文字元件

核心元件文本元件是RTF編輯和合成元件，具有就地編輯功能。

使用狀況

文字元件提供強大的RTF編輯器，以簡化的內嵌編輯器和全螢幕格式輕鬆編輯文字。

edit dialog使用全螢幕編輯對話框中提供的有限功能選項進行串聯編輯。 使用設計對話框，可為內容作者的模板配置標題、特殊字元和段落樣式等文本格式選項。

版本和相容性

目前的文字元件版本為v2，此版本於2018年1月隨核心元件2.0.0版推出，本檔案將加以說明。

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

如需核心元件版本和版本的詳細資訊，請參閱檔案核心元件版本。

元件輸出示例

若要體驗文字元件，並查看其設定選項以及HTML和JSON輸出的範例，請造訪元件程式庫。

技術詳細資訊

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

有關開發核心元件的詳細資訊，請參閱核心元件開發人員檔案。

文本元件和RTF編輯器

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

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

編輯對話框

編輯對話方塊提供使用者預期要撰寫文字的標準RTF格式工具。

粗體

用於將粗體格式應用於選定文本或在游標後輸入的大膽格式文本。

Ctrl+ B可用作鍵盤快速鍵。

斜體

用於將斜體格式應用到選定文本或在游標之後輸入的斜體文本。

Ctrl+ 可用作鍵盤快捷鍵。

底線

用於將下划線格式應用於在游標之後輸入的選定文本或下划線文本。

Ctrl+ Ucan用作鍵盤快捷鍵。

下標

用於將游標之後輸入的選定文本或文本格式化為下標。

上標

用於將游標之後輸入的選定文本或文本格式化為上標。

貼上為文字

將任何複製的文本貼上為純文字檔案，不使用任何格式。

選取此選項時，將開啟一個窗口，其中文本可以貼上為純文字檔案，在插入文本之前，不以格式作為預覽。 點選或按一下複選標籤以接受，點選或按一下x以取消。

從 Word 貼上

選取此選項時，會開啟一個視窗，可以貼上文字，在將其插入文字之前，將其格式維持為預覽。 點選或按一下複選標籤以接受，點選或按一下x以取消。

超連結

使用此選項可將選定文本轉換為超連結或修改已定義的連結。 只有在已選取文字時，此選項才會作用中，並會開啟包含其他連結設定選項的視窗。

• 輸入路徑

  • 使用「開啟選擇」對話框在AEM中選擇路徑
  • 如果連結不在AEM內，請輸入絕對URL
    • 非絕對路徑會解譯為相對於AEM

• 輸入連結的替代描述性文字

• 選取連結行為

  • 目標
  • 相同索引標籤
  • 新索引標籤
  • 父框架
  • 上框架

  點選或按一下核取記號以套用連結，或按x以取消。

取消連結

使用此選項可移除已套用至所選文字的連結。 只有在已選取連結時，此選項才會作用中。

尋找

使用此選項可搜索文本以查找指定文本字串的出現。 選擇此選項將開啟一個窗口，用於指定搜索選項。

輸入要搜索的文本，點選或按一下​Find​以開始搜索。 點選或按一下x以取消。
如果要根據大小寫進行完全匹配，請在開始搜索之前選擇選項​匹配大小寫。
如果找到相符項目，則會加亮顯示，而搜尋對話方塊則呈現灰色。 在灰色對話方塊中，再點選或按一下​尋找​按鈕，以搜尋下一個出現次數。

如果找不到其他發生次數，則會顯示訊息，並從文字的開頭開始搜尋。

取代

使用此選項可搜索文本以查找指定文本字串的出現次數，並將匹配項替換為另一個字串。 選擇此選項將開啟一個窗口，用於指定搜索和替換選項。

輸入要搜索的文本以及應替換的文本。

• 點選或按一下​尋找​以開始搜尋。 按一下或點選x以取消。
• 如果要根據大小寫進行完全匹配，請在開始搜索之前選擇選項​匹配大小寫。
• 選擇​全部替換​一次替換所有出現的文本。

如果找到相符項目，則會加亮顯示，而搜尋對話方塊則呈現灰色。 再次在灰色對話框中按一下​查找​按鈕以搜索下一個出現項，或選擇​替換​按鈕以替換突出顯示的匹配文本。 請注意，Replace​按鈕僅在匹配後才處於活動狀態。

點擊查找時，查找和替換對話框變為透明，點擊替換時變為不透明。 這可讓作者檢閱作者將取代的文字。

向左對齊文字

用來將文字對齊左側邊界。

文字置中

用來將文字置中。

向右對齊文字

用於將文字對齊右側邊界。

項目符號

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

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

編號

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

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

凸排

用於減少在游標之後輸入的選定文本或文本的縮進級別。

僅當游標的選定文本或位置已縮排時才處於活動狀態。

縮排

用於增加在游標之後輸入的選定文本或文本的縮進級別。

表格

用於將表插入文本中。 選擇此選項將開啟一個窗口，用於指定表的詳細資訊。

• 列 — 表的列數（必要）
• 行 — 表格的行數（必要）
• 寬度 — 表格的寬度
• 高度 — 表格的高度
• 儲存格邊框間距 — 儲存格內容周圍的空格
• 儲存格間距 — 儲存格之間的空間
• 邊框 — 表格邊框的粗細
  • 若表格的標題：
    • 應使用第一列
    • 應使用第一欄
    • 應使用第一列和第一列
    • 或者不應使用標題。
• 註解 — 表格的註解

檢查拼寫

用於檢查文本內容的拼寫。 可能拼錯的字，加上破折的紅線。

有關拼字檢查和自定義拼字檢查字典的詳細資訊，請參見文檔配置RTF編輯器插件。

特殊字元

用於將特殊字元插入文字中。 選擇此選項將開啟一個顯示可用字元的窗口。

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

來源編輯

用於查看和修改文本的HTML源。

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

段落格式

用於將段落格式應用於選定文本或游標後插入的文本。 選擇此選項將開啟一個下拉清單，從中選擇段落格式。

行內編輯

文本元件也可以聯機編輯，但由於空間限制，並非所有格式選項都可以聯機編輯。 若要查看所有選項，請切換至全螢幕模式。

設定和ID

此選項可控制HTML和資料層中元件的唯一標識符。

• 若保留為空白，系統會自動為您產生唯一ID，並且可透過檢查產生的頁面來找到。
• 若已指定ID，則作者應負責確認其唯一。
• 變更ID可能會影響CSS、JS和資料層追蹤。

設計對話框

設計對話方塊可讓範本作者定義內容作者可使用的文字格式選項。

插件頁簽

外掛程式索引標籤可用來啟用和停用內容作者可用的各種文字格式選項。

功能

可為元件啟用或停用下列功能。

• 貼上純文字
• 過去
• 查找和替換
• 拼字檢查程式
• 插入的影像修改選項
• HTML來源編輯

正在格式化

可為元件啟用或停用下列格式選項。

• 表格
• 清單（項目符號、數字、縮進、縮進）
• 對齊方式（左、右、居中）
• 粗體，斜體，底線
• 連結（和取消連結）
• 子/上標

段落樣式

可為元件啟用或停用段落樣式。 激活後，可定義允許的格式。

• 點選或按一下​Add​按鈕以插入新樣式。
• 輸入樣式的代碼以及將在編輯對話框中顯示的說明。
• 若要移除樣式點選，或按一下「刪除」按鈕。
• 要重新排列格式的順序，請點選或按一下並拖動控點。

特殊字元

可為元件啟用或停用插入特殊字元的選項。 啟動後，可定義允許的字元。

• 點選或按一下​Add​按鈕以插入新字元。
• 輸入字元的HTML代碼，以及將在編輯對話方塊中顯示的說明。
• 若要移除字元點選，或按一下「刪除」按鈕。
• 要重新排列字元點選的順序，或按一下並拖動控點。

樣式標籤

文本元件支援AEM style system。

Adobe客戶端資料層

文本元件支援Adobe客戶端資料層。