Documentation Frappe Framework

Frappe Framework

Scripts de formulaire

Huitième étape du tutoriel : améliorer le formulaire Library Member avec un script de formulaire JavaScript qui ajoute deux boutons de création rapide.

1 min de lectureMis à jour le Source : docs.frappe.io

À quoi servent les scripts de formulaire

Les scripts de formulaire (Form Scripts) sont du code JavaScript côté client qui améliore l’expérience utilisateur de vos formulaires.

Le problème à résoudre

Imaginons que vous souhaitiez créer une adhésion pour un membre. Il faut ouvrir la liste Library Membership, créer un nouveau formulaire, sélectionner le membre, remplir les autres champs, puis enregistrer.

De même, pour créer une transaction pour un membre, il faut ouvrir un nouveau formulaire Library Transaction.

Ajouter des boutons au formulaire Library Member

Nous pouvons simplifier ce processus. Écrivez le code suivant dans library_member.js :

js
frappe.ui.form.on('Library Member', {
 refresh: function(frm) {
 frm.add_custom_button('Create Membership', () => {
 frappe.new_doc('Library Membership', {
 library_member: frm.doc.name
 })
 })
 frm.add_custom_button('Create Transaction', () => {
 frappe.new_doc('Library Transaction', {
 library_member: frm.doc.name
 })
 })
 }
});

Rafraîchissez la page et ouvrez le formulaire Library Member. Deux boutons apparaissent en haut à droite. Cliquez dessus pour les essayer : ils renseignent automatiquement le champ Library Member dans chacun des documents créés, ce qui simplifie la saisie. La documentation officielle illustre le résultat par une capture d’écran.

Pour aller plus loin

Nous n’avons fait qu’effleurer le sujet : les scripts de formulaire permettent beaucoup plus. Consultez l’API des scripts de formulaire pour en savoir plus.

La documentation officielle renvoie ensuite vers une page « Portal Pages » du tutoriel (lien externe). Dans cette documentation, l’étape suivante est Et ensuite ?.

Pages liées