文字元件

核心元件文本元件是一個富文本編輯和合成元件，可進行就地編輯。

使用狀況

「文本元件」提供強大的富格文本編輯器，使用簡化的串聯編輯器和全屏格式可以輕鬆編輯文本。

的 編輯對話框 功能是使用有限選項進行線上編輯，而全屏編輯對話框中提供了全部功能。 使用 設計對話框，可以為內容作者的模板配置文本格式選項，如標題、特殊字元和段落樣式。

版本和相容性

文本元件的當前版本是v2，該版本於2018年1月隨核心元件2.0.0版一同推出，本文檔對此進行了說明。

下表詳細說明了元件的所有受支援版本、AEM元件版本與之相容的版本，以及指向早期版本文檔的連結。

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

元件輸出示例

要體驗文本元件，並查看其配置選項示例以及HTML和JSON輸出，請訪問 元件庫。

技術詳細資訊

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

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

文本元件和富格文本編輯器

核心元件文本元件利AEM用RTE。 RTE為內容作者提供了多種編輯其文本內容的功能。 RTE的配置非常靈活，並提供了多種選項。 有關如何配置RTE的進一步詳細資訊，請參閱文章 配置RTF編輯器 和 配置RTF編輯器插件。

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

編輯對話框

編輯對話框提供了用戶希望合成文本的標準富格文本格式工具。

粗體

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

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

斜體

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

Ctrl+I can be used as a keyboard shortcut.

底線

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

Ctrl+U can be used as a keyboard shortcut.

下標

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

上標

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

貼上為文本

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

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

從 Word 貼上

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

超連結

使用此選項可將所選文本轉換為超連結或修改已定義的連結。 僅當已選擇文本並開啟窗口時，此選項才處於活動狀態，其中包含用於設定連結的其他選項。

• 輸入路徑

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

• 輸入連結的備選說明性文本

• 選擇連結行為

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

  點擊或按一下複選標籤以應用連結，或按一下x以取消。

取消連結

使用此選項可刪除已應用於所選文本的連結。 僅當已選擇連結時，此選項才處於活動狀態。

尋找

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

輸入要搜索的文本，點擊或按一下 查找 開始搜索。 點擊或按一下x取消。
如果要根據大小寫進行精確匹配，請選擇選項 匹配大小寫 開始搜索。
如果找到匹配項，則會加亮該匹配項，並且搜索對話框會變暗。 點擊或按一下 查找 的子菜單。

如果找不到其他出現的情況，將顯示一條消息，並從文本的開頭重新開始搜索。

取代

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

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

• 點擊或按一下 查找 開始搜索。 按一下或點擊x取消。
• 如果要根據大小寫進行精確匹配，請選擇選項 匹配大小寫 開始搜索。
• 選擇 全部替換 來同時替換所有出現的文本。

如果找到匹配項，則會加亮該匹配項，並且搜索對話框會變暗。 按一下 查找 按鈕，以搜索下一個出現項或選擇 替換 按鈕，將選定控制項在Tab鍵次序中下移一個位置。 請注意 替換 只有匹配後，按鈕才處於活動狀態。

The find and replace dialog becomes transparent when find is clicked and becomes opaque when replace is clicked. 這允許作者審閱作者將替換的文本。

向左對齊文字

用於將文本與左邊距對齊。

文字置中

用於居中文本。

向右對齊文字

用於將文本與右邊距對齊。

項目符號

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

要結束項目符號清單，請點擊或按一下 項目符號 按鈕或輸入兩個回車符。

編號

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

要結束編號清單，請點擊或按一下 編號 按鈕或輸入兩個回車符。

凸排

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

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

縮排

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

表格

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

• 列 — 表的列數（必需）
• 行 — 表的行數（必需）
• 寬度 — 表的寬度
• 高度 — 表的高度
• 單元格填充 — 單元格內容周圍的空間
• 單元格間距 — 單元格之間的空格
• 邊框 — 表的邊框線的重量
  • 如果表的標題：
    • 應使用第一行
    • 應使用第一列
    • The first row and first column should be used
    • 或者不應使用標題。
• 標題 — 表的標題

檢查拼寫

Used to check the spelling of the text content. 可能的拼寫錯誤用破折的紅線加下划線。

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

特殊字元

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

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

來源編輯

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

點擊或按一下 源編輯 表徵圖以更改格式化視圖中文本的內容以查看原始HTML。 在此模式下，所有其它格式選項都被禁用。 點擊或按一下 源編輯 表徵圖以返回到格式化視圖。

段落格式

用於將段落格式應用於選定文本或插入游標後的文本。 Selecting this options opens a dropdown from which the paragraph format is selected.

聯機編輯

文本元件也可以串聯編輯，但由於空間限制，並非所有格式選項都可串聯使用。 要查看所有選項，請切換到全屏模式。

設定和ID

此選項允許控制HTML和 資料層。

• 如果留空，則系統會為您自動生成唯一ID，並通過檢查生成的頁面來找到它。
• 如果指定了ID，則作者有責任確保其唯一。
• 更改ID可能會影響CSS、JS和資料層跟蹤。

設計對話框

設計對話框允許模板作者定義內容作者可以使用哪些文本格式選項。

插件標籤

「插件」標籤用於啟用和禁用內容作者可使用的各種文本格式選項。

功能

可以為元件激活或停用以下特徵。

• 貼上純文字檔案
• 過去自單詞
• 查找和替換
• 拼寫檢查
• Inserted image modification options
• HTML源編輯

正在格式化

The following formatting options can be activated or deactivated for the component.

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

段落樣式

Paragraph styles can be activated or deactivated for the component. 激活後，可以定義允許的格式。

• 點擊或按一下 添加 按鈕。
• 輸入樣式的代碼和將在編輯對話框中顯示的說明。
• 要刪除樣式點擊，或按一下 刪除 按鈕
• 要重新排列格式的順序，請點擊或按一下並拖動控制滑塊。

特殊字元

可以為元件激活或停用插入特殊字元的選項。 When activated, the allowed characters can be defined.

• 點擊或按一下 添加 按鈕
• 輸入字元的HTML代碼和將在編輯對話框中顯示的說明。
• 要刪除字元點擊，或按一下 刪除 按鈕
• 要重新排列字元點擊的順序，或按一下並拖動控制滑塊。

樣式頁籤

文本元件支AEM持 風格系統。

Adobe客戶端資料層

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