Apporter des modifications visuelles avec l’agent de modernisation de l’expérience visual-changes
Ce guide s’adresse aux concepteurs et aux autres personnes qui changent l’apparence d’un site : couleurs, polices, espacement et mise en page de ses blocs. Vous décrivez une modification apportée à l’agent de modernisation de l’expérience dans la console de modernisation de l’expérience, la vérifiez dans l’aperçu et envoyez-la à un développeur pour révision. L’agent écrit le code, de sorte que vous n’avez pas besoin d’écrire du code CSS ou JavaScript. Vos modifications atteignent le site par le biais de son référentiel Git. Vous avez donc besoin des principes de base : vous envoyez votre travail à une branche et le transmettez dans une requête d’extraction. Si ces termes sont nouveaux pour vous, consultez Mots utilisés dans ce guide.
Avant de commencer before-you-start
Demandez ce qui suit à la personne qui dirige le projet :
- Accès à la console. Vous vous connectez avec votre Adobe ID. Voir Ouvrir la console de modernisation de l’expérience.
- Site sur lequel travailler. Vous connectez le référentiel Git du site à l’espace de travail de la console et vous avez besoin d’un accès en écriture au référentiel pour ce faire. Voir Connexion À Votre Site.
- Votre partie du travail. Identifiez les blocs, pages ou styles qui vous appartiennent, de sorte que personne d’autre ne modifie les mêmes fichiers en même temps. Voir Commencer par une personne, puis diviser le travail.
- Comment passer la main. La plupart des équipes protègent la branche principale afin qu’un développeur examine chaque modification. Demandez si vous effectuez une notification push avec Créer un nouveau PR. Voir Remettre pour révision.
- Pour les conceptions Figma, un siège Figma qui peut lire les fichiers. Voir Utilisation d’une conception Figma.
Votre travail reste dans votre propre espace de travail de console jusqu’à ce que vous le transmettiez. Rien de ce que vous essayez dans l’aperçu n’atteint le site en direct par lui-même.
Ce que vous pouvez modifier what-you-can-change
Sur un site Edge Delivery Services, les auteurs écrivent le contenu et le code décide de son aspect. Une modification visuelle modifie donc le code du site, principalement son CSS, et laisse le contenu saisi par les auteurs tel quel. Vous n’avez pas besoin d’importer ou de charger des pages à nouveau.
Chaque partie du code atteint une partie différente du site. Avant de demander une modification, décidez jusqu’où elle doit aller :
--link-color dans les styles globaux.Les variantes, les styles de section et les modèles ne prennent effet que lorsque les auteurs les appliquent. Demandez à l’agent d’en appliquer une à la page sur laquelle vous travaillez, afin de pouvoir la voir, et indiquez aux auteurs quand l’utiliser.
Certaines requêtes vont au-delà de l’aspect du site. L’ajout d’un champ rempli par les auteurs, la modification de la structure du contenu d’un bloc ou l’ajout d’un comportement tel qu’un carrousel modifie le modèle de contenu du bloc ou sa logique. Décrivez ce dont vous avez besoin et laissez ces décisions au développeur. Voir Créer, mettre à jour et refactoriser des blocs.
Limiter une modification à certaines pages impact
La modification d’un bloc ou des styles globaux modifie chaque page qui les utilise. Avant d’en demander une, demandez à l’agent où le bloc ou le style est utilisé, par exemple « Quelles pages de mon espace de travail utilisent le bloc de cartes ? »
Lorsqu’une modification ne doit s’appliquer qu’à certaines pages, demandez plutôt l’une des options suivantes :
- Variante de bloc , lorsque seules certaines instances d’un bloc doivent être différentes.
- Un style de section , lorsqu’une partie d’une page, telle qu’une zone mise en surbrillance, a besoin de son propre aspect.
- Un modèle de page, lorsqu’un type de page, comme toutes les pages de produits, nécessite sa propre apparence.
Expliquez Ce Que Vous Voulez Dire references
Une image est souvent plus précise qu’une description. Utilisez Joindre des fichiers (icône de trombone) dans l’invite pour joindre :
- Capture d’écran du résultat souhaité ou du problème, avec une phrase indiquant ce qu’il faut regarder.
- Pages du guide de style de la marque, sous forme d’images ou de fichier Word ou PowerPoint.
Vous pouvez également pointer vers une page du site qui ressemble déjà à droite : « Faites en sorte que les cartes de /adventures ressemblent à celles de /magazine. » Utilisez uniquement les conceptions et les sites de référence que votre équipe est autorisée à utiliser.
L’agent ne se souvient pas des règles de marque entre les conversations. Une fois qu’une règle est réglée, comme les styles de bouton ou les tailles d’en-tête, demandez à l’agent de l’écrire dans les fichiers d’instructions du projet, afin qu’il suive la règle dans chaque conversation. Voir Instructions et mémoire du projet.
Travail à partir d’une conception de formulaire figma
L’agent peut lire une conception de Figma via le module complémentaire d’importation de Figma. Il transforme les couleurs, la typographie, l’espacement et les variables de la conception en jetons de conception du site et ses composants en blocs ou en variantes de bloc.
- Dans Figma, créez un jeton d’accès personnel avec les portées en lecture seule répertoriées dans les paramètres d’identification de la console.
- Dans la console, ouvrez Paramètres, saisissez le jeton sous Informations d’identification et sélectionnez Enregistrer. Un nouveau jeton peut prendre quelques minutes pour prendre effet.
- Dans Figma, sélectionnez un composant ou une image et copiez son lien. Le lien comprend un élément
node-idqui identifie votre sélection. - Dans la console, envoyez une invite avec le lien, telle que « Mettez à jour le bloc de teaser pour qu’il corresponde à ce composant Figma :
{Figma link}. Réutilisez nos jetons de conception existants. »
À savoir :
- Un composant ou image à la fois. L’agent crée un bloc à partir d’un composant ou une page à partir d’un cadre. Vérifiez chaque résultat avant d’envoyer le lien suivant. Voir Créer un bloc à partir de Figma et Créer une page à partir de Figma.
- Votre jeton, vos fichiers. Le jeton d’accès personnel lit chaque fichier Figma que vous pouvez ouvrir, et rien d’autre. La Figma la délivre et en fixe les limites. Chaque personne stocke son propre jeton. Cela n’a rien à voir avec les jetons de conception, les couleurs et l’espacement que l’agent lit à partir de la conception.
- Votre place Figma. Vous avez besoin d’un siège Dev ou Full Figma ; voir Figma and Design Systems. Si la console signale une erreur d’API Figma avec l’état 429, le jeton a atteint la limite de débit de Figma 🔗.
- Le module complémentaire. L’importation Figma est une fonctionnalité facultative. S’il n’est pas activé pour votre projet, l’agent vous propose de l’activer.
- Jetons de conception. Comparez les nouveaux jetons avec les jetons existants. Lorsqu’une valeur Figma ne diffère que légèrement d’un jeton existant, décidez lequel conserver plutôt que de conserver les deux.
Pour connaître les éléments approuvés par votre organisation avant que les utilisateurs n’utilisent Figma avec l’agent, consultez Figma et systèmes de conception.
Effectuer votre premier changement first-change
- Ouvrez une page dans le panneau d’aperçu de la console.
- Dans le menu Fenêtre d’affichage, choisissez la largeur à vérifier : Bureau, Tablette ou Mobile.
- Activez le mode d’inspection avec l’icône de sélection dans le panneau d’aperçu.
- Sélectionnez l’élément à modifier, tel qu’un en-tête, une image ou un bouton. L’élément est ajouté à votre invite : l’agent reçoit son HTML et sa position sur la page, et limite ses modifications à cet élément.
- Décrivez la modification et l’étendue de la portée, puis envoyez l’invite. Par exemple : « Faites en sorte que ce bouton utilise notre style principal, ici et sur chaque page. »
- Une fois l’agent terminé, sélectionnez Actualiser l’aperçu si l’aperçu n’a pas été mis à jour. Vérifiez le résultat à chaque taille de Viewport.
- Si quelque chose ne fonctionne pas correctement, dites ce que vous voyez, par exemple « Sur mobile, le texte touche l’image ». Demandez une modification à la fois et vérifiez-la avant de demander la suivante.
Pour annuler une modification, demandez à l’agent de l’annuler. Pour déposer toutes les modifications non transmises dans un fichier, ouvrez la vue Modifications et sélectionnez Ignorer en regard du fichier. Voir Actions De Modifications.
Si l’agent n’obtient toujours pas de modification juste après quelques tentatives, demandez à votre développeur ou sélectionnez Demande d’assistance dans la barre de menus et décrivez ce que vous avez demandé et ce que vous voyez. Votre demande parvient à l’équipe qui crée l’agent. Lorsqu’une conversation ne se passe pas bien, la console peut également offrir de l’aide sous Besoin d’un coup de main ? Voir Demande D’Assistance.
Exemples d’invites example-prompts
- « Faites en sorte que tous les en-têtes utilisent la police d’en-tête du guide de style joint. »
- « Donnez aux cartes du bloc de cartes une hauteur égale, avec leurs boutons alignés en bas. »
- « Ajoutez une variante
darkdu bloc de teaser avec du texte blanc sur la couleur sombre de votre marque et appliquez-la au deuxième teaser sur/adventures. » - « Ajoutez un style de section
highlightavec un arrière-plan clair et plus d’espace au-dessus et en dessous, et utilisez-le pour la section newsletter de la page d’accueil. » - « Sur mobile, empilez les colonnes et placez l’image au-dessus du texte. »
- « Quelles pages de mon espace de travail utilisent le bloc principal ? Montrez-moi comment chacun s’occupe de ce changement. »
- « Écrivez les styles de bouton sur lesquels nous nous sommes mis d’accord dans les fichiers d’instructions du projet. »
Vérifier Avant De Remettre check
- Vérifiez chaque taille de Viewport, en particulier Mobile.
- Vérifiez d’autres pages qui utilisent le même bloc, le même style ou le même modèle, et pas seulement la page sur laquelle vous avez travaillé.
- Vérifiez comment la conception gère le contenu réel : titres longs, courts, images manquantes et listes comportant de nombreux éléments.
- Vérifiez que le texte reste lisible sur son arrière-plan. Vous pouvez demander à l’agent : « Vérifiez le contraste des couleurs du texte dans le bloc de teaser par rapport à WCAG AA. »
- Une fois que vous avez envoyé une notification push, ouvrez les URL d’aperçu répertoriées dans la demande d’extraction et vérifiez les pages qu’elles contiennent. Voir La prévisualisation de la console diffère de celle du site.
Remise pour révision hand-over
- Envoyez votre code push avec Créez un PR, comme décrit dans la section Modifications du code push. Préparez uniquement les fichiers qui appartiennent à votre modification et décrivez-les en une phrase simple, comme « Coins arrondis et ombre pour les cartes ».
- Sélectionnez Afficher PR dans la notification et envoyez le lien de la demande d’extraction au développeur qui la révise.
Pour apporter les modifications demandées par le réviseur, continuez à travailler sur la même branche et effectuez une notification push avec Notification push sur la branche actuelle ; la demande d’extraction est mise à jour.
Votre modification atteint le site actif lorsque le développeur la fusionne. Si vous avez également modifié du texte ou des images sur une page, il s’agit d’un changement de contenu : la page n’atteint le site que lorsque la page est chargée et publiée. Je suis d’accord avec les auteurs qui font cela. Voir Coordination Des Modifications De Contenu.
Mots utilisés dans ce guide glossary
--link-color.main.Les sections, les blocs et le contenu par défaut sont expliqués plus en détail sous Façonner la structure de contenu.