ページプロパティのビューのカスタマイズ

どのページにも、ユーザーが表示および編集できる一連のプロパティがあります。ページ作成時に使用されるプロパティもあれば（作成ビュー）、後の段階で表示および編集できるプロパティもあります（編集ビュー）。これらのページプロパティは、適切なページコンポーネントのダイアログ（cq:dialog）で定義し、使用できるようにします。

各ページプロパティのデフォルト状態は次のとおりです。

• 作成ビューでは非表示（例：ページを作成​ウィザード）

• 編集ビューでは表示（例：プロパティを表示）

変更が必要な場合は、フィールドを明確に設定する必要があります。それには適切なノードプロパティを使用します。

• 作成ビューで利用できるページプロパティ（例：ページを作成​ウィザード）：

  • 名前：cq:showOnCreate
  • 型：Boolean

• 編集ビューで利用できるページプロパティ（例：表示／編集）プロパティ​オプション）：

  • 名前：cq:hideOnEdit
  • 型：Boolean

例として、基盤となるページコンポーネントの「基本」タブの「その他のタイトルと説明」の下にグループ化されたフィールドの設定を参照してください。cq:showOnCreate が true に設定されているので、これらのフィールドは​ページを作成​ウィザードに表示されます。

/libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/moretitles

ページプロパティの設定

ページコンポーネントのダイアログを設定し、適切なノードプロパティを適用することによって、表示するフィールドを設定することもできます。

例えば、デフォルトでは、ページを作成​ウィザードには「その他のタイトルと説明」の下にグループ化されたフィールドが表示されます。これらのフィールドを非表示にするには、次のように設定します。

1. /apps の下にページコンポーネントを作成します。

2. ページコンポーネントのbasicセクションにオーバーライドを作成します（Sling リソースマネージャー が提供する ダイアログの差分 を使用）。例を以下に示します。

   <your-page-component>/cq:dialog/content/items/tabs/items/basic
   

   メモ

   リファレンスとして、以下を参照してください。

   /libs/wcm/foundation/components/basicpage/v1/basicpage/cq:dialog
   ただし、/libs パス内の設定は​一切​変更しないでください。
   /libs コンテンツは、インスタンスを次回アップグレードするとき（場合によってはホットフィックスまたは機能パックを適用したとき）に上書きされるからです。
   設定およびその他の変更に推奨される方法は次のとおりです。

   1. 必要な項目（/libs 内に存在）を、/apps の下で再作成します。
   2. /apps 内で変更作業をおこないます。

3. basic の path プロパティに、基本タブのオーバーライドを指すように設定します（次の手順も参照してください）。次に例を示します。

   /apps/demos/components/page/tabs/basic
   

4. 対応するパスに「basic - moretitles 」セクションのオーバーライドを作成します。例：

   /apps/demos/components/page/tabs/basic/items/column/items/moretitles
   

5. 適切なノードプロパティを適用します。

   • 名前：cq:showOnCreate
   • 型：Boolean
   • 値：false

   ページを作成​ウィザードに「その他のタイトルと説明」セクションが表示されなくなります。

ページプロパティの設定サンプル

この例では、Sling Resource Merger のダイアログ差分比較の手法を示しており、sling:orderBefore が使用されています。cq:showOnCreate と cq:hideOnEdit の両方を使用することも説明されています。

GitHub のコード

このページのコードは GitHub にあります

• aem-authoring-extension-page-dialog プロジェクトを GitHub で公開する