Types de dialogues

Cinq dialogues couvrent le message léger, la saisie, la confirmation, l’information et le formulaire libre.

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

Alerte

show_alert affiche un message qui ne bloque pas l’écran. txt est le texte. seconds est la durée, 3 secondes par défaut.

javascript

show_alert("Hi, do you have a new message", 5);

Invite

frappe.prompt collecte une saisie. Paramètres : fields (liste de champs), callback, title, primary_label.

javascript

frappe.prompt(
  [{ fieldname: "birth", fieldtype: "Date", label: "Birth Date", reqd: 1 }],
  function (values) {
    show_alert(values, 5);
  },
  "Age verification",
  "Subscribe me"
);

Confirmation

frappe.confirm demande une confirmation avant une action. La page nomme les arguments mesage, onyes et oncancel : le texte, le rappel si l’utilisateur accepte, le rappel s’il refuse.

javascript

frappe.confirm(
  "Are you sure to leave this page?",
  function () {
    window.close();
  },
  function () {
    show_alert("Thanks for continue here!");
  }
);

Message

msgprint informe l’utilisateur. message peut être une chaîne HTML. title est le titre. L’exemple publié assemble un titre « Server Status » et une liste mémoire, processeur et disque, avec le titre « Server Info ». Le HTML de cet exemple est incomplet dans le texte publié.

Dialogue libre

frappe.ui.Dialog construit un dialogue. L’exemple a un champ HTML et un champ Date dont la valeur par défaut est frappe.datetime.nowdate(). L’action principale masque le dialogue et alerte les valeurs. Le HTML du champ ht est injecté avec d.fields_dict.ht.$wrapper.html, puis d.show() affiche le dialogue.

L’API JavaScript plus large est dans API Dialog. Le côté Python est dans API Dialog (Python).