Compatibilité et distribution

Ces guides ciblent les registres courants React et Vue. Un registre copie les sources dans votre projet ; les fichiers installés déterminent l’API disponible.

Registre courant et versions

Les artefacts courants sont https://table.yayaw.app/r/yayaw-table.json et https://table.yayaw.app/r/yayaw-table-vue.json. Un instantané /r/vX.Y.Z/ reste immuable. Ces guides et leurs aperçus intégrés correspondent à v3.9.2. v3.9.1 et v3.9.2 alignent les deux éditions. En React, une nouvelle recherche, un nouveau filtre ou un nouveau tri repart de la première page, une page au-delà de la dernière passe à la dernière page, et une table démarre dans son columns.order et s’ouvre sur le favori ou la vue par défaut, quel que soit l’ordre de ses définitions. En Vue, un lien garde la page qu’il indique, et précédent et suivant ne rechargent rien quand la requête reste la même. Dans les deux, une table charge sa première page une seule fois et sa vue charge ses données une seule fois. v3.9.0 a ajouté l’éditeur d’écran des tableaux de bord (sections, une fenêtre de widget sur les sources et les blocs de l’hôte, la table réelle comme éditeur de vue, des tables qui rapportent leur vue), l’ordre des vues enregistrées propre à chacun avec un débordement « … », un panneau de facettes à côté des enregistrements, Nouveau dossier et un filtre par dossier dans toutes les vues d’une arborescence, des blocs qui règlent les filtres d’un écran, et des colonnes de tags adossées au catalogue de tags de l’hôte. v3.8.0 a fait des tableaux de bord des écrans (JSON version 2 : sections, tables pleine page, blocs de l’hôte, vues intégrées, textes en plusieurs langues), avec validateDashboard, checkDashboardReferences et dashboardJsonSchema pour les serveurs et les outils d’IA, des sources chargées à la demande, des périodes de dates relatives et des avis de l’hôte ; les filtres de date envoient des jours (AAAA-MM-JJ) depuis. v3.7.0 a ajouté les graphiques en aires, barres et courbe et entonnoir, les langues de formulaire, les questions de consentement et les champs cachés, un éditeur de formulaire presque plein écran, le chargement progressif du Fil, des tableaux de bord sans barres de défilement internes avec comparaisons et courbes de tendance pour les nombres, et les formats de valeur des colonnes partout. v3.6.0 a ajouté les vues Fil, Arborescence, Carte et Tableau de bord ainsi que les colonnes de lieu aux vues Liste, Calendrier, Graphique et Formulaire des versions 3.x précédentes ; v3.1.0 a introduit la consultation de fiches et le Gantt dérivé des lignes, et v3.0.0 précède les deux. La validation des exemples fixe les sources au commit 849e72cd13043083e1691dd2c9489cc653876782, qui est le tag v3.9.2 lui-même : l’instantané et ces exemples sont donc le même build. Revérifiez cette base lors d’une mise à jour des exemples.

Les aperçus installent les éléments principaux et les éléments optionnels yayaw-table-calendar, yayaw-table-chart, yayaw-table-map et yayaw-table-dashboard, ainsi que leurs équivalents Vue yayaw-table-vue-calendar, yayaw-table-vue-chart, yayaw-table-vue-map et yayaw-table-vue-dashboard, depuis l’instantané versionné de la version, public/r/v3.9.2/, à ce commit. Chaque contenu est vérifié par son SHA-256, identique à celui des fichiers de la version v3.9.2. Le composant map de mapcn utilisé par l’élément Carte React provient du même commit. Les aperçus Carte utilisent les styles sans clé d’OpenFreeMap et un worker MapLibre servi par cette documentation.

Depuis v3.7.0, un élément optionnel épinglé dépend du cœur de la même version : /r/v3.9.2/yayaw-table-chart.json installe /r/v3.9.2/yayaw-table.json, et non le cœur le plus récent. Les instantanés jusqu’à v3.6.1 gardent leur contenu. Le cœur React déclare aussi les composants shadcn card et combobox : la CLI shadcn les installe avec la table. Depuis v3.9.0, l’élément tableau de bord de React déclare aussi alert-dialog et command, pour son éditeur.

Les tableaux de bord enregistrés par v3.8.0 sont en version 2, que v3.7.0 et les versions antérieures refusent : mettez à jour tout ce qui lit vos tableaux de bord avant que l’un d’eux n’enregistre un document en version 2. Les règles de date portent des jours depuis v3.8.0 ; un serveur qui sert aussi d’anciens clients continue de lire les instants comme des jours (voir Actions serveur).

Concepts communs, API natives

Dépendances prises en charge

Les registres actuels utilisent TanStack Table 9.2.4 et requièrent un build ESM ciblant ES2022 ou plus récent. Gardez l’adaptateur copié et la dépendance synchronisés. Le package privé du workspace @yayaw/table-vue ne constitue pas un contrat d’installation npm public ; utilisez le registre et les imports locaux du démarrage.

Exemple public Yayaw

L’exemple public de produits et les aperçus intégrés à la documentation utilisent le même commit du registre vérifié indiqué ci-dessus. L’exemple public exécute le composant React copié dans Yayaw, tandis que la documentation construit des copies isolées React et Vue. Mettre à jour le registre seul ne met pas à jour l’exemple public : il faut actualiser les fichiers copiés, préserver les actions de ligne de l’application et déployer Yayaw.

L’exemple de produits présente Table, Kanban et Galerie ; le guide Gantt utilise un jeu de données de planification distinct dans les deux frameworks, et les autres guides de vues partagent un jeu de projets. Les vues enregistrées dans l’exemple anonyme restent dans le stockage local de ce navigateur. Elles ne sont pas stockées en base et ne sont pas partagées entre visiteurs.

Avec Next.js, conservez "use client" avant tout import dans un module client, notamment le hook d’état URL. Vue n’utilise pas cette directive propre à React.