Pulsante di scelta

Un pulsante di scelta in un modulo adattivo è un tipo di elemento di input che consente a un utente di selezionare una opzione da un gruppo di opzioni correlate. Il pulsante è rappresentato da un piccolo pulsante circolare pieno o vuoto per indicare se l’opzione è selezionata o meno. Quando l’utente seleziona un pulsante di scelta, gli altri nel gruppo si deselezionano. I pulsanti di scelta vengono generalmente utilizzati quando sono presenti più opzioni che si escludono reciprocamente, e se ne può selezionare uno solo alla volta.

Esempio

Finestra di dialogo Proprietà

In questo esempio, l’elemento Opzioni viene utilizzato per raggruppare i pulsanti di scelta. 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 del pulsante di scelta ha un valore dati univoco e un attributo Testo visualizzato. Se l’utente seleziona “1-10”, il valore dati corrispondente viene inviato al server quando viene inoltrato il 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, ogni pulsante di scelta 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

Esistono diversi motivi per utilizzare i pulsanti di scelta in un modulo, tra cui:

Scelte limitate: i pulsanti di scelta vengono utilizzati per fornire un elenco di opzioni predefinite tra le quali l’utente può scegliere, e una sola opzione alla volta può essere selezionata. Questa funzione è utile quando il numero di opzioni è limitato e le opzioni si escludono a vicenda.
Rappresentazione evidente: i pulsanti di scelta sono chiari e intuitivi, ciò rende più semplice per gli utenti sapere cosa stanno selezionando.
Coerenza: l’utilizzo dei pulsanti di scelta garantisce un modo uniforme e standardizzato di presentare le opzioni agli utenti, facilitando la comprensione e l’interazione con il modulo.
Più facili da usare: i pulsanti di scelta sono facili da usare, in particolare per gli utenti che non hanno familiarità con la tecnologia o che hanno una mobilità limitata.

Versione e compatibilità

Il componente core Pannello a soffietto moduli adattativi è stato rilasciato a febbraio 2023 come parte dei Componenti core 2.0.4 per Cloud Service e i 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 del componente	AEM as a Cloud Service	AEM Forms 6.5.16.0 o versioni successive
v1	Compatibile con versione 2.0.4 e successive	Compatibile con 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

Per informazioni aggiornate sul componente core del pulsante di scelta nei moduli adattivi, consulta la documentazione tecnica disponibile in GitHub. Per ulteriori informazioni sullo sviluppo dei componenti core, dai un’occhiata alla Documentazione per gli sviluppatori dei componenti core.

Finestra di dialogo per la configurazione

Puoi personalizzare facilmente l’esperienza del pulsante di scelta per i visitatori tramite la finestra di dialogo Configura. Puoi anche definire le opzioni dei pulsanti di scelta con facilità per un’esperienza utente fluida.

Scheda Base

Nome: è possibile identificare facilmente un componente modulo con il suo nome univoco sia nel modulo che nell’editor di regole, ma il nome non deve contenere spazi o caratteri 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.
Nascondi titolo: seleziona l’opzione per nascondere il titolo del componente.

Nella scheda Opzioni è possibile 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 un pulsante di scelta.
- Ridisponi: tocca o fai clic e trascina per riordinare le opzioni.
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.
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 stringa al Valore dati nella scheda Opzioni, nella schermata viene visualizzato il messaggio di errore Value type mismatch.
Opzioni predefinite: questa opzione consente di aggiungere valori predefiniti e preselezionati quando il modulo viene caricato. Se il tipo di dati del valore inviato è impostato su Number e si aggiungono dati stringa a Opzioni predefinite, nella schermata viene visualizzato il messaggio di errore Value type mismatch.
Opzioni visualizzate: questa opzione viene utilizzata per impostare l’allineamento visivo dei pulsanti di scelta in un modulo adattivo. Le due opzioni supportate sono:
- Orizzontale: quando è selezionata questa opzione, i pulsanti di scelta vengono visualizzati da sinistra a destra in un modulo adattivo.
- Verticale: quando è selezionata questa opzione, i pulsanti di scelta vengono visualizzati dall’alto verso il basso in un modulo adattivo.
Nascondi componente: seleziona l’opzione per nascondere il componente dal 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

Obbligatorio: seleziona questa opzione se desideri visualizzare il componente in un modulo adattivo. 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

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à

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.

Finestra di dialogo per la progettazione

La finestra di dialogo per la progettazione consente di definire e gestire gli stili CSS per il componente pulsante di scelta.

Scheda Stili

La scheda è utilizzata per definire e gestire gli stili CSS per un componente. Il componente core del pulsante di scelta nei moduli adattivi supporta il Sistema di stili di AEM.

Finestra di dialogo per la Progettazione di stili

Classi CSS predefinite: è possibile fornire una classe CSS predefinita per il componente core del pulsante di scelta nei moduli adattivi.
Stili consentiti: è possibile 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.

Pulsante di scelta

Utilizzo

Versione e compatibilità

Dettagli tecnici