文字元件 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以取消。
- 如果您想要根據大小寫進行完全比對,請先選取選項 符合大小寫,再開始搜尋。
- 選取 全部取代 以一次取代所有出現的文字。
如果找到相符專案,則會反白該專案,且搜尋對話方塊會變暗。 在灰色的對話方塊中再次按一下 尋找 按鈕以搜尋下一個專案,或選取 取代 按鈕以取代醒目提示的相符文字。 請注意,Replace 按鈕只有在進行比對後才會啟用。
按一下「尋找」時,「尋找和取代」對話方塊會變成透明,按一下「取代」時,對話方塊會變成不透明。 這可讓作者檢閱作者將取代的文字。
向左對齊文字
用於將文字對齊左邊界。
文字置中
用於將文字置中。
向右對齊文字
用於將文字對齊右邊界。
項目符號
用於將選取的文字格式化為專案符號清單,或在游標後開始插入專案符號清單。
若要結束專案符號清單,請再次點選或按一下 專案符號 按鈕,或輸入兩個歸位字元。
編號
用於將選取的文字格式化為編號清單,或在游標後開始插入編號清單。
若要結束編號清單,請再次點選或按一下 編號 按鈕或輸入兩個歸位字元。
凸排
用來減少所選文字的縮排層級,或在游標之後輸入的文字。
只有當選取的文字或游標位置已經縮排時,才為作用中。
縮排
用於增加所選文字的縮排層級,或在游標之後輸入的文字。
表格
用於將表格插入文字中。 選取此選項會開啟一個視窗,用於指定表格的詳細資訊。
-
欄 — 資料表的欄數(必要)
-
列 — 資料表的列數(必填)
-
寬度 — 表格的寬度
-
高度 — 資料表的高度
-
儲存格內距 — 儲存格內容周圍的空間
-
儲存格間距 — 儲存格之間的間距
-
框線 — 資料表的框線粗細
-
如果針對表格的標頭:
- 應使用第一列
- 應使用第一欄
- 應使用第一列和第一欄
- 或不應使用任何標頭。
-
-
標題 — 資料表的標題
檢查拼字
用於檢查文字內容的拼字。 可能的拼字錯誤會以紅色虛線加底線。
如需拼字檢查與自訂拼字檢查字典的詳細資訊,請參閱檔案設定RTF編輯器外掛程式。
特殊字元 special-characters
用於將特殊字元插入文字中。 選取此選項會開啟顯示可用字元的視窗。
點選或按一下所需的字元,將其插入游標之後的文字中。 可以插入多個字元。 點選或按一下x以關閉選取範圍視窗。
來源編輯
用於檢視及修改文字的HTML來源。
點選或按一下 Source Edit 圖示,從格式化檢視變更文字內容以檢視原始HTML。 在此模式中,會停用所有其他格式選項。 再次點選或按一下「Source編輯」圖示可返回格式化檢視。
段落格式
用於將段落格式套用至選取的文字或游標後插入的文字。 選取此選項會開啟一個下拉式清單,您可從其中選取段落格式。
內嵌編輯 in-line-editing
文字元件也可以內嵌編輯,但由於空間限制,並非所有格式選項都內嵌可用。 若要檢視所有選項,請切換到全熒幕模式。
設定ID setting-id
此選項可讓您控制HTML和資料層中元件的唯一識別碼。
- 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
- 若指定ID,作者應負責確認該ID為唯一ID。
- 變更ID會對CSS、JS和資料層追蹤造成影響。
設計對話方塊 design-dialog
「設計」對話方塊可讓範本作者定義哪些文字格式選項可供內容作者使用。
外掛程式標籤 plugins-tab
「外掛程式」索引標籤可用來啟用和停用內容作者可用的各種文字格式選項。
功能 features
可為元件啟用或停用下列功能。
- 貼上純文字
- 從文字貼上
- 尋找和取代
- 拼字檢查程式
- 插入的影像修改選項
- HTML來源編輯
正在格式化 formatting
可為元件啟用或停用下列格式選項。
- 表格
- 清單(專案符號、數字、縮排、減少縮排)
- 對齊方式(左、右、置中)
- 粗體、斜體、底線
- 連結(和取消連結)
- 下標/上標
段落樣式 paragraph-styles
可為元件啟用或停用段落樣式。 啟用時,可以定義允許的格式。
- 點選或按一下 新增 按鈕以插入新樣式。
- 輸入將在「編輯」對話方塊中顯示的樣式代碼和說明。
- 若要移除樣式,請點選或按一下 刪除 按鈕。
- 若要重新排列格式,請點選或按一下並拖曳控點。
特殊字元 configuring-special-characters
可以為元件啟用或停用插入特殊字元的選項。 啟用時,可以定義允許的字元。
- 點選或按一下 新增 按鈕以插入新字元。
- 輸入字元的HTML碼,以及將顯示在編輯對話方塊中的說明。
- 若要移除字元點選或按一下 刪除 按鈕。
- 若要重新排列字元順序,請點選或按一下並拖曳控點。
樣式索引標籤 styles-tab
文字元件支援AEM 樣式系統。
Adobe使用者端資料層 data-layer
文字元件支援Adobe使用者端資料層。