initial commit

1 files changed, 268 insertions, 0 deletions

diff --git a/files/fr/archive/mozilla/xul/richlistbox/index.html b/files/fr/archive/mozilla/xul/richlistbox/index.html
new file mode 100644
index 0000000000..db0f4dacc7
--- /dev/null
+++ b/files/fr/archive/mozilla/xul/richlistbox/index.html
@@ -0,0 +1,268 @@
+---
+title: richlistbox
+slug: Archive/Mozilla/XUL/richlistbox
+tags:
+  - Éléments_XUL
+translation_of: Archive/Mozilla/XUL/richlistbox
+---
+<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs">
+ « <a href="/fr/docs/Référence_XUL">Accueil de la référence XUL</a>    [
+ <a href="#Exemples">Exemples</a> |
+ <a href="#Attributs">Attributs</a> |
+ <a href="#Propri.C3.A9t.C3.A9s">Propriétés</a> |
+ <a href="#M.C3.A9thodes">Méthodes</a> |
+ <a href="#Sujets_li.C3.A9s">Sujets liés</a> ]
+</span></div> <p>Cet élément est utilisé pour créer une liste d'éléments, de manière semblable à une <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>, mais est conçu pour être utilisé lorsque les éléments ne contiennent pas du simple contenu texte. </p><div class="blockIndicator note"><strong>Note :</strong> Dans les versions de Firefox antérieures à Firefox 3, les <code>richlistbox</code> supportaient uniquement les sélections simples. Firefox 3 y permet les sélections multiples.</div>
+
+<dl><dt> Attributs
+</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-disableKeyNavigation">disableKeyNavigation</a>, <a href="#a-preference">preference</a>, <a href="#a-rows">rows</a>, <a href="#a-seltype">seltype</a>, <a href="#a-suppressonselect">suppressonselect</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-value">value</a>
+</dd></dl>
+<dl><dt> Propriétés
+</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-listbox.currentIndex">currentIndex</a>, <a href="#p-currentItem">currentItem</a>, <a href="#p-disabled">disabled</a>, <a href="#p-disableKeyNavigation">disableKeyNavigation</a>, <a href="#p-itemCount">itemCount</a>, <a href="#p-selectedCount">selectedCount</a>, <a href="#p-selectedIndex">selectedIndex</a>, <a href="#p-selectedItem">selectedItem</a>, <a href="#p-selectedItems">selectedItems</a>, <a href="#p-selType">selType</a>, <a href="#p-suppressOnSelect">suppressOnSelect</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a>
+</dd></dl>
+<dl><dt> Méthodes
+</dt><dd> <a href="#m-addItemToSelection">addItemToSelection</a>, <a href="#m-appendItem">appendItem</a>, <a href="#m-clearSelection">clearSelection</a>, <a href="#m-ensureElementIsVisible">ensureElementIsVisible</a>, <a href="#m-ensureIndexIsVisible">ensureIndexIsVisible</a>, <a href="#m-getIndexOfFirstVisibleRow">getIndexOfFirstVisibleRow</a>, <a href="#m-getIndexOfItem">getIndexOfItem</a>, <a href="#m-getItemAtIndex">getItemAtIndex</a>, <a href="#m-getNumberofVisibleRows">getNumberofVisibleRows</a>, <a href="#m-getRowCount">getRowCount</a>, <a href="#m-getSelectedItem">getSelectedItem</a>, <a href="#m-insertItemAt">insertItemAt</a>, <a href="#m-invertSelection">invertSelection</a>, <a href="#m-moveByOffset">moveByOffset</a>, <a href="#m-removeItemAt">removeItemAt</a>, <a href="#m-removeItemFromSelection">removeItemFromSelection</a>, <a href="#m-scrollToIndex">scrollToIndex</a>, <a href="#m-selectAll">selectAll</a>, <a href="#m-selectItem">selectItem</a>, <a href="#m-selectItemRange">selectItemRange</a>, <a href="#m-timedSelect">timedSelect</a>, <a href="#m-toggleItemSelection">toggleItemSelection</a>
+</dd></dl>
+<h3 id="Exemples" name="Exemples"> Exemples </h3>
+<pre class="eval">&lt;richlistbox&gt;
+  &lt;richlistitem&gt;
+    &lt;description&gt;Une description XUL !&lt;/description&gt;
+  &lt;/richlistitem&gt;
+  &lt;richlistitem&gt;
+    &lt;button label="Un bouton XUL"/&gt;
+  &lt;/richlistitem&gt;
+&lt;/richlistbox&gt;
+</pre>
+<p>L'élément <code>richlistbox</code> contient plusieurs éléments <code>richlistitem</code>, qui peuvent contenir tout type de contenu. On peut cliquer sur n'importe quel élément <code>richlistitem</code> et utiliser le clavier pour déplacer la sélection.
+</p>
+<h3 id="Attributs" name="Attributs"> Attributs </h3>
+<p>
+</p><div id="a-disabled">
+
+<dl><dt> <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code>
+</dt><dd> Type : <i>booléen</i>
+</dd><dd> Indique si l'élément est ou non désactivé. Si cette valeur est définie à <code>true</code>, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement <code>command</code> ne se déclenchera pas. </dd></dl>
+<p><br>
+</p>
+<div class="float-right"><img alt="Image:XUL_ref_attr_disabled.png"></div>
+<pre>&lt;!-- La case à cocher active/désactive le bouton --&gt;
+&lt;checkbox label="Enable button"
+    onclick="document.getElementById('buttRemove').disabled = this.checked"/&gt;
+&lt;button id="buttRemove" label="Remove All" disabled="true"/&gt;
+</pre>
+</div>
+<div id="a-disableKeyNavigation">
+
+</div>
+<div id="a-preference">
+
+<dl><dt> <code id="a-preference"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference">preference</a></code>
+</dt><dd> Type : <i>id d'élément</i>
+</dd><dd> Connecte l'élément à une préférence (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>) correspondante. Cet attribut n'a d'effet qu'utilisé au sein d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>. La valeur de la préférence sera mise à jour pour correspondre à la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/value">value</a></span></code> de l'élément.
+</dd></dl>
+
+
+</div>
+<div id="a-rows">
+
+<dl><dt> <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code>
+</dt><dd> Type : <i>entier</i>
+</dd><dd> Le nombre de lignes à afficher dans l'élément. Si l'élément contient plus que ce nombre de lignes, une barre de défilement apparaitra afin que l'utilisateur puisse consulter les autres lignes. Pour obtenir le nombre réel de lignes dans l'élément, utilisez la méthode <span id="m-getRowCount"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/getRowCount">getRowCount</a></code></span>.
+</dd></dl>
+
+
+</div>
+<div id="a-seltype">
+
+<dl>
+ <dt>
+  <code id="a-seltype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/seltype">seltype</a></code>&lt;magic name="\"PAGENAME\"/"&gt;&lt;/magic&gt;</dt>
+ <dd>
+  Type :
+  <i>
+   une des valeurs ci-dessous</i>
+ </dd>
+ <dd>
+  Utilisé pour indiquer si les sélections multiples sont permises.</dd>
+</dl>
+<ul>
+ <li><code>single</code> : Seule une ligne peut être sélectionnée à la fois. (Valeur par défaut dans <code>listbox</code>.)</li>
+ <li><code>multiple</code> : Plusieurs lignes peuvent être sélectionnées à la fois. (Valeur par défaut dans <code>tree</code>.)</li>
+</ul>
+<p>&lt;magic name="\"PAGENAME\"/"&gt;Des cellules individuelles peuvent être sélectionnées.&lt;/magic&gt;&lt;magic name="\"PAGENAME\"/"&gt; Des lignes sont sélectionnées, cependant, l'indicateur de sélection n'est visible que sur le texte de la colonne principale.&lt;/magic&gt;</p>
+</div>
+<div id="a-suppressonselect">
+
+<dl>
+  <dt>
+    <code id="a-suppressonselect"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/suppressonselect">suppressonselect</a></code></dt>
+  <dd>
+    Type :
+    <i>
+      booléen</i>
+  </dd>
+  <dd>
+    Si cet attribut n'est pas spécifié, un évènement <code>select</code> est déclenché dès qu'un élément est sélectionné, que ce soit par l'utilisateur ou par l'appel d'une des méthodes de sélection. Si la valeur de l'attribut est <code>true</code>, l'évènement <code>select</code> n'est jamais déclenché.</dd>
+</dl>
+</div>
+<div id="a-tabindex">
+
+<dl><dt> <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code>
+</dt><dd> Type : <i>entier</i>
+</dd><dd> L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le <code>tabindex</code> est plus haut se trouvent plus tard dans la séquence de tabulation.
+</dd></dl>
+
+
+</div>
+<div id="a-value">
+
+<dl><dt> <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>
+</dt><dd> Type : <i>chaîne</i>
+</dd><dd> Cet attribut chaîne permet d'associer une valeur de données avec un élément. Il n'est destiné à aucune utilisation particulière, mais vous pouvez y accéder avec un script pour votre usage propre..
+</dd></dl>
+
+
+</div>
+
+<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3>
+<p>
+</p><div id="p-accessibleType">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessibleType">accessibleType</a></span></code>
+</dt><dd> Type : <i>entier</i>
+</dd><dd> Une valeur indiquant le type d'objet d'accessibilité pour l'élément.
+</dd></dl>
+</div>
+<div id="p-listbox.currentIndex"></div>
+<div id="p-currentItem">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/currentItem">currentItem</a></span></code>
+</dt><dd> Type : <i>élément listitem</i>
+</dd><dd> Renvoie le dernier élément sélectionné dans la liste de sélection, ce qui n'est utile que dans une liste à sélection multiple.
+</dd></dl>
+
+</div>
+<div id="p-disabled">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/disabled">disabled</a></span></code>
+</dt><dd> Type : <i>booléen</i>
+</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code>.
+</dd></dl>
+
+</div>
+<div id="p-disableKeyNavigation"></div>
+<div id="p-itemCount"></div>
+<div id="p-selectedCount"></div>
+<div id="p-selectedIndex">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedIndex">selectedIndex</a></span></code>
+</dt><dd> Type : <i>entier</i>
+</dd><dd> Renvoie l'indice de l'élément actuellement sélectionné. Un élément peut être sélectionné en assignant son indice à cette propriété. En lui assignant <code>-1</code>, tous les éléments seront désélectionnés.
+</dd></dl>
+
+</div>
+<div id="p-selectedItem">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedItem">selectedItem</a></span></code>
+</dt><dd> Type : <i>élément</i>
+</dd><dd> Conserve l'élément actuellement sélectionné. Si aucun élément n'est sélectionné, sa valeur sera <code>null</code>. Vous pouvez sélectionner un élément en définissant cette valeur. Un évènement select sera envoyé à cet élément lorsqu'il est sélectionné en modifiant cette propriété, la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedIndex">selectedIndex</a></span></code>, ou par l'utilisateur.
+</dd></dl>
+
+</div>
+<div id="p-selectedItems"></div>
+<div id="p-selType">
+<dl>
+ <dt>
+  <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selType">selType</a></span></code>&lt;magic name="\"PAGENAME\"/"&gt;&lt;/magic&gt;</dt>
+ <dd>
+  Type :
+  <i>
+   chaîne de caractères</i>
+ </dd>
+ <dd>
+  Obtient et définit la valeur de l'attribut <code id="a-seltype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/seltype">seltype</a></code>.</dd>
+</dl>
+
+</div>
+<div id="p-suppressOnSelect">
+<dl>
+  <dt>
+    <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/suppressOnSelect">suppressOnSelect</a></span></code></dt>
+  <dd>
+    Type :
+    <i>
+      booléen</i>
+  </dd>
+  <dd>
+    Obtient et définit la valeur de l'attribut <code id="a-suppressonselect"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/suppressonselect">suppressonselect</a></code>.</dd>
+</dl></div>
+<div id="p-tabIndex">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/tabIndex">tabIndex</a></span></code>
+</dt><dd> Type : <i>entier</i>
+</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code>.
+</dd></dl>
+
+</div>
+<div id="p-value">
+<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/value">value</a></span></code>
+</dt><dd> Type : <i>chaîne</i>
+</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>.
+</dd></dl>
+
+</div>
+
+<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3>
+<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238); float: right; width: 250px;">
+<tbody>
+<tr>
+<td>
+<p><strong>Héritées de XUL element</strong><br>
+<small> <span id="m-blur"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttribute">getElementsByAttribute</a></code></span> <span id="m-getElementsByAttributeNS"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttributeNS">getElementsByAttributeNS</a></code></span></small></p> <p><strong>Héritées de DOM element</strong><br>
+<small> <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.appendChild">appendChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.isSupported">isSupported()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code></small></p>
+
+</td>
+</tr>
+</tbody>
+</table>
+
+
+
+
+
+
+
+
+
+<dl><dt> <span id="m-getRowCount"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/getRowCount">getRowCount()</a></code></span>
+</dt><dd> Type de retour : <i>entier</i>
+</dd><dd> Renvoie le nombre total de lignes dans l'élément, quel que soit le nombre de lignes affichées.
+</dd></dl>
+
+
+
+
+
+
+
+<dl><dt> <span id="m-selectAll"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/selectAll">selectAll()</a></code></span>
+</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
+</dd><dd> Sélectionne tous les éléments. Un évènement de sélection est envoyé après l'exécution de la sélection.
+</dd></dl>
+<dl><dt> <span id="m-selectItem"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/selectItem">selectItem( item )</a></code></span>
+</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
+</dd><dd> Désélectionne tous les éléments actuellement sélectionnés, puis sélectionne l'élément donné en argument. Un évènement de sélection est envoyé après l'exécution de la sélection.
+</dd></dl>
+<dl><dt> <span id="m-selectItemRange"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/selectItemRange">selectItemRange( startItem, endItem)</a></code></span>
+</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
+</dd><dd> Sélectionne tous les éléments compris entre les deux éléments donnés en paramètre, y compris les éléments de début et de fin. Tous les autres éléments sont désélectionnés. Cette méthode n'a aucun effet sur les listes en mono-sélection. Un évènement de sélection est envoyé après l'exécution de la sélection.
+</dd></dl>
+<dl><dt> <span id="m-timedSelect"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/timedSelect">timedSelect( item, timeout )</a></code></span>
+</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
+</dd><dd> Sélectionne un élément spécifié par l'argument <code>item</code> après un nombre de millisecondes définit par l'argument <code>timeout</code>. Tous les autres éléments sont désélectionnés.
+</dd></dl>
+<dl><dt> <span id="m-toggleItemSelection"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/toggleItemSelection">toggleItemSelection( item )</a></code></span>
+</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
+</dd><dd> Modifie l'état de sélection de l'élément spécifié. S'il est sélectionné, il devient désélectionné. S'il est désélectionné, il devient sélectionné. Les autres éléments de la liste ne sont pas affectés et ils conservent leur état de sélection.
+</dd></dl>
+
+<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3>
+<dl><dt> Interfaces
+</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULMultiSelectControlElement">nsIDOMXULMultiSelectControlElement</a>
+</dd></dl>
+<div class="noinclude">
+</div>