Lightning コンポーネント開発者ガイド
jLightning ページと Lightning アプリケーションビルダーのコンポーネントの設定に関するヒントおよび考慮事項
Lightning ページおよび Lightning アプリケーションビルダーのコンポーネントおよびコンポーネントバンドルを作成する場合、次のガイドラインを参考にしてください。
コンポーネント
- デザインファイルの要素で label 属性を使用して、<design:component label="foo"> などのわかりやすい名前をコンポーネントに設定します。
- 表示領域の 100% の幅 (余白を含む) を占めるようにコンポーネントを設計します。
- ユーザ操作を必要とする場合、宣言型ツールでコンポーネントの適切なプレースホルダ動作を指定します。
- コンポーネントには、空白のボックスを表示しません。他のサイトがどのように動作するかを考えます。たとえば、Facebook では、実際のフィード項目がサーバから返されるまでフィードの概要が表示されます。これにより、UI 応答のユーザの認識が向上します。
- 起動されたイベントにコンポーネントが連動する場合は、イベントが起動される前に表示するデフォルトの状態を指定します。
- Lightning Experience のスタイル設定および Salesforce Design System と一貫性のある方法で、コンポーネントのスタイルを設定します。
属性
- デザインファイルを使用して、Lightning アプリケーションビルダーに公開する属性を制御します。
- システム管理者にとって使いやすくわかりやすい属性にします。SOQL クエリ、JSON オブジェクト、Apex クラス名は公開しません。
- 必須属性にはデフォルト値を指定します。デフォルト値のない必須属性を持つコンポーネントをアプリケーションビルダーに追加すると、無効と表示され、ユーザの操作性が低下します。
- 公開される属性には、サポートされる基本のデータ型 (string、integer、boolean) を使用します。
- <design:attribute> 要素の整数属性に最小値と最大値を指定して、有効な値範囲を制御します。
- 文字列属性では、事前定義された一連の値を持つデータソースを指定して、属性の設定を選択リストとして公開できます。
- すべての属性に、わかりやすい表示名を使用した表示ラベルを指定します。
- 説明を提供して、データ形式や予期される値範囲など、予期されるデータおよびガイドラインを説明します。説明テキストは、プロパティエディタにツールチップとして表示されます。
- flexipage:availableForAllPageTypes または forceCommunity:availableForAllPageTypes インターフェースを実装するコンポーネントの設計属性を削除するには、まずコンポーネントからインターフェースを削除した後、設計属性を削除します。その後でインターフェースを再実装します。コンポーネントが Lightning ページで参照されている場合は、変更する前にページからコンポーネントを削除する必要があります。
制限事項
Lightning アプリケーションビルダー は、Map 型、Object 型、または java:// 複合型をサポートしません。