Mettre à jour le code copié
Intégrer les évolutions en préservant vos adaptations locales.
Traitez une mise à jour du registre comme une modification de sources. Enregistrez vos fichiers actuels, inspectez le diff puis vérifiez le comportement intégré dans votre application.
Ordre de mise à jour
Identifiez l’utilisation du registre courant ou d’un instantané.
Lisez le changelog et le diff du registre.
Mettez à jour sources et dépendances ensemble.
Réconciliez explicitement les personnalisations.
Vérifiez les types, la recherche, les mutations, les vues et les exports.
Notez la version ou le commit installé pour la prochaine mise à jour.
Points de compatibilité connus
TanStack Table 9 remplace les API internes v8 ; importez les types liés au tableau via l’adaptateur copié lors d’une extension. Yayaw continue de sérialiser left et right pour l’épinglage alors que le moteur v9 utilise start et end. Fournissez le QueryClient partagé requis par React. Actualisez les styles Vue avec les composants et installez les nouvelles dépendances Shadcn comme Empty.
Préserver les états enregistrés
Changer un libellé conserve la compatibilité lorsque l’identifiant de colonne reste stable. Renommer ou supprimer cet identifiant impose de vérifier filtres, ordre, groupement et réglages des cartes qui le référencent. Gardez les données sérialisables des vues distinctes du code de rendu. Consultez la compatibilité avant d’utiliser des exemples d’une distribution plus récente.
Le clic sur une ligne ouvre désormais la vue enregistrement
Avec rowClickMode: 'default' (la valeur par défaut), un clic sur une ligne ouvre désormais la vue enregistrement dans tous les modes d’affichage, au lieu de ne rien faire quand aucune édition, aucun lien ni aucun gestionnaire onRowActivate n’était configuré. Les applications qui comptaient sur l’absence d’effet d’un simple clic doivent passer details={false} (:details="false" en Vue) et omettre onOpenDetails/onRowActivate, ou définir rowClickMode: 'none', pour conserver des clics inertes après la mise à jour.
Les règles de date portent des jours (v3.8.0)
FilterValues<"date"> vaut désormais CalendarDay | [CalendarDay, CalendarDay], où CalendarDay est une chaîne AAAA-MM-JJ, au lieu de Date | [Date, Date]. DateFilter et CompactDateFilter appellent onValueChange avec des jours et lisent toujours les anciennes valeurs, DateRangeShortcuts appelle onSelect avec des jours, et getDefaultFilterValue retourne le jour courant. Le code qui construit des règles de date avec des objets Date doit passer des jours à la place ; les anciennes valeurs Date sont toujours lues comme les jours du lecteur. Sur votre serveur, comparez des jours comme le décrit Règles de date, et faites passer les règles enregistrées par normalizeDateFilterRules là où aucun navigateur ne les lit d’abord.
Les tableaux de bord passent en version 2 (v3.8.0)
Dashboard est désormais le JSON en version 2 : des sections placent ses widgets. Typez les littéraux en version 1 avec DashboardV1 (ou unknown lorsqu’ils viennent du stockage) ; dashboard.layout est désormais le layout d’une section en grille ; applyGridLayout(section, items) prend une section, et applyDashboardSectionLayout(dashboard, sectionId, items) modifie un document. validateDashboard retourne ok et migratedFrom, et chaque problème a une severity et un path. Les documents en version 1 enregistrés se chargent toujours et sont enregistrés en version 2, que v3.7.0 refuse : mettez d’abord à jour tout ce qui lit vos tableaux de bord. Le name d’un bloc est désormais son label, et DashboardBlockDefinition devient DashboardBlockSchema. Voir Tableau de bord.
Ordre des vues et débordement « … » (v3.9.0)
Chaque personne peut ordonner ses vues enregistrées ; voir Ordre des vues. TableViewActions.list répond désormais TableViewListResult ({ data, order? }), et l’action facultative setOrder garde l’ordre sur votre serveur ; sans elle, l’ordre reste dans le navigateur. createLocalTableViewActions() retourne LocalTableViewActions, sans setOrder : le code qui la typait en Required<TableViewActions> utilise le nouveau type. Le débordement des onglets est désormais un bouton à icône nommé views.more (Vue moreViews) : traduisez-le par « Plus de vues ». Les nouvelles clés sont listées dans Traductions des onglets de vues.
L’éditeur d’écran (v3.9.0)
La fenêtre de widget du tableau de bord remplace AddWidgetDialog en React (dashboard-dialogs.tsx) et DashboardAddWidget.vue en Vue. addDashboardWidget et moveWidgetToSection prennent blocks, pour qu’un bloc arrive là où son placement le permet. ToolbarActionContext gagne getViewConfig(), et DashboardBlockProps gagne setFilter et filterRules : le code qui construit l’un ou l’autre lui-même, comme un test, les ajoute. L’élément tableau de bord de React installe désormais les composants shadcn alert-dialog et command. Voir Modifier un écran.
Pages, premier chargement et ordre des colonnes (v3.9.1, v3.9.2)
Aucune API ne disparaît, mais vérifiez trois contrats. Votre action list répond à une page au-delà de la dernière avec meta.totalCount et meta.pageCount et aucune ligne, pas une erreur : la table passe alors à la dernière page que donnent ces comptes (voir La page affichée). Un mode d’affichage personnalisé charge ses données au montage, puis de nouveau quand revision ou la requête de listParams change : React le monte une seule fois, avec la première page, et lui passe les mêmes rows tant que les données ne changent pas ; en Vue, revision ne bouge plus pendant le chargement de la première page. L’option getRowId de useTableUrlData est ignorée en React : les lignes gardent l’ordre que renvoie list, et {tableId}-order ne contient que l’ordre des colonnes.
Une table React démarre désormais dans son columns.order, comme en Vue, et n’écrit aucun ordre de colonnes d’elle-même dans l’URL : seuls le déplacement d’une colonne ou l’application d’une vue en écrivent un. Une table dont le columns.order diffère de ses définitions affiche ses colonnes dans cet ordre et s’ouvre sur le favori ou une vue isDefault (voir État URL) ; le menu Propriétés et l’export groupé suivent le même ordre. Appliquer une vue enregistrée ou masquer une colonne ne remonte plus la table React.
Le menu de filtre remplace le panneau de filtres et les presets (v3.26.0)
Les filtres s’ajoutent depuis l’écran Filtre des Réglages de la vue : le bouton Filtre séparé de la barre d’outils disparaît, et les menus de colonnes ouvrent toujours la règle de leur colonne (voir Le menu de filtre). React ne fournit plus AdvancedFilterPanel, EnhancedFilterChip, FilterPresetsPanel, ModernAddFilterDropdown, les filtres par type (TextFilter, NumberFilter, DateFilter, SelectFilter, MultiSelectFilter, FilterValueInput, AdvancedFacetedFilter) ni useFilterPresets, et Vue ne fournit plus AdvancedFilters ni FilterRule. Les presets de filtres sont remplacés par les vues enregistrées : enregistrez une vue filtrée plutôt qu’un preset. Supprimez les imports locaux de ces fichiers en rafraîchissant le code copié ; aucune clé de configuration ne disparaît, et les filtres, vues et URL enregistrés continuent de fonctionner. Les clés de traduction filters.presets.*, filters.add_menu.*, filters.faceted.* et filters.date_shortcuts.* ne sont plus lues ; le menu de filtre lit filters.menu.* à la place (voir Traductions).
Le choix de densité est un groupe radio (un seul arrêt de tabulation, les flèches changent le choix), et le mode d’affichage ouvre un écran de tuiles de mise en page (voir Réglages de vue). Les scripts qui cliquaient un bouton de densité ou choisissaient un mode dans une liste déroulante doivent sélectionner le bouton radio ou la tuile.