UIコンポーネントの理解
ユーザー・インタフェース(UI)コンポーネントは、定義された契約を通じてユーザー・インタフェースの相互作用の単位をカプセル化します。
Web Componentコントラクトは、ユーザー・インタフェースを介してコンポーネントの機能を公開し、コンポーネントがアプリケーションの他の部分とやりとりできるようにします。 Visual Builderでは、Oracle JavaScript Extension Toolkit (JET)コンポーネント契約がサポートされています。この契約では、Webコンポーネント契約の上部にデータ・バインディング、コンポーネント・メタデータおよび依存関係が追加されます。 Oracle JETコンポーネント・コントラクトは、カスタム・プロパティ、イベント、およびメソッドを使用して、カスタムDocument Object Model (DOM)HTML要素を公開します。 Oracle JETによって追加されたプロパティ・バインディングは、一方向(読み取り専用)バインディングと双方向(読み取り/書き込み)バインディングの両方をサポートします。 一般に、コンポーネントのプロパティは変数にバインドされ、コンポーネント・イベントはアクション・チェーンをトリガーします。
コンポーネントは、そのコンポーネントの1つまたは複数の子を保持できる0個以上のスロットを持つことができます。 たとえば、ツールバーには多数のボタンを含めることができます。
コンポーネント・パレットからアプリケーションにコンポーネントを追加できます。 また、コンポーネント交換で提供されるものなど、カスタムJETコンポーネントを使用することもできます。 詳細は「コンポーネント交換の使用」を参照してください。
簡単な使用例では、単純なHTMLコンポーネントとそれに対応するビュー・モデルの実装を使用できます。
Oracle JETの詳細は、http://www.oracle.com/webfolder/technetwork/jet/index.htmlを参照してください。 Oracle JET Cookbookは、http://www.oracle.com/webfolder/technetwork/jet/jetCookbook.htmlでサポートされているすべてのコンポーネントの使用に関する詳細情報を提供
コンポーネント契約
UIコンポーネントは、Visual Builderによって出荷されるか、パートナによって提供されるか、またはユーザーが作成したかに関係なく、同じコンポーネント契約に従う必要があります。 この契約により、Visual Builderは、Visual Builderユーザー・インタフェースを通じてコンポーネントの機能を宣言的に公開することができます。 コンポーネントに機能を追加する必要がある場合は、そのコンポーネントの機能を拡張することができ、新しい機能はそのコンポーネントのインタフェースで表現されます。
コンポーネント契約には4つの側面があります: プロパティ、イベント、子スロット、およびメソッドが含まれます。
プロパティ
コンポーネントには、Visual Builderユーザー・インタフェースを使用して、変数または式にバインドできるプロパティがあります。 これらのプロパティは、コンポーネントの状態(入力テキスト・フィールドの値など)に影響を与えたり、レンダリングに影響を与えることがあります(たとえば、有効または無効)。 コンポーネント・プロパティは、変数に使用可能な型と一致する特定の型を持ち、それ自体が構造化されているか、またはコレクションである可能性があります。 コンポーネント・インタフェースの一部としてプロパティが必要な場合もあります。
型に加えて、コンポーネント・プロパティには、表示名や説明などの追加のメタデータ(プロパティのJETデザイン時メタデータで定義されている)が含まれている場合もあります。
一方向と双方向の2種類のプロパティがあります。
| プロパティ・タイプ | 説明 | 結ばれることができる |
|---|---|---|
| One-way (read-only) | コンポーネントはこのプロパティの値を読み取ります。 プロパティが変更される式が変更された場合、コンポーネントはこの変更を通知されます。 | 式(変数を含む可能性があります) |
| Two-way (read/write) | コンポーネントはこのプロパティの値を読み取ることができ、そのプロパティに書き戻すこともできます。 変数が外部的に変更された場合、コンポーネントはこの変更を通知されます。 | 変数 |
イベント
コンポーネントは、ゼロ個以上のイベント(ボタンに対するonClickイベントなど)を起動できます。 各イベントにはペイロードがあります。 Visual Builderユーザー・インタフェースを使用すると、開発者はこれらのイベントのいずれかをリッスンし、イベント・ペイロードを公開できます。 アクション・チェーンはイベントを処理できます。
チャイルド・スロット
スロットは、Webコンポーネント内のプレースホルダーで、独自のマークアップを使用して埋め込むことができます。 コンポーネントには、1つ以上の子を保持できる0個以上のスロットを持つことができます。 特定のスロットに割り当てられていない子は、デフォルトのスロットに割り当てられます。