# Vues

- Human documentation: [https://docs.univer.ai/fr-FR/guides/bases/model/views](https://docs.univer.ai/fr-FR/guides/bases/model/views)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/bases/model/views.md](https://docs.univer.ai/fr-FR/guides/bases/model/views.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

- Source: [bases/model/views.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/model/views.fr-FR.mdx)

---

Les vues décrivent la manière dont une table est présentée aux utilisateurs. Une vue peut masquer ou réorganiser des champs, filtrer, trier et regrouper des enregistrements, ainsi que définir une configuration propre à son type pour un rendu sous forme de grille, de kanban, de calendrier, de diagramme de Gantt ou de galerie.

## Instantané d’une vue

| Propriété      | Type                                  | Description                                                        |                                    |
| -------------- | ------------------------------------- | ------------------------------------------------------------------ | ---------------------------------- |
| id             | `string`                              | Identifiant de la vue.                                             |                                    |
| tableId        | `string`                              | Identifiant de la table à laquelle appartient la vue.              |                                    |
| name           | `string`                              | Nom de la vue.                                                     |                                    |
| type           | `BaseViewType`                        | `grid`, `kanban`, `calendar`, `gantt`, `gallery`, `pivot`.         |                                    |
| fieldOrder?    | `string[]`                            | Ordre des champs dans cette vue.                                   |                                    |
| fieldSettings? | `Record\<string, IViewFieldSetting\>` | Visibilité, largeur et paramètres de carte propres à chaque champ. |                                    |
| filter?        | \`IFilterConfig                       | null\`                                                             | Configuration du filtre de la vue. |
| sort?          | `ISortConfig[]`                       | Règles de tri.                                                     |                                    |
| group?         | `IGroupConfig[]`                      | Règles de regroupement.                                            |                                    |
| config         | `ViewSpecificConfig`                  | Configuration propre au type de vue.                               |                                    |

## Types de vues

| Type       | Cas d’usage                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------- |
| `grid`     | Modification de tables comme dans une feuille de calcul.                                    |
| `kanban`   | Cartes regroupées selon un champ de sélection, de personne, de groupe, de texte ou de date. |
| `calendar` | Enregistrements positionnés selon des champs de date.                                       |
| `gantt`    | Planification chronologique à l’aide de champs de date de début et de fin.                  |
| `gallery`  | Disposition en cartes pour les enregistrements visuels ou riches en contenu.                |
| `pivot`    | Agrégations et graphiques via le plugin de tableau de bord.                                 |

## Créer une vue

```ts
const view = table.createView('Kanban', univerAPI.Enum.BaseViewType.Kanban)
```

## Configurer le filtrage et le tri

```ts
view.setFilter({
  conjunction: univerAPI.Enum.BaseFilterConjunction.AND,
  conditions: [
    {
      fieldId: 'status',
      operator: univerAPI.Enum.BaseFilterOperator.IS,
      operand: 'In progress',
    },
  ],
})

view.setSort([
  { fieldId: 'dueDate', direction: univerAPI.Enum.BaseSortDirection.ASC },
])
```

## Visibilité et largeur des champs

```ts
view.setFieldVisible('internalNotes', false)
view.setFieldWidth('title', 280)
```

[Tableaux de bord et vues pivot](https://docs.univer.ai/fr-FR/guides/bases/features/dashboard.md)