TextInput
sioux_textinput.js
exemple_form.html#textinput
L'objet TextInput est un champ de saisie mono-ligne, pouvant être de type caractère, décimal, entier, mot de passe, date, etc. C'est l'objet le plus utilisé dans un formulaire.
textinput
jsLabelWidth
Largeur du label (en pixels).
int
100
jsWidth
Largeur du champ de saisie (en pixels).
int
100
jsDataType
Type de données : char (ou string), password, date, heure, int (ou integer), dec (ou decimal ou float).
string
char
jsMaxLength
Longueur maximale du contenu, en nombre de caractères.
int ou -1 (pas de limite)
-1
jsHelpURL
Adresse d'aide pour le champ, qui s'ouvre dans une nouvelle fenêtre sur F1 ou sur click du bouton d'aide associé..
url
jsHelpButton
Indique si à côté du champ doit figurer un bouton d'aide.
boolean
false
jsHelpText
Texte s'affichant dans la barre de statut lorsque l'objet est sélectionné.
string
jsClassName
Permet de spécifier une autre classe de style (CSS) que la classe par défaut.
string
jsLabelPosition
Position du label par rapport au champ.
right ou left
left
jsVisible
Etat du champ (visible ou non).
boolean
true
jsSensitive
Etat du champ (actif ou inactif).
boolean
true
jsViewAsText
Affiche le champ comme une étiquette (inactif et sans bordure).
boolean
false
jsFormat
Définit un format d'affichage pour tout type de données autre que "string". Pour plus de détails sur cette fonction partagée par d'autres objets Sioux, voir l'objet "Format".
string
jsQueryHelp
Nom d'un objet Query associé au formulaire. Lorsque jsQueryHelp est défini, c'est le résultat de cette requête qui s'affiche sur F1 (ou bouton d'aide) à la place de l'URL qui aurait éventuellement été définie avec jsHelpURL. Cet attribut sert généralement à proposer une liste de choix pour renseigner un champ. Pour plus de détails sur cette fonctionnalité de Sioux, voir l'objet "Query".
string
jsQueryCheck
Nom d'un objet Query associé au formulaire. Lorsque jsQueryCheck est défini, la requête est lancée à la sortie du champ pour vérifier que sa valeur est correcte. Pour plus de détails sur cette fonctionnalité de Sioux, voir l'objet "Query".
string
jsMandatory
Indique si le champ est obligatoire. Si le champ est obligatoire et que sa valeur est nulle ou vide, la méthode checkMandatory() du formulaire affiche un message d'erreur.
boolean
false
jsValue
Valeur initiale du champ de saisie.
string
jsQueryHelpReturn
Nom d'une fonction utilisateur (javascript) permettant de récupérer le choix effectué par l'utilisateur par jsQueryHelp.
string
jsLabelClassName
Classe du label. Permet de spécifier une autre classe de style (CSS) que la classe par défaut.
string
jsSubmit
Si jsSubmit vaut true, appuyer sur la touche entrée valide le formulaire.
boolean
false
jsName
Nom unique dans le formulaire associé.
string
jsLabel
Texte du label.
string
setValue
valeur
Assigne une valeur au champ.
Si un type de données a été spécifié (jsDataType), la valeur passée doit être du type spécifié.
getValue
Retourne la valeur du champ.
Si un type de données (jsDataType) a été spécifié, la valeur retournée est du type spécifié.
disable
Désactive le champ.
enable
Active le champ.
show
Rend le champ visible.
hide
Rend le champ invisible.