Ce composant sert pour l’affichage des champs de type dictionnaire (fkey_dico).
Hérite de WidgetField.
Fonction
Rendu
Utilisation
Utilisation classique avec un dictionnaire
Sur Epicraft, ajouter un champ de type “choix simple” au formulaire et sélectionner le dictionnaire à utiliser.
Par défaut, une variable de type fkey_dico est affichée avec des boutons radio. Voir aussi le widget Select.
Utilisation avec un dataset de type référentiel (résultant d’un dataquery)
Par dataset de référentiel, on entend un varset contenant des valeurs ayant pour but d’être utilisées comme un dictionnaire. Par exemple : un référentiel des pays du monde pour que les utilisateurs puissent sélectionner leur pays de naissance.
1 - Ajout d’une variable au varset cible
Dans Epicraft, au lieu d’ajouter un champ de type dico pour afficher votre variable de type choix, ajouter un champ de type “nombre” (integer).
Il faudra veiller à documenter quelque part le mapping entre la valeur de ce champ et la table contenant le référentiel pour se rappeler d’où elle provient car le lien ne se fera plus “tout seul”.
2 - Ajout d’une source de données au formulaire cible
Ajouter une source de données de type “Varset” sans référence au contexte. Sélectionner le varset de référentiel. La table de varset servant de référentiel doit imiter un dictionnaire.
3 - Modification du champ pour utiliser un WidgetRadioGroup
Forcer l’utilisation du WidgetRadioGroup pour l’affichage du champ de type nombre ajouté préalablement en et préciser le dataset à utiliser en ajoutant 2 propriétés personnalisées de type form.widget.value.option
(voir options ci-dessous) sur le champ.
Utilisation avec un dataset “en dur”
Ce dispositif n’a d’intérêt que pour récupérer une valeur qui servira à un traitement côté serveur car ni le dataset cible, ni le dataset de dictionnaire ne proviennent d’un dataquery.
1 - Ajout de la source de données cible au formulaire
Ajouter une source de données de type “Libre” contenant le dataset cible.
2 - Ajout de la source de données contenant le dictionnaire
Ajouter une source de données de type “Libre”. Le dataset doit “imiter” un dataset de dictionnaire.
3 - Modification du champ pour utiliser un WidgetRadioGroup
Forcer l’utilisation du WidgetRadioGroup pour l’affichage du champ de type nombre ajouté préalablement (option “widget”) et préciser le dataset à utiliser (option “dataset”).
Attributs
Les attributs nécessaires au bon fonctionnement du widget sont signalés par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetField pour vérifier si d’autres attributs sont disponibles.
Options
Les options nécessaires au bon fonctionnement du widget sont signalées par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetField pour vérifier si d’autres options sont disponibles.
columns_count
Affiche les boutons radio en colonnes. Les valeurs possibles vont de 2 à 12.
-
Version : >=2.15
-
Valeurs possibles : Integer
-
Valeur par défaut : 1
columns_offset
Offset des boutons radio
-
Version : >=2.15
-
Valeurs possibles : Integer
dataset
Permet d’utiliser un dataset plutôt qu’un dictionnaire. Le dataset en question doit être similaire à un dataset de dictionnaire.
-
Version : >=2.26
-
Valeurs possibles : string
hide_label
Permet de masquer le label des boutons radio
-
Version : >=2.15
-
Valeurs possibles : Boolean
inline
Permet de passer l’affichage en mode inline
-
Version : >=2.15
-
Valeurs possibles : Boolean
show_archived
Permet d’afficher les valeurs archivées
-
Version : >=2.15
-
Valeurs possibles : Boolean