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