文字元件

核心元件文字元件是富格文字編輯與合成元件，具備就地編輯功能。

使用狀況

文字元件提供強穩的豐富式文字編輯器，讓您在簡化的內嵌編輯器中，以及全螢幕格式輕鬆編輯文字。

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

版本和相容性

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

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

有關核心元件版本和版本的詳細資訊，請參閱文檔核心元件版本。

元件輸出示例

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

技術詳細資訊

有關Text Component 的最新技術文檔可在GitHub上找到。

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

The Text Component and the Rich Text Editor

Core Components Text Component利用Rich AEM Text Editor(RTE)。 RTE為內容作者提供了多種功能，以編輯其文本內容。 RTE的配置非常靈活，並提供了多種選項。 有關如何配置RTE的詳細資訊，請參閱 Configure the Rich Text Editor和 Configure the Rich Text Editor plug-ins文章。

本文的其餘部分演示了使用現成可用的RTE配置的核心元件文本元件的標準配置。

編輯對話框

編輯對話方塊提供使用者預期要合成文字的標準豐富文字格式工具。

粗體

用於將粗體格式套用至選取的文字，或大膽格式化游標後輸入的文字。

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

斜體

用於將斜體格式套用至選取的文字或在游標後輸入的斜體文字。

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

底線

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

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

下標

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

上標

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

貼上為文字

將任何複製的文字貼上為純文字，不需任何格式。

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

從 Word 貼上

選取此選項時，會開啟一個視窗，可在其中貼上文字，並保留其格式為預覽，然後再將它插入文字。 點選或按一下核取標籤以接受，點選或按一下x以取消。

超連結

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

• 輸入路徑

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

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

• 選取連結行為

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

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

取消連結

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

尋找

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

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

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

取代

使用此選項可搜尋文字中是否出現指定的文字字串，並以其他字串取代相符項目。 選擇此選項將開啟一個窗口，用於指定搜索和替換選項。

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

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

如果找到相符項目，則會反白顯示，而搜尋對話方塊會暗顯。 再次在暗灰色對話方塊中按一下「尋找​​」按鈕，以搜尋下一個出現的項目，或選取「取代​​」按鈕以取代反白顯示的相符文字。 請注意，Replace​按鈕只有在匹配後才處於活動狀態。

當點按尋找時，尋找和取代對話方塊會變為透明，當點按取代時，對話方塊會變成不透明。 這可讓作者檢閱作者將要取代的文字。

向左對齊文字

用來將文字與左邊距對齊。

文字置中

用來將文字置中。

向右對齊文字

用來將文字對齊右邊距。

項目符號

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

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

編號

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

要結束編號清單，請再次按一下或按一下​Numbered​按鈕，或輸入兩個歸位。

凸排

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

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

縮排

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

表格

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

• 列 -表的列數（必需）
• 行 -表的行數（必需）
• Width —— 表格的寬度
• 高度 -表格的高度
• 單元格間距 -單元格內容周圍的空格
• 單元格間距 -單元格之間的空間
• 邊框 -表格邊框線的重量
  • 如果表的標題：
    • 應使用第一行
    • 應使用第一欄
    • 應使用第一列和第一列
    • 或者不應使用標題。
• 標題 -表格標題

檢查拼字

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

有關拼字檢查和自訂拼字檢查字典的詳細資訊，請參閱檔案設定Rich Text Editor外掛程式。

特殊字元

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

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

來源編輯

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

點選或按一下「來源編輯」圖示，以變更格式化檢視中的文字內容，以檢視原始HTML。 ​​在此模式下，所有其它格式設定選項都被禁用。 再次點選或按一下「Source Edit（源編輯）」表徵圖返回格式化視圖。

段落格式

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

行內編輯

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

設定和ID

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

• 如果保留空白，則會自動為您產生唯一ID，並透過檢查產生的頁面找到。
• 如果指定ID，則作者有責任確保其唯一性。
• 變更ID可能會影響CSS、JS和資料圖層追蹤。

設計對話框

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

外掛程式標籤

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

功能

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

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

正在格式化

可以為元件激活或停用以下格式設定選項。

• 表格
• 清單（項目符號、編號、縮進、縮進）
• 對齊（左、右、居中）
• 粗體、斜體、下划線
• 連結（和取消連結）
• 子／上標

段落樣式

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

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

特殊字元

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

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

樣式標籤

文本元件支AEM持樣式系統。

Adobe客戶端資料層

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