openpencil/packages/docs/it/user-guide/components.md
Danila Poyarkov d67415c793
docs: explain component library workflows (#520)
Documents component libraries and localized workflows added by #512.
2026-08-14 20:39:47 +03:00

3.8 KiB

title description
Componenti Componenti riutilizzabili, istanze, override e sincronizzazione live in OpenPencil.

Componenti

I componenti sono elementi di design riutilizzabili. Le modifiche al componente principale aggiornano automaticamente le istanze.

Esplorare i componenti

Apri la scheda Assets nel pannello sinistro per esplorare componenti locali e librerie abilitate. Cerca per nome, passa tra griglia ed elenco e inserisci con un clic, Invio o trascinamento. Le revisioni scaricate restano disponibili offline.

Creare un componente

⌥⌘K (Ctrl + Alt + K) — converte la selezione in un componente riutilizzabile. I componenti mostrano un'etichetta viola con icona a diamante.

Set di componenti e varianti

⇧⌘K — combina 2+ componenti in un set con bordo tratteggiato viola.

Le varianti supportano più dimensioni, ad esempio Dimensione=Piccola, Stato=Hover e Tema=Scuro, senza richiedere tutte le combinazioni. La variante in alto a sinistra è predefinita e viene usata come fallback quando un aggiornamento non contiene più una corrispondenza esatta. Nel pannello delle proprietà puoi aggiungere, rinominare, riordinare e rimuovere dimensioni e valori; le combinazioni duplicate vengono rifiutate.

Proprietà dei componenti

I componenti supportano proprietà di testo, visibilità booleana e scambio di istanza. Collega una proprietà a un campo discendente, quindi modifica il valore di un'istanza senza separarla. Definizioni e assegnazioni vengono conservate nei file .fig.

Librerie di componenti

Una libreria pubblica componenti come revisione immutabile. Apri Assets → Gestisci librerie → Pubblica libreria, imposta un ID stabile e un nome alla prima pubblicazione, seleziona le modifiche e pubblica. Le modifiche non selezionate restano in sospeso.

Abilita una libreria da Gestisci librerie. I suoi asset appaiono accanto ai componenti locali. Le definizioni pubblicate sono in sola lettura nel documento che le usa, mentre istanze collegate e override restano modificabili.

In Aggiornamenti, confronta affiancate l'istanza corrente e quella nuova. Aggiorna una singola istanza, tutte le istanze di un asset, la pagina corrente o tutte le pagine. Le proprietà compatibili vengono mantenute e, se manca una variante esatta, il fallback viene mostrato prima della conferma. Gli aggiornamenti supportano annulla/ripristina.

Le librerie possono usare il catalogo locale o un provider di archiviazione configurato. Le revisioni scaricate vengono memorizzate nella cache. I collegamenti abilitati e le definizioni materializzate vengono salvati in .fig, quindi il documento può essere riaperto senza accesso alla libreria remota.

Creare istanze

Clic destro → Crea istanza. Appare 40 px a destra.

Separare un'istanza

⌥⌘B — diventa un frame senza collegamento.

Sincronizzazione live

Modificare un componente aggiorna tutte le istanze. Proprietà sincronizzate: dimensioni, riempimenti, contorni, effetti, opacità, raggi angoli, layout.

Override

Le istanze possono sovrascrivere proprietà specifiche senza rompere il collegamento. Proprietà sovrascrivibili: nome, testo, fontSize, fontWeight, fontFamily e proprietà visuali/layout.

Selezione

Un clic seleziona il componente. Doppio clic per entrare e selezionare i figli.

Azione Mac Windows / Linux
Crea componente ⌥⌘K Ctrl + Alt + K
Crea set ⇧⌘K Shift + Ctrl + K
Separa istanza ⌥⌘B Ctrl + Alt + B