Documentation
Vérifier le rendu d'un composant
Laisser votre agent comparer son rendu au crop de référence, sans quitter votre machine.
Un rendu peut sembler juste à l'œil et dériver de quelques pixels. Cadralia fournit à votre agent le crop de référence et une commande pour le comparer à sa propre page. La vérification est une capacité en plus, pas une étape obligatoire.
Elle ne consomme aucune extraction : la commande tourne en local, sans session.
La commande
Votre agent lance :
cadralia-bridge check \
--reference <selectionId> \
--url <son URL locale> \
--target "<sélecteur cible>"
L'agent fournit lui-même l'URL de la page sur laquelle il a travaillé, ou une route de prévisualisation pour le composant. Cadralia ne devine jamais le serveur de développement.
selectionId est l'identifiant de la livraison. Il se trouve dans l'historique
du panneau et dans le handoff reçu par l'agent.
Ce que produit la commande
La commande capture l'élément cible, le compare au crop de référence et écrit
quatre fichiers dans .cadralia/checks/<selectionId>/ :
reference.png, le crop livré ;current.png, l'élément tel qu'il est rendu ;diff.png, la carte des différences ;report.json, les métriques et les régions classées par écart.
Le rapport compare la géométrie, les espacements, la typographie, les couleurs, les bordures, les rayons, les ombres, les icônes et les graphismes. Le contenu textuel peut différer : ce n'est pas un échec.
Le rapport est informatif. Aucun seuil ne bloque la livraison ni ne déclare le travail terminé. L'agent le lit, décide quoi corriger et relance la commande s'il le souhaite.
Deux règles honnêtes
- La largeur doit correspondre. Un élément rendu à une autre largeur que la référence échoue avec un message clair, au lieu de produire un faux score. Ciblez un conteneur à la largeur du design, ou adaptez la page avant de relancer.
- Le défilement source n'est jamais rejoué. Cadralia compare l'élément au crop, jamais la page entière. La position de départ de la sélection sert de provenance, pas d'instruction.
Ciblez un conteneur qui correspond à la zone. Une capture d'élément coupe ce qui dépasse de sa boîte, comme une ombre externe.
Limites de la première version
La vérification fonctionne sur une URL locale, sans session :
- les pages authentifiées ne sont pas encore prises en charge ;
- les modales, les popovers et les toasts ne sont pas capturés ;
- les dialogues natifs du navigateur ne peuvent pas être capturés ;
- la référence est mise en cache au moment de la livraison. Une ancienne entrée d'historique ne peut pas être revérifiée tant que la référence n'est pas persistée côté API.
Ces limites concernent la vérification. La sélection, l'extraction et l'action sur un détail continuent de fonctionner normalement.
Si la vérification échoue
- La référence est introuvable. Livrez à nouveau la zone pour recréer le cache local.
- La largeur ne correspond pas. Ciblez un conteneur à la largeur de référence, ou rendez le composant à cette largeur.
- Le sélecteur ne trouve rien. Vérifiez l'URL et le sélecteur. La page doit être servie, pas seulement présente dans un éditeur.
- Le navigateur manque. Installez Chrome ou laissez Playwright installer son Chromium. La commande utilise le navigateur système en dernier recours.
Pour référencer un élément sur n'importe quelle page, voir Agir sur un détail.