Lancez les tâches courantes de Convertify 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 sa boîte de dialogue d’enregistrement.
Les raccourcis de création demandent directement des noms ou des dimensions. Les raccourcis 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 Convertify pour ouvrir le panneau habituel du plugin.
| Raccourci | Champs |
|---|---|
| Export Selected Layers (Custom Settings…) | Format (facultatif) |
Les champs à choix fixes utilisent des libellés lisibles. Recherchez par libellé affiché ou par 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 → Convertify (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 nécessite aucun champ obligatoire ; terminez la boîte de dialogue d’enregistrement si elle s’affiche.
Chaque préréglage définit l’option qui lui correspond. 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 ré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 nécessitent du texte, des URL, des noms ou des dimensions demandent toujours ces champs obligatoires. Open Convertify ouvre le panneau habituel.
| Choix de menu | Étape suivante |
|---|---|
| Export Selected Layers → Use Saved Settings | S’exécute immédiatement |
| Export Selected Layers → Adobe Photoshop (.psd) | S’exécute immédiatement |
| Export Selected Layers → Canva (.psd) | S’exécute immédiatement |
| Export Selected Layers → Sketch (.sketch) | S’exécute immédiatement |
| Export Selected Layers → EPS Vector (.eps) | S’exécute immédiatement |
| Export Selected Layers → Adobe XD (.xd) | S’exécute immédiatement |
| Export Selected Layers → Adobe After Effects | S’exécute immédiatement |
| Export Selected Layers → Adobe InDesign (.idml) | S’exécute immédiatement |
| Export Selected Layers → Export Selected Layers (Custom Settings…) | Saisir Format (facultatif) |
Édition détaillée
Utilisez le panneau habituel du plugin pour les réglages détaillés, les contenus longs, la création en masse et la navigation dans les composants ou les modèles. Le menu des raccourcis ne contient que les commandes du quotidien listées ci-dessus.
Limitez chaque champ collé à moins de 150 caractères : l’application de bureau Figma peut tronquer le texte collé à 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 Convertify
| Action | Ce qu’elle fait | Cible |
|---|---|---|
export | Convertit les calques sélectionnés avec l’exportateur existant | Un ou plusieurs calques éligibles |
export
Convertit les calques sélectionnés avec l’exportateur existant. Sélectionnez un ou plusieurs calques éligibles.
| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
|---|---|---|---|
format | string | Valeur de repli : "psd" | Format de conversion local. psd, canva, sketch, eps, xd, ae, idml |
Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises suivent le comportement de l’opération existante, sauf si une valeur par défaut est indiquée.
Choisissez Export Selected Layers (Custom Settings…). Saisissez ces champs simples ; aucun JSON n’est nécessaire :
- Format : Adobe Photoshop (.psd)
Entrée pour l’hôte de l’agent
{"command":"shortcut-export","parameters":{"format":"psd"}}Utiliser les raccourcis avec un agent
Lisez le registre lisible par machine dont le lien figure 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 rejetés.
L’agent a besoin d’un hôte capable d’invoquer 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é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 à jour le plugin 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 pu être tronquées | Utilisez des valeurs de champ simples, chacune de moins de 150 caractères, avec uniquement les champs acceptés par ce raccourci. |
| La cible est manquante ou non éligible | Ouvrez la bonne page, vérifiez les conditions de calque de l’action 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. |
| 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 de téléchargement. Inspectez 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
Tous les imports de fichiers restent interactifs, car le texte des paramètres ne peut pas fournir les octets d’un fichier local. After Effects utilise le format de transmission XD existant ; IDML produit le package ZIP existant. Le comportement actuel de conversion et de restauration temporaire du document est conservé.