自訂頁面編寫

AEM提供多種機制，讓您可自訂製作例項的頁面製作功能（和consoles）。

• Clientlibs

  Clientlibs可讓您擴充預設實作以實現新功能，同時重複使用標準函式、物件和方法。 自訂時，您可以在/apps.下建立自己的clientlib新clientlib必須：

  • 取決於編寫clientlib cq.authoring.editor.sites.page
  • 屬於適當的cq.authoring.editor.sites.page.hook類別

• 覆蓋

  覆蓋是根據節點定義，並可讓您以您自己的自訂功能（在/apps中）覆蓋標準功能（在/libs中）。 建立覆蓋時不需要原始資料的1:1副本，因為sling資源合併允許繼承。

這些功能可以用於擴充AEM例項中的頁面編寫功能。 下面將介紹一個選項（在高級別）。

添加新層（模式）

編輯頁面時，有多種模式可用。 這些模式是使用layers實現的。 這可讓使用者存取相同頁面內容的不同功能類型。 標準層包括：編輯、預覽、注釋、開發人員和鎖定目標。

圖層範例：即時副本狀態

標準AEM例項提供MSM層。 這會存取與多網站管理相關的資料，並在層中加亮顯示。

若要在實際操作中查看它，您可以編輯任何We.Retail語言副本頁面（或任何其他即時副本頁面），然後選取​即時副本狀態​模式。

您可以在下列位置找到MSM層定義（以供參考）:

/libs/wcm/msm/content/touch-ui/authoring/editor/js/msm.Layer.js

程式碼範例

此範例套件會示範如何建立新層（模式），這是MSM檢視的新層。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-authoring-new-layer-mode專案
• 將專案下載為a ZIP檔案

將新選擇類別添加到資產瀏覽器

資產瀏覽器會顯示各種類型/類別的資產（例如影像、檔案等）。 資產也可依這些資產類別篩選。

程式碼範例

aem-authoring-extension-assetfinder-flickr 是範例套件，說明如何將新群組新增至資產尋找器。此範例會連結至Flickr的公開資料流，並在側面板中顯示。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-authoring-extension-assetfinder-flickr專案
• 將專案下載為a ZIP檔案

篩選資源

編寫頁面時，使用者通常必須從資源（例如頁面、元件、資產等）中選取。 這可以採用清單的形式，例如，作者必須從中選擇項目。

為了使清單保持在合理的大小以及與使用案例相關的大小，可以以自訂述詞的形式實施篩選器。 例如，如果使用pathbrowser Granite元件來允許使用者選取特定資源的路徑，則可透過下列方式篩選呈現的路徑：

• 實作com.day.cq.commons.predicate.AbstractNodePredicate介面以實作自訂述詞。
• 指定謂語的名稱，並在使用pathbrowser時參考該名稱。

如需建立自訂述詞的詳細資訊，請參閱本文。

將新操作添加到元件工具欄

每個元件（通常）都有工具列，可供存取該元件可採取的一系列動作。

程式碼範例

aem-authoring-extension-toolbar-screenshot 是範例套件，說明如何建立自訂工具列動作來轉譯元件。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-authoring-extension-toolbar — 螢幕擷取專案
• 將專案下載為a ZIP檔案

添加新的就地編輯器

標準就地編輯器

在標準的 AEM 配置中：

1. /libs/cq/gui/components/authoring/editors/clientlibs/core/js/editors/editorExample.js

   保留可用各種編輯器的定義。

2. 編輯器與可使用的每種資源類型（如元件中）之間有連接：

   • cq:inplaceEditing

     例如：

     • /libs/foundation/components/text/cq:editConfig

     • /libs/foundation/components/image/cq:editConfig

       • 屬性: editorType

         定義觸發該元件就地編輯時將使用的內嵌編輯器類型；例如text、textimage、image、title。

3. 編輯器的其他配置詳細資訊可以使用包含配置的config節點以及包含必要插件配置詳細資訊的其他plugin節點進行配置。

   以下是定義影像元件的影像裁切外掛程式外觀比例的範例。 請注意，由於螢幕大小可能非常有限，裁切接受率會移至全螢幕編輯器，而且只能在此顯示。

   <cq:inplaceEditing
           jcr:primaryType="cq:InplaceEditingConfig"
           active="{Boolean}true"
           editorType="image">
           <config jcr:primaryType="nt:unstructured">
               <plugins jcr:primaryType="nt:unstructured">
                   <crop jcr:primaryType="nt:unstructured">
                       <aspectRatios jcr:primaryType="nt:unstructured">
                           <_x0031_6-10
                               jcr:primaryType="nt:unstructured"
                               name="16 : 10"
                               ratio="0.625"/>
                       </aspectRatios>
                   </crop>
               </plugins>
           </config>
   </cq:inplaceEditing>
   

   注意

   請注意，在AEM裁切比例中，由ratio屬性設定，定義為​height/width。 這與傳統的寬度/高度定義不同，且是由於舊版相容性原因而完成。 如果您清楚定義name屬性，製作使用者將不會察覺到任何差異，因為這是UI中顯示的內容。

建立新的就地編輯器

若要實作新的就地編輯器（在您的clientlib內）:

1. 實作：

   • setUp
   • tearDown

2. 註冊編輯器（包括建構子）:

   • editor.register

3. 提供編輯器與可使用的每個資源類型（如元件中）之間的連線。

建立新就地編輯器的程式碼範例

aem-authoring-extension-inplace-editor 是範例套件，說明如何在AEM中建立新的就地編輯器。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-authoring-extension-inplace-editor專案
• 將專案下載為a ZIP檔案

配置多個就地編輯器

您可以設定元件，使元件擁有多個就地編輯器。 設定多個就地編輯器時，您可以選取適當的內容並開啟適當的編輯器。 如需詳細資訊，請參閱設定多個就地編輯器檔案。

新增頁面動作

若要將新頁面動作新增至頁面工具列，例如​返回Sites（主控台）動作。

程式碼範例

aem-authoring-extension-header-backtosites 是範例套件，說明如何建立自訂標頭列動作以跳回Sites主控台。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-authoring-extension-header-backtosites專案
• 將專案下載為a ZIP檔案

自訂啟動工作流程請求

當內容作者沒有適當的復寫權限時，會自動觸發現成可用的工作流程​啟動要求。

若要在這類啟動時擁有自訂行為，您可以覆蓋​啟動請求​工作流程：

1. 在/apps中覆蓋​Sites​嚮導：

   /libs/wcm/core/content/common/managepublicationwizard

   注意

   這本身會覆寫下列的常見例項：

   /libs/cq/gui/content/common/managepublicationwizard

2. 視需要更新工作流程模型和相關設定/指令碼。

3. 從所有相關頁面的所有適當使用者移除 replicate動作的權利；讓任何使用者嘗試發佈（或復寫）頁面時，將此工作流程觸發為預設動作。