新しい Granite UI フィールドコンポーネントの作成

Granite UI には、フォームで使用するようにデザインされた幅広いコンポーネントが用意されています。これらを Granite の UI 用語では「フィールド」と呼びます。標準の Granite フォームコンポーネントは、次の場所にあります。

/libs/granite/ui/components/foundation/form/*

メモ

これらの Granite UI フォームフィールドが特に注目されるのは、これらがコンポーネントダイアログで使用されるからです。

メモ

フィールドについて詳しくは、Granite UI に関するドキュメントを参照してください。

Granite コンポーネントを開発または拡張するには、Granite UI の基盤フレームワークを使用します。このフレームワークには次の 2 つの要素があります。

サーバー側：
- 基盤コンポーネントのコレクション
  - 基盤 - モジュール式、組み立て可能、階層化可能、再利用可能
  - コンポーネント - Sling コンポーネント
- アプリケーション開発を支援するためのヘルパー
クライアント側：
- ハイパーメディア駆動型 UI を使用して一般的なインタラクションパターンを実現するための語彙（HTML 言語の拡張）を提供するクライアントライブラリのコレクション

一般的な Granite UI コンポーネントである field は、以下の 2 つのファイルで構成されています。

init.jsp：ラベル付けや説明などの一般的な処理を扱い、フィールドをレンダリングする際に必要になるフォーム値を提供します。
render.jsp：ここで、フィールドの実際のレンダリングが実行され、カスタムフィールドの場合は上書きされる必要があります。init.jsp にインクルードされます。

例えば、以下を参照してください。

メモ

このメカニズムは JSP を使用しているので、i18n および XSS はデフォルトでは提供されません。つまり、文字列を国際化およびエスケープする必要があります。以下のディレクトリには、標準インスタンスの一般的なフィールドが含まれています。これらをリファレンスとして使用できます。

/libs/granite/ui/components/foundation/form ディレクトリ

コンポーネント用のサーバーサイドスクリプトの作成

カスタマイズしたフィールドは、render.jsp スクリプトのみを上書きする必要があります。このスクリプトは、コンポーネントのマークアップを提供します。この JSP（レンダリングスクリプト）は、マークアップのラッパーと見なすことができます。

sling:resourceSuperType プロパティを使用して、以下から継承する新しいコンポーネントを作成します。

/libs/granite/ui/components/foundation/form/field
以下のスクリプトを上書きします。

render.jsp

このスクリプトでは、クライアントが生成された要素とやり取りする方法を理解できるように、ハイパーメディアマークアップ（ハイパーメディアアフォーダンスを含む、拡張されたマークアップ）を生成する必要があります。Granite UI のサーバー側コーディングスタイルに従ってください。

カスタマイズする際に守る必要のある唯一の決まりごとは、以下を使用して、リクエストからフォーム値（init.jsp で初期化）を読み取ることです。
```
// Delivers the value of the field (read from the content)
ValueMap vm = (ValueMap) request.getAttribute(Field.class.getName());
vm.get("value, String.class");
```
詳しくは、デフォルトの Granite UI フィールドの実装（例：/libs/granite/ui/components/foundation/form/textfield）を参照してください。

メモ

現時点では、HTL ではコンポーネント間の情報の受け渡し（フォーム／フィールドのコンテキストでは非常に頻繁におこなわれます）を簡単には実現できないので、スクリプティングメソッドとして JSP が推奨されます。

特定のクライアント側動作をコンポーネントに追加するには：