> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti.md).

# I componenti

I componenti sono i mattoncini con cui costruiamo i servizi digitali. La UI dei componenti (la grafica e il comportamento) segue lo [UI kit di Designers Italia](https://github.com/italia/design-ui-kit).

Nei paragrafi successivi trovi un elenco dei campi più utilizzati durante la creazione o la modifica di un servizio digitale.

## Usare il service builder

Per procedere alla modifica del modulo di un servizio digitale, accedi alla scheda "Modulo".

<figure><img src="/files/Js6ilmwe0LxgEsqa369w" alt=""><figcaption></figcaption></figure>

In questa sezione, sulla sinistra, trovi un elenco di componenti che puoi utilizzare per modifiare il modulo del servizio.

<figure><img src="/files/TBFiFqYhvPXggYIKBapb" alt=""><figcaption></figcaption></figure>

Per inserire un componente, trascinalo dall'elenco all'interno del modulo.

<figure><img src="/files/zsFcZXVEucrM1tGBkNJp" alt=""><figcaption></figcaption></figure>

## Tipi di componenti

### Componenti di layout

Organizzano e strutturano il modulo senza raccogliere dati direttamente:

* [Nested form](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form.md) — raggruppa dati in classi standard riutilizzabili;
* [Elementi](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/gli-elementi.md) — crea sezioni e contenitori per ordinare i campi;
* [Columns](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-columns.md) — dispone i campi su più colonne affiancate;
* [Datagrid](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-datagrid.md) — permette di ripetere un insieme di campi più volte;
* [HTML](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/lhtml.md) — inserisce testo o contenuto statico nel modulo;
* [Page break](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-page-break.md) — inserisce un'interruzione di pagina nel PDF del modulo.

### Componenti di raccolta dati

Raccolgono le informazioni inserite dal cittadino:

* [Textfield](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-textfield.md) — campo di testo libero;
* [Select](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/la-select.md) — selezione da un elenco a discesa;
* [Select boxes e radio button](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/impostare-le-scelte-utente-select-boxes-e-radio-button.md) — scelta singola o multipla tra opzioni predefinite;
* [Date](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/le-date.md) — selezione di una data;
* [File SDC](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/inserire-allegati-il-file-sdc.md) — caricamento di allegati;
* [Address](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/geo-localizzare-una-pratica-il-componente-address.md) — inserimento e geo-localizzazione di un indirizzo;
* [Oggetto della pratica](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/loggetto-della-pratica.md) — imposta il titolo identificativo della pratica.

## Componenti standard

La creazione dei servizi avviene con un modello a componenti, basati su classi dati. Tutti i servizi possono utilizzare la [libreria di componenti standard (*Nested form*)](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form.md), con i relativi vantaggi, tra cui la realizzazione del principio del *once only*.

## Componenti custom

Nonostante il vantaggio nell'utilizzo di componenti standard, la piattaforma consente di di creare facilmente componenti custom per raccogliere diversi tipi di dati, da riutilizzare eventualmente anche per altri servizi.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencityitalia.it/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.