Personnaliser les grilles

Les grilles dans Dokos (tables enfants dans les formulaires) offrent plusieurs options de personnalisation pour améliorer votre productivité et adapter l'affichage à vos besoins.

Ouvrir les lignes dans un panneau latéral

Les lignes de grille s'ouvrent désormais dans un panneau latéral fixe qui glisse depuis la droite de l'écran. Ce changement offre plusieurs avantages :

• Contexte préservé : Le document principal reste visible en arrière-plan.
• Navigation fluide : Utilisez les boutons Précédent et Suivant pour naviguer entre les lignes sans fermer le panneau.
• Fermeture intuitive : Cliquez en dehors du panneau ou appuyez sur Échap pour le fermer.

Redimensionner les colonnes

Exemple — Maison Verte SARL Un commercial de Maison Verte SARL travaille sur un bon de commande contenant 20 lignes d'articles. Il ajuste la largeur de la colonne "Description" pour afficher le texte complet sans troncature, et cette préférence est sauvegardée pour ses futures sessions.

Vous pouvez désormais ajuster la largeur des colonnes directement depuis l'interface utilisateur :

1. Positionnez le curseur sur le bord droit de l'en-tête de colonne.
2. Une poignée de redimensionnement apparaît.
3. Cliquez et faites glisser pour ajuster la largeur.
4. Relâchez : la nouvelle largeur est automatiquement sauvegardée pour votre utilisateur.

      
flowchart LR
    A[Survoler le bord de l'en-tête] --> B[Poignée apparaît]
    B --> C[Cliquer-glisser pour redimensionner]
    C --> D[Largeur sauvegardée automatiquement]

    

Caractéristiques du redimensionnement

Bonnes pratiques

• Double-cliquez sur le bord de l'en-tête pour ajuster automatiquement la largeur au contenu le plus large de la colonne.
• Les largeurs sont personnelles : chaque utilisateur peut configurer ses préférences sans affecter les autres.
• Pour les grilles fréquemment utilisées, prenez le temps de configurer des largeurs adaptées à votre workflow.

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

Exemple — Bureau Moderne Sur le bon de commande 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.

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

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

Configuration avancée des grilles (développeurs)

frappe.ui.form.on("NomDoctype", {
    refresh(frm) {
        frm.fields_dict["nom_table"].grid.on("column_resize", function(fieldname, new_width) {
            console.log(`Colonne ${fieldname} redimensionnée à ${new_width}px`);
        });
    }
});