Onderdeel vervolgkeuzelijst drop-down-list-adaptive-forms-core-component

Met een vervolgkeuzelijst in een adaptief formulier kunnen gebruikers een of meer opties selecteren in een lijst met vooraf gedefinieerde opties. De opties kunnen van het type String, Number of Boolean zijn. Bovendien, kan de drop-down lijstcomponent worden gevormd om verschillende bevestiging en standaardwaarden te hebben.

Voorbeeld
voorbeeld

Gebruik reasons-to-use-drop-down-list

Er zijn verschillende redenen waarom het nuttig is om een vervolgkeuzelijst op te nemen in een adaptief formulier, zoals:

  • Lange lijst met opties: Vervolgkeuzelijsten zijn handig voor situaties waarin een veld een lange lijst met opties bevat. Ze nemen minder ruimte in het formulier in beslag dan een lijst met keuzerondjes of selectievakjes. De gebruikers hebben dit minder nodig.

  • Consistentie: Vervolgkeuzelijsten bieden consistentie in het ontwerp en de indeling van het formulier, waardoor het intuïtiever wordt en gebruikers gemakkelijker door het formulier kunnen navigeren.

  • Helderheid: Met vervolgkeuzelijsten kunt u het formulier duidelijker en begrijpelijker maken door een duidelijke en beknopte lijst met opties te bieden.

  • Gebruikerservaring: Met vervolgkeuzelijsten kunt u het formulier gebruiksvriendelijker maken door gebruikers een duidelijke en intuïtieve manier te bieden om opties te selecteren.

  • Gegevensanalyse: Vervolgkeuzelijsten kunnen worden gebruikt om gegevens van verschillende bronnen te verzamelen en te analyseren, of om deze als invoer voor verdere verwerking te gebruiken.

Dialoogvenster Eigenschappen

dialoogvenster Eigenschappen

In dit voorbeeld wordt het element Opties gebruikt om de lijstitems te definiëren. De Tekst weergeven element wordt gebruikt om een label voor lijstitems te verstrekken en Gegevenswaarde wordt gebruikt om de waarde op te geven die naar de server wordt verzonden wanneer het formulier wordt verzonden.

Elke vervolgkeuzelijst heeft een unieke waarde voor Gegevens en een uniek kenmerk voor Tekst weergeven. Als een gebruiker de optie "Rood" selecteert, wordt de bijbehorende waarde van Gegevens verzonden naar de server wanneer het formulier wordt verzonden. Deze gegevens kunnen vervolgens worden verwerkt door een serverscript om te bepalen welke opties door de gebruiker zijn geselecteerd en kunnen worden gebruikt om verschillende handelingen uit te voeren, zoals het bijwerken van andere velden in het formulier of het verzenden van de formuliergegevens naar een serverscript voor verdere verwerking.

Bovendien, kan de drop-down lijst worden gevormd om verschillende verwerkingswaarden voor elke optie te hebben, en dit kan worden geplaatst door de Adaptieve Redacteur van de Regel van Forms te gebruiken.

Versie en compatibiliteit version-and-compatibility

De Adaptive Forms Accordion Core Component is in februari 2023 uitgebracht als onderdeel van Core Components 2.0.4 for Cloud Service and Core Components 1.1.12 voor AEM 6.5.16.0 Forms of hoger. Hier volgt een tabel met alle ondersteunde versies, AEM compatibiliteit en koppelingen naar de bijbehorende documentatie:

Componentversie
AEM as a Cloud Service
AEM 6.5.16.0 Forms of hoger
v1
Compatibel met
versie 2.0.4 en hoger
Compatibel met
release 1.1.12 en later, maar minder dan 2.0.0.

Raadpleeg voor meer informatie over versies en releases van de Core Component de Versies van kerncomponenten document.

Technische details technical-details

Lees de nieuwste informatie over de Adaptive Forms vervolgkeuzelijst Core Component in de technische documentatie over GitHub. Voor meer informatie over het ontwikkelen van Core Components, bekijk Documentatie voor ontwikkelaars van kerncomponenten.

Dialoogvenster configureren configure-dialog

Met het dialoogvenster Configureren kunt u uw ervaring in de vervolgkeuzelijst eenvoudig aanpassen voor bezoekers. U kunt ook eenvoudig opties voor vervolgkeuzelijsten definiëren voor een naadloze gebruikerservaring.

Het tabblad Basis

  • Naam - U kunt een formuliercomponent gemakkelijk herkennen met de unieke naam, zowel in het formulier als in de regeleditor, maar de naam mag geen spaties of speciale tekens bevatten.

  • Titel - Met Titel kunt u een component gemakkelijk herkennen in een formulier. Standaard wordt de titel boven op de component weergegeven. Als u geen titel toevoegt, wordt de naam van de component weergegeven in plaats van de titeltekst.

  • RTF-tekst voor titel toestaan - Met deze functies kunnen gebruikers gewone teksttitels opmaken en functies zoals vet, cursief, onderstreepte tekst, diverse lettertypen, tekengrootten, kleuren en extra opties opnemen om de visuele presentatie en aanpassing te verbeteren. Deze functie biedt meer flexibiliteit en creatieve controle bij het opvallen van titels in documenten, websites of toepassingen.
    Na het selecteren van het selectievakje voor RTF-tekst voor titel toestaan worden opmaakopties zichtbaar om de titel van de component op te maken. Als u toegang wilt tot alle beschikbare opmaakopties, klikt u op de knop Pictogram Volledig scherm tab.

    RTF-ondersteuning

  • Titel verbergen - Selecteer de optie om de titel van de component te verbergen.

  • Meerdere selecties toestaan - Selecteer deze optie als u meerdere opties in een vervolgkeuzelijst wilt selecteren.

  • Waarde opslaan als - Met deze optie geeft u het gegevenstype op van de waarde die wordt verzonden wanneer een optie is geselecteerd. Als de Waarde opslaan als is ingesteld op Number en u voegt tekenreeksgegevens toe aan Gegevenswaarde ​ ​ op de Opties tabblad geeft het scherm een Value type mismatch foutbericht.

    In de Opties kunt u gegevenswaarden toevoegen en tekstparen weergeven met de opdracht Toevoegen knop. Nadat een nieuwe optie is toegevoegd, worden de volgende handelingen uitgevoerd:

    • Gegevenswaarde - Met deze optie kunt u de inhoud invoeren die u wilt verzenden wanneer een optie is geselecteerd.
    • Tekst weergeven - Met deze optie kunt u de inhoud invoeren die u wilt weergeven in een adaptief formulier.
    • Verwijderen - Tik of klik om de optie van een vervolgkeuzemenu te verwijderen.
    • Opnieuw rangschikken - Tik of klik en sleep om de volgorde voor de optie van een vervolgkeuzemenu te wijzigen.
  • Standaardoptie - U kunt nu standaardwaarden toevoegen. Gebruik het verwijderpictogram om de toegevoegde optie te verwijderen. Als de Waarde opslaan als is ingesteld op Number en u voegt tekenreeksgegevens toe aan Standaardopties, wordt een Value type mismatch foutbericht.

  • Plaatsaanduidingstekst - Plaatsaanduidingstekst in een formuliercomponent verwijst naar een kort label of een korte vraag die binnen een invoerveld wordt weergegeven als een tip voor de gebruiker met betrekking tot welk type informatie naar verwachting in dat veld wordt ingevoerd. Plaatsaanduidingstekst verdwijnt wanneer de gebruiker in het veld typt en verschijnt opnieuw als het veld leeg blijft. De klasse biedt een visuele aanwijzing voor de gebruiker, maar fungeert niet als een permanent label of een permanente waarde voor het veld.

  • Opties - U kunt gegevenswaarden toevoegen en tekstparen weergeven met de opdracht Toevoegen knop. Nadat een nieuwe optie is toegevoegd, kunnen de volgende acties worden uitgevoerd:

    • Gegevenswaarde - Met deze optie kunt u de inhoud invoeren die u wilt verzenden wanneer een optie is geselecteerd.
    • Tekst weergeven - Met deze optie kunt u de inhoud invoeren die u wilt weergeven in een adaptief formulier.
    • Verwijderen - Tik of klik om de optie van een selectievakje te verwijderen.
    • Opnieuw rangschikken - Tik of klik en sleep om de volgorde van de deelvensters te wijzigen.
  • Bindverwijzing - Een bind verwijzing is een verwijzing naar een gegevenselement dat in een externe gegevensbron wordt opgeslagen en in een vorm wordt gebruikt. Met de bind-verwijzing kunt u gegevens dynamisch binden aan formuliervelden, zodat in het formulier de meest actuele gegevens uit de gegevensbron kunnen worden weergegeven. Een bind-verwijzing kan bijvoorbeeld worden gebruikt om de naam en het adres van een klant in een formulier weer te geven op basis van de id van de klant die in het formulier is ingevoerd. De bind verwijzing kan ook worden gebruikt om de gegevensbron met gegevens bij te werken ingegaan in de vorm. Op deze manier kunt u in AEM Forms formulieren maken die interageren met externe gegevensbronnen, zodat u een naadloze gebruikerservaring hebt voor het verzamelen en beheren van gegevens.

  • Markeren als niet-gebonden formulierelement: Selecteer de optie om een formulierveld te configureren dat niet is gekoppeld aan een schema. Met deze optie kunt u gegevens opslaan zonder de gegevensbron bij te werken. Het laat u ook toe om gegevens op een douanemethode, los van standaardgegevensbestandintegratie te behandelen.

  • Component verbergen - Selecteer de optie om de component te verbergen voor het formulier. De component blijft toegankelijk voor andere doeleinden, zoals het gebruiken voor berekeningen in de Redacteur van de Regel. Dit is handig wanneer u informatie wilt opslaan die niet hoeft te worden bekeken of rechtstreeks door de gebruiker hoeft te worden gewijzigd.

  • Component uitschakelen - Selecteer de optie om de component uit te schakelen. De uitgeschakelde component is niet actief of bewerkbaar voor de eindgebruiker. De gebruiker kan de waarde van het veld zien, maar kan deze niet wijzigen. De component blijft toegankelijk voor andere doeleinden, zoals het gebruiken voor berekeningen in de Redacteur van de Regel.

  • Alleen-lezen - Selecteer de optie om de component niet-bewerkbaar te maken. De gebruiker kan de waarde van het veld zien, maar kan deze niet wijzigen. De component blijft toegankelijk voor andere doeleinden, zoals het gebruiken voor berekeningen in de Redacteur van de Regel.

Tabblad Validatie validation-tab

Tabblad Validatie

  • Vereist - Selecteer deze optie als u de component wilt weergeven in een adaptief formulier. Nadat u de optie hebt geselecteerd, moet u een selectie maken voordat u een formulier kunt verzenden. U kunt de Component verbergen of Component uitschakelen in de Basis als deze optie is geselecteerd.

  • Foutbericht - Met deze optie kunt u een bericht invoeren dat wordt weergegeven als de optie Vereist wordt ingeschakeld en wordt het formulierveld leeg gelaten.

  • Bericht voor scriptvalidatie - Met deze optie kunt u een bericht invoeren dat wordt weergegeven als de scriptvalidatie mislukt.

Het tabblad Help-inhoud help-content-tab

Help-inhoud, tabblad

  • Korte beschrijving - Een korte beschrijving is een korte tekstuitleg met aanvullende informatie of verduidelijking over het doel van een specifiek formulierveld. Het helpt de gebruiker begrijpen welk type gegevens in het gebied moeten worden ingegaan en kan richtlijnen of voorbeelden verstrekken helpen ervoor zorgen dat de ingevoerde informatie geldig is en aan de gewenste criteria voldoet. Korte beschrijvingen blijven standaard verborgen. De optie Altijd korte beschrijving tonen gebruiken om de achtergrondafbeelding onder de component weer te geven.

  • Altijd korte beschrijving tonen - Schakel de optie in om de korte beschrijving onder de component weer te geven.

  • Help-tekst - De Help-tekst verwijst naar aanvullende informatie of aanwijzingen die de gebruiker krijgt om deze te helpen bij het correct invullen van een formulierveld. Deze wordt weergegeven wanneer de gebruiker op het Help-pictogram (i) naast de component klikt. De Help-tekst biedt gedetailleerdere informatie dan de label- of plaatsaanduidingstekst van een formulierveld en is ontworpen om de gebruiker te helpen de vereisten of beperkingen van het veld te begrijpen. Het kan ook suggesties of voorbeelden bevatten om het invullen van het formulier eenvoudiger en nauwkeuriger te maken.

Tabblad Toegankelijkheid accessibility-tab

Toegankelijkheid, tabblad

  • Tekst voor schermlezers - Tekst voor schermlezers verwijst naar extra tekst die specifiek is bedoeld om te worden gelezen door ondersteunende hulpmiddelen, zoals schermlezers, die door visueel gehandicapten worden gebruikt. Deze tekst bevat een audiobeschrijving van het doel van het formulierveld en kan informatie bevatten over de titel, beschrijving, naam en relevante berichten (aangepaste tekst) van het veld. Met de schermlezertekst kunt u ervoor zorgen dat het formulier toegankelijk is voor alle gebruikers, inclusief gebruikers met een visuele handicap, en krijgt deze een volledig inzicht in het formulierveld en de vereisten ervan.

    • Aangepaste tekst: Selecteer deze optie als u de aangepaste tekst voor toegankelijkheidslabels in ARIA wilt gebruiken. Als u deze optie selecteert, wordt het dialoogvenster Aangepaste tekst weergegeven. U kunt relevante informatie toevoegen in het dialoogvenster Aangepaste tekst.
    • Beschrijving: Selecteer deze optie als u de beschrijving voor toegankelijkheidslabels van ARIA wilt gebruiken.
    • Titel: Selecteer deze optie als u de titel voor toegankelijkheidslabels in ARIA wilt gebruiken.
    • Naam: Selecteer deze optie als u de naam voor toegankelijkheidslabels van ARIA wilt gebruiken.
    • Geen: Selecteer deze optie als u geen toegankelijkheidslabels voor ARIA wilt toevoegen.

Ontwerpdialoogvenster design-dialog

Het dialoogvenster Ontwerpen wordt gebruikt om CSS-stijlen voor de vervolgkeuzelijstcomponent te definiëren en te beheren.

Tabblad Stijlen styles-tab

Het tabblad wordt gebruikt om CSS-stijlen voor een component te definiëren en te beheren. De Adaptive Forms vervolgkeuzelijst Core Component ondersteunt de AEM Stijlsysteem.

Ontwerpdialoogvenster

  • Standaard CSS-klassen: U kunt een standaard CSS-klasse opgeven voor de Adaptive Forms Drop-down Core Component.

  • Toegestane stijlen: U kunt stijlen definiëren door een naam op te geven en de CSS-klasse op te geven die de stijl vertegenwoordigt. U kunt bijvoorbeeld een stijl met de naam "vetgedrukte tekst" maken en de CSS-klasse "font-weight: bold" opgeven. U kunt deze stijlen gebruiken of toepassen op een adaptief formulier in de Adaptieve Forms-editor. Als u een stijl wilt toepassen, selecteert u in de Adaptieve Forms-editor de component waarop u de stijl wilt toepassen, navigeert u naar het dialoogvenster Eigenschappen en selecteert u de gewenste stijl in het menu Stijlen vervolgkeuzelijst. Als u de stijlen moet bijwerken of wijzigen, gaat u terug naar het dialoogvenster Ontwerpen, werkt u de stijlen op het tabblad Stijlen bij en slaat u de wijzigingen op.

Aangepaste eigenschappen

Dialoogvenster Aangepaste eigenschappen

Met aangepaste eigenschappen kunt u aangepaste kenmerken (sleutelwaardeparen) aan een Adaptief kernonderdeel van een formulier koppelen met behulp van de formuliersjabloon. De aangepaste eigenschappen worden weergegeven in de sectie Eigenschappen van de koploze uitvoering van de component. Hiermee kunt u dynamisch formuliergedrag maken dat wordt aangepast op basis van de waarden van aangepaste kenmerken. Ontwikkelaars kunnen bijvoorbeeld verschillende uitvoeringen van een Forms-component zonder koptekst ontwerpen voor mobiele apparaten, desktops of webplatforms, waardoor de gebruikerservaring op een groot aantal apparaten aanzienlijk wordt verbeterd.

  • Groepsnaam: U kunt een naam opgeven om de groep met aangepaste eigenschappen te identificeren. U kunt meerdere groepen met aangepaste eigenschappen toevoegen, verwijderen of opnieuw rangschikken. Nadat u de aangepaste groep eigenschappen hebt toegevoegd, kunt u de volgende opties zien:

    • Belangrijke paren: U kunt meerdere aangepaste eigenschapnamen en aangepaste eigenschapswaarden toevoegen door op de knop Toevoegen knop voor elke aangepaste groep eigenschappen.

    • Verwijderen: Tik of klik om de naam van de aangepaste eigenschap en de waarde van de aangepaste eigenschap te verwijderen.

    • Opnieuw rangschikken: Tik of klik en sleep om de volgorde van de naam van de aangepaste eigenschap en de waarde van de aangepaste eigenschap te wijzigen.

Verwante artikelen related-articles

Zie ook see-also

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