Bonnes pratiques
Création de blocs
- Toujours utiliser des blocs natifs BWEB (wrapper, text, button, listbox) plutôt que des blocs code
- Les propriétés objet (htmlProperties, objectProperties, etc.) doivent être {} jamais null
- Chaque bloc doit avoir un blockName unique et descriptif
CSS natif vs customClass
| Utiliser CSS natif | Utiliser customClass |
|---|---|
| Layout (flex, grid) | Classes Tailwind spécifiques |
| Taille de police | Gradients, animations |
| Couleurs de base | Classes utilitaires combinées |
Règle : privilégier les propriétés CSS natives BWEB quand elles existent. Utiliser customClass pour tout le reste.
Conventions de nommage
| Élément | Convention | Exemple |
|---|---|---|
| Wrapper | wrapperNomSection | wrapperSupplierList |
| Bouton | btnAction | btnSaveSupplier |
| Champ | fieldNomChamp | fieldSupplierName |
| Listbox | listboxNom | listboxSuppliers |
| Texte | textDescription | textPageTitle |
Duplication de blocs
Pour dupliquer des cartes ou sections, utiliser le mécanisme repeat/forEach sur un wrapper. Le wrapper parent contient un modèle de carte qui est répété pour chaque élément de la collection.
Structure HTML recommandée
Une page type suit cette structure :
wrapper (main container, max-w-7xl, mx-auto)
wrapper (page header, flex, justify-between)
text (titre)
button (action principale)
listbox (donnees)
wrapper (section detail, conditionalDisplay)

