openpencil/packages/docs/fr/programmable/cli/inspecting.md
2026-05-29 15:56:52 +03:00

2.1 KiB

title description
Inspecter des fichiers Parcourez les arborescences de nœuds, recherchez par nom ou type, et examinez les propriétés depuis le terminal.

Inspecter des fichiers

Le CLI vous permet d'explorer des fichiers .fig sans ouvrir l'éditeur. Chaque commande fonctionne aussi sur l'application en cours d'exécution — il suffit d'omettre l'argument fichier.

::: tip Installation

npm install -g @open-pencil/cli
# ou
brew install open-pencil/tap/open-pencil

:::

Informations sur le document

Obtenez un aperçu rapide — nombre de pages, nombre total de nœuds, polices utilisées, taille du fichier :

openpencil info design.fig

Arborescence des nœuds

Affichez la hiérarchie complète des nœuds :

openpencil tree design.fig
[0] [page] "Getting started" (0:46566)
  [0] [section] "" (0:46567)
    [0] [frame] "Body" (0:46568)
      [0] [frame] "Introduction" (0:46569)
        [0] [frame] "Introduction Card" (0:46570)
          [0] [frame] "Guidance" (0:46571)

Trouver des nœuds

Rechercher par type :

openpencil find design.fig --type TEXT

Rechercher par nom :

openpencil find design.fig --name "Button"

Les deux options peuvent être combinées pour affiner les résultats.

Détails d'un nœud

Inspectez toutes les propriétés d'un nœud spécifique par son identifiant :

openpencil node design.fig --id 1:23

Pages

Listez toutes les pages du document :

openpencil pages design.fig

Variables

Listez les variables de design et leurs collections :

openpencil variables design.fig

Mode application en direct

Quand l'application de bureau est en cours d'exécution, omettez l'argument fichier — le CLI se connecte via RPC et opère sur le canevas en direct :

openpencil tree              # inspecter le document en direct
openpencil eval -c "..."     # interroger l'éditeur

Sortie JSON

Toutes les commandes supportent --json pour une sortie lisible par machine — redirigez vers jq, alimentez des scripts CI, ou traitez avec d'autres outils :

openpencil tree design.fig --json | jq '.[] | .name'