Vues

Une vue détermine comment une table est présentée aux utilisateurs. Elle peut masquer ou réorganiser des champs, filtrer, trier et enregistrer des groupes, et elle détient la configuration qu'un type de vue exige de rendre comme une grille, une planche kanban, un calendrier, un graphique gantt ou une galerie.

Instantané d’une vue

PropriétéTypeDescription
idstringIdentifiant de la vue.
tableIdstringIdentification de la table propriétaire.
namestringNom de la vue.
typeBaseViewTypegrid, kanban, calendar, gantt, gallery, pivot.
fieldOrder?string[]Ordre des champs dans cette vue.
fieldSettings?Record\<string, IViewFieldSetting\>Visibilité, largeur et paramètres de la carte par champ.
filter?`IFilterConfignull`
sort?ISortConfig[]Règles de tri.
group?IGroupConfig[]Règles de regroupement.
configViewSpecificConfigConfiguration spécifique au type de vue.

Types de vues

TypeCas d’usage
gridRévision d'une table en forme de feuille de calcul.
kanbanCartes regroupées selon un champ de sélection, de personne, de groupe, de texte ou de date.
calendarEnregistrements placés par champs de date.
ganttPlanification chronologique à l’aide de champs de date de début et de fin.
galleryMise en page de la carte pour les documents qui sont principalement visuels ou contiennent une grande quantité de contenu.
pivotAgrégations et graphiques via le plugin de tableau de bord.

Créer une vue

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

Configurer le filtrage et le tri

TypeScript
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

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

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.