---
url: "/fr/weblify/automation/parameters.md"
description: "Lancez les Quick Actions de Weblify avec des champs simples et nommés, et des raccourcis qui agissent sur la sélection en cours."
---

# Quick Actions de Weblify

> Lancez les Quick Actions de Weblify avec des champs simples et nommés, et des raccourcis qui agissent sur la sélection en cours.

Lancez les tâches courantes de Weblify depuis les Quick Actions de Figma, sans ouvrir le panneau du plugin. Choisissez un raccourci nommé ci-dessous. Utilisez le panneau habituel du plugin pour les réglages détaillés et la création de contenu.

## Lancer une Quick Action {#run-a-quick-action}

Chaque raccourci exige une licence valide et vérifiée, ou des essais restants. Si la vérification échoue ou si vos essais ont expiré, ouvrez le panneau habituel du plugin pour activer votre licence. Le panneau reste toujours accessible.

1. Sélectionnez les calques sur lesquels vous voulez travailler, si le raccourci utilise une sélection.
2. Ouvrez les Quick Actions de Figma avec **Command + /** sur Mac ou **Ctrl + /** sous Windows.
3. Recherchez le plugin et choisissez le raccourci nommé ci-dessous.
4. Remplissez les champs affichés. Les champs facultatifs peuvent être ignorés ; utilisez la touche Tab pour les modifier. Lancez le raccourci, puis vérifiez le résultat ou terminez sa boîte de dialogue d’enregistrement.

Les raccourcis de création demandent directement des noms ou des dimensions. Les raccourcis qui agissent sur les calques sélectionnés utilisent automatiquement la sélection en cours. Ces raccourcis du quotidien ne demandent ni Target ni JSON. Choisissez **Open Weblify** pour ouvrir le panneau habituel du plugin.

| Raccourci | Champs |
| --- | --- |
| **Export Website…** | Nom de l’export |
| **Repair Weblify Metadata** | Aucun ; s’exécute immédiatement |

Les champs à choix fixes utilisent des libellés lisibles. Recherchez par le libellé affiché ou par la valeur sous-jacente ; les entrées des agents continuent d’utiliser les valeurs indiquées dans la référence des commandes.

## Lancer depuis le menu contextuel {#run-from-the-context-menu}

Sélectionnez les calques voulus, faites un clic droit et choisissez **Plugins → Weblify** (les plugins en développement apparaissent sous **Development**). Choisissez une action, puis son format ou son préréglage. Un préréglage s’exécute immédiatement s’il ne demande aucun champ obligatoire ; terminez la boîte de dialogue d’enregistrement si elle apparaît.

Chaque préréglage définit l’option qu’il nomme. Les options compatibles omises reprennent les réglages enregistrés du plugin ; une action ou une option explicite l’emporte sur un comportement enregistré contradictoire. Seuls les champs saisis explicitement ou le choix de menu sélectionné les remplacent, et uniquement pour cette exécution. Si un réglage n’a jamais été enregistré, le réglage habituel ou la valeur de repli documentée s’applique. Les remplacements d’export ne sont pas enregistrés dans vos préférences. Si un format enregistré n’est pas disponible en raccourci, choisissez explicitement un format pris en charge ou utilisez le panneau habituel. Pour combiner des options, choisissez **Custom Settings…** dans l’action et saisissez les paramètres. Les actions qui ont besoin de texte, d’URL, de noms ou de dimensions demandent toujours ces champs obligatoires. **Open Weblify** ouvre le panneau habituel.

| Choix de menu | Étape suivante |
| --- | --- |
| **Export Website…** | Saisir le nom de l’export (Export name) |
| **Repair Weblify Metadata** | S’exécute immédiatement |

## Modifications détaillées {#detailed-editing}

Utilisez le panneau habituel du plugin pour les réglages détaillés, les contenus longs, la création en masse et la consultation des composants ou des modèles. Le menu des raccourcis ne contient que les commandes du quotidien listées ci-dessus.

Gardez chaque champ collé sous 150 caractères : l’application de bureau Figma peut tronquer les saisies collées à cette limite. Les saisies plus longues se font dans le panneau habituel.

Si une ancienne version du plugin affiche plutôt Action, Target et Options, mettez-la à jour pour utiliser ces raccourcis nommés. Une valeur Target est un ID de calque ou une sélection, jamais le nom d’un nouvel élément.

## Actions de Weblify {#weblify-actions}

| Action | Ce qu’elle fait | Target |
| --- | --- | --- |
| [`export`](#export) | Exporte le site Weblify actuel sous forme de ZIP statique | Aucun calque cible |
| [`repair`](#repair) | Répare les métadonnées des sous-arborescences sélectionnées, sans se rabattre sur toute la page | Un ou plusieurs calques compatibles |

### export {#export}

Exporte le site Weblify actuel sous forme de ZIP statique. Cette action ne prend pas de cible.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `name` | string | Obligatoire | Nom du nouvel élément. 1 caractère minimum ; 120 caractères maximum |

Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises conservent le comportement existant de l’opération, sauf si une valeur par défaut est indiquée.

Choisissez **Export Website…**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

- **Export name** : `My Website`

Entrée pour l’hôte de l’agent

```json
{"command":"shortcut-export","parameters":{"name":"My Website"}}
```

### repair {#repair}

Répare les métadonnées des sous-arborescences sélectionnées, sans se rabattre sur toute la page. Sélectionnez un ou plusieurs calques compatibles.

Ce raccourci n’a aucun champ de saisie.

Choisissez **Repair Weblify Metadata**. Il s’exécute immédiatement sur la sélection en cours.

Entrée pour l’hôte de l’agent

```json
{"command":"shortcut-repair","parameters":{}}
```

## Utiliser les raccourcis avec un agent {#using-shortcuts-with-an-agent}

Lisez le registre lisible par une machine indiqué ci-dessous et choisissez une action proposée dans la liste des Quick Actions du plugin installé. Le registre utilise les définitions d’options d’Hypermatic plutôt que le JSON Schema standard : `min` et `max` limitent la longueur d’une chaîne, la longueur d’un tableau ou une valeur numérique selon le type du champ ; les définitions imbriquées utilisent `fields` et `item`. Les champs inconnus sont refusés.

L’agent a besoin d’un hôte capable d’appeler les Quick Actions de Figma et d’observer le résultat habituel du plugin. Les paramètres n’ajoutent aucun lanceur REST ou MCP. Les exemples dépliables sont des données d’entrée pour un hôte compatible, pas des appels d’API exécutables ; les entrées des raccourcis utilisent des chaînes simples dans `parameters`, y compris pour les nombres et les choix de format. N’affirmez jamais qu’un raccourci s’est exécuté sur la seule base de l’entrée préparée.

Vérifiez le résultat visible : les calques Figma modifiés, l’export enregistré ou la page publiée. Lisez la notification habituelle de réussite ou d’erreur, ainsi que tout avertissement d’export partiel. Terminez les boîtes de dialogue d’enregistrement natives si nécessaire ; le début d’un téléchargement ne prouve pas que le fichier a été enregistré. Les utilisateurs n’ont pas besoin d’ouvrir les outils de développement ni de lire une console.

## Dépannage {#troubleshooting}

| Symptôme | Étape suivante |
| --- | --- |
| L’action n’est pas disponible | Mettez à jour le plugin et vérifiez sa liste de Quick Actions ; utilisez le panneau habituel si l’action n’est pas disponible. |
| Les options sont invalides ou ont pu être tronquées | Utilisez des valeurs simples, champ par champ, de moins de 150 caractères, avec uniquement les champs acceptés par ce raccourci. |
| La cible est absente ou incompatible | Ouvrez la bonne page, vérifiez les conditions de l’action sur les calques et sélectionnez à nouveau les calques voulus. |
| Une erreur de licence ou d’essai apparaît | Terminez le processus d’activation habituel du plugin avant de relancer. |
| Un téléchargement a été demandé, mais aucun fichier enregistré n’est visible | Vérifiez la boîte de dialogue d’enregistrement native et l’emplacement des téléchargements. Examinez le fichier lui-même. |
| Une commande échoue, expire ou est annulée | Vérifiez le document et la destination distante avant de réessayer ; des modifications ou des mises en ligne antérieures existent peut-être déjà. |

Les commandes ont un délai de cinq minutes. Une erreur n’implique pas une annulation complète. Relancer automatiquement une création, un remplacement ou une mise en ligne peut dupliquer ou écraser du travail.

Le [registre des commandes lisible par une machine](/automation/parameters/weblify.json) contient les mêmes identifiants d’action et les mêmes définitions d’options.

## Limites actuelles {#current-limits}

Créez les pages, mettez à jour les images, composez les composants et publiez depuis le panneau habituel. Repair Weblify Metadata répare uniquement les métadonnées des sous-arborescences sélectionnées ; il ne modifie pas leur mise en page visible. Export Website agit sur le site Weblify actuel plutôt que sur la sélection. Utilisez le panneau pour les audits, les tokens et l’inspection des images de substitution.

## Documentation associée {#related-documentation}

- [Installer et lancer Weblify](/fr/weblify/overview/install)
- [Paramètres des plugins Figma](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Options d’interface masquée de Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)