Tekstcomponent (v1) text-component-v
De component Text is een component voor tekstbewerking en -compositie met tekstopmaak die op locatie kan worden bewerkt.
Gebruik usage
De component Text biedt een robuuste teksteditor met tekstopmaak die het mogelijk maakt tekst eenvoudig te bewerken in een vereenvoudigde, inline editor en in een volledige schermopmaak.
Het geeft dialoogeigenschappen in-lijn uit het uitgeven met beperkte opties met volledige functionaliteit beschikbaar in het volledig scherm uitgeeft dialoog. Gebruikend de ontwerpdialoog, tekst het formatteren opties zoals rubrieken, speciale karakters, en paragraafstijlen kunnen voor het malplaatje voor de inhoudauteur worden gevormd.
Versie en compatibiliteit version-and-compatibility
In dit document wordt versie 1 van de tekstcomponent beschreven, die oorspronkelijk is geïntroduceerd met versie 1.0.0 van de kerncomponenten met AEM 6.3.
In de volgende tabel wordt de compatibiliteit van v1 van de tekstcomponent weergegeven.
Uitvoer van voorbeeldcomponent sample-component-output
Het volgende wordt steekproef genomen van We.Retail.
Schermafbeelding screenshot
HTML html
<div class="cmp cmp-text aem-GridColumn aem-GridColumn--default--12">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer porttitor ante a tortor volutpat maximus. Donec eu porta eros. Aenean sit amet eleifend arcu, eu vestibulum magna. Fusce eget nisi tincidunt, tristique felis quis, tincidunt est. Aliquam consequat aliquam quam non eleifend. Phasellus ut magna luctus, aliquam risus eget, fermentum augue. Aliquam lobortis accumsan magna, quis efficitur enim dictum eu. Pellentesque iaculis felis eget felis commodo, non euismod dolor euismod. Quisque nec arcu rutrum, mollis tortor non, sollicitudin odio. Sed dictum nulla mauris, eu pretium dui vulputate a. Maecenas lacus massa, egestas vitae tincidunt eu, interdum et magna. Lorem ipsum dolor sit amet, consectetur adipiscing elit. In eleifend ex lacus, in consectetur nunc interdum et. Donec interdum mi vitae dolor pretium mattis. In quis arcu sapien. Phasellus at metus vitae nisi tincidunt varius.<br />
</p>
</div>
JSON json
"text": {
"columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
"text": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer porttitor ante a tortor volutpat maximus. Donec eu porta eros. Aenean sit amet eleifend arcu, eu vestibulum magna. Fusce eget nisi tincidunt, tristique felis quis, tincidunt est. Aliquam consequat aliquam quam non eleifend. Phasellus ut magna luctus, aliquam risus eget, fermentum augue. Aliquam lobortis accumsan magna, quis efficitur enim dictum eu. Pellentesque iaculis felis eget felis commodo, non euismod dolor euismod. Quisque nec arcu rutrum, mollis tortor non, sollicitudin odio. Sed dictum nulla mauris, eu pretium dui vulputate a. Maecenas lacus massa, egestas vitae tincidunt eu, interdum et magna. Lorem ipsum dolor sit amet, consectetur adipiscing elit. In eleifend ex lacus, in consectetur nunc interdum et. Donec interdum mi vitae dolor pretium mattis. In quis arcu sapien. Phasellus at metus vitae nisi tincidunt varius.</p>\n",
"richText": true,
":type": "weretail/components/content/text"
}
Dialoogvenster Bewerken edit-dialog
Het dialoogvenster Bewerken bevat de standaardgereedschappen voor tekstopmaak die de gebruiker zou verwachten bij het samenstellen van tekst.
-
Vet
Wordt gebruikt om vette opmaak toe te passen op geselecteerde tekst of opgemaakte tekst die na de cursor wordt ingevoerd.
Ctrl+B kan als toetsenbordkortere weg worden gebruikt.
-
Cursief
Wordt gebruikt om cursieve opmaak toe te passen op geselecteerde tekst of om tekst die na de cursor wordt ingevoerd, cursief te maken.
Ctrl+I kan als toetsenbordkortere weg worden gebruikt.
-
Onderstrepen
Wordt gebruikt om onderstreepte opmaak toe te passen op geselecteerde tekst of onderstreepte tekst die na de cursor wordt ingevoerd.
Ctrl+U kan als toetsenbordkortere weg worden gebruikt.
-
Subscript
Wordt gebruikt om geselecteerde tekst of tekst die na de cursor is ingevoerd, op te maken als een subscript.
-
Superscript
Hiermee maakt u geselecteerde tekst of tekst die na de cursor is ingevoerd, op als superscript.
-
Plakken als tekst
Hiermee plakt u alle gekopieerde tekst als onbewerkte tekst zonder opmaak.
Wanneer u deze optie selecteert, wordt een venster geopend waarin de tekst als onbewerkte tekst zonder opmaak kan worden geplakt als een voorvertoning voordat deze in de tekst wordt ingevoegd. Accepteren door te tikken of op het vinkje te klikken, annuleren door te tikken of op de x te klikken.
-
Plakken vanuit Word
Wanneer u deze optie selecteert, wordt een venster geopend waarin de tekst kan worden geplakt met behoud van de opmaak als voorvertoning voordat deze in de tekst wordt ingevoegd. Accepteren door te tikken of op het vinkje te klikken, annuleren door te tikken of op de x te klikken.
-
Hyperlink
Met deze optie kunt u de geselecteerde tekst omzetten in een hyperlink of een reeds gedefinieerde koppeling wijzigen. Deze optie is alleen actief als er al tekst is geselecteerd en er een venster wordt geopend met aanvullende opties voor het instellen van de koppeling.
-
Voer de locatie in
- Kies in het dialoogvenster Selectie openen een pad in AEM
- Als de koppeling zich niet binnen AEM bevindt, voert u de absolute URL in (niet-absolute paden worden geïnterpreteerd als relatief ten opzichte van AEM)
-
Alternatieve beschrijvende tekst voor de koppeling invoeren
-
Koppelingsgedrag selecteren
- Doel
- Zelfde tabblad
- Nieuw tabblad
- Bovenliggend frame
- Bovenste frame
Tik of klik op het vinkje om de koppeling toe te passen of klik op de x om te annuleren.
-
-
Ontkoppelen
Gebruik deze optie om een koppeling te verwijderen die al op de geselecteerde tekst is toegepast. Deze optie is alleen actief als er al een koppeling is geselecteerd.
-
Zoeken
Gebruik deze optie om de tekst te zoeken op instanties van een opgegeven tekstreeks. Als u deze optie selecteert, wordt een venster geopend waarin u de zoekopties kunt opgeven.
Ga de tekst in waarvoor u wilt zoeken en tikken of Vondst klikken om met het onderzoek te beginnen. Tik of klik op de x om te annuleren.
Als u wenst om een nauwkeurige gelijke volgens het geval te doen, selecteer de optie Geval van de Gelijke alvorens het onderzoek te beginnen.
Als een overeenkomst wordt gevonden, wordt deze gemarkeerd en wordt het zoekdialoogvenster gedimd weergegeven. Tik of klik opnieuw de Vondst knoop in de gedimde dialoog om naar het volgende voorkomen te zoeken.
Als er geen andere exemplaren worden gevonden, wordt een bericht weergegeven en wordt de zoekopdracht opnieuw gestart vanaf het begin van de tekst.
-
Vervangen
Gebruik deze optie om de tekst te zoeken op instanties van een opgegeven tekenreeks en de overeenkomsten te vervangen door een andere tekenreeks. Als u deze optie selecteert, wordt een venster geopend waarin u de opties voor zoeken en vervangen kunt opgeven.
Voer de tekst in waarnaar u wilt zoeken en de tekst waarmee u deze wilt vervangen.
Tik of klik Vondst om met het onderzoek te beginnen. Klik of tik op de x om te annuleren.
Als u wenst om een nauwkeurige gelijke volgens het geval te doen, selecteer de optie Geval van de Gelijke alvorens het onderzoek te beginnen.
Als een overeenkomst wordt gevonden, wordt deze gemarkeerd en wordt het zoekdialoogvenster gedimd weergegeven. Klik opnieuw de Vondst knoop in de gedimde dialoog om naar het volgende voorkomen te zoeken of te selecteren vervang knoop om de benadrukte, aangepaste tekst te vervangen. Merk op dat vervangt knoop slechts actief is zodra een gelijke wordt gemaakt.
Selecteer vervangen allen om alle voorkomen van de tekst in één keer te vervangen.
-
Tekst links uitlijnen
Wordt gebruikt om de tekst uit te lijnen met de linkermarge.
-
Tekst centreren
Hiermee centreert u de tekst.
-
Tekst rechts uitlijnen
Wordt gebruikt om de tekst uit te lijnen met de rechtermarge.
-
Opsommingsteken
Wordt gebruikt om de geselecteerde tekst op te maken als een lijst met opsommingstekens of om te beginnen met het invoegen van een lijst met opsommingstekens na de cursor.
Om een bulleted lijst te eindigen, onttikt of klikt opnieuw de knoop van de Opsommingsteken of gaat twee vervoerterugkeer in.
-
Genummerd
Hiermee maakt u de geselecteerde tekst op als een genummerde lijst of begint u met het invoegen van een genummerde lijst na de cursor.
Om een genummerde lijst te beëindigen, de Genummerde knoop te onttikken of te klikken opnieuw of twee vervoerterugkeer in te gaan.
-
Uitspringen
Wordt gebruikt om het inspringingsniveau te verlagen van de geselecteerde tekst of tekst die na de cursor wordt ingevoerd.
Alleen actief als de geselecteerde tekst of positie van de cursor al is ingesprongen.
-
Inspringen
Wordt gebruikt om het inspringingsniveau te verhogen van de geselecteerde tekst of tekst die na de cursor wordt ingevoerd.
-
Tabel
Wordt gebruikt om een tabel in de tekst in te voegen. Als u deze optie selecteert, wordt een venster geopend waarin u de details van de tabel kunt opgeven.
-
Kolommen - het aantal kolommen van de (vereiste) lijst
-
Rijen - het aantal rijen van de (vereiste) lijst
-
Breedte - de breedte van de lijst
-
Hoogte - de hoogte van de lijst
-
het paddin van de Cel g - de ruimte rond de celinhoud
-
het uit elkaar plaatsen van de Cel - de ruimte tussen cellen
-
Grens - het gewicht van de grenslijnen van de lijst
-
Indien voor de koptekst van de tabel:
- Gebruik de eerste rij
- Gebruik de eerste kolom
- Gebruik de eerste rij en de eerste kolom
- Of er moet geen header worden gebruikt.
-
Titel - de titel van de lijst
-
-
Spellingcontrole
Wordt gebruikt om de spelling van de tekstinhoud te controleren. Mogelijke spelfouten worden onderstreept met gebroken, rode lijnen.
-
Speciale tekens
Wordt gebruikt om speciale tekens in te voegen in de tekst. Als u deze optie selecteert, wordt een venster geopend waarin de beschikbare tekens worden weergegeven.
Tik op het gewenste teken of klik op het gewenste teken om het teken na de cursor in te voegen in de tekst. U kunt meerdere tekens invoegen. Tik of klik op de x om het selectievenster te sluiten.
-
Source Edit
Wordt gebruikt om de HTML-bron van de tekst weer te geven en te wijzigen.
Tik of klik Source geeft pictogram uit om de inhoud van de tekst van de geformatteerde mening te veranderen om ruwe HTML te bekijken. In deze modus zijn alle andere opmaakopties uitgeschakeld. Tik of klik Source geeft opnieuw pictogram uit om aan de geformatteerde mening terug te keren.
note caution CAUTION Zoals altijd het geval met toegang tot ruwe HTML, moet de zorg worden uitgeoefend wanneer het gebruiken van Source geeft optie uit! HTML ingegaan via Source geeft uit wordt gescand voor XSS risico's en om het even welke manuscripten die worden opgenomen worden verwijderd en zullen niet op de resulterende pagina verschijnen. Nochtans misvormde HTML ingegaan in Source geeft uit kan het malplaatje voor de pagina breken resulterend in onverwachte het formatteren of het teruggeven van de resulterende pagina onbruikbaar. -
Alineaopmaak
Wordt gebruikt om alineaopmaak toe te passen op de geselecteerde tekst of op tekst die na de cursor wordt ingevoegd. Als u deze optie selecteert, wordt een vervolgkeuzelijst geopend waarin de alineaopmaak wordt geselecteerd.
De tekstcomponent kan ook in regels worden bewerkt, maar vanwege ruimtebeperkingen zijn niet alle opmaakopties in regels beschikbaar. Schakel over naar de modus Volledig scherm om alle opties weer te geven.
Ontwerpdialoogvenster design-dialog
In het ontwerpdialoogvenster kan de sjabloonauteur definiëren welke tekstopmaakopties beschikbaar zijn voor de auteurs van de inhoud.
Functies features
De volgende functies kunnen voor de component worden geactiveerd of gedeactiveerd.
- Onbewerkte tekst plakken
- Plakken van woord
- Zoeken en vervangen
- Spellingcontrole
- Source bewerken
Opmaak formatting
De volgende opmaakopties kunnen voor de component worden geactiveerd of gedeactiveerd.
- Tabel
- Lijsten
- Uitlijning
- Vet, cursief, onderstrepen
- Koppelingen
- Sub/superscript
Alineastijlen paragraph-styles
Alineastijlen kunnen voor de component worden geactiveerd of gedeactiveerd. Als deze optie is geactiveerd, kunnen de toegestane indelingen worden gedefinieerd.
- Tik of klik voeg knoop toe om een nieuwe stijl op te nemen.
- Voer de code in van de stijl en een beschrijving die worden weergegeven in het dialoogvenster Bewerken.
- Om een stijlkraan te verwijderen of de knoop van de Schrapping te klikken.
- Tik of klik op de handgrepen om de volgorde van de indelingen te wijzigen.
Speciale tekens special-characters
De optie voor het invoegen van speciale tekens kan voor de component worden geactiveerd of gedeactiveerd. Als deze optie is geactiveerd, kunnen de toegestane tekens worden gedefinieerd.
- Tik of klik voeg knoop toe om een nieuw karakter op te nemen.
- Voer de HTML-code van het teken in en een beschrijving die wordt weergegeven in het dialoogvenster Bewerken.
- Om een karakterkraan te verwijderen of de knoop van de Schrapping te klikken.
- Als u de volgorde van de tekens wilt wijzigen, tikt u of klikt u en sleept u de handgrepen.
Technische details technical-details
De recentste technische documentatie over de Component van de Tekst kan op GitHubworden gevonden.
Het volledige kerncomponentenproject kan van GitHub worden gedownload.
De verdere details over het ontwikkelen van de Componenten van de Kern kunnen in de de ontwikkelaarsdocumentatie van de Componenten van de Kern worden gevonden.