Lancez les tâches courantes de CopyDoc depuis les Quick Actions de Figma sans ouvrir le panneau du plugin. Choisissez l’un des raccourcis nommés 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
Chaque raccourci nécessite une licence valide 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. L’ouverture du panneau reste toujours possible.
- Sélectionnez les calques sur lesquels vous voulez travailler, si le raccourci utilise une sélection.
- Ouvrez les Quick Actions de Figma avec Command + / sur Mac ou Ctrl + / sur Windows.
- Recherchez le plugin et choisissez l’un des raccourcis nommés ci-dessous.
- Remplissez les champs affichés. Les champs facultatifs peuvent être ignorés ; utilisez Tab pour les modifier. Lancez le raccourci, puis vérifiez le résultat ou terminez la 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 actuelle. Ces raccourcis du quotidien ne demandent ni Target ni JSON. Choisissez Open CopyDoc pour ouvrir le panneau habituel du plugin.
| Raccourci | Champs |
|---|---|
| Export Selected Text (Custom Settings…) | Format (facultatif) |
Les champs à choix fixe 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
Sélectionnez les calques voulus, faites un clic droit et choisissez Plugins → CopyDoc (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 s’affiche.
Chaque préréglage définit l’option qui porte son nom. 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 comme 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 d’un texte, d’URL, de noms ou de dimensions demandent toujours ces champs obligatoires. Open CopyDoc ouvre le panneau habituel.
| Choix de menu | Étape suivante |
|---|---|
| Export Selected Text → Use Saved Settings | S’exécute immédiatement |
| Export Selected Text → CSV Spreadsheet | S’exécute immédiatement |
| Export Selected Text → Excel Spreadsheet (.xlsx) | S’exécute immédiatement |
| Export Selected Text → JSON | S’exécute immédiatement |
| Export Selected Text → Markdown | S’exécute immédiatement |
| Export Selected Text → XLIFF 1.2 | S’exécute immédiatement |
| Export Selected Text → XLIFF 2.0 | S’exécute immédiatement |
| Export Selected Text → Export Selected Text (Custom Settings…) | Saisissez Format (facultatif) |
Modifications détaillées
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 CopyDoc
| Action | Ce qu’elle fait | Cible |
|---|---|---|
export | Exporte le texte des frames sélectionnés | Un ou plusieurs calques compatibles |
export
Exporte le texte des frames sélectionnés. Sélectionnez un ou plusieurs calques compatibles.
| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
|---|---|---|---|
format | string | Valeur de repli : "csv" | Format d’export du texte. csv, xlsx, json, markdown, xliff1, xliff2 |
Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises reprennent le comportement actuel de l’opération, sauf si une valeur par défaut est indiquée.
Choisissez Export Selected Text (Custom Settings…). Saisissez ces champs simples ; aucun JSON n’est nécessaire :
- Format : CSV Spreadsheet
Entrée pour l’hôte de l’agent
{"command":"shortcut-export","parameters":{"format":"csv"}}Utiliser les raccourcis avec un agent
Lisez le registre lisible par 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 standard JSON Schema : 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 de lancer les Quick Actions de Figma et d’observer le résultat habituel du plugin. Les paramètres n’ajoutent pas de 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 et tout avertissement d’export partiel. Terminez les boîtes de dialogue d’enregistrement natives si nécessaire ; le démarrage 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
| Symptôme | Étape suivante |
|---|---|
| L’action n’est pas disponible | Mettez le plugin à jour et vérifiez sa liste de Quick Actions ; utilisez le panneau habituel si l’action reste indisponible. |
| Les options ne sont pas valides ou ont peut-être été tronquées | Utilisez des valeurs de champ simples, individuelles, de moins de 150 caractères, avec uniquement les champs acceptés par ce raccourci. |
| La cible est manquante ou non compatible | Ouvrez la bonne page, vérifiez les exigences de l’action concernant les calques et sélectionnez de nouveau les calques voulus. |
| Une erreur de licence ou d’essai s’affiche | Terminez le processus d’activation habituel du plugin avant de relancer. |
| Le téléchargement a été demandé, mais aucun fichier enregistré n’apparaît | Vérifiez la boîte de dialogue d’enregistrement native et l’emplacement de téléchargement. 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 envois antérieurs peuvent déjà exister. |
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 un envoi peut dupliquer ou écraser du travail.
Le registre des commandes lisible par machine contient les mêmes ID d’action et définitions d’options.
Limites actuelles
Les raccourcis exportent le texte sélectionné. Le remplacement de texte, l’import de traductions, la synchronisation de tableurs et le remplissage de composants passent par le panneau habituel.