From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/archive/mozilla/xul/tooltip/index.html | 225 ++++++++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 files/fr/archive/mozilla/xul/tooltip/index.html (limited to 'files/fr/archive/mozilla/xul/tooltip') diff --git a/files/fr/archive/mozilla/xul/tooltip/index.html b/files/fr/archive/mozilla/xul/tooltip/index.html new file mode 100644 index 0000000000..abc9a0ffbd --- /dev/null +++ b/files/fr/archive/mozilla/xul/tooltip/index.html @@ -0,0 +1,225 @@ +--- +title: tooltip +slug: Archive/Mozilla/XUL/tooltip +tags: + - Éléments_XUL +translation_of: Archive/Mozilla/XUL/tooltip +--- +
+ « Accueil de la référence XUL [ + Exemples | + Attributs | + Propriétés | + Méthodes | + Sujets liés ] +

Cet élément est utilisé pour les popups de bulles d'information. Pour les tooltip texte, il n'est pas nécessaire d'utiliser cet élément ; vous pouvez dans ce cas simplement ajouter un attribut tooltiptext à l'élément.

Vous trouverez plus d'informations dans le Tutoriel XUL. +

+
Attributs +
crop, default, label, noautohide, onpopuphidden, onpopuphiding, onpopupshowing, onpopupshown, position +
+
Propriétés +
accessibleType, label, popupBoxObject, position, state +
+
Méthodes +
hidePopup, moveTo, openPopup, openPopupAtScreen, showPopup, sizeTo +
+

Exemples

+
Image:XUL_ref_tooltip.png
+
<tooltip id="moretip" orient="vertical" style="background-color: #33DD00;">
+  <label value="Cliquez ici pour obtenir plus d'infomations"/>
+  <label value="Vraiment !" style="color: red;"/>
+</tooltip>
+
+<vbox>
+  <button label="Simple" tooltiptext="Un popup simple"/>
+  <button label="Plus" tooltip="moretip"/>
+</vbox>
+
+

Attributs

+

+

+ +
crop +
Type : une des valeurs ci-dessous +
Si le label de l'élément est trop long pour être contenu dans son espace donné, le texte sera tronqué du côté indiqué par l'attribut crop. Une ellipse (…) sera utilisée à la place du texte tronqué. Si la direction de la boîte est inversée, le tronquage l'est également. +
+ + + +
+
+ +
+
+ +
label +
Type : chaîne de caractères +
Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. +
+ + +
+
+ +
+
+ +
onpopuphidden +
Type : code de script +
Cet évènement est envoyé à un popup après qu'il a été caché. http://www.langue-fr.net/index/A/apres-que.htm +
+ + +
+
+ +
onpopuphiding +
Type : code de script +
Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué. +
+ + +
+
+ +
onpopupshowing +
Type : code de script +
Cet évènement est envoyé à un popup juste avant son ouverture. On l'utilise généralement pour définir dynamiquement le contenu lorsque l'utilisateur demande son affichage. Si ce gestionnaire d'évènement renvoie false, le popup ne s'affichera pas. +
+ + +
+
+ +
onpopupshown +
Type : code de script +
Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement onload est envoyé à une fenêtre à son ouverture. +
+ + +
+
+ +
position +
Type : une des valeurs ci-dessous +
L'attribut position détermine où le popup apparaît par rapport à l'élément sur lequel l'utilisateur a cliqué pour l'invoquer. C'est ce qui permet de placer le popup sur le bord d'un bouton. +
+ + + +
+ +

Propriétés

+

+

+
accessibleType +
Type : entier +
Une valeur indiquant le type d'objet d'accessibilité pour l'élément. +
+
+
+
label +
Type : chaîne de caractères +
Obtient et définit la valeur de l'attribut label. +
+ +
+
+
popupBoxObject +
Type : nsIPopupBoxObject +
Cette propriété en lecture seule conserve le nsIPopupBoxObject qui implémente le popup. Il n'est normalement pas nécessaire d'utiliser cette propriété étant donné que toutes ses fonctions sont disponibles via le popup lui-même. +
+ +
+
+
position +
Type : chaîne +
Obtient et définit la valeur de l'attribut position. +
+ +
+
+
state +
Type : chaîne +
Cette propriété en lecture seule indique si le popup est ouvert ou non. Quatre valeurs sont possibles : +
+ + +
+ +

Méthodes

+ + + + + + +
+

Héritées de XUL element
+ blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

Héritées de DOM element
+ addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

+ +
+
hidePopup()
+
Type de retour : pas de valeur de retour +
Ferme le popup immédiatement. +
+
moveTo( x, y ) +
Type de retour : pas de valeur de retour +
Déplace le popup vers un nouvel emplacement. +
+
openPopup( anchor , position , x , y , isContextMenu, attributesOverride ) +
Type de retour : pas de valeur de retour +
+

Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique. +

Le popup peut soit être ancré à un autre nœud ou ouvert librement. Pour ancrer un popup à un nœud, fournissez un nœud d'accrochage dans le paramètre anchor et définissez la position par une chaîne indiquant la manière dont le popup doit être ancré. +

Les valeurs possibles pour le paramètre position sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer +

Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup. +

Si le paramètre attributesOverride vaut true, l'attribut position sur le nœud popup a priorité sur la valeur du paramètre position. Si attributesOverride vaut false, l'attribut n'est utilisé que si le paramètre position est vide. +

Pour un popup ancré, les paramètres x et y peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS). +

Les popups non ancrés peuvent être créés en fournissant null comme paramètre anchor. Un popup non ancré apparait à la position spécifiée par x et y relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres position et attributesOverride sont ignorés. +

+
openPopupAtScreen( x, y, isContextMenu ) +
Type de retour : pas de valeur de retour +
+

Ouvre le popup à une position spécifique sur l'écran spécifiée par x et y. Cette position peut être ajustée s'il s'avère qu'elle provoquerait l'apparition du popup en dehors de l'écran. Les coordonnées x et y sont mesurées en pixels CSS. +

+
showPopup( element, x, y, popupType, anchor, align ) Déprécié dans Mozilla 1.9 +
Type de retour : aucune valeur de retour +
Ouvre un élément popup. Deux moyens de spécifier l'emplacement où s'affichera la fenêtre popup existent, soit en spécifiant une position spécifique de l'écran, soit par rapport à un autre élément de la fenêtre. Si x ou y sont définies par une valeur, le popup apparaîtra aux coordonnées (x,y) de l'écran. Si x et y sont définies à -1, le popup sera positionné par rapport à l'element spécifié dans le premier paramètre. C'est cette dernière méthode qu'il faut utiliser, par exemple, pour afficher un popup sous un bouton. Dans ce cas, les paramètres anchor et align peuvent être utilisés pour contrôler plus avant l'endroit où apparaîtra le popup par rapport à l'élément. Le paramètre anchor correspond à l'attribut popupanchor de l'élément et le paramètre align correspond à l'attribut popupalign. Les paramètres anchor et align sont ignorés si ni x ni y ne valent -1. +
+
Pour qu'un popup apparaisse à une position relative à un autre élément tout en étant décalé de quelques pixels, déterminez la position réelle de l'élément à l'aide de ses propriétés boxObject.screenX et boxObject.screenY, et utilisez celles-ci comme paramètres x et y en y ajoutant les décalages souhaités. +
+
Le paramètre popupType doit être une des chaînes popup, context ou tooltip. Chaque type de popup est destiné à être affiché temporairement ; ils ne sont pas censés être affichés de façon permanente. On ne peut afficher qu'un popup à la fois. +
+
sizeTo( <i>largeur</i>, <i>hauteur</i> ) +
Type de retour : aucune valeur de retour +
Modifie la taille actuelle de la fenêtre popup avec les nouvelles dimensions largeur et hauteur. +
+ +

Sujets liés

+

À faire +

+
+
-- cgit v1.2.3-54-g00ecf