Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

 

 

OutSystems

ドロップダウン

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リテラルまたはExpression。 Yes False
Enabled ウィジェットを編集できるかどうかを定義するBooleanリテラルまたはExpression。 True
Empty Text 選択が空であることを示すドロップダウンリストに表示されるTextリテラルまたはExpression。このオプションが選択された場合、定義された変数はデフォルト値を保持します。
Style Classes ウィジェットに適用する1つまたは複数のスタイルクラスを指定します。複数の値はスペースで区切ります。 "dropdown"
アトリビュート
Property この要素のHTML変換に追加するアトリビュート名。 ドロップダウンリストからプロパティを選択するか、フリーテキストを入力します。プロパティ名はプラットフォームによって検証されません。

プロパティの重複は許可されていません。スペース、「"」、「'」も許可されていません。
Value アトリビュートの値。 値を直接入力するか、Expressionエディタを使用してExpressionを記述します。

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
  • Was this article helpful?