文字元件 text-component
核心元件文字元件是 RTF 文字編輯和撰寫元件,具備就地編輯功能。
用途 usage
文字元件提供強大的 RTF 文字編輯器,允許在簡化的內嵌編輯器與全螢幕格式中輕鬆編輯文字。
編輯對話框提供內嵌編輯功能,但選項有限;完整功能則可在全螢幕編輯對話框中使用。使用設計對話框,內容作者可設定範本的文字格式選項,例如標題、特殊字元和段落樣式。
版本和相容性 version-and-compatibility
文字元件的目前版本為 v2,此版本於 2018 年 1 月隨著核心元件 2.0.0 版發行導入,詳情請參閱本文件。
下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本,以及舊版文件的連結。
如需核心元件版本和發行版本的進一步詳細資訊,請參閱核心元件版本文件。
範例元件輸出 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 設定的核心元件文字元件的標準設定。
編輯對話框 edit-dialog
編輯對話框提供使用者將用於撰寫文字的標準 RTF 文字格式工具。
粗體
用於將粗體格式套用至選取的文字,或將游標後方輸入的文字設定為粗體格式。
Ctrl+B 可以當做鍵盤快速鍵使用。
斜體
用於將斜體格式套用至選取的文字,或將游標後方輸入的文字設定為斜體格式。
Ctrl+I 可以當做鍵盤快速鍵使用。
底線
用於將底線格式套用至選取的文字,或將游標後方輸入的文字加上底線。
Ctrl+U 可以當做鍵盤快速鍵使用。
下標
用於將選取的文字或在游標後方輸入的文字格式化為下標。
上標
用於將選取的文字或在游標後方輸入的文字格式化為上標。
以文字格式貼上
將任何複製的文字以純文字形式貼上,不包含任何格式。
當選取此選項時,會開啟一個視窗,可將文字以不含任何格式的純文字形式貼上,作為預覽內容,之後再插入至正文。點選或按一下核取記號即可接受,點選或按一下 x 可取消。
從 Word 貼上
當選取此選項時,會開啟一個視窗,可將文字保留原有格式貼上,作為預覽內容,之後再插入至正文。點選或按一下核取記號即可接受,點選或按一下 x 可取消。
超連結
使用此選項可將選取的文字轉換為超連結或修改已定義的連結。此選項只有在已選取文字時才會啟用,並開啟一個具有額外連結設定選項的視窗 。
-
輸入路徑
- 使用開啟選取對話框,在 AEM 中選擇路徑
- 如果連結不在 AEM 中,請輸入絕對 URL
- 非絕對路徑會解譯為相對於 AEM
-
輸入連結的替代說明文字
-
選取連結行為
- 目標
- 相同索引標籤
- 新索引標籤
- 上層框架
- 上框架
點選或按一下核取記號以套用連結,或點選 x 以取消。
取消連結
使用此選項可移除已套用至所選文字的連結。此選項僅在已選取連結時才會啟用。
尋找
使用此選項來搜尋文字,找出指定文字字串的出現位置。選取此選項會開啟一個視窗,用以指定搜尋選項。
輸入您要搜尋的文字,然後點選或按一下 尋找 開始搜尋。點選或按一下 x 以取消。
如果您想要根據大小寫進行完全比對,請先選取選項 符合大小寫,再開始搜尋。
如果找到相符項目,則會醒目提示該項目,且搜尋對話框會變暗。在變暗的對話框中,再次點選或按一下 尋找 按鈕以搜尋下一個出現位置。
如果未找到其他出現位置,則會顯示訊息,並從文字的開頭重新開始搜尋。
取代
使用此選項來搜尋文字,找出指定文字字串的出現位置,並將相符項目取代為其他字串。選取此選項會開啟一個視窗,用於指定搜尋和取代選項。
輸入要搜尋的文字以及應取代的文字。
- 點選或按一下 尋找 開始搜尋。按一下或點選 x 以取消。
- 如果您想要根據大小寫進行完全比對,請先選取選項 符合大小寫,再開始搜尋。
- 選取 全部取代 以一次取代所有出現的文字。
如果找到相符項目,則會醒目提示該項目,且搜尋對話框會變暗。在變暗的對話框中再次按一下 尋找 按鈕以搜尋下一個出現位置,或選取 取代 按鈕以取代醒目提示的相符文字。請注意,取代 按鈕只有在進行比對後才會啟用。
按一下「尋找」時,「尋找和取代」對話框會變成透明,按一下「取代」時,對話框會變成不透明。這可讓作者檢閱作者將取代的文字。
向左對齊文字
用於將文字對齊左邊界。
文字置中
用於將文字置中。
向右對齊文字
用於將文字對齊右邊界。
項目符號
用於將選取的文字格式化為項目符號清單,或在游標後開始插入項目符號清單。
若要結束項目符號清單,請再次點選或按一下 「項目符號」 按鈕,或輸入兩個歸位字元。
編號
用於將選取的文字格式化為編號符號清單,或在游標後開始插入編號符號清單。
若要結束編號符號清單,請再次點選或按一下 「編號符號」 按鈕,或輸入兩個歸位字元。
凸排
用來減少所選文字或在游標之後輸入的文字的縮排等級。
只有當選取的文字或游標位置已經縮排時才會啟用。
縮排
用來增加所選文字或在游標之後輸入的文字的縮排等級。
表格
用於將表格插入文字中。選取此選項會開啟一個視窗,用於指定表格的詳細資訊。
-
欄 - 表格的欄數 (必要)
-
列 - 表格的列數 (必要)
-
寬度 - 表格的寬度
-
高度 - 表格的高度
-
儲存格內邊距 - 儲存格內容周圍的空間
-
儲存格間距 - 儲存格之間的間距
-
框線 - 表格的框線粗細
-
如果針對表格的標頭:
- 應使用第一列
- 應使用第一欄
- 應使用第一列和第一欄
- 或不應使用任何標頭。
-
-
標題 - 表格的標題
檢查拼字
用於檢查文字內容的拼字。可能的拼字錯誤會以紅色虛線加底線標示。
如需拼字檢查與自訂拼字檢查字典的詳細資訊,請參閱設定 RTF 文字編輯器外掛程式文件。
特殊字元 special-characters
用於將特殊字元插入文字中。選取此選項會開啟顯示可用字元的視窗。
點選或按一下所需的字元,將其插入游標之後的文字中。可以插入多個字元。點選或按一下 x 以關閉選取視窗。
原始碼編輯
用於檢視及修改文字的 HTML 原始碼。
點選或按一下 原始碼編輯 圖示,從格式化檢視變更文字內容以檢視原始 HTML。在此模式中,會停用所有其他格式選項。再次點選或按一下 原始碼編輯 圖示可返回格式化檢視。
段落格式
用於將段落格式套用至所選文字或在游標之後輸入的文字。選取此選項會開啟一個下拉式清單,您可從其中選取段落格式。
內嵌編輯 in-line-editing
文字元件也可以內嵌編輯,但由於空間限制,並非所有格式選項都內嵌可用。若要檢視所有選項,請切換至全螢幕模式。
設定 ID setting-id
此選項可讓您控制 HTML 和資料層中元件的唯一識別碼。
- 如果留空,則會自動產生唯一識別碼,您可以透過檢查得出的頁面找到該 ID。
- 若已指定 ID,則作者應確保其為唯一識別碼。
- 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。
設計對話框 design-dialog
透過設計對話框,範本作者可定義可供內容作者使用的文字格式選項。
外掛程式索引標籤 plugins-tab
外掛程式索引標籤可用來啟用和停用內容作者可用的各種文字格式選項。
功能 features
可為元件啟用或停用下列功能。
- 貼上純文字
- 從 Word 貼上
- 尋找並取代
- 拼字檢查工具
- 插入的影像修改選項
- HTML 原始碼編輯
格式化 formatting
可為元件啟用或停用下列格式選項。
- 表格
- 清單 (項目符號、數字、縮排、凸排)
- 對齊方式 (左、右、置中)
- 粗體、斜體、底線
- 連結 (和取消連結)
- 下標/上標
段落樣式 paragraph-styles
可為元件啟用或停用段落樣式。啟用時,可以定義允許的格式。
- 點選或按一下 新增 按鈕以插入新樣式。
- 輸入將在編輯對話框中顯示的樣式程式碼和說明。
- 若要移除樣式,請點選或按一下 刪除 按鈕。
- 若要重新排列格式的順序,請點選或按一下並拖曳控點。
特殊字元 configuring-special-characters
可以為元件啟用或停用插入特殊字元的選項。啟用時,可以定義允許的字元。
- 點選或按一下 新增 按鈕以插入新字元。
- 輸入將在編輯對話框中顯示的字元 HTML 程式碼和說明。
- 若要移除字元,請點選或按一下 刪除 按鈕。
- 若要重新排列字元的順序,請點選或按一下並拖曳控點。
樣式索引標籤 styles-tab
文字元件支援 AEM 樣式系統。
Adobe Client Data Layer data-layer
「文字元件」支援 Adobe Client Data Layer。