Skip to main content
View as Markdown

Champs numériques

Six types de champs stockent des nombres, des devises, des pourcentages, des notes et des indicateurs de progression. Tous partagent les propriétés de base des champs.

Type Stocke
integer Nombres entiers avec une plage min/max optionnelle.
decimal Décimaux à précision fixe (1–10 décimales).
currency Valeurs monétaires avec code ISO 4217 et mise en forme.
percentage Valeurs en pourcentage, affichées avec %.
rating Note en étoiles/icônes avec un maximum configurable.
progress Une barre de progression 0–100 avec couleur optionnelle.

integer

Nombres entiers sans décimales. Optimisé pour la performance.

Propriété Description
min Valeur minimale autorisée (incluse).
max Valeur maximale autorisée (incluse).
default Entier par défaut pour les nouveaux enregistrements.
- { id: 1, name: quantity, type: integer, required: true, min: 0, max: 1000, default: 1 }

decimal

Nombres avec décimales, stockés avec une précision DECIMAL exacte.

Propriété Description
precision Nombre de décimales. Entier de 1 à 10.
min Valeur minimale autorisée (incluse).
max Valeur maximale autorisée (incluse).
default Décimal par défaut pour les nouveaux enregistrements.
- { id: 2, name: weight, type: decimal, precision: 2, min: 0.01, max: 999.99, default: 1.0 }

currency

Valeurs monétaires avec une mise en forme d'affichage adaptée à la locale.

Propriété Description
currency Requis. Code ISO 4217 à trois lettres (par ex. USD, EUR, GBP, JPY).
precision Nombre de décimales. Entier de 0 à 10 (par défaut 2 pour la plupart des devises).
min Valeur minimale autorisée (incluse).
max Valeur maximale autorisée (incluse).
symbolPosition Placement du symbole monétaire : before ($100) ou after (100€).
negativeFormat Affichage des valeurs négatives : minus (-100) ou parentheses ((100)).
thousandsSeparator Caractère de groupement des milliers : comma, period, space ou none.
- id: 3
  name: price
  type: currency
  required: true
  currency: USD
  precision: 2
  symbolPosition: before
  negativeFormat: parentheses
  thousandsSeparator: comma

percentage

Valeurs en pourcentage (typiquement 0–100), affichées avec un symbole %.

Propriété Description
precision Nombre de décimales. Entier de 0 à 10 (par défaut 0).
min Valeur minimale autorisée (incluse, typiquement 0).
max Valeur maximale autorisée (incluse, typiquement 100).
default Pourcentage par défaut pour les nouveaux enregistrements.
- { id: 4, name: discount_rate, type: percentage, precision: 1, min: 0, max: 100, default: 10.0 }

rating

Une valeur de note rendue sous forme d'étoiles ou d'autres indicateurs.

Propriété Description
max Valeur de note maximale. Entier de 1 à 10 (par défaut 5).
style Style visuel de la note (par ex. stars).
default Valeur de note par défaut pour les nouveaux enregistrements.
- { id: 5, name: product_rating, type: rating, max: 5, style: stars }

progress

Affiche une valeur 0–100 sous forme de barre de progression. Utilisé pour suivre l'avancement vers un objectif.

Propriété Description
color Couleur de la barre de progression en hexadécimal sur 6 chiffres (par ex. #10B981).
default Valeur de progression par défaut (0–100) pour les nouveaux enregistrements.
- { id: 6, name: task_completion, type: progress, color: '#10B981', default: 0 }