Bonnes pratiques

Création de blocs

  • Toujours utiliser des blocs natifs BWEB (wrapper, text, button, listbox) plutot 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 natifUtiliser customClass
Layout (flex, grid)Classes Tailwind spécifiques
Taille de policeGradients, animations
Couleurs de baseClasses utilitaires combinees

Regle : privilegier les propriétés CSS natives BWEB quand elles existent. Utiliser customClass pour tout le reste.

Conventions de nommage

ÉlémentConventionExemple
WrapperwrapperNomSectionwrapperSupplierList
BoutonbtnActionbtnSaveSupplier
ChampfieldNomChampfieldSupplierName
ListboxlistboxNomlistboxSuppliers
TextetextDescriptiontextPageTitle

Duplication de blocs

Pour dupliquer des cartes ou sections, utiliser le mecanisme repeat/forEach sur un wrapper. Le wrapper parent contient un modèle de carte qui est repete pour chaque élément 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)