自訂工具列 id172FB00L0V6

依預設,Web編輯器會隨附任何DITA編輯器所需的最常見編輯功能。 編輯器中有插入型別清單\(編號或專案符號\)、互動參照、內容參照、表格、段落和字元格式等元素的功能。 除了這些基本元素之外,您還可以自訂Web編輯器來插入在編寫環境中使用的元素。

自訂網頁編輯器的工具列有兩種方式:

  • 將新功能新增至工具列

  • 從工具列移除任何現有功能

在工具列中新增功能

將功能新增至網頁編輯器有兩個主要工作 — 在中新增功能的圖示 ui_config.json 以及在JavaScript中新增背景功能。

執行以下步驟,將功能新增至網頁編輯器的工具列:

  1. 若要下載UI設定檔,請以管理員身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇 工具.

  3. 選取 指南 ​從工具清單中,按一下 資料夾設定檔.

  4. 按一下 全域設定檔 圖磚。

  5. 選取 XML編輯器設定 標籤並按一下 編輯 圖示在頂端

  6. 按一下 下載 圖示可在本機系統上下載ui_config.json檔案。 您可以接著對檔案進行變更,然後上傳相同的檔案。

  7. ui_config.json 檔案,在工具列區段中新增新功能的定義。 儲存檔案並上傳。

    通常,您可以建立新的工具列按鈕群組,並在其中新增一或多個工具列按鈕。 或者,您可以在現有的工具列群組中新增工具列按鈕。 建立新的工具列群組需要下列詳細資料:

    type:指定 blockGroup 作為 type 值。 此值表示您正在建立包含一或多個工具列群組的區塊群組。

    extraclass:以空格分隔的一個或多個類別的名稱。

    個專案:在工具列中指定所有群組的定義。 每個群組可以包含一或多個工具列圖示。 若要定義工具列群組中的圖示,您需要再次定義 type 中的屬性 items,並將其值設為 buttonGroup. 在 extraclass 屬性。 在中指定特徵名稱 label 屬性。 下列來自的程式碼片段 ui_config.json 檔案顯示主要工具列區塊的定義,後面接著 buttonGroup 定義:

    code language-none
    ```
    "toolbar": {
    "type": "blockGroup",
    "extraclass":
    「工具列作業」、
    "items": [
    {
    "type": "buttonGroup",
    "extraclass": "left-controls",
    "label": "Left Controls",
    "items": [
    ```
    

    items 集合,您必須指定一或多個工具列圖示的定義。

    您需要定義以下屬性以新增工具列圖示:

    type:指定 button 作為 type 值。 此值表示您正在新增工具列按鈕。

    圖示:指定您要在工具列中使用的Coral圖示名稱。

    變體:指定 quiet 作為 variant 值。

    標題:指定圖示的工具提示。

    按一下:指定在JavaScript檔案中為功能定義的命令名稱。 如果您的命令需要輸入引數,則指定命令名稱為:

    code language-none
    ```Javascript
    "on-click": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"}
    ```
    

    顯示或隱藏:如果您正在定義 show 屬性,然後指定圖示的顯示模式。 可能的值包括 — @isAuthorMode@isSourceMode@isPreviewModetrue \(在所有模式中顯示\),或 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"
    
  8. 建立 clientlib 並將您的JavaScript新增至此資料夾。

  9. 更新「 」的「 」類別屬性 clientlib 資料夾,為其指派值 apps.fmdita.xml_editor.page_overrides.

  10. 儲存 ui_config.json 檔案並重新載入網頁編輯器。

從工具列移除功能

有時您可能不想提供網頁編輯器中目前可用的所有功能,在這種情況下,您可以從網頁編輯器的工具列移除不需要的功能。

執行以下步驟,從工具列移除任何不想要的特徵:

  1. 若要下載UI設定檔,請以管理員身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇 工具.

  3. 選取 指南 從工具清單中,按一下 資料夾設定檔.

  4. 按一下 全域設定檔 圖磚。

  5. 選取 XML編輯器設定 標籤並按一下 編輯 圖示在頂端

  6. 按一下 下載 圖示可在本機系統上下載ui_config.json檔案。 您可以接著對檔案進行變更,然後上傳相同的檔案。

    ui_config.json 檔案包含三個區段:

    1. 工具列:本節包含編輯器工具列中可用所有功能的定義,例如「插入/移除編號清單」、「(file)關閉」、「儲存」、「註解」等。

    2. 捷徑:本節包含指派給編輯器中特定功能的鍵盤快速鍵定義。

    3. 範本:本節包含您可在檔案中使用的DITA元素之預先定義結構。 依照預設,「範本」區段包含段落、簡單表格、表格和正文元素的範本定義。 您可以為想要的元素新增有效的XML結構,以建立任何元素的範本定義。 例如,如果您想要新增 p 元素,每個新 li 元素清單中,您可以在範本區段的結尾新增下列程式碼以達成此目的:

    code language-css
    "li": "<li><p></p></li>"
    
  7. 從工具列區段中,移除您不想向使用者公開的功能專案。

  8. 儲存 ui_config.json 檔案並重新載入網頁編輯器。

父級主題:​自訂Web編輯器

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178