Componente gruppo di caselle di controllo button-component-adaptive-forms-core-component
Un gruppo di caselle di controllo in un modulo adattivo è un insieme di caselle di controllo correlate che consentono agli utenti di selezionare una o più opzioni da un elenco. Ciascuna casella di controllo è rappresentata da un valore dati (valore utilizzato per elaborare gli elementi di un gruppo di caselle di controllo) e dal valore visualizzato (etichetta per ogni elemento della casella di controllo che ne descrive lo scopo)Esempio
Finestra di dialogo Proprietà
In questo esempio, l’elemento Opzioni viene utilizzato per raggruppare le caselle di controllo. L’elemento Testo visualizzato viene utilizzato per fornire un’etichetta per un elemento e Valore dati viene utilizzato per specificare il valore inoltrato al server al momento dell’invio del modulo.
Ogni opzione/elemento della casella di controllo ha un valore dati univoco e un attributo Testo visualizzato. Se l’utente seleziona le caselle di controllo “Figlio” e “Figlia”, il valore dati corrispondente viene inviato al server al momento dell’invio del modulo. Questi dati possono quindi essere elaborati da uno script lato server per determinare quali opzioni sono state selezionate dall’utente e possono essere utilizzate per eseguire varie azioni, ad esempio l’aggiornamento di altri campi del modulo o l’invio dei dati del modulo a uno script lato server per un’ulteriore elaborazione.
Inoltre, il gruppo di caselle di controllo può essere configurato in modo da avere valori di elaborazione diversi per ciascuna opzione, e questo può essere impostato utilizzando l’editor di regole dei moduli adattivi.
Utilizzo reasons-to-use-check-box-group
Ci sono diversi motivi per cui è utile includere un gruppo di caselle di controllo in un modulo adattivo, tra cui:
-
Selezioni multiple: un gruppo di caselle di controllo consente agli utenti di selezionare più opzioni da un elenco, il che può essere utile in situazioni in cui sono consentite o richieste selezioni multiple.
-
Esperienza utente: un gruppo di caselle di controllo può essere utilizzato per rendere il modulo più semplice da usare, poiché fornisce agli utenti un modo chiaro e intuitivo per selezionare più opzioni.
-
Analisi dei dati: un gruppo di caselle di controllo può essere utilizzato per raccogliere dati di origine diversa e analizzarli o utilizzarli come input per un’ulteriore elaborazione.
-
Sondaggi: un gruppo caselle di controllo può essere utilizzato nei sondaggi per selezionare più opzioni per una domanda.
-
Preferenze utente: un gruppo di caselle di controllo può essere utilizzato per registrare le preferenze dell’utente tra diverse opzioni.
-
Valore dati: un gruppo di caselle di controllo può essere utilizzato anche per elaborare gli elementi di un gruppo di caselle di controllo.
Versione e compatibilità version-and-compatibility
Il componente core Gruppo di caselle di selezione per moduli adattivi è stato rilasciato a febbraio 2023 come parte dei Componenti core 2.0.4 per Cloud Service e dei Componenti core 1.1.12 per AEM Forms 6.5.16.0 o versioni successive. Di seguito è riportata una tabella che mostra tutte le versioni supportate, la compatibilità AEM e i collegamenti alla documentazione corrispondente:
versione 2.0.4 e successive
versione 1.1.12 e successive, ma precedenti a 2.0.0.
Per informazioni sulle versioni dei componenti core, consulta il documento Versioni dei componenti core.
Dettagli tecnici technical-details
Puoi trovare le informazioni più recenti sul componente core di un gruppo di caselle di controllo nei moduli adattivi nella documentazione tecnica su GitHub. Per ulteriori informazioni sullo sviluppo dei componenti core, consulta la Documentazione per gli sviluppatori di componenti core.
Finestra di dialogo per la configurazione configure-dialog
Puoi personalizzare facilmente la tua esperienza con le caselle di controllo per i visitatori tramite la finestra di dialogo Configura. Puoi anche definire le opzioni delle caselle di controllo con facilità per un’esperienza utente ottimale.
Scheda Base basic-tab
-
Nome: il nome identifica in modo univoco il componente nell’editor delle regole. Le stringhe di nome non consentono l’uso di caratteri e spazi speciali.
-
Titolo : con il relativo titolo è possibile identificare facilmente un componente in un modulo e, per impostazione predefinita, il titolo viene visualizzato sopra il componente. Se non aggiungi un titolo, al posto del testo del titolo viene visualizzato il nome del componente.
-
Consenti testo formattato per titolo: questa funzione permette agli utenti di formattare i titoli in testo normale, incorporando opzioni come il grassetto, il corsivo, il testo sottolineato, vari font, dimensioni dei font, colori e altre opzioni per migliorare la presentazione visiva e la personalizzazione. Offre maggiore flessibilità e controllo creativo nel far risaltare i titoli all’interno di documenti, siti web o applicazioni.
Dopo aver selezionato la casella di controllo per Consenti formato RTF per il titolo, le opzioni di formattazione diventano visibili per applicare lo stile al titolo del componente. Per accedere a tutte le opzioni di formattazione disponibili, puoi fare clic sulla schedaFullscreen
. -
Nascondi titolo: seleziona l’opzione per nascondere il titolo del componente.
-
Opzioni: puoi aggiungere valori dati e visualizzare coppie di testo utilizzando il pulsante Aggiungi.
Una volta aggiunta una nuova opzione, è possibile eseguire le azioni seguenti:- Valore Dati: questa opzione consente di immettere il contenuto da inviare quando viene selezionata un’opzione.
- Testo visualizzato: questa opzione consente di inserire il contenuto da visualizzare in un modulo adattivo.
- Elimina: tocca o fai clic per eliminare l’opzione di una casella di controllo.
- Ridisponi: tocca o fai clic e trascina per modificare l’ordine dei pannelli.
È inoltre possibile formattare le opzioni per il gruppo di caselle di controllo utilizzando Consenti formato RTF per le opzioni.
Dopo aver selezionato la casella di controllo per Consenti testo formattato per opzioni, le opzioni di formattazione diventano visibili per applicare lo stile alle opzioni del componente. Per accedere a tutte le opzioni di formattazione disponibili, puoi fare clic sulla scheda
Fullscreen
.
-
Riferimento di binding: un riferimento di binding è un riferimento a un elemento dati memorizzato in un’origine dati esterna e utilizzato in un modulo. Il riferimento di binding consente di eseguire un binding dinamico dei dati ai campi del modulo, in modo che il modulo possa visualizzare i dati più aggiornati dell’origine dati. Ad esempio, è possibile utilizzare un riferimento di binding per visualizzare il nome e l’indirizzo di un cliente in un modulo, in base all’ID cliente immesso nel modulo. È inoltre possibile utilizzare il riferimento di binding per aggiornare l’origine dati con i dati immessi nel modulo. In questo modo, AEM Forms consente di creare moduli che interagiscono con origini dati esterne, fornendo un’esperienza utente fluida per la raccolta e la gestione dei dati.
-
Contrassegna come elemento modulo non associato: seleziona l’opzione per configurare un campo modulo non collegato ad alcun schema. Questa opzione consente di salvare i dati senza aggiornare l’origine dati. Consente inoltre di gestire i dati in modo personalizzato, separato dall’integrazione standard del database.
-
Tipo di dati del valore inviato - questa opzione specifica il tipo di dati del valore inviato quando viene selezionata un’opzione. Se il tipo di dati del valore inviato è impostato su
Number
e si aggiungono dati della stringa a Valore dati nella scheda Opzioni, nella schermata viene visualizzato un messaggio di erroreValue type mismatch
. -
Opzioni visualizzate: questa opzione viene utilizzata per impostare l’allineamento visivo delle caselle di controllo in un modulo adattivo. Le due opzioni supportate sono:
- Orizzontale: quando questa opzione è selezionata, le caselle di controllo vengono visualizzate da sinistra a destra in un modulo adattivo.
- Verticale: quando questa opzione è selezionata, le caselle di controllo vengono visualizzate dall’alto verso il basso in un modulo adattivo.
-
Opzioni predefinite: questa opzione consente di aggiungere valori predefiniti preselezionati al caricamento del modulo. Utilizza l’icona Elimina per rimuovere le opzioni aggiunte. Se il tipo di dati del valore inviato è impostato su
Number
e aggiungi una stringa di dati a Opzioni predefinite, la schermata mostra un messaggio di erroreValue type mismatch
. -
Nascondi componente: seleziona questa opzione per nascondere il componente del modulo. Il componente rimane accessibile per altri scopi, ad esempio per i calcoli nell’editor di regole. Questa funzione è utile quando devi memorizzare informazioni che non devono essere viste o modificate direttamente dall’utente.
-
Disattiva componente: seleziona questa opzione per disabilitare il componente. Il componente disabilitato non è attivo o modificabile dall’utente finale. L’utente può visualizzare il valore del campo, ma non può modificarlo. Il componente rimane accessibile per altri scopi, ad esempio per i calcoli nell’editor di regole.
-
Sola lettura: seleziona questa opzione per rendere il componente non modificabile. L’utente può visualizzare il valore del campo, ma non può modificarlo. Il componente rimane accessibile per altri scopi, ad esempio per i calcoli nell’editor di regole.
Scheda Convalida validation-tab
-
Obbligatorio: seleziona questa opzione se desideri visualizzare il componente in un modulo adattivo. Dopo aver selezionato l’opzione, è necessario effettuare una selezione prima di procedere con l’invio di un modulo. Non è possibile selezionare Nascondi componente o Disattiva componente nella scheda Base quando questa opzione è selezionata.
-
Messaggio di errore: questa opzione consente di inserire un messaggio visualizzato se la casella di controllo Obbligatorio è selezionata e il campo modulo viene lasciato vuoto.
-
Messaggio di convalida script: questa opzione consente di inserire un messaggio da visualizzare in caso di mancata convalida dello script.
Scheda Contenuto Guida helpcontent-tab
-
Breve descrizione: una breve descrizione è una breve spiegazione testuale che fornisce informazioni aggiuntive o chiarimenti sullo scopo di un campo modulo specifico. Aiuta l’utente a capire quale tipo di dati deve essere immesso nel campo e può fornire linee guida o esempi per garantire che le informazioni immesse siano valide e soddisfino i criteri desiderati. Per impostazione predefinita, le descrizioni brevi rimangono nascoste. Abilita l’opzione Mostra sempre una breve descrizione per visualizzarla sotto il componente.
-
Mostra sempre una breve descrizione: abilita l’opzione per visualizzare la descrizione breve sotto il componente.
-
Testo guida: il testo guida si riferisce a informazioni o indicazioni aggiuntive fornite all’utente per aiutarlo a compilare correttamente un campo del modulo. Viene visualizzato quando l’utente fa clic sull’icona dell’aiuto (i) posta vicino al componente. Il testo guida fornisce informazioni più dettagliate rispetto all’etichetta o al testo segnaposto di un campo del modulo ed è progettato per consentire all’utente di comprendere i requisiti o i vincoli del campo. Può inoltre offrire suggerimenti o esempi per rendere più semplice e precisa la compilazione del modulo.
Scheda Accessibilità accessibility-tab
-
Testo per utilità per la lettura dello schermo: il testo per le utilità per la lettura dello schermo si riferisce al testo aggiuntivo destinato specificamente ad essere letto da tecnologie di assistenza, come le utilità per la lettura dello schermo, utilizzate da persone ipovedenti. Questo testo fornisce una descrizione audio dello scopo del campo modulo e può includere informazioni sul titolo, la descrizione, il nome del campo ed eventuali messaggi rilevanti (testo personalizzato). Il testo dell’assistente vocale consente di garantire l’accesso al modulo da parte di qualsiasi utente, comprese le persone ipovedenti, consentendo di comprendere appieno il campo del modulo e i relativi requisiti.
- Testo personalizzato: seleziona questa opzione per utilizzare il testo personalizzato per le etichette di accessibilità ARIA. Selezionando questa opzione, viene visualizzata la finestra di dialogo Testo personalizzato. Puoi aggiungere informazioni rilevanti nella finestra di dialogo Testo personalizzato.
- Descrizione: seleziona questa opzione per utilizzare la descrizione per le etichette di accessibilità ARIA.
- Titolo: seleziona questa opzione per utilizzare il titolo per le etichette di accessibilità ARIA.
- Nome: seleziona questa opzione per utilizzare il nome per le etichette di accessibilità ARIA.
- Nessuno: seleziona questa opzione in caso tu non voglia aggiungere etichette di accessibilità ARIA.
Finestra di dialogo per la progettazione design-dialog
La finestra di dialogo per la progettazione si usa per definire e gestire gli stili CSS per il componente Gruppo di caselle di selezione.
Scheda Stili styles-tab
Il componente core Gruppo di caselle di controllo dei moduli adattivi supporta il sistema di stili AEM.
-
Classi CSS predefinite: puoi fornire una classe CSS predefinita per il componente core del gruppo di caselle di selezione dei moduli adattivi.
-
Stili consentiti: puoi definire gli stili fornendo un nome e la classe CSS che rappresenta lo stile. Ad esempio, puoi creare uno stile denominato “testo in grassetto” e fornire la classe CSS “spessore carattere: grassetto”. Puoi utilizzare o applicare questi stili a un modulo adattivo nell’editor di moduli adattivi. Per applicare uno stile, nell’editor dei moduli adattivi, seleziona il componente a cui applicare lo stile, passa alla finestra di dialogo delle proprietà e seleziona lo stile desiderato dall’elenco a discesa Stili. Per aggiornare o modificare gli stili, è sufficiente tornare alla finestra di dialogo per la progettazione, aggiornare gli stili nella scheda Stili e salvare le modifiche.
Proprietà personalizzate
Le proprietà personalizzate consentono di associare attributi personalizzati (coppie chiave-valore) a un componente core del modulo adattivo utilizzando il modello di modulo. Le proprietà personalizzate vengono riflesse nella sezione delle proprietà della rappresentazione headless del componente. Consentono di creare un comportamento di modulo dinamico che si adatta in base ai valori degli attributi personalizzati. Ad esempio, gli sviluppatori possono progettare diverse rappresentazioni di un componente moduli headless su piattaforme mobili, desktop o web, migliorando in modo significativo l’esperienza utente su un’ampia gamma di dispositivi.
-
Nome gruppo: puoi fornire un nome per identificare il gruppo di proprietà personalizzate. È possibile aggiungere, eliminare o ridisporre più gruppi di proprietà personalizzate. Dopo aver aggiunto il gruppo di proprietà personalizzate, puoi visualizzare le seguenti opzioni:
-
Coppie chiave-valore: puoi aggiungere più nomi e valori della proprietà personalizzata facendo clic sul pulsante Aggiungi per ogni gruppo di proprietà personalizzate.
-
Elimina: tocca o fai clic per eliminare il nome e il valore della proprietà personalizzata.
-
Ridisponi: tocca o fai clic e trascina per ridisporre l’ordine del nome e del valore della proprietà personalizzata.
-
Articoli correlati related-articles
)
Consulta anche see-also
- Creare un modulo adattivo AEM
- Aggiungere un modulo adattivo AEM a una pagina AEM Sites
- Applicare i temi a un modulo adattivo AEM
- Aggiungere componenti a un modulo adattivo di AEM
- Utilizzare reCAPTCHA in un modulo adattivo AEM
- Generare la versione PDF (DoR) di un modulo adattivo AEM
- Tradurre un modulo adattivo AEM
- Abilitare Adobe Analytics per il monitoraggio dell’utilizzo dei moduli con un modulo adattivo
- Collegare un modulo adattivo a Microsoft SharePoint
- Collegare un modulo adattivo a Microsoft Power Automate
- Collegare un modulo adattivo a Microsoft OneDrive
- Collegare un modulo adattivo all’archiviazione BLOB di Microsoft Azure
- Collegare un modulo adattivo a Salesforce
- Utilizzare Adobe Sign in un modulo adattivo di AEM
- Aggiungere una nuova lingua per un modulo adattivo
- Inviare dati del modulo adattivo a un database
- Inviare dati del modulo adattivo a un endpoint REST
- Inviare dati del modulo adattivo al flusso di lavoro di AEM
- Usare il portale dei moduli per elencare moduli adattivi di AEM su un sito web di AEM