Vues
Une table peut avoir plusieurs vues. Les tâches peuvent être entrées dans une grille et leur état suivi sur un kanban; le changement entre les deux ne copie aucun enregistrement.
Une table, plusieurs vues
Changez le statut du cours Sheets, puis changez de vue. Chaque vue utilise les mêmes enregistrements.
Exemple de parcours · Septembre 2026
| Cours | Statut | Date |
|---|---|---|
| Sheets | Prévu | |
| Docs | En cours | |
| Slides | Terminé | |
| Bases | En cours |
Enregistrements partagés: 4 · Sheets: Prévu
| Affichage | Cas d'utilisation | Configuration principale |
|---|---|---|
Grid | Édition, filtrage et tri des lignes | Champs gelés, hauteur des rangs, largeurs des champs |
Kanban | Groupement par statut ou propriétaire | groupFieldId |
Calendar | Calendrier des dossiers par date | startDateFieldId, date de fin optionnelle |
Gantt | Durée de la planification et dépendances | Dates de début et de fin, champs optionnels de progrès et de dépendance |
Gallery | Affichage d'images et de cartes de contenu | Champs de couverture, de titre et de carte |
Pivot | Résumés et graphiques | Nécessite le plugin tableau de bord |
Les exemples supposent qu'un table existe déjà. Remplacez les identifiants de champs par des champs réels et créez n'importe quelle date ou regroupement de champs avant de configurer la vue qui les utilise.
Créer des vues
const grid = table.createView('All records', univerAPI.Enum.BaseViewType.Grid)const kanban = table.createView( 'By status', univerAPI.Enum.BaseViewType.Kanban, { view: { config: { groupFieldId: 'status' }, }, },)Activer une vue dans l’interface utilisateur
const baseUI = univerAPI.getBaseUI()await baseUI.activateTable(table.getId())await baseUI.activateView(kanban.getId())Configurer les règles d’une vue
kanban.setGroup([ { fieldId: 'status', direction: univerAPI.Enum.BaseSortDirection.ASC },])kanban.setFilter({ conjunction: univerAPI.Enum.BaseFilterConjunction.AND, conditions: [ { fieldId: 'archived', operator: univerAPI.Enum.BaseFilterOperator.IS, operand: false }, ],})Paramètres de champ sur une visibilité de contrôle de vue, largeurs, et affichage de carte. Ils ne changent pas le schéma de table sous-jacent.
Dates du calendrier
const calendar = table.createView('Schedule', univerAPI.Enum.BaseViewType.Calendar, { view: { config: { startDateFieldId: 'startDate', endDateFieldId: 'endDate', mode: 'month' }, },})Un calendrier nécessite un champ de démarrage. Gantt nécessite également un champ de fin de date et prend en charge les jours ouvrables, les progrès et les dépendances. Dans une galerie, card configure le titre et les champs que chaque carte affiche.
Tri et affichage des champs
grid.setSort([{ fieldId: 'priority', direction: univerAPI.Enum.BaseSortDirection.DESC }])grid.setFieldVisible('internalNotes', false)grid.setFieldWidth('title', 280)Les filtres, le tri, le regroupement et l'affichage des champs appartiennent tous à la vue courante. Aucun de ces paramètres ne supprime les enregistrements ou les champs sous-jacents.
Coloration conditionnelle
La règle suivante met en évidence les enregistrements dont la note est supérieure à 80 :
const score = table.addField('Score', univerAPI.Enum.BaseFieldType.Number)grid.setConditionalColorRules([{ id: 'high-score', target: univerAPI.Enum.BaseConditionalColorTarget.ROW, fieldId: score.getId(), operator: univerAPI.Enum.BaseConditionalColorOperator.GREATER_THAN, operand: 80, color: '#dcfce7',}])Les règles prennent la priorité dans l'ordre des tableaux. Passez [] pour effacer toutes les règles. La cible peut être une cellule, une ligne ou une colonne; colorer une colonne est inconditionnelle.
Que pensez-vous de ce guide ?