De Rich Text Editor configureren configure-the-rich-text-editor

De Rich Text Editor (RTE) biedt auteurs een groot aantal functies voor het bewerken van tekstinhoud. Pictogrammen, selectiekaders, werkbalk en menu's zijn beschikbaar voor een WYSIWYG-ervaring bij het bewerken van tekst. De beheerders vormen RTE om, de eigenschappen toe te laten onbruikbaar te maken en uit te breiden beschikbaar in de auteurscomponenten. Zie hoe de auteurs RTE voor creatiewebinhoud gebruiken.

De concepten en de stappen van RTE die worden vereist om het te vormen zijn hieronder vermeld.

Begrijp de gebruikersinterface beschikbaar aan auteurs understand-rte-ui

De interface RTE biedt a ontvankelijk ontwerpvoor auteursmilieu aan. De interface is ontworpen voor gebruik op touch- en desktopapparaten.

Cijfer: De rijke toolbar van de Redacteur van de Tekst met alle beschikbare toegelaten opties.

De werkbalk bevat de opties voor de WYSIWYG-ontwerpervaring. Experience Manager beheerders kunnen de opties vormen beschikbaar in de toolbar op de interface. In Experience Manager is standaard een uitgebreide set bewerkingsopties beschikbaar. Ontwikkelaars kunnen Experience Manager aanpassen om meer bewerkingsopties toe te voegen.

Verschillende bewerkingsmodi editingmodes

Auteurs kunnen tekstinhoud in Experience Manager maken en bewerken met de verschillende modi van componenten. De toolbaropties voor het ontwerpen en het formatteren van inhoud en de gebruikerservaring van rte-toegelaten componenten op verschillende het uitgeven wijze variëren gebaseerd op configuraties RTE.

Inline bewerken inline-editing

Als u de inhoud binnen een pagina wilt bewerken, opent u de inhoud met een langzame dubbelklik. Er wordt een compacte werkbalk met basisopties weergegeven.

Cijfer: Het gealigneerde uitgeven met basisopties in de toolbar.

Volledig scherm bewerken full-screen-editing

Experience Manager -componenten kunnen worden geopend in de weergave Volledig scherm, waarin de pagina-inhoud wordt verborgen en het beschikbare scherm wordt ingenomen. U kunt overwegen een gedetailleerde versie van de inlinebewerking op volledig scherm te bewerken, aangezien deze de meeste bewerkingsopties biedt. Het kan worden geopend door , van de compacte toolbar te openen wanneer het gebruiken van de gealigneerde het uitgeven wijze.

In de modus Volledig scherm van het dialoogvenster zijn, samen met een gedetailleerde RTE-werkbalk, ook de opties en componenten beschikbaar in een dialoogvenster. Het is alleen van toepassing voor een dialoog die naast andere componenten RTE bevat.

Cijfer: De gedetailleerde toolbar van RTE wanneer het uitgeven op volledig-schermwijze.

Dialoogvenster bewerken dialog-editing

Wanneer dubbelgeklikt wordt op een component, wordt een dialoogvenster geopend voor het bewerken van de inhoud. Het dialoogvenster wordt boven op de bestaande pagina geopend. In sommige specifieke scenario's, opent de dialoog als pop-up venster. Wanneer een tekstcomponent bijvoorbeeld deel uitmaakt van een kolom in een paginalay-out met meerdere kolommen en het gebied dat beschikbaar is voor het dialoogvenster kleiner is.

Cijfer: Dialoog het uitgeven wijze.

Informatie over RTE-plug-ins en de bijbehorende functies aboutplugins

De functionaliteit wordt beschikbaar gesteld via een reeks plug-ins, elk met:

De basisfuncties van de RTE worden geactiveerd of gedeactiveerd door de waarde van de eigenschap features op een knooppunt dat specifiek is voor de juiste insteekmodule.

In de volgende tabel worden de huidige plug-ins weergegeven:

Begrijp de configuratiewegen en plaatsen understand-the-configuration-paths-and-locations

De wijze van RTE het uitgeven en de interfacedie u voor uw auteurs verstrekt beslist de plaats voor de configuratiedetails wanneer u de stop-ins van RTEactiveert. De locaties zijn:

Configureer de volgende eigenschappen die van toepassing zijn in de bewerkingsmodus van dialoogvenster:

Wanneer u RTE gebruikt in het dialoogvenster met aanraakbediening, stelt u de eigenschap useFixedInlineToolbar in op true om problemen te voorkomen.

RTE-functies inschakelen door plug-ins te activeren enable-rte-functionalities-by-activating-plug-ins

De functionaliteit van RTE wordt beschikbaar gemaakt via een reeks stop-ins, elk met eigenschappen bezit. U kunt de eigenschap features configureren om de verschillende functies van elke insteekmodule in of uit te schakelen.

Voor gedetailleerde configuraties van de stop-ins van RTE, zie hoe te om de stop-ins van RTE te activeren en te vormen.

De de tekstcomponent van Componenten van de Kernlaat malplaatjeredacteurs om vele stop-ins te vormen RTE gebruikend het gebruikersinterface als inhoudsbeleid, die de behoefte aan technische configuratie elimineren. Het inhoudsbeleid kan werken met RTE UI-configuraties, zoals in dit document wordt beschreven. Voor meer informatie, zie paginasjablonenen de de ontwikkelaarsdocumentatie van de Componenten van de Kerncreëren.

Ter referentie kunt u de standaardtekstcomponenten (geleverd als onderdeel van een standaardinstallatie) vinden op:

• /libs/wcm/foundation/components/text
• /libs/foundation/components/text

Als u uw eigen tekstcomponent wilt maken, kopieert u de bovenstaande component in plaats van deze componenten te bewerken.

RTE-werkbalk configureren dialogfullscreen

Met Experience Manager kunt u de interface voor de Rich Text Editor op verschillende manieren configureren voor de verschillende bewerkingsmodi. De standaardinstellingen worden hieronder gegeven. U kunt deze standaardinstellingen op basis van uw vereisten overschrijven. U kunt alleen de werkbalkfuncties aanpassen die u aan de auteurs wilt geven. U hoeft niet alle werkbalkconfiguraties op te geven.

Gebruik de volgende voorbeeldconfiguratie om de werkbalk voor dialogFullScreen te configureren.

<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,justify#justifyjustify]"
          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,justify#justifyjustify,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>

Er worden verschillende instellingen voor de gebruikersinterface gebruikt voor de inlinemodus en de modus Volledig scherm. Met de eigenschap toolbar geeft u de optie van de werkbalk op.

Als de optie zelf bijvoorbeeld een functie is (bijvoorbeeld Bold ), wordt deze opgegeven als PluginName#FeatureName (bijvoorbeeld links#modifylink ).

Als de optie een pop-up is (met enkele functies van een plug-in), wordt deze opgegeven als #PluginName (bijvoorbeeld #format ).

Scheidingstekens (|) tussen een groep opties kunnen worden opgegeven met - .

Het pop-upknooppunt onder de modus Inline of Volledig scherm bevat een lijst met de pop-upovers die worden gebruikt. Elk onderliggend knooppunt onder het knooppunt popovers krijgt een naam na de insteekmodule (bijvoorbeeld de indeling). Deze heeft een eigenschap 'items' die een lijst bevat met functies van de plug-in (bijvoorbeeld format#bold).

RTE-gebruikersinterface-instellingen en inhoudsbeleid rtecontentpolicies

De beheerders kunnen de opties controleren RTE gebruikend inhoudsbeleid, zeggen in plaats van de configuratie zoals hierboven beschreven. Het beleid van de inhoud bepaalt de ontwerpeigenschappen van een component wanneer gebruikt als deel van een editable malplaatje. Als bijvoorbeeld een tekstcomponent die de RTE gebruikt wordt gebruikt met een bewerkbare sjabloon, kan het inhoudsbeleid definiëren dat de optie Vet beschikbaar is en zijn enkele opties voor alineaopmaak beschikbaar. Het inhoudsbeleid is herbruikbaar en kan op meerdere sjablonen worden toegepast.

De beschikbare opties in RTE stromen stroomafwaarts van de configuraties van het gebruikersinterface aan het inhoudsbeleid.

Als voorbeeld, kunt u de documentatie van de Component van de Kern van de Tekstzien.

Toewijzing aanpassen tussen werkbalkpictogrammen en -opdrachten iconstoolbar

U kunt de afbeelding aanpassen tussen de koraalpictogrammen die worden weergegeven op de RTE-werkbalk en de beschikbare opdrachten. U kunt geen andere pictogrammen gebruiken behalve Koraalpictogrammen.

Hieronder ziet u een voorbeeldfragment waarmee u de opdracht Bold toewijst aan het pictogram Koraal met de naam 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>

Bekende beperkingen known-limitations

Experience Manager De mogelijkheid van RTE heeft de volgende beperkingen:

Tips en trucs best-practices-and-tips