---
title: "Componenti e variabili | Kalka docs"
description: "Componenti riutilizzabili con varianti e proprietà, la pagina Variabili con raccolte e modalità, e come le variabili diventano proprietà personalizzate CSS e design token."
url: https://kalka.design/it/docs/components-variables
language: it
---

## Componenti

Un componente è un design che riutilizzi: un pulsante, una card, una barra di navigazione. Le sue copie, chiamate istanze, lo seguono. Modifica il componente e tutte le istanze cambiano, tranne ciò che un’istanza sovrascrive.

- **Crea componente:** seleziona dei livelli e premi Cmd Alt K (Ctrl Alt K).

- **Crea un’istanza:** trascina il componente dal pannello **Risorse** sul canvas, oppure usa **Inserisci istanza** in quel pannello.

- **Vai al componente principale** passa da un’istanza al suo componente.

- **Scollega istanza** (Cmd Alt B, Ctrl Alt B) trasforma di nuovo un’istanza in semplici livelli.

Il pannello **Risorse** elenca i componenti del documento, a griglia o a elenco, con una ricerca.

## Varianti

Le varianti sono versioni di uno stesso componente, come un pulsante primario o secondario, piccolo o grande. Seleziona più componenti e usa **Crea set di componenti** (Shift Cmd K, Ctrl Shift K), poi aggiungi le proprietà di variante e i loro valori. Ogni variante deve avere una sua combinazione di valori. Su un’istanza, cambi variante dal pannello Design.

## Proprietà del componente

Oltre alle varianti, un componente può esporre:

- proprietà **Testo**, per cambiare un’etichetta su ogni istanza;

- proprietà **Booleano**, per mostrare o nascondere una parte;

- proprietà **Scambio di istanza**, per sostituire un componente annidato, come un’icona;

- **slot**, aree in cui ogni istanza riceve i propri livelli, con un limite sul numero.

Creane una con **Crea proprietà…** nel pannello Design, oppure da un campo con **Applica proprietà del componente**. Le istanze mostrano queste proprietà in cima al pannello Design.

## Comportamenti

Un componente può comportarsi come un vero controllo: un interruttore, una casella di controllo, uno slider, delle schede, un campo di testo, una fisarmonica, un pulsante con gli stati hover, premuto, focus e disattivato, e altro. Sceglilo nella sezione **Comportamento** del componente. **Visualizza › Anteprima** (Cmd Alt Enter) fa poi funzionare davvero i controlli: puoi scrivere in un campo di testo, trascinare uno slider, aprire una fisarmonica, anche da tastiera. Mentre li provi, nel documento non cambia nulla; Esc torna alla modifica.

## Librerie

Per condividere componenti tra documenti, pubblica un documento come libreria con **Pubblica libreria**, poi attivala in un altro documento con **Gestire le librerie**. Quando la libreria cambia, **Esamina gli aggiornamenti della libreria** mostra cosa è cambiato, affiancato o in sovrapposizione, prima che tu aggiorni.

## Variabili

Le variabili sono valori con un nome che riutilizzi: un colore del brand, una spaziatura, una dimensione del font, un’etichetta. Modifica la variabile e ogni livello che la usa la segue.

### Aprire la pagina Variabili

Fai clic su **Variabili** nella barra laterale sinistra. Nell’editor desktop, la pagina Variabili si apre sopra i pannelli e il canvas. Premi di nuovo **Variabili**, scegli un altro pannello o premi Esc per ritrovare il canvas com’era. Puoi aprirla anche con **Visualizza › Variabili…**, oppure con **Apri variabili** nel pannello Design quando non è selezionato nulla. Sullo schermo di un telefono si apre in una finestra di dialogo.

_La pagina Variabili con una raccolta Tokens: variabili di colore, spaziatura e raggio con valori Light e Dark, i loro nomi CSS e il foglio di stile generato sotto_

La pagina Variabili: ogni variabile con il suo nome CSS e un valore per modalità, e il foglio di stile che scrive Kalka.

### Tipi

| Tipo | Per |
| --- | --- |
| Colore | riempimenti, contorni, colori delle ombre |
| Numero | dimensioni, spaziature, raggi, opacità, dimensioni dei font |
| Testo | etichette, testi, famiglie di font |
| Booleano | vero o falso, per esempio per mostrare un livello |

Una variabile può essere limitata ad alcuni campi con i suoi **ambiti**, così una spaziatura non compare mai in un elenco di colori. La sua **espressione CSS** le permette di contenere nel codice qualcosa come `clamp(1rem, 4vw, 1.5rem)`.

### Raccolte e modalità

Le variabili stanno in **raccolte**, come Colori o Spaziature, e si possono ordinare in gruppi. Una raccolta può avere delle **modalità**: chiara e scura, compatta e comoda, una per brand. Ogni variabile ha un valore per modalità.

Ogni modalità dice quando si applica nel CSS esportato:

- attivata a mano, con un attributo come `data-theme`;

- quando il sistema è in modalità scura o chiara;

- con il contrasto elevato o la riduzione del movimento;

- sotto o sopra una larghezza dello schermo, o di un contenitore;

- oppure sotto qualsiasi selettore CSS o query `@media`, `@supports` o `@container` che scrivi tu.

### Usare una variabile

Accanto a un campo, fai clic su **Usa una variabile** e scegline una dal piccolo elenco; passando il mouse su una variabile di colore o numerica ne vedi l’anteprima sul canvas. **Scollega variabile** rimette un valore semplice. Da un valore già impostato, **Crea variabile colore** o **Crea variabile numerica** lo trasforma in variabile in un solo passaggio.

## Le variabili nel codice

Le variabili sono proprietà personalizzate CSS. La modalità predefinita di ogni raccolta viene scritta in `:root`, e le altre modalità sovrascrivono solo i valori che cambiano, sotto la loro condizione. Una variabile chiamata `Gray/50` diventa `--color-gray-50`, e `Space/small` diventa `--spacing-small`; puoi impostare un tuo nome CSS.

Dalla pagina Variabili puoi:

- **Copia tutte le variabili come CSS**, oppure **come tema Tailwind** (`@theme`);

- **Esporta come design token:** un `.zip` di design token W3C, un file per ogni modalità di raccolta;

- **Importa design token** da file `.json`, `.tokens` o `.zip`. Le variabili con lo stesso nome vengono aggiornate; non viene eliminato nulla.

In una cartella Kalka, le variabili vengono salvate come design token W3C in `design-system/tokens.json`, e come CSS in `design-system/tokens.css`. Vedi [File e versioni](https://kalka.design/it/docs/files-versions).
