ツールバーのカスタマイズ id172FB00L0V6
デフォルトでは、Web エディターには、任意の DITA エディターで必要とされる最も一般的な編集機能が付属しています。 リストタイプ(番号付きまたは箇条書き)、相互参照、コンテンツ参照、テーブル、段落、文字書式の要素の挿入などの機能をエディターで使用できます。 これらの基本的な要素に加えて、 Web エディターをカスタマイズして、オーサリング環境で使用する要素を挿入できます。
Web エディタのツールバーをカスタマイズする方法は 2 つあります。
-
ツールバーへの新しい機能の追加
-
ツールバーから既存の機能を削除します。
ツールバーに機能を追加する
Web エディターに機能を追加するには、主に 2 つのタスクが必要です。 ui_config.json ファイルを作成し、JavaScript でバックグラウンド機能を追加する方法について説明します。
Web エディタのツールバーに機能を追加するには、次の手順を実行します。
-
UI 設定ファイルをダウンロードするには、管理者としてAdobe Experience Managerにログインします。
-
上部の「 Adobe Experience Manager 」リンクをクリックし、「 」を選択します。 ツール.
-
選択 ガイド ツールのリストから、 フォルダープロファイル.
-
をクリックします。 Global Profile タイル。
-
を選択します。 XML エディターの設定 タブをクリックし、 編集 上部のアイコン
-
次をクリック: ダウンロード アイコンを使用して、ui_config.json ファイルをローカルシステムにダウンロードします。 その後、ファイルに変更を加えてから、同じファイルをアップロードできます。
-
Adobe Analytics の
ui_config.json
ファイルを開き、新しい機能の定義を「ツールバー」セクションに追加します。 ファイルを保存してアップロードします。通常は、新しいツールバーボタングループを作成し、そのグループに 1 つ以上のツールバーボタンを追加できます。 または、既存のツールバーグループ内に新しいツールバーボタンを追加できます。 新しいツールバーグループを作成するには、次の詳細が必要です。
type:を指定します。
blockGroup
としてtype
の値です。 この値は、1 つ以上のツールバーグループを含むブロックグループを作成していることを示します。抽出:スペースで区切られたクラスの名前。
項目:ツールバーのすべてのグループの定義を指定します。 各グループには、1 つまたは複数のツールバーアイコンを含めることができます。 ツールバーグループ内でアイコンを定義するには、
type
属性をitems
の値をに設定し、buttonGroup
. で 1 つ以上のクラス名を指定します。extraclass
プロパティ。 でフィーチャ名を指定します。label
プロパティ。 次のスニペット:ui_config.json
ファイルには、メインツールバーブロックの定義が表示され、その後にbuttonGroup
定義:code language-none "' "toolbar": { "type": "blockGroup", "extraclass": "toolbar operations", "items": [ { "type": "buttonGroup", "extraclass": "left-controls", "label": "Left Controls", "items": [ "'
内
items
コレクションに含める場合は、1 つ以上のツールバーアイコンの定義を指定する必要があります。ツールバーアイコンを追加するには、次のプロパティを定義する必要があります。
type:を指定します。
button
としてtype
の値です。 この値は、ツールバーボタンを追加しようとしていることを示します。アイコン:ツールバーで使用する Coral アイコンの名前を指定します。
バリアント:を指定します。
quiet
としてvariant
の値です。タイトル:アイコンのツールチップを指定します。
クリック時:JavaScript ファイルで、機能に対して定義されたコマンド名を指定します。 コマンドに入力パラメータが必要な場合は、コマンド名を次のように指定します。
code language-none "'JavaScript "on-click": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"} "'
表示または非表示:
show
プロパティを使用して、アイコンが表示されるモードを指定します。 指定できる値は — です。@isAuthorMode
,@isSourceMode
,@isPreviewMode
,true
\(すべてのモードで表示\)またはfalse
\(すべてのモードで非表示にします\)。の代わりに
show
を使用する場合、hide
プロパティ。 指定可能な値は、の値と同じです。show
プロパティの値は、指定したモードではアイコンが表示されないという違いだけです。次の例は、ユーザーがツールバーのバージョンを表示アイコンをクリックしたときのAEM Guides のバージョン番号を示しています。
次のコードを JavaScript ファイルに追加します。
code language-javascript $(document).ready(setTimeout(function() { fmxml.commandHandler.subscribe({ key: 'user.alert', next: function() { alert("AEM Guides version x.x") } }) }, 1000))
機能を ui_config.json ファイルの形式:
code language-javascript "type": "button", "icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
-
の作成 clientlib フォルダーに追加し、このフォルダーに JavaScript を追加します。
-
の categories プロパティを更新します。 clientlib フォルダーに次の値を割り当てる apps.fmdita.xml_editor.page_overrides.
-
を保存します。 ui_config.json ファイルを作成し、Web エディタを再読み込みします。
ツールバーからフィーチャを削除する
Web エディタで現在利用可能なすべての機能を提供したくない場合は、不要な機能を Web エディタのツールバーから削除できます。
ツールバーから不要な機能を削除するには、次の手順を実行します。
-
UI 設定ファイルをダウンロードするには、管理者としてAdobe Experience Managerにログインします。
-
上部の「 Adobe Experience Manager 」リンクをクリックし、「 」を選択します。 ツール.
-
選択 ガイド ツールのリストから、 フォルダープロファイル.
-
をクリックします。 Global Profile タイル。
-
を選択します。 XML エディターの設定 タブをクリックし、 編集 上部のアイコン
-
次をクリック: ダウンロード アイコンを使用して、ui_config.json ファイルをローカルシステムにダウンロードします。 その後、ファイルに変更を加えてから、同じファイルをアップロードできます。
The
ui_config.json
ファイルには 3 つのセクションがあります。-
ツールバー:このセクションには、エディターのツールバーで使用できるすべての機能 (「番号付きリストを挿入/削除」、「(file) 閉じる」、「保存」、「コメント」など ) の定義が含まれます。
-
ショートカット:このセクションには、エディターの特定の機能に割り当てられるキーボードショートカットの定義が含まれています。
-
テンプレート:この節には、文書で使用できる DITA 要素の事前定義済みの構造が含まれています。 デフォルトでは、「テンプレート」セクションには、段落、単純なテーブル、テーブルおよび本文の各要素のテンプレート定義が含まれています。 任意の要素のテンプレート定義を作成するには、目的の要素に有効な XML 構造を追加します。 例えば、
p
新たに追加されるごとに要素li
要素をリストに追加すると、テンプレートセクションの最後に次のコードを追加して、これを実現できます。
code language-css "li": "<li><p></p></li>"
-
-
「ツールバー」セクションで、ユーザーに表示しない機能のエントリを削除します。
-
を保存します。 ui_config.json ファイルを作成し、Web エディタを再読み込みします。
親トピック: Web エディタのカスタマイズ