非表示条件の使用 using-hide-conditions

非表示の条件を使用して、コンポーネントリソースをレンダリングするかどうかを決定できます。その一例として、テンプレート作成者がテンプレートエディターでコアコンポーネントのリストコンポーネントを設定し、子ページに基づいてリストを作成するオプションの無効化を決定する場合があります。デザインダイアログボックスでこのオプションを無効にすると、リストコンポーネントのレンダリング時に非表示の条件が評価され、子ページを表示するオプションが表示されないようにプロパティが設定されます。

概要 overview

オプションのごく一部しか使用しないユーザーにとって、多数のオプションが表示されたダイアログボックスは複雑になります。これにより、ユーザーが圧倒されるようなユーザーインターフェイスのエクスペリエンスになってしまう可能性があります。

管理者、デベロッパー、スーパーユーザーは、非表示の条件を使用することで、一連のルールに基づいてリソースを非表示にできます。この機能を使用すると、作成者がコンテンツを編集する際に表示されるリソースを決定できます。

実装と使用の詳細 implementation-and-usage-details

com.adobe.granite.ui.components.FilteringResourceWrapper は、フィルタリング対象のフィールドの granite:hide プロパティの有無と値に基づいてリソースをフィルタリングします。/libs/cq/gui/components/authoring/dialog/dialog.jsp の実装には、FilteringResourceWrapper. のインスタンスが含まれます。

この実装では、Granite ELResolver API を利用し、ExpressionCustomizer を介して cqDesign カスタム変数を追加します。

以下に、etc/design 内かコンテンツポリシーとして配置されているデザインノードの非表示の条件の例をいくつか示します。

${cqDesign.myProperty}
${!cqDesign.myProperty}
${cqDesign.myProperty == 'someText'}
${cqDesign.myProperty != 'someText'}
${cqDesign.myProperty == true}
${cqDesign.myProperty == true}
${cqDesign.property1 == 'someText' && cqDesign.property2 || cqDesign.property3 != 1 || header.myHeader}

非表示式を定義する際は、次の点に留意してください。

例 example

非表示の条件の例は、AEM 全体（特に、コアコンポーネント）で確認できます。例えば、リストコアコンポーネントについて考えてみます。

テンプレートエディターを使用した場合、テンプレート作成者は、ページ作成者が利用できるリストコンポーネントのオプションをデザインダイアログで定義できます。リストを静的リストにするか、子ページのリストにするか、タグ付きページのリストにするかなどを指定するオプションを有効または無効にできます。

テンプレート作成者が子ページオプションを無効にすると、デザインプロパティが設定され、非表示の条件がそのプロパティに対して評価されます。その結果、このオプションはページ作成者には表示されません。