DokumentationAEMAnvändarhandbok om grundläggande komponenter

Textkomponent (v1) text-component-v

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare
  • Administratör
  • Användare

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.

Dialogrutan Redigera innehåller redigeringsfunktioner i rad med begränsade alternativ med full funktionalitet i redigeringsdialogrutan i helskärmsläge. Med hjälp av designdialogrutan kan textformateringsalternativ som rubriker, specialtecken och styckeformat 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 dokumentet Textkomponent.

Exempel på komponentutdata sample-component-output

Följande är ett exempel från We.Retail.

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. Mer information finns i kompatibilitetsinformationen för kärnkomponenter v1.

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 har tillämpats på 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 den text 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, markerar du alternativet Matcha skiftläge innan du startar sökningen.

    Om en matchning hittas markeras den och sökdialogrutan är nedtonad. Tryck eller klicka på knappen 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 på 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, markerar du alternativet Matcha skiftläge innan du startar sökningen.

    Om en matchning hittas markeras den och sökdialogrutan är nedtonad. Klicka på knappen Sök igen i den nedtonade dialogrutan om du vill söka efter nästa förekomst, eller välj knappen Ersätt om du vill ersätta den markerade, matchade texten. Observera att knappen Ersätt bara är aktiv när en matchning 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.

    Om du vill avsluta en punktlista trycker eller klickar du på knappen Bullet igen eller anger 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.

    Om du vill avsluta en numrerad lista trycker eller klickar du på knappen Numrerad igen eller anger två radmatningar.

  • 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 - antalet rader i tabellen (obligatoriskt)

    • Bredd - Tabellens bredd

    • Höjd - tabellens höjd

    • Cellfyllnad g - Utrymmet runt cellinnehållet

    • Cellmellanrum - Mellanrummet mellan celler

    • Kant - vikten 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.

    • Beskrivning - 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. Det går att infoga flera tecken. Tryck eller klicka på x för att stänga markeringsfönstret.

  • Source Edit

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

    Tryck eller klicka på ikonen Source Edit om du vill ändra textens innehåll från den formaterade vyn så att du kan visa HTML i Raw-format. I det här läget är alla andra formateringsalternativ inaktiverade. Tryck eller klicka på ikonen Source Edit igen för att återgå till den formaterade vyn.

    note caution
    CAUTION
    Som alltid när du har åtkomst till Raw-HTML måste du vara försiktig när du använder alternativet Source Edit!
    HTML som anges via Source Edit genomsöks efter XSS-risker och eventuella infogade skript tas bort och visas inte på den resulterande sidan. Felformaterad HTML som angetts i Source Edit kan emellertid bryta sidans mall, vilket resulterar i oväntad formatering eller oanvändbar återgivning av den resulterande sidan.

  • 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
  • Source-redigering

Formatering formatting

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

  • Tabell
  • Listor
  • Justering
  • Fet, kursiv, understruken
  • Länkar
  • Under/upphöjd

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å knappen Lägg till för att 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 klickar på knappen Ta bort .
  • 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 det här alternativet är aktiverat kan du definiera tillåtna tecken.

  • Tryck eller klicka på knappen Lägg till för att infoga ett nytt tecken.
  • Ange HTML-koden för tecknet och en beskrivning som ska visas i redigeringsdialogrutan.
  • Om du vill ta bort en teckentryckning eller klicka på knappen Ta bort .
  • 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 hämtas från GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen för kärnkomponentutvecklare.

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