DropDown (드롭다운) Widget Control

備考

サンプルファイル: 07_Work_with_Widgets/dropdown_objet.lfp

DropDownウィジェットをスクリプトから制御するときに使用するWidget Control（Property · Method · Event）の一覧です。ウィジェットの紹介と使い方はDropDownドキュメントを参照してください。

備考

以下の例のdropdownIDは、キャンバスでDropDownウィジェットに指定した名前（ID）です。スクリプトではwidgetID.memberの形式でアクセスします。

Widget Control一覧

Widget Control	種類	シグネチャ	説明
value	Property	string（読み取り/書き込み）	選択された項目の値
items	Property	配列（書き込み専用）	選択項目のリストを設定
onChanged	Event	onChanged = (value) => { ... }	別の項目を選択したときに実行

Property

value

現在選択されている項目の値です。書き込むとデフォルトの選択値を指定でき（項目のvalueのいずれかと一致する必要があります）、読み取ると現在選択されている項目の値を返します。

• 型: string
• アクセス: 読み取り / 書き込み

Example

// デフォルトの選択値を指定
dropdownID.value = "ko";

// 現在の選択値を読み取る
const selected = dropdownID.value;

items

書き込み専用で、選択できる項目のリストを設定します。各項目はtitle（表示テキスト）、任意のsubtitle、valueを持ちます。valueを省略するとtitleが値として使われます。

• 型: 配列 [{ title, subtitle?, value? }]
• アクセス: 書き込み専用

Example

dropdownID.items = [
  { title: "Korean", subtitle: "한국어", value: "ko" },
  { title: "English", value: "en" },
];

Method

備考

該当なし — DropDownウィジェットに専用のMethodはありません。以下の共通Widget Controlを使用します。

Event

onChanged

ユーザーが別の項目を選択したときに実行されます。

• 種類: Event
• ハンドラー引数
  • value: 選択された項目のvalue
• Returns: なし

Example

// ユーザーがドロップダウンで別の項目を選択したとき
dropdownID.onChanged = (value) => {
  // value: 選択された項目の値
};

共通Widget Control（すべてのウィジェット）

注記

すべてのウィジェットは、setProperty(name, value) / getProperty(name) / setStyleProperty(styleName, styleProperty, value)のような共通Widget Control（Method）も使用できます。詳しいルールは共通Widget Controlリファレンスを参照してください。