Bloc PageBuilder : cta

Documentation technique

Objet : Bloc PageBuilder
Type : Object
Slice : Slice 1 (Page d’accueil)
Cycle : DOC → SPEC → CODE → TEST → INTÉG
Statut : DOC

1. Description et périmètre

1.1. Objectif

Le bloc cta (Call-to-Action) est un bloc PageBuilder qui affiche une section d’appel à l’action avec un titre, un texte et un bouton.

1.2. Utilisation principale

Section CTA de la page d’accueil
Encouragement à l’action (inscription, contact, etc.)
Conversion des visiteurs

1.3. Périmètre concerné

Type : Object Sanity
Champs : heading, text, buttonText, buttonLink
Rendu : Composant Astro CTA
Style : Mise en évidence visuelle

2. Contrats d’entrée

2.1. Structure du bloc1/2

Entrée : Configuration du bloc cta dans Sanity Studio

Structure :

{
  _type: "cta",
  heading: string,
  text: string,
  buttonText: string,
  buttonLink: string
}

2.1. Structure du bloc2/2

Règles :

heading : obligatoire, titre de la section
text : obligatoire, texte de description
buttonText : obligatoire, texte du bouton
buttonLink : obligatoire, lien du bouton

2.2. Validation

Règles de validation :

heading : max 100 caractères
text : max 300 caractères
buttonText : max 50 caractères
buttonLink : URL valide (relative ou absolute)

3. Contrats de sortie

3.1. Données Sanity

Sortie : Bloc cta dans le PageBuilder

Format : JSON avec la structure définie ci-dessus

Utilisation :

Rendu dans le composant Astro CTA
Utilisation dans le PageBuilder de la page

3.2. Rendu Astro

Sortie : Composant Astro CTA

Comportement :

Affichage du titre de la section
Affichage du texte de description
Affichage du bouton avec le lien
Mise en évidence visuelle (couleur, taille)

4. Side effects

4.1. Impact sur le rendu

Effet : Le bloc cta nécessite un composant Astro spécifique

Impact :

Création du composant CTA.astro
Gestion du lien (interne ou externe)
Mise en évidence visuelle

4.2. Impact sur l’accessibilité

Effet : Le bouton doit être accessible

Impact :

Attribut aria-label si nécessaire
Contraste suffisant
Focus visible

5. Erreurs et gestion

5.1. Erreurs potentielles

Erreur	Cause probable	Solution
Lien invalide	URL mal formatée	Valider l’URL côté Sanity
Bouton vide	`buttonText` vide	Afficher un texte par défaut
Lien externe non sécurisé	Lien HTTP au lieu de HTTPS	Forcer HTTPS ou avertir l’utilisateur

5.2. Codes HTTP

Non applicable (bloc PageBuilder)

6. Checklist de validation

Avant de passer à l’étape SPEC, vérifier :

La structure du bloc est documentée
Les contrats d’entrée/sortie sont documentés
Les side effects sont identifiés
Les erreurs potentielles sont documentées

7. Approbation

Validation requise : Confirmer que la documentation du bloc cta peut passer à l’étape SPEC.

8. Historique des modifications

Date	Version	Description	Auteur
2026-09-16	1.0	Création initiale	Devin