使用法と例
入力 Web 拡張機能を構成するには、以下のパラメーターを指定します：
- モード: 色を指定します。値は、["Light"]、["Dark"]、["High Contrast"]、[""] です。空の文字列値 [""] は ["Light"] と等しくなります。
- ラベル: コントロールラベルを設定します。空の文字列値 [""] は、ラベル、必要なインジケーター、およびツールヒントの情報アイコンを非表示にします。
- 値:現在の値を保持します。アクションは、State パラメーターが ["Enabled"] の値を持つ場合にのみ実行されます。
- Type: コントロールタイプを定義します。値は、["入力"]、["テキストエリア"]、["検索"] になります。
- 形式:形式を指定します。値は、["text"] (デフォルト)、["number"]、["percentage"]、["currency"] になります。数値は地域設定に従って表示されます。
- カスタムシンボル：セルに最大 5 文字のプレフィックスを追加します。通貨をセルに追加する際に使用します (例、[$ 300])。
- 最大の長さ:指定できる文字数を定義します。指定しない場合、デフォルトの 300 が使用されます。
- 精度:["currency"]、["number"]、["percentage"] の形式で使用する小数点以下桁数を定義します。値は 0 から 12 までになります。デフォルト値は 0 です。
- 必須: エレメントの選択が必須かどうかを定義します。["FALSE"] がデフォルト値です。
- 情報: [] アイコンのツールヒントテキストを提供します。空の文字列 [""] を指定すると、このアイコンは非表示になります。
- ヒントテキスト: ヒントテキストを文字列で定義します。入力フィールドに値が入力されていない場合、ヒントテキストが表示されます。
- エラーテキスト：エラーテキストが文字列として提供された場合、コントロールはエラー状態で表示されます。空の文字列 [""] を使用すると、エラー状態を非表示にできます。["検索"] タイプはエラー状態をサポートしていません。
- 状態: 制御状態を ["Enabled"]、["Disabled"] , または["Read-only"] として定義します。デフォルト値は ["Enabled"] です。
- ダーティフラグ：レポートが保存された後に値が変更されたかどうかを表示します。["TRUE"] または [""] を使用して、ダーティフラグインジケーターを使用します。["FALSE"] を指定すると、フラグは無視されます。
この例では、入力 Web 拡張機能を構成し、その値を後続処理のためにレポート変数に保存する方法を示しています: