支架 scaffolding

有時您可能需要建立大型頁面集,這些頁面具有共用結構但內容不同。 透過標準Adobe Experience Manager (AEM)介面,您需要建立每個頁面、將適當的元件拖曳到頁面上,並個別填入每個元件。

使用支架,您可以建立包含欄位的表單(支架),這些欄位會反映您想要用於頁面的結構,然後使用此表單以根據此結構輕鬆建立頁面。

NOTE
支架(在傳統UI中) 遵守MSM繼承

支架如何運作 how-scaffolding-works

支架儲存在網站管理員的​ 工具 ​主控台中。

  • 開啟​ 工具 ​主控台,然後按一下​ 預設頁面支架
  • 在此底下,按一下​ Geometrixx
  • 在​ Geometrixx ​下,您找到名為​ 新聞 ​的​ 支架頁面。 按兩下以開啟此頁面。

howscaffolds_work

支架包含一個表單,其中針對要建立之頁面的每個內容片段都有一個欄位,以及四個重要引數,這些引數可透過支架頁面的​ 頁面屬性 ​存取。

pageprops

支架頁面屬性包括:

  • 標題文字:這是此支架頁面本身的名稱。 在此範例中,它稱為「新聞」。
  • 描述:這會顯示在支架頁面的標題下方。
  • 目標範本:這是此支架在建立頁面時將使用的範本。 在此範例中,它是​ Geometrixx內容頁面 ​範本。
  • 目標路徑:這是此支架將在其下建立頁面的上層頁面的路徑。 在此範例中,路徑是​ /content/geometrixx/en/news

架構的正文即為形式。 當使用者希望使用支架建立頁面時,他填寫表單並按一下底部的​ 建立。 在表單上方的​ 新聞 ​範例中,有下列欄位:

  • 標題:這是要建立之頁面的名稱。 此欄位一律存在於每個支架上。
  • 文字:此欄位對應到結果頁面上的文字元件。
  • 影像:此欄位對應到結果頁面上的影像元件。
  • 影像/進階標題:影像的標題。
  • 影像/進階替代文字:影像的替代文字。
  • 影像/進階描述:影像描述。
  • 影像/進階大小:影像大小。
  • 標籤/關鍵字:要指派給此頁面的中繼資料。 此欄位一律存在於每個支架上。

建立支架 creating-a-scaffold

若要建立支架,請前往​ 工具 ​主控台,然後​ 預設頁面支架 ​並建立頁面。 單一頁面範本型別可使用,支架範本。

前往新頁面的​ 頁面屬性,並設定​ 標題文字描述目標範本 ​和​ 目標路徑,如上所述。

接下來,您必須定義此支架將建立的頁面結構。 若要這麼做,請進入支架頁面上的​ 設計模式。 會出現連結,讓您在​ 對話方塊編輯器 ​中編輯支架。

cq5_dialog_editor

使用對話方塊編輯器,您可以指定每次使用此支架建立新頁面時將建立的屬性。

支架的對話方塊定義與元件的定義運作方式類似(請參閱元件)。 不過,還是有一些重要差異:

  • 元件對話方塊定義會呈現為一般對話方塊(例如顯示在對話方塊編輯器的中間窗格中),而支架對話方塊定義雖然會在對話方塊編輯器中呈現為一般對話方塊,卻會在支架頁面上呈現為支架表單(如上方​ 新聞 ​支架所示)。
  • 元件對話方塊僅提供定義單一特定元件內容所需之值的欄位。 架構對話方塊必須為要建立之頁面的每個段落中的每個屬性提供欄位。
  • 如果有元件對話方塊,則用來呈現指定內容的元件是隱含的,因此在建立段落時,會自動填入段落的sling:resourceType屬性。 在架構中,為指定段落定義內容和指派元件的所有資訊都必須由對話方塊本身提供。 在架構對話方塊中,必須使用​ 隱藏 ​欄位來提供此資訊,才能在建立頁面時提交此資訊。

檢視對話方塊編輯器中的範例​ 新聞 ​支架對話方塊有助於說明其運作方式。 在支架頁面上進入設計模式,然後按一下對話方塊編輯器連結。

現在,按一下對話方塊欄位​ 對話方塊>索引標籤面板>文字>文字,如下所示:

textedit

此欄位的屬性清單會顯示在對話方塊編輯器的右側,如下所示:

屬性list_of_properties

請注意此欄位的名稱屬性。 它具有值

./jcr:content/par/text/text

這是使用支架建立頁面時,此欄位內容將寫入的屬性名稱。 屬性是以節點的相對路徑來表示,代表要建立的頁面。 它指定節點文字下方的屬性文字,節點文字本身是頁面節點下方jcr:content節點的子節點。

這會定義將輸入至此欄位之文字的內容儲存位置。 不過,我們還需要為此內容指定兩個特性:

  • 此處儲存的字串必須解譯為​ RTF文字,而且
  • 應使用哪個元件來將此內容轉譯至產生的頁面。

在一般元件對話方塊中,您不必指定此資訊,因為對話方塊已繫結至特定元件是隱含的。

若要指定這兩個資訊,請使用隱藏欄位。 按一下第一個隱藏欄位​ 對話方塊>索引標籤面板>文字>隱藏,如下所示:

隱藏

此隱藏欄位的屬性如下:

hidden_list_props

此隱藏欄位的name屬性為

./jcr:content/par/text/textIsRich

這是布林值屬性,用來解譯儲存在./jcr:content/par/text/text的文字字串。

因為我們知道文字應該解譯為RTF文字,所以讓我們將此欄位的value屬性指定為true

CAUTION
對話方塊編輯器允許使用者變更對話方塊定義中​ existing ​屬性的值。 若要新增屬性,使用者必須使用CRXDE Lite。 例如,當使用對話方塊編輯器將新的隱藏欄位新增到對話方塊定義時,它沒有​ value ​屬性(也就是名稱為「value」的屬性)。 如果有問題的隱藏欄位需要設定預設值屬性,則必須使用其中一個CRX工具手動新增此屬性。 無法以對話方塊編輯器本身新增值。 不過,屬性一旦出現,您就可使用對話方塊編輯器來編輯其值。

第二個隱藏欄位可以按一下顯示,如下所示:

隱藏2

此隱藏欄位的屬性如下:

hidden_list_props2

此隱藏欄位的name屬性為

./jcr:content/par/text/sling:resourceType

而且為此屬性指定的固定值為

foundation/components/textimage

這會指定呈現此段落文字內容所使用的元件是​ 文字影像 ​元件。 搭配其他隱藏欄位中指定的isRichText布林值使用,元件可以依照所需方式轉譯儲存在./jcr:content/par/text/text的實際文字字串。

使用MSM繼承的支架 scaffolding-with-msm-inheritance

在傳統UI中,支架與MSM繼承完全整合(如適用)。

當您以​ 支架 ​模式(使用sidekick底部的圖示)開啟頁面時,受繼承限制的任何元件都將以下列方式指示:

  • 鎖定符號(適用於大多數元件;例如,文字和標題)
  • 包含文字的遮色片​ 按一下以取消繼承 (針對影像元件)

這些符號表示在取消繼承之前,無法編輯元件。

chlimage_1

NOTE
這相當於編輯頁面內容時繼承的元件

按一下鎖定符號或影像圖示可讓您中斷繼承:

  • 符號會變更為開啟的掛鎖。
  • 解鎖後,即可編輯內容。

chlimage_1-1

解鎖後,您可以按一下解鎖的掛鎖符號來還原繼承 — 這會遺失您所做的任何編輯。

NOTE
如果在頁面層級取消繼承(從「頁面屬性」的Livecopy索引標籤),則所有元件都可在​ 支架 ​模式中編輯(這些元件會以解鎖狀態顯示)。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2