文字元件 text-component

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
核心組件

建立對象：

開發人員
管理員
使用者

核心元件文字元件是 RTF 文字編輯和撰寫元件，具備就地編輯功能。

TIP

您是否考慮過適用於 AEM 的 Edge Delivery Services？

現有的專案可以繼續使用本文件中所述的方法。然而，針對新專案，Adobe 建議採用 Edge Delivery Services。

用途 usage

文字元件提供強大的 RTF 文字編輯器，允許在簡化的內嵌編輯器與全螢幕格式中輕鬆編輯文字。

編輯對話框提供內嵌編輯功能，但選項有限；完整功能則可在全螢幕編輯對話框中使用。使用設計對話框，內容作者可設定範本的文字格式選項，例如標題、特殊字元和段落樣式。

版本和相容性 version-and-compatibility

文字元件的目前版本為 v2，此版本於 2018 年 1 月隨著核心元件 2.0.0 版發行導入，詳情請參閱本文件。

下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本，以及舊版文件的連結。

元件版本

AEM 6.4

AEM 6.5

AEM 6.5 LTS

AEM as a Cloud Service

與
2.17.4 版及更早版本相容

相容

如需核心元件版本和發行版本的進一步詳細資訊，請參閱核心元件版本文件。

範例元件輸出 sample-component-output

若要體驗「文字元件」，並檢視其設定選項及 HTML 和 JSON 輸出的範例，請造訪「元件庫」。

技術詳細資訊 technical-details

在 GitHub 上可找到有關文字元件的最新技術文件。

如需開發「核心元件」的進一步詳細資訊，請參閱核心元件開發人員文件。

文字元件和 RTF 文字編輯器 the-text-component-and-the-rich-text-editor

核心元件文字元件採用 AEM RTF 文字編輯器 (RTE)。RTE 為內容作者提供編輯其文字內容的廣泛功能。RTE 的設定非常彈性，並提供多個選項。如需有關如何設定 RTE 的詳細資訊，請參閱文章設定 RTF 文字編輯器和設定 RTF 文字編輯器外掛程式。

本文章的其餘部分示範使用現成 RTE 設定的核心元件文字元件的標準設定。

NOTE

只有 RTE 的 UI 設定所啟用的選項在文字元件中可用。

編輯對話框 edit-dialog

編輯對話框提供使用者將用於撰寫文字的標準 RTF 文字格式工具。

文字元件的編輯對話框

粗體

用於將粗體格式套用至選取的文字，或將游標後方輸入的文字設定為粗體格式。

Ctrl+B 可以當做鍵盤快速鍵使用。

斜體

用於將斜體格式套用至選取的文字，或將游標後方輸入的文字設定為斜體格式。

Ctrl+I 可以當做鍵盤快速鍵使用。

底線

用於將底線格式套用至選取的文字，或將游標後方輸入的文字加上底線。

Ctrl+U 可以當做鍵盤快速鍵使用。

下標

用於將選取的文字或在游標後方輸入的文字格式化為下標。

上標

用於將選取的文字或在游標後方輸入的文字格式化為上標。

以文字格式貼上

將任何複製的文字以純文字形式貼上，不包含任何格式。

當選取此選項時，會開啟一個視窗，可將文字以不含任何格式的純文字形式貼上，作為預覽內容，之後再插入至正文。點選或按一下核取記號即可接受，點選或按一下 x 可取消。

以文字格式貼上範例

從 Word 貼上

當選取此選項時，會開啟一個視窗，可將文字保留原有格式貼上，作為預覽內容，之後再插入至正文。點選或按一下核取記號即可接受，點選或按一下 x 可取消。

從 Word 貼上範例

超連結

使用此選項可將選取的文字轉換為超連結或修改已定義的連結。此選項只有在已選取文字時才會啟用，並開啟一個具有額外連結設定選項的視窗。

超連結範例

輸入路徑
- 使用開啟選取對話框，在 AEM 中選擇路徑
- 如果連結不在 AEM 中，請輸入絕對 URL
  - 非絕對路徑會解譯為相對於 AEM
輸入連結的替代說明文字
選取連結行為
- 目標
- 相同索引標籤
- 新索引標籤
- 上層框架
- 上框架
點選或按一下核取記號以套用連結，或點選 x 以取消。

取消連結

使用此選項可移除已套用至所選文字的連結。此選項僅在已選取連結時才會啟用。

尋找

使用此選項來搜尋文字，找出指定文字字串的出現位置。選取此選項會開啟一個視窗，用以指定搜尋選項。

尋找範例

輸入您要搜尋的文字，然後點選或按一下尋找開始搜尋。點選或按一下 x 以取消。
如果您想要根據大小寫進行完全比對，請先選取選項 符合大小寫，再開始搜尋。
如果找到相符項目，則會醒目提示該項目，且搜尋對話框會變暗。在變暗的對話框中，再次點選或按一下尋找按鈕以搜尋下一個出現位置。

已找到的尋找範例

如果未找到其他出現位置，則會顯示訊息，並從文字的開頭重新開始搜尋。

尋找未找到其他項目的範例

取代

使用此選項來搜尋文字，找出指定文字字串的出現位置，並將相符項目取代為其他字串。選取此選項會開啟一個視窗，用於指定搜尋和取代選項。

取代範例

輸入要搜尋的文字以及應取代的文字。

點選或按一下尋找開始搜尋。按一下或點選 x 以取消。
如果您想要根據大小寫進行完全比對，請先選取選項 符合大小寫，再開始搜尋。
選取 全部取代 以一次取代所有出現的文字。

如果找到相符項目，則會醒目提示該項目，且搜尋對話框會變暗。在變暗的對話框中再次按一下尋找按鈕以搜尋下一個出現位置，或選取取代按鈕以取代醒目提示的相符文字。請注意，取代按鈕只有在進行比對後才會啟用。

按一下「尋找」時，「尋找和取代」對話框會變成透明，按一下「取代」時，對話框會變成不透明。這可讓作者檢閱作者將取代的文字。

NOTE

使用取代功能時，要取代的取代字串應與尋找字串同時輸入。不過，您仍然可以按一下「尋找」來搜尋字串，然後再取代它。如果在按一下「尋找」之後輸入取代字串，則搜尋會重設回文字的開頭。

向左對齊文字

用於將文字對齊左邊界。

文字置中

用於將文字置中。

向右對齊文字

用於將文字對齊右邊界。

項目符號

用於將選取的文字格式化為項目符號清單，或在游標後開始插入項目符號清單。

若要結束項目符號清單，請再次點選或按一下 「項目符號」 按鈕，或輸入兩個歸位字元。

編號

用於將選取的文字格式化為編號符號清單，或在游標後開始插入編號符號清單。

若要結束編號符號清單，請再次點選或按一下 「編號符號」 按鈕，或輸入兩個歸位字元。

凸排

用來減少所選文字或在游標之後輸入的文字的縮排等級。

只有當選取的文字或游標位置已經縮排時才會啟用。

縮排

用來增加所選文字或在游標之後輸入的文字的縮排等級。

表格

用於將表格插入文字中。選取此選項會開啟一個視窗，用於指定表格的詳細資訊。

表格範例

欄 - 表格的欄數 (必要)
列 - 表格的列數 (必要)
寬度 - 表格的寬度
高度 - 表格的高度
儲存格內邊距 - 儲存格內容周圍的空間
儲存格間距 - 儲存格之間的間距
框線 - 表格的框線粗細
- 如果針對表格的標頭：
  - 應使用第一列
  - 應使用第一欄
  - 應使用第一列和第一欄
  - 或不應使用任何標頭。
標題 - 表格的標題

檢查拼字

用於檢查文字內容的拼字。可能的拼字錯誤會以紅色虛線加底線標示。

如需拼字檢查與自訂拼字檢查字典的詳細資訊，請參閱設定 RTF 文字編輯器外掛程式文件。

特殊字元 special-characters

用於將特殊字元插入文字中。選取此選項會開啟顯示可用字元的視窗。

特殊字元範例

點選或按一下所需的字元，將其插入游標之後的文字中。可以插入多個字元。點選或按一下 x 以關閉選取視窗。

原始碼編輯

用於檢視及修改文字的 HTML 原始碼。

點選或按一下 原始碼編輯 圖示，從格式化檢視變更文字內容以檢視原始 HTML。在此模式中，會停用所有其他格式選項。再次點選或按一下 原始碼編輯 圖示可返回格式化檢視。

CAUTION

和存取原始 HTML 的情況一樣，使用 原始碼編輯 選項時必須小心！

透過 原始碼編輯 輸入的 HTML 會進行掃描以確認是否有 XSS 風險，若插入任何指令碼都會被移除，且不會顯示在結果頁面上。不過，在 原始碼編輯 中輸入格式錯誤的 HTML 可能會破壞頁面的範本，導致非預期的格式設定或導致產生的頁面無法使用。

NOTE

由於透過 原始碼編輯 輸入的 HTML 已掃描確認是否具有 XSS 風險和任何指令碼，並且會自動移除找到的指令碼，因此保留的實際內容可能會與 原始碼編輯 中輸入的內容不同。因此，若要儲存使用 原始碼編輯 所做的變更，您必須先退出 原始碼編輯 ，以在儲存前於一般編輯器中檢視文字。