Konfigurera RTF-redigeraren configure-the-rich-text-editor

Med textredigeraren får författarna ett stort antal funktioner för redigering av textinnehåll. Ikoner, markeringsrutor, verktygsfält och menyer finns för WYSIWYG-textredigering.

Om du vill veta hur du använder RTE-funktioner för redigering kan du läsa Använd RTF-redigerare för att skapa. RTE kan konfigureras för att aktivera, inaktivera och utöka de funktioner som är tillgängliga i redigeringskomponenterna. Följande arbetsflöde visar den rekommenderade ordningen för att slutföra RTE-konfigurationsuppgifterna i Experience Manager.

Bild: Normalt arbetsflöde för att konfigurera RTF-redigeraren

Förstå användargränssnittet med pekskärmsfunktioner och det klassiska användargränssnittet understand-touch-enabled-ui-and-classic-ui

Det användargränssnitt som har stöd för pekskärm är standardgränssnittet för AEM. Adobe introducerade Touch UI med responsiv design för redigeringsmiljön, i version 5.6. Touchgränssnittet är utformat för enheter med pekskärm och stationära datorer. Gränssnittet skiljer sig avsevärt från det ursprungliga klassiska användargränssnittet.

Bild: Verktygsfältet för textredigeraren i det Touch-aktiverade gränssnittet

Bild: Verktygsfältet RTF-redigerare i det klassiska användargränssnittet

Olika redigeringslägen editingmodes

Författare kan skapa och redigera textinnehåll i AEM med de olika komponentlägena. Alternativen i verktygsfältet för att skapa och formatera innehåll och användarupplevelsen i komponenter med RTE-funktioner i olika redigeringslägen varierar beroende på RTE-konfigurationer.

Inline-redigering inline-editing

När innehållet öppnas (med en långsam dubbeltryckning/klick) kan det redigeras på sidan. Ett kompakt verktygsfält med grundläggande alternativ visas.

Bild: Inline-redigering med grundläggande verktygsfält i Touch-aktiverat användargränssnitt

I det klassiska användargränssnittet kan du med en långsam dubbelklickning på komponenten redigera textbundet och med en orange kontur markeras innehållet. Om Innehållssökning är öppet visas ett verktygsfält med tillgängliga alternativ för RTF-formatering högst upp i fönstret. Om Innehållssökning inte är öppet visas inte formateringsalternativen och du kan bara göra grundläggande textredigeringar.

Helskärmsredigering full-screen-editing

AEM kan öppnas i helskärmsläge som döljer sidinnehållet och tar upp den tillgängliga skärmen. Överväg att redigera i helskärmsläge som en detaljerad version av den infogade redigeringen eftersom den erbjuder de flesta redigeringsalternativen. Du kan öppna den genom att klicka från det kompakta verktygsfältet när du använder det infogade redigeringsläget.

I helskärmsläget i dialogrutan finns ett detaljerat verktygsfält för textredigering, samt alternativ och komponenter som är tillgängliga i dialogruteläget. Det gäller endast för en dialogruta som innehåller RTE tillsammans med andra komponenter.

Bild: Det detaljerade verktygsfältet för textredigering när du redigerar i helskärmsläge i det touchaktiverade gränssnittet

Dialogruteredigering dialog-editing

När du dubbelklickar på en komponent i det klassiska användargränssnittet öppnas en dialogruta där du kan redigera innehållet. Dialogrutan öppnas ovanpå den befintliga sidan. I vissa specifika scenarier öppnas dialogrutan som ett popup-fönster. Om en textkomponent till exempel är en del av en kolumn i en sidlayout med flera kolumner och området som är tillgängligt för dialogrutan är mindre.

Bild: Dialogruteredigeringsläge i användargränssnittet med pekfunktioner

Bild: Dialogruta i Classic UI som innehåller ett detaljerat verktygsfält för redigering

Om RTE-plugin-program och associerade funktioner aboutplugins

Funktionerna är tillgängliga via ett antal plugin-program, var och en med:

Grundfunktionerna i textredigeringsprojektet aktiveras, eller inaktiveras, av värdet på features på en nod som är specifik för rätt plugin-program.

I följande tabell visas de aktuella plugin-programmen:

Förstå konfigurationssökvägar och -platser understand-the-configuration-paths-and-locations

The RTE-redigeringsläge (och användargränssnittet) som du anger för författarna bestämmer var konfigurationsinformationen ska placeras när du är aktivera RTE-plugin-program:

Konfigurera följande egenskaper som gäller i redigeringsläget för dialogrutor endast i Touch-gränssnittet:

När textredigeraren används i den beröringsaktiverade dialogrutan anger du egenskapen useFixedInlineToolbar true är obligatoriskt för att undvika problem.

Anpassa redigering på plats customizing-in-place-editing

Du kan definiera på vilken HTML-väljare textredigeraren ska starta genom att konfigurera följande egenskaper:

Motsvarande egenskap för dialogläge är name.

Aktivera RTE-funktioner genom att aktivera plugin-program enable-rte-functionalities-by-activating-plug-ins

RTE-funktioner är tillgängliga via en serie plugin-program, var och en med features-egenskaper. Du kan konfigurera egenskapen features för att aktivera eller inaktivera de olika funktionerna i varje plugin-program.

Detaljerade konfigurationer av RTE-plugin-program finns i hur du aktiverar och konfigurerar RTE-plugin-program.

Hämta den här exempelkonfigurationen för att förstå hur du konfigurerar RTE. I det här paketet är alla funktioner aktiverade.

Hämta fil

Verktygsfältet Konfigurera RTE dialogfullscreen

I AEM kan du konfigurera gränssnittet för RichText Editor på olika sätt för de olika redigeringslägena. Standardinställningarna anges nedan. Du kan åsidosätta dessa standardinställningar baserat på dina behov.

För bästa redigeringsmiljö:

<uiSettings jcr:primaryType="nt:unstructured">
  <cui jcr:primaryType="nt:unstructured">
    <inline
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,#justify,#lists,links#modifylink,links#unlink,#paraformat]">
      <popovers jcr:primaryType="nt:unstructured">
        <justify
          jcr:primaryType="nt:unstructured"
          items="[justify#justifyleft,justify#justifycenter,justify#justifyright]"
          ref="justify"/>
        <lists
          jcr:primaryType="nt:unstructured"
          items="[lists#unordered,lists#ordered,lists#outdent,lists#indent]"
          ref="lists"/>
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </inline>
    <dialogFullScreen
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,justify#justifyleft,justify#justifycenter,justify#justifyright,lists#unordered,lists#ordered,lists#outdent,lists#indent,links#modifylink,links#unlink,table#createoredit,#paraformat,image#imageProps]">
      <popovers jcr:primaryType="nt:unstructured">
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </dialogFullScreen>
    <tableEditOptions
      jcr:primaryType="nt:unstructured"
      toolbar="[table#insertcolumn-before,table#insertcolumn-after,table#removecolumn,-,table#insertrow-before,table#insertrow-after,table#removerow,-,table#mergecells-right,table#mergecells-down,table#mergecells,table#splitcell-horizontal,table#splitcell-vertical,-,table#selectrow,table#selectcolumn,-,table#ensureparagraph,-,table#modifytableandcell,table#removetable,-,undo#undo,undo#redo,-,table#exitTableEditing,-]">
    </tableEditOptions>
  </cui>
</uiSettings>

Olika gränssnittsinställningar används för textbundet läge och helskärmsläge. Verktygsfältsegenskapen används för att ange knapparna i verktygsfältet. Om till exempel själva knappen är en funktion (till exempel Bold), anges som PluginName#FeatureName (t.ex. links#modifylink). Om knappen är en pekare (som innehåller vissa funktioner i ett plugin-program) anges den som #PluginName (t.ex. #format). Avgränsare ( | ) mellan en grupp knappar kan anges med '-'.

Popup-noden under infogat läge eller helskärmsläge innehåller en lista över de poseringar som används. Varje underordnad nod under popovers noden namnges efter plugin-programmet (till exempel format). Den har en egenskap items som innehåller en lista med funktioner i plugin-programmet (till exempel format#bold).

RTE-inställningar (User Interface Settings) och innehållsprinciper rtecontentpolicies

Administratörer kan styra textredigeringsalternativen med hjälp av innehållsprinciper, till exempel i stället för att göra konfigurationen enligt beskrivningen ovan. Innehållsprofiler definierar designegenskaperna för en komponent när de används som en del av en redigerbar mall. Om en textkomponent som använder textredigeraren till exempel används med en redigerbar mall kan innehållsprincipen definiera att det feta alternativet är tillgängligt och att några styckeformateringsalternativ är tillgängliga. Innehållsprofilerna kan återanvändas och kan tillämpas på flera mallar.

AEM 6.4 Service Pack 3 och senare flödar de tillgängliga alternativen i RTE nedåt från användargränssnittskonfigurationerna till innehållsprinciperna.

Du kan till exempel se Dokumentation för komponenten Text Core.

Anpassa mappningen mellan verktygsfältsikoner och kommandon iconstoolbar

Du kan anpassa mappningen mellan koralikonerna som visas i verktygsfältet för textredigering och de tillgängliga kommandona. Du kan inte använda några andra ikoner förutom kornikoner.

Nedan finns ett exempelfragment som kopplar kommandot Fet till koralikonen med namnet textItalic.

<text jcr:primaryType="nt:unstructured" sling:resourceType="cq/gui/components/authoring/dialog/richtext" name="./text" useFixedInlineToolbar="{Boolean}true">
    <rtePlugins jcr:primaryType="nt:unstructured">
        <format jcr:primaryType="nt:unstructured" features="bold,italic"/>
    </rtePlugins>
    <uiSettings jcr:primaryType="nt:unstructured">
        <cui jcr:primaryType="nt:unstructured">
            <inline jcr:primaryType="nt:unstructured"
                toolbar="[format#bold,format#italic,format#underline,links#modifylink,links#unlink]">
            </inline>
            <icons jcr:primaryType="nt:unstructured">
                <bold jcr:primaryType="nt:unstructured"
                    command="format#bold"
                    icon="textItalic"/>
            </icons>
        </cui>
    </uiSettings>
</text>

Växla till CoralUI 2 Rich Text Editor switch-to-coralui-rich-text-editor

På en sida kan du antingen inkludera CoralUI 2 RTE clientlib eller CoralUI 3 RTE clientlib. Som standard innehåller textredigeraren klienten CoralUI 3 RTE. Så här byter du till CoralUI 2 RTE:

Ytterligare information further-information

Mer information om hur du konfigurerar RTE finns i API för AEM referens.

Du kan särskilt se vilka plugin-program och relaterade alternativ som är tillgängliga:

Ovanstående alternativ kan användas för att utöka och anpassa din egen RTE. Om du till exempel vill lista de ankare som är tillgängliga på sidan när du skapar en länk kan du ange en egen implementering av LinkPlugin.

Kända begränsningar known-limitations

AEM har följande begränsningar: