Champs de formulaire
Champs de formulaire
Icône du type de document sur les champs Lien
Les champs de type Lien affichent automatiquement l'icône associée au type de document cible, à gauche de la valeur saisie. Cette icône permet d'identifier visuellement le type de document référencé sans lire le libellé du champ.
L'icône est récupérée depuis la configuration du type de document (champ Icône sur le formulaire DocType). Elle s'actualise dynamiquement si le type cible change (champs Lien dynamique).
L'icône n'est pas affichée dans les situations suivantes :
- Dans une table enfant (grille)
- Sur les formulaires en lecture seule
- Dans les filtres de liste
- Sur le site web public (portail utilisateur)
Pour les développeurs d'applications
L'icône est automatique dès que le type de document cible possède un champ icon renseigné. Pour les DocTypes personnalisés, configurez l'icône depuis le formulaire Type de document > champ Icône (bibliothèque Lucide).
Pour un contrôle créé en JavaScript, l'option no_icon: true désactive l'icône et le bouton d'effacement :
frappe.ui.form.make_control({
df: { fieldtype: "Link", fieldname: "customer", options: "Customer" },
parent: wrapper,
no_icon: true,
render_input: true,
});
Cette option n'existe pas dans les propriétés d'un champ de type de document.
Voir un bon de commande dans la démo — les champs Lien affichent l'icône du type de document associéBouton d'effacement sur les champs Lien
Un bouton ✕ est affiché à droite des champs Lien. Il est actif dès qu'une valeur est saisie. Un clic efface la valeur.
Le bouton reste inactif dans une table enfant, sur un champ en lecture seule et quand le champ est vide. Aucun paramètre ne le désactive.
Pour les développeurs d'applications
Le comportement est contrôlé par la méthode is_clear_button_enabled() du contrôle Link, qui retourne true inconditionnellement dans Dodock. Ce comportement s'applique à tous les champs Lien et Lien dynamique dans les formulaires du bureau.