Community

言語:

OutSystemsの用語

ドロップダウン

Last updated
Save as PDF

現在、Dropdownウィジェットは、［Text Only］に設定されていてラベルの値が非リテラル型である場合、実行時に適切に動作しません。

Dropdownウィジェットは、モバイルアプリやリアクティブWebアプリでドロップダウンリストを作成するときに使用します。

Dropdownウィジェットでは、2種類のリストを実装することができます。

テキストのみの単純なリスト。この場合、Options Contentを［Text Only］に設定します。これらは一般的なタイプのリストであり、<select> HTMLタグを使用して描画されます。デバイスでは、ネイティブなルックアンドフィールで表示されます。
他のウィジェットを使用したカスタムリスト。この場合、Options Contentを［Custom］に設定します。たとえば、画像や他のウィジェットからリストを作成する場合に使用します。これらのリストは、<div> HTMLタグを使用して描画されます。

プロパティ

名前	説明	必須	デフォルト値	備考
Name	画面、アクション、モジュールといった、定義されているスコープ内の要素を識別します。	Yes
Variable	ユーザーが入力した値を保持します。	Yes
List	ドロップダウンに表示するレコードのリストを指定します。	Yes
Options Content	「Text（デフォルト）」にすると、テキスト値を選択するコンテンツでネイティブなエクスペリエンスを提供します（select HTMLタグを使用）。「Custom」にすると、ドロップダウン内にテキスト以外のウィジェット（画像など）を含むリッチなコンテンツを表示することができます（div HTMLタグを使用）。	Yes	カスタム
Options Text	ラベルとして使用するリストのレコードのアトリビュート。
Options Value	選択された値の識別子として使用するリストのレコードのアトリビュート。	Yes
Mandatory	ウィジェットが必要かどうかを定義するBooleanリテラルまたは式。	Yes	False
Enabled	ウィジェットを編集できるかどうかを定義するBooleanリテラルまたは式。		True
Empty Text	選択が空であることを示すドロップダウンリストに表示されるTextリテラルまたは式。このオプションが選択された場合、定義された変数はデフォルト値を保持します。
Style Classes	ウィジェットに適用する1つまたは複数のスタイルクラスを指定します。複数の値はスペースで区切ります。		"dropdown"
アトリビュート
Property	この要素のHTML変換に追加するアトリビュート名。			ドロップダウンリストからプロパティを選択するか、フリーテキストを入力します。プロパティ名はプラットフォームによって検証されません。プロパティの重複は許可されていません。スペース、「"」、「'」も許可されていません。
Value	アトリビュートの値。			値を直接入力するか、式エディタを使用して式を記述します。 Valueが空の場合、対応するHTMLタグはproperty="property"として作成されます。たとえば、nowrapプロパティは値を必要としないため、nowrap="nowrap"が追加されます。

イベント

名前	説明	必須	備考
On Change	要素の値が変更されたときに実行される画面アクションまたは移動先の画面。
Transition	他の画面に移動するときに適用される移行エフェクト。		デフォルトでは、モジュールレベルで定義されます。
Event	処理されるJavaScriptまたはカスタムイベント。
Handler	JavaScriptイベントハンドラ。

ランタイムプロパティ

名前	説明	読み取り専用	型	備考
Id	実行時にウィジェットインスタンスを識別します（HTMLのid属性）。JavaScriptと拡張プロパティで使用できます。	Yes	Text
Valid	必要な入力がない場合、または入力値が定義されたデータ型に適合していない場合はFalseになります。このプロパティの値は、カスタム検証を実行するときに上書きできます。		Boolean
ValidationMessage	ValidがFalseの場合にビルドイン検証制約を満たしていないことを説明するメッセージ。このプロパティの値は、カスタム検証を実行するときに上書きできます。		Text