使用AEM元件自訂DITA元素對應 id1679J600HEL

系統會根據元素名稱，先搜尋每個DITA元素以尋找對應的元件對應。 例如：

<ditaelement>
   <name>**substeps**</name>
   <class>- topic/ol task/substeps</class>
   <componentpath>dita/components/ditaolist</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
</ditaelement>

在上述範例中，所有substeps DITA元素都是使用dita/components/ditaolist元件轉譯。

如果DITA元素找不到以名稱為基礎的相符專案，則會完成以class為基礎的相符專案。 例如：

<ditaelement>
   <name>topic</name>
   <class>**- topic/topic**</class>
   <componentpath>fmdita/components/dita/topic</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
   <attributemap>
      <attribute from="id" to="id" />
   </attributemap>
</ditaelement>

在上述範例中，如果沒有為task元素定義對應，則task元素會對應至上述元件，因為task繼承自topic元件。

當元素具有對應的元件對應時，其子元素的進一步處理由type決定。 例如：

<ditaelement>
   <name>title</name>
   <class>- topic/title</class>
   <componentpath>foundation/components/title</componentpath>
   <type>**STANDALONE**</type>
   <target>para</target>
   <textprop>jcr:title</textprop>
</ditaelement>

type採用下列值：

• COMPOSITE：子元素​ 的元素與元件 ​的對映也會繼續。

• STANDALONE：目前專案的子專案是​未進一步對應。

在上述範例中，若<title>元素具有任何子元素，則不會對應至任何其他元件。 <title>元素的元件負責轉譯<title>元素內的所有子元素。

如果有多個元件對應至單一DITA元素，則會選取該元素的最佳相符專案。 若要選取最佳相符元件，會考慮DITA元素的領域和結構專門化。

如果有具有領域專門化的DITA元素，且元件對應到領域專門化，則該元件會獲得高優先順序。

同樣地，如果有具有結構專門化的DITA元素，且元件對應結構專門化，則該元件會獲得高優先順序。

您可以在元素對應中使用<attributemap>，將屬性值對應至對應的節點屬性。

textprop可用來將DITA元素的文字內容序列化為node屬性。 此外，它可以在元素標籤中多次使用，以將已發佈階層中多個位置的文字內容序列化。 您也可以自訂目標屬性的位置和名稱。 例如：

<ditaelement>
   <name>title</name>
   <componentpath>foundation/components/title</componentpath>
   <type>STANDALONE</type>
   <target>para</target>
    <textprop>**jcr:title**</textprop>
</ditaelement>

以上元素對應指定<title>元素的文字內容將會儲存為輸出節點上名為jcr:title之屬性的值。

xmlprop可用來將指定專案的整個XML序列化為節點屬性。 元件將可讀取此節點屬性並執行自訂轉譯。 例如：

<ditaelement>
    <name>svg-container</name>
   <class>+ topic/foreign svg-d/svg-container</class>
    <componentpath>fmdita/components/dita/svg</componentpath>
    <type>STANDALONE</type>
    <target>para</target>
   <xmlprop>**data**</xmlprop>
</ditaelement>

以上專案對應指定專案<svg-container>的整個XML標籤將會儲存為輸出節點上名為data之屬性的值。

有一個特殊的屬性對應，可在輸出產生程式中處理路徑解析。 例如：

<attributemap>
   <attribute from="href" to="fileReference" ispath="true" rel="source" />
   <attribute from="height" to="height" />
    <attribute from="width" to="width" />
</attributemap>

對於上述attributemap，您DITA元素中的href屬性將對應至名為fileReference的節點屬性。 現在，由於ispath設定為true，輸出產生程式會解析此路徑，然後在fileReference節點屬性中設定它。

此解析如何根據屬性對應中rel屬性的值來決定。

• 如果rel=source，則會針對目前處理中的DITA來源檔案解析href的值。 href的值已解析並置於fileReference屬性的值中。

• 如果rel=target，則相對於根發佈位置解析href的值。 href的值已解析並置於fileReference屬性的值中。

如果您不想在路徑屬性上發生任何前置處理或解析，則不需要指定ispath屬性。 值會依原樣複製，元件可執行所需的解析度。