Skip to content

The open alternative to Salesforce, designed for AI.

5.9 KB
Raw Blame
---
title: Panoramica
description: "Inserisci la tua app all'interno dell'interfaccia utente di Twenty: voci della barra laterale, viste salvate, schede nella pagina di dettaglio dei record e componenti React isolati."
---

import { PageBanner } from "/snippets/page-banner.mdx"
import { CardTitle } from "/snippets/card-title.mdx"

## Cosa copre il livello di disposizione

Il **livello di layout** di un'app Twenty è tutto ciò che l'utente vede: dove l'app viene visualizzata nella barra laterale, quali viste elenco fornisce, come sono organizzate le sue pagine di dettaglio dei record e quali componenti React personalizzati vengono renderizzati all'interno di quelle pagine.

```text
   Sidebar               Record list            Record detail page
   ───────               ───────────            ──────────────────
   [📋 My View]    ────▶ ┌──────────┐          ┌─────────────────────┐
   [📋 Drafts ]          │ Companies│          │ Tabs: [Overview ]   │
   [📋 Inbox  ]          │ ──────── │          │       [Notes    ]   │
        ▲                │  Apple   │          │       [Hello    ]◀──── definePageLayoutTab
        │                │  Acme    │          │                     │   adds a tab...
        └ defineNavi-    │  …       │          │  ┌────────────────┐ │
          gationMenu-    └────▲─────┘          │  │                │ │
          Item points         │                │  │   React UI     │◀── …with a
          to a defineView     │                │  │  (sandboxed in │ │   defineFrontComponent
                              └ defineView     │  │   a Worker)    │ │   widget inside
                                picks columns  │  └────────────────┘ │
                                and filters    └─────────────────────┘
```

## In questa sezione

<CardGroup cols={2} className="documentation-card-group">
  <Card href="/it/developers/extend/apps/layout/views" img="/images/documentation/section-overview-icons-v1/views-pipelines.svg">
    <CardTitle>Visualizzazioni</CardTitle>
    `defineView` — configurazioni dell'elenco salvato: colonne visibili, filtri, gruppi.
  </Card>
  <Card href="/it/developers/extend/apps/layout/navigation-menu-items" img="/images/user-guide/halftone/card-page-navigation.svg">
    <CardTitle>voci del menu di navigazione</CardTitle>
    `defineNavigationMenuItem` — voci della barra laterale che puntano a viste o URL esterni.
  </Card>
  <Card href="/it/developers/extend/apps/layout/page-layouts" img="/images/user-guide/halftone/card-page-page-layouts.svg">
    <CardTitle>Page Layouts</CardTitle>
    `definePageLayout`, `definePageLayoutTab` e `definePageLayoutWidget` — schede e widget nella pagina di dettaglio di un record.
  </Card>
  <Card href="/it/developers/extend/apps/layout/front-components" img="/images/user-guide/halftone/card-page-front-components.svg">
    Componenti <CardTitle>Front</CardTitle>
    `defineFrontComponent` — componenti React sandboxed che rendono all'interno di Venti.
  </Card>
  <Card href="/it/developers/extend/apps/layout/command-menu-items" img="/images/user-guide/halftone/card-page-command-menu.svg">
    <CardTitle>Elementi del menu dei comandi</CardTitle>
    `defineCommandMenuItem` — registra i componenti frontali come voci Cmd+K e azioni rapide.
  </Card>
</CardGroup>

## Dove viene visualizzata l'app

| Superficie                                      | Cosa controlla                                                                            | Entità                                                              |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Barra laterale**                              | Una voce personalizzata che collega a una vista salvata o a un URL esterno                | `defineNavigationMenuItem`                                          |
| **Elenco record**                               | Una configurazione salvata per un oggetto — colonne visibili, ordine, filtri, gruppi      | `defineView`                                                        |
| **Pagina di dettaglio del record**              | Le schede e i widget nella pagina di un record (del tuo oggetto o di un oggetto standard) | `definePageLayout`, `definePageLayoutTab`, `definePageLayoutWidget` |
| **All'interno di uno qualsiasi dei precedenti** | Un widget React personalizzato: pulsanti, moduli, dashboard, integrazioni                 | `defineFrontComponent`                                              |
| **Impostazioni dell'app**                       | Una voce nel menu delle impostazioni dell'app; dichiarane quante ne occorrono             | `defineSettingsMenuItem`                                            |
| **Menu comandi (Cmd+K)**                        | Un'azione rapida fissata o un comando nascosto                                            | `defineCommandMenuItem`                                             |

I componenti front-end vengono eseguiti all'interno di un Web Worker isolato usando Remote DOM: vengono renderizzati in modo nativo nella pagina (non all'interno di un iframe), ma non possono accedere direttamente alla pagina host o al DOM. La comunicazione con Twenty avviene tramite un'API host basata sul passaggio di messaggi.

Sono ancora in fase di sviluppo attivo: la sandbox implementa un DOM parziale, quindi gli usi avanzati possono non funzionare. Vedi [Limitazioni attuali](/it/developers/extend/apps/layout/front-components#current-limitations).

<PageBanner illustration="section-apps-layout" />