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