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 natifUtiliser customClass
Layout (flex, grid)Classes Tailwind specifiques
Taille de policeGradients, animations
Couleurs de baseClasses utilitaires combinees

Regle : privilegier les proprietes CSS natives BWEB quand elles existent. Utiliser customClass pour tout le reste.

Conventions de nommage

ElementConventionExemple
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 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)