ldc-bien-etre-animal/resources/ts/front/components.md
2026-08-28 10:40:04 +02:00

25 KiB
Raw Permalink Blame History

Documentation des composants

Pour plus de détails je vous invite à regarder le code de chaque composant Pour les fonts et les style (app.scss) Les utilisations de ces composant sont dans la page Home et la page Default

Arborescence

├── Articles
│   ├── ArticleCard.tsx
│   └── ArticlesCarousel.tsx
├── Communities
│   └── CommunitiesCarousel.tsx
├── Engagements
│   ├── EngagementCard.tsx
│   ├── EngagementsSection.tsx
│   └── PhotoCarousel.tsx
├── Filters
│   ├── FilterSection.tsx
│   ├── FilterTag.tsx
│   ├── MobileFilterPanel.tsx
│   └── Select.tsx
├── Footer
│   ├── Footer.tsx
│   └── FooterEleveurs.tsx
├── Form
│   ├── Checkbox.tsx
│   ├── ContactForm.tsx
│   ├── FileInput.tsx
│   ├── FormSelect.tsx
│   ├── SuccessModel.tsx
│   ├── TextArea.tsx
│   └── TextInput.tsx
├── Guarantees
│   ├── GuaranteeCard.tsx
│   └── GuaranteesCarousel.tsx
├── Header
│   ├── Header.tsx
│   ├── HeroVideo.tsx
│   ├── LanguageSwitcher.tsx
│   ├── MenuButton.tsx
│   ├── MenuContent.tsx
│   └── MenuOverlay.tsx
├── Layout
│   ├── ClippedPanel.tsx
│   ├── CtaButton.tsx
│   ├── Heading.tsx
│   ├── IconCircleButton.tsx
│   ├── Logo.tsx
│   ├── ScrollToTop.tsx
│   └── SearchBar.tsx
├── Shared
│   ├── Accordion.tsx
│   ├── Carousel.tsx
│   ├── CarouselControls.tsx
│   ├── ContentPanel.tsx
│   ├── CurvedImageCard.tsx
│   ├── ImageCard.tsx
│   ├── ImageCarousel.tsx
│   ├── PhotoCard.tsx
│   └── SliderCustomCard.tsx
├── Stats
│   ├── StatCard.tsx
│   └── StatsCarousel.tsx
├── Testimonials
│   ├── TestimonialCard.tsx
│   └── TestimonialsSection.tsx

Engagements

EngagementCard

Deux rendus distincts selon variant : mobile (photo + badge + titre/accordéon avec line-clamp-3) ou desktop (texte à gauche, photo+badge à droite via CurvedImageCard).

// Desktop
<EngagementCard variant="desktop" image={photo} badge={badge} title="..." rotation={-2}>
  <p>Texte...</p>
</EngagementCard>

// Mobile (via EngagementsSection généralement)
<EngagementCard variant="mobile" image={photo} badge={badge} title="...">
  <p>Texte complet, tronqué à 3 lignes tant que fermé.</p>
</EngagementCard>

À savoir :

  • variant n'est pas auto-détecté (pas de useDeviceType interne) — à fournir explicitement par le parent (EngagementsSection).
  • Mode mobile : children tronqué visuellement via WebkitLineClamp: 3 (style inline, pas la classe Tailwind line-clamp-3 — plus fiable selon config Tailwind), affiché en entier au clic sur le chevron.
  • Mode desktop : layout justify-between centré, max-w-[1202px], texte limité à max-w-[650px].

PhotoCarousel

Carrousel scrollable de PhotoCard, taille active/inactive différente en desktop, taille unique en mobile/tablette.

Prop Type Défaut
items {image, imageWebp?, caption?, rotation?}[] requis
gap string 'gap-8'
activeSize {width, height} {680, 484}
inactiveSize {width, height} {600, 430}
mobileSize {width, height} {220, 220}
<PhotoCarousel
  items={[{ image: photo1, rotation: -2 }, { image: photo2 }]}
  activeSize={{ width: 680, height: 484 }}
  inactiveSize={{ width: 600, height: 430 }}
/>

EngagementsSection

Bascule Carousel (mobile, une carte à la fois) / liste empilée verticale (desktop, toutes visibles). Centralise la détection isMobile, transmet variant explicite à chaque EngagementCard.

Prop Type Défaut
engagements {image, imageWebp?, badge, title, content, rotation?, reverse?}[] requis
<EngagementsSection
  engagements={[
    { image: photo1, badge: badge1, title: '...', rotation: -2, content: <p>...</p> },
    { image: photo2, badge: badge2, title: '...', rotation: 2, reverse: true, content: <p>...</p> },
  ]}
/>

Filters

FilterTag

Pilule outline rouge avec croix, pour retirer un filtre actif.

Prop Type Défaut
label string requis
onRemove () => void requis
<FilterTag label="5 garanties" onRemove={() => setSelected('')} />

Select

Dropdown custom (pas de <select> natif) : bouton pilule + liste multi-colonnes en absolute. Ferme au clic extérieur.

<Select options={thematicOptions} value={selected} onChange={setSelected} placeholder="Thématiques" columns={2} />

MobileFilterPanel

Bottom sheet mobile (glisse depuis le bas, via createPortal), sections en Accordion contrôlé (un seul ouvert), boutons Appliquer/Effacer fixes en bas.

Prop Type Défaut
isOpen boolean requis
onClose () => void requis
sections {title, options, selected, onSelect, columns?}[] requis
onApply () => void requis
onClear () => void requis
height string 'h-[684px]' — hauteur fixe, contenu scrollable en interne
<MobileFilterPanel
  isOpen={isMobilePanelOpen}
  onClose={() => setIsMobilePanelOpen(false)}
  sections={[
    { title: 'Thématiques', options, selected, onSelect: handleSelect, columns: 1 },
    { title: 'Mois', options: monthOptions, selected: selectedMonth, onSelect: setSelectedMonth, columns: 2 },
  ]}
  onApply={() => setIsMobilePanelOpen(false)}
  onClear={handleClear}
/>

À savoir :

  • createPortal(..., document.body) indispensable : sans lui, si utilisé à l'intérieur d'un composant avec filter/transform actif (ex: ContentPanel, cartes avec rotation), le panneau se positionne mal (bug CSS connu : filter/transform sur un ancêtre redéfinit le référentiel de position: fixed).
  • height fixe garantit que l'ouverture d'un Accordion ne fait jamais grandir/rétrécir le panneau — seul le contenu interne scrolle.
  • Nécessite la keyframe animate-slide-up définie dans app.css.

FilterSection

Assemble le tout : bascule bouton "Filtrer" + MobileFilterPanel (mobile) / deux Select côte à côte (desktop) + tags actifs.

Prop Type Défaut
options {label, value}[] requis — thématiques
monthOptions {label, value}[] []
onFilterChange (value: string) => void — appelé au changement de thématique uniquement
<FilterSection
  options={[{ label: '5 garanties', value: 'garanties' }]}
  monthOptions={[{ label: 'Janvier', value: 'janvier' }]}
  onFilterChange={(value) => console.log(value)}
/>

À savoir :

  • onFilterChange n'est déclenché que par le filtre "thématiques" — pas de callback dédié pour le mois (à ajouter si besoin).
  • Le mode desktop n'a pas de bouton "Effacer la sélection" tant qu'aucun filtre n'est actif (selected || selectedMonth).

Fond SVG (mobile/tablette vs desktop selon useDeviceType) + MenuContent.

FooterEleveurs

Image du groupe d'éleveurs + cœur décoratif superposé.

<FooterEleveurs />

Form

TextInput

Champ texte pilule, label sert de placeholder (label* si required).

<TextInput name="email" type="email" label="Adresse e-mail" value={data.email} onChange={(e) => setData('email', e.target.value)} required />

TextArea

Même principe que TextInput, zone multi-lignes (rows={5} par défaut, non redimensionnable).

<TextArea name="message" label="Message" value={data.message} onChange={(e) => setData('message', e.target.value)} required />

FormSelect

Dropdown natif (<select>) stylé pilule, flèche custom, appearance-none forcé (multi-préfixes navigateur).

<FormSelect name="community" label="Quelle communauté ?" options={communities} value={data.community} onChange={(e) => setData('community', e.target.value)} required />

Checkbox

Case à cocher custom (carré bordé bleu, coche visible via peer-checked), avec label.

<Checkbox checked={accepted} onChange={(e) => setAccepted(e.target.checked)} label="Je soutiens le manifeste" />

FileInput

Déclenche un <input type="file"> caché via un bouton pilule stylé ; affiche le nom du fichier une fois choisi.

<FileInput onChange={(file) => setData('attachment', file)} />

SuccessModel

Modal de confirmation (panneau incliné, coin arrondi), auto-fermeture après un délai, via createPortal.

<SuccessModel isOpen={showSuccess} onClose={() => setShowSuccess(false)} />

ContactForm

Assemble tous les champs ci-dessus. Gère data/errors/processing en interne (useState, mode test sans back-end pour l'instant).

<ContactForm communities={[{ label: 'La Communauté 1', value: '1' }]} />

Header

Header

En-tête principal, fond vidéo (home) ou image (pages internes), logo, langue, bouton menu, titre optionnel centré.

Prop Type Défaut
media {type: 'video'|'image', src, srcWebp?} —
title ReactNode —
fullHeight boolean true
showLanguageSwitcher boolean false
className string ''
// Home, vidéo plein écran
<Header media={{ type: 'video', src: '/videos/hero.mp4' }} showLanguageSwitcher />
// Page interne, image + titre, hauteur réduite
<Header
  media={{ type: 'image', src: photoJpg, srcWebp: photoWebp }}
  fullHeight={false}
  title={<>Bien-être Animal :<br />Pourquoi cette démarche ?</>}
/>

HeroVideo

Vidéo de fond plein écran avec bouton play/pause et image décorative optionnelle.

Prop Type Défaut
src string requis
overlayImage string —
<HeroVideo src="/videos/hero.mp4" overlayImage={soleilImg} />

À savoir : contrôle play/pause via videoRef natif (.play()/.pause()), pas de librairie. autoPlay reste actif au montage, isPlaying démarre à true.

LanguageSwitcher

Switch FR/EN, lit locale/localizedUrls depuis les props Inertia partagées. Pas de props — autonome.

<LanguageSwitcher />

MenuButton

Bouton pilule à 3 points, ouvre/ferme MenuOverlay.

<MenuButton isOpen={isMenuOpen} onClick={() => setIsMenuOpen((prev) => !prev)} />

MenuContent

Contenu partagé Footer/MenuOverlay : titre, navigation 2 colonnes (avec sous-menus dépliables) + photo éleveurs. Données (COLONNE_GAUCHE/COLONNE_DROITE) codées en dur dans le fichier.

Prop Type Défaut
variant 'default' | 'menu' 'default' — contrôle uniquement les marges externes
// Footer
<MenuContent />

// Menu déroulant
<MenuContent variant="menu" />

MenuOverlay

Panneau déroulant plein écran depuis le haut, fond image fixe, contient MenuContent.

<MenuOverlay isOpen={isMenuOpen} onClose={() => setIsMenuOpen(false)} />

À savoir :

  • Animation translate-y (glisse depuis le haut), pas de createPortal — si un jour utilisé dans un composant avec filter/transform (ContentPanel par ex.), risque le même bug de positionnement rencontré sur MobileFilterPanel.
  • Fond image (menuOverlayBg) en hauteur fixe (h-[920px]), pas responsive à la hauteur réelle du contenu.
  • Appelle toujours <MenuContent variant="menu" /> — logo/bouton fermer non paramétrables (en dur).

Layout

CtaButton

Bouton pilule, plein ou outline, rend <Link> (Inertia) si href fourni, sinon <button>.

Prop Type Défaut
children ReactNode requis
href string — rend un <Link> au lieu d'un <button>
onClick () => void —
icon ReactNode — taille auto-ajustée selon size
iconPosition 'left' | 'right' 'left'
color 'bleu' | 'rouge' 'bleu'
variant 'filled' | 'outline' 'filled'
size 'sm' | 'md' | 'lg' 'md'
width string ''
type 'button' | 'submit' | 'reset' 'button'
className string ''
<CtaButton icon={<ArrowRight />} iconPosition="right" color="rouge">
  Envoyer
</CtaButton>
<CtaButton href="/contact" color="bleu" variant="outline" size="lg">
  En savoir plus
</CtaButton>
<CtaButton type="submit" width="w-full lg:w-[320px]">
  Valider
</CtaButton>

Heading

Titre (h1/h2/h3) avec soulignement optionnel en trait ondulé (SVG inline, s'étire sur toute la largeur).

Prop Type Défaut
children ReactNode requis
level 'h1' | 'h2' | 'h3' 'h2'
underline boolean true
underlineColor string (couleur CSS) '#E00A1E'
color string (classe Tailwind) 'text-bleu'
className string ''
<Heading level="h3" color="text-bleu">
  Charte de confidentialité
</Heading>
<Heading level="h1" underline={false} color="text-white">
  Titre sans soulignement
</Heading>

À savoir :

  • Le trait est un <svg> inline avec preserveAspectRatio="none" — s'étire pour occuper toute la largeur du titre, quelle que soit sa longueur, sans déformation d'un <img>.

IconCircleButton

Bouton rond (icône seule), plein ou outline, taille responsive automatique.

Prop Type Défaut
icon ReactNode requis
ariaLabel string requis
onClick () => void —
variant 'outline' | 'filled' 'outline'
outlineColor string 'border-primary text-primary hover:bg-primary/10'
filledColor string 'bg-primary text-white hover:bg-primary/90'
size number (px) 40 mobile / 56 desktop si non fourni
className string ''
<IconCircleButton icon={<Play size={24} />} ariaLabel="Lecture" variant="filled" size={85} />
<IconCircleButton
  icon={<ChevronLeft size={20} />}
  ariaLabel="Précédent"
  outlineColor="border-bleu text-bleu hover:bg-bleu/10"
/>

Barre de recherche pilule, soumission via onSearch.

<SearchBar onSearch={(value) => console.log(value)} width="w-full md:w-[958px]" />

Shared

Carrousel générique (render-prop), réutilisable pour n'importe quel type de carte. 3 modes : default (1 active + reste cachées en desktop dès lg:), contained (largeur bornée, effet "peek"), scrollable (vrai scroll horizontal, scrollIntoView au clic).

Prop Type Défaut
items T[] requis
renderItem (item: T, index: number, isActive: boolean) => ReactNode requis
starIcon string image par défaut
showStar boolean true
gap string 'gap-8'
initialIndex number 1
controlsColor string —
controlsDotColor string —
type 'default' | 'contained' | 'scrollable' 'default'
containedMaxWidth string 'max-w-[1000px]' (utilisé seulement si type="contained")
<Carousel
  items={guarantees}
  renderItem={(item, index, isActive) => (
    <GuaranteeCard {...item} isActive={isActive} />
  )}
  gap="gap-10"
/>
// Type contained (effet "peek", carte suivante partiellement visible)
<Carousel items={brands} renderItem={...} type="contained" containedMaxWidth="max-w-[1000px]" showStar={false} />
// Type scrollable (vrai défilement, toutes les cartes dans le DOM)
<Carousel items={photos} renderItem={...} type="scrollable" showStar={false} />

À savoir :

  • showStar affiche une image décorative (éclat) positionnée différemment selon mobile/tablette/desktop — désactiver si non pertinent (showStar={false}).
  • type="default" : en dessous de lg:, une seule carte est visible à la fois ; à partir de lg:, toutes réapparaissent (hidden lg:block) — adapté aux listes de cartes affichées côte à côte en desktop.
  • type="contained" : borne le conteneur en largeur avec overflow-hidden, laisse déborder visuellement la carte suivante sans vrai scroll interactif.
  • type="scrollable" : le seul mode avec un vrai scroll physique (scrollIntoView) — préférer ImageCarousel/PhotoCarousel pour un contrôle plus fin du scroll (offsetLeft) si ce mode pose des soucis d'alignement.

CarouselControls

Flèches précédent/suivant + dots de navigation, tailles responsive automatiques (plus petit en mobile).

<CarouselControls
  total={items.length}
  activeIndex={activeIndex}
  onPrev={goPrev}
  onNext={goNext}
  onSelect={setActiveIndex}
  color="text-bleu border-bleu hover:bg-bleu/10"
  dotColor="bg-bleu"
/>

Généralement utilisé à l'intérieur de Carousel/ImageCarousel/PhotoCarousel, pas appelé seul.

Accordion

Bloc dépliable, autonome ou contrôlé (un seul ouvert à la fois dans un groupe).

Prop Type Défaut
title string requis
children ReactNode requis
titleStyle string 'font-lato-bold text-h3 text-white'
iconStyle string 'text-white'
buttonStyle string 'gap-4 p-6'
defaultOpen boolean false
isOpen boolean — passe en mode contrôlé si fourni
onToggle () => void requis si isOpen fourni
className string ''
// Autonome
<Accordion title="Question">
  <p>Réponse...</p>
</Accordion>
// Contrôlé (un seul ouvert à la fois)
const [open, setOpen] = useState<string | null>(null);

<Accordion
  title="Thématiques"
  isOpen={open === 'thematiques'}
  onToggle={() => setOpen(open === 'thematiques' ? null : 'thematiques')}
>
  ...
</Accordion>

Fond fixé à bg-bleu en dur, pas de prop couleur dédiée.

ContentPanel

Bloc de contenu incliné avec un coin arrondi (façon "post-it"), plusieurs type selon le comportement voulu.

Prop Type Défaut
children ReactNode requis
title string —
titleStyle string ''
bgColor string 'bg-bleu'
rotation number -2.22
position 'left' | 'right' 'right' — côté qui reste arrondi
align 'start' | 'end' 'start' — collé à gauche/droite du conteneur parent
edgeOffset string auto (-left-3/-right-3 selon align)
roundedSize string '100px'
maxWidth string 'max-w-[1000px]'
height string ''
type 'accordion' | 'panel' | 'fullWidth' | 'sliderImage' 'panel'
image string — image décorative en absolute
imageClassName string positionnement de image
className string ''

Types :

  • panel (défaut) : toujours affiché en panneau incliné, jamais d'accordéon.
  • accordion : bascule en accordéon uniquement en mobile ; reste panel en tablette/desktop.
  • fullWidth : en mobile, annule rotation et edgeOffset (panneau droit, collé aux bords).
  • sliderImage : annule tout padding par défaut — laisse className gérer entièrement l'espacement (utilisé pour englober un carrousel).

CurvedImageCard

Base réutilisable : image avec bas courbé (classe clip-guarantee), rotation, ombre configurable. Utilisée par GuaranteeCard, ArticleCard, EngagementCard.

Prop Type Défaut
image string requis
children ReactNode requis
imageWebp string —
rotation number 3 — desktop uniquement
shadow 'default' | 'blue' 'default'
className string ''
imageClassName string ''
<CurvedImageCard image={photo} imageWebp={photoWebp} rotation={-2} className="w-[320px]">
  <div className="p-6">
    <h3>Titre</h3>
  </div>
</CurvedImageCard>

ImageCard

Carte blanche arrondie contenant une image, taille et rotation différentes si active/inactive.

Prop Type Défaut
image string requis
imageWebp string —
isActive boolean false
rotation number 0 — angle en desktop
compactRotation number 0 — angle en mobile/tablette
<ImageCard image={logo} imageWebp={logoWebp} isActive rotation={-4} />

ImageCarousel

Carrousel scrollable dédié (scroll physique via offsetLeft, pas scrollIntoView), une carte visible à la fois avec zoom sur la carte active. Pensé pour être englobé dans un ContentPanel type="sliderImage".

<ImageCarousel
  items={[
    { image: logo1, imageWebp: logo1Webp, rotation: -4 },
    { image: logo2, rotation: 7 },
  ]}
/>
// Dans un ContentPanel
<ContentPanel type="sliderImage" maxWidth="max-w-[1575px]" className="flex items-center justify-center py-24">
  <ImageCarousel items={[...]} />
</ContentPanel>

À savoir :

  • Tailles de carte fixes en dur (mobile 315×266, desktop 450×350 actif / 400×300 inactif) — pas de props de taille, à ajuster dans le composant.
  • Le scroll utilise card.offsetLeft (pas scrollIntoView) pour un alignement précis, contourne les soucis de centrage automatique du navigateur.
  • Le <div> vide en fin de liste (w-6 lg:w-16) est un spacer pour que la dernière carte, une fois active (plus large), ne dépasse jamais du cadre.

PhotoCard

Photo dans un cadre arrondi avec rotation, légende optionnelle en dessous. Taille responsive automatique (size/sizeLg), ou override direct (width/height).

// Autonome, taille responsive automatique
<PhotoCard image={photo} caption="toto" rotation={4} />
// Taille custom (ex: dans PhotoCarousel, qui calcule width/height selon la position)
<PhotoCard image={photo} width={680} height={484} />

À savoir :

  • width/height ignorent totalement size/sizeLg et le hook isCompact dès qu'ils sont fournis.
  • La légende hérite de la largeur de l'image (width: finalWidth), toujours alignée à gauche du cadre.

SliderCustomCard

Carte à 3 comportements (type) : default (numéro + titre), cta (fond bleu + bouton), flip (retournement recto/verso au clic). Style fixé par une table CARD_STYLES[type][état].

Prop Type Défaut
number string requis
title string requis
type 'default' | 'cta' | 'flip' 'default'
isActive boolean false
rotation number 3 — angle desktop
compactRotation number 2 — angle mobile/tablette
ctaLabel string 'En savoir plus' (type cta)
onCtaClick () => void — (type cta)
verso ReactNode — contenu affiché au retournement (type flip)
// Numéro/titre simple
<SliderCustomCard number="1" title="La Communauté Amont" isActive rotation={3} />
// Avec CTA
<SliderCustomCard
  type="cta"
  number="2"
  title="La Communauté Transformateurs"
  onCtaClick={() => {}}
/>
// Flip recto/verso
<SliderCustomCard
  type="flip"
  number="1"
  title="Densité d'élevage et conditions d'ambiance"
  verso={<p>Texte détaillé au verso...</p>}
/>

À savoir :

  • En mobile/tablette (isCompact), la carte est toujours en état "active" (effectiveIsActive), peu importe la prop isActive — pertinent puisqu'une seule carte est visible à la fois sur ces écrans.
  • Le contenu (recto vs verso) est un simple switch conditionnel
  • CARD_STYLES centralise taille/police par type/état — à modifier directement dans le composant pour changer les dimensions.

Stats

StatCard

Carte chiffre-clé (nombre géant + sous-titre + description), taille/rotation différentes selon isActive et l'écran.

<StatCard number="+1300" subtitle="éleveurs" description="La communauté du Collectif..." isActive />

À savoir :

  • Largeur mobile calculée en calc(100vw-64px) (96px en tablette md:) — s'adapte à l'écran, pas une valeur fixe.
  • En mobile/tablette (isCompact), rotation forcée à 2°
  • Généralement utilisée via StatsCarousel,

StatsCarousel

Carousel (type default) préconfiguré avec StatCard.

<StatsCarousel
  stats={[
    { number: '5', subtitle: 'garanties', description: '...', rotation: -4 },
    { number: '+1300', subtitle: 'éleveurs', description: '...' },
  ]}
/>

Testimonials

TestimonialCard

Carte blanche : citation entre guillemets ouvrant/fermant, photo + nom + rôle de l'auteur, logo de l'entreprise.

Prop Type Défaut
quote string requis
authorName string requis
authorRole string requis
authorPhoto string requis
logo string requis
quoteOpenIcon string requis
quoteCloseIcon string requis
<TestimonialCard
  quote="Lorem ipsum..."
  authorName="Christophe PAJOT"
  authorRole="Directeur Général Le Gaulois"
  authorPhoto={photo}
  logo={logoGaulois}
  quoteOpenIcon={quoteOpen}
  quoteCloseIcon={quoteClose}
/>

À savoir :

  • quote supporte \n\n (via whitespace-pre-line) pour séparer plusieurs paragraphes.
  • Guillemets ouvrant/fermant en img (pas SVG inline) — à fournir en props, pas d'icône par défaut.
  • Généralement utilisée via TestimonialsSection

TestimonialsSection

Assemble ContentPanel (fond incliné bleu) + Heading + TestimonialCard

<TestimonialsSection
  testimonials={[
    { quote: '...', authorName: 'Christophe PAJOT', authorRole: 'Directeur Général Le Gaulois', authorPhoto: photo, logo: logoGaulois },
  ]}
/>