設定RTF編輯器外掛程式 configure-the-rich-text-editor-plug-ins

RTE功能可透過一系列外掛程式使用,每個外掛程式都具備功能屬性。 您可以設定功能屬性,以啟用或停用一或多個RTE功能。 本文會說明如何特別設定RTE外掛程式。

如需其他RTE設定的詳細資訊,請參閱設定RTF編輯器

NOTE
使用CRXDE Lite時,建議使用全部儲存選項定期儲存變更。

啟動外掛程式並設定功能屬性 activateplugin

若要啟用外掛程式,請依照下列步驟操作。 只有在您首次設定外掛程式時才需要執行某些步驟,因為對應的節點不存在。

根據預設,formatlinklistjustifycontrol外掛程式及其所有功能已在RTE中啟用。

NOTE
個別rtePlugins節點稱為<rtePlugins-node>,以避免本文出現重複。
  1. 使用CRXDE Lite,找出專案的文字元件。

  2. 在設定任何RTE外掛程式之前,建立<rtePlugins-node>的父節點(若不存在):

    • 根據您的元件,父節點為:

      • config: .../text/cq:editConfig/cq:inplaceEditing/config
      • 替代設定節點: .../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
      • text: .../text/dialog/items/tab1/items/text
    • 型別為: jcr:primaryType cq:Widget

    • 兩者都有以下屬性:

      • 名稱 name
      • 型別 String
      • ./text
  3. 根據您設定的介面,建立節點<rtePlugins-node> (如果它不存在):

    • 名稱 rtePlugins
    • 型別 nt:unstructured
  4. 在此節點底下,針對您要啟用的每個外掛程式建立一個節點:

    • 型別 nt:unstructured
    • 名稱 ​需要外掛程式的外掛程式識別碼

啟用外掛程式之後,請遵循這些准則來設定features屬性。

啟用所有功能
啟用幾項特定功能
停用所有功能
名稱
功能
功能
功能
類型
字串
字串[] (多字串;將Type設定為String並按一下Multi inCRXDE Lite)
字串
* (星號)
設定為一或多個特徵值
-

瞭解findreplace外掛程式 findreplace

findreplace外掛程式不需要任何設定。 開箱即用。

使用取代功能時,要取代的取代字串應與尋找字串同時輸入。 不過,您仍然可以按一下「尋找」來搜尋字串,然後再取代它。 如果在按一下「尋找」之後輸入取代字串,則搜尋會重設為文字的開頭。

按一下「尋找」時,「尋找和取代」對話方塊會變成透明,按一下「取代」時,對話方塊會變成不透明。 這可讓作者檢閱作者所取代的文字。 如果使用者按一下「全部取代」,對話方塊會關閉並顯示所做的取代數目。

設定貼上模式 paste-modes

使用RTE時,作者可以下列三種模式之一貼上內容:

  • 瀏覽器模式:使用瀏覽器的預設貼上實作貼上文字。 不建議使用此方法,因為它可能會引入不想要的標籤。

  • 純文字模式:以純文字貼上剪貼簿內容。 它會在插入Experience Manager元件之前,從複製的內容中移除所有樣式和格式元素。

  • MS® Word模式:從MS® Word複製時,貼上含有格式設定的文字(包括表格)。 不支援從其他來源(例如網頁或MS® Excel)複製和貼上文字,僅保留部分格式設定。

設定RTE工具列上的貼上選項 configure-paste-options-available-on-the-rte-toolbar

您可以在RTE工具列中向作者提供以下三個圖示的部份、全部或都不提供:

  • 貼上(Ctrl+V):可以預先設定為對應上述三種貼上模式之一。

  • 貼上成文字:提供純文字模式功能。

  • 從Word貼上​ 貼上:提供MS® Word模式功能。

若要設定RTE以顯示必要的圖示,請按照下列步驟操作。

  1. 導覽至您的元件,例如/apps/<myProject>/components/text
  2. 導覽至節點rtePlugins/edit。 如果節點不存在,請參閱啟用外掛程式
  3. edit節點上建立features屬性,並新增一或多個功能。 儲存所有變更。

設定貼上(Ctrl+V)圖示和捷徑的行為 configure-the-behavior-of-the-paste-ctrl-v-icon-and-shortcut

您可以使用下列步驟,預先設定​ 貼上(Ctrl+V) ​圖示的行為。 此設定也會定義「作者」用來貼上內容的鍵盤快速鍵Ctrl+V的行為。

此設定允許以下三種型別的使用案例:

  • 使用瀏覽器的預設貼上實作來貼上文字。 不建議使用此方法,因為它可能會引入不想要的標籤。 使用下列browser設定。

  • 以純文字形式貼上剪貼簿內容。 插入至AEM元件之前,它會從複製的內容中移除樣式和格式的所有元素。 使用下列plaintext設定。

  • 從MS® Word複製時,貼上包含格式設定的文字(包括表格)。 不支援從其他來源(例如網頁或MS® Excel)複製和貼上文字,僅保留部分格式設定。 使用下列wordhtml設定。

  1. 在您的元件中,導覽至<rtePlugins-node>/edit節點。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. edit節點中,使用下列詳細資料建立屬性:

    • 名稱 defaultPasteMode
    • 型別 String
    • ​必要的貼上模式browserplaintextwordhtml之一。

設定貼上內容時允許的格式 pasteformats

您可以進一步設定paste-as-Microsoft-Word (paste-wordhtml)模式,以明確定義從其他程式(例如Microsoft® Word)貼入AEM時允許的樣式。

例如,如果在AEM中貼上時只允許使用粗體格式和清單,您可以篩選掉其他格式。 這稱為可設定的貼上篩選,可同時針對下列兩項執行:

對於連結,您也可以定義自動接受的通訊協定。

若要設定將文字從其他程式貼入AEM時允許的格式:

  1. 在您的元件中,導覽至節點<rtePlugins-node>/edit。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. edit節點下建立節點,以便保留HTML貼上規則:

    • 名稱 htmlPasteRules
    • 型別 nt:unstructured
  3. htmlPasteRules下建立節點,以便您可以儲存所允許基本格式的詳細資料:

    • 名稱 allowBasics
    • 型別 nt:unstructured
  4. 若要控制接受的個別格式,請在allowBasics節點上建立下列一個或多個屬性:

    • 名稱 bold
    • 名稱 italic
    • 名稱 underline
    • 名稱 anchor (適用於連結和已命名的錨點)
    • 名稱 image

    所有屬性都是​ 型別 Boolean,因此在適當的​ ​中,您可以選取或移除核取記號來啟用或停用該功能。

    note note
    NOTE
    如果未明確定義,則使用預設值true並接受格式。
  5. 其他格式也可以使用套用至htmlPasteRules節點的其他屬性或節點範圍來定義。 儲存所有變更。

您可以為htmlPasteRules使用下列屬性。

屬性
類型
說明
allowBlockTags
字串

定義允許的區塊標籤清單。 一些可能的區塊標籤包括:

  • 標題(h1、h2、h3)
  • 段落(p)
  • 清單(ol, ul)
  • 表格(表格)
fallbackBlockTag
字串
定義區塊標籤,此區塊標籤用於任何區塊具有allowBlockTags中未包含的區塊標籤。 p通常已足夠。
表格
nt:unstructured

定義貼上表格時的行為。 此節點必須具有屬性allow (型別布林值)以定義是否允許貼上資料表。 如果allow設為false,您必須指定屬性ignoreMode (型別字串)以定義如何處理貼上的表格內容。 ignoreMode的有效值為:

  • remove:移除表格內容。
  • paragraph:將表格儲存格轉換為段落。
list
nt:unstructured

定義貼上清單時的行為。 必須有屬性allow (型別布林值)以定義是否允許貼上清單。 如果allow設定為false,您必須指定屬性ignoreMode (型別字串)以定義如何處理貼上的任何清單內容。 ignoreMode的有效值為:

  • remove:移除清單內容。
  • paragraph:將清單專案轉換為段落。

以下是有效htmlPasteRules結構的範例。

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}

設定文字樣式 textstyles

作者可以套用樣式來變更部分文字的外觀。 樣式是以您在CSS樣式表中預先定義的CSS類別為基礎。 樣式化內容使用class屬性括在span標籤中,以參照CSS類別。 例如,<span class=monospaced>Monospaced Text Here</span>

第一次啟用樣式外掛程式時,沒有可用的預設樣式。 快顯清單是空的。 若要為作者提供樣式,請執行下列動作:

  • 啟用樣式下拉式選取器。
  • 指定樣式表的位置。
  • 指定可從「樣式」下拉式清單中選取的個別樣式。

對於之後的設定,如要新增更多樣式,請僅依照指示參考新的樣式表並指定其他樣式。

NOTE
您可以定義表格或表格儲存格的樣式。 這些設定需要單獨的程式。

啟用樣式下拉式選取器清單 styleselectorlist

啟用樣式外掛程式即可完成此操作。

  1. 在您的元件中,導覽至節點<rtePlugins-node>/styles。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. styles節點上建立features屬性:

    • 名稱 features
    • 型別 String
    • * (星號)
  3. 儲存所有變更。

NOTE
啟用樣式外掛程式後,「樣式」下拉式清單會顯示在編輯對話方塊中。 不過,清單是空的,因為沒有設定任何樣式。

指定樣式表位置 locationofstylesheet

然後,指定要參照的樣式表位置:

  1. 導覽至文字元件的根節點,例如/apps/<myProject>/components/text

  2. 將屬性externalStyleSheets新增至<rtePlugins-node>的父節點:

    • 名稱 externalStyleSheets
    • 型別 String[] (多字串;在CRXDE中按一下​ Multi
    • Values ​您要包含的每個樣式表的路徑和檔案名稱。 使用存放庫路徑。
    note note
    NOTE
    您稍後可隨時新增參照至其他樣式表。
  3. 儲存所有變更。

NOTE
在對話方塊(傳統UI)中使用RTE時,您可能想要指定針對RTF編輯最佳化的樣式表。 由於技術限制,編輯器中的CSS上下文會遺失,因此您可能想要模擬此上下文以改善WYSIWYG體驗。
RTF編輯器使用ID為CQrte的容器DOM元素,其可用於提供不同的樣式以進行檢視和編輯:
#CQ td {
// defines the style for viewing }
#CQrte td {
// defines the style for editing }

在快顯清單中指定可用的樣式 stylesindropdown

  1. 在元件定義中,瀏覽至節點<rtePlugins-node>/styles,如啟用樣式下拉式選取器中所建立。

  2. 在節點styles下,建立節點(也稱為styles)以儲存可供使用的清單:

    • 名稱 styles
    • 型別 cq:WidgetCollection
  3. styles節點下建立節點,以便您可以代表個別樣式:

    • 名稱,您可以指定名稱,但名稱應該適合樣式
    • 型別 nt:unstructured
  4. 將屬性cssName新增至此節點,以便您可以參考CSS類別:

    • 名稱 cssName
    • 型別 String
    • Value CSS類別的名稱(沒有前置的'.';例如cssClass而非.cssClass)
  5. 將屬性text新增至相同的節點;這會定義選取方塊中顯示的文字:

    • 名稱 text
    • 型別 String
    • ​樣式的描述;出現在[樣式]下拉式選取方塊中。
  6. 儲存變更。

    對每個所需樣式重複上述步驟。

設定RTE以取得日文的最佳斷字 jpwordwrap

使用AEM編寫日文語言內容的作者可以在字元上套用樣式,以避免在不需要分行符號的情況下出現分行符號。 這可讓作者在所需位置斷句。 此功能的樣式是以CSS樣式表中預先定義的CSS類別為基礎。

NOTE
此功能至少需要AEM 6.5 Service Pack 1。

若要建立作者可套用至日文字的樣式,請遵循下列步驟:

  1. 在styles節點下建立節點。 請參閱指定新樣式

    • 名稱:jpn-word-wrap
    • 類型:nt:unstructure
  2. 將屬性cssName新增至節點,以便您可以參考CSS類別。 此類別名稱是日文自動換行功能的保留名稱。

    • 名稱:cssName
    • 類型:String
    • 值: jpn-word-wrap (沒有前置的.
  3. 將屬性文字新增至相同的節點。 值是作者在選取樣式時看到的樣式名稱。

    • 名稱: text
      *型別: String
    • 值: Japanese word-wrap
  4. 建立樣式表並指定其路徑。 請參閱指定樣式表的位置。 將下列內容加入樣式表中。 視需要變更背景顏色。

    code language-css
    .text span.jpn-word-wrap {
        display:inline-block;
    }
    .is-edited span.jpn-word-wrap {
        background-color: #ffddff;
    }
    

    樣式表,讓作者可以使用日文自動換行功能

設定段落格式 paraformats

以RTE編寫的任何文字都會放置在區塊標籤中,預設值為<p>。 啟用paraformat外掛程式後,您可使用下拉式選取清單來指定可指派給段落的其他區塊標籤。 段落格式會指定正確的區塊標籤來決定段落型別。 作者可使用格式選取器來選取及指派這些變數。 範例區塊標籤包含標準段落<p>和標題<h1>、<h2>等。

CAUTION
此外掛程式不適用於具有複雜結構的內容,例如清單或表格。
NOTE
如果無法將區塊標籤(例如<hr>標籤)指派給段落,則這不是paraformat外掛程式的有效使用案例。

第一次啟用「段落格式」外掛程式時,沒有可用的預設段落格式。 快顯清單是空的。 若要為作者提供「段落格式」,請執行下列動作:

  • 啟用「格式」下拉式選取器清單。
  • 指定可從下拉式清單中選取作為段落格式的區塊標籤。

對於之後的設定或重新設定(例如新增更多格式),請僅遵循指示的相關部分。

啟用格式下拉式選取器 formatselectorlist

首先啟用引數格式外掛程式:

  1. 在您的元件中,導覽至節點<rtePlugins-node>/paraformat。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. paraformat節點上建立features屬性:

    • 名稱 features
    • 型別 String
    • * (星號)
NOTE
如果未進一步設定外掛程式,則會啟用下列預設格式:
  • 段落( <p>)
  • 標題1 ( <h1>)
  • 標題2 ( <h2>)
  • 標題3 ( <h3>)
CAUTION
設定RTE的段落格式時,請勿移除段落標籤<p>作為格式選項。 如果移除<p>標籤,那麼即使設定了其他格式,內容作者也無法選取​ 段落格式 ​選項。

指定可用的段落格式 paraformatsindropdown

段落格式可透過以下方式選取:

  1. 在元件定義中,瀏覽至節點<rtePlugins-node>/paraformat,如啟用格式下拉式選取器中所建立。

  2. paraformat節點下,建立節點以儲存格式清單:

    • 名稱 formats
    • 型別 cq:WidgetCollection
  3. formats節點下建立節點,這會保留個別格式的詳細資料:

    • 名稱,您可以指定名稱,但它應該適合格式(例如myparagraph、myheading1)。
    • 型別 nt:unstructured
  4. 將屬性新增至此節點,以定義使用的區塊標籤:

    • 名稱 tag

    • 型別 String

    • ​格式的區塊標籤;例如:p、h1、h2。

      您不需要輸入分隔的角括弧。

  5. 若要讓描述文字出現在下拉式清單中,請新增屬性至相同節點:

    • 名稱 description
    • 型別 String
    • ​此格式的描述文字;例如,段落,標題1,標題2。 此文字會顯示在「格式」選取項清單中。
  6. 儲存變更。

    針對每種所需的格式重複這些步驟。

CAUTION
如果您定義自訂格式,則會移除預設格式(<p><h1><h2><h3>)。 重新建立<p>格式,因為它是預設格式。

設定特殊字元 spchar

在標準AEM安裝中,當misctools外掛程式啟用特殊字元(specialchars)時,預設選取專案立即可供使用;例如,版權和商標符號。

您可以設定RTE,讓自己的字元選擇可供使用;藉由定義不同的字元或整個序列。

CAUTION
新增您自己的特殊字元會覆寫預設選取範圍。 如有必要,請在您自己的選取範圍中定義或重新定義這些字元。

定義單一字元 definesinglechar

  1. 在您的元件中,導覽至節點<rtePlugins-node>/misctools。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. misctools節點上建立features屬性:

    • 名稱 features

    • 型別 String[]

    • specialchars

      (或String / * (如果套用此外掛程式的所有功能)

  3. misctools下,建立節點以儲存特殊字元設定:

    • 名稱 specialCharsConfig
    • 型別 nt:unstructured
  4. specialCharsConfig下,建立另一個節點以儲存字元清單:

    • 名稱 chars
    • 型別 nt:unstructured
  5. chars底下,新增節點以儲存個別字元定義:

    • 名稱 ​您可以指定名稱,但應反映字元,例如,一半。
    • 型別 nt:unstructured
  6. 將下列屬性新增至此節點:

    • 名稱 entity
    • 型別 String
    • ​必要字元的HTML表示法;例如,分數的一半為&189;
  7. 儲存變更。

在CRXDE中,儲存屬性後,會顯示所表示的字元。 請參閱下方一半的範例。 重複上述步驟,讓作者可以使用更多特殊字元。

在CRXDE中,新增可在RTE工具列中使用的單一字元

定義字元範圍 definerangechar

  1. 使用定義單一字元🔗的步驟1到3。

  2. chars底下,新增節點以儲存字元範圍的定義:

    • 名稱 ​您可以指定名稱,但應反映字元範圍;例如,鉛筆。
    • 型別 nt:unstructured
  3. 在此節點下(根據特殊字元範圍命名)新增以下兩個屬性:

    • 名稱 rangeStart

      型別 Long
      ​範圍中第一個字元的Unicode表示法(十進位)

    • 名稱 rangeEnd

      型別 Long
      ​範圍中最後一個字元的Unicode表示法(十進位)

  4. 儲存變更。

    例如,定義範圍9998 - 10000提供您下列字元。

    在CRXDE中,定義可在RTE中使用的字元範圍

    圖:在CRXDE中,定義在RTE ​中可用的字元範圍

    RTE中可用的特殊字元會在快顯視窗中顯示給作者

設定表格樣式 tablestyles

樣式通常會套用至文字,但個別的樣式集合也可以套用至表格或一些表格儲存格。 作者可在「儲存格屬性」或「表格屬性」對話方塊的「樣式選取器」方塊中使用這類樣式。 在文字元件(或衍生專案)中編輯表格時,樣式而非在標準「表格」元件中可供使用。

NOTE
您只能為Classic UI定義表格和儲存格的樣式。
NOTE
在RTE元件中或從RTE元件複製和貼上表格是瀏覽器相依的。 並非所有瀏覽器都支援此功能。 根據表格結構和瀏覽器,您可能會獲得不同的結果。 例如,當您在傳統UI和觸控式UI中,於Mozilla Firefox複製並貼上RTE元件中的表格時,不會保留表格的版面。
  1. 在您的元件中,導覽至節點<rtePlugins-node>/table。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. table節點上建立features屬性:

    • 名稱 features
    • 型別 String
    • * (星號)
    note note
    NOTE
    如果您不想要啟用所有表格功能,您可以建立features屬性,如下所示:
    • 型別 String[]

    • ​下列其中一項(或兩項),視需要而定:

    • table以允許編輯表格屬性;包括樣式。

    • cellprops以允許編輯儲存格屬性,包括樣式。

  3. 定義CSS樣式表的位置,讓您參照這些樣式表。 請參閱指定樣式表的位置,因為這與定義文字🔗的樣式相同。 如果您定義了其他樣式,則可定義位置。

  4. table節點下,建立下列新節點(視需要):

    • 若要定義整個表格的樣式(可在​ 表格屬性 ​下使用):

      • 名稱 tableStyles
      • 型別 cq:WidgetCollection
    • 若要定義個別儲存格的樣式(可在​ 儲存格屬性 ​下使用):

      • 名稱 cellStyles
      • 型別 cq:WidgetCollection
  5. 建立節點(視情況在tableStylescellStyles節點下),讓您可以代表個別樣式:

    • 名稱 ​您可以指定名稱,但應反映樣式。
    • 型別 nt:unstructured
  6. 在此節點上,建立屬性:

    • 定義要參考的CSS樣式

      • 名稱 cssName
      • 型別 String
      • CSS類別的名稱(不含前置的.,例如cssClass而非.cssClass
    • 定義要顯示在下拉式選取器中的描述性文字

      • 名稱 text
      • 型別 String
      • ​要顯示在選取專案清單中的文字
  7. 儲存所有變更。

對每個所需樣式重複上述步驟。

設定表格中的隱藏標題以取得協助工具 hiddenheader

有時候,假設欄與其他欄的視覺關係隱含了欄標題的用途,您就可以在欄標題中建立沒有視覺文字的資料表。 在這種情況下,必須在標題儲存格的儲存格中提供隱藏的內部文字。 如此一來,熒幕助讀程式和其他輔助技術就能協助有各種需求的助讀程式瞭解欄目的。

為了增強在這類情況下的協助工具,RTE支援隱藏的標題儲存格。 此外,它提供與表格中隱藏標題相關的組態設定。 這些設定可讓您在編輯和預覽模式中,將CSS樣式套用至隱藏的標頭。 為協助作者在編輯模式中識別隱藏的標題,請在程式碼中包含下列引數:

  • hiddenHeaderEditingCSS:指定在編輯RTE時,套用至hidden-header儲存格的CSS類別名稱。
  • hiddenHeaderEditingStyle:指定編輯RTE時套用至hidden-header儲存格的Style字串。

如果您在程式碼中同時指定CSS和Style字串,則CSS類別會優先於樣式字串,並可能覆寫Style字串所做的任何設定變更。

若要協助作者在預覽模式下對隱藏的標題套用CSS,您可以在程式碼中包含下列引數:

  • hiddenHeaderClassName:指定在預覽模式中套用至隱藏標頭儲存格的CSS類別名稱。
  • hiddenHeaderStyle:指定在預覽模式下套用至hidden-header儲存格的Style字串。

如果您在程式碼中同時指定CSS和Style字串,則CSS類別會優先於樣式字串,並可能覆寫Style字串所做的任何設定變更。

新增拼字檢查器的字典 adddict

當啟用拼字檢查外掛程式時,RTE會使用字典來表示每種適當的語言。 接著,系統會取用子樹狀結構的language屬性,或從URL擷取語言,根據網站的語言來選取這些專案。 例如,/en/分支被檢查為英文,/de/分支被檢查為德文。

NOTE
如果嘗試檢查未安裝的語言,則會看到訊息Spell checking failed。 標準字典位於/libs/cq/spellchecker/dictionaries,以及適當的Readme檔案。 請勿修改檔案。

標準AEM安裝包含美式英文(en_us)和英式英文(en_gb)的字典。 若要新增更多字典,請按照以下步驟操作。

  1. 瀏覽至頁面https://extensions.openoffice.org/

  2. 執行下列任一項作業,尋找您選擇的語言字典:

  3. 下載含有拼字定義的封存。 擷取檔案系統上封存的內容。

    note caution
    CAUTION
    僅支援OpenOffice.org v2.0.1或更舊版本之MySpell格式的字典。 由於字典現在是封存檔案,建議您下載後驗證封存。
  4. 找到.aff.dic檔案。 將檔案名稱保留為小寫。 例如,de_de.affde_de.dic

  5. /apps/cq/spellchecker/dictionaries的存放庫中載入.aff.dic檔案。

NOTE
RTE拼字檢查器可隨選使用。 當您開始輸入文字時,它不會自動執行。 若要執行拼字檢查程式,請按一下工具列中的拼字檢查程式。 RTE會檢查單字的拼字並反白拼錯的單字。
如果您合併拼字檢查程式所建議的任何變更,文字的狀態會變更,且拼錯的字詞不會再反白。 若要執行拼字檢查程式,請再次按一下「拼字檢查程式」按鈕。

設定復原和重做動作的歷史記錄大小 undohistory

RTE可讓作者還原或重做幾項最後的編輯。 依預設,50項編輯內容會儲存在記錄中。 您可以視需要設定此值。

  1. 在您的元件中,導覽至節點<rtePlugins-node>/undo。 如果節點不存在,請建立這些節點。 如需詳細資訊,請參閱啟用外掛程式

  2. undo節點上,建立屬性:

    • 名稱 maxUndoSteps
    • 型別 Long
    • ​您想要儲存在記錄中的復原步驟數。 預設值為50。 使用0完全停用還原/重做。
  3. 儲存變更。

設定索引標籤大小 tabsize

當在任何文字中按下Tab字元時,會插入預先定義的空格數;依預設,這是三個不間斷的空格和一個空格。

若要定義定位點大小,請執行下列動作:

  1. 在您的元件中,導覽至節點<rtePlugins-node>/keys。 如果節點不存在,請建立節點。 如需詳細資訊,請參閱啟用外掛程式

  2. keys節點上,建立屬性:

    • 名稱 tabSize
    • 型別 String
    • ​要用於製表器的空格字元數
  3. 儲存變更。

設定縮排邊界 indentmargin

啟用縮排(預設)時,您可以定義縮排的大小:

NOTE
此縮排大小僅適用於文字的段落(區塊),不會影響實際清單的縮排。
  1. 在您的元件中,導覽至節點<rtePlugins-node>/lists。 如果節點不存在,請建立這些節點。 如需詳細資訊,請參閱啟用外掛程式

  2. lists節點上,建立indentSize引數:

    • 名稱indentSize
    • 類型Long
    • :縮排邊界所需的畫素數。

設定可編輯空間的高度 editablespace

NOTE
這僅適用於在對話方塊中使用RTE (而非在傳統UI中就地編輯)時。

您可以定義元件對話方塊中顯示的可編輯空間的高度:

  1. 在元件的對話方塊定義中的../items/text節點上,建立屬性:

    • 名稱 height
    • 型別 Long
    • ​編輯畫布的高度(畫素)。
    note note
    NOTE
    這不會變更對話方塊視窗的高度。
  2. 儲存變更。

設定連結的樣式和通訊協定 linkstyles

在AEM中新增連結時,您可以定義:

  • 要使用的CSS樣式
  • 自動接受的通訊協定

若要設定如何將連結從其他程式新增到AEM中,請定義HTML規則。

  1. 使用CRXDE Lite,找出專案的文字元件。

  2. 在與<rtePlugins-node>相同的層級上建立節點,也就是說,在<rtePlugins-node>的父節點下建立節點:

    • 名稱 htmlRules
    • 型別 nt:unstructured
    note note
    NOTE
    ../items/text節點具有屬性:
    • 名稱 xtype
    • 型別 String
    • richtext
    ../items/text節點的位置可能會因對話方塊的結構而異;兩個範例是/apps/myProject>/components/text/dialog/items/text/apps/<myProject>/components/text/dialog/items/panel/items/text
  3. htmlRules下建立節點。

    • 名稱 links
    • 型別 nt:unstructured
  4. links節點下,視需要定義屬性:

    • 內部連結的CSS樣式:

      • 名稱 cssInternal
      • 型別 String
      • Value CSS類別的名稱(沒有前置的'.';例如cssClass而非.cssClass)
    • 外部連結的CSS樣式

      • 名稱 cssExternal
      • 型別 String
      • Value CSS類別的名稱(沒有前置的'.';例如cssClass而非.cssClass)
    • 有效​ 通訊協定 ​的陣列。 支援的通訊協定為http://https://file://mailto:

      • 名稱 protocols
      • 型別 String[]
      • ​一或多個通訊協定
    • defaultProtocol (型別​ 字串 ​的屬性):使用者未明確指定通訊協定時要使用的通訊協定。

      • 名稱 defaultProtocol
      • 型別 String
      • ​一或多個預設通訊協定
    • 如何處理連結目標屬性的定義。 建立節點:

      • 名稱 targetConfig
      • 型別 nt:unstructured

      在節點targetConfig上,定義必要的屬性:

      • 指定目標模式:

        • 名稱 mode

        • 型別 String

          • auto:表示已選擇自動目標

            (由外部連結的targetExternal屬性或內部連結的targetInternal指定)。

          • manual:不適用於此內容

          • blank:不適用於此內容

      • 內部連結的目標:

        • 名稱 targetInternal
        • 型別 String
        • ​內部連結的目標(僅當模式為auto時使用)
      • 外部連結的目標:

        • 名稱 targetExternal
        • 型別 String
        • ​外部連結的目標(僅當模式為auto時使用)。
  5. 儲存所有變更。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2