Komponent för formulärfragment form-fragment-component-adaptive-forms-core-component

Den här artikeln innehåller innehåll omTillåt RTF-text för rubriken förhandsversion. Förhandsversionen är bara tillgänglig via vår kanal för förhandsversion.

Adaptiv Forms är ett bekvämt sätt att skapa formulärsegment, t.ex. paneler eller fältgrupper, så att de kan återanvändas i olika adaptiva Forms. Dessa återanvändbara och fristående segment kallas Adaptiva formulärfragment.

Du kan lägga till ett fragment flera gånger i ett dokument och använd databindningsegenskaper för komponenterna för att knyta dem till olika datakällor eller scheman. Du kan till exempel använda samma adressfragment för permanent adress, kommunikations- och faktureringsadress och ansluta det till olika fält i en datakälla eller ett schema.

exempel

Du kan också använda upprepningsalternativ Om du vill duplicera formulärfragmentkomponenten och dess underordnade komponenter definierar du ett minsta och högsta antal repetitioner och underlättar replikering av liknande avsnitt i ett formulär.

NOTE
Du kan skapa ett adaptivt formulärfragment från scratch eller spara en panel i ett befintligt adaptivt formulär som fragment.

Användning usage

  • Återanvändbarhet: Möjligheten att återanvända formulärfragment i flera adaptiva Forms är den största fördelen med att använda formulärfragment. Det bidrar till att bibehålla en konsekvent design och funktionalitet, eftersom ändringar som görs i ett fragment återspeglas i alla instanser där det används.

  • Enhetlig användarupplevelse: Att använda formulärfragment för vanliga element, till exempel sidhuvuden och sidfötter, ger en konsekvent och sammanhängande användarupplevelse.

  • Smidigt underhåll: Ändringarna eller ändringarna som görs i ett formulärfragment återspeglas i alla instanser där det används. Det förenklar underhållet och minskar risken för fel.

  • Effektivitet: Designers och utvecklare sparar tid genom att bara skapa och testa formulärfragment en gång. Blankettfragmenten kan sedan enkelt läggas in i flera adaptiva Forms utan att man behöver göra ett överflödigt arbete.

Version och kompatibilitet version-and-compatibility

Den adaptiva kärnkomponenten i Forms Fragment släpptes som en del av Core Components 2.0.50 för Cloud Service och Core Components 1.1.26 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:

Komponentversion
AEM as a Cloud Service
AEM 6.5.16.0 Forms eller senare
v1
Kompatibel med
version 2.0.50 och senare
Kompatibel med
version 1.1.26 och senare men mindre än 2.0.0.

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

Teknisk information technical-details

Den senaste informationen om den adaptiva kärnkomponenten i Forms Fragment finns i den tekniska dokumentationen om GitHub. Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.

Konfigurera dialogruta configure-dialog

Du kan enkelt anpassa fragmentupplevelsen för besökare med dialogrutan Konfigurera. Du kan också enkelt definiera fragmentegenskaper för en smidig användarupplevelse.

Fliken Grundläggande basic-tab

Fliken Grundläggande

  • 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 rubriktexten.

  • Tillåt RTF-text för rubrik - Med den här funktionen kan användare formatera vanliga texttitlar med funktioner som fet, kursiv, understruken text, olika teckensnitt, teckenstorlekar, färger och ytterligare alternativ för att förbättra visuell presentation och anpassning. Det ger större flexibilitet och kreativ kontroll när det gäller att få titlar att sticka ut i dokument, på webbplatser och i tillämpningar.
    När du markerar kryssrutan för Tillåt RTF-text för rubrik blir formateringsalternativen synliga för att formatera komponentens titel. Om du vill visa alla tillgängliga formateringsalternativ klickar du på Helskärmsikon -fliken.

    Stöd för RTF

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

  • Gruppera underordnade komponenters data när formulär skickas (kapsla in data i objekt) - När alternativet är markerat kapslas data från dess underordnade komponenter in i den överordnade komponentens JSON-objekt. Om alternativet inte är markerat har inskickade JSON-data en platt struktur utan objekt för den överordnade komponenten. Till exempel:

    • När alternativet är markerat kapslas data från de underordnade komponenterna (till exempel Street, City och Zip Code) in i den överordnade komponenten (Address) som ett JSON-objekt. Detta skapar en hierarkisk struktur och data ordnas under den överordnade komponenten.

      Struktur på inlämnade uppgifter:

      code language-json
      { "Address":
      
      { "Street": "123 Main Street", "City": "New York", "Zip Code": "12345" }
      
      }
      
    • När alternativet inte är markerat har skickade JSON-data en platt struktur utan objekt för den överordnade komponenten (adress). Alla data finns på samma nivå, utan någon hierarkisk organisation.

      Struktur på inlämnade uppgifter:

      code language-json
         { "Street": "123 Main Street", "City": "New York", "Zip Code": "12345" }
      
  • Fragmentreferens - En fragmentreferens är en referens till ett formulärfragment som lagras i en extern datakälla och används i ett formulär. Med fragmentreferensen kan du binda formulärfragmentet dynamiskt till ett formulär.

  • 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 du med 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.

Upprepa fragmentflik repeat-tab

Upprepa fragmentflik

  • Gör fragment repeterbara: En växlingsfunktion som gör att användarna kan aktivera eller inaktivera repeteringsfunktionen.
  • Minsta antal upprepningar: Fastställer det minsta antal gånger som fragmentkomponenten kan upprepas. Värdet noll anger att fragmentkomponenten inte upprepas. Standardvärdet är noll.
  • Maximalt antal upprepningar: Anger det maximala antal gånger som fragmentkomponenten kan upprepas. Som standard är det här värdet obegränsat.

Fliken Hjälpinnehåll help-content

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.

Tillgänglighet accessibility

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.

  • HTML roll som skärmläsaren kan meddela - Rollen HTML är ett attribut som används för att ange syftet med ett HTML-element för hjälpmedelstekniker som skärmläsare. Rollattributet används för att ge ytterligare kontext och semantisk innebörd till ett element, vilket gör det enklare för skärmläsare att tolka och meddela innehållet till användaren. I AEM Forms kan till exempel etiketten för ett formulärfält ha rollen"label", och inmatningsfältet kan ha rollen"texbox". Detta gör att skärmläsaren förstår förhållandet mellan etiketten och inmatningsfältet och kan meddela användaren dem på rätt sätt.

Designdialogruta design-dialog

Designdialogrutan används för att definiera och hantera CSS-format för formulärfragmentkomponenten.

Fliken Format styles-tab

Kärnkomponenten Adaptiv Form Fragment stöder AEM Formatsystem.

Designdialogruta

  • CSS-standardklasser: Du kan ange en standard-CSS-klass för kärnkomponenten Adaptiv formulärfragment.

  • 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: bold". Du kan använda eller tillämpa dessa format på ett adaptivt formulär i en anpassad Forms-redigerare. 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 listruta. Om du behöver uppdatera eller ändra formaten går du tillbaka till designdialogrutan, uppdaterar formaten på formatfliken och sparar ändringarna.

Anpassade egenskaper

Dialogrutan Anpassade egenskaper

Med anpassade egenskaper kan du associera anpassade attribut (nyckelvärdepar) till en huvudkomponent för adaptiva formulär med hjälp av formulärmallen. De anpassade egenskaperna återspeglas i egenskapsavsnittet i den headless-renderingen av komponenten. Det gör att du kan skapa dynamiskt formulärbeteende som anpassas baserat på anpassade attributvärden. Utvecklare kan till exempel utforma olika renderingar av en Headless Forms-komponent för mobiler, datorer eller webbplattformar, vilket avsevärt förbättrar användarupplevelsen på en mängd olika enheter.

  • Gruppnamn: Du kan ange ett namn som identifierar den anpassade egenskapsgruppen. Du kan lägga till, ta bort eller ordna om flera anpassade egenskapsgrupper. När du har lagt till den anpassade egenskapsgruppen kan du se följande alternativ:

    • Nyckelvärdepar: Du kan lägga till flera anpassade egenskapsnamn och anpassade egenskapsvärden genom att klicka på Lägg till för varje anpassad egenskapsgrupp.

    • Ta bort: Tryck eller klicka för att ta bort det anpassade egenskapsnamnet och det anpassade egenskapsvärdet.

    • Ordna om: Tryck eller klicka och dra för att ändra ordningen på det anpassade egenskapsnamnet och det anpassade egenskapsvärdet.

Relaterade artiklar related-articles

Se även see-also

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