Skripte

openpencil eval führt JavaScript für ein 4B-Pen-Dokument aus und stellt das globale Objekt figma bereit. Der Befehl eignet sich für Massenänderungen, Prüfungen, Testdaten und Automatisierung ohne Editoroberfläche.

Grundlagen

openpencil eval design.fig -c "return figma.currentPage.children.length"

Beginnt der Code nicht mit return, führt 4B Pen ihn in einer asynchronen Funktion aus.

Ändern und speichern

--write schreibt in die Eingabedatei, --output in eine neue Datei. Längere Skripte können über die Standardeingabe gelesen werden.

Geöffnetes Dokument

Ohne Dateipfad wird das aktuelle Dokument der Desktop-App verwendet.

Ausgabe

Nicht interaktive Ausgabe verwendet standardmäßig JSON. --quiet unterdrückt die Ausgabe.

Unterstützte API

Die API orientiert sich an Figma Plugin API und arbeitet mit SceneGraph und dem 4B-Pen-Dateiformat.

Sie umfasst Dokumente und Seiten, Objekterstellung, Baumoperationen, Komponenten, Variablen sowie häufige Eigenschaften für Geometrie, Darstellung, Text, automatische Anordnung und Konturen.

Exakte Namen wie figma.createFrame(), node.appendChild(), fontSize und layoutMode bleiben mit Figma kompatibel.

Noch nicht kompatibel

Noch nicht angeboten werden unter anderem node.exportAsync(), node.setBoundVariable(), figma.combineAsVariants() und die Stil-APIs von Figma.

Dafür stehen je nach Aufgabe CLI-Export, Werkzeuge des Kernpakets oder direkte SceneGraph-Hilfsfunktionen zur Verfügung.