Édition en cellule
Modifier une cellule typée avec validation et action de mise à jour.
L’édition en cellule évite d’ouvrir un formulaire pour chaque petite modification. Activez-la sur les champs disposant d’un éditeur clair et d’un contrat de modification partielle adapté.
Exemple de configuration
Partez du démarrage React ou du démarrage Vue. Le fichier suivant complète leur catalogue de produits. Passez cette configuration via getTableConfig en React ou config en Vue.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const stockConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) =>
column.id === "stock"
? {
...column,
inlineEdit: { enabled: true, editor: "number" },
defaultCalculation: "sum",
}
: column
),
},
table: {
...productConfig.table,
allowInlineEdit: true,
allowEdit: true,
enableCalculations: true,
inlineEdit: { enabled: true, debounceMs: 400, optimistic: true },
rowClickMode: "none",
},
});import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const stockConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) =>
column.id === "stock"
? {
...column,
inlineEdit: { enabled: true, editor: "number" },
defaultCalculation: "sum",
}
: column
),
},
table: {
...productConfig.table,
allowInlineEdit: true,
allowEdit: true,
enableCalculations: true,
inlineEdit: { enabled: true, debounceMs: 400, optimistic: true },
rowClickMode: "none",
},
});Brancher validation et enregistrement
Fournissez getFormConfig avec le schéma du champ et getTableActions avec update. Le stock doit refuser nombres négatifs et fractions dans le formulaire et lors de l’écriture. fieldErrors associe les erreurs serveur aux noms de champs. La recette stock contient l’adaptateur et le schéma complets.
Comportement de l’éditeur
Un clic n’importe où dans la cellule, ou Entrée, démarre l’édition prise en charge ; un lien affiché dans la cellule reste un lien. editor permet de choisir texte, nombre, sélection simple ou multiple, booléen, date, JSON ou URL. formField relie une colonne à un champ de formulaire portant un autre nom. Les colonnes en lecture seule restent protégées lorsque l’édition globale est activée.
Une case à cocher bascule dès ce premier clic et enregistre la nouvelle valeur : un seul clic la coche ou la décoche. En React, l’interrupteur reste ensuite ouvert jusqu’au délai d’enregistrement automatique ou à la fermeture ; en Vue, l’enregistrement est immédiat, comme avec sa case à cocher.
Les éditeurs de cellule à sélection simple locale de React et Vue utilisent le menu Select du thème. Les réglages des propriétés de tri et de regroupement de Vue utilisent aussi ces contrôles Select. Un clic sur la cellule ou Entrée ouvre aussitôt la liste. Choisir une option conserve le type de sa valeur et l’enregistre une seule fois ; Échap annule l’édition. Vue réutilise le Select des formulaires, fondé sur les primitives Reka utilisées par shadcn-vue, au lieu d’un menu du système. Aucune dépendance ni configuration consommateur supplémentaire n’est nécessaire.
Un champ de formulaire select ou multiSelect doté de searchOptions s’édite lui aussi dans la cellule : à partir de searchMinLength caractères saisis, la recherche serveur part après searchDebounceMs, et la liste affiche ses résultats même quand leur libellé ne contient pas le texte saisi. Choisir une valeur enregistre aussitôt une sélection simple ; une sélection multiple ajoute une puce et enregistre à la fermeture. Les choix trouvés gardent leur libellé et leur type d’origine, resolveOptions nomme les valeurs actuelles à l’ouverture de l’éditeur, et une recherche en échec affiche son message dans la liste sans perdre le brouillon. Les autres types de champ dotés de searchOptions ouvrent toujours le formulaire complet.
Quand le champ a aussi createOption, une recherche qui ne correspond à aucune option existante (sans tenir compte de la casse) termine la liste par Créer « {label} » (inline.create_option). La choisir appelle createOption(label, context, signal) avec le texte saisi, et l’option renvoyée doit porter une valeur enregistrée : une sélection multiple l’ajoute en puce et reste ouverte, une sélection simple l’enregistre aussitôt. L’éditeur reste ouvert pendant la création, si bien que createOption peut ouvrir votre propre formulaire et se résoudre avec l’enregistrement créé ; une création en échec affiche son message dans la liste sans perdre le brouillon.
Les cellules éditables le montrent avant le clic. Au survol, le curseur devient une main et la cellule prend l’aspect d’un champ, avec le fond de la page et une fine bordure intérieure, par-dessus la teinte de la ligne, et une infobulle indique « Cliquez ou appuyez sur Entrée pour modifier » (inline.edit_hint). Au survol ou au focus clavier, la cellule affiche aussi une icône propre à son éditeur (inlineEditorIcon), dans une petite pastille posée sur sa fin (son début pour les nombres alignés à droite), sans changer sa taille : un crayon pour le texte, des lignes pour le texte long, un chevron pour la sélection simple, une liste cochée pour la sélection multiple, une étiquette pour les colonnes de tags, # pour les nombres, un calendrier pour les dates (avec une horloge pour date et heure), un lien pour les URL, un repère pour les lieux et des accolades pour le JSON. Les cases à cocher n’en ont pas, et une cellule avec des actions de cellule affiche ses actions à la place. Les cellules en lecture seule gardent la simple teinte de la ligne, et rien ne s’affiche pendant l’édition.
Éviter les gestes concurrents
Désactivez l’ouverture du formulaire au clic lorsque le clic sert à éditer une cellule ou ouvrir un lien. Les mises à jour optimistes restent provisoires jusqu’au succès de l’action. Testez un refus d’enregistrement et vérifiez le retour à la dernière valeur confirmée dans l’interface et le cache.
Activer une seule colonne éditable
Exposez un éditeur numérique inline pour Prix. Réutilisez productForm et editableActions : zéro est accepté, les prix négatifs sont refusés par le schéma et le stockage.
Copiez cette configuration complète à côté de product-config.ts. Utilisez () => exampleConfig pour getTableConfig en React, ou :config="exampleConfig" en Vue.
Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) =>
column.id === "price"
? { ...column, inlineEdit: { enabled: true, editor: "number" } }
: column
),
},
table: {
...productConfig.table,
allowEdit: true,
allowInlineEdit: true,
rowClickMode: "none",
},
});Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) =>
column.id === "price"
? { ...column, inlineEdit: { enabled: true, editor: "number" } }
: column
),
},
table: {
...productConfig.table,
allowEdit: true,
allowInlineEdit: true,
rowClickMode: "none",
},
});Protéger les produits archivés
Utilisez le prédicat de ligne pour l’interface et répétez l’autorisation dans l’action de modification. Masquer un éditeur ne sécurise pas le serveur.
Copiez cette configuration complète à côté de product-config.ts. Utilisez () => exampleConfig pour getTableConfig en React, ou :config="exampleConfig" en Vue.
Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) => ({
...column,
inlineEdit: column.id === "stock",
})),
},
table: {
...productConfig.table,
allowEdit: true,
allowInlineEdit: true,
canEditRow: (row) => row.status !== "archived",
rowClickMode: "none",
},
});Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
columns: {
...productConfig.columns,
definitions: productConfig.columns.definitions.map((column) => ({
...column,
inlineEdit: column.id === "stock",
})),
},
table: {
...productConfig.table,
allowEdit: true,
allowInlineEdit: true,
canEditRow: (row) => row.status !== "archived",
rowClickMode: "none",
},
});