ユニバーサルエディターのカスタマイズと拡張 customizing-extending
コンテンツ作成者のニーズに合わせてユニバーサルエディターのオーサリングエクスペリエンスをカスタマイズできる様々な拡張ポイントとその他の機能について説明します。
概要 overview
ユニバーサルエディターでは、プロジェクトのニーズに合わせて 2 つのタイプの適応が可能です。
- ユニバーサルエディターのカスタマイズ - ユニバーサルエディターの標準機能は、複数のカスタマイズ設定を通じて適応させることができます。
- ユニバーサルエディター UI の拡張 - ユニバーサルエディターの UI は、プロジェクトのニーズに合わせて、App Builder を使用して拡張することもできます。
次の節では、両方のタイプについて説明します。
ユニバーサルエディターのカスタマイズ customizing
ユニバーサルエディターには、機能をカスタマイズするためのビルトインオプションがいくつか用意されています。
公開の無効化 disable-publish
特定のオーサリングワークフローでは、コンテンツを公開する前に確認する必要があります。このような場合、どの作成者も公開オプションを使用できません。
次のメタデータを追加することで、「公開」ボタンを完全にアプリ内で抑制できます。
<meta name="urn:adobe:aue:config:disable" content="publish"/>
コンポーネントのフィルタリング filtering-components
ユニバーサルエディターを使用する場合、コンテナコンポーネントごとに使用可能なコンポーネントを制限できます。これを行うには、フィルター定義を指す、スクリプトタグをさらに追加導入する必要があります。
<script type="application/vnd.adobe.aue.filter+json" src="/static/filter-definition.json"></script>
フィルター定義は次のようになり、コンテナにテキストと画像の追加のみを許可するように制限します。
[
{
"id": "container-filter",
"components": ["text", "image"]
}
]
次に、プロパティ data-aue-filter
を追加してコンテナコンポーネントからフィルター定義を参照することができるので、以前に定義したフィルターの ID を渡します。
data-aue-filter="container-filter"
フィルター定義の components
属性を null
に設定することによって、フィルターがない場合と同様に、すべてのコンポーネントを許可します。
[
{
"id": "another-container-filter",
"components": null
}
]
プロパティパネルでのコンポーネントを条件付きで表示および非表示にする conditionally-hide
1 つまたは複数のコンポーネントを一般的に作成者が利用できる場合がありますが、意味をなさない状況が発生する場合もあります。このような場合、condition
属性をコンポーネントモデルのフィールドに追加することによって、プロパティパネルでコンポーネントを非表示にすることができます。
条件は、 JsonLogic スキーマを使用して定義できます。 条件が true の場合、フィールドが表示されます。条件が false の場合、フィールドは非表示になります。
code language-json |
---|
|
![非表示のテキストフィールド](./media_186d530a2b12f3abe879b568d52c90a088b266c33.png?width=750&format=png&optimize=medium)
![表示されたテキストフィールド](./media_19ff5415a72c2936a1beb6f43974d3a0906fec92d.png?width=750&format=png&optimize=medium)
ユニバーサルエディター UI の拡張 extending
Adobe Experience Cloud サービスとして、ユニバーサルエディターの UI は、App Builder とExperience Manager を使用して拡張できます。
UI 拡張機能は、Adobe App Builder で作成された JavaScript アプリケーションで、ユニバーサルエディターなどの Adobe Experience Cloud 統合シェルで実行される UI アプリケーションに埋め込むことができます。ヘッダーメニューとプロパティパネルに独自のボタンとアクションを追加したり、ユニバーサルエディター用に独自のイベントを作成したりできます。
これらの可能性を調べるには、次のリソースを参照してください。
- UI 拡張機能 - UI 拡張機能の開発者向けドキュメント。
- UI 拡張機能ガイド - 独自の拡張機能を開発する方法に関する手順説明
- ユニバーサルエディターの拡張ポイント - ユニバーサルエディター固有の拡張ポイントについてのドキュメント
AEM Sites での Extension Manager の使用 拡張機能をインスタンスごとに有効または無効にしたり、ユニバーサルエディターを含むアドビのファーストパーティ拡張機能にアクセスしたりできます。