Tabs

Overview

Tabs は、複数のタブを表示し、表示内容を切り替えることができます。

---

Specification

Property

使用できるプロパティの一覧です。プロパティを指定して値を更新することができます。

Name	Type	Default	Description	Remark
className	string	""	コンポーネントの class 名
id	string	""	コンポーネントの id 名
value	string	""	選択されているタブ	items 内に一致する value がある場合、disabled でもそのタブが表示される 以下の場合は最初の visible タブが表示される items 内に一致する value がない場合 items 内に一致する value があるが、そのタブが visible ではない場合 value が文字列以外の場合、エラーを出力する
borderVisible	boolean	true	表示内容を囲う枠線の表示/非表示設定
scrollButtons *1	boolean	false	スクロールボタンの表示/非表示設定	scrollButtons が true の場合、タブの横スクロールまたはスクロールボタンのクリックで移動ができる
visible	boolean	true	コンポーネントの表示/非表示設定
items	Array<Item>	[]	表示するタブのリスト	items が配列以外の場合、エラーを出力する

備考

*1: scrollButtons を true に設定する場合、Tabs コンポーネントを親 div 要素で括り、適切な max-width プロパティを設定してください。 例えば、メニューの上側の要素内で Tabs コンポーネントを使用する場合、max-width: 100vw のように設定します。

Item

Name	Type	Default	Description	Remark
content	string/HTMLElement	""	タブの内容
label	string	""	タブ名
value	string	""	タブのキー項目 ※必須かつ一意の値	value が items 内で重複もしくは未指定の場合、エラーを出力する
disabled	boolean	false	タブの切替可/不可設定
visible	boolean	true	タブの表示/非表示設定

Event

指定できるイベントの一覧です。

Name	Type	Description	Remark
change	function	選択されているタブが変更された時のイベントハンドラ	引数には Event の event オブジェクトをとる event.detail で以下の値を受け取ることができる event.detail.oldValue : 変更前の value の値 event.detail.value : 変更後の value の値

Constructor

Tabs(options)
使用できるコンストラクタの一覧です。

Parameter

Name	Type	Default	Description	Remark
options	object	{}	コンポーネントのプロパティを含むオブジェクト

Custom CSS

ヒント

Custom CSS をご確認ください。

コンポーネントのスタイルを変更するために使用できるプロパティの一覧です。

Property

Name
--kuc-tabs-tab-background-color
--kuc-tabs-tab-background-color-selected
--kuc-tabs-tab-color
--kuc-tabs-tab-color-selected
--kuc-tabs-tab-font-size
--kuc-tabs-tab-height
--kuc-tabs-tab-width

---

Sample Code

ヒント

導入と実装方法 をご確認ください。

全てのパラメータを指定した場合のサンプルコードです。

const Kuc = Kucs['1.x.x'];

const space = kintone.app.record.getSpaceElement('space');

// Create each Tab content
const textArea = new Kuc.TextArea({
  label: 'TextArea',
  value: 'This is sample.'
});

const timePicker = new Kuc.TimePicker({
  label: 'Time',
  value: '11:30'
});

const text = 'This is sample.';

const tabs = new Kuc.Tabs({
  items: [
    {
      label: 'A',
      content: textArea,
      value: 'a',
      disabled: false
    },
    {
      label: 'B',
      content: timePicker,
      value: 'b',
      disabled: false
    },
    {
      label: 'C',
      content: text,
      value: 'c',
      disabled: false
    }
  ],
  value: 'a',
  className: 'options-class',
  id: 'options-id',
  visible: true,
  borderVisible: true,
  scrollButtons: false
});
space.appendChild(tabs);

tabs.addEventListener('change', event => {
  console.log(event);
});

---

Related Articles

• Tabs customization