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
Corrigé par rapport aux docs antérieures. currency utilise thousandsSeparator — une énumération (comma | period | space | none), et non un booléen. negativeFormat accepte minus ou parentheses (il n'y a pas d'option red), et precision varie de 0 à 10.
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 }
Corrigé par rapport aux docs antérieures. Le champ rating utilise max et style — et non ratingMax / ratingStyle.
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 }
Corrigé par rapport aux docs antérieures. Le champ progress utilise color (une chaîne hexadécimale) — et non progressColor.