Ce widget sert à représenter un champ de type String ou Integer. C’est la classe mère de la plupars des widgets représentant un champ
Hérite de WidgetBase.
Fonction
Rendu
Utilisation
En sachant que le vartype de la variable patient est string, le widget widgetField est automatiquement appliqué au noeud ‘value’ du form_row.
Ce composant est instancié directement pour représenter un champ de type “String” ou “Integer”. Cette classe sert très souvent de classe mère des sous-Widgets liés à un champ (intéraction avec l’utilisateur).
Le template basique de rendu est :
Dans le cas de l’utilisation d’options liées à Glyphicon ou FontAwesome le template de rendu est modifié pour utiliser le mécanisme des Input groups de Bootstrap :
La valeur de “maxlength” est déduite :
- Pour un String, de la taille (length) définie en base pour la colonne SQL (VARCHAR(20), VARCHAR(30))
- Pour un numérique (Integer ou Float), de la taille réelle de la valeur à afficher
Le contenu de l’attribut style
est une largeur (width
) en px
est calculé par rapport à au maxlength
.
Le contenu de {sPrefix}
et {sSuffix}
est injecté en fonction des options (glyphicon|fa)_(prefix|suffix)
(Voir ci-après). Le template Html injecté est :
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 WidgetBase pour vérifier si d’autres attributs sont disponibles.
dataset*
Indique quel DataSet (résultant d’un DataQuery) est lié au champ
-
Version : >=2.15
-
Valeurs possibles : String
field*
Champ du DataSet lié au Widget
-
Version : >=2.15
-
Valeurs possibles : String
mode
Indique si le champ est en lecture seule (mode=”ro”) ou en lecture/écriture (mode=”rw”)
-
Version : >=2.15
-
Valeurs possibles : ro,rw
-
Valeur par défaut : ro
placeholder
Est utilisé en tant que texte pas défaut dans un champ texte
-
Version : >=2.15
-
Valeurs possibles : String
size
Permet de forcer la valeur de l’attribut HTML “size” d’un champ texte
-
Version : >=2.15
-
Valeurs possibles : Integer
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 WidgetBase pour vérifier si d’autres options sont disponibles.
display_type
Détermine le type de rendu du champ (Type ‘text’, ou Type ‘mot de passe’)
-
Version : >=2.15
-
Valeurs possibles : text,password
-
Valeur par défaut : text
fa_prefix
Permet d’ajouter une icône au début du champ
-
Version : >=2.15
-
Valeurs possibles : Liste des icones disponibles : https://fontawesome.com/icons?from=io
fa_suffix
Permet d’ajouter une icône à la fin du champ
-
Version : >=2.15
-
Valeurs possibles : Liste des icones disponibles : https://fontawesome.com/icons?from=io
glyphicon_prefix
Permet d’ajouter une icône au début du champ
-
Version : >=2.15
-
Valeurs possibles : Liste des icones disponibles : https://getbootstrap.com/docs/3.3/components/
glyphicon_suffix
Permet d’ajouter une icône à la fin du champ
-
Version : >=2.15
-
Valeurs possibles : Liste des icones disponibles : https://getbootstrap.com/docs/3.3/components/
n_first_values
N premières valeurs de la liste sont randomisée. S’utilise conjointement avec l’option ‘bRandomOrder’
-
Version : >=2.15
-
Valeurs possibles : Integer
n_last_values
N dernières valeurs de la liste sont randomisée. S’utilise conjointement avec l’option ‘bRandomOrder’
-
Version : >=2.15
-
Valeurs possibles : Integer
on_key_up_refresh
Rafraichissement du champ à chaque touche tapée, au lieu d’attendre que l’utilisateur quitte le champ de saisie
-
Version : >=2.15
-
Valeurs possibles : Boolean
on_key_up_timeout
Lié à “bOnKeyUpRefresh”, délai avant prise en compte de l’appuie sur une touche. Une fois ce délai dépassé, si aucune touche n’a été tapée, le rafraichissement se fait
-
Version : >=2.15
-
Valeurs possibles : Integer
-
Valeur par défaut : 1000
random_order
Active la randomisation. N’est utilisé que par les champs de type ‘radiogroup’, ‘checkboxgroup’ et ‘select’
-
Version : >=2.15
-
Valeurs possibles : Boolean
show_errors
Affiche les erreurs
-
Version : >=2.15
-
Valeurs possibles : Boolean
-
Valeur par défaut : true
strtoupper
Passage en majuscule du contenu du champ
-
Version : >=2.15
-
Valeurs possibles : Boolean
text_prefix
Permet d’ajouter un texte au début du champ
-
Version : >=2.15
-
Valeurs possibles : String
text_suffix
Permet d’ajouter un texte à la fin du champ
-
Version : >=2.15
-
Valeurs possibles : String