Skip to content

AI-native design editor. Open-source Figma alternative.

1.7 KB
Raw Blame

title: Scripting description: 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.setBoundVariable(), figma.combineAsVariants() e tutte le operazioni booleane vettoriali.