Bonnes pratiques
Creation de blocs
- Toujours utiliser des blocs natifs BWEB (wrapper, text, button, listbox) plutot que des blocs code
- Les proprietes objet (htmlProperties, objectProperties, etc.) doivent etre {} 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 specifiques |
| Taille de police | Gradients, animations |
| Couleurs de base | Classes utilitaires combinees |
Regle : privilegier les proprietes CSS natives BWEB quand elles existent. Utiliser customClass pour tout le reste.
Conventions de nommage
| Element | 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 mecanisme repeat/forEach sur un wrapper. Le wrapper parent contient un modele de carte qui est repete pour chaque element de la collection.
Structure HTML recommandee
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)

