<progressmeter>
| Attributs | Enfants communs |
| id | <observes /> |
| value | |
| mode | |
| align | |
| onclick |
Si de grandes pages se chargent dans un browser, par exemple, le progressmeter montre le pourcentage de la page qui a été chargée et combien il reste à faire. L'exemple suivant montre un progressmeter défini dans un cadre XUL:
<box id="state-box" align="horizontal" flex="100%" style="min-width: 1px">
<box align="vertical" style="width:100px">
<spring flex="100%"/>
<progressmeter id="statusbar-icon" mode="normal"
align="horizontal" value="0" onclick="dumpProgress()">
<observes element="Browser:LoadingProgress" attribute="mode"/>
<observes element="Browser:Throbber" attribute="busy"
onbroadcast="onProgress()"/>
</progressmeter>
<spring flex="100%"/>
</box>
</box>
value est un attribut exigé pour indiquer la valeur ou le nom du progressmeter.Syntaxe
<progressmeter value="caractère ou chaîne" />
Exemple
<progressmeter id="nav=prog" value="0" />
Notes
La valeur value n'est pas visible pour les progressmeters, car elle sert pour titledbutton et d'autres widgets de XUL. La valeur dans ce cas-ci XXX.
mode est un attribut exigé pour indiquer si la taille de l'opération est connue ou inconnue.Syntaxe
<progressmeter mode="determined | undetermined | normal" />
Exemple
<progressmeter id="nav-prog" mode="undetermined" />
Notes
Quand la taille de l'opération ne peut pas être déterminée, comme par exemple quand les moments de chargement de page sont affectés par le trafic du réseau et autres, vous devrez placer cet attribut à "undetermined."
onclick est un attribut facultatif auditeur d'événement pour le progressmeter.Syntaxe
<progressmeter id="string" onclick="code dérouleur d'évènement" />
Exemple
<progressmeter id="string" onclick="dumpLoad()" />
Notes
L'évévenement de clique est actionné quand l'utilisateur clique sur le progress meter. Si vous voulez faire exécuter une action -- si vous voulez annuler l'exécution que le progressmeter charge, par exemple -- alors vous pouvez écrire un dérouleur d'événement pour cet attribut, comme dans l'exemple suivant: