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

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

<... 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

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

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

<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}" />

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}" />

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

<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

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

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

<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

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

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

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

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}" />