アダプティブフォームおよび HTML5 フォームの外観フレームワーク appearance-framework-for-adaptive-and-html-forms
フォーム(アダプティブフォームと HTML5 フォーム)は、jQuery、Backbone.jsおよびUnderscore.jsライブラリを外観とスクリプト作成のために使用します。このフォームはまた、フォーム内のすべての対話操作要素(例えばフィールドやボタン)に対して jQuery UI Widgets アーキテクチャを使用します。このアーキテクチャは、フォーム開発者が Forms で豊富な使用可能な jQuery ウィジェットとプラグインのセットを利用できるようにします。また、ユーザーから leadDigits/trailDigits の制限やパターン形式文字列の実装などのデータを取得しながら、フォーム固有のロジックを実装することもできます。フォーム開発者はカスタム外観を作成して使用し、データ取得のエクスペリエンスを改善し、よりユーザーフレンドリーにすることができます。
この記事は jQuery と jQuery ウィジェットの知識が十分ある開発者向けです。外観フレームワークについての理解を深めたり、開発者がフォームフィールドに別の外観を作成するのに役立ちます。
外観フレームワークは、様々なオプション、イベント(トリガー)および機能に依存し、ユーザーのフォームとのやり取りを取得し、モデル変更に対応してエンドユーザーに通知します。さらに、次の点に注意してください。
- フレームワークは、フィールドの外観に一連のオプションを提供します。これらのオプションはキーと値のペアであり、一般的なオプションとフィールドタイプ固有のオプションの 2 つのカテゴリに分かれます。
- 外観はコントラクトの一部として、enter や exit などの一連の インベントのセットをトリガーします。
- 一連の関数を実装するには、外観が必要となります。その関数には一般的なものから、フィールドタイプ固有のものも含まれています。
一般的なオプション common-options
グローバルオプションは次のとおりです。これらのオプションはすべてのフィールドで使用できます。
これらのオプションとは別に、フィールドのタイプによって異なるいくつかの他のオプションがフレームワークによって提供されます。フィールド固有のオプションの詳細は、以下に記載されています。
フォームのフレームワークとのインタラクション interaction-with-forms-framework
Forms のフレームワークとやりとりするために、ウィジェットはいくつかのイベントをトリガーし、フォームスクリプトが機能するように有効化します。ウィジェットがこれらのイベントをスローしない場合、そのフィールドのためにフォーム内に書かれたスクリプトの一部が機能していません。
ウィジェットによってトリガーされるイベント events-triggered-by-widget
ウィジェットで実装された API apis-implemented-by-widget
外観フレームワークはカスタムウィジェットで実装されたウィジェットの関数をいくつか呼び出します。ウィジェットは次の関数を実装する必要があります。
フィールドのタイプに固有のオプション options-specific-to-type-of-field
すべてのカスタムウィジェットは上記の仕様に準拠する必要があります。異なるフィールドの機能を使用するには、ウィジェットはその特定のフィールドのガイドラインに準拠する必要があります。