以自訂 ID 管理標記的文字

Angular 擷取工具會針對下列每種情況，產生一個含有翻譯單元條目的檔案。

如意義如何控制文字擷取與合併所述，Angular 會為每個翻譯單元指派唯一的 ID。

下列範例顯示具有唯一 ID 的翻譯單元。

<trans-unit id="ba0cc104d3d69bf669f97b8d96a4c5d8d9559aa3" datatype="html">

當你變更可翻譯的文字時，擷取工具會為該翻譯單元產生新的 ID。在大多數情況下，來源文字變更時，翻譯也需要跟著變更。因此，使用新的 ID 能讓文字變更與翻譯保持同步。

不過，有些翻譯系統要求 ID 採用特定的形式或語法。為了滿足這項要求，請使用自訂 ID 來標記文字。大多數開發者不需要使用自訂 ID。若你想用獨特的語法傳達額外的中繼資料，請使用自訂 ID。額外的中繼資料可以包括文字出現的函式庫、元件，或應用程式中的區域。

若要在 i18n 屬性或 $localize 標記訊息字串中指定自訂 ID，請使用 @@ 前綴。下列範例在標題元素中定義了 introductionHeader 自訂 ID。

<h1 i18n="@@introductionHeader">Hello i18n!</h1>

下列範例為變數定義了 introductionHeader 自訂 ID。

variableText1 = $localize`:@@introductionHeader:Hello i18n!`;

指定自訂 ID 後，擷取工具會產生一個帶有該自訂 ID 的翻譯單元。

<trans-unit id="introductionHeader" datatype="html">

若你變更文字，擷取工具不會變更 ID。如此一來，你就不必多花一個步驟去更新翻譯。使用自訂 ID 的缺點是：若你變更文字，你的翻譯可能與變更後的來源文字不同步。

搭配說明使用自訂 ID

將自訂 ID 與說明、意義搭配使用，能進一步協助譯者。

下列範例先包含一段說明，接著是自訂 ID。

<h1 i18n="An introduction header for this sample@@introductionHeader">Hello i18n!</h1>

下列範例為變數定義了 introductionHeader 自訂 ID 與說明。

variableText2 = $localize`:An introduction header for this sample@@introductionHeader:Hello i18n!`;

下列範例加入了意義。

<h1 i18n="site header|An introduction header for this sample@@introductionHeader">Hello i18n!</h1>

下列範例為變數定義了 introductionHeader 自訂 ID。

variableText3 = $localize`:site header|An introduction header for this sample@@introductionHeader:Hello i18n!`;

請務必定義唯一的自訂 ID。若你對兩個不同的文字元素使用相同 ID，擷取工具只會擷取第一個，而 Angular 會用該翻譯取代兩個原始文字元素。

例如，在下列程式碼片段中，兩個不同的文字元素定義了相同的 myId 自訂 ID。

<h3 i18n="@@myId">Hello</h3>
<!-- ... -->
<p i18n="@@myId">Good bye</p>

下列顯示法文翻譯。

<trans-unit id="myId" datatype="html">
  <source>Hello</source>
  <target state="new">Bonjour</target>
</trans-unit>

兩個元素現在都使用相同的翻譯 (Bonjour)，因為兩者定義了相同的自訂 ID。

<h3>Bonjour</h3>
<!-- ... -->
<p>Bonjour</p>