2c9bb8fcd7
instance.detachInstance() turns an instance into a frame that keeps its content, as in Figma, from scripts run through eval. It reuses the graph's shared detach implementation, asserts editability like the proxy's other mutations, and joins the instance surface check against @figma/plugin-typings.
1.8 KiB
| title | description |
|---|---|
| Scripting | Eseguire JavaScript con un’API compatibile con i plugin Figma per interrogare, modificare e generare design. |
Scripting
openpencil eval esegue JavaScript su un documento e fornisce un oggetto globale figma. È utile per modifiche in serie, ispezione, dati di test e automazione senza aprire l’interfaccia dell’editor.
Uso di base
openpencil eval design.fig -c "return figma.currentPage.children.length"
-c accetta JavaScript. Se il codice non inizia con return, OpenPencil lo esegue in una funzione asincrona e restituisce l’eventuale risultato.
Interrogare oggetti
openpencil eval design.fig -c "return figma.currentPage.findAll((n) => n.type === 'FRAME')"
Modificare e salvare
--write o -w sovrascrive il file di input. --output o -o crea un altro file.
Script da stdin
cat transform.js | openpencil eval design.fig --stdin --write
Documento aperto
Ometti il percorso per eseguire lo script sul documento attivo nell’app desktop.
Output
In un ambiente non interattivo, eval usa JSON per impostazione predefinita. --json lo forza e --quiet o -q nasconde l’output quando viene scritto solo un file.
API compatibile
L’API segue il modello di Figma Plugin API, ma opera su SceneGraph e sui formati OpenPencil. Copre documento, pagine, creazione di oggetti, operazioni sull’albero, componenti, variabili e proprietà comuni.
Gli identificatori esatti come figma.currentPage, createFrame, appendChild, fills, fontSize, layoutMode e strokeWeight restano invariati.
Limiti
Non esistono ancora equivalenti completi per node.exportAsync(), node.setBoundVariable(), figma.combineAsVariants(), gli stili e tutte le operazioni booleane vettoriali.