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