Nedrullningsbar lista

Med en nedrullningsbar lista i ett adaptivt formulär kan användarna välja ett eller flera alternativ i en lista med fördefinierade alternativ. Alternativen kan vara av typen String, Number eller Boolean. Dessutom kan den nedrullningsbara listkomponenten konfigureras så att den har olika validerings- och standardvärden.

Exempel

Användning

Det finns många skäl till att det är bra att ta med en nedrullningsbar lista i en anpassad form, bland annat:

• Lång lista med alternativ: Listrutor är användbara i situationer där det finns en lång lista med alternativ för ett fält. De tar mindre plats i formuläret än en lista med alternativknappar eller kryssrutor och kan vara mindre överväldigande för användarna.

• Konsekvens: Listrutorna ger en konsekvent design och layout av formuläret, vilket gör det mer intuitivt och enkelt för användarna att navigera.

• Klarhet: Listrutor kan göra formuläret tydligare och lättare att förstå genom att tillhandahålla en tydlig och kortfattad lista med alternativ.

• Användarupplevelse: Listrutor kan användas för att göra formuläret mer användarvänligt genom ett tydligt och intuitivt sätt för användarna att välja alternativ.

• Dataanalys: Listrutor kan användas för att samla in data från olika källor och analysera dem, eller för att använda dem som indata för vidare bearbetning.

Dialogrutan Egenskaper

I det här exemplet används elementet Alternativ för att definiera listobjekten. The Visa text -elementet används för att ange en etikett för listobjekt och Datavärde används för att ange det värde som skickas till servern när formuläret skickas.

Varje alternativ i listrutan har ett unikt datavärde och attributet Visa text. Om en användare väljer alternativet "Rött" skickas motsvarande datavärde till servern när formuläret skickas. Dessa data kan sedan bearbetas av ett skript på servern för att avgöra vilka alternativ som har valts av användaren och kan användas för olika åtgärder, som att uppdatera andra fält i formuläret eller skicka formulärdata till ett skript på servern för vidare bearbetning.

Listrutan kan dessutom konfigureras att ha olika bearbetningsvärden för varje alternativ, och detta kan ställas in med Adaptiv Forms regelredigerare.

Version och kompatibilitet

Den adaptiva Forms Accordion Core-komponenten släpptes i februari 2023 som en del av Core Components 2.0.4 för Cloud Service och Core Components 1.1.12 för AEM 6.5.16.0 Forms eller senare. Här är en tabell med alla versioner som stöds, AEM kompatibilitet och länkar till motsvarande dokumentation:

Information om versioner och versioner av kärnkomponenter finns i Huvudkomponentversioner -dokument.

Teknisk information

Hämta den senaste informationen om den adaptiva Forms Core Component (nedrullningsbar lista) i den tekniska dokumentationen om GitHub. Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.

Konfigurera dialogruta

Du kan enkelt anpassa den nedrullningsbara listan för besökare med dialogrutan Konfigurera. Du kan också enkelt definiera alternativ för nedrullningsbara listor för en smidig användarupplevelse.

• Namn - Du kan enkelt identifiera en formulärkomponent med dess unika namn både i formuläret och i regelredigeraren, men namnet får inte innehålla blanksteg eller specialtecken.

• Titel - Med dess titel kan du enkelt identifiera en komponent i ett formulär. Som standard visas titeln ovanpå komponenten. Om du inte lägger till en titel visas komponentens namn i stället för titeltexten.

• Dölj titel - Välj alternativet om du vill dölja komponentens titel.

• Tillåt flera markeringar - Välj det här alternativet om du vill välja flera alternativ i en nedrullningsbar lista.

• Spara värde som - Det här alternativet anger datatypen för det värde som skickas när något alternativ är markerat. Om Spara värde som är inställd på Number och du lägger till strängdata i Datavärde ​ ​ på Alternativ visas en Value type mismatch felmeddelande.

  I Alternativ kan du lägga till datavärden och visa textpar med Lägg till -knappen. När ett nytt alternativ har lagts till utförs följande åtgärder:

  • Datavärde - Med det här alternativet kan du ange det innehåll som ska skickas när ett alternativ har valts.
  • Visa text - Med det här alternativet kan du ange det innehåll som ska visas i ett adaptivt formulär.
  • Ta bort - Tryck eller klicka för att ta bort alternativet för en nedrullningsbar meny.
  • Ordna om - Tryck eller klicka och dra för att ändra ordningen för alternativet i en nedrullningsbar meny.

• Standardalternativ - Med det här alternativet kan du lägga till standardvärden. Använd ikonen Ta bort för att ta bort det tillagda alternativet. Om Spara värde som är inställd på Number och du lägger till strängdata i Standardalternativ visas en Value type mismatch felmeddelande.

• Platshållartext - Platshållartext i en formulärkomponent refererar till en kort etikett eller en fråga som visas i ett inmatningsfält som ett tips till användaren om vilken typ av information som förväntas anges i det fältet. Platshållartext försvinner när användaren börjar skriva i fältet och visas igen om fältet lämnas tomt. Den ger användaren en visuell referens, men fungerar inte som en permanent etikett eller ett permanent värde för fältet.

• Bindningsreferens - En bind referens är en referens till ett dataelement som lagras i en extern datakälla och används i ett formulär. Med den binda referensen kan du binda data dynamiskt till formulärfält så att formuläret kan visa de senaste data från datakällan. En bindningsreferens kan till exempel användas för att visa en kunds namn och adress i ett formulär baserat på kundens ID som anges i formuläret. Bindningsreferensen kan också användas för att uppdatera datakällan med data som anges i formuläret. På så sätt kan AEM Forms skapa formulär som interagerar med externa datakällor, vilket ger en smidig användarupplevelse för att samla in och hantera data.

• Dölj komponent - Välj alternativet att dölja komponenten från formuläret. Komponenten är fortfarande tillgänglig för andra syften, som att använda den för beräkningar i regelredigeraren. Detta är användbart när du behöver lagra information som inte behöver visas eller ändras direkt av användaren.

• Inaktivera komponent - Välj alternativet att inaktivera komponenten. Den inaktiverade komponenten är inte aktiv eller redigerbar av slutanvändaren. Användaren kan se fältets värde, men kan inte ändra det. Komponenten är fortfarande tillgänglig för andra syften, som att använda den för beräkningar i regelredigeraren.

• Skrivskyddad - Välj alternativet att göra komponenten icke-redigerbar. Användaren kan se fältets värde, men kan inte ändra det. Komponenten är fortfarande tillgänglig för andra syften, som att använda den för beräkningar i regelredigeraren.

Fliken Validering

• Obligatoriskt - Välj det här alternativet om du vill visa komponenten i ett adaptivt formulär. Du kan inte välja Dölj komponent eller Inaktivera komponent i Grundläggande när det här alternativet är markerat.

• Felmeddelande - Med det här alternativet kan du ange ett meddelande som visas om Obligatoriskt kryssrutan är markerad och formulärfältet är tomt.

• Skriptverifieringsmeddelande - Med det här alternativet kan du ange ett meddelande som ska visas om skriptvalideringen misslyckas.

Fliken Hjälpinnehåll

• Kort beskrivning - En kort beskrivning är en kort textförklaring som ger ytterligare information eller förtydliganden om syftet med ett visst formulärfält. Det hjälper användaren att förstå vilken typ av data som ska anges i fältet och kan ge riktlinjer eller exempel som hjälper till att säkerställa att den angivna informationen är giltig och uppfyller de önskade kriterierna. Som standard är korta beskrivningar dolda. Aktivera Visa alltid kort beskrivning för att visa den under komponenten.

• Visa alltid kort beskrivning - Aktivera alternativet att visa den korta beskrivningen under komponenten.

• Hjälptext - Hjälptexten hänvisar till ytterligare information eller vägledning som användaren får för att hjälpa sig fylla i ett formulärfält på rätt sätt. Det visas när användaren klickar på hjälpikonen (i) som finns bredvid komponenten. Hjälptexten ger mer detaljerad information än etiketten eller platshållartexten för ett formulärfält och är utformad för att hjälpa användaren förstå fältets krav eller begränsningar. Den kan också ge förslag eller exempel som gör det enklare och exaktare att fylla i formuläret.

Fliken Tillgänglighet

Text för skärmläsare - Text för skärmläsare avser text som är avsedd att läsas av hjälpmedelstekniker, t.ex. skärmläsare, som används av personer med nedsatt syn. Den här texten innehåller en ljudbeskrivning av formulärfältets syfte och kan innehålla information om fältets titel, beskrivning, namn och relevanta meddelanden (anpassad text). Skärmläsartexten ser till att formuläret är tillgängligt för alla användare, även användare med nedsatt syn, och ger dem en fullständig förståelse för formulärfältet och dess krav.

Designdialogruta

Designdialogrutan används för att definiera och hantera CSS-format för den nedrullningsbara listkomponenten.

Fliken Format

Fliken används för att definiera och hantera CSS-format för en komponent. Core Component (Core-komponent) i listrutan Adaptiv Forms stöder AEM Formatsystem.

• CSS-standardklasser: Du kan ange en standard-CSS-klass för den adaptiva Forms-listrutan Core Component (Core-komponent).

• Tillåtna format: Du kan definiera format genom att ange ett namn och den CSS-klass som representerar formatet. Du kan till exempel skapa ett format med namnet"bold text" och ge CSS-klassen"font-weight: fet". Du kan använda eller tillämpa dessa format på ett adaptivt formulär i den adaptiva Forms-redigeraren. Om du vill använda ett format väljer du den komponent du vill använda formatet på i Adaptiv Forms-redigerare, navigerar till egenskapsdialogrutan och väljer önskat format i dialogrutan Stilar nedrullningsbar lista. Om du behöver uppdatera eller ändra formaten går du tillbaka till designdialogrutan, uppdaterar formaten på formatfliken och sparar ändringarna.

Resurser för Business.Adobe.com