Formulärtextkomponent (v1)

Med komponenten Core Component Form Text kan du skriva in formulärtext.

Användning

Komponenten Form Text tillåter olika typer av text och är avsedd att användas tillsammans med formulärbehållarkomponenten.

Typen av textvalidering, etiketter och hjälpmeddelanden kan definieras av innehållsredigeraren i konfigurationsdialogrutan.

Version och kompatibilitet

I det här dokumentet beskrivs v1 av Form Text Component, som ursprungligen introducerades i version 1.0.0 av Core Components med AEM 6.3.

I följande tabell visas kompatibiliteten för v1 för Form Text Component.

AEM Formulärtextkomponent v1
6.3 Kompatibel
6.4 Kompatibel
FÖRSIKTIGHET

I det här dokumentet beskrivs v1 för Form Text Component.

Information om den aktuella versionen av formulärtextkomponenten finns i dokumentet Formulärtextkomponent.

Exempel på komponentutdata

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

Skärmbild

HTML

<div class="cmp cmp-form aem-GridColumn aem-GridColumn--default--12">
 <form method="POST" action="/content/we-retail/us/en/experience.html" id="new_form" name="new_form" enctype="multipart/form-data" class="aem-Grid aem-Grid--12 aem-Grid--default--12 ">
     <input type="hidden" name=":formstart" value="/content/we-retail/us/en/experience/jcr:content/root/responsivegrid/container">
     <div class="cmp cmp-form-field aem-GridColumn aem-GridColumn--default--12">
   <div class="form-group">
       <label for="form-text-978484744">How many pieces of toast would you like?</label>
          <input type="number" id="form-text-978484744" name="pieces">
   </div>
  </div>
 </form>
</div>

JSON

"container": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "columnCount": 12,
              "gridClassNames": "aem-Grid aem-Grid--12 aem-Grid--default--12",
              ":items": {
                "text": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/text",
                  "name": "piecesOfToast",
                  "jcr:title": "How many pieces of toast would you like?",
                  "type": "number",
                  "rows": "2"
                }
              },
              ":itemsOrder": [
                "text"
              ],
              ":type": "weretail/components/form/container"
            }
OBSERVERA

JSON-export från Core Components kräver version 1.1.0 av Core Components. Mer information finns i kompatibilitetsinformationen för Core Components v1.

Konfigurera dialogruta

I dialogrutan Konfigurera kan innehållsförfattaren definiera vilken typ av text som ska anges samt standardvärden och etiketter.

Huvud

  • Begränsning - Den typ av text som ska anges och valideras mot

    • Text
    • Textområde
    • E-post
    • Tel
    • Date
    • Siffra
    • Lösenord
  • Textrader - Antal rader som ska visas i textområdet (visas bara när ​Begränsningar är inställda på textområde)

  • Etikett - Den etikett som ska visas för fältet

  • Dölj att etiketten visas - Behövs om etiketten endast är nödvändig för hjälpmedelsändamål och inte ger någon ytterligare visuell information om fältet

  • Elementnamn - Namnet på fältet som skickas med formulärdata

  • Värde - Standardvärde som är förifyllt i fältet

Om

  • Hjälpmeddelande - Ett tips till användaren om vad som kan anges i fältet
  • Visa hjälpmeddelandet som platshållare - Om du vill visa hjälpmeddelandet i formulärinmatningen när den är tom och inte fokuserad

Begränsningar

  • Begränsningsmeddelande

    • Meddelande som visas som verktygstips när formuläret skickas om värdet inte validerar vald typ
    • Visas inte för begränsningstyperna Text och Textområde
  • Obligatoriskt - Om det här alternativet är markerat måste användaren fylla i ett värde innan formuläret skickas

  • Gör skrivskyddad - Om du väljer det här alternativet kan användaren inte ändra fältets värde

Designdialogruta

Det finns ingen designdialogruta för komponenten Formulärtext.

Teknisk information

Den senaste tekniska dokumentationen om Form Text Component finns på GitHub.

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

Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen till Core Components developer.

På denna sida