メインコンテンツまでスキップ
バージョン: 1.16.0

Combobox

Overview

Combobox は複数選択肢の中から一つの値を検索して選択することができます。


Specification

Property

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

NameTypeDefaultDescriptionRemark
classNamestring""コンポーネントの class 名
errorstring""エラーに表示するテキスト未指定、あるいは空文字の場合、error は表示されない
idstring""コンポーネントの id 名
labelstring""コンポーネントの説明ラベル未指定、あるいは空文字の場合、label は表示されない
valuestring""選択されている値value が未指定の場合、何も選択されない
value が文字列以外の場合、エラーを出力する
disabledbooleanfalseコンポーネントの編集可/不可設定
requiredIconbooleanfalseコンポーネントの必須アイコン表示/非表示設定
visiblebooleantrueコンポーネントの表示/非表示設定
itemsArray<Item>[]表示する選択肢一覧items が配列以外の場合、エラーを出力する

Item

NameTypeDefaultDescriptionRemark
labelstringnull各選択肢のテキストItem.label が未指定の場合、UI 上は Item.value の値が表示される
valuestringnull各選択肢の値Item.value に重複した値を指定した場合、エラーを出力する
disabledbooleanfalse各オプションの選択可/不可設定

Event

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

NameTypeDescriptionRemark
changefunction値が変更された時のイベントハンドラ引数には Event の event オブジェクトをとる

event.detail で以下の値を受け取ることができる
event.detail.oldValue : 変更前の value の値
event.detail.value : 変更後の value の値

Constructor

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

Parameter

NameTypeDefaultDescriptionRemark
optionsobject{}コンポーネントのプロパティを含むオブジェクト

Custom CSS

ヒント

Custom CSS をご確認ください。

コンポーネントのスタイルを変更するために使用できるプロパティの一覧です。
toggle は、Combobox の入力欄とボタンの領域を示します。

Property

Name
--kuc-combobox-font-size
--kuc-combobox-toggle-width
--kuc-combobox-toggle-height
--kuc-combobox-toggle-color
--kuc-combobox-menu-color
--kuc-combobox-menu-color-selected

Sample Code

ヒント

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

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

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

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

const combobox = new Kuc.Combobox({
label: 'Fruit',
items: [
{ label: 'Banana', value: 'banana', disabled: true },
{ label: 'Orange', value: 'orange' },
{ label: 'Apple', value: 'apple' }
],
value: 'orange',
requiredIcon: true,
error: 'Error occurred!',
className: 'options-class',
id: 'options-id',
visible: true,
disabled: false
});
space.appendChild(combobox);

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