Personnaliser les grilles

Une grille est une table enfant dans un formulaire, par exemple les articles d'une commande. Vous pouvez ouvrir une ligne en détail et adapter la largeur et la liste des colonnes. Ces réglages sont personnels.

Ouvrir une ligne

Cliquez sur l'icône d'édition au bout d'une ligne, ou placez-vous sur la ligne et appuyez sur Entrée. La ligne s'ouvre dans un panneau flottant au-dessus du formulaire, intitulé « Modification de ligne #n ».

Le panneau propose ces actions :

Redimensionner une colonne

Exemple fictif : un commercial travaille sur une commande de 20 lignes. Il élargit la colonne « Description » pour lire le texte entier. La largeur est gardée pour ses prochaines commandes.

1. Placez le curseur sur le bord droit de l'en-tête de colonne.
2. Faites glisser la poignée jusqu'à la largeur voulue.
3. Relâchez le bouton de la souris.

La largeur est enregistrée tout de suite, pour vous seul.

Choisir les colonnes affichées

1. Cliquez sur l'icône de réglage à droite de l'en-tête de la grille.
2. Dans « Configurer les colonnes », ajoutez, retirez ou réordonnez les champs.
3. Saisissez une largeur en pixels dans la colonne de largeur, si besoin. Dodock la ramène entre 60 et 600 px.
4. Cliquez sur Mettre à jour.

Réinitialiser par défaut revient aux colonnes définies dans le type de document.

Sans réglage personnel, la largeur vient de la propriété « Colonnes » du champ (de 1 à 12, convertie de 60 à 600 px), puis du type de champ.

Masquer des colonnes dans la vue liste d'une grille par script

Exemple — Bureau Moderne Exemple fictif : sur la commande client de Bureau Moderne, la grille des articles affiche par défaut la colonne "Taux unitaire". Un développeur souhaite la masquer uniquement dans cette grille, sans affecter d'autres formulaires utilisant le même type de ligne d'article.

Dans un formulaire Dokos, une grille (table enfant) peut afficher ses lignes sous deux formes : la vue liste (lecture seule, affichage condensé des lignes) et la vue édition (formulaire d'une ligne). Il est parfois utile de masquer une colonne dans la vue liste d'une grille précise, sans impacter les autres grilles qui partagent le même type de document enfant.

frm.fields_dict["nom_de_la_table"].grid.set_column_disp_in_list_view(fieldname, show);

// Dans le script client de la commande client
frappe.ui.form.on("Sales Order", {
    refresh(frm) {
        frm.fields_dict["items"].grid.set_column_disp_in_list_view("rate", false);
    }
});