核心元件文本元件是一個富文本編輯和合成元件,可進行就地編輯。
「文本元件」提供強大的富格文本編輯器,使用簡化的串聯編輯器和全屏格式可以輕鬆編輯文本。
的 編輯對話框 功能是使用有限選項進行線上編輯,而全屏編輯對話框中提供了全部功能。 使用 設計對話框,可以為內容作者的模板配置文本格式選項,如標題、特殊字元和段落樣式。
文本元件的當前版本是v2,該版本於2018年1月隨核心元件2.0.0版一同推出,本文檔對此進行了說明。
下表詳細說明了元件的所有受支援版本、AEM元件版本與之相容的版本,以及指向早期版本文檔的連結。
元件版本 | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | 相容 發行版2.17.4 和 |
相容 | 相容 |
v1 | 相容 | 相容 | - |
有關核心元件版本和版本的詳細資訊,請參閱文檔 核心元件版本。
要體驗文本元件,並查看其配置選項示例以及HTML和JSON輸出,請訪問 元件庫。
有關文本元件的最新技術文檔 可在GitHub上找到。
有關開發核心元件的詳細資訊,請參閱 核心元件開發人員文檔。
核心元件文本元件利AEM用RTE。 RTE為內容作者提供了多種編輯其文本內容的功能。 RTE的配置非常靈活,並提供了多種選項。 有關如何配置RTE的進一步詳細資訊,請參閱文章 配置RTF編輯器 和 配置RTF編輯器插件。
本文的其餘部分演示了使用現成RTE配置的核心元件文本元件的標準配置。
僅選項啟用者 RTE的UI配置 在文本元件中可用。
編輯對話框提供了用戶希望合成文本的標準富格文本格式工具。
用於將粗體格式應用於選定文本或大膽設定游標後輸入的文本格式。
Ctrl+B 可用作鍵盤快捷鍵。
用於將斜體格式應用於游標後輸入的選定文本或斜體文本。
Ctrl+I can be used as a keyboard shortcut.
用於將下划線格式應用於游標後輸入的選定文本或下划線文本。
Ctrl+U can be used as a keyboard shortcut.
用於將游標後輸入的選定文本或文本格式化為下標。
用於將游標後輸入的選定文本或文本格式化為上標。
將任何複製的文本貼上為純文字檔案,而不使用任何格式。
選擇此選項時,將開啟一個窗口,在將文本插入文本之前,可以將文本貼上為純文字檔案,且不將格式設定為預覽。 按一下或按一下複選標籤接受,按一下或按一下x取消。
選擇此選項時,將開啟一個窗口,在將文本插入文本之前,可以在其中貼上文本,將其格式保持為預覽。 按一下或按一下複選標籤接受,按一下或按一下x取消。
使用此選項可將所選文本轉換為超連結或修改已定義的連結。 僅當已選擇文本並開啟窗口時,此選項才處於活動狀態,其中包含用於設定連結的其他選項。
輸入路徑
輸入連結的備選說明性文本
選擇連結行為
點擊或按一下複選標籤以應用連結,或按一下x以取消。
使用此選項可刪除已應用於所選文本的連結。 僅當已選擇連結時,此選項才處於活動狀態。
使用此選項可搜索文本以查找指定文本字串的出現情況。 選擇此選項將開啟一個窗口,用於指定搜索選項。
輸入要搜索的文本,點擊或按一下 查找 開始搜索。 點擊或按一下x取消。
如果要根據大小寫進行精確匹配,請選擇選項 匹配大小寫 開始搜索。
如果找到匹配項,則會加亮該匹配項,並且搜索對話框會變暗。 點擊或按一下 查找 的子菜單。
如果找不到其他出現的情況,將顯示一條消息,並從文本的開頭重新開始搜索。
使用此選項可搜索文本以查找指定文本字串的具體值,並將匹配項替換為另一個字串。 選擇此選項將開啟一個窗口,用於指定搜索和替換選項。
輸入要搜索的文本以及應替換它的文本。
如果找到匹配項,則會加亮該匹配項,並且搜索對話框會變暗。 按一下 查找 按鈕,以搜索下一個出現項或選擇 替換 按鈕,將選定控制項在Tab鍵次序中下移一個位置。 請注意 替換 只有匹配後,按鈕才處於活動狀態。
The find and replace dialog becomes transparent when find is clicked and becomes opaque when replace is clicked. 這允許作者審閱作者將替換的文本。
使用替換功能時,應與查找字串同時輸入要替換的替換字串。 但是,您仍可以按一下「查找」在替換字串之前搜索該字串。 如果在按一下「查找」後輸入替換字串,則搜索將重置為文本的開頭。
用於將文本與左邊距對齊。
用於居中文本。
用於將文本與右邊距對齊。
用於將所選文本格式化為項目符號清單或開始在游標後插入項目符號清單。
要結束項目符號清單,請點擊或按一下 項目符號 按鈕或輸入兩個回車符。
用於將所選文本格式化為編號清單或開始在游標後插入編號清單。
要結束編號清單,請點擊或按一下 編號 按鈕或輸入兩個回車符。
用於減少在游標後輸入的選定文本或文本的縮進級別。
僅當游標的選定文本或位置已縮進時才處於活動狀態。
用於增加游標後輸入的選定文本或文本的縮進級別。
用於將表插入文本。 選擇此選項將開啟一個窗口,用於指定表的詳細資訊。
Used to check the spelling of the text content. 可能的拼寫錯誤用破折的紅線加下划線。
有關拼寫檢查和自定義拼寫檢查詞典的詳細資訊,請參閱文檔 配置RTF編輯器插件。
用於在文本中插入特殊字元。 選擇此選項將開啟一個顯示可用字元的窗口。
點擊或按一下所需字元,將其插入游標後的文本。 可以插入多個字元。 點擊或按一下x關閉選擇窗口。
用於查看和修改文本的HTML源。
點擊或按一下 源編輯 表徵圖以更改格式化視圖中文本的內容以查看原始HTML。 在此模式下,所有其它格式選項都被禁用。 點擊或按一下 源編輯 表徵圖以返回到格式化視圖。
與訪問原始HTML的情況一樣,在使用 源編輯 選項!
HTML entered via Source Edit is scanned for XSS risks and any scripts that are inserted are removed and will not appear on the resulting page. 但是,在中輸入的HTML格式錯誤 源編輯 可能會中斷頁面的模板,導致意外的格式設定或導致生成的頁面無法使用。
Because HTML entered via Source Edit is scanned for XSS risks and any scripts and automatically removes those found, the actual content persisted may vary from what was entered in Source Edit. 因此,為了保存使用 源編輯,必須先退出 源編輯 在普通編輯器中查看文本,然後再保存。
用於將段落格式應用於選定文本或插入游標後的文本。 Selecting this options opens a dropdown from which the paragraph format is selected.
文本元件也可以串聯編輯,但由於空間限制,並非所有格式選項都可串聯使用。 要查看所有選項,請切換到全屏模式。
此選項允許控制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.
文本元件支AEM持 風格系統。
文本元件支援 Adobe客戶端資料層。