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

Edit me

Hérite de WidgetBase.

Fonction

Rendu

Utilisation

<form_row>
  <label dataset="patient" field="nom" class="col-md-3 text-right"/>
  <value dataset="patient" field="nom" mode="rw" class="col-md-9 text-left"/>
</form_row>

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 :

	<div class="{sClass}">
	    <input type="{sDisplayType}" id="{idUnique}" name="{nomField}" value="{valeurField}" maxlength="{tailleMaximum}" style="{sStyle}" />
	</div>

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 :

	<div class="{sClass}">
	    <div class="input-group" style="width: 100%;">
	    {sPrefix}
	    <input type="{sDisplayType}" id="{idUnique}" name="{nomField}" value="{valeurField}" maxlength="{tailleMaximum}" style="{sStyle}" />
	    {sSuffix}
	</div>

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 :

	<span class="input-group-addon {sIconType} {sIconClass}"></span>

Attributs

dataset

Indique quel DataSet (résultant d’un DataQuery) est lié au champ

  • Version : >=2.15

  • Valeurs possibles : String

<... dataset="{dataset_value}" .../>

field

Champ du DataSet lié au Widget

  • Version : >=2.15

  • Valeurs possibles : String

<... field="{field_value}" .../>

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

<... mode="ro" .../>

placeholder

Est utilisé en tant que texte pas défaut dans un champ texte

  • Version : >=2.15

  • Valeurs possibles : String

<... placeholder="{placeholder_value}" .../>

size

Permet de forcer la valeur de l’attribut HTML “size” d’un champ texte

  • Version : >=2.15

  • Valeurs possibles : Integer

<... size="{size_value}" .../>

Options

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

<option output="html" option_name="display_type" value="text" />

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/

<option output="html" option_name="glyphicon_prefix" value="{glyphicon_prefix_value}" />

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/

<option output="html" option_name="glyphicon_suffix" value="{glyphicon_suffix_value}" />

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

<option output="html" option_name="fa_prefix" value="{fa_prefix_value}" />

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

<option output="html" option_name="fa_suffix" value="{fa_suffix_value}" />

text_prefix

Permet d’ajouter un texte au début du champ

  • Version : >=2.15

  • Valeurs possibles : String

<option output="html" option_name="text_prefix" value="{text_prefix_value}" />

text_suffix

Permet d’ajouter un texte à la fin du champ

  • Version : >=2.15

  • Valeurs possibles : String

<option output="html" option_name="text_suffix" value="{text_suffix_value}" />

show_errors

Affiche les erreurs

  • Version : >=2.15

  • Valeurs possibles : Boolean

  • Valeur par défaut : true

<option output="html" option_name="show_errors" value="true" />

strtoupper

Passage en majuscule du contenu du champ

  • Version : >=2.15

  • Valeurs possibles : Boolean

  • Valeur par défaut : false

<option output="html" option_name="strtoupper" value="false" />

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

  • Valeur par défaut : false

<option output="html" option_name="on_key_up_refresh" value="false" />

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

<option output="html" option_name="on_key_up_timeout" value="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

  • Valeur par défaut : false

<option output="html" option_name="random_order" value="false" />

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

  • Valeur par défaut : 0

<option output="html" option_name="n_first_values" value="0" />

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

  • Valeur par défaut : 0

<option output="html" option_name="n_last_values" value="0" />

Options groupées