Skip to main content

Widget Number

AperçuLien direct vers Aperçu

La tuile Number de la palette (groupe Formulaire) ajoute un champ numérique. C'est le widget Input avec son Type déjà réglé sur Number ; l'en-tête du panneau de configuration affiche le badge Number. Réglez Type sur String et le même widget devient un champ de texte.

Un widget Number sélectionné dans le builder, avec Min, Max, Step et Prec dans la carte Global.
Un widget Number sélectionné dans le builder, avec Min, Max, Step et Prec dans la carte Global.

ConfigurationLien direct vers Configuration

La carte Global regroupe les réglages du widget :

RéglageDescription
NameLibellé du champ.
Variable/ModelVariable de la page qui contient la valeur.
TypeNumber pour cette tuile. String transforme le widget en champ de texte.
Min, MaxLimites de la valeur. Vide : pas de limite.
StepQuantité ajoutée ou retirée par les flèches du champ. Par défaut : 1.
PrecSans effet sur la page (voir plus bas).
Default ValueValeur initiale : un nombre (12, 2.5), une variable ({{budget}}) ou une formule (={{budget}}*2). Une variable ou une formule est recalculée quand ses variables changent. Une valeur qui n'est pas un nombre est ignorée et le champ démarre vide. Voir Valeurs par Défaut Dynamiques.
On ChangeAction exécutée quand l'utilisateur change la valeur.

Les cartes Validation, Rules et Style sont celles du widget Input : voir Validation et Règles et Options de Style.

Comportement sur la pageLien direct vers Comportement sur la page

  • Saisie : Chrome et Edge ignorent les lettres tapées dans le champ, sauf e (notation scientifique : 12e3 devient 12000 quand l'utilisateur quitte le champ).
  • Min et Max s'appliquent quand l'utilisateur quitte le champ : avec Max à 100, un 150 saisi devient 100.
  • Step ne pilote que les flèches. Une valeur saisie reste telle quelle : avec Step à 5, 7 reste 7.
  • Prec n'est pas appliqué : avec Prec à 2, 3.14159 reste 3.14159. Pour fixer le nombre de décimales, utilisez le réglage Precision du widget Currency.
  • Nombre ou texte : la variable contient un nombre une fois que l'utilisateur a quitté le champ. Avant cela elle contient du texte, et On Change reçoit aussi du texte (SF_input.value vaut '12') : utilisez Number(SF_input.value) pour calculer avec.
  • Champ vide : la variable est vide (null) tant que l'utilisateur n'a pas touché au champ. Quand l'utilisateur quitte un champ vide, la valeur devient 0. Un champ que l'utilisateur a vidé prend la valeur de Min quand Min est supérieur à 0.
Required et la valeur 0

Un champ Number Required est accepté dès que l'utilisateur a cliqué dedans puis l'a quitté, car sa valeur est alors 0. Pour refuser cette valeur, ajoutez une règle Custom dans la carte Rules, avec la valeur SF_input > 0 et un message.

Widgets associésLien direct vers Widgets associés

  • Input : le même widget, avec ses options de texte.
  • Currency : les montants, avec une devise et un nombre de décimales.