DokumentationAEMAnvändarhandbok om grundläggande komponenter

Textkomponent (v1) text-component-v

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Developer
  • Admin
  • User

Komponenten Text är en textredigerings- och dispositionskomponent med funktioner för redigering på plats.

Användning usage

Textkomponenten har en robust textredigerare som gör det enkelt att redigera text i en förenklad, textbunden redigerare och i ett helskärmsformat.

The redigeringsdialogruta funktioner för infogad redigering med begränsade alternativ med full funktionalitet i redigeringsdialogrutan i helskärmsläge. Använda designdialogruta, textformateringsalternativ som rubriker, specialtecken och styckeformat kan konfigureras för mallen för innehållsförfattaren.

Version och kompatibilitet version-and-compatibility

I det här dokumentet beskrivs v1 av textkomponenten, som ursprungligen introducerades i version 1.0.0 av kärnkomponenterna med AEM 6.3.

I följande tabell visas kompatibiliteten för v1 för textkomponenten.

AEM
Textkomponent v1
6.3
Kompatibel
6.4
Kompatibel
CAUTION
Det här dokumentet beskriver v1 för textkomponenten.
Information om den aktuella versionen av textkomponenten finns i Textkomponent -dokument.

Exempel på komponentutdata sample-component-output

Följande prov tas från Vi.butik.

Skärmbild 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"
            }
NOTE
JSON-export från Core Components kräver version 1.1.0 av Core Components. Se kompatibilitetsinformation för kärnkomponenter v1 för mer information.

Dialogrutan Redigera edit-dialog

I redigeringsdialogrutan finns de standardverktyg för RTF-formatering som en användare kan förvänta sig att skapa text.

  • Fet

    Används för att formatera text fet eller fet formatera text som skrivs efter markören.

    Ctrl+B kan användas som kortkommando.

  • Kursiv

    Används för att tillämpa kursiv formatering på markerad text eller kursiv om text som anges efter markören.

    Ctrl+I kan användas som kortkommando.

  • Understruken

    Används för att tillämpa understruken formatering på markerad text eller understruken text som anges efter markören.

    Ctrl+U kan användas som kortkommando.

  • Nedsänkt

    Används för att formatera markerad text eller text som skrivs efter markören som nedsänkt.

  • Upphöjd

    Används för att formatera markerad text eller text som skrivs efter markören som upphöjd text.

  • Klistra in som text

    Klistrar in kopierad text som oformaterad text utan formatering.

    När du väljer det här alternativet öppnas ett fönster där texten kan klistras in som oformaterad text utan formatering som en förhandsvisning innan den infogas i texten. Acceptera genom att trycka eller klicka på bockmarkeringen, avbryt genom att trycka eller klicka på x.

  • Klistra in från Word

    När du väljer det här alternativet öppnas ett fönster där texten kan klistras in med bibehållen formatering som en förhandsvisning innan den infogas i texten. Acceptera genom att trycka eller klicka på bockmarkeringen, avbryt genom att trycka eller klicka på x.

  • Hyperlänk

    Använd det här alternativet om du vill konvertera den markerade texten till en hyperlänk eller ändra en redan definierad länk. Det här alternativet är bara aktivt när text redan är markerad och öppnar ett fönster med ytterligare alternativ för att ange länken.

    • Ange platsen

      • Använd dialogrutan Öppna markering för att välja en bana i AEM
      • Om länken inte finns i AEM anger du den absoluta URL:en (icke-absoluta sökvägar tolkas som relativa till AEM)

    • Ange alternativ beskrivande text för länken

    • Välj länkbeteende

      • Mål
      • Samma flik
      • Ny flik
      • Överordnad ram
      • Övre bildruta

    Tryck eller klicka på bockmarkeringen för att använda länken eller på krysset för att avbryta.

  • Bryt länk

    Använd det här alternativet om du vill ta bort en länk som redan används för den markerade texten. Det här alternativet är bara aktivt när en länk redan är markerad.

  • Sök

    Använd det här alternativet om du vill söka efter förekomster av en angiven textsträng i texten. Om du väljer det här alternativet öppnas ett fönster där du kan ange sökalternativen.

    Ange texten som du vill söka efter och tryck eller klicka på Sök för att påbörja sökningen. Tryck eller klicka på x för att avbryta.

    Om du vill göra en exakt matchning utifrån skiftläget väljer du alternativet Matcha gemener/VERSALER innan sökningen påbörjas.

    Om en matchning hittas markeras den och sökdialogrutan är nedtonad. Tryck eller klicka på Sök igen i den nedtonade dialogrutan för att söka efter nästa förekomst.

    Om inga fler förekomster hittas visas ett meddelande och sökningen startas om från textens början.

  • Ersätt

    Använd det här alternativet om du vill söka efter förekomster av en angiven textsträng och ersätta matchningarna med en annan sträng. Om du väljer det här alternativet öppnas ett fönster där du kan ange alternativ för sökning och ersättning.

    Ange den text som du vill söka efter samt den text som den ska ersättas med.

    Tryck eller klicka Sök för att påbörja sökningen. Klicka eller tryck på x för att avbryta.

    Om du vill göra en exakt matchning utifrån skiftläget väljer du alternativet Matcha gemener/VERSALER innan sökningen påbörjas.

    Om en matchning hittas markeras den och sökdialogrutan är nedtonad. Klicka på Sök igen i den nedtonade dialogrutan för att söka efter nästa förekomst eller markera Ersätt om du vill ersätta den markerade, matchade texten. Observera att Ersätt är bara aktiv när en träff har gjorts.

    Välj Ersätt alla om du vill ersätta alla förekomster av texten samtidigt.

  • Vänsterjustera text

    Används för att justera texten mot vänstermarginalen.

  • Centrera text

    Används för att centrera texten.

  • Högerjustera text

    Används för att justera texten mot högermarginalen.

  • Punkt

    Används för att formatera den markerade texten som en punktlista eller börja infoga en punktlista efter markören.

    Avsluta en punktlista genom att trycka eller klicka på Punkt igen eller ange två vagnreturer.

  • Numrerad

    Används för att formatera den markerade texten som en numrerad lista eller börja infoga en numrerad lista efter markören.

    Avsluta en numrerad lista genom att trycka eller klicka på Numrerad igen eller ange två vagnreturer.

  • Minska indrag

    Används för att minska indragsnivån för den markerade texten eller texten som anges efter markören.

    Endast aktivt om markörens markerade text eller position redan är indragen.

  • Indrag

    Används för att öka indragsnivån för den markerade texten eller texten som anges efter markören.

  • Tabell

    Används för att infoga en tabell i texten. Om du väljer det här alternativet öppnas ett fönster där du kan ange tabellinformation.

    • Kolumner - Antal kolumner i tabellen (obligatoriskt)

    • Rader - Antal rader i tabellen (obligatoriskt)

    • Bredd - Tabellens bredd

    • Höjd - tabellens höjd

    • Cellfyllnad g - Utrymmet runt cellinnehållet

    • Cellmellanrum - Avståndet mellan celler

    • Kant - Bredden på tabellens kantlinjer

    • Om för tabellrubriken:

      • Den första raden ska användas
      • Den första kolumnen ska användas
      • Den första raden och den första kolumnen ska användas
      • Eller så får ingen rubrik användas.

    • Bildtext - Tabellens beskrivning

  • Kontrollera stavning

    Används för att kontrollera stavningen i textinnehållet. Eventuella felstavningar stryks under med brutna, röda linjer.

  • Specialtecken

    Används för att infoga specialtecken i texten. Om du väljer det här alternativet öppnas ett fönster där de tillgängliga tecknen visas.

    Tryck eller klicka på det önskade tecknet för att infoga det i texten efter markören. Flera tecken kan infogas. Tryck eller klicka på x för att stänga markeringsfönstret.

  • Redigera källa

    Används för att visa och ändra textens HTML-källa.

    Tryck eller klicka på Redigera källa om du vill ändra textens innehåll från den formaterade vyn så att HTML visas i Raw-format. I det här läget är alla andra formateringsalternativ inaktiverade. Tryck eller klicka på Redigera källa om du vill återgå till den formaterade vyn.

    note caution
    CAUTION
    Som alltid när det gäller tillgång till obehandlad HTML måste försiktighet iakttas när Redigera källa option!
    HTML via Redigera källa genomsöks efter XSS-risker och eventuella infogade skript tas bort och visas inte på den resulterande sidan. HTML med felaktigt format angavs Redigera källa kan bryta sidans mall vilket resulterar i oväntad formatering eller återgivning av den resulterande sidan som inte kan användas.

  • Styckeformat

    Används för att tillämpa styckeformatering på den markerade texten eller på text som infogas efter markören. Om du väljer det här alternativet öppnas en listruta där styckeformatet är valt.

Textkomponenten kan även redigeras textbundet, men på grund av utrymmesbegränsningar är inte alla formateringsalternativ tillgängliga. Om du vill se alla alternativ växlar du till helskärmsläge.

Designdialogruta design-dialog

I designdialogrutan kan mallskaparen definiera vilka textformateringsalternativ som är tillgängliga för innehållsförfattarna.

Funktioner features

Följande funktioner kan aktiveras eller inaktiveras för komponenten.

  • Klistra in oformaterad text
  • Tidigare från ord
  • Sök och ersätt
  • Stavningskontroll
  • Källredigering

Formatering formatting

Följande formateringsalternativ kan aktiveras eller inaktiveras för komponenten.

  • Tabell
  • Listor
  • Justering
  • Fet, kursiv, understruken
  • Länkar
  • Sub/superscript

Styckeformat paragraph-styles

Styckeformat kan aktiveras eller inaktiveras för komponenten. När det här alternativet är aktiverat kan du definiera vilka format som tillåts.

  • Tryck eller klicka på Lägg till om du vill infoga ett nytt format.
  • Ange koden för formatet och en beskrivning som ska visas i redigeringsdialogrutan.
  • Om du vill ta bort en formatknapp eller klicka på Ta bort -knappen.
  • Om du vill ändra ordningen på formaten trycker du eller klickar och drar i handtagen.

Specialtecken special-characters

Alternativet att infoga specialtecken kan aktiveras eller inaktiveras för komponenten. När du aktiverar det här alternativet kan du definiera tillåtna tecken.

  • Tryck eller klicka på Lägg till om du vill infoga ett nytt tecken.
  • Ange HTML-koden för tecknet och en beskrivning som ska visas i redigeringsdialogrutan.
  • Ta bort en teckenknapp eller klicka på Ta bort -knappen.
  • Om du vill ändra ordningen på tecknen trycker du eller klickar och drar i handtagen.

Teknisk information technical-details

Den senaste tekniska dokumentationen om textkomponenten finns på GitHub.

Hela kärnkomponentprojektet kan laddas ned från GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c