diff options
Diffstat (limited to 'files/fr/archive')
793 files changed, 0 insertions, 68748 deletions
diff --git a/files/fr/archive/add-ons/api_de_restauration_de_session/index.html b/files/fr/archive/add-ons/api_de_restauration_de_session/index.html deleted file mode 100644 index dfae935362..0000000000 --- a/files/fr/archive/add-ons/api_de_restauration_de_session/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: API de restauration de session -slug: Archive/Add-ons/API_de_restauration_de_session -tags: - - Extensions -translation_of: Archive/Add-ons/Session_store_API ---- -<p><a href="fr/Firefox_2">Firefox 2</a> introduit la sauvegarde de session, une nouvelle fonctionnalité qui permet aux <a href="fr/Extensions">extensions</a> de sauvegarder et restaurer des données entre différentes sessions de Firefox. Une API simple permet aux extensions d'accéder à cette fonctionnalité. -</p><p>Un des cas où l'utilisation de cette fonctionnalité peut être cruciale pour une extension est que Firefox 2 permet à l'utilisateur d'annuler la fermeture des onglets. Pour récupérer proprement l'état de votre extension lorsqu'un onglet est restauré, celle-ci doit utiliser la méthode <code>setTabValue()</code> de l'API de sauvegarde de session pour enregistrer toutes les données devant pouvoir être restaurées par la suite, puis appeler la méthode <code>getTabValue()</code> pour récupérer ces données lorsque l'onglet est restauré. -</p><p>L'API de sauvegarde de session est implémentée en utilisant l'interface <code><a href="fr/NsISessionStore">nsISessionStore</a></code>. -</p> -<h2 id="Savoir_quand_restaurer" name="Savoir_quand_restaurer">Savoir quand restaurer</h2> -<p>Chaque fois que Firefox est sur le point de restaurer un onglet, un événement de type <code>SSTabRestoring</code> est généré. Si votre extension doit pouvoir restaurer des données lorsqu'un onglet est récupéré, vous pouvez mettre en place un listener comme ceci : -</p> -<pre>function myExtensionHandleRestore(aEvent) { - Components.classes["@mozilla.org/consoleservice;1"]. - getService(Components.interfaces.nsIConsoleService). - logStringMessage("Restauration d'onglets"); -}; - -document.addEventListener("SSTabRestoring", myExtensionHandleRestore, false); -</pre> -<p>Il vous suffit de remplacer le contenu de la fonction <code>myExtensionHandleRestore()</code> avec vos propres actions à effectuer lorsque l'onglet est récupéré. Dans cet exemple, l'interface <code><a href="fr/NsIConsoleService">nsIConsoleService</a></code> sert à afficher un message dans <a href="fr/Console_JavaScript">la console JavaScript</a>. -</p><p>Cet événement est généré juste avant que l'onglet ne soit récupéré. Un événement de type <code>SSTabRestored</code> est déclenché à chaque fois qu'un onglet a fini d'être récupéré. -</p> -<h2 id="Le_processus_de_restauration_de_session" name="Le_processus_de_restauration_de_session">Le processus de restauration de session</h2> -<p>La séquence exacte d'événements qui surviennent lorsqu'une session est en cours de restauration est la suivante : -</p> -<ol><li> Un état de session est sur le point d'être restauré. Cela peut se faire au démarrage ou en réponse à une annulation de fermeture d'onglet, puisque les sessions d'onglets fermés sont récupérées onglet par onglet. -</li><li> De nouvelles fenêtres sont ouvertes si nécessaire (une pour chaque fenêtre qui a été sauvegardée dans l'enregistrement de session), les cookies et la liste des onglets récemment fermés sont restaurés. -</li></ol> -<p>Ensuite, les étapes suivantes sont lancées pour chaque onglet récupéré : -</p> -<ol><li> Soit un onglet existant est réutilisé, soit un nouvel onglet est créé. Dans ce dernier cas, un événement <code>TabOpen</code> est généré. -</li><li> Les attributs XUL persistants de l'onglet (ceux dus aux appels de <code><a href="fr/NsISessionStore#persistTabAttribute.28.29">persistTabAttribute()</a></code>) et les permissions sont restaurés. -</li><li> L'événement <code>SSTabRestoring</code> est généré. -</li><li> L'onglet reçoit l'indication de l'URL à afficher. -</li><li> Lorsque la page est chargée, les champs de saisie et les barres de défilement sont restaurés. -</li><li> Finalement, l'événement <code>SSTabRestored</code> est généré. -</li></ol> -<p>Si vous voulez définir des permissions ou manipuler un onglet récupéré avant que la page y soit chargée, vous devrez surveiller <code>SSTabRestoring</code>. Si vous voulez faire une action après le chargement de la page, vous devrez surveiller <code>SSTabRestored</code>. -</p><p>Ces deux événements sont générés systématiquement pour chaque onglet récupéré. Vous pouvez déterminer quel onglet est concerné par la récupération grâce au champ <code>originalTarget</code> de l'événement. -</p><p>Il n'y a pas vraiment de moyen pour déterminer quand le dernier onglet a été récupéré à moins de déterminer combien d'onglets doivent être récupérés puis de compter le nombre d'événements <code>SSTabRestored</code>. -</p> -<h2 id="Utilisation_de_l.27API_de_restauration_de_session" name="Utilisation_de_l.27API_de_restauration_de_session">Utilisation de l'API de restauration de session</h2> -<p>Cette section propose quelques exemples simples sur l'emploi de l'API de restauration de session. -</p> -<h3 id="Sauvegarder_une_valeur_avec_un_onglet" name="Sauvegarder_une_valeur_avec_un_onglet">Sauvegarder une valeur avec un onglet</h3> -<p>Le code suivant permet d'attacher un couple clef/valeur à un onglet de telle façon que lorsque l'onglet est récupéré, ce couple le soit également. -</p> -<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. - getService(Components.interfaces.nsISessionStore); - var currentTab = getBrowser().selectedTab; - var dataToAttach = "Je veux attacher ceci"; - ss.setTabValue(currentTab, "key-name-here", dataToAttach); -</pre> -<p>Ce code définit une valeur de <var>dataToAttach</var> à la clef <code>"key-name-here"</code>. La donnée peut être n'importe quel objet JavaScript. -</p> -<h3 id="Lire_une_valeur_sauvegard.C3.A9e" name="Lire_une_valeur_sauvegard.C3.A9e">Lire une valeur sauvegardée</h3> -<p>Vous pouvez lire une valeur associée à un onglet n'importe quand (que l'onglet soit ou non dans un processus de récupération) en utilisant le code suivant : -</p> -<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. - getService(Components.interfaces.nsISessionStore); - var currentTab = getBrowser().selectedTab; - var retrievedData = ss.getTabValue(currentTab, "key-name-here"); -</pre> -<p>Après l'exécution de ce code, la variable <var>retrievedData</var> contient la valeur sauvegardée correspondante à la clef <code>"key-name-here"</code>. La variable <var>retrievedData</var> est indéfinie (<code>undefined</code>) si aucune valeur correspondant à cette clef n'a été sauvegardée. -</p> -<h3 id="Effacer_une_valeur_associ.C3.A9e_.C3.A0_un_onglet" name="Effacer_une_valeur_associ.C3.A9e_.C3.A0_un_onglet">Effacer une valeur associée à un onglet</h3> -<p>Pour effacer une valeur d'un onglet, vous pouvez utiliser un code similaire à celui-ci : -</p> -<pre class="eval"> var ss = Components.classes["@mozilla.org/browser/sessionstore;1"]. - getService(Components.interfaces.nsISessionStore); - var currentTab = getBrowser().selectedTab; - deleteTabValue(currentTab, "key-name-here"); -</pre> -<h3 id="Remarques" name="Remarques">Remarques</h3> -<p>Les fonctions de restauration et de lecture des valeurs d'une fenêtre fonctionnent exactement comme les fonctions pour les onglets portant des noms similaires. -</p> -<h2 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h2> -<p><a href="fr/NsISessionStore">nsISessionStore</a> -</p> diff --git a/files/fr/archive/add-ons/développement_de_modules_complémentaires/index.html b/files/fr/archive/add-ons/développement_de_modules_complémentaires/index.html deleted file mode 100644 index 1be4236d13..0000000000 --- a/files/fr/archive/add-ons/développement_de_modules_complémentaires/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Développement de modules complémentaires -slug: Archive/Add-ons/Développement_de_modules_complémentaires -translation_of: Archive/Add-ons/Developing_add-ons ---- -<p>Les logiciels basés sur Mozilla sont typiquement extensibles au travers de modules complémentaires. Trois principaux types de modules existent : les extensions, les thèmes et les plugins. Cette page vous aidera à trouver les informations dont vous aurez besoin pour créer des modules complémentaires pour Firefox, Thunderbird ou d'autres logiciels basés sur la plateforme Mozilla, ainsi que pour les distribuer.</p> -<table class="mainpage-table"> - <tbody> - <tr> - <td colspan="2"> - <h2 id="Modules_complémentaires">Modules complémentaires</h2> - </td> - </tr> - <tr> - <td> - <dl> - <dt> - <a class="internal" href="/fr/Soumettre_un_module_compl%C3%A9mentaire_sur_AMO" title="fr/Soumettre un module complémentaire sur AMO">Soumettre un module complémentaire sur AMO</a></dt> - <dd> - Fournit des informations pour les développeurs de modules afin de les aider à empaqueter et délivrer leur modules. Ces informations concernent notamment addons.mozilla.org, le site de distribution de modules de Mozilla.</dd> - <dt> - <a class="internal" href="/fr/Extensions" title="fr/Extensions">Extensions</a></dt> - <dd> - Les extensions ajoutent de nouvelles fonctionnalités à des applications Mozilla comme Firefox, SeaMonkey et Thunderbird. Cela peut aller d'un simple bouton de barre d'outils à une toute nouvelle fonctionnalité.</dd> - <dt> - <a class="internal" href="/fr/Plugins" title="fr/Plugins">Plugins</a></dt> - <dd> - Informations sur la manière de créer des plugins, des composants binaires permettant aux logiciels basés sur Mozilla d'afficher du contenu non gérés nativement.</dd> - </dl> - </td> - <td> - <dl> - <dt> - <a class="internal" href="/fr/Th%C3%A8mes" title="fr/Thèmes">Thèmes</a></dt> - <dd> - Les thèmes permettent aux utilisateurs de personnaliser l'apparence de leur interface dans les applications basées sur Mozilla.</dd> - <dt> - <a class="internal" href="/fr/Cr%C3%A9ation_de_plugins_OpenSearch_pour_Firefox" title="fr/Création de plugins OpenSearch pour Firefox">Plugins de moteurs de recherche</a></dt> - <dd> - Firefox permet d'utiliser des plugins de moteurs de recherche, avec lesquels le champ de recherche peut gérer différents moteurs de recherche.</dd> - <dt> - <a class="internal" href="fr/La%20plateforme" title="fr/The Mozilla platform">La plateforme Mozilla</a></dt> - <dd> - Informations concernant la plateforme Mozilla, toutes ses technologies et API, ainsi que la manière de les utiliser dans vos propres projets.</dd> - </dl> - </td> - </tr> - </tbody> -</table> -<p> </p> diff --git a/files/fr/archive/add-ons/gestion_de_suggestions_dans_les_plugins_de_recherche/index.html b/files/fr/archive/add-ons/gestion_de_suggestions_dans_les_plugins_de_recherche/index.html deleted file mode 100644 index 146f12cc47..0000000000 --- a/files/fr/archive/add-ons/gestion_de_suggestions_dans_les_plugins_de_recherche/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Gestion de suggestions dans les plugins de recherche -slug: Archive/Add-ons/Gestion_de_suggestions_dans_les_plugins_de_recherche -tags: - - Plugins - - Plugins_de_recherche -translation_of: Archive/Add-ons/Supporting_search_suggestions_in_search_plugins ---- -<p>MozSearch offre la gestion des suggestions de recherche ; au fur et à mesure que l'utilisateur saisit des caractères dans la barre de recherche, Firefox 2 demande à l'URL spécifiée par le plugin de lui fournir des suggestions de recherche. -</p><p>Une fois la liste récupérée, elle est affiche dans une liste déroulante en dessous de la barre de recherche, permettant à l'utilisateur de sélectionner une des propositions s'il le souhaite. S'il continue à ajouter des caractères, de nouvelles suggestions sont demandées au moteur de recherche, puis utilisées pour rafraîchir la liste précédente. -</p><p>Les plugins de recherche Yahoo et Google inclus dans Firefox 2 utilisent la suggestion de recherche. -</p> -<h3 id="Impl.C3.A9menter_le_support_de_la_suggestion_dans_le_plugin_de_recherche" name="Impl.C3.A9menter_le_support_de_la_suggestion_dans_le_plugin_de_recherche"> Implémenter le support de la suggestion dans le plugin de recherche </h3> -<p>Pour offrir des suggestions de recherche, un plugin doit comporter un élément <code><Url></code> supplémentaire dont l'attribut <code>type</code> vaut <code>"application/x-suggestions+json"</code>. (Cela signifie que le plugin d'un moteur de recherche offrant des suggestions de recherche contient deux éléments <code><Url></code>, l'autre étant l'URL de recherche <code>text/html</code> principale.) -</p><p>Par exemple, le plugin de recherche Yahoo contient l’élément <code><Url></code> suivant : -</p> -<pre><Url type="application/x-suggestions+json" template="http://ff.search.yahoo.com/gossip?output=fxjson&command={searchTerms}"/> -</pre> -<p>Si l'utilisateur entre « fir » dans la barre de recherche, puis fait une pause, Firefox remplace <code>{searchTerms}</code> par « fir » et contacte cette URL : -</p> -<pre><Url type="application/x-suggestions+json" template="http://ff.search.yahoo.com/gossip?output=fxjson&command=fir"/> -</pre> -<p>Les résultats sont utilisés pour créer la liste de la boite de suggestion. -</p><p>Consultez <a href="fr/Cr%c3%a9ation_de_plugins_MozSearch">la page de création d'un plugin MozSearch</a> pour plus de détails sur l’implémentation d’un plugin de recherche. -</p> -<h3 id="Impl.C3.A9menter_le_support_des_suggestions_de_recherche_sur_le_serveur" name="Impl.C3.A9menter_le_support_des_suggestions_de_recherche_sur_le_serveur"> Implémenter le support des suggestions de recherche sur le serveur </h3> -<p>La plus grande partie du travail de la suggestion de recherche se passe du coté du serveur. Si vous êtes concepteur de site Web et que vous désirez proposer des suggestions de recherche, vous devez prévoir la possibilité de renvoyer des suggestions correspondant à un terme de recherche avec la <a class="external" href="http://www.json.org/">Notation JSON</a> (en) (JavaScript Object Notation). -</p><p>Quand le navigateur désire obtenir une liste de correspondances possibles pour un terme recherché, il envoie une requête HTTP GET à l'URL spécifiée dans l'élément <code><Url></code>. -</p><p>Votre serveur doit alors décider des suggestions à faire en utilisant le moyen qu'il jugera adéquat, puis construire un JSON composé d'au minimum deux, et au maximum quatre éléments : -</p> -<dl><dt> <b>chaîne de recherche</b> -</dt><dd> Le premier élément du JSON est le terme de recherche qui a été communiqué au serveur. Cela permet à Firefox de vérifier que les suggestions correspondent au terme de recherche actuel. -</dd></dl> -<dl><dt> <b>liste de suggestions</b> -</dt><dd> Un tableau des termes de recherche suggérés. Le tableau est placé entre crochets. Par exemple : <tt>["terme 1", "terme 2", "terme 3", "terme 4"]</tt> -</dd></dl> -<dl><dt> <b>descriptions</b> -</dt><dd> Cet élément optionnel est un tableau de descriptions correspondant à chacun des éléments de la <i>liste de suggestions</i>. Il peut s'agir de n'importe quelle information supplémentaire que le moteur de recherche désire voir affichée par le navigateur, comme nombre de résultats disponibles pour une suggestion. -</dd></dl> -<div class="note">Les descriptions ne sont pas supportées dans Firefox 2, et sont ignorées lorsqu’elles sont spécifiées.</div> -<dl><dt> <b>URL spécifiques associées à des requêtes</b> -</dt><dd> Cet élément optionnel est un tableau d'URL alternatives pour chacune des suggestions de la <i>liste de suggestions</i>. Par exemple, si pour une suggestion donnée vous préférez donner un lien vers une carte plutôt qu'une simple page de résultats de recherche, vous pouvez retourner une URL vers une carte dans ce tableau. -</dd></dl> -<dl><dd> Si vous ne spécifiez pas d'URL spécifique pour un élément de la liste de suggestions, c'est la requête par défaut, décrite par l’élément <code><Url></code> dans la description XML du plugin, qui sera employée. -</dd></dl> -<div class="note">Les URL associées à des requêtes ne sont pas supportées dans Firefox 2, et sont ignorées lorsqu'elles sont spécifiées.</div> -<p>Ainsi, si le terme de recherche est « fir », et si vous ne désirez renvoyer ni les descriptions, ni les URL associées aux requêtes, vous pouvez renvoyer le JSON suivant : -</p> -<pre class="eval">["fir", ["firefox", "first choice", "mozilla firefox"]] -</pre> -<p>Remarquez que dans cet exemple, seules la chaîne de recherche et la liste de suggestions sont spécifiées, et les éléments optionnels sont négligés. -</p><p>Votre liste de suggestions peut comporter autant d'éléments que vous le souhaitez, mais elle devrait être limitée à une longueur raisonnable étant donné que l'affichage doit être rafraîchi au fur et à mesure que l'utilisateur compose son terme de recherche. Enfin, notez que vous êtes entièrement libre quant à la méthode que vous employez pour sélectionner les suggestions à envoyer. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/add-ons/index.html b/files/fr/archive/add-ons/index.html deleted file mode 100644 index d1851bd7ee..0000000000 --- a/files/fr/archive/add-ons/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Add-ons -slug: Archive/Add-ons -translation_of: Archive/Add-ons ---- -<p>In progress. Archived add-ons documentation.</p> - -<p></p> diff --git a/files/fr/archive/add-ons/installation_d_extensions_et_de_thèmes_depuis_une_page_web/index.html b/files/fr/archive/add-ons/installation_d_extensions_et_de_thèmes_depuis_une_page_web/index.html deleted file mode 100644 index 3d0300b2a6..0000000000 --- a/files/fr/archive/add-ons/installation_d_extensions_et_de_thèmes_depuis_une_page_web/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Installation d'extensions et de thèmes depuis une page Web -slug: Archive/Add-ons/Installation_d_extensions_et_de_thèmes_depuis_une_page_Web -tags: - - Extensions - - Themes -translation_of: Archive/Add-ons/Installing_Extensions_and_Themes_From_Web_Pages ---- -<p>Il existe de nombreuses façons d'installer des <a href="fr/Extensions">extensions</a> et des <a href="fr/Th%c3%a8mes">thèmes</a> depuis des pages Web, parmi lesquelles un lien direct vers les fichiers XPI et l'utilisation de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger">InstallTrigger</a>.</p> -<p>Les auteurs d'extensions et de pages Web sont encouragés à utiliser la méthode décrite ci-dessous pour installer des fichiers XPI, c'est celle qui est la plus agréable pour l'utilisateur.</p> -<h3 id="Exemple_de_script_Web" name="Exemple_de_script_Web">Exemple de script Web</h3> -<pre class="eval"><script type="application/x-javascript"> -<!-- -function install (aEvent) -{ - var params = { - "Foo": { URL: aEvent.target.href, - IconURL: aEvent.target.getAttribute("iconURL"), - Hash: aEvent.target.getAttribute("hash"), - toString: function () { return this.URL; } - } - }; - InstallTrigger.install(params); - - return false; -} ---> -</script> -<span class="nowiki"> - <a href="http://www.example.com/foo.xpi" - iconURL="http://www.example.com/foo.png" - hash="sha1:28857e60d043447c5f4550853f2d40770b326a13" - onclick="return install(event);">Installer l'extension</a> - </span> -</pre> -<p>Examinons ce code pièce par pièce. L'élément HTML <code><a></code> est le lien d'installation. L'attribut <code>href</code> contient un lien direct vers le fichier XPI de l'extension, c'est ce qui sera affiché dans la barre d'adresse lorsque le pointeur survole le lien. Les visiteurs peuvent enregistrer le fichier XPI sur leur disque facilement en cliquant dessus et en choisissant « Enregistrer sous… »</p> -<p>Lorsqu'on clique sur le lien, il appelle la fonction <code>install</code> en passant l'objet d'évènement en paramètre.</p> -<p>L'installation crée d'abord un bloc de paramètres :</p> -<pre class="eval">var params = { - "Foo": { URL: aEvent.target.href, - IconURL: aEvent.target.getAttribute("iconURL"), - Hash: aEvent.target.getAttribute("hash"), - toString: function () { return this.URL; } -}; -</pre> -<p>Ceci spécifie le nom (Foo) à afficher dans le dialogue de confirmation, l'URL où trouver l'extension (qui, souvenez-vous, est l'attribut <code>href</code> du lien), l'URL de l'icône à afficher dans le dialogue de confirmation, une empreinte de contrôle du fichier <code>xpi</code> (pour protéger contre les téléchargements corrompus), et une fonction <code>toString</code> qui permettra à ce code de fonctionner avec les versions 0.8 et antérieures de Firefox. Vous pouvez également utiliser l'ancien style de bloc de paramètres (<code>{ "Foo": aEvent.target.href }</code>) si vous le désirez et que vous n'avez pas d'icône à afficher dans le dialogue de confirmation.</p> -<p><code>InstallTrigger.install</code> est ensuite appelée pour installer l'élément défini dans le bloc de paramètres.</p> -<pre class="eval">return false; -</pre> -<p>Cette dernière partie est la plus importante : la fonction d'installation doit renvoyer <code>false</code> afin que, lorsqu'on clique sur le lien, seul le script soit exécuté et le href du lien ne soit pas chargé dans le navigateur. Si vous oubliez cette étape, l'utilisateur risque de voir deux dialogues d'installation, étant donné que vous avez effectivement invoqué deux requêtes d'installation : une avec <code>InstallTrigger</code> et l'autre en essayant de charger directement le fichier XPI.</p> -<h3 id="Param.C3.A8tres_disponibles_pour_l.27objet_d.27installation" name="Param.C3.A8tres_disponibles_pour_l.27objet_d.27installation">Paramètres disponibles pour l'objet d'installation</h3> -<p>La méthode <code>InstallTrigger.install</code> accepte un objet JavaScript en paramètre, dont plusieurs propriétés seront utilisées au cours de l'installation.</p> -<h4 id="URL" name="URL">URL</h4> -<p>La propriété <code>URL</code> spécifie l'adresse URL du fichier XPI à installer. Cette propriété est obligatoire.</p> -<h4 id="IconURL" name="IconURL">IconURL</h4> -<p>La propriété <code>IconURL</code> indique une icône à utiliser dans le dialogue d'installation. Cette propriété est facultative. Si aucune icône n'est spécifiée, l'icône par défaut sera utilisée, habituellement une pièce de puzzle verte. L'icône peut être dans n'importe quel format d'image accepté par Firefox, et doit être d'une taille de 32×32 pixels.</p> -<h4 id="Hash" name="Hash">Hash</h4> -<p>La propriété <code>Hash</code> spécifie une empreinte cryptographique du contenu du fichier XPI. Celle-ci est utilisée pour vérifier le fichier téléchargé, pour empêcher d'installer, par exemple, un fichier corrompu servi par un serveur de téléchargement miroir. Toute fonction de hachage supportée par <a href="fr/NsICryptoHash">nsICryptoHash</a> peut être utilisée. L'empreinte est spécifiée de la manière <code>fonction de hachage:empreinte de contrôle</code>, par exemple, <code>sha1:28857e60d043447c5f4550853f2d40770b326a13</code>.</p> -<h4 id="toString.28.29" name="toString.28.29">toString()</h4> -<p>La propriété <code>toString()</code> devrait renvoyer l'URL du fichier XPI, pour la compatibilité avec les versions de Firefox antérieures à 1.0, et d'autres applications comme Seamonkey.</p> -<h3 id="Th.C3.A8mes" name="Th.C3.A8mes">Thèmes</h3> -<p>À peu près tout ce qui est décrit ci-dessus s'applique également aux thèmes, sauf qu'il faut utiliser la fonction <code>installChrome</code>. Comme beaucoup de sites installaient des extensions en donnant un lien direct vers un fichier XPI en se reposant sur la gestion de contenu interne au navigateur pour invoquer la fenêtre de confirmation, certains procèdent (incorrectement) de même pour les fichiers JAR de thèmes et se demandent pourquoi ils ne sont pas détectés et installés automatiquement. En fait, XPI est une extension spécifique à Mozilla, et ce format peut donc être géré de façon spéciale, mais ce n'est pas le cas de JAR. Tous les fichiers .jar ne sont pas des thèmes pour Firefox, donc si vous cliquez sur un lien vers un .jar vous verrez un dialogue d'enregistrement de fichier. Pour cette raison, vous devriez toujours utiliser l'API <code>InstallTrigger</code> pour installer des thèmes.</p> -<h3 id="Une_note_.C3.A0_propos_d.27updateEnabled.28.29" name="Une_note_.C3.A0_propos_d.27updateEnabled.28.29">Une note à propos d'updateEnabled()</h3> -<p><code>InstallTrigger</code> expose une fonction appelée <code>updateEnabled</code> que certains peuvent être tentés d'appeler avant <code>InstallTrigger.install</code>. Ce n'est pas nécessaire étant donné que l'installation appelle elle-même <code>updateEnabled</code> en interne. De plus, l'appel à <code>updateEnabled</code> peut causer des problèmes si votre site de distribution n'est pas dans la liste blanche de l'utilisateur, parce que Firefox affiche le message « Installation bloquée » uniquement lorsque <code>installChrome</code> est appelé, ou lorsqu'un fichier XPI est chargé. Donc, si vous avez du code qui ressemble à ceci :</p> -<pre class="eval">if (InstallTrigger.updateEnabled()) - InstallTrigger.install({"MonExtension": "foo.xpi"}); -</pre> -<p>… et que votre site n'est pas dans la liste blanche, lorsque l'utilisateur déclenchera ce code, <code>updateEnabled</code> renverra <code>false</code> étant donné que votre site n'est pas dans la liste autorisée, et puisque c'est <code>updateEnabled</code> qui a fait ce constat et pas une demande d'installation, l'utilisateur ne verra rien du tout se produire.</p> -<p>Par conséquent, vous devriez uniquement utiliser <code>updateEnabled</code> pour afficher du contenu dans la page pour avertir l'utilisateur que l'installation est désactivée, ou que votre site n'est pas dans la liste blanche, et ne pas le placer dans le chemin de code menant à l'installation.</p> -<p>(* de toute manière, ceci ne doit pas vous empêcher de développer des systèmes d'installation plus ambitieux, cette documentation est uniquement fournie comme un guide dans l'espoir que la plupart des distributeurs d'extensions l'utiliseront. Elle se comporte en effet bien dans la plupart des cas.)</p> -<p></p> diff --git a/files/fr/archive/add-ons/paquetage_multi_extensions/index.html b/files/fr/archive/add-ons/paquetage_multi_extensions/index.html deleted file mode 100644 index 946292425d..0000000000 --- a/files/fr/archive/add-ons/paquetage_multi_extensions/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Paquetage multi extensions -slug: Archive/Add-ons/Paquetage_multi_extensions -tags: - - API_du_toolkit - - Extensions -translation_of: Archive/Add-ons/Multiple_Item_Packaging ---- -<div class="warning"> -<p>From the release of Firefox 53, multiple item extension packages are no longer supported and will not load. As a consequence, these packages are no longer accepted by AMO.</p> -</div> - -<p>Un paquetage multi extensions fournit la possibilité de conditionner plusieurs <a href="/fr/Bundles" title="fr/Bundles">paquets installables</a> qui peuvent alors être chargés et installés par un utilisateur, ou fournis pré-empaquetés avec une application ou un programme externe. Chaque paquetage multi extensions doit utiliser un fichier <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a> et a les mêmes exigences et possibilités qu'une <a href="/fr/Empaqueter_une_extension" title="fr/Empaqueter_une_extension">extension</a>, à l'exception de ce qui suit :</p> - -<p>Si l'utilisateur installe une version précédente de l'extension, il n'existe aucun moyen de le prévenir ni de l'en empêcher.</p> - -<p> </p> - -<h3 id="Structure_d.27un_paquetage_multi_extensions" name="Structure_d.27un_paquetage_multi_extensions">Structure d'un paquetage multi extensions</h3> - -<p>La structure d'un paquetage multi extensions est la forme simplifiée d'un <a href="/fr/Bundles" title="fr/Bundles">paquet installable</a> et requiert un fichier avec l'extension <code>.xpi</code>. Un paquetage multi extensions peut contenir aussi bien des extensions (fichiers <code>.xpi</code>) que des thèmes (fichiers <code>.jar</code>). La structure de base est indiquée ci-dessous:</p> - -<pre class="eval">/<a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a> <em>Manifeste d'installation</em> -/extension1.xpi <em><a href="/fr/Empaqueter_une_extension" title="fr/Empaqueter_une_extension">Extension</a></em> -/extension2.xpi <em><a href="/fr/Empaqueter_une_extension" title="fr/Empaqueter_une_extension">Extension</a></em> -/theme1.jar <em><a href="/fr/Empaqueter_un_th%C3%A8me" title="fr/Empaqueter_un_thème">Theme</a></em> -/theme2.jar <em><a href="/fr/Empaqueter_un_th%C3%A8me" title="fr/Empaqueter_un_thème">Theme</a></em> -... -</pre> - -<p>Le gestionnaire d'extension lira le <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">manifeste d'installation</a> pour déterminer si c'est un paquetage multi extensions et démarrera alors automatiquement l'installation de chaque paquet qu'il contient. Aucun autre fichiers, hormis le <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">manifeste d'installation</a> et les fichiers <code>.jar</code> ou <code>.xpi</code>, ne sera extrait ni utilisé.</p> - -<h3 id="install.rdf" name="install.rdf"><a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a></h3> - -<p>Un paquetage multi extensions n'a pas les mêmes obligations qu'une <a href="/fr/Empaqueter_une_extension" title="fr/Empaqueter_une_extension">extension</a> pour son <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">manifeste d'installation</a>. Les seuls éléments requis sont <code>em:id</code>, <code>em:targetApplication</code>, et <code>em:type</code>.</p> - -<p>Pour que les gestionnaires d'extensions de Firefox et Thunderbird 1.5 déterminent la nature du paquetage multi extensions, l'élément <code>em:type</code> spécifié dans votre <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a> doit être à <code>32</code> et indiqué comme <code><em:type NC:parseType="Integer">32</em:type></code>. L'espace de nommage XML <code><span class="nowiki">xmlns:NC="http://home.netscape.com/NC-rdf#"</span></code> doit aussi être déclaré dans votre <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a> comme indiqué ci-dessous:</p> - -<pre>... -<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:NC="http://home.netscape.com/NC-rdf#" - xmlns:em="http://www.mozilla.org/2004/em-rdf#"> - - <Description about="urn:mozilla:install-manifest"> - <!-- nsIUpdateItem type for a Multiple Item Package --> - <em:type NC:parseType="Integer">32</em:type> -...</pre> - -<p>Pour les gestionnaires d'extensions de Firefox et Thunderbird 2.0, vous pouvez utiliser la précédente syntaxe ou <code><em:type>32</em:type></code> comme indiqué ci-dessous:</p> - -<pre>... -<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:em="http://www.mozilla.org/2004/em-rdf#"> - - <Description about="urn:mozilla:install-manifest"> - <!-- nsIUpdateItem type for a Multiple Item Package --> - <em:type>32</em:type> -...</pre> - -<p>En spécifiant <code>em:targetApplication</code>, l'élément <code>minVersion</code> indiqué doit être l'élément <code>minVersion</code> le plus élevé et l'élément <code>maxVersion</code> indiqué doit être l'élément <code>maxVersion</code> le plus bas de tous les <a href="/fr/Bundles" title="fr/Bundles">paquets installables</a> par le paquetage multi extensions pour l'élément <code>em:targetApplication</code>. Sinon chaque paquet incompatible ne sera pas installé, à moins qu'un test de compatibilité découvre une information de compatibilité mise à jour qui le rendrait compatible.</p> - -<h3 id="Installation" name="Installation">Installation</h3> - -<p>L'installation peut être effectuée en utilisant les méthodes existantes pour les extensions/thèmes et la même interface utilisateur est employée pour un paquetage multi extensions (les paquets contenus dans le paquetage multi extensions ne seront pas listés). Cela permet aussi d'afficher l'information de signature pour le paquetage multi extensions.</p> - -<p>Si un gestionnaire (le gestionnaire d'extensions/thèmes par exemple) est affiché après le chargement du paquetage multi extensions, le gestionnaire affichera chaque paquet contenu dans celui-ci, de la même manière que si l'utilisateur avait choisi d'installer plusieurs paquets simultanément. Le gestionnaire n'affichera pas le paquetage multi extensions dans la liste des paquets, un fois le chargement terminé du paquetage multi extensions.</p> - -<h3 id="R.C3.A9f.C3.A9rences_officielles_de_l.27API_du_toolkit" name="R.C3.A9f.C3.A9rences_officielles_de_l.27API_du_toolkit">Références officielles de l'<a href="/fr/API_du_toolkit" title="fr/API_du_toolkit">API du toolkit</a></h3> - -<p></p><p><span class="comment">Official References. Do not add to this list without contacting Benjamin Smedberg. Note that this page is included from the pages listed below. So: Don't Add Breadcrumbs!</span> -</p> -<ul><li> <a href="en/Bundles">Structure of an Installable Bundle</a>: describes the common structure of installable bundles, including extensions, themes, and XULRunner applications -</li><li> <a href="en/Extension_Packaging">Extension Packaging</a>: specific information about how to package extensions -</li><li> <a href="en/Theme_Packaging">Theme Packaging</a>: specific information about how to package themes -</li><li> <a href="en/Multiple_Item_Packaging">Multiple-item Extension Packaging</a>: specific information about multiple-item extension XPIs -</li><li> <a href="en/XUL_Application_Packaging">XUL Application Packaging</a>: specific information about how to package XULRunner applications -</li><li> <a href="en/Chrome_Registration">Chrome Registration</a> -</li></ul><p></p> diff --git a/files/fr/archive/add-ons/télécharger_du_json_et_du_javascript_dans_une_extension/index.html b/files/fr/archive/add-ons/télécharger_du_json_et_du_javascript_dans_une_extension/index.html deleted file mode 100644 index bdc5b7d9b5..0000000000 --- a/files/fr/archive/add-ons/télécharger_du_json_et_du_javascript_dans_une_extension/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Télécharger du JSON et du JavaScript dans une extension -slug: Archive/Add-ons/Télécharger_du_JSON_et_du_JavaScript_dans_une_extension -tags: - - AJAX - - Extensions -translation_of: Archive/Add-ons/Downloading_JSON_and_JavaScript_in_extensions ---- -<p>Une pratique courante utilisée par de nombreuses extensions est d'utiliser <a href="/fr/docs/XMLHttpRequest" title="/fr/docs/XMLHttpRequest">XMLHttpRequest</a> ou un mécanisme similaire pour charger du code JavaScript ou des données au format <a href="/fr/docs/JSON" title="/fr/docs/JSON">JSON</a> depuis un site distant. Le contenu récupéré est ensuite interprété avec la fonction <code><a href="/fr/docs/JavaScript/Reference/Objets_globaux/eval" title="/fr/docs/JavaScript/Reference/Objets_globaux/eval"> eval()</a></code>. Cette pratique est <strong>dangereuse</strong>, et une extension qui l'utiliserait ne pourrait pas franchir l'étape de la revue de code pour être hébergée sur le site <a class="external" href="http://addons.mozilla.org">AMO</a></p> -<p>Cette pratique est dangereuse car le code ainsi interprété obtient les mêmes droits que l'extension, c'est à dire qu'il a un accès complet au chrome, donc à la machine de l'utilisateur, sur laquelle il peut faire ce qu'il veut. L'extension n'a aucun moyen de s'assurer que le site à partir duquel elle récupère du code ou des données n'a pas été piraté, et que le code récupéré est sans danger. AMO prend ce risque très au sérieux.</p> -<p>Il existe heureusement un moyen de contourner ce problème.</p> -<h3 id="Télécharger_du_JSON" name="Télécharger_du_JSON">Télécharger du JSON</h3> -<p>Pour interpréter des données formatées en JSON, les développeurs ne devraient pas utiliser <code>eval()</code> mais plutôt une des méthodes indiquées sur <a href="/fr/docs/JSON" title="/fr/docs/JSON">cette page</a>. Ces méthodes protègent contre du code malicieux, par exemple en garantissant que l'object JSON ne contient que des propriétés, et qu'aucune de ses éventuelles fonctions ne sera exécutée. Pour décoder du JSON, utilisez une fonction faite pour ça, pas <code>eval()</code> !</p> -<h3 id="Télécharger_du_JavaScript" name="Télécharger_du_JavaScript">Télécharger du JavaScript</h3> -<p>Il arrive que du code JavaScript soit téléchargé d'un serveur distant et exécuté dans l'extension. Par exemple si le développeur veut que son extension soit toujours à jour, et ne pas faire appel au mécanisme de mise à jour à chaque modification de code. Dans ce cas, le code téléchargé devrait être exécuté dans un bac à sable pour protéger l'extension et la machine sur laquelle elle s'exécute.</p> -<p>Pour exécuter ce code dans un environnement protégé, il faut faire appel au composant <code><a href="/Fr/Components.utils.evalInSandbox" title="fr/Components.utils.evalInSandbox">Components.utils.evalInSandbox()</a></code>. Le code JavaScript est exécuté dans un bac à sable avec tous les objets "sûrs" avec lesquels il doit communiquer. Cette méthode n'est cependant pas sans danger, et les développeurs devraient lire attentivement la documentation pour s'assurer que le code non sûr ne risque pas de sortir de ce contexte protégé</p> -<p></p> diff --git a/files/fr/archive/add-ons/versions_extension,_mise_à_jour_et_compatibilité/index.html b/files/fr/archive/add-ons/versions_extension,_mise_à_jour_et_compatibilité/index.html deleted file mode 100644 index ab057e896c..0000000000 --- a/files/fr/archive/add-ons/versions_extension,_mise_à_jour_et_compatibilité/index.html +++ /dev/null @@ -1,299 +0,0 @@ ---- -title: 'Versions d''une extension, mise à jour et compatibilité' -slug: 'Archive/Add-ons/Versions_extension,_mise_à_jour_et_compatibilité' -tags: - - Extensions -translation_of: 'Archive/Add-ons/Extension_Versioning,_Update_and_Compatibility' ---- -<h2 id="Versions_d.27un_module" name="Versions_d.27un_module">Versions d'un module</h2> - -<p>Les modules doivent spécifier leurs versions en utilisant le <a href="fr/Format_de_version_du_toolkit">Format de version du toolkit</a>. Il s'agit approximativement d'une chaîne de caractères découpée par des points, comme par exemple :</p> - -<ul> - <li>2.0</li> - <li>1.0b1</li> - <li>3.0pre1</li> - <li>5.0.1.2</li> -</ul> - -<div class="note"><strong>Note :</strong> Avant Firefox 1.5, un format de version plus basique était utilisé : major.minor.release.build[+] où seuls des chiffres étaient permis. Le format de version du toolkit gère la numérotation des versions de Firefox mais il permet une plus grande flexibilité.</div> - -<h2 id="Comment_les_applications_d.C3.A9terminent_la_compatibilit.C3.A9" name="Comment_les_applications_d.C3.A9terminent_la_compatibilit.C3.A9">Comment les applications déterminent la compatibilité</h2> - -<p>Lors de l'installation de modules, les applications regardent les entrées de <code><a href="fr/Install.rdf#targetApplication">targetApplication</a></code> dans le fichier install.rdf du module. L'id de cette entrée doit correspondre exactement à l'id de l'application. De plus, les valeurs <code>minVersion</code> et <code>maxVersion</code> de cette entrée doivent former un intervalle comprenant la version de l'application.</p> - -<p>Si l'application possède une entrée <code>targetApplication</code> pour une version incompatible, elle tentera alors d'obtenir des informations de mise à jour à partir de l'<code><a href="fr/Install.rdf#updateURL">updateURL</a></code> du module.</p> - -<p>Si le fichier install.rdf contient des entrées <code><a href="fr/Install.rdf#targetPlatform">targetPlatform</a></code>, la plateforme devant faire tourner l'application doit y être listée. Dans le cas contraire, l'installation sera refusée.</p> - -<p></p><div class="blockIndicator standardNote standardNoteBlock"> - <p><a href="https://developer.mozilla.org/fr/docs/Mozilla/Firefox/Releases/3">Note concernant Firefox 3</a></p> - <p style="font-weight: 400;">Dans des applications basées sur Gecko 1.9, vous pouvez également utiliser une entrée <code>targetApplication</code> avec une id <code>toolkit@mozilla.org</code>, et des valeurs <code>minVersion</code> et <code>maxVersion</code> qui correspondent à la version du toolkit faisant tourner l'application. Cela vous permet que d'installer votre module sur n'importe quelle application basée sur ce toolkit.</p> -</div><p></p> - -<h3 id="Passer_outre_les_tests_de_compatibilit.C3.A9" name="Passer_outre_les_tests_de_compatibilit.C3.A9">Passer outre les tests de compatibilité</h3> - -<p> Pour des besoins de tests, vous pouvez dire à l'application d'ignorer quelque peu les vérifications de compatibilité lors de l'installation de modules. Créez simplement une préférence booléenne <code>extensions.checkCompatibility</code> avec la valeur false.</p> - -<div class="note"><strong>Note :</strong> Avant Firefox 1.5, la préférence <code>app.extensions.version</code> servait à outrepasser la version que l'application croyait pouvoir installer normalement.</div> - -<h2 id="Choix_de_minVersion_et_maxVersion" name="Choix_de_minVersion_et_maxVersion">Choix de minVersion et maxVersion</h2> - -<p><code>minVersion</code> et <code>maxVersion</code> doivent spécifier la plage de versions de l'application sur laquelle vous avez fait des tests. En particulier, vous ne devriez jamais spécifier un <code>maxVersion</code> plus grand que la version actuelle de l'application, puisque vous ne connaissez pas les modifications possibles à venir des API et de l'interface utilisateur. Avec la <a href="#Mise_.C3.A0_jour_de_compatibilit.C3.A9">mise à jour de compatibilité</a>, il n'est pas nécessaire de fournir une version entière nouvelle de l'extension simplement pour augmenter son <code>maxVersion</code>.</p> - -<p>Pour la valeur <code>maxVersion</code>, il est généralement permis d'utiliser un * à la place de la version mineure de l'application supportée, par exemple 2.0.0.* signifiera que vous supporterez toutes les mises à jour mineures de la version 2.</p> - -<p>N'allez pas imaginer que * dans une version représente n'importe quelle version. Le * représente en fait un nombre infiniment grand et n'a réellement un sens que lorsqu'il est utilisé dans <code>maxVersion</code>. Si vous l'utilisez dans <code>minVersion</code>, vous n'obtiendrez pas le résultat escompté.</p> - -<h2 id="V.C3.A9rification_automatique_des_mises_.C3.A0_jour_de_modules" name="V.C3.A9rification_automatique_des_mises_.C3.A0_jour_de_modules">Vérification automatique des mises à jour de modules</h2> - -<p>Les applications vont vérifier périodiquement les mises à jour à installer des modules en récupérant le fichier <code><a href="fr/Install.rdf#updateURL">updateURL</a></code>. L'information renvoyée peut servir à prévenir l'utilisateur d'une mise à jour d'un module, aussi bien qu'indiquer à l'application qu'il existe des nouvelles versions d'applications compatibles avec ce module.</p> - -<h3 id="Mise_.C3.A0_jour_de_compatibilit.C3.A9" name="Mise_.C3.A0_jour_de_compatibilit.C3.A9">Mise à jour de compatibilité</h3> - -<p>Pendant la phase de vérification automatique, les applications examinent à la fois s'il existe des nouvelles versions et des mises à jour de compatibilité concernant la version installée d'un module. Cela signifie que votre manifeste de mise à jour contient une entrée pour la version actuellement installée du module, et l'entrée <code>targetApplication</code> spécifie un maxVersion plus grand, l'application utilisera cette valeur à la place de celle spécifiée dans le fichier install.rdf du module. De ce fait, des modules qui étaient désactivés car incompatibles peuvent s'activer, et des modules qui ne s'installaient normalement pas peuvent être installés.</p> - -<h3 id="Format_RDF_de_mise_.C3.A0_jour" name="Format_RDF_de_mise_.C3.A0_jour">Format RDF de mise à jour</h3> - -<p>Si vous hébergez l'<code>updateURL</code> de votre module vous-même, vous devrez alors retourner l'information de version dans un format RDF. Vous trouverez ci dessous un exemple de manifeste de mise à jour. Il liste les informations de 2 différentes versions de l'extension ayant pour id <code><a class="link-mailto" href="mailto:foobar@developer.mozilla.org" rel="freelink">foobar@developer.mozilla.org</a></code>. Les versions incluses sont 2.2 et 2.5, et chacune d'elles définit une compatibilité avec les versions de 1.5 à 2.0.0.* de Firefox. Pour la version 2.2, un lien https de mise à jour est employé tandis que pour la version 2.5, c'est un lien régulier http avec un hash pour vérifier le fichier récupéré.</p> - -<p>Il est important de récupérer correctement l'attribut about du RDF:Description initial. Cette information précisera de quel type de module il s'agit :</p> - -<ul> - <li>Pour une extension, il s'agit de <code>urn:mozilla:extension:<id></code></li> - <li>Pour un thème, il s'agit de <code>urn:mozilla:theme:<id></code></li> - <li>Pour tout autre type de module, il s'agit de <code>urn:mozilla:item:<id></code></li> -</ul> - -<p>Dans chacun des exemples qui vont suivre, la séquence des versions au sein de l'élément <RDF:Seq> est significative, les versions plus récentes devant être présentées après les versions plus anciennes. Il n'est pas nécessaire de lister toutes les versions intermédiaires si la dernière version est fournie.</p> - -<pre><?xml version="1.0" encoding="UTF-8"?> - -<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:em="http://www.mozilla.org/2004/em-rdf#"> - - <!-- Cette ressource de description inclut toutes les informations de mise à jour - et de compatibilité pour un unique module ayant l'id foobar@developer.mozilla.org. - Vous pouvez lister plusieurs informations de module dans un même fichier RDF. --> - <RDF:Description about="urn:mozilla:extension:foobar@developer.mozilla.org"> - <em:updates> - <RDF:Seq> - - <!-- Chaque li est une version différente du même module --> - <RDF:li> - <RDF:Description> - <em:version>2.2</em:version> <!-- Ceci est le numéro de version du module --> - - <!-- Un targetApplication pour chacune des applications avec laquelle le module est compatible --> - <em:targetApplication> - <RDF:Description> - <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id> - <em:minVersion>1.5</em:minVersion> - <em:maxVersion>2.0.0.*</em:maxVersion> - - <!-- Ceci est l'emplacement de téléchargement du module --> - <em:updateLink>https://www.mysite.com/foobar2.2.xpi</em:updateLink> - - <!-- Une page décrivant les nouveautés de la mise à jour --> - <em:updateInfoURL>http://www.mysite.com/updateinfo2.2.xhtml</em:updateInfoURL> - </RDF:Description> - </em:targetApplication> - </RDF:Description> - </RDF:li> - - <RDF:li> - <RDF:Description> - <em:version>2.5</em:version> - <em:targetApplication> - <RDF:Description> - <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id> - <em:minVersion>1.5</em:minVersion> - <em:maxVersion>2.0.0.*</em:maxVersion> - <em:updateLink>http://www.mysite.com/foobar2.5.xpi</em:updateLink> - <em:updateHash>sha1:78fc1d2887eda35b4ad2e3a0b60120ca271ce6e6</em:updateHash> - </RDF:Description> - </em:targetApplication> - </RDF:Description> - </RDF:li> - - </RDF:Seq> - </em:updates> - - <!-- Une signature est nécessaire seulement si votre module inclut un updateKey dans - son fichier install.rdf. --> - <em:signature>MIGTMA0GCSqGSIb3DQEBBQUAA4GBAMO1O2gwSCCth1GwYMgscfaNakpN40PJfOWt - ub2HVdg8+OXMciF8d/9eVWm8eH/IxuxyZlmRZTs3O5tv9eWAY5uBCtqDf1WgTsGk - jrgZow1fITkZI7w0//C8eKdMLAtGueGfNs2IlTd5P/0KH/hf1rPc1wUqEqKCd4+L - BcVq13ad</em:signature> - </RDF:Description> -</RDF:RDF> -</pre> - -<p>Certaines personnes préfèrent le format alternatif suivant (notez que beaucoup d'informations ont été retirées de cet exemple par souci de clarté) :</p> - -<pre><?xml version="1.0" encoding="UTF-8"?> - -<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:em="http://www.mozilla.org/2004/em-rdf#"> - - <!-- Cette ressource de description inclut toutes les informations de mise à jour - et de compatibilité pour un unique module ayant l'id foobar@developer.mozilla.org. - Vous pouvez lister plusieurs informations de module dans un même fichier RDF. --> - <RDF:Description about="urn:mozilla:extension:foobar@developer.mozilla.org"> - <em:updates> - <RDF:Seq> - <!-- L'attribut resource pointe vers une entrée RDF:Description correspondante - plus bas. L'uri peut être ce que vous voulez --> - <RDF:li resource="urn:mozilla:extension:foobar@developer.mozilla.org:2.2"/> - <RDF:li resource="urn:mozilla:extension:foobar@developer.mozilla.org:2.5"/> - </RDF:Seq> - </em:updates> - <em:signature>MIGTMA0GCSqGSIb3DQEBBQUAA4GBAMO1O2gwSCCth1GwYMgscfaNakpN40PJfOWt - ub2HVdg8+OXMciF8d/9eVWm8eH/IxuxyZlmRZTs3O5tv9eWAY5uBCtqDf1WgTsGk - jrgZow1fITkZI7w0//C8eKdMLAtGueGfNs2IlTd5P/0KH/hf1rPc1wUqEqKCd4+L - BcVq13ad</em:signature> - </RDF:Description> - - <!-- Ceci représente la même description qu'avec le li de l'exemple précédent --> - <RDF:Description about="urn:mozilla:extension:foobar@developer.mozilla.org:2.2"> - <em:version>2.2</em:version> - - <!-- suppression du contenu ici --> - - </RDF:Description> - - <RDF:Description about="urn:mozilla:extension:foobar@developer.mozilla.org:2.5"> - <em:version>2.5</em:version> - - <!-- suppression du contenu ici --> - - </RDF:Description> - -</RDF:RDF> -</pre> - -<h3 id="Fournir_des_d.C3.A9tails_sur_les_mises_.C3.A0_jour" name="Fournir_des_d.C3.A9tails_sur_les_mises_.C3.A0_jour">Fournir des détails sur les mises à jour</h3> - -<p></p> - -<h4 id="En_g.C3.A9n.C3.A9ral" name="En_g.C3.A9n.C3.A9ral">En général</h4> - -<p>Il est possible de fournir à l'utilisateur quelques détails sur les nouveautés d'une mise à jour d'un module. Ils seront visibles lorsque l'utilisateur reçoit une notification de mise à jour et devraient lui permettre d'avoir un aperçu rapide des nouvelles fonctionnalités et des problèmes de sécurité résolus.</p> - -<p>Pour réaliser cela, vous devez ajouter une entrée <code>updateInfoURL</code> à votre manifeste de mise à jour (voir l'exemple plus haut). La page à cette URL sera récupérée et affichée à l'utilisateur. Puisqu'elle est affichée en dehors du contexte d'une page Web normale, son contenu est énormément assaini, ce qui signifie qu'il n'y a pas beaucoup d'options de formatage disponibles et les scripts et images ne sont pas autorisés.</p> - -<ul> - <li>h1, h2 et h3 pour les en-têtes généraux</li> - <li>p pour les paragraphes</li> - <li>ul et ol pour les listes.</li> -</ul> - -<p>À l'intérieur des listes, utilisez les balises habituelles <code>li</code> pour chaque item.</p> - -<p>À l'intérieur des balises h1, h2, h3, p et li, vous pouvez utiliser :</p> - -<ul> - <li>b ou strong pour du texte en gras</li> - <li>i ou em pour du texte en italique</li> -</ul> - -<p>La page d'information récupérée doit pour l'instant être totalement valide en XHTML, et doit être servie avec le type MIME <code>application/xhtml+xml</code>.</p> - -<p>Vous pouvez ajouter <code>%APP_LOCALE%</code> dans votre <code>updateInfoURL</code> si vous désirez que les informations de locale soient fournis dans l'URL — ceci permet de personnaliser le texte selon la locale de l'utilisateur. Vous pouvez également utiliser les autres chaînes de substitution gérées par <code>updateURL</code>, bien qu'elles soient probablement moins utiles.</p> - -<h4 id="Ce_que_voit_l.27utilisateur" name="Ce_que_voit_l.27utilisateur">Ce que voit l'utilisateur</h4> - -<p>Le contenu de <code>updateInfoURL</code> sera affiché pour l'utilisateur dans la page des modules complémentaires, dans une liste des mises à jour disponibles. L'utilisateur peut ensuite cliquer sur le bouton <strong>Afficher les informations</strong> et verra celles-ci sur le côté droit. (notez que l'intitulé du bouton devient <strong>Masquer les informations</strong>)</p> - -<p><img alt="Image:Example_updateInfoURL2.png"></p> - -<h3 id="Mises_.C3.A0_jour_s.C3.A9curis.C3.A9es" name="Mises_.C3.A0_jour_s.C3.A9curis.C3.A9es">Mises à jour sécurisées</h3> - -<p> </p> - -<p>Gecko 1.9 dispose d'un processus supplémentaire destiné à protéger les utilisateurs contre <a class="external" href="http://fr.wikipedia.org/wiki/Attaque_de_l'homme_du_milieu">les attaques de l'homme du milieu</a> ainsi que pendant des mises à jour de modules. Dans le fichier install.rdf du module déjà installé, <code>updateURL</code> doit être défini d'une des façons suivantes :</p> - -<ul> - <li>L'<code><a href="fr/Install.rdf#updateURL">updateURL</a></code> utilise https, ou il n'y a aucun <code>updateURL</code> (ce qui par défaut correspond à addons.mozilla.org qui est en https)</li> - <li>L'<code><a href="fr/Install.rdf#updateURL">updateURL</a></code> utilise http et l'entrée <code><a href="fr/Install.rdf#updateKey">updateKey</a></code> est spécifiée pour permettre de vérifier les données du manifeste d'installation.</li> -</ul> - -<p>Lorsque vous spécifier une <code>updateKey</code> dans install.rdf, vous devez inclure <a href="#Signature_de_manifestes_de_mise_.C3.A0_jour">une signature numérique</a> dans le manifeste de mise à jour ou l'information sera rejetée.</p> - -<p>Dans le manifeste de mise à jour délivré par <code>updateURL</code>, <code>updateLink</code> doit être défini d'une des façons suivantes :</p> - -<ul> - <li>Le lien <code>updateLink</code> vers un fichier XPI doit utiliser https</li> - <li>Le lien <code>updateLink</code> peut utiliser http et vous devez inclure une entrée <code><a href="#Hachages_de_mise_.C3.A0_jour">updateHash</a></code> pour le fichier XPI en utilisant des algorithmes de hachage sha1, sha256, sha384 ou sha512.</li> -</ul> - -<p>Toutes les entrées du manifeste de mise à jour qui ne respectent pas ces deux exigences seront ignorées lors de la vérification des nouvelles versions.</p> - -<p>Notez que les liens https vers des sites ayant des certificats invalides ou qui redirigent les requêtes vers des sites http échoueront également pour les cas update.rdf et <code>updateLink</code></p> - -<h4 id="Hachages_de_mise_.C3.A0_jour" name="Hachages_de_mise_.C3.A0_jour">Hachages de mise à jour</h4> - -<p>Afin de vérifier l'intégrité du XPI téléchargé, vous devez fournir une entrée <code>updateHash</code> en même temps que le lien updateLink. Il s'agit d'un hachage généré à partir des données du fichier selon l'un des algorithmes gérés (sha1, sha256, sha384 et sha512). Dans Firefox 3, si la valeur <code>updateLink</code> n'est pas https le hachage doit être fait à l'aide d'un des membres de la famille d'algorithmes sha. L'algorithme de hachage utilisé est placé en préfixe de la chaîne de caractères et séparé par « <code>:</code> ».</p> - -<pre> <em:updateHash>sha1:78fc1d2887eda35b4ad2e3a0b60120ca271ce6e6</em:updateHash> -</pre> - -<p></p><div class="note"><strong>Note :</strong> La valeur de <code>updateHash</code>, <strong>doit</strong> commencer par la chaîne de l'algorithme de hachage, une erreur courante est d'effacer le préfixe en mettant à jour la valeur de <code>updateHash</code> : <em><strong>sha1:</strong>78fc1d2887eda35b4ad2e3a0b60120ca271ce6e6</em></div><p></p> - -<p>Une erreur est affichée lorsque le hachage d'un fichier téléchargé diffère de son hachage spécifié.</p> - -<p>Différents outils peuvent être utilisés pour générer des hachages :</p> - -<p>De nombreuses variantes d'Unix fournissent sha1sum, sha256sum et ainsi de suite. Les utilisateurs de Windows peuvent utiliser <a class="external" href="http://beeblebrox.org/hashtab/">HashTab</a> pour une utilisation interactive (hors script de compilation). On pensera aussi aux <a class="external" href="http://gnuwin32.sourceforge.net/packages/coreutils.htm">outils GNU pour Windows</a> (en dehors des classiques comme Cygwin), qui peuvent servir en utilisation non interactive :</p> - -<pre class="eval">sha1sum FICHIER -</pre> - -<p>On peut encore citer <a class="external" href="http://md5deep.sourceforge.net/">md5deep</a>, qui est multiplateforme :</p> - -<pre class="eval">sha1deep FICHIER -</pre> - -<p>OpenSSL peut également générer des hachages :</p> - -<pre class="eval">openssl sha1 FICHIER -</pre> - -<p>Sous Windows, <a class="external" href="http://beeblebrox.org/hashtab/">HashTab</a> peut servir d'extension au shell… un clic droit vous donnera des valeurs de hachage pour n'importe quel fichier.</p> - -<p>De plus, un <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=395368">bug d'amélioration est ouvert</a> pour ajouter une génération automatique de hachages pour les fichiers XPI à l'outil McCoy.</p> - -<p>Enfin, tous les langages (de script) populaires offrent cette fonctionnalité, par exemple : <a class="external" href="http://docs.python.org/lib/module-hashlib.html">Python</a>, Perl: CPAN Digest, <a class="external" href="http://de2.php.net/sha1_file">PHP</a>.</p> - -<h4 id="Signature_de_manifestes_de_mise_.C3.A0_jour" name="Signature_de_manifestes_de_mise_.C3.A0_jour">Signature de manifestes de mise à jour</h4> - -<p> </p> - -<p>Si vous souhaitez servir votre RDF de mise à jour depuis un serveur http classique, les applications basées sur Gecko 1.9 auront besoin que vous signez numériquement le manifeste de mise à jour pour garantir que l'information n'est pas altérée entre le moment où vous l'avez créée et celui où les applications la récupèrent. L'outil <a href="fr/McCoy">McCoy</a> doit être utilisé pour signer le RDF de mise à jour.</p> - -<p>Les détails techniques du mécanisme de signature dépasse le cadre de ce document, toutefois les bases sont les suivantes :</p> - -<h5 id="Premi.C3.A8re_.C3.A9tape_.E2.80.94_.C3.A0_faire_une_seule_fois.2C_avant_de_publier_le_module" name="Premi.C3.A8re_.C3.A9tape_.E2.80.94_.C3.A0_faire_une_seule_fois.2C_avant_de_publier_le_module">Première étape — à faire une seule fois, avant de publier le module</h5> - -<p>L'objectif et d'ajouter <code><a href="fr/Install.rdf#updateKey">updateKey</a></code> au fichier install.rdf.</p> - -<p>L'auteur du module crée une paire de clés cryptée RSA publique/privée.</p> - -<p>La partie publique de la clé est encodée en DER et encodée en base 64, puis ajoutée au fichier install.rdf du module dans l'entrée <code><a href="fr/Install.rdf#updateKey">updateKey</a></code>.</p> - -<h5 id="Deuxi.C3.A8me_.C3.A9tape_.E2.80.94_.C3.A0_faire_.C3.A0_chaque_modification_du_fichier_.C2.AB_update.rdf.E2.80.89.C2.BB" name="Deuxi.C3.A8me_.C3.A9tape_.E2.80.94_.C3.A0_faire_.C3.A0_chaque_modification_du_fichier_.C2.AB_update.rdf.E2.80.89.C2.BB">Deuxième étape — à faire à chaque modification du fichier « update.rdf »</h5> - -<p>L'objectif est de définir la valeur de <code><a href="fr/Update.rdf#signature">signature</a></code> dans update.rdf.</p> - -<p>Lorsque l'auteur crée le fichier rdf de mise à jour, un outil sert à le signer en utilisant la partie privée de la clé. Plus simplement, l'information de mise à jour est convertie en chaîne de caractères, puis hachée par un algorithme sha512 et le hachage obtenu est signé grâce à la clé privée. La donnée résultante est encodée en DER, puis encodée en base 64 pour être inclue dans update.rdf et comme une entrée de <code><a href="fr/Update.rdf#signature">signature</a></code>.</p> - -<h2 id="D.C3.A9bogage_et_r.C3.A9solution_de_probl.C3.A8mes" name="D.C3.A9bogage_et_r.C3.A9solution_de_probl.C3.A8mes">Débogage et résolution de problèmes</h2> - -<p>Les mécanismes de mise à jour peuvent envoyer des informations à la console, et afficher différentes informations pouvant vous aider à résoudre un problème. Pour activer l'affichage des messages :</p> - -<ol> - <li>Définissez la valeur de <strong>extensions.logging.enabled</strong> à <strong>true</strong> (en utilisant l'URL <code>about:config</code>).</li> - <li>Lancez Firefox en ligne de commande avec l'option <code>-console</code></li> -</ol> - -<p>Si vous rencontrez des problèmes, examinez la sortie en console pour l'id de votre extension, et regardez si des erreurs ont été enregistrées.</p> diff --git a/files/fr/archive/apps/advanced_topics/index.html b/files/fr/archive/apps/advanced_topics/index.html deleted file mode 100644 index dd21392e76..0000000000 --- a/files/fr/archive/apps/advanced_topics/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Sujets avancés -slug: Archive/Apps/Advanced_topics -tags: - - Applications - - Firefox OS - - Mobile -translation_of: Archive/Apps/Advanced_topics ---- -<p>Ces articles vous donnerons plus d'informations sur des sujets plus avancés concernant les applications Web.</p> - -<div class="row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Architecture" name="Architecture">Documentation sur l'architecture des applications</h2> - -<dl> - <dt><a href="/en-US/docs/Web/Apps/Architecture">Architectures des Applications Web</a></dt> - <dd>Vue d'ensemble de l'architecture à la base du design et de l'implémentation d'un projet d'applications Web.</dd> - <dt><a href="/en-US/docs/Web/Apps/Platform-specific_details">Spécificités de la plateforme pour l'installation d'une application</a></dt> - <dd>Il y a quelques différences dans la façon dont les applications web sont installées selon les diverses plateformes qui les supportent; cette article va vous aider à les comprendre.</dd> - <dt><a href="/en-US/docs/Web/Apps/Apps_for_Android">Applications Web pour Android</a></dt> - <dd>Informations à propos de l'installation et du test d'une applications Web sur un appareil Android.</dd> -</dl> - -<h2 class="Documentation" id="Other" name="Other">Autre documentation</h2> - -<dl> - <dt><a href="/en-US/docs/Web/Apps/Creating_a_store">Créer une plateforme de téléchargement d'applications en ligne</a></dt> - <dd>Informations utiles si vous voulez créer votre propre marché d'application en ligne pour vendre et distribuer des applications Web.</dd> -</dl> - -<p><span class="alllinks"><a href="/en-US/docs/tag/Marketplace">Tout Voir...</a></span></p> -</div> - -<div class="section"> -<p></p><h5 class="Tools" id="Tools" name="Tools">Tools for app developers</h5> -<ul> - <li><a href="https://marketplace.firefox.com/developers/">Visit Firefox Marketplace Developer Hub</a></li> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Using_Firefox_OS_Simulator">Firefox OS Simulator</a></li> - <li><a href="/en-US/docs/Apps/App_developer_tools">App developer tools</a></li> -</ul> -<h5 class="Documentation" id="Documentation" name="Documentation">Technology reference documentation</h5> -<div class="twocolumns"> - <ul> - <li><a href="/en-US/docs/Web/CSS">CSS</a></li> - <li><a href="/en-US/docs/DOM">DOM</a></li> - <li><a href="/en-US/docs/Web/HTML">HTML</a></li> - <li><a href="/en-US/docs/JavaScript">JavaScript</a></li> - <li><a href="/en-US/docs/WebAPI">WebAPI</a></li> - <li><a href="/en-US/docs/Web/WebGL">WebGL</a></li> - <li><a href="/en-US/docs/SVG">SVG</a></li> - <li><a href="https://www.mozilla.org/en-US/apps/">Open Web Apps overview site</a></li> - <li><a href="https://wiki.mozilla.org/Apps">Apps project wiki page</a></li> - </ul> -</div> -<h5 class="Community" id="Community" name="Community">Getting help from the community</h5> -<p>If you still aren't sure how to do what you're trying to get done, feel free to join the conversation!</p> -<ul> - <li>Consult the webapps forum: <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-webapps"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.webapps"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.webapps/feeds"> Flux de syndication</a></li> -</ul> - <ul> - <li>Ask your question on the Open Web Apps IRC channel: <a class="link-irc" href="irc://irc.mozilla.org/openwebapps">#openwebapps</a></li> - </ul> - </li> -</ul> -<p><span class="alllinks"><a href="http://www.catb.org/~esr/faqs/smart-questions.html" rel="external">Don't forget about the <em>netiquette</em>...</a></span></p><p></p> -</div> -</div> - -<p> </p> diff --git a/files/fr/archive/apps/index.html b/files/fr/archive/apps/index.html deleted file mode 100644 index 10bb499435..0000000000 --- a/files/fr/archive/apps/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Apps -slug: Archive/Apps -translation_of: Archive/Apps ---- -<p class="summary">In progress. This page includes archived content for Apps, including obsolete web app content, Firefox OS app-related content, etc.</p> - -<p></p> diff --git a/files/fr/archive/b2g_os/add-ons/développer_des_add-ons_pour_firefox_os/index.html b/files/fr/archive/b2g_os/add-ons/développer_des_add-ons_pour_firefox_os/index.html deleted file mode 100644 index 0f7f9ab464..0000000000 --- a/files/fr/archive/b2g_os/add-ons/développer_des_add-ons_pour_firefox_os/index.html +++ /dev/null @@ -1,357 +0,0 @@ ---- -title: Développer des modules pour B2G OS -slug: Archive/B2G_OS/Add-ons/Développer_des_add-ons_pour_Firefox_OS -tags: - - Apps - - CSS - - Extensions - - Firefox OS - - JavaScript - - Manifeste - - Modules - - personnalisations -translation_of: Archive/B2G_OS/Add-ons/Developing_B2G_OS_add-ons ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p class="summary">Les modules sont un concept bien connu dans le monde des navigateurs web, et ce concept a été ajouté à Firefox OS. Un module Firefox OS unique peut étendre les fonctionalités d'une ou plusieurs applications, voire toutes les applications, en incluant les applications système. Cet article est un guide pour la création de votre propre module Firefox OS, avec des conseils, des astuces, et des informations à prendre en compte.</p> - -<div class="note"> -<p><strong>Note: </strong>Les modules Firefox OS utilisent le système d'extensions WebExtensionns, qui est largement basé sur les extensions de Chrome/Blink, donnant de nombreux avantages sur la façon dont les modules sont créés en terme d'interopérabilité et de fonctionalités. Pour en savoir plus, gardez un œil sur notre documentation grandissante sur <a href="/fr/docs/Mozilla/Add-ons/WebExtensions">WebExtensions</a>.</p> -</div> - -<div class="warning"> -<p><strong>Important :</strong> Les modules ne sont disponibles que sur Firefox OS 2.5+, et vous aurez besoin d'un nouveau build installé sur votre téléphone pour être sûr que vous avez un support pour le débogage d'extensions dans WebIDE, etc. Soyez sûr d'avoir mis à jour avec le dernier build (2015-27-08 ou plus) sur votre téléphone développeur avant de commencer à développer des modules Firefox OS.</p> -</div> - -<h2 id="Développer_des_modules">Développer des modules</h2> - -<p>Les modules sont des paquets composés de Javascipt, CSS, et d'autres assets. Cependant, ils ne sont pas autonomes. À la place, le manifeste du module inclut des fonctionnalités spéciales qui définissent les applications auxquelles appliquer le module. Quand les applications sont lancées sur un appareil Firefox OS qui a un module installé, le module est injecté dans l'application qui concorde avec le modèle spécifié dans le champ du fichier <a href="#manifest.json">manifest.json</a>.</p> - -<p>Les modules Firefox OS utilisent les mêmes syntaxe et structure dans leur code que la nouvelle école de modules Firefox utilisant l'<a href="https://wiki.mozilla.org/WebExtensions">API WebExtensions</a>, qui est basée sur le modèle d'<a href="https://developer.chrome.com/extensions">extensions de Chrome</a>.</p> - -<h3 id="Un_exemple_simple">Un exemple simple</h3> - -<p>Pour comprendre les bases des modules Firefox OS, nous allons présenter un simple exemple qui ajoute une bannière a l'application système, sur laquelle on peut cliquer pour la cacher.</p> - -<p><img alt="firefox os screenshot showing add-on banner" src="https://mdn.mozillademos.org/files/11445/add-on-screenshot.png" style="display: block; height: 445px; margin: 0px auto; width: 250px;"></p> - -<p>C'est vraiment basique et trivial, mais cela vous donnera ce qu'il faut pour commencer. Vous pouvez regarder le <a href="https://github.com/mdn/simple-addon">code de l'exemple sur Github</a>, et installer le module sur votre appareil Firefox OS en clonant le dépôt localement, puis en utilisant WebIDE (voir la section <a href="#Testing_your_add-on_using_WebIDE">Testing your add-on using WebIDE</a>.) Vous pouvez <a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission">distribuer le module en utilisant le Marketplace Firefox.</a></p> - -<p>Sachez qu'un module Firefox OS peut faire bien plus que ce qui est listé ici. La documentation de <a href="/fr/docs/Mozilla/Add-ons/WebExtensions">WebExtensions</a> comportera plus d'informations au fil du temps.</p> - -<h2 id="L'anatomie_d'un_module_Firefox_OS">L'anatomie d'un module Firefox OS</h2> - -<p>Dans cette partie, nous allons parcourir le contenu du dépôt du module d'exemple, en expliquant chaque élément. La structure des dossiers ressemble à ça :</p> - -<ul class="directory-tree"> - <li>simple-addon/ - <ul> - <li>manifest.json</li> - <li>update.webapp</li> - <li>css/ - <ul> - <li>style.css</li> - </ul> - </li> - <li>js/ - <ul> - <li>index.js</li> - </ul> - </li> - <li>icons/ - <ul> - <li>128.png</li> - </ul> - </li> - <li>extension.zip</li> - </ul> - </li> -</ul> - -<h3 id="manifest.json">manifest.json</h3> - -<p>Remarquez qu'il y a deux fichiers de manifeste dans notre dossier d'exemple de module. Le premier, manifest.json, suit la structure de manifeste Chrome, et est placé dans l'archive <a href="#extensions.zip">extensions.zip</a> avec le CSS, le Javascript et l'icône compris dans le module. Il peut contenir une large palette d'instructions (voir <a href="https://developer.chrome.com/extensions/manifest">Chrome Manifest File Format</a>), mais pour le moment nous allons nous concentrer sur une petite partie :</p> - -<pre class="brush: json">{ - "manifest_version": 1, - "name": "Add-on banner", - "description": "Firefox OS add-on example", - "version": "1.0", - "author": "Chris Mills", - "content_scripts": [{ - "matches": ["app://system.gaiamobile.org/index.html"], - "css": ["css/style.css"], - "js": ["js/index.js"] - }], - "icons": { - "128": "/icons/128.png" - } -}</pre> - -<p>La plupart de ces champs sont assez explicites, mais nous allons voir les derniers.</p> - -<p>Tout d'abord, le champ <code>content_scripts</code> désigne le code qui sera injecté dans les applications sur lesquelles le module est appliqué, en fournissant le chemin des fichiers CSS et Javascript dans les champs <code>css</code> et <code>js</code>. Le champ <code>matches</code> contient un modèle qui spécifie dans quelles applications le code sera injecté. Ce modèle peut prendre différentes formes (voir <a href="https://developer.chrome.com/extensions/match_patterns">Chrome Match Patterns</a>), mais pour l'instant nous spécifions simplement <code>app://system.gaiamobile.org/index.html</code>, ce qui affecte uniquement l'application système. Vous pourriez l'appliquer à toutes les applications en utilisant <code>app://*/*</code>.</p> - -<div class="note"> -<p><strong>Note </strong>: Vous pouvez désigner plusieurs scripts et feuilles de styles en incluant simplement plusieurs éléments dans les tableaux, par exemple <code>"css": ["css/style.css", "css/more.css"]</code>.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Firefox OS ne supporte pas le mot-clé de Chrome <all_urls>.</p> -</div> - -<p>En bas du manifeste nous avons inclus le champ <code>icons</code>, voir la section suivante pour plus d'infos à ce sujet.</p> - -<h3 id="update.webapp">update.webapp</h3> - -<div class="note"> -<p><strong>Note</strong> : Vous n'avez pas besoin du manifeste .webapp si vous voulez <a href="/en-US/docs/Mozilla/Marketplace/Add-on_submission">soumettre un module au Marketplace Firefox</a>, simplement du fichier .zip</p> -</div> - -<p>Le manifeste <code>update.webapp</code> est un <a href="https://developer.mozilla.org/fr/Apps/Manifeste">manifeste de style Firefox OS</a>, ce qui est sensiblement équivalent à un mini manifeste d'application empaquetée (voir <a href="/fr/Marketplace/Options/Self_publishing#Auto-publication_d'applications_empaquet.C3.A9es">Auto-publication d'applications empaquetées</a>.)</p> - -<p>Notre <code>update.webapp</code> ressemblera à ça :</p> - -<pre class="brush: json">{ - "name" : "Add-on banner", - "description": "Firefox OS add-on example", - "developer": { "name": "Chris Mills" }, - "package_path": "extension.zip", - "icons": { - "128": "/icons/128.png" - } -}</pre> - -<p>Encore une fois, ceci est assez explicite.</p> - -<p>Le champ le plus important ici est probablement <code>package_path</code>, qui référence l'archive qui contient l'extension.</p> - -<p>Vous remarquerez que le champ <code>icons</code> est inclus ici de la même façon que dans <a href="#manifest.json">manifest.json</a>, <code>update.webapp</code> est le seul endroit où vous <em>avez</em> besoin des informations d'icônes pour le moment, mais nous vous recommendons de les inclure dans les deux au cas où cela deviendrait nécessaire. Le champ icons dirige vers l'<code>icône</code> du module pour être utilisé dans l'application Paramètres de Gaia.</p> - -<h3 id="Inclure_une_icône">Inclure une icône</h3> - -<p>Vous devez inclure au moins une icône et la référencer dans votre manifeste, autrement le manifeste ne sera pas validé. Voir la <a href="/fr/Apps/Manifeste#icons">section de référence des icônes de Manifeste</a> pour plus d'informations. </p> - -<h3 id="CSS">CSS</h3> - -<div class="warning"> -<p><strong>Important : </strong>A cause du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1179536">bug 1179536</a>, injecter des feuilles de styles ailleurs que dans l'application système est impossible, cela fonctionnera tout de même pour ce tutoriel car le module n'affecte que l'application système, mais pour ajouter des règles de style à une autre application ou page web vous aurez besoin de modifier le style en utilisant JavaScript.</p> -</div> - -<p>Il n'y a rien de spécial à propos du CSS dans cet exemple. La seule chose à garder à l'esprit est de faire attention aux noms de classe et sélecteurs de votre module pour ne pas entrer en conflit avec le CSS de/des application(s).</p> - -<p>Par exemple, nous avons enveloppé notre bannière d'exemple dans une <a href="/fr/docs/Web/HTML/Element/div" title="L'élément HTML <div> (qui signifie division du document) est un conteneur générique qui permet d'organiser le contenu sans représenter rien de particulier. Il peut être utilisé afin de grouper d'autres éléments pour leur appliquer un style (en utilisant les attributs class ou id) ou parce qu'ils partagent des attributs aux valeurs communes, tel que lang. Il doit uniquement être utilisé lorsqu'aucun autre élément sémantique (par exemple <article> ou <nav>) n'est approprié."><code><div></code></a> avec la classe <code>fxos-banner</code>. Mais vous pourriez tout aussi bien utiliser votre propre code pour votre nom de classe.</p> - -<h3 id="JavaScript">JavaScript</h3> - -<p>Encore une fois, le ficher JavaScript qui fait fonctionner le module ne contient aucune fonctionnalité spéciale (voir le code source JavaScript sur Github). Il est injecté dans l'applicaction avec le CSS spécifié dans le fichier <a href="#manifest.json">manifest.json</a>.</p> - -<div class="note"> -<p><strong>Note :</strong> Le code du module est injecté à chaque fois qu'une application qui est référencée par le modèle du manifest.json est lancé. Il est aussi injecté quand les modules sont activés. Quand le module est injecté par le lancement de l'application, tous les fichiers du module sont injectés dans l'application avant que quoi que ce soit dans l'app ne soit initialisé, en incluant le DOM. C'est au développeur du module de gérer les différents cas de lancement (injection immédiate contre injection au lancement), il y a plus d'informations plus bas.</p> -</div> - -<p>Plusieurs autres points sont abordés plus bas.</p> - -<h4 id="L'objet_window">L'objet window</h4> - -<p>Les modules ne partagent qu'une représentation du contenu de <code>window</code>. En conséquence, tout ce qui est enregistré dans l'objet <a href="/fr/docs/Web/API/Window">window</a> par un module est indisponible dans le code de l'application. Cependant, tout ce qui est dans l'objet <code>window</code> par le code de l'application est disponible aux modules. Le DOM est accessible comme d'habitude.</p> - -<h4 id="Injection_DOM">Injection DOM</h4> - -<p>Vous pouvez utiliser les APIs JavaScript pour manipuler le DOM de l'application.</p> - -<h4 id="Injecter_du_code_au_bon_moment">Injecter du code au bon moment</h4> - -<p>Vous devez être prudent pour gérer correctement les cas où un module est injecté dans une application après qu'elle ait été chargée. Un tel scénario peut se produire quand une application est déjà lancée et qu'un module qui la concerne est activé. Dans ce cas, un gestionnaire <a href="/fr/docs/Web/API/GlobalEventHandlers/onload">window.onload</a> ne fonctionnera pas parce que l'événement <a href="/fr/docs/Web/Events/DOMContentLoaded">DOMContentLoaded</a> s'est déjà produit.</p> - -<p>Pour l'instant, il n'existe pas de bonne solution à ce problème. En attendant, nous conseillons de vérifier si le DOM a été chargé ou non avant de définir un callback <code>DOMContentLoaded</code>. Ce modèle est utilisé dans la démo :</p> - -<pre class="brush: js">// En cas d'injection dans une appli déjà lancée au moment où -// l'appli a été activée, l'initialiser simplement. -if (document.documentElement) { - initialize(); -} - -// Sinon, nous devons attendre que le DOM soit prêt avant de -// lancer l'initialisation car les modules sont en général (toujours ?) -// injectés *avant* que `document.documentElement` ne soit défini. -else { - window.addEventListener('DOMContentLoaded', initialize); -} - -function initialize() { - // ... -} -</pre> - -<h4 id="Empêcher_les_injections_multiples">Empêcher les injections multiples</h4> - -<p>Enfin, pour empêcher un module d'être injecté à plusieurs reprises dans une instance unique d'application, nous devons vérifier si votre module est déjà présent ou non, de cette manière :</p> - -<pre class="brush: js">function initialize() { - if (document.querySelector('.fxos-banner')) { - // Déjà injectée, annulation. - return; - } else { - var body = document.querySelector('body'); - var fxosBanner = document.createElement('div'); - fxosBanner.classList.add('fxos-banner'); - var bannerText = document.createElement('p'); - var closeBtn = document.createElement('button'); - - fxosBanner.appendChild(bannerText); - fxosBanner.appendChild(closeBtn); - body.appendChild(fxosBanner); - - closeBtn.textContent = 'X'; - bannerText.textContent = 'Waouh, vous avez une extension installée !'; - - closeBtn.onclick = function() { - fxosBanner.parentNode.removeChild(fxosBanner); - } - } -} -</pre> - -<p>Ici donc, nous faisons usage de <code>if (document.querySelector('.fxos-banner'))</code> pour vérifier si la bannière d'exemple existe déjà. Dans l'affirmative, nous quittons la fonction. Si ce n'est pas le cas, la méthode <code>querySelector()</code> renvoie alors <code>null</code>, et nous exécutons le bloc de code qui crée la bannière.</p> - -<h4 id="Fonctions_de_gestion_des_applis_dans_les_modules">Fonctions de gestion des applis dans les modules</h4> - -<p>Toutes les fonctions <code><a href="/fr/docs/Web/API/DOMApplicationsRegistry">Apps</a></code> et <code><a href="/en-US/docs/Web/API/DOMApplicationsRegistry/mgmt">Mgmt</a></code> se comportent avec les modules de la même façon qu'avec les applications. Notez cependant qu'elles ne sont disponibles pour les modules que lorsque ces derniers sont injectés dans une application certifiée possédant la permission <code>webapps-manager</code> spécifiée dans le manifeste.</p> - -<p>En plus de ces fonctions, un callback <code><a href="http://mxr.mozilla.org/mozilla-central/source/dom/webidl/Apps.webidl#141">onenabledstatechange</a></code> est exposé aux modules qui sont activés et désactivés. Comme cet événement est déclenché pour tous les modules, il vous faut vérifier lequel d'entre-eux a été activé/désactivé avant de procéder à toute initialisation ou nettoyage.</p> - -<pre class="brush: js"><span>navigator.mozApps.mgmt</span>.<span>addEventListener('enabledstatechange</span>', <span>function</span>(<span>event</span>) { - var app = event.application; - if (app.manifestURL === 'https://origin.of.manifest/manifest.webapp') { - var wasEnabled = app.enabled; - // faire quelque chose de cette information - } -}); -</pre> - -<div class="warning"> -<p><strong>Important </strong>: En raison du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1214155">bogue 1214155</a>, il n'est pas possible d'ajouter le gestionnaire d'événement enabled state via <code>navigator.mozApps.mgmt.</code><span id="summary_alias_container"><span id="short_desc_nonedit_display"><code>onenabledstatechange = function() {...}</code> : vous devez utiliser la méthode <code>addEventListener</code> comme mentionné ci-dessus.</span></span></p> -</div> - -<h3 id="extension.zip">extension.zip</h3> - -<div class="note"> -<p><strong>Note</strong> : Le fichier <code>extension.zip</code> a été laissé dans le dépôt de démo principalement dans un but d'illustration ; la façon dont fonctionne le système est ainsi claire. En réalité, vous n'avez pas besoin d'inclure le zip dans votre répertoire car WebIDE va le générer à votre place lorsque vous installerez le module.</p> -</div> - -<p>L'archive <code>extension.zip</code> contient le code de l'extension et est référencée dans le champ <a href="#update.webapp">update.webapp</a> <code>package_path</code> — C'est ainsi que Gecko trouve le code à installer. Archivés à l'intérieur, vous trouverez :</p> - -<ul class="directory-tree"> - <li>css/ - <ul> - <li>style.css</li> - </ul> - </li> - <li>js/ - <ul> - <li>index.js</li> - </ul> - </li> - <li>icons/ - <ul> - <li>128.png</li> - </ul> - </li> - <li>manifest.json</li> -</ul> - -<p>Le fichier <code>manifest.json</code> se trouve donc à l'intérieur de l'archive et sert à faire référence aux fichiers à injecter et à spécifier quelles sont les applications à affecter.</p> - -<h3 id="Tester_votre_module_avec_WebIDE">Tester votre module avec WebIDE</h3> - -<p>L'outil WebIDE de Mozilla est disponible par défaut dans Firefox pour ordinateur. Pour s'en servir afin d'installer des modules sur votre téléphone, suivez les étapes énumérées ci-dessous :</p> - -<ol> - <li>Assurez-vous d'avoir installé Firefox 43 ou plus récent (il s'agissait de <a href="https://nightly.mozilla.org/">Nightly</a> au moment de la rédaction de cet article). Les modules ne sont pas pris en charge par WebIDE avant cette version.</li> - <li>Ouvrez votre navigateur puis l'outil WebIDE (cliquez sur le bouton WebIDE ou allez dans le menu <em>Outils > Développement web > WebIDE</em>.)</li> - <li>Vérifiez que le débogage distant est activé sur votre téléphone (<em>Paramètres > Développeur > Définissez "Débogage via USB " sur "ADB et outils de développement".</em>)</li> - <li>Branchez votre téléphone sur votre ordinateur avec un câble USB. Vérifiez que vous n'avez pas branché d'autres téléphones en même temps.</li> - <li>Dans l'interface de WebIDE, choisissez l'option <em>Sélectionner l'environnement</em> puis sélectionnez votre téléphone, celui-ci devant être listé dans la catégorie <em>Périphériques USB</em>.</li> - <li>À ce stade, votre téléphone devrait afficher une demande <em>Autoriser la connexion de débogage USB ?</em>. Choisissez <em>Autoriser</em>.</li> - <li>Sélectionnez l'option <em>Ouvrir une application</em> puis choisissez <em>Ouvrir une application empaquetée...</em></li> - <li>Dans le sélecteur de fichiers qui apparaît, naviguez jusqu'au répertoire qui contient votre fichier de manifeste <code>update.webapp</code> et cliquez sur <em>Ouvrir</em>.</li> - <li>En supposant qu'il n'y ait aucun avertissement ni erreur, vous pouvez installer votre module sur votre appareil en cliquant sur le bouton "Lecture" situé au centre (<em>Installer et lancer</em>.)</li> - <li>Pour voir le module en action, activez-le en choisissant <em>Paramètres > Modules > Module exemple > basculez la case à cocher en haut</em>.</li> -</ol> - -<h2 id="Déboguer_les_modules">Déboguer les modules</h2> - -<p>Il faut noter qu'à cause du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1185464" title="The new extension API should come with debuggability">bug 1185464</a> il n'est pas possible pour l'instant de déboguer les modules avec WebIDE.</p> - -<h2 id="Paramètres_du_module">Paramètres du module</h2> - -<p>Vous pouvez contrôler les modules de votre téléphone en allant dans <em>Paramètres > Modules </em>; vous trouverez à cet endroit une liste de vos modules installés et vous pourrez voir plus d'informations sur chacun d'eux en tapant sur l'entrée correspondante.</p> - -<p style="width: 520px; margin: 0 auto;"><img alt="firefox os screenshot showing a list of installed add-ons in the settings app" src="https://mdn.mozillademos.org/files/11447/add-on-settings-screen.png" style="height: 445px; margin-right: 20px; width: 250px;"><img alt="information screen for an individual addon, with a list of apps this add-on affects, and controls to disable and delete the add-on" src="https://mdn.mozillademos.org/files/11449/individual-add-on-settings-page.png" style="height: 445px; width: 250px;"></p> - -<h3 id="Activerdésactiver_et_supprimer_des_modules">Activer/désactiver et supprimer des modules</h3> - -<p>Par défaut, les modules sont activés après leur installation s'ils sont installés depuis le Marketplace Firefox. Par contre, lorsqu'ils sont installés via WebIDE, ils sont désactivés par défaut.</p> - -<p>Vous avez la possibilité d'activer/désactiver des modules manuellement par l'intermédiaire de la case à cocher qui se trouve en haut de la page individuelle du module (accessible dans <em>Paramètres > Modules</em>), ou par programmation en utilisant la fonction <a href="/en-US/docs/Web/API/DOMApplicationsManager/setEnabled">navigator.mozApps.mgmt.setEnabled()</a> (voir cet <a href="https://github.com/fxos/directory/blob/master/app/js/controller/list_controller.js#L220-L223">exemple d'utilisation de setEnabled()</a> sur Github.)</p> - -<p>Vous pouvez supprimer totalement un module en tapant le bouton <em>Supprimer</em> qui se trouve sur les pages individuelles des applications.</p> - -<h2 id="Permissions">Permissions</h2> - -<p>Les modules héritent toutes leurs permissions depuis leur application hôte. Demander des permissions dans le manifeste du module (voir <a href="#update.webapp">update.webapp</a>) n'aura aucun effet et n'exposera au module aucune API qui n'est pas disponible dans l'application hôte.</p> diff --git a/files/fr/archive/b2g_os/add-ons/index.html b/files/fr/archive/b2g_os/add-ons/index.html deleted file mode 100644 index f09b9d9a97..0000000000 --- a/files/fr/archive/b2g_os/add-ons/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Modules B2G OS -slug: Archive/B2G_OS/Add-ons -tags: - - Add-ons - - Apps - - Extensions - - Firefox OS - - customizations -translation_of: Archive/B2G_OS/Add-ons ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="note"> -<p dir="ltr"><strong>Note </strong>: Les modules B2G OS sont basés sur l'<a href="/fr/docs/Mozilla/Add-ons/WebExtensions">API WebExtensions</a> qui est également prise en charge par Firefox pour ordinateur à partir de la version 42 et qui se base sur les APIs des extensions utilisées dans Chrome et Opera.</p> -</div> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Pour commencer à développer des extensions, vous devez suivre les étapes ci-dessous pour effectuer la configuration.</p> - -<p> </p> - -<h3 id="1._Activer_le_débogage_USB">1. Activer le débogage USB</h3> - -<p> </p> - -<p>Dans l'application <em>Paramètres</em> de l'appareil, sélectionnez <em>Développeurs > Débogage via USB > ADB et outils de développement</em>. Vous devriez maintenant pouvoir déboguer les applications installées avec WebIDE, soit via un câble USB, soit <a href="/fr/docs/Outils/Débogage_distant/Debugging_Firefox_OS_over_Wifi">en Wifi</a> (câble USB non requis.)</p> - -<h3 id="3._Configurer_WebIDE">3. Configurer WebIDE</h3> - -<p>L'outil <a href="/fr/docs/Outils/WebIDE">WebIDE</a> est un composant de Firefox et peut être utilisé pendant le développement pour installer des modules sur votre téléphone — voir <a href="/fr/Firefox_OS/Add-ons/Développer_des_add-ons_pour_Firefox_OS#Testing_your_add-on_using_WebIDE">Tester votre module avec WebIDE</a> pour plus d'informations.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<h3 id="Développer">Développer</h3> - -<ul> - <li dir="ltr"><strong>Tutorial </strong>: <a href="https://developer.mozilla.org/fr/Firefox_OS/Add-ons/D%C3%A9velopper_des_add-ons_pour_Firefox_OS">https://developer.mozilla.org/fr/Firefox_OS/Add-ons/D%C3%A9velopper_des_add-ons_pour_Firefox_OS</a></li> - <li dir="ltr"><strong>Exemple détaillé </strong>: <a href="https://hacks.mozilla.org/2015/11/building-an-ios-style-unread-notifications-add-on-for-firefox-os/">https://hacks.mozilla.org/2015/11/building-an-ios-style-unread-notifications-add-on-for-firefox-os/</a></li> - <li dir="ltr"><strong>Référence de l'API </strong>: <a href="https://developer.mozilla.org/fr/docs/Mozilla/Add-ons/WebExtensions">https://developer.mozilla.org/fr/docs/Mozilla/Add-ons/WebExtensions</a></li> -</ul> - -<h3 dir="ltr" id="sect1"> </h3> - -<h3 dir="ltr" id="Contribuer">Contribuer</h3> - -<ul> - <li dir="ltr"><strong>Liste de diffusion </strong>: <a href="https://mail.mozilla.org/listinfo/dev-addons">https://mail.mozilla.org/listinfo/dev-fxos</a></li> - <li dir="ltr"><strong>Forum Discourse </strong>: <a href="https://discourse.mozilla-community.org/c/add-ons/development">https://discourse.mozilla-community.org/c/add-ons/development</a></li> - <li dir="ltr"><strong>IRC</strong> : irc.mozilla.org, #webextensions et #fxos</li> - <li dir="ltr"><strong>Rejoindre le groupe Telegram non-officiel </strong>: <a href="https://telegram.me/joinchat/BTLPMAC90O9n8cpgsZ03_A">https://telegram.me/joinchat/BTLPMAC90O9n8cpgsZ03_A</a></li> - <li dir="ltr"><strong>Signalez-nous les nouvelles APIs auxquelles nous devrions donner la priorité </strong>: <a href="https://webextensions.uservoice.com/forums/315663-webextension-api-ideas">https://webextensions.uservoice.com/forums/315663-webextension-api-ideas</a></li> - <li dir="ltr"><strong>Suivez-nous sur Twitter </strong>: <a href="https://twitter.com/MozWebExt">@MozWebExt</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/alarm_api/index.html b/files/fr/archive/b2g_os/api/alarm_api/index.html deleted file mode 100644 index 8a71386e21..0000000000 --- a/files/fr/archive/b2g_os/api/alarm_api/index.html +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: Alarm API -slug: Archive/B2G_OS/API/Alarm_API -translation_of: Archive/B2G_OS/API/Alarm_API ---- -<p>{{DefaultAPISidebar("Alarm API")}}{{Non-standard_Header}}</p> - -<p class="summary">The <strong>Alarm API</strong> allows applications to schedule actions to be run in the future. For example, some applications like alarm-clock, calendar or auto-update might need to utilize the Alarm API to trigger particular device behaviors at specified time points.</p> - -<p>By itself, the Alarm API just allows to schedule alarms. An alarm is dispatched to applications through the System Message API, so applications which want to react to alarms have to register themselves to the <code>alarm</code> messages.</p> - -<p>Alarms are set using the {{DOMxRef("Navigator.mozAlarms")}} object which is an instance of the {{DOMxRef("MozAlarmsManager")}} interface.</p> - -<div class="blockIndicator note"> -<p><em><strong>Note:</strong></em> The term alarm in the Alarms API is not the same as an alarm used by the Clock app. The Alarms API wakes up applications, the Clock wakes up humans. The Clock <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/clock/js/alarm.js">uses the Alarm API</a> to be notified when the time is right to wake up humans.</p> -</div> - -<h2 id="example" name="example">Schedule alarms</h2> - -<p>The first things to do when using alarm is to schedule alarms. There are two kind of alarms based on the respect of the time zone. In both case it's done using the {{DOMxRef("MozAlarmsManager.add()")}} method.</p> - -<div class="blockIndicator note"> -<p><strong>Note:</strong> If an alarm is not targeted at a specific application, the system will dispatch all the alarms to all the applications listening for alarms.</p> -</div> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: You need to use the same URL for setting and receiving an alarm. For example, If you invoke <code>navigator.mozAlarms.add()</code> on <code>foo.html</code> or <code>index.html?foo=bar</code>, but have <code style="white-space: nowrap;">{ "alarm": "/index.html" }</code> in your <a href="/en-US/Apps/Build/Manifest#messages">manifest messages field</a>, you'll never receive the alarm.</p> -</div> - -<h3 id="Alarms_ignoring_time_zones">Alarms ignoring time zones</h3> - -<p>Those kind of alarms is dispatched based on the local time of the device. If the user of the device changes its time zone, the alarm will be dispatched based on the new time zone. For example, if a user is in Paris and sets an alarm that should be dispatched at 12 PM CET (<em>Central European Time</em>) and that user travels to San Francisco, the alarm will be dispatched at 12 PM PDT (<em>Pacific Daylight Time</em>).</p> - -<pre class="brush: js;">// This the date to schedule the alarm -var myDate = new Date("May 15, 2012 16:20:00"); - -// This is arbitrary data pass to the alarm -var data = { - foo: "bar" -} - -// The "ignoreTimezone" string is what make the alarm ignoring it -var request = navigator.mozAlarms.add(myDate, "ignoreTimezone", data); - -request.onsuccess = function () { - console.log("The alarm has been scheduled"); -}; - -request.onerror = function () { - console.log("An error occurred: " + this.error.name); -};</pre> - -<h3 id="Alarms_honoring_time_zones">Alarms honoring time zones</h3> - -<p>Those kind of alarms are dispatched based on the time in the time zone that defines when the alarm has been scheduled. If for some reason, the user of the device changes its time zone the alarm will be dispatched based on the original time zone. For example, if a user is in Paris and set an alarm that should be dispatched at 12pm CET (<em>Central European Time</em>) and if that user travel to San Francisco, the alarm will be dispatched at 3 AM PDT (<em>Pacific Daylight Time</em>).</p> - -<pre class="brush: js;">// This the date to schedule the alarm -var myDate = new Date("May 15, 2012 16:20:00"); - -// This is arbitrary data pass to the alarm -var data = { - foo: "bar" -} - -// The "honorTimezone" string is what make the alarm honoring it -var request = navigator.mozAlarms.add(myDate, "honorTimezone", data); - -request.onsuccess = function () { - console.log("The alarm has been scheduled"); -}; - -request.onerror = function () { - console.log("An error occurred: " + this.error.name); -};</pre> - -<h2 id="Managing_alarms">Managing alarms</h2> - -<p>Once an alarm is scheduled, it's still possible to manage it.</p> - -<p>The {{DOMxRef("MozAlarmsManager.getAll()")}} method will return the complete list of alarms currently scheduled by the application. This list is an <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" title="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a></code> of {{anch("mozAlarm")}} objects.</p> - -<h3 id="mozAlarm">mozAlarm</h3> - -<p>{{page("/en-US/docs/Web/API/MozAlarmsManager.getAll","mozAlarm")}}</p> - -<pre class="brush: js;">var request = navigator.mozAlarms.getAll(); - -request.onsuccess = function () { - this.result.forEach(function (alarm) { - console.log('Id: ' + alarm.id); - console.log('date: ' + alarm.date); - console.log('respectTimezone: ' + alarm.respectTimezone); - console.log('data: ' + JSON.stringify(alarm.data)); - }); -}; - -request.onerror = function () { - console.log("An error occurred: " + this.error.name); -};</pre> - -<p>The {{DOMxRef("MozAlarmsManager.remove")}} method is used to unschedule an existing alarm.</p> - -<pre class="brush: js;">var alarmId; - -// Set an alarm and store it's id -var request = navigator.mozAlarms.add(new Date("May 15, 2012 16:20:00"), "honorTimezone"); - -request.onsuccess = function () { - alarmId = this.result; -} - -// ... - -// Later on, removing the alarm if it exists -if (alarmId) { - navigator.mozAlarms.remove(alarmId); -}</pre> - -<h2 id="Handling_alarms">Handling alarms</h2> - -<p>Any application can react when an alarm is dispatched by the system. In order to be able to handle any alarms, an application must register itself as an alarm handler. This is done through the System Messaging API in two steps:</p> - -<p>First, the applications must include <code>alarm</code> to the <a href="/en-US/docs/Apps/Manifest#messages" title="/en-US/docs/Apps/Manifest#messages">messages property of its application manifest</a> with the URL to the document which registers the callback function to be used when an alarm is dispatched.</p> - -<pre class="brush: js;">"messages": [ - { "alarm": "/index.html" } -]</pre> - -<p>Second, the application must bind a callback function with the <code>alarm</code> message. This is done using the {{DOMxRef("Navigator.mozSetMessageHandler()")}} method. This callback function will receive a {{Anch("mozAlarm")}} object containing the data attached to the alarm.</p> - -<pre class="brush: js;">navigator.mozSetMessageHandler("alarm", function (mozAlarm) { - alert("alarm fired: " + JSON.stringify(mozAlarm.data)); -});</pre> - -<p>If an application wants to know if there is a pending alarm at the system level, it's possible to use the {{DOMxRef("Navigator.mozHasPendingMessage()")}} method with the value <code>alarm</code>.</p> - -<pre class="brush: js;">navigator.mozHasPendingMessage("alarm"); </pre> - -<h2 id="Permissions_for_the_Alarm_API">Permissions for the Alarm API</h2> - -<p>Please note that while the Alarm API is not privileged or certified, you should still include <code>permissions</code> and <code>messages</code> entries in your <code>manifest.webapp</code> file when including it in an installable open Web app.</p> - -<pre class="brush: json;">{ - "permissions": { - "alarms": { - "description": "Required to schedule alarms" - } - }, - "messages": [ - { "alarm": "/index.html" } - ] -}</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("Alarm API")}}</td> - <td>{{Spec2("Alarm API")}}</td> - <td>Initial specification.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>Supported in Firefox OS 1.0.1.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/Apps/Build/User_notifications/Using_Alarms_to_notify_users">Using Alarms to notify users</a></li> - <li>{{DOMxRef("Navigator.mozAlarms")}}</li> - <li>{{DOMxRef("MozAlarmsManager")}}</li> - <li>{{DOMxRef("Navigator.mozSetMessageHandler")}}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/api_contacts/index.html b/files/fr/archive/b2g_os/api/api_contacts/index.html deleted file mode 100644 index 01422c1af0..0000000000 --- a/files/fr/archive/b2g_os/api/api_contacts/index.html +++ /dev/null @@ -1,272 +0,0 @@ ---- -title: API Contacts -slug: Archive/B2G_OS/API/API_Contacts -tags: - - API - - B2G - - Contact - - Contacts - - Firefox OS - - Guide -translation_of: Archive/B2G_OS/API/Contacts_API ---- -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est pas en voie de standardisation au W3C, mais elle est supportée par la plateforme Firefox OS. Bien que son implémentation puisse changer dans le futur et qu'elle n'est pas largement supportée par les différents navigateurs, elle est utilisable pour du code dédié aux applications Firefox OS.</p> - </div><p></p> - -<p></p><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications privilégiées ou certifiées</a> seulement.</p> -</div><p></p> - -<h2 id="Résumé">Résumé</h2> - -<p>L'API Contacts fournit une interface simple pour gérer les contacts des utilisateurs enregistrés dans le carnet d'adresses du système. Un cas pratique typique de l'API Contacts est l'implémentation d'une application de gestion de carnet d'adresses.</p> - -<div class="note"> -<p><strong>Note :</strong> Comme les informations personnelles des contacts utilisateurs constituent des données sensibles, seules les applications certifiées et privilégiées sont autorisées à accéder à cette API. L'utilisation des <a href="/en-US/docs/WebAPI/Web_Activities" title="/en-US/docs/WebAPI/Web_Activities">Activités Web</a> pour déléguer les opérations sur les contacts est préconisée pour les autres applications.</p> -</div> - -<h2 id="Gestion_des_contacts">Gestion des contacts</h2> - -<p>Les contacts enregistrés dans le carnet d'adresses du système sont accessibles par l'intermédiaire de la propriété <a href="/fr/docs/Web/API/Window/navigator/mozContacts" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.mozContacts</code></a>, elle-même étant une instance de l'interface <a href="/fr/docs/Web/API/ContactManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager</code></a>.</p> - -<h3 id="Ajout_d'un_contact">Ajout d'un contact</h3> - -<p>La création d'une nouvelle entrée dans le carnet d'adresses du système se fait en deux étapes :</p> - -<ol> - <li>Instanciez un nouvel objet <a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a> et remplissez toutes les propriétés nécéssaires. L'interface <a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a> définit toutes les propriétés possibles pour un contact donné. Ces propriétés sont essentiellement les mêmes que celles définies dans la spécification vCard 4.0, avec les exceptions suivantes : - <ul> - <li>L'attribut vCard N est divisé en cinq propriétés : <a href="/fr/docs/Web/API/MozContact/familyName" title="La propriété familyName est une liste de tous les noms de famille possibles utilisables pour le contact."><code>familyName</code></a>, <a href="/fr/docs/Web/API/MozContact/givenName" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>givenName</code></a>, <a href="/fr/docs/Web/API/MozContact/additionalName" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>additionalName</code></a>, <a href="/fr/docs/Web/API/MozContact/honorificPrefix" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>honorificPrefix</code></a>, <a href="/fr/docs/Web/API/MozContact/honorificSuffix" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>honorificSuffix</code></a></li> - <li>L'attribut vCard FN a été renommé <a href="/fr/docs/Web/API/MozContact/name" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>name</code></a></li> - <li>L'attribut vCard GENDER est divisé en deux propriétés : <a href="/fr/docs/Web/API/MozContact/sex" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>sex</code></a>, <a href="/fr/docs/Web/API/MozContact/genderIdentity" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>genderIdentity</code></a></li> - <li>Faîtes attention : la plupart des propriétés sont des tableaux. Firefox v1.3 vérifie cela de manière bien plus stricte et par conséquent du code qui fonctionnait avec Firefox v1.2 peut ne plus s'exécuter avec Firefox v1.3 à cause de ça.</li> - </ul> - </li> - <li>Utilisez la méthode <a href="/fr/docs/Web/API/ContactManager/save" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.save()</code></a> avec l'objet contact comme premier paramètre. La méthode renvoie un <a href="/fr/docs/Web/API/DOMRequest" title="Un objet DOMRequest représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet DOMRequest que vous pouvez surveiller pour connaitre le déroulement de l'opération"><code>DOMRequest</code></a> pour conserver une trace de la réussite ou de l'échec de l'opération d'enregistrement.</li> -</ol> - -<pre class="brush: js">// première méthode : définir les propriétés directement -var person = new mozContact(); -person.givenName = ["John"]; -person.familyName = ["Doe"]; -person.nickname = ["No kidding"]; - -// seconde méthode : utilisation d'un objet -var contactData = { - givenName: ["John"], - familyName: ["Doe"], - nickname: ["No kidding"] -}; - -var person = new mozContact(contactData); // Firefox OS 1.3 prend un paramètre pour initialiser l'objet -if ("init" in person) { - // Firefox OS 1.2 et précédents utilisent une méthode "init" pour initialiser l'objet - person.init(contactData); -} - -// enregistre le nouveau contact -var saving = navigator.mozContacts.save(person); - -saving.onsuccess = function() { - console.log('nouveau contact enregistré'); - // Cela actualise la personne telle qu'elle est enregistrée - // Elle comporte son ID interne unique - // Notez que saving.result est null ici -}; - -saving.onerror = function(err) { - console.error(err); -}; -</pre> - -<h3 id="Recherche_d'un_contact">Recherche d'un contact</h3> - -<p>Deux méthodes permettent de récupérer un contact depuis le carnet d'adresses du système :</p> - -<ul> - <li><a href="/fr/docs/Web/API/ContactManager/find" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.find()</code></a> pour obtenir une liste de contacts spécifique</li> - <li><a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.getAll()</code></a> pour récupérer tous les contacts</li> -</ul> - -<p>Les deux méthodes attendent un paramètre qui est un objet défiinissant les options de filtres et de tri. <a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.getAll</code></a> n'accepte que les options de tri. Ces dernières sont :</p> - -<ul> - <li><code>sortBy</code> : Une chaîne de caractères représentant le champ sur lequel les résultats de la recherche seront triés. Pour le moment, seuls givenName et familyName sont supportés.</li> - <li><code>sortOrder </code>: Une chaîne de caractères qui indique le sens du tri des résultats. Les valeurs possibles sont <code>descending</code> (descendant) ou <code>ascending (ascendant)</code>.</li> -</ul> - -<p>Et les options de filtre :</p> - -<ul> - <li><code>filterBy</code> : Un tableau de chaînes de caractères représentant tous les champs utilisés pour le filtrage.</li> - <li><code>filterValue</code> : La valeur avec laquelle faire la comparaison.</li> - <li><code>filterOp</code> : L'opérateur de comparaison du filtre à utiliser. Les valeurs possibles sont <code>equals</code> (égal à), <code>startsWith</code> (commence par), et <code>match</code> (correspond à), cette dernière étant spécifique aux numéros de téléphone.</li> - <li><code>filterLimit </code>: Le nombre de contacts à récupérer avec la méthode <a href="/fr/docs/Web/API/ContactManager/find" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>find</code></a>.</li> -</ul> - -<p><a href="/fr/docs/Web/API/ContactManager/find" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>find</code></a> renvoie un objet <a href="/fr/docs/Web/API/DOMRequest" title="Un objet DOMRequest représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet DOMRequest que vous pouvez surveiller pour connaitre le déroulement de l'opération"><code>DOMRequest</code></a> et <a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>getAll</code></a> retourne un objet <a href="/fr/docs/Web/API/DOMCursor" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>DOMCursor</code></a> pour connaître la réussite ou l'échec d'une recherche.</p> - -<p>Si la recherche réussit, son résultat est disponible dans la propriété <a href="/fr/docs/Web/API/DOMRequest/result" title="Cette propriété fournit la valeur de résultat pour l'opération d'un DOMRequest."><code>DOMRequest.result</code></a>, soit dans un tableau d'objets <a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a> pour <a href="/fr/docs/Web/API/ContactManager/find" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>find</code></a>, soit dans un unique objet <a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a> pour <a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>getAll</code></a>. Pour obtenir le résultat suivant dans la liste obtenue avec <a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>getAll</code></a>, appelez la méthode <code>continue()</code> du curseur.</p> - -<pre class="brush: js">var options = { - filterValue : "John", - filterBy : ["givenName","name","nickName"], - filterOp : "contains", - filterLimit : 1, - sortBy : "familyName", - sortOrder : "ascending" -} - -var search = navigator.mozContacts.find(options); - -search.onsuccess = function() { - if (search.result.length === 1) { - var person = search.result[0]; - console.log("Trouvé :" + person.givenName[0] + " " + person.familyName[0]); - } else { - console.log("Désolé, il n'y a pas de tel contact.") - } -}; - -search.onerror = function() { - console.warn("Aïe ! Quelque chose ne va pas, aucun résultat !"); -}; - -var allContacts = navigator.mozContacts.getAll({sortBy: "familyName", sortOrder: "descending"}); - -allContacts.onsuccess = function(event) { - var cursor = event.target; - if (cursor.result) { - console.log("Trouvé : " + cursor.result.givenName[0] + " " + cursor.result.familyName[0]); - cursor.continue(); - } else { - console.log("Pas d'autre contact"); - } -}; - -allContacts.onerror = function() { - console.warn("Quelque chose s'est mal passée ! :("); -}; -</pre> - -<h3 id="Mise_à_jour_d'un_contact">Mise à jour d'un contact</h3> - -<p>Lors de l'obtention d'un contact par l'intermédiaire de <a href="/fr/docs/Web/API/ContactManager/find" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>find()</code></a> ou de <a href="/fr/docs/Web/API/ContactManager/getAll" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>getAll()</code></a> (ou après un appel réussi à <a href="/fr/docs/Web/API/ContactManager/save" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>save()</code></a> pour un nouveau contact), celui-ci se voit attribuer des méta-données :</p> - -<ul> - <li>Un ID unique accessible via <a href="/fr/docs/Web/API/MozContact/id" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozContact.id</code></a></li> - <li>Un objet <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Date" title="/en-US/docs/JavaScript/Reference/Global_Objects/Date">Date</a> à l'intérieur de <a href="/fr/docs/Web/API/MozContact/updated" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozContact.updated</code></a> pour représenter la date de dernière modification du contact.</li> -</ul> - -<p>Actualiser un contact revient globalement à modifier les valeurs de ses propriétés puis à l'enregistrer via un appel à la méthode <a href="/fr/docs/Web/API/ContactManager/save" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>save()</code></a>.</p> - -<div class="note"> -<p><strong>Note :</strong> À chaque fois qu'un contact est ajouté, mis à jour ou supprimé, un événement <code><a href="/fr/docs/Web/Reference/Events/contactchange" title="/fr/docs/Web/Reference/Events/contactchange">contactchange</a></code> est déclenché afin d'avoir un suivi de tous les changements apportés au carnet d'adresses du système. Cet événement peut être géré avec la propriété <a href="/fr/docs/Web/API/ContactManager/oncontactchange" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.oncontactchange</code></a>.</p> -</div> - -<h3 id="Suppression_d'un_contact">Suppression d'un contact</h3> - -<p>Un appel à la méthode <a href="/fr/docs/Web/API/ContactManager/remove" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.remove()</code></a> va tout simplement supprimer l'objet <a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a> qui lui a été transmis.</p> - -<p>Dans certains cas limites, il est aussi possible de se débarrasser de tous les contacts. Pour cela, utilisez <a href="/fr/docs/Web/API/ContactManager/clear" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager.clear()</code></a>. Soyez prudent lors de l'appel de cette méthode ; il n'est pas possible de revenir en arrière.</p> - -<h2 id="Specifications" name="Specifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td><a class="external" href="https://www.w3.org/2012/sysapps/contacts-manager-api/" hreflang="en" lang="en">Contacts Manager API<br><small lang="fr">La définition de 'Contacts Manager API' dans cette spécification.</small></a></td> - <td><span class="spec-Obsolete">Obsolete</span></td> - <td> </td> - </tr> - <tr> - <td><a class="external" href="https://tools.ietf.org/html/rfc6350" hreflang="en" lang="en" title="La spécificaction 'vCard Format Specification'">vCard Format Specification</a></td> - <td><span class="spec-RFC">IETF RFC</span></td> - <td>RFC 6350</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p></p><p class="warning"><strong><a href="https://github.com/mdn/browser-compat-data">Nous convertissons les données de compatibilité dans un format JSON</a></strong>. - Ce tableau de compatibilité utilise encore l'ancien format - car nous n'avons pas encore converti les données qu'il contient. - <strong><a href="/fr/docs/MDN/Contribute/Structures/Compatibility_tables">Vous pouvez nous aider en contribuant !</a></strong></p> - -<div class="htab"> - <a id="AutoCompatibilityTable" name="AutoCompatibilityTable"></a> - <ul> - <li class="selected"><a>Ordinateur</a></li> - <li><a>Mobile</a></li> - </ul> -</div><p></p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Caractéristique</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>support basique</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Caractéristique</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>Firefox OS</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>basic support</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td>18.0</td> - <td>1.1</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Window/navigator/mozContacts" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.mozContacts</code></a></li> - <li><a href="/fr/docs/Web/API/MozContact" title="The MozContact interface is used to describe a single contact in the device's contact database."><code>mozContact</code></a></li> - <li><a href="/fr/docs/Web/API/ContactManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>ContactManager</code></a></li> - <li><a href="/fr/docs/Web/API/MozContactChangeEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozContactChangeEvent</code></a></li> - <li><a href="https://github.com/soapdog/firefoxos-sample-app-contact-exporter" title="Firefox OS Contact Exported Sample App">Application d'exemple pour exporter les contacts sous Firefox OS</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/bluetoothstatuschangedevent/index.html b/files/fr/archive/b2g_os/api/bluetoothstatuschangedevent/index.html deleted file mode 100644 index 8474dbd5f8..0000000000 --- a/files/fr/archive/b2g_os/api/bluetoothstatuschangedevent/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: BluetoothStatusChangedEvent -slug: Archive/B2G_OS/API/BluetoothStatusChangedEvent -translation_of: Archive/B2G_OS/API/BluetoothStatusChangedEvent ---- -<p>{{ apiref("Bluetooth API") }}</p> - -<p>{{ non-standard_header() }}</p> - -<p>{{ B2GOnlyHeader2('certified') }}</p> - -<h2 id="Sommaire">Sommaire</h2> - -<p>L'API <code>BluetoothStatusChangedEvent</code> donne accès aux informations de modification du statut de l'équipement Bluetooth.</p> - -<p>Une modification du statut a lieu lorsqu'un des évènements suivants est détecté :</p> - -<ul> - <li>{{Event("a2dpstatuschange")}} : It occurs when an <a class="external" href="http://en.wikipedia.org/wiki/Bluetooth_profile#Advanced_Audio_Distribution_Profile_.28A2DP.29" rel="external"><abbr title="Advanced Audio Distribution Profile">A2DP</abbr></a> connection status changes. See {{domxref("BluetoothAdapter.ona2dpstatuschanged")}} for more information.</li> - <li>{{Event("hfpstatuschange")}} : It occurs when an <a class="external" href="http://en.wikipedia.org/wiki/Bluetooth_profile#Hands-Free_Profile_.28HFP.29" rel="external"><abbr title="Hands-Free Profile">HFP</abbr></a> connection status changes. See {{domxref("BluetoothAdapter.onhfpstatuschanged")}} for more information.</li> - <li>{{Event("pairedstatuschange")}} : It occurs when the pairing status of the device changes. See {{domxref("BluetoothAdapter.onpairedstatuschanged")}} for more information.</li> - <li>{{Event("scostatuschange")}} : It occurs when an <abbr title="Synchronous connection-oriented"><a class="external" href="http://en.wikipedia.org/wiki/Bluetooth_protocols#Synchronous_connection-oriented_.28SCO.29_link" rel="external">SCO</a></abbr> connection status changes. See {{domxref("BluetoothAdapter.onscostatuschanged")}} for more information.</li> -</ul> - -<h2 id="Interface_overview">Interface overview</h2> - -<pre>interface BluetoothStatusChangedEvent: Event -{ - readonly attribute DOMString address; - readonly attribute boolean status; -};</pre> - -<h2 id="Properties">Properties</h2> - -<dl> - <dt>{{domxref("BluetoothStatusChangedEvent.address")}} {{readonlyinline}}</dt> - <dd>A string representing the address of the device for which the status has changed in the Bluetooth micro-network.</dd> - <dt>{{domxref("BluetoothStatusChangedEvent.status")}} {{readonlyinline}}</dt> - <dd>A boolean representing the current status of the connection. It can be enabled (<code>true</code>) or disabled (<code>false</code>).</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<p>None.</p> - -<h2 id="Specification">Specification</h2> - -<p>Not part of any specification yet. It should be discussed as part of the <a href="http://www.w3.org/2012/sysapps/">W3C's System Applications Working Group</a>.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{domxref("BluetoothAdapter")}}</li> - <li>{{domxref("BluetoothAdapter.ona2dpstatuschanged")}}</li> - <li>{{domxref("BluetoothAdapter.onhfpstatuschanged")}}</li> - <li>{{domxref("BluetoothAdapter.onpairedstatuschanged")}}</li> - <li>{{domxref("BluetoothAdapter.onscostatuschanged")}}</li> - <li><a href="/en-US/docs/WebAPI/WebBluetooth">Web Bluetooth</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/callevent/index.html b/files/fr/archive/b2g_os/api/callevent/index.html deleted file mode 100644 index 9b140224a9..0000000000 --- a/files/fr/archive/b2g_os/api/callevent/index.html +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: CallEvent -slug: Archive/B2G_OS/API/CallEvent -translation_of: Archive/B2G_OS/API/CallEvent ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Archive"><code>Archive</code></a></strong></li><li class="toggle"><details open><summary>Pages liées à Firefox OS</summary><ol><li><a href="/fr/docs/Web/API/MozAlarmsManager"><code>MozAlarmsManager</code></a></li><li><a href="/fr/docs/Web/API/MozMobileNetworkInfo"><code>MozMobileNetworkInfo</code></a></li><li><a href="/fr/docs/Web/API/MozWifiP2pGroupOwner"><code>MozWifiP2pGroupOwner</code></a></li></ol></details></li></ol></section><p></p> - -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><p></p> - -<p></p><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications internes</a> seulement.</p> -</div><p></p> - -<p>L'interface <code>CallEvent</code> de l'<a href="https://developer.mozilla.org/fr/docs/Web/API/Web_Telephony_API">API Web Téléphony</a> représente les événements liés aux appels téléphoniques.</p> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt><a href="/fr/docs/Web/API/CallEvent/call" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CallEvent.call</code></a> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></dt> - <dd>Un objet <a href="/fr/docs/Web/API/TelephonyCall" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>TelephonyCall</code></a> représantant l'appel à l'origine de l'événement.</dd> -</dl> - -<h2 id="Examples">Examples</h2> - -<pre class="brush: js">// Telephony object -var tel = navigator.mozTelephony; - -// Receive a call -tel.onincoming = function(e) { - var incomingCall = e.call; - - // Answer the call - incomingCall.answer(); -};</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td><a class="external" href="https://wiki.mozilla.org/WebAPI/WebTelephony" hreflang="en" lang="en" title="La spécificaction 'Web Telephony'">Web Telephony</a></td> - <td><span class="spec-Draft">Projet</span></td> - <td>Draft</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>For obvious reasons, support is primarily expected on mobile browsers.</p> - -<p></p><p class="warning"><strong><a href="https://github.com/mdn/browser-compat-data">Nous convertissons les données de compatibilité dans un format JSON</a></strong>. - Ce tableau de compatibilité utilise encore l'ancien format - car nous n'avons pas encore converti les données qu'il contient. - <strong><a href="/fr/docs/MDN/Contribute/Structures/Compatibility_tables">Vous pouvez nous aider en contribuant !</a></strong></p> - -<div class="htab"> - <a id="AutoCompatibilityTable" name="AutoCompatibilityTable"></a> - <ul> - <li class="selected"><a>Ordinateur</a></li> - <li><a>Mobile</a></li> - </ul> -</div><p></p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>Firefox OS (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td>12.0 (12.0)</td> - <td>1.0.1</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/Guide/API/Telephony/Using_the_Web_Telephony_API">Using the Web Telephony API</a></li> - <li><a href="/fr/docs/Web/API/Telephony" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Telephony</code></a></li> - <li><a href="/fr/docs/Web/API/CallEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CallEvent</code></a></li> - <li><a href="/fr/docs/Web/API/Navigator/mozTelephony" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Navigator.mozTelephony</code></a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/data_store_api/index.html b/files/fr/archive/b2g_os/api/data_store_api/index.html deleted file mode 100644 index 8eabb360a4..0000000000 --- a/files/fr/archive/b2g_os/api/data_store_api/index.html +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: Data Store API -slug: Archive/B2G_OS/API/Data_Store_API -tags: - - API - - Certified - - Firefox OS - - Interface - - Non-standard - - Obsolete - - Reference - - WebAPI -translation_of: Archive/B2G_OS/API/Data_Store_API ---- -<div> -<div class="blockIndicator nonStandard nonStandardHeader"> -<p><strong>Non-standard</strong><br> - Cette fonctionnalité ne fait pas partie des normes actuelles du W3C, mais elle est prise en charge sur la plate-forme Firefox OS. Bien que les implémentations puissent changer à l'avenir et qu'il ne soit pas largement pris en charge par les navigateurs, il convient pour une utilisation dans le code dédié aux applications Firefox OS.</p> -</div> - -<div class="blockIndicator warning"> -<p style="text-align: center;">Cette API est disponible sur <a href="/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">les applications internes</a> uniquement.</p> -</div> -</div> - -<div class="summary"> -<p>L'<strong>API Data Store</strong> fournit un mécanisme de stockage puissant et flexible que les applications Firefox OS peuvent utiliser pour stocker et partager des données. Il s’agit en fait d’un magasin intermédiaire permettant à plusieurs applications de partager des données entre elles rapidement, efficacement et en toute sécurité, malgré les différences entre les structures de données des API, les formats, etc.</p> -</div> - -<h2 id="Concepts_et_usages">Concepts et usages</h2> - -<p>L'API Data Store a été créée pour permettre à plusieurs applications <a href="/en-US/Firefox_OS">Firefox OS</a>, avec des structures de données et des mécanismes de stockage potentiellement différents, de créer, de maintenir et de partager efficacement les mêmes objets de données entre elles. Chaque application peut ensuite importer les données dans sa propre base <a href="/en-US/docs/Web/API/IndexedDB_API">IndexedDB</a> locale pour indexer en fonction de leurs besoins en matière de requête. Cela n'est toutefois pas nécessaire et vous pouvez simplement écrire directement dans le magasin de données de l'API du magasin de données.</p> - -<div class="note"> -<p><strong>Note</strong>: Pour plus d'informations concernant le fonctionnement de l'API Data Store avec des exemples, consultez notre article <a href="/en-US/docs/Web/API/Data_Store_API/Using_the_Data_Store_API">Utiliser l'API Data Store</a>.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: L'API Data Store est disponible dans <a href="/en-US/docs/Web/Guide/Performance/Using_web_workers">Web Workers</a>, à partir de Firefox 32 (Firefox OS 2.0; voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=949325" title="FIXED: C++ wrapper to support DataStore API on the worker">bug 949325</a>.)</p> -</div> - -<p>Il y a plusieurs raisons d'utiliser cette API, comme :</p> - -<ul> - <li><span class="tlid-translation translation" lang="fr"><span title="">Permettre</span></span><span class="tlid-translation translation" lang="fr"><span title=""> à une application de créer des données qu’elle peut ensuite partager avec d’autres applications.</span></span></li> - <li><span class="tlid-translation translation" lang="fr"><span title="">Permettre à plusieurs applications de fournir des données au même</span></span> data store.</li> - <li><span class="tlid-translation translation" lang="fr"><span title="">Permettre la lecture seule des data stores tels que les contacts Facebook (en d’autres termes, il permet à une application de créer et de gérer les données, tandis que d’autres applications peuvent seulement lire les données du store)</span></span>.</li> - <li><span class="tlid-translation translation" lang="fr"><span title="">Permettre la lecture/écriture du data store, de sorte que plusieurs applications puissent contribuer sur le même data store.</span> <span title="">Un exemple serait les contacts standard de l'appareil, qui peuvent être mis à jour à la fois par l'application Contacts intégrée et par les applications tierces.</span></span></li> - <li><span class="tlid-translation translation" lang="fr"><span title="">Permettre la conservation du cache de stockage local de données d'un data store, avec des notifications permettant à l'application de savoir quand des modifications ont été apportées au data store principal afin que le cache puisse être mis à jour.</span></span></li> -</ul> - -<p>Chaque data store appartient à une application spécifique (comme spécifié par le champ <code>datastores-owned</code> dans le manifeste de l'application - voir <a href="#Manifest_fields">Manifest_fields</a>, ci-dessous). Cette propriété donne à l'application le droit de remplir le data store et de déclarer si le magasin de données est <code>readonly</code> (ce qui signifie que les autres applications ne peuvent lire que les données) ou <code>readwrite</code> (ce qui signifie que d'autres applications peuvent modifier les données ainsi que les lire.) Les autres applications peuvent accéder à un data store en le nommant dans le champ <code>datastores-access</code> de son manifeste. </p> - -<p>Lorsqu'une application souhaite accéder à un data store, elle doit appeler <a href="/en-US/docs/Web/API/Navigator/getDataStores" title="The documentation about this has not yet been written; please consider contributing!"><code>Navigator.getDataStores()</code></a>. La valeur résultante de cette méthode est un objet <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise" title="The Promise object represents the eventual completion (or failure) of an asynchronous operation, and its resulting value."><code>Promise</code></a> qui sera résolu avec un tableau d'objets <a href="/en-US/docs/Web/API/DataStore" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore</code></a>. À partir de ces objets <code>DataStore</code>, l'application peut lire et modifier des valeurs à l'aide de différentes méthodes du <code>DataStore</code> telles que <a href="/en-US/docs/Web/API/DataStore/get" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.get()</code></a> et <a href="/en-US/docs/Web/API/DataStore/insert" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.insert()</code></a>.</p> - -<div class="note"> -<p><strong>Note</strong>: L'API Data Store n'impose pas pour le moment de limitations sur l'espace de stockage. Cela sera surement changé dans un futur proche.</p> -</div> - -<h3 id="Gestion_du_changement_et_résolution_des_conflits">Gestion du changement et résolution des conflits</h3> - -<p>Quand plusieurs applications effectuent des changements dans un data store, cela peut créer des conflits. Cependant, toutes les modifications effectuées ( en utilisant <a href="/en-US/docs/Web/API/DataStore/update" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.update()</code></a>, <a href="/en-US/docs/Web/API/DataStore/add" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.add()</code></a>, reçoivent un <code>revisionId</code>, un UUID reçu dans l'évenement <code>change</code> est déclenché chaque fois qu'une opération est effectuée sur le data store par une application ayant accès à celui-ci. Cela peut être lu à partir de la propriété <a href="/en-US/docs/Web/API/DataStore/revisionId" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.revisionId</code></a></p> - -<p>La propriété <code>revisionId</code> peut être incluse en tant que paramètre facultatif dans les méthodes <a href="/en-US/docs/Web/API/DataStore/add" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.add()</code></a>, <a href="/en-US/docs/Web/API/DataStore/put" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.put()</code></a>, <a href="/en-US/docs/Web/API/DataStore/remove" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.remove()</code></a>, <a href="/en-US/docs/Web/API/DataStore/clear" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.clear()</code></a>, and <a href="/en-US/docs/Web/API/DataStore/sync" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.sync()</code></a>. Elles utilisent essentiellement <code>revisionId</code> pour éviter les conflit - l'opération est annulée si cette <code>revisionId</code> n'est pas la dernière connue par le data store (c'est-à-dire si une autre application a apporté une modification plus récente).</p> - -<p>Lorsque l'événement <code>change</code> est déclenché, il reçoit un objet <a href="/en-US/docs/Web/API/DataStoreChangeEvent" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent</code></a>, donnant à l'application l'accès à:</p> - -<ul> - <li><a href="/en-US/docs/Web/API/DataStoreChangeEvent/revisionId" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent.revisionId</code></a>: Le <code>revisionId</code> le plus récent.</li> - <li><a href="/en-US/docs/Web/API/DataStoreChangeEvent/id" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent.id</code></a>: La clef du dernier objet changé, qui peut être vide si l'opération etait <code>clear()</code>.</li> - <li><a href="/en-US/docs/Web/API/DataStoreChangeEvent/operation" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent.operation</code></a>: L'opération qui a été effectuée — <code>add()</code>, <code>remove()</code>, etc.</li> - <li><a href="/en-US/docs/Web/API/DataStoreChangeEvent/owner" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent.owner</code></a>: L'URl du manifest de l'application qui a effectué cette oppération.</li> -</ul> - -<p>Quand une application veut savoir ce qui a changé, elle peut le faire en demandant le "delta" entre le dernier <code>revisionId</code> et l'actuel. Cela s'effectue avec la méthode <a href="/en-US/docs/Web/API/DataStore/sync" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.sync()</code></a> . Vous pouvez autoriser votre application à gérer les changements des données en utilisant <code>sync()</code> lors du démarage de l'application et <a href="/en-US/docs/Web/API/Onchange" title="The documentation about this has not yet been written; please consider contributing!"><code>onchange</code></a> en lui passant le<code>revisionId</code> actuel pour vérifier de nouveau.</p> - -<h3 id="Filtrage_des_donnée">Filtrage des donnée</h3> - -<p>Comme indiqué ci-dessus, l'API Data Store n'est pas responsable du filtrage des données ni de la création d'index. Au lieu de cela, elle laisse cela au mécanisme de stockage local de l'application (généralement <a href="/en-US/docs/Web/API/IndexedDB_API">IndexedDB</a>); L'API Data Store permet simplement de mettre à jour les index locaux, via l'objet <a href="/en-US/docs/Web/API/DataStoreCursor" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreCursor</code></a>, créé lors de l'appel de <code>sync()</code>.</p> - -<h2 id="Champs_du_manifest">Champs du manifest</h2> - -<p>Le manifest propriétaire du data store DOIT inclure le champ <code>datastores</code> pourrevendiquer la propriété, par exemple :</p> - -<pre class="brush: json">"datastores-owned": { - "myData": { - "access": "readwrite", - "description": "mon data store" - } -} -</pre> - -<p>Vous pouvez inclure différentes propriétés pour représenter différents data stores, et chacun peut utiliser <code>readonly</code>/<code>readwrite</code> pour spécifier si le data store peut être lu / modifié par d'autres applications. Une description est également incluse pour décrire le data store.</p> - -<p>Les autres application qui veulent accèder au data store mais qui ne leur appartient pas doivent inclure le champ<code>datastores-access</code> , par exemple :</p> - -<pre class="brush: json">"datastores-access": { - "myData": { - "access": "readonly", - "description": "Lire et modifier mon data store" - } -} -</pre> - -<p>Sans ce champ, la réponse par défaut est "no access". Encore, plusieurs propriétées peuvent être incluses si vous voulez accèder à plusieurs data stores, et un accès <code>readonly</code> ou <code>readwrite</code> peut être mis pour déclarer le type d'accès dont l'application a besoin.</p> - -<p>En termes de permissions, le propriétaire du data store gagne toujours contre les applications tières. Si le propriétaire déclare <code>"readonly": true</code> dans le manifest, toutes les applications tières seront <code>readonly</code>, même si elles déclarent <code>"access": "readwrite"</code> dans leur manifest. Bien sûr, cela n’est pas très utile si le propriétaire autorise la modification du magasin de données par des applications tierces. Pour le moment, Data Store est une API certifiée. Il est probable que les privilèges reviendront à la finalisation du modèle de sécurité.</p> - -<div class="note"> -<p><strong>Note</strong>: Rappelez-vous également que dans de tels cas, vous devez utiliser le champ <a href="https://developer.mozilla.org/en-US/Apps/Build/Manifest#type">type</a> de votre manifeste pour déclarer explicitement que votre application est une application interne / certifiée : <code>"type": "certified"</code>.</p> -</div> - -<h2 id="Interfaces_de_l'API_Data_Store">Interfaces de l'API Data Store</h2> - -<p>L'API Data Store contient les interfaces suivantes :</p> - -<dl> - <dt><a href="/en-US/docs/Web/API/DataStore" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore</code></a></dt> - <dd>L'interface <strong><code>DataStore</code></strong> représente un ensemble de données récupérées, et inclut des propriétés standards pour accèder au nom du store, le propriétaire, etc. mais aussi des méthodes pour lire, modifier et syncroniser les données, et le gestionnaire d'évenements <code>onchange</code> pour réagire aux changements dans les données.</dd> - <dt><a href="/en-US/docs/Web/API/DataStoreCursor" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreCursor</code></a></dt> - <dd>Cette interface permet à l'application de parcourir une liste d'objets <a href="/en-US/docs/Web/API/DataStoreTask" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreTask</code></a> représentant l'historique des changements du data store, pour utiliser lors de la syncronisation des données.</dd> - <dt><a href="/en-US/docs/Web/API/DataStoreChangeEvent" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent</code></a></dt> - <dd>Cette interface représente l'évenement lié à un enregistrement changé dans le data store, par exemple elle est renvoyée une fois qu'une modification est effectuée et que l'événement <code>change</code> est déclenché (voir <a href="/en-US/docs/Web/API/DataStore/onchange" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore.onchange</code></a> pour le gestionnaire), à utiliser lors de la synchronisation de modifications individuelles.</dd> - <dt><a href="/en-US/docs/Web/API/DataStoreTask" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreTask</code></a></dt> - <dd>Cette interface représente un enregistrement changé dans le data store quand est utilisé pour parcourir l'historique des modifications du data store.</dd> -</dl> - -<h2 id="Example" name="Example">Exemples</h2> - -<p>Nous avons écrit quelques exemples qui vont ensemble, pour expliquer comment différentes applications peuvent avoir différents usages du même data store :</p> - -<ul> - <li><a href="https://github.com/mdn/data-store-contacts-editor">L'éditeur de contacts Data Store</a> crée un data store nommé "contacts" sur la machine sur laquelle il est installé, ajoute quelques données et autorise l'utilisateur à ajouter et supprimer des contacts.</li> - <li><a href="https://github.com/mdn/data-store-contacts-viewer">Le visionneur de contacts Data Store</a> a un accès en lecture uniquement au data store "contacts". Il lit les données et les affiche à l'utilisateur via une interface, avec une carte Google Maps de l'emplacement de l'utilisateur sélectionné, affiché dans un <a href="/en-US/docs/Web/HTML/Element/iframe" title="The HTML Inline Frame element (<iframe>) represents a nested browsing context, embedding another HTML page into the current one."><code><iframe></code></a> pour contourner les restrictions CSP des applications certifiées.</li> -</ul> - -<p>Continuez à vous référer à ces exemples et lisez <a href="/en-US/docs/Web/API/Data_Store_API/Using_the_Data_Store_API">Utilisation de l'API Data Store</a> pour des explications et des exemples de code.</p> - -<div class="note"> -<p><strong>Note</strong>: Sachez que pour tester des exemples de magasin de données, vous devez vous assurer que vos applications sont internes / certifiées (voir ci-dessus pour les champs de manifeste nécessaires) et utilisez App Manager ou WebIDE pour simuler un environnement dans lequel une application interne / certifiée peut être exécutée. Suivez ces liens pour savoir comment faire cela en utilisant chaque outil: <a href="/en-US/Firefox_OS/Using_the_App_Manager#Debugging_Certified_Apps_2">App Manager: Debugger les applications certifiées</a> et <a href="/en-US/docs/Tools/WebIDE#Debugging_certified_apps_%28including_main_process%29">WebIDE: Debugger les applications certifiées</a>.</p> -</div> - -<h2 id="Caractéristiques">Caractéristiques</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Caractéristiques</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td><a class="external" href="https://airpingu.github.io/data-store-api/index.html" hreflang="en" lang="en" title="The 'Data Store API' specification">API Data Store</a></td> - <td><span class="spec-Draft">Brouillon</span></td> - <td></td> - </tr> - </tbody> -</table> - - - -<p>La discussion concernant la création de cette API a eu lieu dans diverses <a href="https://lists.mozilla.org/listinfo">listes de diffusion Mozilla</a> et ailleurs. Vous trouverez un résumé de la discussion et d'autres indications sur le <a href="https://wiki.mozilla.org/WebAPI/DataStore">Wiki de Mozilla</a>. Pour plus d'informations et de questions, envoyez un courrier à la liste de diffusion <a href="https://lists.mozilla.org/listinfo/dev-webapi">dev-webapi</a>.</p> - -<h2 id="Compatibilité">Compatibilité</h2> - -<div>Supporté dans Firefox OS 1.0.1.</div> - -<div>Disponible dans web workers dans Firefox OS 2.0.</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/Data_Store_API/Using_the_Data_Store_API">Utiliser l'API Data Store</a></li> - <li><a href="https://github.com/mdn/data-store-contacts-editor">Éditeur de contacts Data Store</a></li> - <li><a href="https://github.com/mdn/data-store-contacts-viewer">Visionneur de contacts Data Store</a></li> -</ul> - -<section id="Quick_Links"> -<h3 id="Liens">Liens</h3> - -<ol> - <li data-default-state="open"><strong><a href="#">Guides</a></strong> - - <ol> - <li><a href="/en-US/docs/Web/API/Data_Store_API/Using_the_Data_Store_API">Utiliser l'API Data Store</a></li> - </ol> - </li> - <li data-default-state="open"><strong><a href="#">Exemples</a></strong> - <ol> - <li><a href="https://github.com/mdn/data-store-contacts-editor">Éditeur de contacts Data Store</a></li> - <li><a href="https://github.com/mdn/data-store-contacts-viewer">Visionneur de contacts Data Store</a></li> - </ol> - </li> - <li data-default-state="open"><strong><a href="#">Interfaces</a></strong> - <ol> - <li><a href="/en-US/docs/Web/API/DataStore" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStore</code></a></li> - <li><a href="/en-US/docs/Web/API/DataStoreCursor" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreCursor</code></a></li> - <li><a href="/en-US/docs/Web/API/DataStoreChangeEvent" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreChangeEvent</code></a></li> - <li><a href="/en-US/docs/Web/API/DataStoreTask" title="The documentation about this has not yet been written; please consider contributing!"><code>DataStoreTask</code></a></li> - </ol> - </li> -</ol> -</section> diff --git a/files/fr/archive/b2g_os/api/domapplication/index.html b/files/fr/archive/b2g_os/api/domapplication/index.html deleted file mode 100644 index 59dc92f290..0000000000 --- a/files/fr/archive/b2g_os/api/domapplication/index.html +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: App -slug: Archive/B2G_OS/API/DOMApplication -tags: - - API Apps - - Apps -translation_of: Archive/B2G_OS/API/DOMApplication ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Archive"><code>Archive</code></a></strong></li><li class="toggle"><details open><summary>Pages liées à Apps</summary><ol><li><a href="/fr/docs/Web/API/DOMApplication"><code>DOMApplication</code></a></li><li><a href="/fr/docs/Web/API/DOMApplicationsManager"><code>DOMApplicationsManager</code></a></li><li><a href="/fr/docs/Web/API/DOMApplicationsRegistry"><code>DOMApplicationsRegistry</code></a></li><li><a href="/fr/docs/Web/API/InstallTrigger"><code>InstallTrigger</code></a></li></ol></details></li></ol></section><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><p></p> - -<p>Dans l'API JavaScript Open Web Apps, un objet <code>App</code> est un objet JavaScript qui représente une application qui a été, ou pourrait être, installée par l'utilisateur.</p> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Nom</th> - <th scope="col">Description</th> - <th scope="col">Type</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>manifest</code></td> - <td>L'instance actuellement stockée du <a href="/fr/docs/Applications/Manifeste" title="/fr/docs/Applications/Manifeste">manifeste</a> de l'application.</td> - <td><code>object</code></td> - </tr> - <tr> - <td><code>manifestURL</code></td> - <td>Où le manifeste a été trouvé.</td> - <td><code>string</code></td> - </tr> - <tr> - <td><code>origin</code></td> - <td>L'origine de l'application (protocole, hôte, et numéro du port facultatif). Par exemple : http://example.com</td> - <td><code>string</code></td> - </tr> - <tr> - <td><code>installOrigin</code></td> - <td>L'origine du site qui a déclenché l'installation de l'application.</td> - <td><code>string</code></td> - </tr> - <tr> - <td><code>installTime</code></td> - <td>Quand a été installée l'application. Généré à partir de <code>Date().getTime()</code>, représentant le nombre de millisecondes depuis le 1er janvier 1970 à minuit.</td> - <td><code>integer</code></td> - </tr> - <tr> - <td><code>receipts</code></td> - <td>Un objet contenant un tableau d'un ou plusieurs reçus. Chaque reçu est une chaîne de caractères. Si il n'y a aucun reçu, sa valeur est <code>null</code>.</td> - <td><code>object</code> ou <code>null</code></td> - </tr> - </tbody> -</table> - -<h2 id="Méthodes">Méthodes</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Méthode</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>launch()</code></td> - <td>Lance l'application. Ne renvoie aucune valeur.</td> - </tr> - <tr> - <td><code>uninstall()</code></td> - <td>Désinstalle l'application, inclus la suppression des ressources locales. Une confirmation par l'utilisateur peut être nécessaire. Renvoie un objet <code>pendingUninstall</code>.</td> - </tr> - <tr> - <td><code>checkForUpdate()</code></td> - <td>Pour les <a href="/en-US/docs/Apps/Packaged_apps" title="/en-US/docs/Apps/Packaged_apps">applications empaquetées</a>. Vérifie si l'application empaquetée a été mise à jour. Renvoie un objet <a href="/fr/docs/Web/API/DOMRequest" title="Un objet DOMRequest représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet DOMRequest que vous pouvez surveiller pour connaitre le déroulement de l'opération"><code>DOMRequest</code></a>.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple_d'un_objet_App">Exemple d'un objet <code>App</code></h2> - -<pre class="brush: js">{ - manifest: { - name: "Add-on Builder", - default_locale: "en", - installs_allowed_from: [ - "https://apps-preview-dev.example.com/", - "https://apps-preview.example.com/" - ], - description: "Add-on Builder makes it easy to write, build and test Firefox extensions using common web technologies.", - version: "0.9.16.1", - developer: { - url: "https://builder.addons.mozilla.org/", - name: "Mozilla Flightdeck Team" - } - }, - origin: "https://builder-addons-dev.example.com", - installTime: 1321986882773, - installOrigin: "https://apps-preview-dev.example.com", - receipts: ["h0dHBzOi8v <em>(la majorité du reçu a été supprimée)</em> Tg2ODtkUp"] -}</pre> diff --git a/files/fr/archive/b2g_os/api/domrequest/error/index.html b/files/fr/archive/b2g_os/api/domrequest/error/index.html deleted file mode 100644 index 97e50b6908..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/error/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: DOMRequest.error -slug: Archive/B2G_OS/API/DOMRequest/error -tags: - - DOM -translation_of: Archive/B2G_OS/API/DOMRequest/error ---- -<div><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/en-US/docs/Mozilla/Firefox_OS/API/Archive"><code>Archive</code></a></strong></li><li data-default-state="open"><a href="#"><strong>Related pages for DOM (Non-standard)</strong></a><ol><li><a href="/en-US/docs/Mozilla/Firefox_OS/API/DOMCursor"><code>DOMCursor</code></a></li></ol></li></ol></section></div> - -<p>This property can contain error information in a <a href="/en-US/docs/Web/API/DOMError" title="The DOMError interface describes an error object that contains an error name."><code>DOMError</code></a> object.</p> - -<p></p><div class="note"><strong>Note:</strong> This feature is available in <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a>.</div><p></p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="eval">var <em>errorname</em> = <em>request</em>.error.name; -</pre> - -<p>Where <em>request</em> is a <a href="/en-US/docs/Web/API/DOMRequest" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest</code></a> object. This gets the name of the error. See <a href="/en-US/docs/Web/API/DOMError" title="The DOMError interface describes an error object that contains an error name."><code>DOMError</code></a> for the error types.</p> - -<h2 id="Specifications">Specifications</h2> - -<p>Not part of any current specification.</p> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>Supported in Firefox 13.<br> - Available in workers in Firefox 41.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/DOMRequest" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest</code></a></li> - <li><a href="/en-US/docs/Web/API/DOMRequest/onsuccess" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest.onsuccess</code></a></li> - <li><a href="/en-US/docs/Web/API/DOMRequest/onerror" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest.onerror</code></a></li> - <li><a href="/en-US/docs/Web/API/DOMRequest/readyState" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest.readyState</code></a></li> - <li><a href="/en-US/docs/Web/API/DOMRequest/result" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMRequest.result</code></a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/domrequest/index.html b/files/fr/archive/b2g_os/api/domrequest/index.html deleted file mode 100644 index 6fb4e8f968..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: DOMRequest -slug: Archive/B2G_OS/API/DOMRequest -tags: - - DOM - - Référence_du_DOM_Gecko -translation_of: Archive/B2G_OS/API/DOMRequest ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<p>Un objet <code>DOMRequest</code> représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet <code>DOMRequest</code> que vous pouvez surveiller pour connaitre le déroulement de l'opération</p> -<h2 id="Attributs">Attributs</h2> -<dl> - <dt> - {{ domxref("DOMRequest.onsuccess") }}</dt> - <dd> - Pour définir un callback à appeler quand l'opération représentée par <code>DOMRequest</code> est terminée</dd> - <dt> - {{ domxref("DOMRequest.onerror") }}</dt> - <dd> - Pour définir un callback qui sera appelé si une erreur survient pendant le déroulement de l'opération.</dd> - <dt> - {{ domxref("DOMRequest.readyState") }}</dt> - <dd> - Une chaîne de caractère indiquant si l'opération tourne toujours. Sa valeur est soit "<code>done</code>" ou "<code>pending</code>".</dd> - <dt> - {{ domxref("DOMRequest.result") }}</dt> - <dd> - Le résultat de l'opération.</dd> - <dt> - {{ domxref("DOMRequest.error") }}</dt> - <dd> - Information de l'erreur, si présent.</dd> -</dl> -<h2 id="Exemple">Exemple</h2> -<p>Un exemple de l'utilisation des propriétés <code>onsuccess</code>, <code>onerror</code>, <code>result</code> et <code>error</code> de l'objet <code>DOMRequest</code>.</p> -<pre class="brush: js">var pending = navigator.mozApps.install(manifestUrl); -pending.onsuccess = function () { - // Enregistre l'objet App renvoyé - var appRecord = this.result; - alert('Installation réussie !'); -}; -pending.onerror = function () { - // Affiche le nom de l'erreur - alert('Installation échouée, erreur : ' + this.error.name); -}; -</pre> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h2 id="Spécification">Spécification</h2> -<p>Ne fait actuellement partie d'aucune spécification</p> diff --git a/files/fr/archive/b2g_os/api/domrequest/onerror/index.html b/files/fr/archive/b2g_os/api/domrequest/onerror/index.html deleted file mode 100644 index 81160a27cb..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/onerror/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: DOMRequest.onerror -slug: Archive/B2G_OS/API/DOMRequest/onerror -tags: - - DOM - - Référence_du_DOM_Gecko -translation_of: Archive/B2G_OS/API/DOMRequest/onerror ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Cette propriété renseigne la fonction de callback à appeler quand un {{ domxref("DOMRequest") }} échoue.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="eval"><em>requete</em>.onerror = <em>fonction</em>; -</pre> -<p>Où <em>requete</em> est un objet {{ domxref("DOMRequest") }} et <em>fonction</em> est une fonction JavaScript à éxecuter quand la requête ne parvient pas à se terminer sans problème.</p> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Ne fait actuellement partie d'aucune spécification.</p> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{ domxref("DOMRequest") }}</li> - <li>{{ domxref("DOMRequest.onsuccess") }}</li> - <li>{{ domxref("DOMRequest.readyState") }}</li> - <li>{{ domxref("DOMRequest.result") }}</li> - <li>{{ domxref("DOMRequest.error") }}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/domrequest/onsuccess/index.html b/files/fr/archive/b2g_os/api/domrequest/onsuccess/index.html deleted file mode 100644 index 454fb8e72a..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/onsuccess/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: DOMRequest.onsuccess -slug: Archive/B2G_OS/API/DOMRequest/onsuccess -tags: - - DOM - - Référence_du_DOM_Gecko -translation_of: Archive/B2G_OS/API/DOMRequest/onsuccess ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Cette propriété renseigne la fonction de callback à appeler quand un {{ domxref("DOMRequest") }} se termine sans problème.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="eval"><em>requete</em>.onsuccess = <em>fonction</em>; -</pre> -<p>Où <em>requete</em> est un objet {{ domxref("DOMRequest") }} et <em>fonction</em> est une fonction JavaScript à executer quand le requête se termine sans problème.</p> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Ne fait actuellement partie d'aucune spécification.</p> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{ domxref("DOMRequest") }}</li> - <li>{{ domxref("DOMRequest.onerror") }}</li> - <li>{{ domxref("DOMRequest.readyState") }}</li> - <li>{{ domxref("DOMRequest.result") }}</li> - <li>{{ domxref("DOMRequest.error") }}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/domrequest/readystate/index.html b/files/fr/archive/b2g_os/api/domrequest/readystate/index.html deleted file mode 100644 index 15e22601a4..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/readystate/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: DOMRequest.readyState -slug: Archive/B2G_OS/API/DOMRequest/readyState -tags: - - DOM - - Référence_du_DOM_Gecko -translation_of: Archive/B2G_OS/API/DOMRequest/readyState ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Cette propriété est une chaîne de caractères indiquant si une opération {{ domxref("DOMRequest") }} a fini, ou pas, de s'éxecuter.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="eval">var etat = requete.readyState; -</pre> -<p>Où <em>requete</em> est un objet {{ domxref("DOMRequest") }}.</p> -<p>Cette propriété est en lecture seul.</p> -<h2 id="Valeur_renvoyée">Valeur renvoyée</h2> -<p>La valeur renvoyé est une chaîne de caractères JavaScript dont le contenu est "<code>done</code>" si l'opération est finie ou "<code>pending</code>" si elle ne l'est pas.</p> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Ne fait actuellement partie d'aucune spécification.</p> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{ domxref("DOMRequest") }}</li> - <li>{{ domxref("DOMRequest.onsuccess") }}</li> - <li>{{ domxref("DOMRequest.onerror") }}</li> - <li>{{ domxref("DOMRequest.result") }}</li> - <li>{{ domxref("DOMRequest.error") }}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/domrequest/result/index.html b/files/fr/archive/b2g_os/api/domrequest/result/index.html deleted file mode 100644 index 73efc17722..0000000000 --- a/files/fr/archive/b2g_os/api/domrequest/result/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: DOMRequest.result -slug: Archive/B2G_OS/API/DOMRequest/result -tags: - - DOM - - Référence_du_DOM_Gecko -translation_of: Archive/B2G_OS/API/DOMRequest/result ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Cette propriété fournit la valeur de résultat pour l'opération d'un {{ domxref("DOMRequest") }}.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="eval">var <em>resultat</em> = <em>requete</em>.result; -</pre> -<p>Où <em>requête</em> est un objet {{ domxref("DOMRequest") }}.</p> -<h2 id="Valeur_renvoyée">Valeur renvoyée</h2> -<p>La valeur renvoyée est un objet JavaScript représentant le résultat de l'opération.</p> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Ne fait actuellement partie d'aucune spécification.</p> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> -<p>{{ CompatibilityTable() }}</p> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("13.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> - </table> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{ domxref("DOMRequest") }}</li> - <li>{{ domxref("DOMRequest.onsuccess") }}</li> - <li>{{ domxref("DOMRequest.onerror") }}</li> - <li>{{ domxref("DOMRequest.readyState") }}</li> - <li>{{ domxref("DOMRequest.error") }}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/index.html b/files/fr/archive/b2g_os/api/index.html deleted file mode 100644 index 7706d81bd4..0000000000 --- a/files/fr/archive/b2g_os/api/index.html +++ /dev/null @@ -1,831 +0,0 @@ ---- -title: APIs de B2G OS -slug: Archive/B2G_OS/API -tags: - - API - - B2G API - - api de b2g os -translation_of: Archive/B2G_OS/API ---- -<h2 id="B2G_OS_utilise_les_API_Web_standards">B2G OS utilise les API Web standards</h2> - -<p></p><div class="index"> -<span>A</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ANGLE_instanced_arrays" title="The ANGLE_instanced_arrays extension is part of the WebGL API and allows to draw the same object, or groups of similar objects multiple times, if they share the same vertex data, primitive count and type."><code>ANGLE_instanced_arrays</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AbortController" title="The AbortController interface represents a controller object that allows you to abort one or more DOM requests as and when desired."><code>AbortController</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AbortSignal" title="The AbortSignal interface represents a signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object."><code>AbortSignal</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AbstractWorker" title="The AbstractWorker interface of the Web Workers API abstracts properties and methods common to all kind of workers, being Worker or SharedWorker."><code>AbstractWorker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AmbientLightSensor" title="The AmbientLightSensor interface of the the Ambient Light Sensor API returns an interface for accessing AmbientLightSensorReading."><code>AmbientLightSensor</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AmbientLightSensorReading" title="The AmbientLightSensorReading interface of the the Ambient Light Sensor API returns an interface for reading the current light level."><code>AmbientLightSensorReading</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnalyserNode" title="The AnalyserNode interface represents a node able to provide real-time frequency and time-domain analysis information. It is an AudioNode that passes the audio stream unchanged from the input to the output, but allows you to take the generated data, process it, and create audio visualizations."><code>AnalyserNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Animation" title="The Animation interface of the Web Animations API represents a single animation player and provides playback controls and a timeline for an animation node or source."><code>Animation</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationEffectReadOnly" title="The AnimationEffectReadOnly interface of the Web Animations API defines current and future animation effects like KeyframeEffect, which can be passed to Animation objects for playing, and KeyframeEffectReadOnly (which is used by CSS Animations and Transitions)."><code>AnimationEffectReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationEffectTiming" title="The AnimationEffectTiming interface of the Web Animations API is comprised of timing properties. It is returned by the timing attribute of a KeyframeEffect."><code>AnimationEffectTiming</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationEffectTimingProperties" title="The AnimationEffectTimingProperties dictionary, part of the Web Animations API, is used by Element.animate(), KeyframeEffectReadOnly(), and KeyframeEffect() to describe timing properties for animation effects. These properties are all optional, although without setting a duration the animation will not play."><code>AnimationEffectTimingProperties</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationEffectTimingReadOnly" title="The AnimationEffectTimingReadOnly interface of the Web Animations API is comprised of timing properties."><code>AnimationEffectTimingReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationEvent" title="The AnimationEvent interface represents events providing information related to animations."><code>AnimationEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationPlaybackEvent" title="The AnimationPlaybackEvent interface of the Web Animations API represents animation events."><code>AnimationPlaybackEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AnimationTimeline" title="The AnimationTimeline interface of the Web Animations API represents the timeline of an animation. This interface exists to define timeline features (inherited by DocumentTimeline and future timeline types) and is not itself directly used by developers. Anywhere you see AnimationTimeline, you should use DocumentTimeline or any other timeline type instead."><code>AnimationTimeline</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ArrayBufferView" title="ArrayBufferView is a helper type representing any of the following JavaScript TypedArray types:"><code>ArrayBufferView</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Attr" title="This type represents a DOM element's attribute as an object. In most DOM methods, you will probably directly retrieve the attribute as a string (e.g., Element.getAttribute(), but certain functions (e.g., Element.getAttributeNode()) or means of iterating give Attr types."><code>Attr</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioBuffer" title="Objects of these types are designed to hold small audio snippets, typically less than 45 s. For longer sounds, objects implementing the MediaElementAudioSourceNode are more suitable. The buffer contains data in the following format: non-interleaved IEEE754 32-bit linear PCM with a nominal range between -1 and +1, that is, 32bits floating point buffer, with each samples between -1.0 and 1.0. If the AudioBuffer has multiple channels, they are stored in separate buffer."><code>AudioBuffer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioBufferSourceNode" title="The AudioBufferSourceNode interface is an AudioScheduledSourceNode which represents an audio source consisting of in-memory audio data, stored in an AudioBuffer. It's especially useful for playing back audio which has particularly stringent timing accuracy requirements, such as for sounds that must match a specific rhythm and can be kept in memory rather than being played from disk or the network."><code>AudioBufferSourceNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioContext" title="Also inherits properties from its parent interface, BaseAudioContext."><code>AudioContext</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioDestinationNode" title="AudioDestinationNode has no output (as it is the output, no more AudioNode can be linked after it in the audio graph) and one input. The number of channels in the input must be between 0 and the maxChannelCount value or an exception is raised."><code>AudioDestinationNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioListener" title="It is important to note that there is only one listener per context and that it isn't an AudioNode."><code>AudioListener</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioNode" title="The AudioNode interface is a generic interface for representing an audio processing module like an audio source (e.g. an HTML <audio> or <video> element, an OscillatorNode, etc.), the audio destination, intermediate processing module (e.g. a filter like BiquadFilterNode or ConvolverNode), or volume control (like GainNode)."><code>AudioNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioNodeOptions" title="The AudioNodeOptions dictionary of the Web Audio API specifies options that can be used when creating new AudioNode objects."><code>AudioNodeOptions</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioParam" title="There are two kinds of AudioParam, a-rate and k-rate parameters:"><code>AudioParam</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioProcessingEvent" title="The Web Audio API AudioProcessingEvent represents events that occur when a ScriptProcessorNode input buffer is ready to be processed."><code>AudioProcessingEvent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/AudioScheduledSourceNode" title="The AudioScheduledSourceNode interface—part of the Web Audio API—is a parent interface for several types of audio source node interfaces which share the ability to be started and stopped, optionally at specified times. Specifically, this interface defines the start() and stop() methods, as well as the onended event handler."><code>AudioScheduledSourceNode</code></a></span></span></li> -</ul> -<span>B</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BaseAudioContext" title="A BaseAudioContext can be a target of events, therefore it implements the EventTarget interface."><code>BaseAudioContext</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BasicCardRequest" title="The BasicCardRequest dictionary is a JavaScript object-structure that can be used in the Payment Request API. The properties of BasicCardRequest are defined in the Basic Card Payment spec)."><code>BasicCardRequest</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BasicCardResponse" title="The BasicCardResponse dictionary (related to the Payment Request API, although defined in the Basic Card Payment spec) defines an object structure for payment response details such as the number/expiry date of the card used to make the payment, and the billing address."><code>BasicCardResponse</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BatteryManager" title="The BatteryManager interface provides ways to get information about the system's battery charge level."><code>BatteryManager</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BeforeInstallPromptEvent" title='The BeforeInstallPromptEvent is fired at the Window.onbeforeinstallprompt handler before a user is prompted to "install" a web site to a home screen on mobile.'><code>BeforeInstallPromptEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BeforeUnloadEvent" title="The beforeunload event is fired when the window, the document and its resources are about to be unloaded."><code>BeforeUnloadEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BiquadFilterNode" title="The BiquadFilterNode interface represents a simple low-order filter, and is created using the AudioContext.createBiquadFilter() method. It is an AudioNode that can represent different kinds of filters, tone control devices, and graphic equalizers."><code>BiquadFilterNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Blob" title="A Blob object represents a file-like object of immutable, raw data. Blobs represent data that isn't necessarily in a JavaScript-native format. The File interface is based on Blob, inheriting blob functionality and expanding it to support files on the user's system."><code>Blob</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BlobBuilder" title="The BlobBuilder interface provides an easy way to construct Blob objects. Just create a BlobBuilder and append chunks of data to it by calling the append() method. When you're done building your blob, call getBlob() to retrieve a Blob containing the data you sent into the blob builder."><code>BlobBuilder</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BlobEvent" title="The BlobEvent interface represents events associated with a Blob. These blobs are typically, but not necessarily, associated with media content."><code>BlobEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Bluetooth" title="The Bluetooth interface of the Web Bluetooth API returns a Promise to a BluetoothDevice object with the specified options."><code>Bluetooth</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothAdvertisingData" title="The BluetoothDevice interface of the Web Bluetooth API provides advertising data about a particular Bluetooth device."><code>BluetoothAdvertisingData</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothCharacteristicProperties" title="The BluetoothCharacteristicProperties interface of the the Web Bluetooth API provides an object provides propertieds of a particular BluetoothRemoteGATTCharacteristic."><code>BluetoothCharacteristicProperties</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothRemoteGATTCharacteristic" title="The BluetoothRemoteGattCharacteristic interface of the Web Bluetooth API represents a GATT Characteristic, which is a basic data element that provides further information about a peripheral’s service."><code>BluetoothRemoteGATTCharacteristic</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothRemoteGATTDescriptor" title="The BluetoothRemoteGATTDescriptor interface of the Web Bluetooth API provides a GATT Descriptor, which provides further information about a characteristic’s value."><code>BluetoothRemoteGATTDescriptor</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothRemoteGATTServer" title="The BluetoothRemoteGATTServer interface of the Web Bluetooth API represents a GATT Server on a remote device."><code>BluetoothRemoteGATTServer</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BluetoothStatusChangedEvent" title="The BluetoothStatusChangedEvent API provides access to information regarding any change to the status of a Bluetooth device."><code>BluetoothStatusChangedEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Body" title="The Body mixin of the Fetch API represents the body of the response/request, allowing you to declare what its content type is and how it should be handled."><code>Body</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BroadcastChannel" title="The BroadcastChannel interface represents a named channel that any browsing context of a given origin can subscribe to. It allows communication between different documents (in different windows, tabs, frames or iframes) of the same origin. Messages are broadcasted via a message event fired at all BroadcastChannel objects listening to the channel."><code>BroadcastChannel</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BudgetService" title="The BudgetService interface of the Web Budget API provides a programmatic interface to the user agent’s budget service. It is available in both document and worker environments."><code>BudgetService</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BudgetState" title="The BudgetState interface of the the Web Budget API provides the amount of the user agent's processing budget at a specific point in time."><code>BudgetState</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/BufferSource" title="BufferSource is a typedef used to represent objects that are either themselves an ArrayBuffer, or which are a TypedArray providing an ArrayBufferView."><code>BufferSource</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ByteLengthQueueingStrategy" title="The ByteLengthQueuingStrategy interface of the the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams."><code>ByteLengthQueuingStrategy</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ByteString" title="ByteString is a UTF-8 String that corresponds to the set of all possible sequences of bytes. ByteString maps to a String when returned in JavaScript; generally, it's only used when interfacing with protocols that use bytes and strings interchangably, such as HTTP."><code>ByteString</code></a></span></span></li> -</ul> -<span>C</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CDATASection" title="The CDATASection interface represents a CDATA section that can be used within XML to include extended portions of unescaped text, such that the symbols < and & do not need escaping as they normally do within XML when used as text."><code>CDATASection</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSS" title="The CSS interface holds useful CSS-related methods. No object with this interface are implemented: it contains only static methods and therefore is a utilitarian interface."><code>CSS</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSConditionRule" title="An object implementing the CSSConditionRule interface represents a single condition CSS at-rule, which consists of a condition and a statement block. It is a child of CSSGroupingRule."><code>CSSConditionRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSCounterStyleRule" title="The CSSCounterStyleRule interface represents an @counter-style at-rule."><code>CSSCounterStyleRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSGroupingRule" title="An object implementing the CSSGroupingRule interface represents any CSS at-rule that contains other rules nested within it."><code>CSSGroupingRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSKeyframeRule" title="The CSSKeyframeRule interface describes an object representing a set of style for a given keyframe. It corresponds to the contains of a single keyframe of a @keyframes at-rule. It implements the CSSRule interface with a type value of 8 (CSSRule.KEYFRAME_RULE)."><code>CSSKeyframeRule</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSKeyframesRule" title="The CSSKeyframesRule interface describes an object representing a complete set of keyframes for a CSS animation. It corresponds to the contains of a whole @keyframes at-rule. It implements the CSSRule interface with a type value of 7 (CSSRule.KEYFRAMES_RULE)."><code>CSSKeyframesRule</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSMatrix" title="A CSSMatrix represents a homogeneous 4x4 matrix to which 2D or 3D transforms can be applied. This class was allegedly part of CSS Transitions Module Level 3 at some point, but is not present in the current Working Draft. Use DOMMatrix instead."><code>CSSMatrix</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSMediaRule" title="The CSSMediaRule is an interface representing a single CSS @media rule. It implements the CSSConditionRule interface, and therefore the CSSGroupingRule and the CSSRule interface with a type value of 4 (CSSRule.MEDIA_RULE)."><code>CSSMediaRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSNamespaceRule" title="The CSSNamespaceRule interface describes an object representing a single CSS @namespace at-rule. It implements the CSSRule interface, with a type value of 10 (CSSRule.NAMESPACE_RULE)."><code>CSSNamespaceRule</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSOMString" title="CSSOMString is used to denote string data in CSSOM specifications and can refer to either DOMString or USVString. When a specification says CSSOMString, it is left for the browser vendors to choose whether to use DOMString or USVString. While browser implementations that use UTF-8 internally to represent strings in memory can use USVString when the specification says CSSOMString, implementations that already represent strings as 16-bit sequences might choose to use DOMString instead."><code>CSSOMString</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSPageRule" title="CSSPageRule is an interface representing a single CSS @page rule. It implements the CSSRule interface with a type value of 6 (CSSRule.PAGE_RULE)."><code>CSSPageRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSPrimitiveValue" title="The CSSPrimitiveValue interface derives from the CSSValue interface and represents the current computed value of a CSS property."><code>CSSPrimitiveValue</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSRule" title="The CSSRule interface represents a single CSS rule. There are several types of rules, listed in the Type constants section below."><code>CSSRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSRuleList" title="A CSSRuleList is an (indirect-modify only) array-like object containing an ordered collection of CSSRule objects."><code>CSSRuleList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSStyleDeclaration" title="CSSStyleDeclaration represents a collection of CSS property-value pairs. It is used in a few APIs:"><code>CSSStyleDeclaration</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSStyleRule" title="CSSStyleRule represents a single CSS style rule. It implements the CSSRule interface with a type value of 1 (CSSRule.STYLE_RULE)."><code>CSSStyleRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSStyleSheet" title="The CSSStyleSheet interface represents a single CSS style sheet. It inherits properties and methods from its parent, StyleSheet."><code>CSSStyleSheet</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSSupportsRule" title="The CSSSupportsRule interface describes an object representing a single CSS @supports at-rule. It implements the CSSConditionRule interface, and therefore the CSSRule and CSSGroupingRule interfaces with a type value of 12 (CSSRule.SUPPORTS_RULE)."><code>CSSSupportsRule</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSValue" title="The CSSValue interface represents the current computed value of a CSS property."><code>CSSValue</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CSSValueList" title="The CSSValueList interface derives from the CSSValue interface and provides the abstraction of an ordered collection of CSS values."><code>CSSValueList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Cache" title="The Cache interface provides a storage mechanism for Request / Response object pairs that are cached, for example as part of the ServiceWorker life cycle. Note that the Cache interface is exposed to windowed scopes as well as workers. You don't have to use it in conjunction with service workers, even though it is defined in the service worker spec."><code>Cache</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CacheStorage" title="The CacheStorage interface represents the storage for Cache objects. It provides a master directory of all the named caches that a ServiceWorker, other type of worker or window scope can access (you don't have to use it with service workers, even though that is the spec that defines it) and maintains a mapping of string names to corresponding Cache objects."><code>CacheStorage</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CanvasCaptureMediaStream" title="The CanvasCaptureMediaStream interface represents a MediaStream capturing in real-time the surface of an HTMLCanvasElement."><code>CanvasCaptureMediaStream</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CanvasGradient" title="The CanvasGradient interface represents an opaque object describing a gradient. It is returned by the methods CanvasRenderingContext2D.createLinearGradient() or CanvasRenderingContext2D.createRadialGradient()."><code>CanvasGradient</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CanvasImageSource" title="CanvasImageSource is a helper type representing any objects of one of the following types:"><code>CanvasImageSource</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CanvasPattern" title="The CanvasPattern interface represents an opaque object describing a pattern, based on an image, a canvas or a video, created by the CanvasRenderingContext2D.createPattern() method."><code>CanvasPattern</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CanvasRenderingContext2D" title='To get an object of this interface, call getContext() on a &amp;amp;amp;lt;canvas> element, supplying "2d" as the argument:'><code>CanvasRenderingContext2D</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CaretPosition" title="The CaretPosition interface represents the caret postion, an indicator for the text insertion point. You can get a CaretPosition using the document.caretPositionFromPoint method."><code>CaretPosition</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ChannelMergerNode" title=""><code>ChannelMergerNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ChannelSplitterNode" title=""><code>ChannelSplitterNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CharacterData" title="The CharacterData abstract interface represents a Node object that contains characters. This is an abstract interface, meaning there aren't any object of type CharacterData: it is implemented by other interfaces, like Text, Comment, or ProcessingInstruction which aren't abstract."><code>CharacterData</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ChildNode" title="The ChildNode interface contains methods that are particular to Node objects that can have a parent."><code>ChildNode</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ChromeWorker" title="If you're developing privileged code, and would like to create a worker that can use js-ctypes to perform calls to native code, you can do so by using ChromeWorker instead of the standard Worker object. It works exactly like a standard Worker, except that it has access to js-ctypes via a global ctypes object available in the global scope of the worker. Examples of ChromeWorker's using js-ctypes are availabe on Github and are linked to from the See Also section below. To use a postMessage with callback version of ChromeWorker that features promises, see PromiseWorker."><code>ChromeWorker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Client" title="The Client interface represents an executable context such as a Worker, or a SharedWorker. Window clients are represented by the more-specific WindowClient. You can get Client/WindowClient objects from methods such as Clients.matchAll() and Clients.get()."><code>Client</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Clients" title="The Clients interface provides access to Client objects. Access it via self.clients within a service worker."><code>Clients</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ClipboardEvent" title="The ClipboardEvent interface represents events providing information related to modification of the clipboard, that is cut, copy, and paste events."><code>ClipboardEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CloseEvent" title="A CloseEvent is sent to clients using WebSockets when the connection is closed. This is delivered to the listener indicated by the WebSocket object's onclose attribute."><code>CloseEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Comment" title="The Comment interface represents textual notations within markup; although it is generally not visually shown, such comments are available to be read in the source view. Comments are represented in HTML and XML as content between '<!--' and '-->'. In XML, the character sequence '--' cannot be used within a comment."><code>Comment</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CompositionEvent" title="The DOM CompositionEvent represents events that occur due to the user indirectly entering text."><code>CompositionEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Console" title="The Console object provides access to the browser's debugging console (e.g., the Web Console in Firefox). The specifics of how it works vary from browser to browser, but there is a de facto set of features that are typically provided."><code>Console</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConstantSourceNode" title="The ConstantSourceNode interface—part of the Web Audio API—represents an audio source (based upon AudioScheduledSourceNode) whose output is single unchanging value. This makes it useful for cases in which you need a constant value coming in from an audio source. in addition, it can be used like a constructible AudioParam by automating the value of its offset or by connecting another node to it; see Controlling multiple parameters with ConstantSourceNode."><code>ConstantSourceNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConstrainBoolean" title="The ConstrainBoolean dictionary is used to specify a constraint for a property whose value is a Boolean value. You can specify an exact value which must be matched, an ideal value that should be matched if at all possible, and a fallback value to attempt to match once all more specific constraints have been applied."><code>ConstrainBoolean</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConstrainDOMString" title="The ConstrainDOMString dictionary is used to specify a constraint for a property whose value is a string. It allows you to specify one or more exact string values from which one must be the parameter's value, or a set of ideal values which should be used if possible. You can also specify a single string (or an array of strings) which the user agent will do its best to match once all more stringent constraints have been applied."><code>ConstrainDOMString</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConstrainDouble" title="The ConstrainDouble type is used to specify a constraint for a property whose value is a double-precision floating-point number. It extends the DoubleRange dictionary (which provides the ability to specify a permitted range of property values) to also support an exact value and/or an ideal value the property should take on. Additionally, you can specify the property's value as a simple floating-point value, in which case the user agent does its best to match the value once all other more stringent constraints are met."><code>ConstrainDouble</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConstrainLong" title="The ConstrainLong type is used to specify a constraint for a property whose value is an integral number. It extends the LongRange dictionary (which provides the ability to specify a permitted range of property values) to also support an exact value and/or an ideal value the property should take on. In addition, you can specify the value as a simple long integer value, in which case the user agent does its best to match the value once all other more stringent constraints are met."><code>ConstrainLong</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ConvolverNode" title="The ConvolverNode interface is an AudioNode that performs a Linear Convolution on a given AudioBuffer, often used to achieve a reverb effect. A ConvolverNode always has exactly one input and one output."><code>ConvolverNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Coordinates" title="The Coordinates interface represents the position and altitude of the device on Earth, as well as the accuracy with which these properties are calculated."><code>Coordinates</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CountQueueingStrategy" title="The CountQueuingStrategy interface of the the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams."><code>CountQueueingStrategy</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Credential" title="The Credential interface of the the Credential Management API provides information about an entity as a prerequisite to a trust decision."><code>Credential</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CredentialsContainer" title="The CredentialsContainer interface of the the Credential Management API exposes methods to request credentials and notify the user agent when events such as successful sign in or sign out happen. This interface is accessible from Navigator.credentials."><code>CredentialsContainer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Crypto" title="The Crypto interface represents basic cryptography features available in the current context. It allows access to a cryptographically strong random number generator and to cryptographic primitives."><code>Crypto</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CryptoKey" title="The CryptoKey interface represents a cryptographic key derived from a specific key algorithm."><code>CryptoKey</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CustomElementRegistry" title="The CustomElementRegistry interface provides methods for registering custom elements and querying registered elements. It can be accessed with window.customElements."><code>CustomElementRegistry</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/CustomEvent" title="This interface inherits properties from its parent, Event:"><code>CustomEvent</code></a></span></span></li> -</ul> -<span>D</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMConfiguration" title='Pre-defined parameters: "canonical-form", "cdata-sections", "check-character-normalization", "comments", "datatype-normalization", "element-content-whitespace", "entities", "error-handler", "infoset", "namespaces", "namespace-declarations", "normalize-characters","schema-location", "schema-type", "split-cdata-sections", "validate", "validate-if-schema", "well-formed"'><code>DOMConfiguration</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMError" title="The DOMError interface describes an error object that contains an error name."><code>DOMError</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMErrorHandler" title='Set as "error-handler" parameter in DOMConfiguration.setParameter . Implementation may provide a default handler. DOMError.relatedData will contain closest node to where error occurred or contain the Document node if it is unable to be determined. Document mutations from within the error handler result in implementation-dependent behavior. If there are to be multiple errors, the sequence and numbers of the errors passed to the error handler are also implementation dependent. The application using the DOM implementation implements this interface:'><code>DOMErrorHandler</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMException" title="The DOMException interface represents an abnormal event (called an exception) which occurs as a result of calling a method or accessing a property of a web API."><code>DOMException</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMHighResTimeStamp" title="The DOMHighResTimeStamp type is a double and is used to store a time value. The value could be a discrete point in time or the difference in time between two discrete points in time. The unit is milliseconds and should be accurate to 5 µs (microseconds). However, if the browser is unable to provide a time value accurate to 5 microseconds (due, for example, to hardware or software constraints), the browser can represent the value as a time in milliseconds accurate to a millisecond."><code>DOMHighResTimeStamp</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMImplementation" title="The DOMImplementation interface represent an object providing methods which are not dependent on any particular document. Such an object is returned by the Document.implementation property."><code>DOMImplementation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMImplementationList" title="Returned by DOMImplementationSource.getDOMImplementationList() and DOMImplementationRegistry.getDOMImplementationList() . Can be iterated with 0-based index."><code>DOMImplementationList</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMImplementationRegistry" title="This is a global variable used to get a single DOMImplementation or DOMImplementationList depending on the registered objects with the specified features."><code>DOMImplementationRegistry</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMImplementationSource" title="Can request a particular implementation based on needed features and versions (which can then be used to create a document, etc.). Called during DOMImplementationRegistry.getDOMImplementation() and DOMImplementationRegistry.getDOMImplementationList()."><code>DOMImplementationSource</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMLocator" title="Indicates a location such as where an error occurred. Returned by DOMError.location."><code>DOMLocator</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMMatrix" title="The DOMMatrix interface represents 4x4 matrices, suitable for 2D and 3D operations."><code>DOMMatrix</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMMatrixReadOnly" title="The DOMMatrixReadOnly interface represents 4x4 matrices, suitable for 2D and 3D operations. If this interface defines only read-only matrices, the DOMMatrix interface which inherits from it, add all the properties and the methods to allow to have modifiable matrices."><code>DOMMatrixReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMObject" title=""><code>DOMObject</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMParser" title="DOMParser can parse XML or HTML source stored in a string into a DOM Document. DOMParser is specified in DOM Parsing and Serialization."><code>DOMParser</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMPoint" title="A DOMPoint represents a 2D or 3D point in a coordinate system."><code>DOMPoint</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMPointReadOnly" title="Editorial review completed."><code>DOMPointReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMRect" title="A DOMRect represents a rectangle."><code>DOMRect</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMRectReadOnly" title="The DOMRectReadOnly interface specifies the standard properties used by DOMRect to define a rectangle."><code>DOMRectReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMString" title="DOMString is a UTF-16 String. As JavaScript already uses such strings, DOMString is mapped directly to a String."><code>DOMString</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMStringList" title="A type returned by some APIs which contains a list of DOMString (strings)."><code>DOMStringList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMStringMap" title="Editorial review completed."><code>DOMStringMap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMTimeStamp" title="The DOMTimeStamp type represents an absolute or relative number of milliseconds, depending on the specification in which it appears."><code>DOMTimeStamp</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMTokenList" title="The DOMTokenList interface represents a set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList or HTMLAreaElement.relList. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive."><code>DOMTokenList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DOMUserData" title="DOMUserData refers to application data. In JavaScript, it maps directly to Object. It is returned or used as an argument by Node.setUserData(), Node.getUserData(), used as the third argument to handle() on UserDataHandler, and is used or returned by various DOMConfiguration methods."><code>DOMUserData</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DataTransfer" title="The DataTransfer object is used to hold the data that is being dragged during a drag and drop operation. It may hold one or more data items, each of one or more data types. For more information about drag and drop, see HTML Drag and Drop API."><code>DataTransfer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DataTransferItem" title="The DataTransferItem object represents one drag data item. During a drag operation, each drag event has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object."><code>DataTransferItem</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DataTransferItemList" title="The DataTransferItemList object is a list of DataTransferItem objects representing items being dragged. During a drag operation, each DragEvent has a dataTransfer property and that property is a DataTransferItemList."><code>DataTransferItemList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DedicatedWorkerGlobalScope" title="The DedicatedWorkerGlobalScope object (the Worker global scope) is accessible through the self keyword. Some additional global functions, namespaces objects, and constructors, not typically associated with the worker global scope, but available on it, are listed in the JavaScript Reference. See also: Functions available to workers."><code>DedicatedWorkerGlobalScope</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DelayNode" title=""><code>DelayNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceAcceleration" title="A DeviceAcceleration object provides information about the amount of acceleration the device is experiencing along all three axes."><code>DeviceAcceleration</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceLightEvent" title="The DeviceLightEvent provides web developers with information from photo sensors or similiar detectors about ambient light levels near the device. For example this may be useful to adjust the screen's brightness based on the current ambient light level in order to save energy or provide better readability."><code>DeviceLightEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceMotionEvent" title="The DeviceMotionEvent provides web developers with information about the speed of changes for the device's position and orientation."><code>DeviceMotionEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceOrientationEvent" title="The DeviceOrientationEvent provides web developers with information from the physical orientation of the device running the web page."><code>DeviceOrientationEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceProximityEvent" title="The DeviceProximityEvent interface provides information about the distance of a nearby physical object using the proximity sensor of a device."><code>DeviceProximityEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DeviceRotationRate" title="A DeviceRotationRate object provides information about the rate at which the device is rotating around all three axes."><code>DeviceRotationRate</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DirectoryEntrySync" title="The DirectoryEntrySync interface of the File System API represents a directory in a file system. It includes methods for creating, reading, looking up, and recursively removing files in a directory."><code>DirectoryEntrySync</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DirectoryReaderSync" title="The DirectoryReaderSync interface of the File System API lets you read the entries in a directory."><code>DirectoryReaderSync</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Document" title="The Document interface represents any web page loaded in the browser and serves as an entry point into the web page's content, which is the DOM tree."><code>Document</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DocumentFragment" title="The DocumentFragment interface represents a minimal document object that has no parent. It is used as a lightweight version of Document that stores a segment of a document structure comprised of nodes just like a standard document. The key difference is that because the document fragment isn't part of the active document tree structure, changes made to the fragment don't affect the document, cause reflow, or incur any performance impact that can occur when changes are made."><code>DocumentFragment</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DocumentOrShadowRoot" title="The DocumentOrShadowRoot interface of the Shadow DOM API provides APIs that are shared between documents and shadow roots."><code>DocumentOrShadowRoot</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DocumentTimeline" title="The DocumentTimeline interface of the the Web Animations API represents animation timelines, including the default document timeline (accessed via Document.timeline)."><code>DocumentTimeline</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DocumentTouch" title="The DocumentTouch interface used to provide convenience methods for creating Touch and TouchList objects, but DocumentTouch been removed from the standards. These two methods now live on the Document interface now."><code>DocumentTouch</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DocumentType" title="The DocumentType interface represents a Node containing a doctype."><code>DocumentType</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DoubleRange" title="The DoubleRange dictionary is used to define a range of permitted double-precision floating-point values for a property, with either or both a maximum and minimum value specified. The ConstrainDouble dictionary is based on this, augmenting it to support exact and ideal values as well."><code>DoubleRange</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DragEvent" title="The DragEvent interface is a DOM event that represents a drag and drop interaction. The user initiates a drag by placing a pointer device (such as a mouse) on the touch surface and then dragging the pointer to a new location (such as another DOM element). Applications are free to interpret a drag and drop interaction in an application-specific way."><code>DragEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/DynamicsCompressorNode" title="Inherits properties from its parent, AudioNode."><code>DynamicsCompressorNode</code></a></span></span></li> -</ul> -<span>E</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_blend_minmax" title="The EXT_blend_minmax extension is part of the WebGL API and extends blending capabilities by adding two new blend equations: the minimum or maximum color components of the source and destination colors."><code>EXT_blend_minmax</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_color_buffer_float" title="The EXT_color_buffer_float extension is part of WebGL and adds the ability to render a variety of floating point formats."><code>EXT_color_buffer_float</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_color_buffer_half_float" title="The EXT_color_buffer_half_float extension is part of the WebGL API and adds the ability to render to 16-bit floating-point color buffers."><code>EXT_color_buffer_half_float</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_disjoint_timer_query" title="The EXT_disjoint_timer_query extension is part of the WebGL API and provides a way to measure the duration of a set of GL commands, without stalling the rendering pipeline."><code>EXT_disjoint_timer_query</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_frag_depth" title="The EXT_frag_depth extension is part of the WebGL API and enables to set a depth value of a fragment from within the fragment shader."><code>EXT_frag_depth</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_sRGB" title="The EXT_sRGB extension is part of the WebGL API and adds sRGB support to textures and framebuffer objects."><code>EXT_sRGB</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_shader_texture_lod" title="The EXT_shader_texture_lod extension is part of the WebGL API and adds additional texture functions to the OpenGL ES Shading Language which provide the shader writer with explicit control of LOD (Level of detail)."><code>EXT_shader_texture_lod</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EXT_texture_filter_anisotropic" title="The EXT_texture_filter_anisotropic extension is part of the WebGL API and exposes two constants for anisotropic filtering (AF)."><code>EXT_texture_filter_anisotropic</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Element" title="Element is the most general base class from which all objects in a Document inherit. It only has methods and properties common to all kinds of element. More specific classes inherit from Element."><code>Element</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ElementTraversal" title="The ElementTraversal interface was defining methods allowing to access from one Node to another one in the document tree."><code>ElementTraversal</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Entity" title="Read-only reference to a DTD entity. Also inherits the methods and properties of Node."><code>Entity</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EntityReference" title="Read-only reference to an entity reference in the DOM tree. Has no properties or methods of its own but inherits from Node."><code>EntityReference</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EntrySync" title="The EntrySync interface of the FileSystem API represents an entry in a file system. The entry can be a FileEntrySync or a DirectoryEntry. It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about the file it points to—including the file name and its path from the root to the entry."><code>EntrySync</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ErrorEvent" title="The ErrorEvent interface represents events providing information related to errors in scripts or in files."><code>ErrorEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Event" title="The Event interface represents any event which takes place in the DOM; some are user-generated (such as mouse or keyboard events), while others are generated by APIs (such as events that indicate an animation has finished running, a video has been paused, and so forth). There are many types of events, some of which use other interfaces based on the main Event interface. Event itself contains the properties and methods which are common to all events."><code>Event</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EventListener" title="This method is called whenever an event occurs of the type for which the EventListener interface was registered."><code>EventListener</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EventSource" title="The EventSource interface is used to receive server-sent events. It connects to a server over HTTP and receives events in text/event-stream format without closing the connection."><code>EventSource</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/EventTarget" title="EventTarget is an interface implemented by objects that can receive events and may have listeners for them."><code>EventTarget</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ExtendableEvent" title="The ExtendableEvent interface extends the lifetime of the install and activate events dispatched on the global scope as part of the service worker lifecycle. This ensures that any functional events (like FetchEvent) are not dispatched until it upgrades database schemas and deletes the outdated cache entries."><code>ExtendableEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ExtendableMessageEvent" title="The ExtendableMessageEvent interface of the ServiceWorker API represents the event object of a message event fired on a service worker (when a channel message is received on the ServiceWorkerGlobalScope from another context) — extends the lifetime of such events."><code>ExtendableMessageEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>F</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FederatedCredential" title="The FederatedCredential interface of the the Credential Management API provides information about credentials from a federated identity provider. A federated identity provider is an entity that a website trusts to correctly authenticate a user, and that provides an API for that purpose. OpenID Connect is an example of a federated identity provider framework."><code>FederatedCredential</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FetchEvent" title="This is the event type for fetch events despatched on the service worker global scope. It contains information about the fetch, including the request and how the receiver will treat the response. It provides the event.respondWith() method, which allows us to provide a response to this fetch."><code>FetchEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/File" title="The File interface provides information about files and allows JavaScript in a web page to access their content."><code>File</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileEntrySync" title="The FileEntrySync interface of the File System API represents a file in a file system. It lets you write content to a file."><code>FileEntrySync</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileError" title="Represents an error that occurs while using the FileReader interface."><code>FileError</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileException" title="In the File System API, a FileException object represents error conditions that you might encounter while accessing the file system using the synchronous API. It extends the FileException interface described in File Writer and adds several new error codes."><code>FileException</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileList" title="An object of this type is returned by the files property of the HTML <input> element; this lets you access the list of files selected with the <input type="file"> element. It's also used for a list of files dropped into web content when using the drag and drop API; see the DataTransfer object for details on this usage."><code>FileList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileReader" title="The FileReader object lets web applications asynchronously read the contents of files (or raw data buffers) stored on the user's computer, using File or Blob objects to specify the file or data to read."><code>FileReader</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileReaderSync" title="The FileReaderSync interface allows to read File or Blob objects in a synchronous way."><code>FileReaderSync</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileRequest" title="The FileRequest interface extends the DOMRequest interface to provide some extra properties necessary for the LockedFile objects."><code>FileRequest</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystem" title="The File and Directory Entries API interface FileSystem is used to represent a file system. These objects can be obtained from the filesystem property on any file system entry. Some browsers offer additional APIs to create and manage file systems, such as Chrome's requestFileSystem() method."><code>FileSystem</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemDirectoryEntry" title="The FileSystemDirectoryEntry interface of the File and Directory Entries API represents a directory in a file system. It provides methods which make it possible to access and manipulate the files in a directory, as well as to access the entries within the directory."><code>FileSystemDirectoryEntry</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemDirectoryReader" title="The FileSystemDirectoryReader interface of the File and Directory Entries API lets you access the FileEntry-based objects (generally FileSystemFileEntry or FileSystemDirectoryEntry) representing each entry in a directory."><code>FileSystemDirectoryReader</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemEntry" title="The FileSystemEntry interface of the File and Directory Entries API represents a single in a file system. The entry can be a file or a directory (directories are represented by the DirectoryEntry interface). It includes methods for working with files—including copying, moving, removing, and reading files—as well as information about a file it points to—including the file name and its path from the root to the entry."><code>FileSystemEntry</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemFileEntry" title="The FileSystemFileEntry interface of the File System API represents a file in a file system. It offers properties describing the file's attributes, as well as the file() method, which creates a File object that can be used to read the file."><code>FileSystemFileEntry</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemFlags" title="The FileSystemFlags dictionary defines a set of values which are used when specifying option flags when calling certain methods in the File and Directory Entries API. Methods which accept an options parameter of this type may specify zero or more of these flags as fields in an object, like this:"><code>FileSystemFlags</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FileSystemSync" title="In the File System API, a FileSystemSync object represents a file system. It has two properties."><code>FileSystemSync</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FocusEvent" title="The FocusEvent interface represents focus-related events like focus, blur, focusin, or focusout."><code>FocusEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FontFace" title="The FontFace interface represents a single usable font face. It allows control of the source of the font face, being a URL to an external resource, or a buffer; it also allows control of when the font face is loaded and its current status."><code>FontFace</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FontFaceSet" title="The FontFaceSet interface of the CSS Font Loading API manages the loading of font-faces and querying of their download status."><code>FontFaceSet</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FontFaceSetLoadEvent" title="The FontFaceSetLoadEvent interface of the the Css Font Loading API is fired whenever a FontFaceSet loads."><code>FontFaceSetLoadEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FormData" title='The FormData interface provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method. It uses the same format a form would use if the encoding type were set to "multipart/form-data".'><code>FormData</code></a></span></span></li> -</ul> -<span>G</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GainNode" title="The gain is a unitless value, changing with time, that is multiplied to each corresponding sample of all input channels. If modified, the new gain is applied using a de-zippering algorithm in order to prevent unaesthetic 'clicks' from appearing in the resulting audio."><code>GainNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Gamepad" title="The Gamepad interface of the Gamepad API defines an individual gamepad or other controller, allowing access to information such as button presses, axis positions, and id."><code>Gamepad</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GamepadButton" title="The GamepadButton interface defines an individual button of a gamepad or other controller, allowing access to the current state of different types of buttons available on the control device."><code>GamepadButton</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GamepadEvent" title=""><code>GamepadEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GamepadHapticActuator" title="The GamepadHapticActuator interface of the Gamepad API represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware."><code>GamepadHapticActuator</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GamepadPose" title="The GamepadPose interface of the Gamepad API represents the pose of a WebVR controller at a given timestamp (which includes orientation, position, velocity, and acceleration information.)"><code>GamepadPose</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Geolocation" title="The Geolocation interface represents an object able to programmatically obtain the position of the device. It gives Web content access to the location of the device. This allows a Web site or app to offer customized results based on the user's location."><code>Geolocation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GestureEvent" title="The GestureEvent is a proprietary interface specific to WebKit which gives information regarding multi-touch gestures. Events using this interface include gesturestart, gesturechange, and gestureend."><code>GestureEvent</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GlobalEventHandlers" title="The GlobalEventHandlers mixin describes the event handlers common to several interfaces like HTMLElement, Document, or Window. Each of these interfaces can, of course, add more event handlers in addition to the ones listed below."><code>GlobalEventHandlers</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/GlobalFetch" title="The GlobalFetch mixin of the Fetch API contains the GlobalFetch.fetch() method used to start the process of fetching a resource."><code>GlobalFetch</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>H</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HMDVRDevice" title="The HMDVRDevice interface of the WebVR API represents a head mounted display, providing access to information about each eye, and allowing us to modify the current field of view."><code>HMDVRDevice</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLAnchorElement" title="The HTMLAnchorElement interface represents hyperlink elements and provides special properties and methods (beyond those of the regular HTMLElement object interface that they inherit from) for manipulating the layout and presentation of such elements."><code>HTMLAnchorElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLAreaElement" title="The HTMLAreaElement interface provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of area elements."><code>HTMLAreaElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLAudioElement" title="The HTMLAudioElement interface provides access to the properties of <audio> elements, as well as methods to manipulate them. It derives from the HTMLMediaElement interface."><code>HTMLAudioElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLBRElement" title="The HTMLBRElement interface represents a HTML line break element (<br>). It inherits from HTMLElement."><code>HTMLBRElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLBaseElement" title="The HTMLBaseElement interface contains the base URI for a document. This object inherits all of the properties and methods as described in the HTMLElement interface."><code>HTMLBaseElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLBaseFontElement" title="The HTMLBaseFontElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <basefont> elements."><code>HTMLBaseFontElement</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLBodyElement" title="The HTMLBodyElement interface provides special properties (beyond those of the regular HTMLElement interface they also inherit) for manipulating body elements."><code>HTMLBodyElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLButtonElement" title="The HTMLButtonElement interface provides properties and methods (beyond the <button> object interface it also has available to them by inheritance) for manipulating the layout and presentation of button elements."><code>HTMLButtonElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLCanvasElement" title="The HTMLCanvasElement interface provides properties and methods for manipulating the layout and presentation of canvas elements. The HTMLCanvasElement interface also inherits the properties and methods of the HTMLElement interface."><code>HTMLCanvasElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLCollection" title="The HTMLCollection interface represents a generic collection (array-like object similar to arguments) of elements (in document order) and offers methods and properties for selecting from the list."><code>HTMLCollection</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLContentElement" title="The HTMLContentElement interface represents a <content> HTML Element, which is used in Shadow DOM."><code>HTMLContentElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDListElement" title="The HTMLDListElement interface provides special properties (beyond those of the regular HTMLElement interface it also has available to it by inheritance) for manipulating definition list elements."><code>HTMLDListElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDataElement" title="The HTMLDataElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <data> elements."><code>HTMLDataElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDataListElement" title="The HTMLDataListElement interface provides special properties (beyond the HTMLElement object interface it also has available to it by inheritance) to manipulate <datalist> elements and their content."><code>HTMLDataListElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDialogElement" title="The HTMLDialogElement interface provides methods to manipulate <dialog> elements. It inherits properties and methods from the HTMLElement interface."><code>HTMLDialogElement</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDivElement" title="The HTMLDivElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating div elements."><code>HTMLDivElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLDocument" title="HTMLDocument is an abstract interface of the DOM which provides access to special properties and methods not present by default on a regular (XML) document."><code>HTMLDocument</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLElement" title="The HTMLElement interface represents any HTML element. Some elements directly implement this interface, others implement it via an interface that inherits it."><code>HTMLElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLEmbedElement" title="The HTMLEmbedElement interface, which provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <embed> elements."><code>HTMLEmbedElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLFieldSetElement" title="The HTMLFieldSetElement interface has special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of field-set elements."><code>HTMLFieldSetElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLFontElement" title="Implements the document object model (DOM) representation of the font element. The HTML Font Element <font> defines the font size, font face and color of text."><code>HTMLFontElement</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLFormControlsCollection" title="The HTMLFormControlsCollection interface represents a collection of HTML form control elements. It replaces one method of HTMLCollection."><code>HTMLFormControlsCollection</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLFormElement" title="The HTMLFormElement interface provides methods to create and modify <form> elements."><code>HTMLFormElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLFrameSetElement" title="The HTMLFrameSetElement interface provides special properties (beyond those of the regular HTMLElement interface they also inherit) for manipulating <frameset> elements."><code>HTMLFrameSetElement</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLHRElement" title="The HTMLHRElement interface provides special properties (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating <hr> elements."><code>HTMLHRElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLHeadElement" title="The HTMLHeadElement interface contains the descriptive information, or metadata, for a document. This object inherits all of the properties and methods described in the HTMLElement interface."><code>HTMLHeadElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLHeadingElement" title="The HTMLHeadingElement interface represents the different heading elements. It inherits methods and properties from the HTMLElement interface."><code>HTMLHeadingElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLHtmlElement" title="The HTMLHtmlElement interface serves as the root node for a given HTML document. This object inherits the properties and methods described in the HTMLElement interface."><code>HTMLHtmlElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLHyperlinkElementUtils" title="The HTMLHyperlinkElementUtils mixin defines utility methods and properties to work with HTMLAnchorElement and HTMLAreaElement. These utilities allow to deal with common features like URLs."><code>HTMLHyperlinkElementUtils</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLIFrameElement" title="The HTMLIFrameElement interface provides special properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements."><code>HTMLIFrameElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLImageElement" title="The HTMLImageElement interface provides special properties and methods for manipulating the layout and presentation of <img> elements."><code>HTMLImageElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLInputElement" title="The HTMLInputElement interface provides special properties and methods for manipulating the layout and presentation of input elements."><code>HTMLInputElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLIsIndexElement" title="The HTMLIsIndexElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <isindex> elements."><code>HTMLIsIndexElement</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLKeygenElement" title="Technical review completed."><code>HTMLKeygenElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLLIElement" title="The HTMLLIElement interface exposes specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating list elements."><code>HTMLLIElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLLabelElement" title="The HTMLLabelElement interface gives access to properties specific to <label> elements. It inherits methods and properties from the base HTMLElement interface."><code>HTMLLabelElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLLegendElement" title="The HTMLLegendElement is an interface allowing to access properties of the <legend> elements. It inherits properties and methods from the HTMLElement interface."><code>HTMLLegendElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLLinkElement" title="The HTMLLinkElement interface represents reference information for external resources and the relationship of those resources to a document and vice-versa. This object inherits all of the properties and methods of the HTMLElement interface."><code>HTMLLinkElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLMapElement" title="The HTMLMapElement interface provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of map elements."><code>HTMLMapElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLMediaElement" title="The HTMLMediaElement interface adds to HTMLElement the properties and methods needed to support basic media-related capabilities that are common to audio and video."><code>HTMLMediaElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLMetaElement" title="The HTMLMetaElement interface contains descriptive metadata about a document. It inherits all of the properties and methods described in the HTMLElement interface."><code>HTMLMetaElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLMeterElement" title="The HTML <meter> elements expose the HTMLMeterElement interface, which provides special properties and methods (beyond the HTMLElement object interface they also have available to them by inheritance) for manipulating the layout and presentation of <meter> elements."><code>HTMLMeterElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLModElement" title="The HTMLModElement interface provides special properties (beyond the regular methods and properties available through the HTMLElement interface they also have available to them by inheritance) for manipulating modification elements, that is <del> and <ins>."><code>HTMLModElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLOListElement" title="The HTMLOListElement interface provides special properties (beyond those defined on the regular HTMLElement interface it also has available to it by inheritance) for manipulating ordered list elements."><code>HTMLOListElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLObjectElement" title="The HTMLObjectElement interface provides special properties and methods (beyond those on the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of <object> element, representing external resources."><code>HTMLObjectElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLOptGroupElement" title="The HTMLOptGroupElement interface provides special properties and methods (beyond the regular HTMLElement object interface they also have available to them by inheritance) for manipulating the layout and presentation of <optgroup> elements."><code>HTMLOptGroupElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLOptionElement" title="The HTMLOptionElement interface represents <option> elements and inherits all classes and methods of the HTMLElement interface."><code>HTMLOptionElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLOptionsCollection" title='HTMLOptionsCollection is an interface representing a collection of HTML option elements (in document order) and offers methods and properties for traversing the list as well as optionally altering its items. This type is returned solely by the "options" property of select.'><code>HTMLOptionsCollection</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLOutputElement" title="The HTMLOutputElement interface provides properties and methods (beyond those inherited from HTMLElement) for manipulating the layout and presentation of <output> elements."><code>HTMLOutputElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLParagraphElement" title="The HTMLParagraphElement interface provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating <p> elements."><code>HTMLParagraphElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLParamElement" title="The HTMLParamElement interface provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating <param> elements, representing a pair of a key and a value that acts as a parameter for an <object> element."><code>HTMLParamElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLPictureElement" title="The HTMLPictureElement interface represents a <picture> HTML element. It doesn't implement specific properties or methods."><code>HTMLPictureElement</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLPreElement" title="The HTMLPreElement interface expose specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating block of preformatted text."><code>HTMLPreElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLProgressElement" title="The HTMLProgressElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of <progress> elements."><code>HTMLProgressElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLQuoteElement" title="The HTMLQuoteElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like <blockquote> and <q>, but not the <cite> element."><code>HTMLQuoteElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLScriptElement" title="HTML script elements expose the HTMLScriptElement interface, which provides special properties and methods (beyond the regular HTMLElement object interface they also have available to them by inheritance) for manipulating the layout and presentation of <script> elements."><code>HTMLScriptElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLSelectElement" title="The HTMLSelectElement interface represents a <select> HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface."><code>HTMLSelectElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLShadowElement" title="The HTMLShadowElement interface represents a <shadow> HTML Element, which is used in Shadow DOM."><code>HTMLShadowElement</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLSlotElement" title="The HTMLSlotElement interface of the Shadow DOM API enables access to the name and assigned nodes of an HTML <slot> element."><code>HTMLSlotElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLSourceElement" title="The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating <source> elements."><code>HTMLSourceElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLSpanElement" title="The HTMLSpanElement interface represents a <span> element and derives from the HTMLElement interface, but without implementing any additional properties or methods."><code>HTMLSpanElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLStyleElement" title="The HTMLStyleElement interface represents a <style> element. It inherits properties and methods from its parent, HTMLElement, and from LinkStyle."><code>HTMLStyleElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableCaptionElement" title="The HTMLTableCaptionElement interface special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating table caption elements."><code>HTMLTableCaptionElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableCellElement" title="The HTMLTableCellElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of table cells, either header or data cells, in an HTML document."><code>HTMLTableCellElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableColElement" title="The HTMLTableColElement interface provides special properties (beyond the HTMLElement interface it also has available to it inheritance) for manipulating single or grouped table column elements."><code>HTMLTableColElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableDataCellElement" title="The HTMLTableDataCellElement interface provides special properties and methods (beyond the regular HTMLTableCellElement and HTMLElement interfaces it also has available to it by inheritance) for manipulating the layout and presentation of table data cells in an HTML document."><code>HTMLTableDataCellElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableElement" title="The HTMLTableElement interface provides special properties and methods (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating the layout and presentation of tables in an HTML document."><code>HTMLTableElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableHeaderCellElement" title="The HTMLTableHeaderCellElement interface provides special properties and methods (beyond the regular HTMLTableCellElement and HTMLElement interfaces it also has available to it by inheritance) for manipulating the layout and presentation of table header cells in an HTML document."><code>HTMLTableHeaderCellElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableRowElement" title="The HTMLTableRowElement interface provides special properties and methods (beyond the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of rows in an HTML table."><code>HTMLTableRowElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTableSectionElement" title="The HTMLTableSectionElement interface provides special properties and methods (beyond the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of sections, that is headers, footers and bodies, in an HTML table."><code>HTMLTableSectionElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTemplateElement" title="The HTMLTemplateElement interface enables access to the contents of an HTML <template> element."><code>HTMLTemplateElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTextAreaElement" title="The HTMLTextAreaElement interface provides special properties and methods for manipulating the layout and presentation of <textarea> elements."><code>HTMLTextAreaElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTimeElement" title="The HTMLTimeElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <time> elements."><code>HTMLTimeElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTitleElement" title="The HTMLTitleElement interface contains the title for a document. This element inherits all of the properties and methods of the HTMLElement interface."><code>HTMLTitleElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLTrackElement" title="The HTMLTrackElement"><code>HTMLTrackElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLUListElement" title="The HTMLUListElement interface provides special properties (beyond those defined on the regular HTMLElement interface it also has available to it by inheritance) for manipulating unordered list elements."><code>HTMLUListElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLUnknownElement" title="The HTMLUnknownElement interface represents an invalid HTML element and derives from the HTMLElement interface, but without implementing any additional properties or methods."><code>HTMLUnknownElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HTMLVideoElement" title="The HTMLVideoElement interface provides special properties and methods for manipulating video objects. It also inherits properties and methods of HTMLMediaElement and HTMLElement."><code>HTMLVideoElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/HashChangeEvent" title="The hashchange event is fired when the fragment identifier of the URL has changed (the part of the URL that follows the # symbol, including the # symbol)."><code>HashChangeEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Headers" title="The Headers interface of the Fetch API allows you to perform various actions on HTTP request and response headers. These actions include retrieving, setting, adding to, and removing. A Headers object has an associated header list, which is initially empty and consists of zero or more name and value pairs. You can add to this using methods like append() (see Examples.) In all methods of this interface, header names are matched by case-insensitive byte sequence."><code>Headers</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/History" title="Editorial review completed."><code>History</code></a></span></span></li> -</ul> -<span>I</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBCursor" title="The IDBCursor interface of the IndexedDB API represents a cursor for traversing or iterating over multiple records in a database."><code>IDBCursor</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBCursorSync" title="The IDBCursorSync interface of the IndexedDB API represents a cursor for iterating over multiple records in a database. You can have only one instance of IDBCursorSync representing a cursor, but you can have an unlimited number of cursors at the same time. Operations are performed on the underlying index or object store. It enables an application to synchronously process all the records in the cursor's range."><code>IDBCursorSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBCursorWithValue" title=""><code>IDBCursorWithValue</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBDatabase" title="The IDBDatabase interface of the IndexedDB API provides a connection to a database; you can use an IDBDatabase object to open a transaction on your database then create, manipulate, and delete objects (data) in that database. The interface provides the only way to get and manage versions of the database."><code>IDBDatabase</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBDatabaseException" title="In the IndexedDB API, an IDBDatabaseException object represents exception conditions that can be encountered while performing database operations."><code>IDBDatabaseException</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBDatabaseSync" title="The DatabaseSync interface in the IndexedDB API represents a synchronous connection to a database."><code>IDBDatabaseSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBEnvironment" title="The IDBEnvironment helper of the IndexedDB API contains the indexedDB property, which provides access to IndexedDB functionality. It is the top level IndexedDB interface implemented by the window and Worker objects."><code>IDBEnvironment</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBEnvironmentSync" title="The Unimplemented IDBEnvironmentSync interface of the IndexedDB API will be implemented by worker objects."><code>IDBEnvironmentSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBFactory" title="In the following code snippet, we make a request to open a database, and include handlers for the success and error cases. For a full working example, see our To-do Notifications app (view example live.)"><code>IDBFactory</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBFactorySync" title="The IDBFactorySync interface of the IndexedDB API provide a synchronous means of accessing the capabilities of indexed databases."><code>IDBFactorySync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBIndex" title="IDBIndex interface of the IndexedDB API provides asynchronous access to an index in a database. An index is a kind of object store for looking up records in another object store, called the referenced object store. You use this interface to retrieve data."><code>IDBIndex</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBIndexSync" title="The IDBIndexSync interface of the IndexedDB API provides synchronous access to an index in a database."><code>IDBIndexSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBKeyRange" title="A key range can be a single value or a range with upper and lower bounds or endpoints. If the key range has both upper and lower bounds, then it is bounded; if it has no bounds, it is unbounded. A bounded key range can either be open (the endpoints are excluded) or closed (the endpoints are included). To retrieve all keys within a certain range, you can use the following code constructs:"><code>IDBKeyRange</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBLocaleAwareKeyRange" title="The IDBLocaleAwareKeyRange interface of the IndexedDB API is a Firefox-specific version of IDBKeyRange — it functions in exactly the same fashion, and has the same properties and methods, but it is intended for use with IDBIndex objects when the original index had a locale value specified upon its creation (see createIndex()'s optionalParameters) — that is, it has locale aware sorting enabled."><code>IDBLocaleAwareKeyRange</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBMutableFile" title="The IDBMutableFile interface provides access in read or write mode to a file, dealing with all the necessary locks."><code>IDBMutableFile</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBObjectStore" title="This example shows a variety of different uses of object stores, from updating the data structure with IDBObjectStore.createIndex inside an onupgradeneeded function, to adding a new item to our object store with IDBObjectStore.add. For a full working example, see our To-do Notifications app (view example live.)"><code>IDBObjectStore</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBObjectStoreSync" title="The IDBObjectStoreSync interface of the IndexedDB API provides synchronous access to an object store of a database."><code>IDBObjectStoreSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBOpenDBRequest" title="Also inherits methods from its parents IDBRequest and EventTarget."><code>IDBOpenDBRequest</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBRequest" title="The request object does not initially contain any information about the result of the operation, but once information becomes available, an event is fired on the request, and the information becomes available through the properties of the IDBRequest instance."><code>IDBRequest</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBTransaction" title="Note that as of Firefox 40, IndexedDB transactions have relaxed durability guarantees to increase performance (see bug 1112702.) Previously in a readwrite transaction IDBTransaction.oncomplete was fired only when all data was guaranteed to have been flushed to disk. In Firefox 40+ the complete event is fired after the OS has been told to write the data but potentially before that data has actually been flushed to disk. The complete event may thus be delivered quicker than before, however, there exists a small chance that the entire transaction will be lost if the OS crashes or there is a loss of system power before the data is flushed to disk. Since such catastrophic events are rare most consumers should not need to concern themselves further."><code>IDBTransaction</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBTransactionSync" title="The IDBTransactionSync interface of the IndexedDB API provides a synchronous transaction on a database. When an application creates an IDBTransactionSync object, it blocks until the browser is able to reserve the require database objects."><code>IDBTransactionSync</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBVersionChangeEvent" title="The IDBVersionChangeEvent interface of the IndexedDB API indicates that the version of the database has changed, as the result of an IDBOpenDBRequest.onupgradeneeded event handler function."><code>IDBVersionChangeEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IDBVersionChangeRequest" title="The IDBVersionChangeRequest interface the IndexedDB API represents a request to change the version of a database. It is used only by the setVersion() method of IDBDatabase."><code>IDBVersionChangeRequest</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IIRFilterNode" title="The IIRFilterNode interface of the Web Audio API is a AudioNode processor which implements a general infinite impulse response (IIR) filter; this type of filter can be used to implement tone control devices and graphic equalizers as well. It lets the parameters of the filter response be specified, so that it can be tuned as needed."><code>IIRFilterNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IdentityManager" title="The IdentityManager of the BrowserID protocol exposes the BrowserID API, via navigator.id. This API has gone through several significant revisions. Each generation is listed separately below."><code>IdentityManager</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IdleDeadline" title="See our complete example in the article Cooperative Scheduling of Background Tasks API."><code>IdleDeadline</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ImageBitmap" title="The ImageBitmap interface represents a bitmap image which can be drawn to a <canvas> without undue latency. It can be created from a variety of source objects using the createImageBitmap() factory method. ImageBitmap provides an asynchronous and resource efficient pathway to prepare textures for rendering in WebGL."><code>ImageBitmap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ImageBitmapFactories" title="The ImageBitmapFactories mixin interface contains utility methods to create an ImageBitmap. There is no object of this type, but the two interfaces Window, available within the regular browsing scope, and the WorkerGlobalScope interface for workers, implement this interface."><code>ImageBitmapFactories</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ImageBitmapRenderingContext" title="The ImageBitmapRenderingContext interface is a canvas rendering context which only provides the functionality to replace the canvas's contents with the given ImageBitmap. Its context id (the first argument to HTMLCanvasElement.getContext() or OffscreenCanvas.getContext() is "bitmaprenderer"."><code>ImageBitmapRenderingContext</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ImageCapture" title="The ImageCapture interface of the the MediaStream Image Capture API provides is an interface for capturing images from a photographic device referenced through a valid MediaStreamTrack."><code>ImageCapture</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ImageData" title="The ImageData interface represents the underlying pixel data of an area of a <canvas> element. It is created using the ImageData() constructor or creator methods on the CanvasRenderingContext2D object associated with a canvas: createImageData() and getImageData(). It can also be used to set a part of the canvas by using putImageData()."><code>ImageData</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Index" title="Found 3782 pages:"><code>Index</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/InputDeviceCapabilities" title="The InputDeviceCapabilities interface of the Input Device Capabilities API provides information about the physical device or a group of related devices responsible for generating input events. Events caused by the same physical input device get the same instance of this object, but the converse isn't true. For example, two mice with the same capabilities in a system may appear as a single InputDeviceCapabilities instance."><code>InputDeviceCapabilities</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/InputEvent" title="The InputEvent interface represents an event notifying of editable content change."><code>InputEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/FetchEvent_clone" title="The InstallEvent interface represents an install action that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker. As a child of ExtendableEvent it ensures that functional events (like FetchEvent) are not dispatched during installation."><code>InstallEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/InstallEvent" title="The parameter passed into the oninstall handler, the InstallEvent interface represents an install action that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker. As a child of ExtendableEvent, it ensures that functional events such as FetchEvent are not dispatched during installation. "><code>InstallEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/InstallTrigger" title="The InstallTrigger interface is an interesting outlier in the Apps API; it's included in this API but are inherited from the old Mozilla XPInstall technology for installing add-ons. It is used for triggering the download and installation of an add-on (or anything packaged in an .xpi file) from a Web page, using JavaScript code to kick off the install process."><code>InstallTrigger</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IntersectionObserver" title="The IntersectionObserver interface of the Intersection Observer API provides a way to asynchronously observe changes in the intersection of a target element with an ancestor element or with a top-level document's viewport."><code>IntersectionObserver</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/IntersectionObserverEntry" title="The IntersectionObserverEntry interface of the Intersection Observer API describes the intersection between the target element and its root container at a specific moment of transition."><code>IntersectionObserverEntry</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> - - -<span>K</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/KeyboardEvent" title="KeyboardEvent objects describe a user interaction with the keyboard. Each event describes a key; the event type (keydown, keypress, or keyup) identifies what kind of activity was performed."><code>KeyboardEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/KeyframeEffect" title="The KeyframeEffect interface of the Web Animations API lets us create sets of animatable properties and values, called keyframes. These can then be played using the Animation() constructor."><code>KeyframeEffect</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/KeyframeEffectReadOnly" title="The KeyframeEffectReadOnly interface of the Web Animations API describes sets of animatable properties and values that can be played using the Animation.Animation() constructor, and which are inherited by KeyframeEffect."><code>KeyframeEffectReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>L</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.formatValue" title="formatValue is used to retrieve translations from the localization resources, optionally interpolating them with additional variable data. If the translation is not found in the first supported locale, the L10n context will try the next locale in the fallback chain (asynchronously) until it finds an available translation. "><code>L10n.formatValue</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.get" title="The get method is used to retrieve translations from the localization resources, optionally interpolating them with additional variable data. If the translation is not found in the first supported locale, the L10n context will try the next locale in the fallback chain (synchronously!) until it finds an available translation."><code>L10n.get</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.language.code" title="The language.code property returns the code of the currently active language and allows to change the language by setting the value to a new code."><code>L10n.language.code</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.language.direction" title="The language.direction property returns the direction (ltr or rtl) of the currently active language."><code>L10n.language.direction</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.once" title="The once method is used to register a callback that will execute exactly once. If the L10n context is ready when L10n.once() is called, the callback will be invoked immediately on the next tick of the event loop. If the L10n context is not ready when L10n.once() is called (because the localization resources are still downloading), the callback will be invoked when the ready event of the L10n context fires."><code>L10n.once</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.ready" title="The ready method is used to register a callback that will execute at least once. The callback is registered as a listener to the ready event of the L10n context. Additionally, if the L10n context is ready when L10n.ready() is called, the callback will be invoked immediately on the next tick of the event loop."><code>L10n.ready</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.readyState" title="The readyState property returns either loading or complete — depending on the current state of the L10n context."><code>L10n.readyState</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/L10n.setAttributes" title="The setAttributes method may be used to set the data-l10n-id and data-l10n-args attributes on DOM elements."><code>L10n.setAttributes</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LinkStyle" title="The LinkStyle interface allows to access the associated CSS style sheet of a node."><code>LinkStyle</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LocalFileSystem" title="The LocalFileSystem interface of the File System API gives you access to a sandboxed file system. The methods are implemented by window and worker objects."><code>LocalFileSystem</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LocalFileSystemSync" title="The LocalFileSystemSync interface of the File System API gives you access to a sandboxed file system. It is intended to be used with WebWorkers. The methods are implemented by worker objects."><code>LocalFileSystemSync</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LocalMediaStream" title="The LocalMediaStream interface was part of the Media Capture and Streams API, representing a stream of data being generated locally (such as by getUserMedia(). However, getUserMedia() now returns a MediaStream instead, and this interface has been removed from the specification."><code>LocalMediaStream</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Location" title="The Location interface represents the location (URL) of the object it is linked to. Changes done on it are reflected on the object it relates to. Both the Document and Window interface have such a linked Location, accessible via Document.location and Window.location respectively."><code>Location</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LockedFile" title="The LockedFile interface provides tools to deal with a given file with all the necessary locks."><code>LockedFile</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/LongRange" title="The LongRange dictionary is used to define a range of permitted integer values for a property, with either or both a maximum and minimum value specified. The ConstrainLongRange dictionary is based on this, augmenting it to support exact and ideal values as well."><code>LongRange</code></a></span></span></li> -</ul> -<span>M</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MIDIAccess" title="The MIDIAccess interface of the Web MIDI API provides methods for listing MIDI input and output devices, and obtaining access to those devices."><code>MIDIAccess</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MIDIConnectionEvent" title="The MIDIConnectionEvent interface of the Web MIDI API is the event passed to the onstatechange event of the MIDIAccess interface and the onstatechange event of the MIDIPorts interface. This occurs any time a new port becomes available, or when a previously available port becomes unavailable. For example, this event is fired whenever a MIDI device is either plugged in to or unplugged from a computer."><code>MIDIConnectionEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MIDIInput" title="Use the MIDIInput interface of the Web MIDI API to access and pass messages to a MIDI input port."><code>MIDIInput</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MIDIInputMap" title="The MIDIInputMap read-only interface of the Web MIDI API provides a Map-like interface to the currently available MIDI input ports. Though it works generally like a map, because it is read-only it does not contain clear(), delete(), or set() functions."><code>MIDIInputMap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MIDIOutputMap" title="The MIDIOutputMap read-only interface of the Web MIDI API provides a Map-like interface to the currently available MIDI output ports. Although it works like a map, because it is read-only, it does not contain clear(), delete(), or set() functions."><code>MIDIOutputMap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MSGestureEvent" title="The MSGestureEvent is a proprietary interface specific to Internet Explorer and Microsoft Edge which represents events that occur due to touch gestures. Events using this interface include MSGestureStart, MSGestureEnd, MSGestureTap, MSGestureHold, MSGestureChange, and MSInertiaStart."><code>MSGestureEvent</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaDeviceInfo" title="The MediaDevicesInfo interface contains information on the available media input and output devices."><code>MediaDeviceInfo</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaDevices" title="The MediaDevices interface provides access to connected media input devices like cameras and microphones, as well as screen sharing. In essence, it lets you obtain access to any hardware source of media data."><code>MediaDevices</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaElementAudioSourceNode" title="A MediaElementSourceNode has no inputs and exactly one output, and is created using the AudioContext.createMediaElementSource method. The amount of channels in the output equals the number of channels of the audio referenced by the HTMLMediaElement used in the creation of the node, or is 1 if the HTMLMediaElement has no audio."><code>MediaElementAudioSourceNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaError" title="The MediaError interface represents an error which occurred while handling media in an HTML media element based on HTMLMediaElement, such as <audio> or <video>."><code>MediaError</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeyMessageEvent" title="The MediaKeyMessageEvent interface of the EncryptedMediaExtensions API contains the content and related data when the content decryption module generates a message for the session."><code>MediaKeyMessageEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeySession" title="The MediaKeySession interface of the EncryptedMediaExtensions API represents a context for message exchange with a content decryption module (CDM)."><code>MediaKeySession</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeyStatusMap" title="The MediaKeyStatusMap interface of the EncryptedMediaExtensions API is a read-only map of media key statuses by key IDs."><code>MediaKeyStatusMap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeySystemAccess" title="The MediaKeySystemAccess interface of the EncryptedMediaExtensions API provides access to a Key System for decryption and/or a content protection provider. You can request an instance of this object using the Navigator.requestMediaKeySystemAccess method."><code>MediaKeySystemAccess</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeySystemConfiguration" title="The MediaKeySystemConfiguration interface Encrypted Media Extensions API provides configuration information about the media key system."><code>MediaKeySystemConfiguration</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaKeys" title="The MediaKeys interface of EncryptedMediaExtensions API the represents a set of keys that an associated HTMLMediaElement can use for decryption of media data during playback."><code>MediaKeys</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaMetadata" title="The MediaMetadata interface of the the Media Session API provides allows a web page to provide rich media metadata for display in a platform UI."><code>MediaMetadata</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaQueryList" title="A MediaQueryList object stores information on a media query applied to a document, and handles sending notifications to listeners when the media query state change (i.e. when the media query test starts or stops evaluating to true)."><code>MediaQueryList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaQueryListEvent" title="The MediaQueryListEvent object stores information on the changes that have happened to a MediaQueryList object — instances are available as the event object on a function referenced by a MediaQueryList.onchange property or MediaQueryList.addEvent() call."><code>MediaQueryListEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaQueryListListener" title="A MediaQueryList object maintains a list of media queries on a document, and handles sending notifications to listeners when the media queries on the document change."><code>MediaQueryListListener</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaRecorder" title="The MediaRecorder interface of the MediaStream Recording API provides functionality to easily record media. It is created by the invocation of the MediaRecorder() constructor."><code>MediaRecorder</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaRecorderErrorEvent" title="The MediaRecorderErrorEvent interface represents errors returned by the MediaStream Recording API. It is an Event object that encapsulates a reference to a DOMException describing the error that occurred."><code>MediaRecorderErrorEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaSession" title="The MediaSession interface of the the Media Session API allows a web page to provide custom behaviors for standard media playback interactions."><code>MediaSession</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaSettingsRange" title="The MediaSettingsRange interface of the the MediaStream Image Capture API provides the possible range and value size of PhotoCapabilities.imageHeight and PhotoCapabilities.imageWidth. A PhotoCapabilities object can be retrieved by calling ImageCapture.PhotoCapabilities()."><code>MediaSettingsRange</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaSource" title="The MediaSource interface of the Media Source Extensions API represents a source of media data for an HTMLMediaElement object. A MediaSource object can be attached to a HTMLMediaElement to be played in the user agent."><code>MediaSource</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStream" title="The MediaStream interface represents a stream of media content. A stream consists of several tracks such as video or audio tracks. Each track is specified as an instance of MediaStreamTrack."><code>MediaStream</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamAudioDestinationNode" title="Inherits properties from its parent, AudioNode."><code>MediaStreamAudioDestinationNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamAudioSourceNode" title="A MediaElementSourceNode has no inputs and exactly one output, and is created using the AudioContext.createMediaStreamSource method. The number of channels in the output equals the number of channels in AudioMediaStreamTrack. If there is no valid media stream, then the number of output channels will be one silent channel."><code>MediaStreamAudioSourceNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamConstraints" title="The MediaStreamConstraints dictionary is used when calling getUserMedia() to specify what kinds of tracks should be included in the returned MediaStream, and, optionally, to establish constraints for those tracks' settings."><code>MediaStreamConstraints</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamEvent" title="The MediaStreamEvent interface represents events that occurs in relation to a MediaStream. Two events of this type can be thrown: addstream and removestream."><code>MediaStreamEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamTrack" title="The MediaStreamTrack interface represents a single media track within a stream; typically, these are audio or video tracks, but other track types may exist as well."><code>MediaStreamTrack</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaStreamTrackEvent" title="The MediaStreamTrackEvent interface represents events which indicate that a MediaStream has had tracks added to or removed from the stream through calls to Media Stream API methods. These events are sent to the stream when these changes occur."><code>MediaStreamTrackEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaTrackConstraints" title="The MediaTrackConstraints dictionary is used to describe a set of capabilities and the value or values each can take on. A constraints dictionary is passed into applyConstraints() to allow a script to establish a set of exact (required) values or ranges and/or preferred values or ranges of values for the track, and the most recently-requested set of custom constraints can be retrieved by calling getConstraints()."><code>MediaTrackConstraints</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaTrackSettings" title="The MediaTrackSettings dictionary is used to return the current values configured for each of a MediaStreamTrack's settings. These values will adhere as closely as possible to any constraints previously described using a MediaTrackConstraints object and set using applyConstraints(), and will adhere to the default constraints for any properties whose constraints haven't been changed, or whose customized constraints couldn't be matched."><code>MediaTrackSettings</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MediaTrackSupportedConstraints" title="The MediaTrackSupportedConstraints dictionary establishes the list of constrainable properties recognized by the user agent or browser in its implementation of the MediaStreamTrack object. An object conforming to MediaTrackSupportedConstraints is returned by MediaDevices.getSupportedConstraints()."><code>MediaTrackSupportedConstraints</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MessageChannel" title="The MessageChannel interface of the Channel Messaging API allows us to create a new message channel and send data through it via its two MessagePort properties."><code>MessageChannel</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MessageEvent" title="The MessageEvent interface represents a message received by a target object."><code>MessageEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MessagePort" title="The MessagePort interface of the Channel Messaging API represents one of the two ports of a MessageChannel, allowing sending of messages from one port and listening out for them arriving at the other."><code>MessagePort</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Metadata" title="The Metadata interface is used by the File and Directory Entries API to contain information about a file system entry. This metadata includes the file's size and modification date and time."><code>Metadata</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MimeType" title="The MimeType interface provides contains information about a MIME type associated with a particular plugin. NavigatorPlugins.mimeTypes returns an array of this object."><code>MimeType</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MimeTypeArray" title="The MimeTypeArray interface returns an array of MimeType instances, each of which contains information about a supported browser plugins. This object is returned by NavigatorPlugins.mimeTypes."><code>MimeTypeArray</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MouseEvent" title="The MouseEvent interface represents events that occur due to the user interacting with a pointing device (such as a mouse). Common events using this interface include click, dblclick, mouseup, mousedown."><code>MouseEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MouseScrollEvent" title="The MouseScrollEvent interface represents events that occur due to the user moving a mouse wheel or similar input device."><code>MouseScrollEvent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MouseWheelEvent" title="The MouseWheelEvent interface represents events that occur due to the user turning a mouse wheel."><code>MouseWheelEvent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MutationEvent" title="Provides event properties that are specific to modifications to the Document Object Model (DOM) hierarchy and nodes."><code>MutationEvent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MutationObserver" title="MutationObserver provides developers with a way to react to changes in a DOM. It is designed as a replacement for Mutation Events defined in the DOM3 Events specification."><code>MutationObserver</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/MutationRecord" title="A MutationRecord represents an individual DOM mutation. It is the object that is passed to MutationObserver's callback."><code>MutationRecord</code></a></span></span></li> -</ul> -<span>N</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NameList" title="Provides an abstraction for an ordered collection of name and namespace value pairs. Items can be accessed by a 0-based index. The DOM spec does not specify how the collection is to be implemented."><code>NameList</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NamedNodeMap" title="The NamedNodeMap interface represents a collection of Attr objects. Objects inside a NamedNodeMap are not in any particular order, unlike NodeList, although they may be accessed by an index as in an array."><code>NamedNodeMap</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigationPreloadManager" title="The NavigationPreloadManager interface of the the Service Worker API provides methods for managing the preloading of resources with a service worker."><code>NavigationPreloadManager</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Navigator" title="The Navigator interface represents the state and the identity of the user agent. It allows scripts to query it and to register themselves to carry on some activities."><code>Navigator</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorConcurrentHardware" title="The NavigatorConcurrentHardware mixin adds to the Navigator interface features which allow Web content to determine how many logical processors the user has available, in order to let content and Web apps optimize their operations to best take advantage of the user's CPU."><code>NavigatorConcurrentHardware</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorGeolocation" title="NavigatorGeolocation contains a creation method allowing objects implementing it to obtain a Geolocation instance."><code>NavigatorGeolocation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorID" title="The NavigatorID interface contains methods and properties related to the identity of the browser."><code>NavigatorID</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorLanguage" title="NavigatorLanguage contains methods and properties related to the language of the navigator."><code>NavigatorLanguage</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorOnLine" title="The NavigatorOnLine interface contains methods and properties related to the connectivity status of the browser."><code>NavigatorOnLine</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorPlugins" title="The NavigatorPlugins mixin adds to the Navigator interface methods and properties for discovering and interacting with plugins installed into the browser."><code>NavigatorPlugins</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NavigatorStorage" title="The NavigatorStorage mixin adds to the Navigator and WorkerNavigator interfaces the Navigator.storage property, which provides access to the StorageManager singleton used for controlling the persistence of data stores as well as obtaining information"><code>NavigatorStorage</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NetworkInformation" title="The NetworkInformation interface provides information about the connection a device is using to communicate with the network and provides a means for scripts to be notified if the connection type changes. The NetworkInformation interfaces cannot be instantiated. It is instead accessed through the connection property of the Navigator interface."><code>NetworkInformation</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Node" title="Node is an interface from which a number of DOM API object types inherit; it allows these various types to be treated similarly, for example inheriting the same set of methods, or being tested in the same way."><code>Node</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NodeFilter" title="A NodeFilter interface represents an object used to filter the nodes in a NodeIterator or TreeWalker. They don't know anything about the DOM or how to traverse nodes; they just know how to evaluate a single node against the provided filter."><code>NodeFilter</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NodeIterator" title="The NodeIterator interface represents an iterator over the members of a list of the nodes in a subtree of the DOM. The nodes will be returned in document order."><code>NodeIterator</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NodeList" title="NodeList objects are collections of nodes such as those returned by properties such as Node.childNodes and the document.querySelectorAll() method."><code>NodeList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NonDocumentTypeChildNode" title="The NonDocumentTypeChildNode interface contains methods that are particular to Node objects that can have a parent, but not suitable for DocumentType."><code>NonDocumentTypeChildNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Notation" title="Represents a DTD notation (read-only). May declare format of an unparsed entity or formally declare the document's processing instruction targets. Inherits methods and properties from Node. Its nodeName is the notation name. Has no parent."><code>Notation</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/notification" title="The Notification interface of the Notifications API is used to configure and display desktop notifications to the user."><code>Notification</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NotificationEvent" title="The parameter passed into the onnotificationclick handler, the NotificationEvent interface represents a notification click event that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker."><code>NotificationEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/NotifyAudioAvailableEvent" title=""><code>NotifyAudioAvailableEvent</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -</ul> -<span>O</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_element_index_uint" title="The OES_element_index_uint extension is part of the WebGL API and adds support for gl.UNSIGNED_INT types to WebGLRenderingContext.drawElements()."><code>OES_element_index_uint</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_standard_derivatives" title="The OES_standard_derivatives extension is part of the WebGL API and adds the GLSL derivative functions dFdx, dFdy, and fwidth."><code>OES_standard_derivatives</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_texture_float" title="The OES_texture_float extension is part of the WebGL API and exposes floating-point pixel types for textures."><code>OES_texture_float</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_texture_float_linear" title="The OES_texture_float_linear extension is part of the WebGL API and allows linear filtering with floating-point pixel types for textures."><code>OES_texture_float_linear</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_texture_half_float" title="The OES_texture_half_float extension is part of the WebGL API and adds texture formats with 16- (aka half float) and 32-bit floating-point components."><code>OES_texture_half_float</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_texture_half_float_linear" title="The OES_texture_half_float_linear extension is part of the WebGL API and allows linear filtering with half floating-point pixel types for textures."><code>OES_texture_half_float_linear</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OES_vertex_array_object" title="The OES_vertex_array_object extension is part of the WebGL API and provides vertex array objects (VAOs) which encapsulate vertex array states. These objects keep pointers to vertex data and provide names for different sets of vertex data."><code>OES_vertex_array_object</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OfflineAudioCompletionEvent" title="The Web Audio API OfflineAudioCompletionEvent interface represents events that occur when the processing of an OfflineAudioContext is terminated. The complete event implements this interface."><code>OfflineAudioCompletionEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OfflineAudioContext" title="The OfflineAudioContext interface is an AudioContext interface representing an audio-processing graph built from linked together AudioNodes. In contrast with a standard AudioContext, an OfflineAudioContext doesn't render the audio to the device hardware; instead, it generates it, as fast as it can, and outputs the result to an AudioBuffer."><code>OfflineAudioContext</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OffscreenCanvas" title="The OffscreenCanvas interface provides a canvas that can be rendered off screen. It is available in both the window and worker contexts."><code>OffscreenCanvas</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/OscillatorNode" title="The OscillatorNode interface represents a periodic waveform, such as a sine wave. It is an AudioScheduledSourceNode audio-processing module that causes a specified frequency of a given wave to be created—in effect, a constant tone."><code>OscillatorNode</code></a></span></span></li> -</ul> -<span>P</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PageTransitionEvent" title="Page transition events fire when a webpage is being loaded or unloaded."><code>PageTransitionEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PannerNode" title="A PannerNode always has exactly one input and one output: the input can be mono or stereo but the output is always stereo (2 channels); you can't have panning effects without at least two audio channels!"><code>PannerNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ParentNode" title="The ParentNode mixin contains methods and properties that are common to all types of Node objects that can have children. It's implemented by Element, Document, and DocumentFragment objects."><code>ParentNode</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PasswordCredential" title="The interface of the Credential Management API provides information about a username/password pair. In supporting browsers an instance of this class may be passed in the credential member of the init object for global fetch."><code>PasswordCredential</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Path2D" title="The Path2D interface of the Canvas 2D API is used to declare paths that are then later used on CanvasRenderingContext2D objects. The path methods of the CanvasRenderingContext2D interface are present on this interface as well and are allowing you to create paths that you can retain and replay as required on a canvas."><code>Path2D</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PaymentAddress" title="The PaymentAddress interface of the Payment Request API stores address information."><code>PaymentAddress</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PaymentRequest" title="The PaymentRequest interface of the Payment Request API manages the process of a user making a payment."><code>PaymentRequest</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PaymentRequestUpdateEvent" title="The PaymentRequestUpdateEvent interface of the the Payment Request API enables a web page to update the details of a PaymentRequest in response to a user action."><code>PaymentRequestUpdateEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PaymentResponse" title="The PaymentResponse interface of the Payment Request API is returned after a user selects a payment method and approves a payment request."><code>PaymentResponse</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Performance" title="The Performance interface provides access to performance-related information for the current page. It's part of the High Resolution Time API, but is enhanced by the Performance Timeline API, the Navigation Timing API, the User Timing API, and the Resource Timing API."><code>Performance</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceEntry" title="The PerformanceEntry object encapsulates a single performance metric that is part of the performance timeline. A performance entry can be directly created by making a performance mark or measure (for example by calling the mark() method) at an explicit point in an application. Performance entries are also created in indirect ways such as loading a resource (such as an image). This interface is exposed to Window and Worker."><code>PerformanceEntry</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceFrameTiming" title="PerformanceFrameTiming is an abstract interface that provides frame timing data about the browser's event loop."><code>PerformanceFrameTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceLongTaskTiming" title="The PerformanceLongTaskTiming interface of the the Long Tasks API reports instances of long tasks."><code>PerformanceLongTaskTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceMark" title="PerformanceMark is an abstract interface for PerformanceEntry objects with an entryType of "mark". Entries of this type are created by calling performance.mark() to add a named DOMHighResTimeStamp (the mark) to the browser's performance timeline."><code>PerformanceMark</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceMeasure" title="PerformanceMeasure is an abstract interface for PerformanceEntry objects with an entryType of "measure". Entries of this type are created by calling performance.measure() to add a named DOMHighResTimeStamp (the measure) between two marks to the browser's performance timeline."><code>PerformanceMeasure</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceNavigation" title="The PerformanceNavigation interface represents information about how the navigation to the current document was done."><code>PerformanceNavigation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceNavigationTiming" title="The PerformanceNavigationTiming interface provides methods and properties to store and retrieve metrics regarding the browser's document navigation events. For example, this interface can be used to determine how much time it takes to load or unload a document."><code>PerformanceNavigationTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceObserver" title="The PerformanceObserver interface is used to observe performance measurement events and be notified of new performance entries as they are recorded in the browser's performance timeline."><code>PerformanceObserver</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceObserverEntryList" title="The PerformanceObserverEntryList interface is a list of peformance events that were explicitly observed via the observe() method."><code>PerformanceObserverEntryList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformancePaintTiming" title='The PerformancePaintTiming interface of the Paint Timing provides provides timing information about "paint" (also called "render") operations during web page construction. "Paint" refers to conversion of the render tree to on-screen pixels.'><code>PerformancePaintTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceResourceTiming" title="The PerformanceResourceTiming interface enables retrieving and analyzing detailed network timing data regarding the loading of an application's resources. An application can use the timing metrics to determine, for example, the length of time it takes to fetch a specific resource, such as an XMLHttpRequest, <SVG>, image, or script."><code>PerformanceResourceTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PerformanceTiming" title="The PerformanceTiming interface contains properties that offer performance timing information for various events which occur during the loading and use of the current page. You get a PerformanceTiming object describing your page using the window.performance.timing property."><code>PerformanceTiming</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PeriodicWave" title="PeriodicWave has no inputs or outputs; it is used to define custom oscillators when calling OscillatorNode.setPeriodicWave(). The PeriodicWave itself is created/returned by AudioContext.createPeriodicWave()."><code>PeriodicWave</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PermissionStatus" title="The PermissionStatus interface of the Permissions API provides the state of an object and an event handler for monitoring changes to said state."><code>PermissionStatus</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Permissions" title=""><code>Permissions</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PhotoCapabilities" title="The PhotoCapabilities interface of the the MediaStream Image Capture API provides available configuration options for an attached photographic device. A PhotoCapabilities object is retrieved by calling ImageCapture.getPhotoCapabilities()."><code>PhotoCapabilities</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Plugin" title="The Plugin interface provides information about a browser plugin."><code>Plugin</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PluginArray" title="The PluginArray interface is used to store a list of Plugin objects describing the available plugins; it's returned by the window.navigator.plugins property. The PluginArray is not a JavaScript array, but has the length property and supports accessing individual items using bracket notation (plugins[2]), as well as via item(index) and namedItem("name") methods."><code>PluginArray</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Point" title="Point is an interface, which existed only briefly in the CSS Transforms Level 1 specification, which represents a point in 2-dimensional space. It is non-standard, not broadly compatible, and should not be used."><code>Point</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PointerEvent" title="The PointerEvent interface represents the state of a DOM event produced by a pointer such as the geometry of the contact point, the device type that generated the event, the amount of pressure that was applied on the contact surface, etc."><code>PointerEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PopStateEvent" title="An event handler for the popstate event on the window."><code>PopStateEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PortCollection" title=""><code>PortCollection</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Position" title="The Position interface represents the position of the concerned device at a given time. The position, represented by a Coordinates object, comprehends the 2D position of the device, on a spheroid representing the Earth, but also its altitude and its speed."><code>Position</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PositionError" title="The PositionError interface represents the reason of an error occurring when using the geolocating device."><code>PositionError</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PositionOptions" title="The PositionOptions interface describes an object containing option properties to pass as a parameter of Geolocation.getCurrentPosition() and Geolocation.watchPosition()."><code>PositionOptions</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PositionSensorVRDevice" title="The PositionSensorVRDevice interface of the WebVR API represents VR hardware's position sensor. You can access information such as the current position and orientation of the sensor in relation to the head mounted display through the PositionSensorVRDevice.getState() method."><code>PositionSensorVRDevice</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Presentation" title="The Presentation can be defined as two possible user agents in the context: Controlling user agent and Receiving user agent."><code>Presentation</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationAvailability" title="A PresentationAvailability object is associated with available presentation displays and represents the presentation display availability for a presentation request. If the controlling user agent can monitor the list of available presentation displays in the background (without a pending request to start()), the PresentationAvailability object MUST be implemented in a controlling browsing context."><code>PresentationAvailability</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationConnection" title="The PresentationConnection interface of the Presentation API provides methods and properties for managing a single presentation. Each presentation connection is represented by a PresentationConnection object. Both the controlling user agent and receiving user agent MUST implement PresentationConnection."><code>PresentationConnection</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationConnectionAvailableEvent" title="The PresentationConnectionAvailableEvent interface of the Presentation API is fired on a PresentationRequest when a connection associated with the object is created."><code>PresentationConnectionAvailableEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationConnectionCloseEvent" title="The PresentationConnectionCloseEvent interface of the Presentation API is fired on a PresentationConnection when it is closed."><code>PresentationConnectionCloseEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationConnectionClosedEvent" title="A PresentationConnectionClosedEvent is declared when a presentation connection enters a closed state. The reason attribute provides the reason why the connection was closed."><code>PresentationConnectionClosedEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationConnectionList" title="PresentationConnectionList is the collection of incoming presentation connections."><code>PresentationConnectionList</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationReceiver" title="The PresentationReceiver interface of the the Presentation API provides a means for a receiving browsing context to access controlling browsing contexts and communicate with them."><code>PresentationReceiver</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PresentationRequest" title="A PresentationRequest object is used to initiate or reconnect to a presentation made by a controlling browsing context. The PresentationRequest object MUST be implemented in a controlling browsing context provided by a controlling user agent."><code>PresentationRequest</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ProcessingInstruction" title="A processing instruction embeds application-specific instructions in XML which can be ignored by other applications that don't recognize them."><code>ProcessingInstruction</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ProgressEvent" title="The ProgressEvent interface represents events measuring progress of an underlying process, like an HTTP request (for an XMLHttpRequest, or the loading of the underlying resource of an <img>, <audio>, <video>, <style> or <link>)."><code>ProgressEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PromiseRejectionEvent" title="The PromiseRejectionEvent interface represents events which are fired when JavaScript Promises are rejected. These events are particularly useful for telemetry and debugging purposes."><code>PromiseRejectionEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PromiseResolver" title="The PromiseResolver interface represents an object controlling the state and the result value of a Promise."><code>PromiseResolver</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PushEvent" title="The PushEvent interface of the Push API represents a push message that has been received. This event is sent to the global scope of a ServiceWorker. It contains the information sent from an application server to a PushSubscription."><code>PushEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PushManager" title="The PushManager interface of the Push API provides a way to receive notifications from third-party servers as well as request URLs for push notifications."><code>PushManager</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PushMessageData" title="The PushMessageData interface of the Push API provides methods which let you retrieve the push data sent by a server in various formats."><code>PushMessageData</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PushRegistrationManager" title="Returns an interface to register or unregister a push registration, get an active registration, or check the permission status of the registration. This interface has been superceded by PushManager."><code>PushRegistrationManager</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/PushSubscription" title="The PushSubscription interface of the Push API provides a subcription's URL endpoint and allows unsubscription from a push service."><code>PushSubscription</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> - - -<span>R</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCCertificate" title="The interface of the the WebRTC API provides an object represents a certificate that an RTCPeerConnection uses to authenticate."><code>RTCCertificate</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCConfiguration" title="The RTCConfiguration dictionary is used to provide configuration options for an RTCPeerConnection. It may be passed into the constructor when instantiating a connection, or used with the RTCPeerConnection.getConfiguration() and RTCPeerConnection.setConfiguration() methods, which allow inspecting and changing the configuration while a connection is established."><code>RTCConfiguration</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCDTMFSender" title="tbd"><code>RTCDTMFSender</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCDTMFToneChangeEvent" title="The RTCDTMFToneChangeEvent interface represents events sent to indicate that DTMF tones have started or finished finished playing. This interface is used by the tonechange event."><code>RTCDTMFToneChangeEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCDataChannel" title="The RTCDataChannel interface represents a network channel which can be used for bidirectional peer-to-peer transfers of arbitrary data. Every data channel is associated with an RTCPeerConnection, and each peer connection can have up to a theoretical maximum of 65,534 data channels (the actual limit may vary from browser to browser)."><code>RTCDataChannel</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCDataChannelEvent" title="The RTCDataChannelEvent() constructor returns a new RTCDataChannelEvent object, which represents a datachannel event. These events sent to an RTCPeerConnection when its remote peer is asking to open an RTCDataChannel between the two peers."><code>RTCDataChannelEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCIceCandidate" title="The RTCIceCandidate interface of the the WebRTC API represents a candidate Internet Connectivity Establishment (ICE) server for establishing an RTCPeerConnection."><code>RTCIceCandidate</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCIceServer" title="The RTCIceServer dictionary defines how to connect to a single ICE server (such as a STUN or TURN server). It includes both the URL and the necessary credentials, if any, to connect to the server."><code>RTCIceServer</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCIdentityAssertion" title="The RTCIdentityAssertion interface of the the WebRTC API represents the identity of the a remote peer of the current connection. If no peer has yet been set and verified this interface returns null. Once set it can't be changed."><code>RTCIdentityAssertion</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCIdentityErrorEvent" title="The RTCIdentityErrorEvent interface represents an error associated with the identity provider (idP). This is usually for an RTCPeerConnection. Two events are sent with this type: idpassertionerror and idpvalidationerror."><code>RTCIdentityErrorEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCIdentityEvent" title="The RTCIdentityEvent interface represents an identity assertion generated by an identity provider (idP). This is usually for an RTCPeerConnection. The only event sent with this type is identityresult.."><code>RTCIdentityEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCPeerConnection" title="The RTCPeerConnection interface represents a WebRTC connection between the local computer and a remote peer. It provides methods to connect to a remote peer, maintain and monitor the connection, and close the connection once it's no longer needed."><code>RTCPeerConnection</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCPeerConnectionIceEvent" title="The RTCPeerConnectionIceEvent interface represents events that occurs in relation to ICE candidates with the target, usually an RTCPeerConnection. Only one event is of this type: icecandidate."><code>RTCPeerConnectionIceEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCRtpContributingSource" title="The RTCRtpContributingSource interface of the the WebRTC API provides contains information about a given contributing source (CSRC) including the most recent time a packet that the source contributed was played out."><code>RTCRtpContributingSource</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCRtpReceiver" title="The RTCRtpReceiver interface of the the WebRTC API manages the reception and decoding of data for a MediaStreamTrack on an RTCPeerConnection."><code>RTCRtpReceiver</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCRtpSender" title="tbd"><code>RTCRtpSender</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCSctpTransport" title="The RTCSctpTransport interface provides information which describes a Stream Control Transmission Protocol (SCTP) transport. This provides information about limitations of the transport, but also provides a way to access the underlying Datagram Transport Layer Security (DTLS) transport over which SCTP packets for all of an RTCPeerConnection's data channels are sent and received."><code>RTCSctpTransport</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCSessionDescription" title="The RTCSessionDescription interface describes one end of a connection—or potential connection—and how it's configured. Each RTCSessionDescription consists of a description type indicating which part of the offer/answer negotiation process it describes and of the SDP descriptor of the session."><code>RTCSessionDescription</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCSessionDescriptionCallback" title="The RTCSessionDescriptionCallback type is used to represent the callback function passed into the deprecated callback-based version of createOffer() or createAnswer() when using them to create offers or answers."><code>RTCSessionDescriptionCallback</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RTCStatsReport" title="The RTCStatsReport interface is used to provide statistics data about WebRTC connections as returned by the RTCPeerConnection.getStats(), RTCRtpReceiver.getStats(), and RTCRtpSender.getStats() methods."><code>RTCStatsReport</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RadioNodeList" title="The RadioNodeList interface represents a collection of elements in a <form> or a <fieldset> element."><code>RadioNodeList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RandomSource" title="RandomSource represents a source of cryptographically secure random numbers. It is available via the Crypto object of the global object: Window.crypto on Web pages, WorkerGlobalScope.crypto in workers."><code>RandomSource</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Range" title="The Range interface represents a fragment of a document that can contain nodes and parts of text nodes."><code>Range</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableByteStreamController" title="The ReadableByteStreamController interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. Byte stream controllers are for byte streams."><code>ReadableByteStreamController</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableStream" title="The ReadableStream interface of the Streams API represents a readable stream of byte data. It can be used to handle response streams of the Fetch API. "><code>ReadableStream</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableStreamBYOBReader" title='The ReadableStreamDefaultReader interface of the Streams API represents a BYOB ("bring your own buffer") reader that can be used to read stream data supplied by the developer (e.g. a custom ReadableStream.ReadableSteam() constructor).'><code>ReadableStreamBYOBReader</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableStreamBYOBRequest" title="The ReadableStreamBYOBRequest interface of the Streams API represents a pull request into a ReadableByteStreamController view."><code>ReadableStreamBYOBRequest</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableStreamDefaultController" title="The ReadableStreamDefaultController interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. Default controllers are for streams that are not byte streams. "><code>ReadableStreamDefaultController</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ReadableStreamDefaultReader" title="The ReadableStreamDefaultReader interface of the Streams API represents a default reader that can be used to read stream data supplied from a network (e.g. a fetch request). "><code>ReadableStreamDefaultReader</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/RenderingContext" title="RenderingContext is a WebIDL typedef which can refer to any one of the interfaces that represent a graphics rendering context within a <canvas> element: CanvasRenderingContext2D, WebGLRenderingContext, or WebGL2RenderingContext. By using the shorthand RenderingContext, methods and properties which can make use of any of these interfaces can be specified and written more easily; since <canvas> supports several rendering systems, it's helpful from a specification and browser implementation perspective to have a shorthand that means "one of these interfaces.""><code>RenderingContext</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Request" title="The Request interface of the Fetch API represents a resource request."><code>Request</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Response" title="The Response interface of the Fetch API represents the response to a request."><code>Response</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>S</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAElement" title="The SVGAElement interface provides access to the properties of <a> element, as well as methods to manipulate them."><code>SVGAElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAltGlyphDefElement" title="The SVGAltGlyphDefElement interface corresponds to the <altGlyphDef> element."><code>SVGAltGlyphDefElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAltGlyphElement" title="The SVGAltGlyphElement interface represents an <altglyph> element. This interface makes it possible to implement more sophisticated and particular glyph characters. For some textal representations as: ligatures (e.g. æ, ß, etc ), special-purpose fonts (e.g. musical symbols) or even alternate glyphs such as Asian text strings it is required that a different set of glyphs be used than the normal given character data."><code>SVGAltGlyphElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAltGlyphItemElement" title="The SVGAltGlyphItemElement interface corresponds to the <altGlyphItem> element."><code>SVGAltGlyphItemElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAngle" title="The SVGAngle interface is used to represent a value that can be an <angle> or <number> value. An SVGAngle reflected through the animVal attribute is always read only."><code>SVGAngle</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimateColorElement" title="The SVGAnimateColorElement interface corresponds to the <animateColor> element."><code>SVGAnimateColorElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimateElement" title="The SVGAnimateElement interface corresponds to the <animate> element."><code>SVGAnimateElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimateMotionElement" title="The SVGAnimateMotionElement interface corresponds to the <animateMotion> element."><code>SVGAnimateMotionElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimateTransformElement" title="The SVGAnimateTransformElement interface corresponds to the <animateTransform> element."><code>SVGAnimateTransformElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedAngle" title="The SVGAnimatedAngle interface is used for attributes of basic type <angle> which can be animated."><code>SVGAnimatedAngle</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedBoolean" title="The SVGAnimatedBoolean interface is used for attributes of type boolean which can be animated."><code>SVGAnimatedBoolean</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedEnumeration" title="The SVGAnimatedEnumeration interface is used for attributes whose value must be a constant from a particular enumeration and which can be animated."><code>SVGAnimatedEnumeration</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedInteger" title="The SVGAnimatedInteger interface is used for attributes of basic type <integer> which can be animated."><code>SVGAnimatedInteger</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedLength" title="The SVGAnimatedLength interface is used for attributes of basic type <length> which can be animated."><code>SVGAnimatedLength</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedLengthList" title="The SVGAnimatedLengthList interface is used for attributes of type SVGLengthList which can be animated."><code>SVGAnimatedLengthList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedNumber" title="The SVGAnimatedNumber interface is used for attributes of basic type <Number> which can be animated."><code>SVGAnimatedNumber</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedNumberList" title="The SVGAnimatedNumber interface is used for attributes which take a list of numbers and which can be animated."><code>SVGAnimatedNumberList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedPoints" title="The SVGAnimatedPoints interface supports elements which have a points attribute which holds a list of coordinate values and which support the ability to animate that attribute."><code>SVGAnimatedPoints</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedPreserveAspectRatio" title="The SVGAnimatedPreserveAspectRatio interface is used for attributes of type SVGPreserveAspectRatio which can be animated."><code>SVGAnimatedPreserveAspectRatio</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedRect" title="The SVGAnimatedRect interface is used for attributes of basic SVGRect which can be animated."><code>SVGAnimatedRect</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedString" title="The SVGAnimatedString interface represents string attributes which can be animated from each SVG declaration. You need to create SVG attribute before doing anything else, everything should be declared inside this."><code>SVGAnimatedString</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimatedTransformList" title="The SVGAnimatedTransformList interface is used for attributes which take a list of numbers and which can be animated."><code>SVGAnimatedTransformList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGAnimationElement" title="The SVGAnimationElement interface is the base interface for all of the animation element interfaces: SVGAnimateElement, SVGSetElement, SVGAnimateColorElement, SVGAnimateMotionElement and SVGAnimateTransformElement."><code>SVGAnimationElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGCircleElement" title="The SVGCircleElement interface is an interface for the <circle> element. The circle element is defined by the cx and cy attributes that denote the coordinates of the centre of the circle."><code>SVGCircleElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGClipPathElement" title="The SVGClipPathElement interface provides access to the properties of <clipPath> elements, as well as methods to manipulate them."><code>SVGClipPathElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGColorProfileElement" title="The SVGColorProfileElement interface corresponds to the <color-profile> element."><code>SVGColorProfileElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGComponentTransferFunctionElement" title="The SVGComponentTransferFunctionElement interface defines a base interface used by the component transfer function interfaces."><code>SVGComponentTransferFunctionElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGCursorElement" title="The SVGCursorElement interface provides access to the properties of <cursor> elements, as well as methods to manipulate them."><code>SVGCursorElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGDefsElement" title="The SVGDefsElement interface corresponds to the <defs> element."><code>SVGDefsElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGDescElement" title="The SVGDescElement interface corresponds to the <desc> element."><code>SVGDescElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGElement" title="All of the SVG DOM interfaces that correspond directly to elements in the SVG language derive from the SVGElement interface."><code>SVGElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGEllipseElement" title="The SVGEllipseElement interface provides access to the properties of <ellipse> elements."><code>SVGEllipseElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGEvent" title="This section contains the Scalable Vector Graphics (SVG) event reference documentation."><code>SVGEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGExternalResourcesRequired" title="The SVGExternalResourcesRequired interface defines an interface which applies to all elements where this element or one of its descendants can reference an external resource."><code>SVGExternalResourcesRequired</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEBlendElement" title="The SVGFEBlendElement interface corresponds to the <feBlend> element."><code>SVGFEBlendElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEComponentTransferElement" title="The SVGFEComponentTransferElement interface corresponds to the <feComponentTransfer> element."><code>SVGFEComponentTransferElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFECompositeElement" title="The SVGFECompositeElement interface corresponds to the <feComposite> element."><code>SVGFECompositeElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEConvolveMatrixElement" title="The SVGFEConvolveMatrixElement interface corresponds to the <feConvolveMatrix> element."><code>SVGFEConvolveMatrixElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEDiffuseLightingElement" title="The SVGFEDiffuseLightingElement interface corresponds to the <feDiffuseLighting> element."><code>SVGFEDiffuseLightingElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEDisplacementMapElement" title="The SVGFEDisplacementMapElement interface corresponds to the <feDisplacementMap> element."><code>SVGFEDisplacementMapElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEDistantLightElement" title="The SVGFEDistantLightElement interface corresponds to the <feDistantLight> element."><code>SVGFEDistantLightElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEDropShadowElement" title="The SVGFEDropShadowElement interface corresponds to the <feDropShadow> element."><code>SVGFEDropShadowElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEFloodElement" title="The SVGFEFloodElement interface corresponds to the <feFlood> element."><code>SVGFEFloodElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEFuncAElement" title="The SVGFEFuncAElement interface corresponds to the <feFuncA> element."><code>SVGFEFuncAElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEFuncBElement" title="The SVGFEFuncBElement interface corresponds to the <feFuncB> element."><code>SVGFEFuncBElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEFuncGElement" title="The SVGFEFuncGElement interface corresponds to the <feFuncG> element."><code>SVGFEFuncGElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEFuncRElement" title="The SVGFEFuncRElement interface corresponds to the <feFuncR> element."><code>SVGFEFuncRElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEGaussianBlurElement" title="The SVGFEGaussianBlurElement interface corresponds to the <feGaussianBlur> element."><code>SVGFEGaussianBlurElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEImageElement" title="The SVGFEImageElement interface corresponds to the <feImage> element."><code>SVGFEImageElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEMergeElement" title="The SVGFEMergeElement interface corresponds to the <feMerge> element."><code>SVGFEMergeElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEMergeNodeElement" title="The SVGFEMergeNodeElement interface corresponds to the <feMergeNode> element."><code>SVGFEMergeNodeElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEMorphologyElement" title="The SVGFEMorphologyElement interface corresponds to the <feMorphology> element."><code>SVGFEMorphologyElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEOffsetElement" title="The SVGFEOffsetElement interface corresponds to the <feOffset> element."><code>SVGFEOffsetElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFEPointLightElement" title="The SVGFEPointLightElement interface corresponds to the <fePointLight> element."><code>SVGFEPointLightElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFESpecularLightingElement" title="The SVGFESpecularLightingElement interface corresponds to the <feSpecularLighting> element."><code>SVGFESpecularLightingElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFESpotLightElement" title="The SVGFESpotLightElement interface corresponds to the <feSpotLight> element."><code>SVGFESpotLightElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFETileElement" title="The SVGFETileElement interface corresponds to the <feTile> element."><code>SVGFETileElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFETurbulenceElement" title="The SVGFETurbulenceElement interface corresponds to the <feTurbulence> element."><code>SVGFETurbulenceElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFilterElement" title="The SVGFilterElement interface provides access to the properties of <filter> elements, as well as methods to manipulate them."><code>SVGFilterElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFilterPrimitiveStandardAttributes" title="The SVGFilterPrimitiveStandardAttributes interface defines the set of DOM attributes that are common across the filter primitive interfaces."><code>SVGFilterPrimitiveStandardAttributes</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontElement" title="The SVGFontElement interface corresponds to the <font> elements."><code>SVGFontElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontFaceElement" title="The SVGFontFaceElement interface corresponds to the <font-face> elements."><code>SVGFontFaceElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontFaceFormatElement" title="The SVGFontFaceFormatElement interface corresponds to the <font-face-format> elements."><code>SVGFontFaceFormatElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontFaceNameElement" title="The SVGFontFaceNameElement interface corresponds to the <font-face-name> elements."><code>SVGFontFaceNameElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontFaceSrcElement" title="The SVGFontFaceSrcElement interface corresponds to the <font-face-src> elements."><code>SVGFontFaceSrcElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGFontFaceUriElement" title="The SVGFontFaceUriElement interface corresponds to the <font-face-uri> elements."><code>SVGFontFaceUriElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGForeignObjectElement" title="The SVGForeignObjectElement interface provides access to the properties of <foreignObject> elements, as well as methods to manipulate them."><code>SVGForeignObjectElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGElement" title="The SVGGElement interface corresponds to the <g> element."><code>SVGGElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGeometryElement" title="The SVGGeometryElement interface represents SVG elements whose rendering is defined by geometry with an equivalent path, and which can be filled and stroked. This includes paths and the basic shapes."><code>SVGGeometryElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGlyphElement" title="The SVGGlyphElement interface corresponds to the <glyph> element."><code>SVGGlyphElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGlyphRefElement" title="The SVGGlyphRefElement interface corresponds to the <glyphRef> elements."><code>SVGGlyphRefElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGradientElement" title="The SVGGradient interface is a base interface used by SVGLinearGradientElement and SVGRadialGradientElement."><code>SVGGradientElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGGraphicsElement" title="The SVGGraphicsElement interface represents SVG elements whose primary purpose is to directly render graphics into a group."><code>SVGGraphicsElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGHKernElement" title="The SVGHKernElement interface corresponds to the <hkern> elements."><code>SVGHKernElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGImageElement" title="The SVGImageElement interface corresponds to the <image> element."><code>SVGImageElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGLength" title="The SVGLength interface correspond to the <length> basic data type."><code>SVGLength</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGLengthList" title="The SVGLengthList defines a list of SVGLength objects."><code>SVGLengthList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGLineElement" title="The SVGLineElement interface provides access to the properties of <line> elements, as well as methods to manipulate them."><code>SVGLineElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGLinearGradientElement" title="The SVGLinearGradientElement interface corresponds to the <linearGradient> element."><code>SVGLinearGradientElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMPathElement" title="The SVGMPathElement interface corresponds to the <mpath> element."><code>SVGMPathElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMaskElement" title="The SVGMaskElement interface provides access to the properties of <mask> elements, as well as methods to manipulate them."><code>SVGMaskElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMatrix" title="Many of SVG's graphics operations utilize 2x3 matrices of the form:"><code>SVGMatrix</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMeshElement" title="The SVGMeshElement interface provides access to the properties of <mesh> elements."><code>SVGMeshElement</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMetadataElement" title="The SVGMetadataElement interface corresponds to the <metadata> element."><code>SVGMetadataElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGMissingGlyphElement" title="The SVGMissingGlyphElement interface corresponds to the <missing-glyph> elements."><code>SVGMissingGlyphElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGNumber" title="The SVGNumber interface corresponds to the <number> basic data type."><code>SVGNumber</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGNumberList" title="The SVGNumberList defines a list of SVGNumber objects."><code>SVGNumberList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPathElement" title="The SVGPathElement interface corresponds to the <path> element."><code>SVGPathElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPatternElement" title="The SVGPatternElement interface corresponds to the <pattern> element."><code>SVGPatternElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPoint" title="An SVGPoint represents a 2D or 3D point in the SVG coordinate system."><code>SVGPoint</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPolygonElement" title="The SVGPolygonElement interface provides access to the properties of <polygon> elements, as well as methods to manipulate them."><code>SVGPolygonElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPolylineElement" title="The SVGPolylineElement interface provides access to the properties of <polyline> elements, as well as methods to manipulate them."><code>SVGPolylineElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGPreserveAspectRatio" title="The SVGPreserveAspectRatio interface corresponds to the preserveAspectRatio attribute, which is available for some of SVG's elements."><code>SVGPreserveAspectRatio</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGRadialGradientElement" title="The SVGRadialGradientElement interface corresponds to the <RadialGradient> element."><code>SVGRadialGradientElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGRect" title="The SVGRect represents a rectangle. Rectangles consist of an x and y coordinate pair identifying a minimum x value, a minimum y value, and a width and height, which are constrained to be non-negative."><code>SVGRect</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGRectElement" title="The SVGRectElement interface provides access to the properties of <rect> elements, as well as methods to manipulate them."><code>SVGRectElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGRenderingIntent" title="The SVGRenderingIntent interface defines the enumerated list of possible values for rendering-intent attributes or descriptors."><code>SVGRenderingIntent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGSVGElement" title="The SVGSVGElement interface provides access to the properties of <svg> elements, as well as methods to manipulate them. This interface contains also various miscellaneous commonly-used utility methods, such as matrix operations and the ability to control the time of redraw on visual rendering devices."><code>SVGSVGElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGScriptElement" title="The SVGScriptElement interface corresponds to the SVG <script> element."><code>SVGScriptElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGSetElement" title="The SVGSetElement interface corresponds to the <set> element."><code>SVGSetElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGSolidcolorElement" title="The SVGSolidcolorElement interface corresponds to the <solidcolor> element."><code>SVGSolidcolorElement</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGStopElement" title="The SVGStopElement interface corresponds to the <stop> element."><code>SVGStopElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGStringList" title="The SVGStringList defines a list of DOMString objects."><code>SVGStringList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGStylable" title="The SVGStylable interface is implemented on all objects corresponding to SVG elements that can have style, class and presentation attributes specified on them."><code>SVGStylable</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGStyleElement" title="The SVGStyleElement interface corresponds to the SVG <style> element."><code>SVGStyleElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGSwitchElement" title="The SVGSwitchElement interface corresponds to the <switch> element."><code>SVGSwitchElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGSymbolElement" title="The SVGSymbolElement interface corresponds to the <symbol> element."><code>SVGSymbolElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTRefElement" title="The SVGTRefElement interface corresponds to the <tref> elements."><code>SVGTRefElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTSpanElement" title="The SVGTSpanElement interface represents a <tspan> element."><code>SVGTSpanElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTests" title="The SVGTests interface is used to reflect conditional processing attributes and is mixed into other interfaces for elements that support these attributes."><code>SVGTests</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTextContentElement" title="The SVGTextContentElement interface is implemented by elements that support rendering child text content. It is inherited by various text-related interfaces, such as SVGTextElement, SVGTSpanElement, SVGTRefElement, SVGAltGlyphElement and SVGTextPathElement."><code>SVGTextContentElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTextElement" title="The SVGTextElement interface corresponds to the <text> elements."><code>SVGTextElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTextPathElement" title="The SVGTextPathElement interface corresponds to the <textPath> element."><code>SVGTextPathElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTextPositioningElement" title="The SVGTextPositioningElement interface is implemented by elements that support attributes that position individual text glyphs. It is inherited by SVGTextElement, SVGTSpanElement, SVGTRefElement and SVGAltGlyphElement."><code>SVGTextPositioningElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTitleElement" title="The SVGTitleElement interface corresponds to the <title> element."><code>SVGTitleElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTransform" title="SVGTransform is the interface for one of the component transformations within an SVGTransformList; thus, an SVGTransform object corresponds to a single component (e.g., scale(…) or matrix(…)) within a transform attribute."><code>SVGTransform</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTransformList" title="The SVGTransformList defines a list of SVGTransform objects."><code>SVGTransformList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGTransformable" title="Interface SVGTransformable contains properties and methods that apply to all elements which have attribute transform."><code>SVGTransformable</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGURIReference" title="The SVGURIReference interface is used to reflect the href attribute and the deprecated xlink:href attribute."><code>SVGURIReference</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGUnitTypes" title="The SVGUnitTypes interface defines a commonly used set of constants used for reflecting gradientUnits, patternContentUnits and other similar attributes."><code>SVGUnitTypes</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGUseElement" title="The SVGUseElement interface corresponds to the <use> element."><code>SVGUseElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGVKernElement" title="The SVGVKernElement interface corresponds to the <vkern> elements."><code>SVGVKernElement</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGViewElement" title="The SVGViewElement interface provides access to the properties of <view> elements, as well as methods to manipulate them."><code>SVGViewElement</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SVGZoomAndPan" title="The SVGZoomAndPan interfaceis used to reflect the zoomAndPan attribute, and is mixed in to other interfaces for elements that support this attribute."><code>SVGZoomAndPan</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Screen" title="The Screen interface represents a screen, usually the one on which the current window is being rendered."><code>Screen</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ScreenOrientation" title="The ScreenOrientation interface of the the Screen Orientation API provides information about the current orientation of the document."><code>ScreenOrientation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ScriptProcessorNode" title=""><code>ScriptProcessorNode</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SecurityPolicyViolationEvent" title="The SecurityPolicyViolationEvent interface is an event sent on a document or worker when its content security policy is violated."><code>SecurityPolicyViolationEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Selection" title="A Selection object represents the range of text selected by the user or the current position of the caret. To obtain a Selection object for examination or modification, call window.getSelection()."><code>Selection</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorker" title="The ServiceWorker interface of the ServiceWorker API provides a reference to a service worker. Multiple browsing contexts (e.g. pages, workers, etc.) can be associated with the same service worker, each through a unique ServiceWorker object."><code>ServiceWorker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorkerContainer" title="The ServiceWorkerContainer interface of the ServiceWorker API provides an object representing the service worker as an overall unit in the network ecosystem, including facilities to register, unregister and update service workers, and access the state of service workers and their registrations."><code>ServiceWorkerContainer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorkerGlobalScope" title="The ServiceWorkerGlobalScope interface of the ServiceWorker API represents the global execution context of a service worker."><code>ServiceWorkerGlobalScope</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorkerMessageEvent" title="The ServiceWorkerMessageEvent interface of the ServiceWorker API contains information about an event sent to a ServiceWorkerContainer target. This extends the default message event to allow setting a ServiceWorker object as the source of a message. The event object is accessed via the handler function of a message event, when fired by a message received from a service worker."><code>ServiceWorkerMessageEvent</code></a></span><span class="indexListBadges"> <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorkerRegistration" title="The ServiceWorkerRegistration interface of the ServiceWorker API represents the service worker registration. You register a service worker to control one or more pages that share the same origin."><code>ServiceWorkerRegistration</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ServiceWorkerState" title="The ServiceWorkerState is associated with its ServiceWorker's state."><code>ServiceWorkerState</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ShadowRoot" title="The ShadowRoot interface of the Shadow DOM API is the root node of a DOM subtree that is rendered separately from a document's main DOM tree."><code>ShadowRoot</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SharedWorker" title="The SharedWorker interface represents a specific kind of worker that can be accessed from several browsing contexts, such as several windows, iframes or even workers. They implement an interface different than dedicated workers and have a different global scope, SharedWorkerGlobalScope."><code>SharedWorker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SharedWorkerGlobalScope" title="The SharedWorkerGlobalScope object (the SharedWorker global scope) is accessible through the self keyword. Some additional global functions, namespaces objects, and constructors, not typically associated with the worker global scope, but available on it, are listed in the JavaScript Reference. See the complete list of functions available to workers."><code>SharedWorkerGlobalScope</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SourceBuffer" title="The SourceBuffer interface represents a chunk of media to be passed into an HTMLMediaElement and played, via a MediaSource object. This can be made up of one or several media segments."><code>SourceBuffer</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SourceBufferList" title="The SourceBufferList interface represents a simple container list for multiple SourceBuffer objects."><code>SourceBufferList</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechGrammar" title="The SpeechGrammar interface of the Web Speech API represents a set of words or patterns of words that we want the recognition service to recognize."><code>SpeechGrammar</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechGrammarList" title="The SpeechGrammarList interface of the Web Speech API represents a list of SpeechGrammar objects containing words or patterns of words that we want the recognition service to recognize."><code>SpeechGrammarList</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognition" title="The SpeechRecognition interface of the Web Speech API is the controller interface for the recognition service; this also handles the SpeechRecognitionEvent sent from the recognition service."><code>SpeechRecognition</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognitionAlternative" title="The SpeechRecognitionAlternative interface of the Web Speech API represents a single word that has been recognised by the speech recognition service."><code>SpeechRecognitionAlternative</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognitionError" title="The SpeechRecognitionError interface of the Web Speech API represents error messages from the recognition service."><code>SpeechRecognitionError</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognitionEvent" title="The SpeechRecognitionEvent interface of the Web Speech API represents the event object for the result and nomatch events, and contains all the data associated with an interim or final speech recognition result."><code>SpeechRecognitionEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognitionResult" title="The SpeechRecognitionResult interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative objects."><code>SpeechRecognitionResult</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechRecognitionResultList" title="The SpeechRecognitionResultList interface of the Web Speech API represents a list of SpeechRecognitionResult objects, or a single one if results are being captured in continuous mode."><code>SpeechRecognitionResultList</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechSynthesis" title="The SpeechSynthesis interface of the Web Speech API is the controller interface for the speech service; this can be used to retrieve information about the synthesis voices available on the device, start and pause speech, and other commands besides."><code>SpeechSynthesis</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechSynthesisErrorEvent" title="The SpeechSynthesisErrorEvent interface of the Web Speech API contains information about any errors that occur while processing SpeechSynthesisUtterance objects in the speech service."><code>SpeechSynthesisErrorEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechSynthesisEvent" title="The SpeechSynthesisEvent interface of the Web Speech API contains information about the current state of SpeechSynthesisUtterance objects that have been processed in the speech service."><code>SpeechSynthesisEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechSynthesisUtterance" title="The SpeechSynthesisUtterance interface of the Web Speech API represents a speech request. It contains the content the speech service should read and information about how to read it (e.g. language, pitch and volume.)"><code>SpeechSynthesisUtterance</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SpeechSynthesisVoice" title="The SpeechSynthesisVoice interface of the Web Speech API represents a voice that the system supports. Every SpeechSynthesisVoice has its own relative speech service including information about language, name and URI."><code>SpeechSynthesisVoice</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StereoPannerNode" title="The pan property takes a unitless value between -1 (full left pan) and 1 (full right pan). This interface was introduced as a much simpler way to apply a simple panning effect than having to use a full PannerNode."><code>StereoPannerNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Storage" title="The Storage interface of the Web Storage API provides access to the session storage or local storage for a particular domain, allowing you to for example add, modify or delete stored data items."><code>Storage</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StorageEstimate" title="The StorageEstimate dictionary is used by the StorageManager to provide estimates of the size of a site's or application's data store and how much of it is in use. The estimate() method returns an object that conforms to this dictionary when its Promise resolves."><code>StorageEstimate</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StorageEvent" title="A StorageEvent is sent to a window when a storage area it has access to is changed within the context of another document."><code>StorageEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StorageManager" title="The StorageManager interface of the the Storage API provides an interface for managing persistance permissions and estimating available storage. You can get a reference to this interface using either navigator.storage or WorkerNavigator.storage."><code>StorageManager</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StorageQuota" title="The storageQuota property of the Navigator interface of the Quota Management API provides means to query and request storage usage and quota information."><code>StorageQuota</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StyleSheet" title="An object implementing the StyleSheet interface represents a single style sheet. CSS style sheets will further implement the more specialized CSSStyleSheet interface."><code>StyleSheet</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/StyleSheetList" title="Technical review completed."><code>StyleSheetList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SubtleCrypto" title="The SubtleCrypto interface represents a set of cryptographic primitives. It is available via the Crypto.subtle properties available in a window context (via Window.crypto)."><code>SubtleCrypto</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SyncEvent" title="The SyncEvent interface represents a sync action that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker. "><code>SyncEvent</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/SyncManager" title="The SyncManager interface of the the ServiceWorker API provides an interface for registering and listing sync registrations."><code>SyncManager</code></a></span><span class="indexListBadges"> <span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></span></span></li> -</ul> -<span>T</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TaskAttributionTiming" title="The TaskAttributionTiming interface of the the Long Tasks API returns information about the work involved in a long task and its associate frame context. The frame context, also called the container is the iframe, embed or object etc. that is being implicated, on the whole, for a long task."><code>TaskAttributionTiming</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Text" title="The Text interface represents the textual content of Element or Attr. If an element has no markup within its content, it has a single child implementing Text that contains the element's text. However, if the element contains markup, it is parsed into information items and Text nodes that form its children."><code>Text</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TextDecoder" title="The TextDecoder interface represents a decoder for a specific method, that is a specific character encoding, like utf-8, iso-8859-2, koi8, cp1261, gbk, etc. A decoder takes a stream of bytes as input and emits a stream of code points. For a more scalable, non-native library, see StringView – a C-like representation of strings based on typed arrays."><code>TextDecoder</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TextEncoder" title="TextEncoder takes a stream of code points as input and emits a stream of bytes. For a more scalable, non-native library, see StringView – a C-like representation of strings based on typed arrays."><code>TextEncoder</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TextMetrics" title="The TextMetrics interface represents the dimension of a text in the canvas, as created by the CanvasRenderingContext2D.measureText() method."><code>TextMetrics</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TextTrack" title="This interface also inherits properties from EventTarget."><code>TextTrack</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TimeEvent" title="Extends Event."><code>TimeEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TimeRanges" title="The TimeRanges interface is used to represent a set of time ranges, primarily for the purpose of tracking which portions of media have been buffered when loading it for use by the <audio> and <video> elements."><code>TimeRanges</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Touch" title="The Touch interface represents a single contact point on a touch-sensitive device. The contact point is commonly a finger or stylus and the device may be a touchscreen or trackpad."><code>Touch</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TouchEvent" title="The TouchEvent interface represents an event sent when the state of contacts with a touch-sensitive surface changes. This surface can be a touch screen or trackpad, for example. The event can describe one or more points of contact with the screen and includes support for detecting movement, addition and removal of contact points, and so forth."><code>TouchEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TouchList" title="The TouchList interface represents a list of contact points with a touch surface; for example, if the user has three fingers on the touch surface (such as a screen or trackpad), the corresponding TouchList object would have one Touch object for each finger, for a total of three entries."><code>TouchList</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TrackDefault" title="The TrackDefault interface provides a SourceBuffer with kind, label, and language information for tracks that do not contain this information in the initialization segments of a media chunk."><code>TrackDefault</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TrackDefaultList" title="The TrackDefaultList interface represents a simple container list for multiple TrackDefault objects."><code>TrackDefaultList</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Transferable" title="The Transferable interface represents an object that can be transfered between different execution contexts, like the main thread and Web workers."><code>Transferable</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TransitionEvent" title="The TransitionEvent interface represents events providing information related to transitions."><code>TransitionEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TreeWalker" title="The TreeWalker object represents the nodes of a document subtree and a position within them."><code>TreeWalker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/TypeInfo" title=""><code>TypeInfo</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -</ul> -<span>U</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/UIEvent" title="The UIEvent interface represents simple user interface events."><code>UIEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/URL" title="The URL interface represents an object providing static methods used for creating object URLs."><code>URL</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/URLSearchParams" title="The URLSearchParams interface defines utility methods to work with the query string of a URL."><code>URLSearchParams</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/URLUtilsReadOnly" title="The URLUtilsReadOnly interface defines utility methods to work with URLs. It defines only non-modifying methods intended to be used on data that cannot be changed."><code>URLUtilsReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/USVString" title="USVString corresponds to the set of all possible sequences of unicode scalar values. USVString maps to a String when returned in JavaScript; it's generally only used for APIs that perform text processing and need a string of unicode scalar values to operate on. USVString is equivalent to DOMString except for not allowing unpaired surrogate codepoints. Unpaired surrogate codepoints present in USVString are converted by the browser to Unicode 'replacement character' U+FFFD, (�)."><code>USVString</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/UserDataHandler" title="When associating user data with a key on a node, Node.setUserData() can also accept, in its third argument, a handler which will be called when the object is cloned, imported, deleted, renamed, or adopted. Per the specification, exceptions should not be thrown in a UserDataHandler. In both document.importNode() and Node.cloneNode(), although user data is not copied over, the handler will be called."><code>UserDataHandler</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/UserProximityEvent" title="The UserProximityEvent indicates whether a nearby physical object is present by using the proximity sensor of a device."><code>UserProximityEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>V</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRDisplay" title="The VRDisplay interface of the WebVR API represents any VR device supported by this API. It includes generic information such as device IDs and descriptions, as well as methods for starting to present a VR scene, retrieving eye parameters and display capabilities, and other important functionality."><code>VRDisplay</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRDisplayCapabilities" title="The VRDisplayCapabilities interface of the WebVR API describes the capabilities of a VRDisplay — its features can be used to perform VR device capability tests, for example can it return position information."><code>VRDisplayCapabilities</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRDisplayEvent" title="The VRDisplayEvent interface of the WebVR API represents represents the event object of WebVR-related events (see the list of WebVR window extensions)."><code>VRDisplayEvent</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VREyeParameters" title="The VREyeParameters interface of the WebVR API represents all the information required to correctly render a scene for a given eye, including field of view information."><code>VREyeParameters</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRFieldOfView" title="The VRFieldOfView interface of the WebVR API represents a field of view defined by 4 different degree values describing the view from a center point."><code>VRFieldOfView</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRFieldOfViewReadOnly" title="The VRFieldOfViewReadOnly interface of the WebVR API contains the raw definition for the degree value properties required to define a field of view. Inherited by VRFieldOfView."><code>VRFieldOfViewReadOnly</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRFrameData" title="The VRFrameData interface of the WebVR API represents all the information needed to render a single frame of a VR scene; constructed by VRDisplay.getFrameData()."><code>VRFrameData</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRLayerInit" title="The VRLayerInit interface (dictionary) of the WebVR API represents a content layer (an HTMLCanvasElement or OffscreenCanvas) that you want to present in a VR display."><code>VRLayerInit</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRPose" title="The VRPose interface of the WebVR API represents the state of a VR sensor at a given timestamp (which includes orientation, position, velocity, and acceleration information.)"><code>VRPose</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VRStageParameters" title="The VRStageParameters interface of the WebVR API represents the values describing the the stage area for devices that support room-scale experiences."><code>VRStageParameters</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VTTCue" title="VTTCues represent a cue in a text track."><code>VTTCue</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/ValidityState" title="The ValidityState interface represents the validity states that an element can be in, with respect to constraint validation. Together, they help explain why an element's value fails to validate, if it's not valid."><code>ValidityState</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VideoPlaybackQuality" title="The VideoPlaybackQuality interface represents the set of metrics describing the playback quality of a video."><code>VideoPlaybackQuality</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/VisualViewport" title="The VisualViewport interface of the the Visual Viewport API represents the visual viewport for a given window. For a page containing iframes, each iframe, as well as the containing page, will have a unique window object. Each window on a page will have a unique VisualViewport representing the properties associated with that window. You can get a window's viewport using Window.visualViewport."><code>VisualViewport</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>W</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_color_buffer_float" title="The WEBGL_color_buffer_float extension is part of the WebGL API and adds the ability to render to 32-bit floating-point color buffers."><code>WEBGL_color_buffer_float</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_astc" title="The WEBGL_compressed_texture_astc extension is part of the WebGL API and exposes Adaptive Scalable Texture Compression (ASTC) compressed texture formats to WebGL."><code>WEBGL_compressed_texture_astc</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_atc" title="The WEBGL_compressed_texture_atc extension is part of the WebGL API and exposes 3 ATC compressed texture formats. ATC is a proprietary compression algorithm for compressing textures on handheld devices."><code>WEBGL_compressed_texture_atc</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_etc" title="The WEBGL_compressed_texture_etc extension is part of the WebGL API and exposes 10 ETC/EAC compressed texture formats."><code>WEBGL_compressed_texture_etc</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_etc1" title="The WEBGL_compressed_texture_etc1 extension is part of the WebGL API and exposes the ETC1 compressed texture format."><code>WEBGL_compressed_texture_etc1</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_pvrtc" title="The WEBGL_compressed_texture_pvrtc extension is part of the WebGL API and exposes four PVRTC compressed texture formats."><code>WEBGL_compressed_texture_pvrtc</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_s3tc" title="The WEBGL_compressed_texture_s3tc extension is part of the WebGL API and exposes four S3TC compressed texture formats."><code>WEBGL_compressed_texture_s3tc</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_compressed_texture_s3tc_srgb" title="The WEBGL_compressed_texture_s3tc_srgb extension is part of the WebGL API and exposes four S3TC compressed texture formats for the sRGB colorspace."><code>WEBGL_compressed_texture_s3tc_srgb</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_debug_renderer_info" title="The WEBGL_debug_renderer_info extension is part of the WebGL API and exposes two constants with information about the graphics driver for debugging purposes."><code>WEBGL_debug_renderer_info</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_debug_shaders" title="The WEBGL_debug_shaders extension is part of the WebGL API and exposes a method to debug shaders from privileged contexts."><code>WEBGL_debug_shaders</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_depth_texture" title="The WEBGL_depth_texture extension is part of the WebGL API and defines 2D depth and depth-stencil textures."><code>WEBGL_depth_texture</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_draw_buffers" title="The WEBGL_draw_buffers extension is part of the WebGL API and enables a fragment shader to write to several textures, which is useful for deferred shading, for example."><code>WEBGL_draw_buffers</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WEBGL_lose_context" title="The WEBGL_lose_context extension is part of the WebGL API and exposes functions to simulate losing and restoring a WebGLRenderingContext."><code>WEBGL_lose_context</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WaveShaperNode" title="A WaveShaperNode always has exactly one input and one output."><code>WaveShaperNode</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGL2RenderingContext" title="The WebGL2RenderingContext interface provides the OpenGL ES 3.0 rendering context for the drawing surface of an HTML <canvas> element."><code>WebGL2RenderingContext</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLActiveInfo" title="The WebGLActiveInfo interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getActiveAttrib() and WebGLRenderingContext.getActiveUniform() methods."><code>WebGLActiveInfo</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLBuffer" title="The WebGLBuffer interface is part of the WebGL API and represents an opaque buffer object storing data such as vertices or colors."><code>WebGLBuffer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLContextEvent" title="The WebContextEvent interface is part of the WebGL API and is an interface for an event that is generated in response to a status change to the WebGL rendering context."><code>WebGLContextEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLFramebuffer" title="The WebGLFramebuffer interface is part of the WebGL API and represents a collection of buffers that serve as a rendering destination."><code>WebGLFramebuffer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLProgram" title="The WebGLProgram is part of the WebGL API and is a combination of two compiled WebGLShaders consisting of a vertex shader and a fragment shader (both written in GLSL). These are then linked into a usable program."><code>WebGLProgram</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLQuery" title="The WebGLQuery interface is part of the WebGL 2 API and provides ways to asynchronously query for information. By default, occlusion queries and primitive queries are available."><code>WebGLQuery</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLRenderbuffer" title="The WebGLRenderbuffer interface is part of the WebGL API and represents a buffer that can contain an image, or can be source or target of an rendering operation."><code>WebGLRenderbuffer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLRenderingContext" title="The WebGLRenderingContext interface provides the OpenGL ES 2.0 rendering context for the drawing surface of an HTML <canvas> element."><code>WebGLRenderingContext</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLSampler" title="The WebGLSampler interface is part of the WebGL 2 API and stores sampling parameters for WebGLTexture access inside of a shader."><code>WebGLSampler</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLShader" title="The WebGLShader is part of the WebGL API and can either be a vertex or a fragment shader. A WebGLProgram requires both types of shaders."><code>WebGLShader</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLShaderPrecisionFormat" title="The WebGLShaderPrecisionFormat interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getShaderPrecisionFormat() method."><code>WebGLShaderPrecisionFormat</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLSync" title="The WebGLSync interface is part of the WebGL 2 API and is used to synchronize activities between the GPU and the application."><code>WebGLSync</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLTexture" title="The WebGLTexture interface is part of the WebGL API and represents an opaque texture object providing storage and state for texturing operations."><code>WebGLTexture</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLTransformFeedback" title="The WebGLTransformFeedback interface is part of the WebGL 2 API and enables transform feedback, which is the process of capturing primitives generated by vertex processing. It allows to preserve the post-transform rendering state of an object and resubmit this data multiple times."><code>WebGLTransformFeedback</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLUniformLocation" title="The WebGLUniformLocation interface is part of the WebGL API and represents the location of a uniform variable in a shader program."><code>WebGLUniformLocation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebGLVertexArrayObject" title="The WebGLVertexArrayObject interface is part of the WebGL 2 API, represents vertex array objects (VAOs) pointing to vertex array data, and provides names for different sets of vertex data."><code>WebGLVertexArrayObject</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebSocket" title="The WebSocket object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection."><code>WebSocket</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WebSockets_API" title="WebSockets is an advanced technology that makes it possible to open an interactive communication session between the user's browser and a server. With this API, you can send messages to a server and receive event-driven responses without having to poll the server for a reply."><code>WebSockets</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WheelEvent" title="The WheelEvent interface represents events that occur due to the user moving a mouse wheel or similar input device."><code>WheelEvent</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Window" title="The window object represents a window containing a DOM document; the document property points to the DOM document loaded in that window."><code>Window</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WindowBase64" title="The WindowBase64 helper contains utility methods to convert data to and from base64, a binary-to-text encoding scheme. For example it is used in data URIs."><code>WindowBase64</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WindowClient" title="The WindowClient interface of the ServiceWorker API represents the scope of a service worker client that is a document in a browser context, controlled by an active worker. The service worker client independently selects and uses a service worker for its own loading and sub-resources."><code>WindowClient</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WindowEventHandlers" title="WindowEventHandlers mixin describes the event handlers common to several interfaces like Window, or HTMLBodyElement and HTMLFrameSetElement. Each of these interfaces can implement additional specific event handlers."><code>WindowEventHandlers</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WindowOrWorkerGlobalScope" title="The WindowOrWorkerGlobalScope mixin describes several features common to the Window and WorkerGlobalScope interfaces. Each of these interfaces can, of course, add more features in addition to the ones listed below."><code>WindowOrWorkerGlobalScope</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WindowTimers" title="WindowTimers is a mixin used to provide utility methods which set and clear timers. No objects of this type exist; instead, its methods are available on Window for the standard browsing scope, or on WorkerGlobalScope for workers."><code>WindowTimers</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/Worker" title="The Worker interface of the Web Workers API represents a background task that can be easily created and can send messages back to its creator. Creating a worker is as simple as calling the Worker() constructor and specifying a script to be run in the worker thread."><code>Worker</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WorkerGlobalScope" title="The WorkerGlobalScope interface of the Web Workers API is an interface representing the scope of any worker. Workers have no browsing context; this scope contains the information usually conveyed by Window objects — in this case event handlers, the console or the associated WorkerNavigator object. Each WorkerGlobalScope has its own event loop."><code>WorkerGlobalScope</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WorkerLocation" title="The WorkerLocation interface defines the absolute location of the script executed by the Worker. Such an object is initialized for each worker and is available via the WorkerGlobalScope.location property obtained by calling window.self.location."><code>WorkerLocation</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WorkerNavigator" title="The WorkerNavigator interface represents a subset of the Navigator interface allowed to be accessed from a Worker. Such an object is initialized for each worker and is available via the WorkerGlobalScope.navigator property obtained by calling window.self.navigator."><code>WorkerNavigator</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WritableStream" title="The WritableStream interface of the the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink. This object comes with build-in backpressure and queuing."><code>WritableStream</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WritableStreamDefaultController" title="The WritableStreamDefaultController interface of the the Streams API represents a controller allowing control of a WritableStream's state. When constructing a WritableStream, the underlying sink is given a corresponding WritableStreamDefaultController instance to manipulate."><code>WritableStreamDefaultController</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/WritableStreamDefaultWriter" title="The WritableStreamDefaultWriter interface of the the Streams API is the object returned by WritableStream.getWriter() and once created locks the < writer to the WritableStream ensuring that no other streams can write to the underlying sink."><code>WritableStreamDefaultWriter</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -</ul> -<span>X</span><ul> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XDomainRequest" title="XDomainRequest is an implementation of HTTP access control (CORS) that worked in Internet Explorer 8 and 9. It was removed in Internet Explorer 10 in favor of using XMLHttpRequest with proper CORS; if you are targeting Internet Explorer 10 or later, or wish to support any other browser, you need to use standard HTTP access control."><code>XDomainRequest</code></a></span><span class="indexListBadges"> <span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XMLDocument" title="The XMLDocument interface represent an XML document. It inherits from the generic Document and does not add any specific methods or properties to it: nevertheless, several algorithms behave differently with the two types of documents."><code>XMLDocument</code></a></span><span class="indexListBadges"> <span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XMLHttpRequest" title="XMLHttpRequest objects to interact with servers. You can retrieve data from a URL without having to do a full page refresh. This enables a Web page to update just part of a page without disrupting what the user is doing."><code>XMLHttpRequest</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XMLHttpRequestEventTarget" title="XMLHttpRequestEventTarget is the interface that describes the event handlers you can implement in an object that will handle events for an XMLHttpRequest."><code>XMLHttpRequestEventTarget</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XMLSerializer" title=""><code>XMLSerializer</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XPathExpression" title="An XPathExpression is a compiled XPath query returned from document.createExpression(). It has a method evaluate() which can be used to execute the compiled XPath."><code>XPathExpression</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XPathResult" title=""><code>XPathResult</code></a></span></span></li> -<li><span class="indexListRow"><span class="indexListTerm"><a href="/fr/docs/Web/API/XSLTProcessor" title="An XSLTProcessor applies an XSLT stylesheet transformation to an XML document to produce a new XML document as output. It has methods to load the XSLT stylesheet, to manipulate <xsl:param> parameter values, and to apply the transformation to documents."><code>XSLTProcessor</code></a></span></span></li> -</ul> - - - - - -</div><p></p> diff --git a/files/fr/archive/b2g_os/api/l10n_api/index.html b/files/fr/archive/b2g_os/api/l10n_api/index.html deleted file mode 100644 index 3b1c9850ed..0000000000 --- a/files/fr/archive/b2g_os/api/l10n_api/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: L10n API -slug: Archive/B2G_OS/API/L10n_API -tags: - - API - - 'API:Mozilla Extensions' - - Aperçu - - Firefox OS - - I10n - - Non-standard - - Reference -translation_of: Archive/B2G_OS/API/L10n_API ---- -<section class="Quick_links" id="Quick_Links"> -<ol> - <li class="toggle"> - <details open><summary>Interfaces</summary> - - <ol> - <li><a href="/en-US/docs/Web/API/L10n"><code>L10n</code></a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details open><summary>Properties</summary> - <ol> - <li><a href="/en-US/docs/Web/API/Navigator/mozL10n"><code>Navigator.mozL10n</code></a></li> - </ol> - </details> - </li> -</ol> -</section> - -<div class="blockIndicator draft"> -<p><strong>Brouillon</strong><br> - Cette page n'est pas complète.</p> -</div> - -<div class="blockIndicator nonStandard nonStandardHeader"> -<p><strong>Non-standard</strong><br> - Cette fonctionnalité ne fait pas partie des standards actuels du W3C, mais elle est prise en charge sur la plate-forme Firefox OS. Bien que les implémentations puissent changer à l'avenir et qu'il ne soit pas largement pris en charge par les navigateurs, il convient pour une utilisation dans du code dédié aux applications Firefox OS.</p> -</div> - - - -<h2 id="Interfaces">Interfaces</h2> - -<div class="index"> -<ul> - <li><a href="/en-US/docs/Web/API/L10n" title="The documentation about this has not yet been written; please consider contributing!"><code>L10n</code></a></li> -</ul> -</div> diff --git a/files/fr/archive/b2g_os/api/navigator/addidleobserver/index.html b/files/fr/archive/b2g_os/api/navigator/addidleobserver/index.html deleted file mode 100644 index 54e7fd998e..0000000000 --- a/files/fr/archive/b2g_os/api/navigator/addidleobserver/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Navigator.addIdleObserver() -slug: Archive/B2G_OS/API/Navigator/addIdleObserver -translation_of: Archive/B2G_OS/API/Navigator/addIdleObserver ---- -<p>{{ non-standard_header() }}</p> -<p>{{ B2GOnlyHeader2('certified') }}</p> -<h2 id="Résumé"><span id="Dst[0][0:6:0:5]">Résumé</span></h2> -<div class="mttextarea" dir="ltr" id="TranslationOutput"> - <div> - <span id="Dst[0][0:3:0:4]">Cette</span><span> </span><span id="Dst[0][5:10:6:12]">méthode</span><span> </span><span id="Dst[0][12:13:14:16]">est</span><span> </span><span id="Dst[0][15:18:18:25]">utilisée</span><span> </span><span id="Dst[0][20:21:27:30]">pour</span><span> </span><span id="Dst[0][23:25:32:38]">ajouter</span><span> </span><span id="Dst[0][27:28:40:41]">un</span><span> </span><span id="Dst[0][30:37:43:53]">observateur</span><span> </span><span id="Dst[0][39:42:55:57]">qui</span><span> </span><span id="Dst[0][44:47:59:60]">va</span><span> </span><span id="Dst[0][49:53:62:69]">vérifier</span><span> </span><span id="Dst[0][55:56:71:72]">si</span><span> </span><span id="Dst[0][62:65:74:86]">l'utilisateur</span><span> </span><span id="Dst[0][67:68:88:90]">est</span><span> </span><span id="Dst[0][70:73:92:98]">inactif</span><span> </span><span id="Dst[0][75:77:100:101]">et</span><span> </span><span id="Dst[0][79:86:103:107]">agira</span><span> </span><span id="Dst[0][88:98:109:122]">en conséquence</span>. Une fois l'observateur ajouté, il est possible de le retirer avec {{domxref("window.navigator.removeIdleObserver","navigator.removeIdleObserver")}}.</div> - <div> - </div> -</div> -<h2 id="Syntaxe">Syntaxe</h2> -<pre>navigator.addIdleObserver(IdleObserver);</pre> -<h3 id="Paramètres"><span id="Dst[0][0:9:0:9]">Paramètres</span></h3> -<dl> - <dt> - <code>IdleObserver</code></dt> - <dd> - <div class="mttextarea" dir="ltr" id="TranslationOutput"> - <div> - Un objet avec des propriétés spécifiques à gérer si l'utilisateur est inactif ou non ; cf {{anch("IdleObserver")}} ci-dessous.</div> - </div> - </dd> -</dl> -<h3 id="IdleObserver">IdleObserver</h3> -<p><code>IdleObserver</code> est un objet contenant les trois propriétés suivantes :</p> -<dl> - <dt> - <code>time</code></dt> - <dd> - Le temps (exprimé en secondes) avant que l'utilisateur soit considéré comme inactif.</dd> - <dt> - <code>onidle</code></dt> - <dd> - Une fonction appelée lorsque l'utilisateur est considéré comme inactif.</dd> - <dt> - <code>onactive</code></dt> - <dd> - Une fonction appelée lorsque l'utilisateur redevient actif.</dd> -</dl> -<h2 id="Exemple">Exemple</h2> -<pre class="brush: js">var myObserver = { - time: 10, - onidle: function () { - console.log("L'utilisateur est inactif depuis 10 secondes"); - }, - onactive: function () { - console.log("L'utilisateur est actif de nouveau"); - } -} - -navigator.addIdleObserver(myObserver); -</pre> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Ne fait encore partie d'aucune spécification ; Toutefois, cette API sera discutée au W3C dans le cadre de la <a href="http://www.w3.org/2012/sysapps/" rel="external" title="http://www.w3.org/2012/sysapps/">System Applications Working Group</a>.</p> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{domxref("window.navigator.removeIdleObserver","navigator.removeIdleObserver")}}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/navigator/index.html b/files/fr/archive/b2g_os/api/navigator/index.html deleted file mode 100644 index c98f922aeb..0000000000 --- a/files/fr/archive/b2g_os/api/navigator/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Navigator (Firefox OS extensions) -slug: Archive/B2G_OS/API/Navigator -tags: - - API - - Firefox OS - - Interface - - Navigator - - Non-standard - - TopicStub -translation_of: Archive/B2G_OS/API/Navigator ---- -<p>L'interface <code><strong>Navigator</strong></code> représente l'état et l'identité de l'agent utilisateur. Il permet aux scripts de l'interroger et de s'enregistrer pour effectuer certaines activités. Cette page représente la liste des propriétés et des méthodes ajoutées à <code>Navigator</code> sur les appareils Firefox OS. Pour obtenir la liste des propriétés des méthodes disponibls sur tous les sites Web, consultez <a href="/fr/docs/Web/API/Navigator" title="L'interface Navigator représente l'état et l'identité de l'agent utilisateur. Elle permet aux scripts de l'interroger et de s'enregister eux-mêmes pour poursuivre certaines tâches."><code>Navigator</code></a>.</p> - -<p>Un objet <code>Navigator</code> peut être récupéré à l'aide de la propriété <a href="/fr/docs/Web/API/Window/navigator" title="Renvoie une référence à l'objet - - navigator - , qui peut être interrogé pour obtenir des informations concernant l'application exécutant le script."><code>Window.navigator</code></a> en lecture seule.</p> - - - -<dl> - <dt class="landingPageList"><a href="/fr/docs/Archive/B2G_OS/API/Navigator/mozApps">window.navigator.mozApps</a></dt> - <dd class="landingPageList">Renvoie un objet <a href="/fr/docs/Web/API/Apps" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Apps</code></a> que vous pouvez utiliser pour installer, gérer et contrôler des <a href="/fr/docs/Applications" title="/fr/docs/Applications">Open Web Apps</a> dans le navigateur.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/api/navigator/mozapps/index.html b/files/fr/archive/b2g_os/api/navigator/mozapps/index.html deleted file mode 100644 index 6b1d9283bc..0000000000 --- a/files/fr/archive/b2g_os/api/navigator/mozapps/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: window.navigator.mozApps -slug: Archive/B2G_OS/API/Navigator/mozApps -tags: - - API Apps - - Apps -translation_of: Archive/B2G_OS/API/Navigator/mozApps ---- -<p>(fr translation)</p> - -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><p></p> - -<h2 id="Summary" name="Summary">Résumé</h2> - -<p>Renvoie un objet <a href="/fr/docs/Web/API/Apps" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Apps</code></a> que vous pouvez utiliser pour installer, gérer et contrôler des <a href="/fr/docs/Applications" title="/fr/docs/Applications">Open Web Apps</a> dans le navigateur.</p> - -<h2 id="Syntax" name="Syntax">Syntaxe</h2> - -<pre class="eval">var <em>apps</em> = window.navigator.mozApps; -</pre> - -<h2 id="Specification" name="Specification">Spécification</h2> - -<p>Ne fait partie d'aucune spécification. Implementé dans Gecko suite au <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=697383" title="FIXED: implement navigator.mozApps">bug 697383</a>.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p></p><p class="warning"><strong><a href="https://github.com/mdn/browser-compat-data">Nous convertissons les données de compatibilité dans un format JSON</a></strong>. - Ce tableau de compatibilité utilise encore l'ancien format - car nous n'avons pas encore converti les données qu'il contient. - <strong><a href="/fr/docs/MDN/Contribute/Structures/Compatibility_tables">Vous pouvez nous aider en contribuant !</a></strong></p> - -<div class="htab"> - <a id="AutoCompatibilityTable" name="AutoCompatibilityTable"></a> - <ul> - <li class="selected"><a>Ordinateur</a></li> - <li><a>Mobile</a></li> - </ul> -</div><p></p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support de base</td> - <td>---</td> - <td><a href="/en-US/Firefox/Releases/11" title="Sorti le 2012-03-13.">11.0</a> (11.0)</td> - <td>---</td> - <td>---</td> - <td>---</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonction</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support de base</td> - <td>---</td> - <td><a href="/en-US/Firefox/Releases/11" title="Sorti le 2012-03-13.">11.0</a> (11.0)</td> - <td>---</td> - <td>---</td> - <td>---</td> - </tr> - </tbody> -</table> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/api/navigator/requestwakelock/index.html b/files/fr/archive/b2g_os/api/navigator/requestwakelock/index.html deleted file mode 100644 index b9cf1367d4..0000000000 --- a/files/fr/archive/b2g_os/api/navigator/requestwakelock/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: window.navigator.requestWakeLock -slug: Archive/B2G_OS/API/Navigator/requestWakeLock -tags: - - B2G - - Firefox OS - - Non Standard - - Power Management - - WebAPI -translation_of: Archive/B2G_OS/API/Navigator/requestWakeLock ---- -<p>{{ non-standard_header() }}</p> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Cette méthode est utilisée pour faire une requête de blocage de mise en veille de n'importe quelle ressource de l'appareil. Elle renvoie un objet {{ anch("MozWakeLock") }} utilisable pour garder une trace ou libérer le verrou de blocage.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="eval">var lock = window.navigator.requestWakeLock(resourceName); -</pre> -<dl> - <dt> - resourceName</dt> - <dd> - Une chaîne de caractères représentant le nom de la ressource à verrouiller. <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a> utilise trois noms de ressources basiques : <code>screen</code>, <code>cpu</code> et <code>wifi.</code> Cependant toute application certifiée peut exposer de nouvelles ressources.</dd> -</dl> -<h2 id="Value" name="Value">Valeur</h2> -<p><code>navigator.requestWakeLock</code> retourne un objet {{anch("MozWakeLock")}} qu'il est nécessaire d'utiliser pour libérer le verrou.</p> -<div class="note"> - <p><strong>Note :</strong> quand la fenêtre qui a requis un ou plusieurs verrou est fermée ou supprimée, tout verrou impliqué est implicitement libéré. Une libération manuelle n'est pas nécessaire.</p> -</div> -<h3 id="MozWakeLock">MozWakeLock</h3> -<pre>interface MozWakeLock -{ - readonly attribute DOMString topic - - void unlock(); -}</pre> -<dl> - <dt> - <code>topic</code></dt> - <dd> - La chaîne de caractères contenant le nom de la ressource à verrouiller.</dd> - <dt> - <code>unlock</code></dt> - <dd> - Une fonction qui doit être appelée pour libérer le verrou. Si plusieurs verrous ont été requis, chacun d'entre eux doit être libéré individuellement.</dd> -</dl> -<div class="note"> - <p><strong>Note :</strong> appeler la méthode<code> unlock </code>sur un verrou déjà libéré lancera une erreur de type : <code>NS_ERROR_DOM_INVALID_STATE_ERR</code>.</p> -</div> -<h2 id="Specification" name="Specification">Exemple</h2> -<pre class="brush: js">var lock = window.navigator.requestWakeLock('screen'); - -window.addEventListener('unload', function () { - lock.unlock(); -});</pre> -<h2 id="Specification" name="Specification">Spécification</h2> -<p>Cette API ne fait partie d'aucune spécification.</p> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li>{{domxref("window.navigator.mozPower","navigator.mozPower")}}</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/nfc_api/index.html b/files/fr/archive/b2g_os/api/nfc_api/index.html deleted file mode 100644 index 8d6e16ffb4..0000000000 --- a/files/fr/archive/b2g_os/api/nfc_api/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: NFC API -slug: Archive/B2G_OS/API/NFC_API -tags: - - API - - Firefox OS - - NFC - - Non-standard - - Reference -translation_of: Archive/B2G_OS/API/NFC_API ---- -<section class="Quick_links" id="Quick_Links"> -<ol> - <li><strong><a href="/en-US/docs/Web/API/NFC_API">API NFC</a></strong></li> - <li data-default-state="open"><a href="#"><strong>Interfaces</strong></a> - <ol> - <li><a href="/en-US/docs/Web/API/MozNDEFRecord"><code>MozNDEFRecord</code></a></li> - <li><a href="/en-US/docs/Web/API/MozNFC"><code>MozNFC</code></a></li> - <li><a href="/en-US/docs/Web/API/MozNFCPeer"><code>MozNFCPeer</code></a></li> - <li><a href="/en-US/docs/Web/API/MozNFCTag"><code>MozNFCTag</code></a></li> - </ol> - </li> - <li data-default-state="open"><a href="#"><strong>Propriétés</strong></a> - <ol> - <li><a href="/en-US/docs/Web/API/Navigator/mozNfc"><code>Navigator.mozNfc</code></a></li> - </ol> - </li> -</ol> -</section> - -<div class="overheadIndicator nonStandard nonStandardHeader"> -<p><strong>Non-standard</strong><br> - Cette fonctionnalité ne fait pas partie des normes actuelles du W3C, mais elle est prise en charge sur la plate-forme Firefox OS. Bien que les implémentations puissent changer à l'avenir et qu'il ne soit pas largement pris en charge par les navigateurs, il convient pour une utilisation dans le code dédié aux applications Firefox OS.</p> -</div> - -<div class="warning"> -<p style="text-align: center;">Cette API est disponible sur <a href="/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">les applications privilégiées ou certifiées</a> uniquement.</p> -</div> - -<div class="summary"> -<p>L'API NFC (Near Field Communication) est utilisée pour échanger des données <span class="tlid-translation translation" lang="fr"><span title="">entre des appareils mobiles compatibles NFC ou des balises NFC en les touchant ensemble.</span></span></p> -</div> - -<h2 id="Présentation">Présentation</h2> - -<p>Vous accédez à l'ensemble des fonctionnalités NFC via la propriété <a href="/en-US/docs/Web/API/Navigator/mozNfc" title="The documentation about this has not yet been written; please consider contributing!"><code>Navigator.mozNfc</code></a> , ce qui vous permet de retourner un objet <a href="/en-US/docs/Web/API/MozNFC" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFC</code></a> sur lequel vous pouvez effectuer d'autres opérations.</p> - -<h3 id="Permissions">Permissions</h3> - -<p>Les applications privilégiées qui souhaitent utiliser l'API NFC doivent demander l'autorisation NFC dans leur manifeste d'application. Firefox 2.2+ permet l'utilisation de la technologie NFC dans des applications privilégiées. Pour les versions anterieures, il n'est disponible que pour les applications certifiées.</p> - -<pre class="brush: json">"permission": { - "nfc":{} -}</pre> - -<p>L'API NFC prend en charge trois modes d'opération définis dans le forum NFC.</p> - -<h4 id="Mode_LectureÉcriture">Mode Lecture/Écriture</h4> - -<p>Ce mode peut être utilisé pour lire / écrire des balises NFC via l'interface <a href="/en-US/docs/Web/API/MozNFCTag" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCTag</code></a> à l'aide de <a href="/en-US/docs/Web/API/MozNDEFRecord" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNDEFRecord</code></a>, ou pour communiquer avec la balise NFC en envoyant / recevant une commande APDU.</p> - -<h4 id="Mode_Pair_à_Pair">Mode Pair à Pair</h4> - -<p>Ce mode est utilisé pour partager du contenu avec un autre périphérique NFC via l'interface <a href="/en-US/docs/Web/API/MozNFCPeer" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCPeer</code></a> .</p> - -<h4 id="Card_Emulation_Mode">Card Emulation Mode</h4> - -<p>Ce mode permet d'émuler le périphérique NFC en tant que balise NFC. Ce mode est principalement utilisé dans les paiements NFC.</p> - -<p>À partir de Firefox OS v2.2, seulement Secure Element-based Card Emulation est supporté.</p> - -<h3 id="Enregistrement_NDEF">Enregistrement NDEF</h3> - -<p>NDEF (NFC Data Exchange Format) est le format de données commun défini dans le forum NFC. En utilisant NDEF, une application peut oppérer sur <a href="/en-US/docs/Web/API/MozNFCTag" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCTag</code></a> si la balise est compatible avec NFC Forum Tag, ou peut échanger des données avec <a href="/en-US/docs/Web/API/MozNFCPeer" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCPeer</code></a>.</p> - -<p>En savoir plus : <a href="/en-US/docs/Web/API/MozNDEFRecord" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNDEFRecord</code></a>.</p> - -<h3 id="Event_Dispatching">Event Dispatching </h3> - -<p>Pour les événements NFC Tag ou NFC Peer, la priorité est d’envoyer d’abord ces événements à l’application de premier plan (décidé par l’application Système). Si l'application de premier plan ne peut pas traiter l'événement, l'événement sera à nouveau redistribué vers l'application System. L'application System lancera les applications en appelant MozActivity.</p> - -<p>Vous pouvez trouver plus de détails sur l’utilisation de NFC dans Firefox OS dans <a href="/en-US/docs/Web/API/NFC_API/Using_the_NFC_API">Utiliser l'API NFC</a>.</p> - -<h2 id="Interfaces_NFC">Interfaces NFC</h2> - -<dl> - <dt><a href="/en-US/docs/Web/API/MozNDEFRecord" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNDEFRecord</code></a></dt> - <dd>Structure NDEF (NFC Data Exchange Format) pour les données liées à NFC.</dd> - <dt><a href="/en-US/docs/Web/API/MozNFC" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFC</code></a></dt> - <dd>Objet Navigateur haut niveau pour les opérations NFC.</dd> - <dt><a href="/en-US/docs/Web/API/MozNFCTag" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCTag</code></a></dt> - <dd>Objet NFC utilisé pour manipuler des données sur des balises.</dd> -</dl> - -<dl> - <dt><a href="/en-US/docs/Web/API/MozNFCPeer" title="The documentation about this has not yet been written; please consider contributing!"><code>MozNFCPeer</code></a></dt> - <dd>Objet NFC utilisé pour manipuler des données sur des périphériques.</dd> -</dl> - -<h2 id="Caractéristiques">Caractéristiques</h2> - -<p>L'implémentation NFC dans Gecko suit les <a href="http://members.nfc-forum.org/specs/">caracteristiques du Forum NFC</a>.</p> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilité</h2> - -<p>Supporté dans Firefox OS 1.0.<br> - Disponible dans les applications privilégiées à partir de Firefox OS 2.2.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/NFC_API/Using_the_NFC_API">Utiliser l'API NFC</a></li> - <li><a href="/en-US/docs/Web/API/NFC_API/Using_the_NFC_emulator">Utiliser l'émulateur NFC</a></li> - <li><a href="http://developer.nokia.com/community/wiki/Inside_NFC:_Understanding_NDEF_message">Comprendre la structure des messages NDEF</a></li> - <li><a href="http://www.adafruit.com/datasheets/Introduction_to_NFC_v1_0_en.pdf">Introduction à NFC</a> (référence assez longue, contenant les termes généraux de la NFC et certaines spécificités de la plate-forme Nokia.)</li> -</ul> - -<section id="Quick_Links"></section> diff --git a/files/fr/archive/b2g_os/api/udpsocket/index.html b/files/fr/archive/b2g_os/api/udpsocket/index.html deleted file mode 100644 index b9ade8c1c7..0000000000 --- a/files/fr/archive/b2g_os/api/udpsocket/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: UDPSocket -slug: Archive/B2G_OS/API/UDPSocket -translation_of: Archive/B2G_OS/API/UDPSocket ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Archive"><code>Archive</code></a></strong></li><li class="toggle"><details open><summary>Pages liées à Firefox OS</summary><ol><li><a href="/fr/docs/Web/API/MozAlarmsManager"><code>MozAlarmsManager</code></a></li><li><a href="/fr/docs/Web/API/MozMobileNetworkInfo"><code>MozMobileNetworkInfo</code></a></li><li><a href="/fr/docs/Web/API/MozWifiP2pGroupOwner"><code>MozWifiP2pGroupOwner</code></a></li></ol></details></li></ol></section><p></p> - -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><p></p> - -<p></p><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications privilégiées ou certifiées</a> seulement.</p> -</div><p></p> - -<h2 id="Exemple_d'appel_de_l'API">Exemple d'appel de l'API</h2> - -<pre class="brush: js">var SSDP_PORT = 1900; -var SSDP_ADDRESS = "239.255.255.250"; -var SSDP_DISCOVER_MX = 2; -var SEARCH_TARGET = "urn:schemas-upnp-org:service:ContentDirectory:1"; - -var SSDP_DISCOVER_PACKET = - "M-SEARCH * HTTP/1.1\r\n" + - "HOST: " + SSDP_ADDRESS + ":" + SSDP_PORT + "\r\n" + - "MAN: \"ssdp:discover\"\r\n" + - "MX: " + SSDP_DISCOVER_MX + "\r\n" + - "ST: " + SEARCH_TARGET + "\r\n" + - "\r\n"; - -var searchSocket = new UDPSocket({ - loopback: true -}); - -searchSocket.joinMulticastGroup(SSDP_ADDRESS); - -searchSocket.onmessage = function (e) { - - var msg = String.fromCharCode.apply(null, new Uint8Array(e.data)); - - console.log(msg); -}; - -searchSocket.opened.then(function() { - - searchSocket.send(SSDP_DISCOVER_PACKET, SSDP_ADDRESS, SSDP_PORT); - - setTimeout(function () { searchSocket.close(); }, SSDP_DISCOVER_MX * 1000); -});</pre> - -<h2 id="Exemple_de_manifeste">Exemple de manifeste</h2> - -<pre class="brush: json">{ - "name": "My App", - "launch_path": "/index.html", - "icons": { - }, - "developer": { - }, - "type": "privileged", - "permissions": { - "udp-socket": { "description": "Required to do any UDP" } - }, - "default_locale": "en" -}</pre> diff --git a/files/fr/archive/b2g_os/api/wake_lock_api/index.html b/files/fr/archive/b2g_os/api/wake_lock_api/index.html deleted file mode 100644 index 122d994ab9..0000000000 --- a/files/fr/archive/b2g_os/api/wake_lock_api/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Wake Lock API -slug: Archive/B2G_OS/API/Wake_Lock_API -tags: - - Firefox OS - - Non-standard - - Overview - - TopicStub - - Wake Lock API -translation_of: Archive/B2G_OS/API/Wake_Lock_API ---- -<section class="Quick_links" id="Quick_Links"> -<ol> - <li><strong><a href="/fr/docs/Web/API/Wake_Lock_API">Wake Lock API</a></strong></li> - <li class="toggle"> - <details open><summary>Interfaces</summary> - <ol> - <li><a href="/fr/docs/Web/API/MozWakeLock"><code>MozWakeLock</code></a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details open><summary>Méthodes</summary> - <ol> - <li><a href="/fr/docs/Web/API/Navigator/requestWakeLock"><code>Navigator.requestWakeLock()</code></a></li> - </ol> - </details> - </li> -</ol> -</section> - -<div class="overheadIndicator nonStandard nonStandardHeader"> -<p><strong>Non standard</strong><br> - Cette fonctionnalité n'est pas en voie de standardisation au W3C, mais elle est supportée par la plateforme Firefox OS. Bien que son implémentation puisse changer dans le futur et qu'elle n'est pas largement supportée par les différents navigateurs, elle est utilisable pour du code dédié aux applications Firefox OS.</p> -</div> - - - -<p>L' <strong>API Wake Lock</strong> permet de verrouiller n'importe quelle ressource de l'appareil. Cela signifie que vous pouvez empêcher cette ressource de devenir indisponible tant que votre application détient un verrou pour cette ressource. Par exemple, une application d'enregistrement vocal peut obtenir un verrouillage pour garder l'écran allumé pendant l'enregistrement afin de pouvoir donner à l'utilisateur un retour visuel prouveur indiquant que l'enregistrement est en cours.</p> - -<p><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a> utilise trois noms de ressources de base qui peuvent être utilisés comme <code>sujet</code>: <code>écran</code>, <code>cpu</code>, et <code>wifi</code>, mais toute application certifié peut exposer de nouvelles ressources.</p> - -<h2 id="Références">Références</h2> - -<dl> - <dt><a href="/fr/docs/Web/API/Navigator/requestWakeLock" title="Cette méthode est utilisée pour faire une requête de blocage de mise en veille de n'importe quelle ressource de l'appareil. Elle renvoie un objet MozWakeLock utilisable pour garder une trace ou libérer le verrou de blocage."><code>Navigator.requestWakeLock()</code></a></dt> - <dd>Verrouillez une ressource.</dd> - <dt><a href="/fr/docs/Web/API/MozWakeLock" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozWakeLock</code></a></dt> - <dd>Interface représentant une serrure et permettant de les gérer, en en gardant une trace, et en donnant la possibilité de la libérer.</dd> -</dl> - -<h2 id="Exemple">Exemple</h2> - -<h3 id="Specification" name="Specification">Garder l'écran allumé</h3> - -<p>Toute application peut choisir de garder l'écran allumé pendant son exécution. Pour ce faire, l'application doit obtenir un verrou pour la ressource écran lorsqu'elle est initialisée.</p> - -<pre class="brush: js notranslate">var lock = window.navigator.requestWakeLock('screen'); -</pre> - -<p>Les développeurs d'applications doivent être responsables et réfléchir soigneusement à la question de savoir s'ils doivent garder l'écran allumé. Le risque de réclamer le verrou est que les utilisateurs peuvent oublier de fermer l'application lorsqu'ils ont fini de l'utiliser, ce qui peut entraîner une augmentation significative de l'utilisation de la batterie. Si vous n'êtes pas certain que l'obtention du verrouillage de l'écran ait du sens dans tous les scénarios, il serait judicieux de fournir l'option d'activer ou de désactiver l'option de verrouillage d'écran dans les paramètres de l'application.</p> - -<p>Si vous ne relâchez pas du tout le verrouillage de l'écran, il sera à nouveau obtenu à partir de votre application lorsqu'il passe en arrière-plan ou lorsque l'application se termine. Cependant, il existe certains scénarios où vous devez libérer vous-même le verrouillage de l'écran, par exemple lorsque l'utilisateur désactive l'option dans les paramètres ou lorsque l'application n'exécute pas la tâche qui nécessitait que l'écran reste allumé. Dans ces scénarios, il vous suffit d'appeler la méthode unlock() pour libérer le verrou.</p> - -<pre class="brush: js notranslate">lock.unlock();</pre> - -<p>Le verrouillage de réveil de l'écran est actuellement disponible pour les applications hébergées et packagées exécutées sur la plate-forme Firefox OS.</p> - -<h2 id="Specification" name="Specification">Spécification</h2> - -<p>Ne fait partie d'aucune spécification</p> - -<h2 id="Voir_également">Voir également</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Navigator/mozPower" title="Retourne un objet PowerManager que vous pouvez utiliser pour gérer la consommation energétique de l'appareil."><code>Navigator.mozPower</code></a></li> -</ul> diff --git a/files/fr/archive/b2g_os/api/wake_lock_api/keeping_the_geolocation_on_when_the_application_is_invisible/index.html b/files/fr/archive/b2g_os/api/wake_lock_api/keeping_the_geolocation_on_when_the_application_is_invisible/index.html deleted file mode 100644 index f6ffe5ed9d..0000000000 --- a/files/fr/archive/b2g_os/api/wake_lock_api/keeping_the_geolocation_on_when_the_application_is_invisible/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Garder la main sur la géolocalisation même si l'application n'est plus visible -slug: >- - Archive/B2G_OS/API/Wake_Lock_API/Keeping_the_geolocation_on_when_the_application_is_invisible -tags: - - Firefox OS - - Guide - - Non-standard - - Wake Lock API - - Web -translation_of: >- - Archive/B2G_OS/API/Wake_Lock_API/Keeping_the_geolocation_on_when_the_application_is_invisible ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Wake_Lock_API">Wake Lock API</a></strong></li><li class="toggle"><details open><summary>Interfaces</summary><ol><li><a href="/fr/docs/Web/API/MozWakeLock"><code>MozWakeLock</code></a></li></ol></details></li><li class="toggle"><details open><summary>Méthodes</summary><ol><li><a href="/fr/docs/Web/API/Navigator/requestWakeLock"><code>Navigator.requestWakeLock()</code></a></li></ol></details></li></ol></section><p></p> - -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est pas en voie de standardisation au W3C, mais elle est supportée par la plateforme Firefox OS. Bien que son implémentation puisse changer dans le futur et qu'elle n'est pas largement supportée par les différents navigateurs, elle est utilisable pour du code dédié aux applications Firefox OS.</p> - </div><p></p> - -<p></p><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications internes</a> seulement.</p> -</div><p></p> - -<p>Une application Firefox OS peut continuer à utiliser le service de géolocalisation alors même qu'elle n'est plus visible. Ceci peut être obtenu via un appel à <a href="/fr/docs/Web/API/MozWakeLock" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozWakeLock</code></a> conjointement avec <a href="/fr/docs/Web/API/Geolocation/watchPosition" title="La méthode Geolocation.watchPosition() permet de manipuler une fonction appelée automatiquement à chaque fois que la position de l'appareil change. Vous pouvez de même, en option, manipuler une autre fonction appelée automatiquement pour gérer les erreurs."><code>watchPosition()</code></a> de cette façon, l'application pourra continuer à utiliser le GPS bien que n'étant plus au premier plan.</p> - -<div class="note"> -<p>Toute application désirant conserver l'accès au service de géolocalisation alors que l'écran est éteint ou que cette application se retrouve en arrière plan, doit obtenir un verrou spécial avant de ne plus être visible.</p> -</div> - -<p>Pour obtenir un tel verrou, il suffit d'appeler la méthode <a href="/fr/docs/Web/API/Navigator/requestWakeLock" title="Cette méthode est utilisée pour faire une requête de blocage de mise en veille de n'importe quelle ressource de l'appareil. Elle renvoie un objet MozWakeLock utilisable pour garder une trace ou libérer le verrou de blocage."><code>Navigator.requestWakeLock()</code></a> avec l'argument <code>'gps'</code>.</p> - -<pre class="brush: js">var lock = window.navigator.requestWakeLock('gps'); -</pre> - -<p>Ici, les développeurs d'applications portent une lourde responsabilté. Ils doivent être certains des raisons pour lesquelles ils ont besoin du service de géolocalisation et surtout savoir quand l'arrêter. Le risque, avec ce verrou, vient de ce que les utilisateurs de votre application peuvent très bien oublier de fermer l'appli lorsqu'ils ont fini de l'utiliser - ce qui se soldera par une diminution importante de la charge de la batterie, inutilement. Si vous n'êtes pas certain à 100 % que l'obtention d'un verrou de géolocalisation est gérable dans tous les cas de figure, alors vous devez proposer une option pour activer ou désactiver ce<em> verrou de géolocalisation </em>dans les paramètres de votre appli.</p> - -<p>Si vous ne libérez pas du tout votre <em>verrou de géolocalisation</em>, il sera automatiquement libéré lorsque votre appli se terminera. Cependant il y a de nombreux cas où vous pouvez libérer ce verrou vous-même - notamment lorsque l'utilisateur désactive cette option dans vos paramètres applicatifs, ou encore lorsque votre appli ne requiert plus d'utiliser la géolocalisation. Pour libérer le verrou, vous appelez <a href="/fr/docs/Web/API/Lock/unlock" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>unlock()</code></a> qui est la méthode prévue :</p> - -<pre class="brush: js">lock.unlock();</pre> - -<p>Les verrous de géolocalisation sont disponibles, à la fois dans les applis hébergées et les applis packagées - au sens de la plateforme Firefox.</p> - -<h2 id="Example">Example</h2> - -<pre class="brush: js">var id, target, options; -<strong>var wakeLock; -</strong> -function success(pos) { - var crd = pos.coords; - - if (target.latitude === crd.latitude && target.longitude === crd.longitude) { - console.log('Congratulations, you reached the target'); - navigator.geolocation.clearWatch(id); - <strong>wakeLock.unlock();</strong> - } -} - -function error(err) { - console.warn('ERROR(' + err.code + '): ' + err.message); -} - -target = { - latitude : 0, - longitude: 0 -}; - -options = { - enableHighAccuracy: false, - timeout: 5000, - maximumAge: 0 -}; - -<strong>wakeLock = window.navigator.requestWakeLock('gps');</strong> -id = navigator.geolocation.watchPosition(success, error, options); -</pre> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Navigator/requestWakeLock" title="Cette méthode est utilisée pour faire une requête de blocage de mise en veille de n'importe quelle ressource de l'appareil. Elle renvoie un objet MozWakeLock utilisable pour garder une trace ou libérer le verrou de blocage."><code>Navigator.requestWakeLock()</code></a>, pour poser un verrou sur une ressource.</li> - <li><a href="/fr/docs/Web/API/MozWakeLock" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozWakeLock</code></a>, l'interface représentant un verrou et permettant sa gestion, depuis sa création en passant par sa conservation en mémoire, et pour finir en le libérant.</li> -</ul> diff --git a/files/fr/archive/b2g_os/api/window/index.html b/files/fr/archive/b2g_os/api/window/index.html deleted file mode 100644 index b4383e7590..0000000000 --- a/files/fr/archive/b2g_os/api/window/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Window (extensions Firefox OS) -slug: Archive/B2G_OS/API/Window -tags: - - API - - Firefox OS - - Interface - - Navigator - - Non-standard -translation_of: Archive/B2G_OS/API/Window ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Mozilla/Firefox_OS/API/Archive"><code>Archive</code></a></strong></li></ol></section><p></p> - -<p>L'interface <code>Window</code> représente une fenêtre contenant un document DOM. Cette page expose la liste des propriétés et méthodes ajoutées à <code>Window</code> sur les appareils Firefox OS. Pour la liste des propriétés et méthodes disponibles pour tous les sites Web, consultez <a href="/fr/docs/Web/API/Window" title="L'objet window représente une fenêtre contenant un document DOM ; la propriété document pointe vers le document DOM chargé dans cette fenêtre."><code>Window</code></a>.</p> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt><a href="/fr/docs/Web/API/Window/onmoztimechange" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Window.onmoztimechange</code></a><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span></dt> - <dd>Contient le gestionnaire d'événement à appeler lorsque l'événement <code>moztimechange</code> est envoyé.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em>Il n'y a aucune méthode spécifique à Firefox OS pour l'interface <code>Window</code>.</em></p> diff --git a/files/fr/archive/b2g_os/automated_testing/configurer_marionette/index.html b/files/fr/archive/b2g_os/automated_testing/configurer_marionette/index.html deleted file mode 100644 index 8ae67abda9..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/configurer_marionette/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Configurer Marionette pour Firefox OS -slug: Archive/B2G_OS/Automated_testing/Configurer_Marionette -tags: - - Firefox OS - - Guide -translation_of: 'https://marionette-client.readthedocs.io/en/latest/' ---- -<h2 id="Configurer_le_client_Marionette">Configurer le client Marionette</h2> - -<p>Le client Marionette est un package Python avec lequel vous pouvez exécuter des tests Marionette : à la fois des tests Python et des tests de WebAPI JavaScript. Vous allez avoir besoin de configurer ceci sur votre machine avant de pouvoir l'utiliser.</p> - -<p>Pour y parvenir, vous devez cloner un arbre Gecko ; soit l'arbre Gecko dans un clone Firefox OS, soit un clone Gecko autonome (par exemple, <a href="http://hg.mozilla.org/mozilla-central/" title="http://hg.mozilla.org/mozilla-central/">mozilla-central</a>). Par exemple, supposons que c'est la première fois que vous clonez un arbre Gecko :</p> - -<p>Installez tout d'abord Mercurial, si ce n'est déjà fait. Voici comment vous pouvez faire sur Mac si vous avez Homebrew d'installé. Les autres gestionnaires de package seront différents :</p> - -<p><code>$ brew install mercurial</code></p> - -<p>Déplacez-vous dans votre répertoire de travail (par exemple ~/code) et tapez la ligne suivante pour commencer le processus de clonage :</p> - -<p><code>$ hg clone http://hg.mozilla.org/mozilla-central/ $GECKO_DIR</code></p> - -<p>... où $GECKO_DIR peut être n'importe quel nom valide de répertoire, par exemple <code>mozilla-central</code>. Cette étape va prendre un peu de temps (environ 10 minutes avec une connexion rapide).</p> - -<p>Voir assi <a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">Compiler et installer Firefox OS</a> pour plus de détails sur la façon de configurer un environnement de compilation Firefox OS et faire un <em>pull</em> du code.</p> - -<pre>$ cd $GECKO_DIR/testing/marionette/client - -$ python setup.py develop</pre> - -<p>Il est recommandé d'utiliser un environnement virtuel <a href="/en-US/docs/Python/Virtualenv" title="/en-US/docs/Python/Virtualenv">virtualenv</a>. Configuration rapide de virtualenv :</p> - -<p><code>$ pip install virtualenv</code></p> - -<p><code>$ virtualenv $MARIONETTE_ENV</code></p> - -<p>Encore une fois, <code>$MARIONETTE_ENV</code> peut être n'importe quel nom valide de répertoire. Maintenant vous devriez être capable d'exécuter les étapes ci-dessus mais dans le nouvel environnement avec :</p> - -<pre>$ cd $GECKO_DIR/testing/marionette/client - -$ $MARIONETTE_ENV/bin/python setup.py develop</pre> - -<p>Pour vérifier que Marionette est installé :</p> - -<pre>$ $MARIONETTE_ENV/bin/python ->>> from marionette import Marionette</pre> - -<p>Voir aussi <a href="/en-US/docs/Marionette/Running_Tests" title="/en-US/docs/Marionette/Running_Tests">Exécuter des tests Marionette</a> pour plus d'informations sur la façon d'exécuter des tests après avoir configuré Marionette.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/endurance/index.html b/files/fr/archive/b2g_os/automated_testing/endurance/index.html deleted file mode 100644 index dc39c6ae1d..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/endurance/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Endurance tests -slug: Archive/B2G_OS/Automated_testing/Endurance -translation_of: Archive/B2G_OS/Automated_testing/Endurance ---- -<div class="warning"> -<p><strong>Important</strong>:<strong> </strong>Les tests d'endurance Gaia-ui ne sont plus utilisés - voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1117144" title="FIXED: Remove gaia-ui endurance tests">bug 1117144</a> - cette page est maintenu seulement pour la valeur historique. Vous devriez regarder nos <a href="https://developer.mozilla.org/en-US/Firefox_OS/Automated_testing/MTBF_tests">tests MTBF</a> place.</p> -</div> - -<div class="summary"> -<p>Le but de nos tests d'endurance est de vérifier Firefox OS et la stabilité de l'application Gaia et de détecter des fuites de mémoire, en effectuant de multiples itérations de cas d'utilisation communes. Les tests d'endurance Gaia-IU sont en cours d'exécution dans l'ombre, tandis que d'autres types de tests d'endurance sont actuellement en développement (et seront ajoutés ici quand ils serontt mis en ligne). Cet article explique comment ces tests fonctionnent, et comment les exécuter.</p> -</div> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Les tests d'endurance Gaia-IU sont une suite de tests de Firefox OS construits au-dessus du cadre <a href="https://developer.mozilla.org/en-US/Firefox_OS/Automated_testing/gaia-ui-tests">Gaiatest (Tests de l'IU Gaia)</a>. Les tests s'exécutent sur de vrais dispositifs de Firefox OS, et utilisent <a href="https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette">Marionette </a>pour conduire l'IU de l'appareil.</span></span></p> - -<p>Comme mentionné ci-dessus, les tests d'endurance Gaia-IU vérifie le dispositif Firefox OS et la stabilité de l'application Gaia en effectuant plusieurs itérations de cas d'utilisation communes. Des exemples de ces cas d'utilisation comprennent l'ajout d'un contact dans le carnet d'adresses, d'ajouter un événement au calendrier, l'envoi d'un message SMS, ouvrant le navigateur Firefox et la navigation sur un site spécifique.</p> - -<p>As well as verifying Gaia application functionality under numerous iterations, the endurance tests also perform device-side "checkpoints" after every <em>N</em> number of iterations. This checkpoint currently consists of recording the device’s B2G process RSS memory use value. By logging these results over time and comparing them across commits and builds, we can to detect any sudden changes in B2G memory consumption that may occur during the various test scenarios.</p> - -<h2 id="Running_the_tests">Running the tests</h2> - -<div class="note"> -<p><strong>Note</strong>: The Gaia-UI Endurance tests and framework source code can be found in the "v1-train" branch of the <a href="https://github.com/mozilla-b2g/gaia/tree/v1-train/tests/python/gaia-ui-tests/gaiatest/tests/endurance" title="https://github.com/mozilla-b2g/gaia/tree/v1-train/tests/python/gaia-ui-tests/gaiatest/tests/endurance">Mozilla Github Gaia repository</a>.</p> -</div> - -<p>Let's go through the steps required to set up the Gaia-UI Endurance test environment and run the tests on your local machine and Firefox OS device.</p> - -<div class="warning"> -<p><strong>WARNING: Running the Gaia-UI Endurance Tests will result in data being ERASED from the Firefox OS device, including data on the device’s microSD card</strong>. Therefore, if there is any data on your Firefox OS device and microSD card that you wish to keep, be sure to back it up first before running the Gaia-UI Endurance Tests. Consider yourself warned!</p> -</div> - -<h3 id="Prerequisites">Prerequisites</h3> - -<ul> - <li>Ubuntu 12.04 (or better) x64, or Mac OS X (these instructions are confirmed for 10.8 but should work on previous versions of 10, theoretically.)</li> - <li>A Firefox OS device ALREADY FLASHED with an ENGINEERING build of Firefox OS B2G. As the Endurance tests are underpinned by the well maintained gaiatest, compatibility with a range of devices and branches is good.</li> - <li><a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB installed</a>, and the environment variable <code>ADB_PATH</code> pointing to your ADB location.</li> -</ul> - -<p>If you are on Ubuntu, you need to check that it is configured to support the USB connection to the Firefox OS device. To verify this, connect the device to your computer via USB, open a terminal and enter the <code>adb logcat</code> command to see if it connects.</p> - -<div class="note"> -<p><strong>Note</strong>: To start with, the Firefox OS device should not be connected to your computer. You will be told when to connect it in the steps below.</p> -</div> - -<h3 id="Step_1_Clone_the_Gaia_repository">Step 1: Clone the Gaia repository</h3> - -<p>The Gaia-UI Endurance Tests are located in the Mozilla Github Gaia repository. Assuming that you haven’t done so already, the first step is to clone that repo:</p> - -<pre>git clone <a href="https://github.com/mozilla-b2g/gaia.git" rel="nofollow">https://github.com/mozilla-b2g/gaia.git</a></pre> - -<p>You may want to go grab a coffee and come back in five minutes.</p> - -<h3 id="Step_2_Run_the_GaiaTest_setup">Step 2: Run the GaiaTest setup</h3> - -<p>The Gaia-UI Endurance tests are built upon the GaiaTest framework (which uses <a href="https://developer.mozilla.org/en-US/docs/Marionette" title="Marionette">Marionette</a>). The next step is to run the setup script to install GaiaTest and all of the required dependencies. You may wish to create a new virtual environment to use with the Gaia-UI Endurance Tests. If you don’t, you may need to use <code>sudo</code> while running the setup command. In your terminal, type:</p> - -<pre style="padding-left: 30px;">cd gaia/tests/python/gaia-ui-tests -python setup.py develop</pre> - -<h3 id="Step_3_Set_test_vars_and_acknowledge_risks">Step 3: Set test vars and acknowledge risks</h3> - -<p>GaiaTest uses a special file to set certain variables that are required for test configuration. For example, to tell the device which WiFi network it should use. Before running the Gaia-UI Endurance Tests, you must setup the test vars file. Make a copy of the <code>gaia/tests/python/gaia-ui-tests/gaiatest/testvars_template.json</code> file in the same location (call it what you like) and edit it:</p> - -<ul> - <li>If the Firefox OS device has a SIM card, add the corresponding phone number in the phone number entry in the <code>carrier</code> section, e.g. <code>"phone_number": "5551234567"</code>.</li> - <li>Add the same phone number for the <code>"remote_phone_number"</code> entry.</li> - <li>In the <code>wifi</code> section, add the SSID for the Wifi network that the Firefox OS device is to connect to during the tests in the <code>ssid</code> line, for example <code>"ssid": "Wifi Network Name"</code>.</li> -</ul> - -<p>As mentioned in the warning above, running the Gaia-UI Endurance tests will result in data being erased from the Firefox OS device and microSD card. This is to ensure that the tests start cleanly each time. For example, running a test on a device that already has 10,000 contacts will have very different memory value results vs running the same test on a device with no existing contacts. In order to run the tests, you must acknowledge that you are aware of this data loss risk.</p> - -<p>To acknowledge the risks, add the following entry to your <code>testvars</code> file as the first entry in the list: <code>"acknowledged_risks": true</code>.</p> - -<div class="note"> -<p><strong>Note</strong>: If the risks are not acknowledged in the <code>testvars</code> file, the tests will not run.</p> -</div> - -<h3 id="Step_4_Connect_the_device_to_WiFi">Step 4: Connect the device to WiFi</h3> - -<p>Next, power on your Firefox OS device. After it boots up, go into the Wifi settings then manually select and connect to the Wifi network that you want the device to use for the tests. Ensure the Wifi settings confirm that the device is connected to Wifi before continuing.</p> - -<h3 id="Step_5_Connect_to_USB_and_ADB_Forward_the_Device">Step 5: Connect to USB and ADB Forward the Device</h3> - -<p>Attach the Firefox OS device to your computer via USB.</p> - -<div class="note"> -<p><strong>Note</strong>: If you’re using an Ubuntu VM, after attaching the device ensure the VM sees the device and connects to it; in the VM select <em>VM > Removable Devices > Your Device > Connect</em> and wait for the device to connect to the VM.</p> -</div> - -<p>Now tell <code>adb</code> to forward the device port to GaiaTest using the following command:</p> - -<pre class="brush: bash" style="padding-left: 30px;">adb forward tcp:2828 tcp:2828</pre> - -<div class="note"> -<p><strong>Note</strong>: If you are using the Firefox OS Leo device, you must first tell ADB to be the root user, like so:</p> - -<pre style="padding-left: 30px;">adb root -adb forward tcp:2828 tcp:2828</pre> -</div> - -<h3 id="Step_6_Run_a_Test">Step 6: Run a Test</h3> - -<p>Now you’re ready to actually try running a test. To run the <code>add_contact</code> endurance test, with a single iteration, use the following commands:</p> - -<pre class="brush: bash" style="padding-left: 30px;">cd gaia/tests/python/gaia-ui-tests -gaiatest --type=b2g --address=localhost:2828 --testvars=mytestvars.json --iterations=1 --checkpoint=1 --restart gaiatest/tests/endurance/test_endurance_add_contact.py</pre> - -<p>If you get a “connection refused” error it means the device USB connection didn’t work; just repeat the device connection and try again.</p> - -<p>The Firefox OS device b2g process should now restart, then the <code>add_contact</code> endurance test will run with a single iteration. If you watch the Firefox OS device, you’ll see the device UI being manipulated by Marionette. After the test finishes, a memory checkpoint will be performed.</p> - -<div class="note"> -<p><strong>Note</strong>: The Gaia-UI Endurance tests now grab the Firefox OS device’s b2g process RSS value for the memory use checkpoint (it used to be the V-SIZE value.)</p> -</div> - -<p>The test result will be displayed in the terminal window. Note that this result doesn’t include the b2g process memory value; this value is stored in a text file that was created at the time of the checkpoint in the <code>checkpoints</code> directory. To see the resulting b2g process, open this file. This "suite_summary" file will contain the average b2g process memory use (RSS) value, averaged from all of the test checkpoints (in our example there was only one checkpoint anyway).</p> - -<p>There are two other files present in the <code>checkpoints</code> folder:</p> - -<ul> - <li>The <code>checkpoint_add_contact_(datetime)_summary.log</code> file contains a summary for the test run. This includes the number of iterations, all of the RSS value readings from each checkpoint, the average RSS value, etc.</li> - <li>The <code>checkpoint_add_contact_(datetime).log</code> file contains the raw data received from each of the device checkpoints, from which the summary files were produced.</li> -</ul> - -<h3 id="Command_Line_Options">Command Line Options</h3> - -<p>Here is a description of the GaiaTest command line options that you can use when running the Gaia-UI Endurance Test(s):</p> - -<ul> - <li style="padding-left: 30px;"><code>--type</code>: The type of test being run; always use <code>--type=b2g</code> for this.</li> - <li style="padding-left: 30px;"><code>--address</code>: The address where the device port is forwarded, when you issued the ADB forward command; just use <code>--address=localhost:2828</code>.</li> - <li style="padding-left: 30px;"><code>--testvars</code>: The path and name of the file containing the test vars, as described in Step 3 above.</li> - <li style="padding-left: 30px;"><code>--iterations</code>: The number of times to repeat each test case/test; i.e. 100 iterations of the <code>add_contact</code> test will result in 100 new address book entries being added.</li> - <li style="padding-left: 30px;"><code>--checkpoints</code>: After every <em>N</em> iterations a b2g process memory checkpoint will be grabbed from the device; by default a checkpoint will be performed after all iterations are complete.</li> - <li style="padding-left: 30px;"><code>--restart</code>: The Firefox OS device’s b2g process will be restarted before each new test (not each iteration) begins (i.e. a soft reset.)</li> -</ul> - -<p>As an example, to run the <code>add_contact</code> test and have it perform 100 test case iterations, grabbing a device memory checkpoint after every 10 iterations, and restarting the b2g process before the test begins, you would use the following command line:</p> - -<pre class="brush: bash" style="padding-left: 30px;">gaiatest --type=b2g --address=localhost:2828 --testvars=mytestvars.json --iterations=100 --checkpoint=10 --restart gaiatest/tests/endurance/test_endurance_add_contact.py</pre> - -<p>If you wish to run the entire Gaia-UI Endurance test suite, instead of specifying a single test on the command line, just point to the manifest file for the test name, like this:</p> - -<pre class="brush: bash" style="padding-left: 30px;">gaiatest --type=b2g --address=localhost:2828 --testvars=mytestvars.json --iterations=1 --checkpoint=1 --restart gaiatest/tests/endurance/manifest.ini</pre> - -<p>However, note that running the entire test suite, with 100 iterations of each test (and a checkpoint after every 10 iterations) takes approximately 16 hours.</p> - -<p>Now you should be all set and have the Gaia-UI Endurance Tests up and running on your local machine/device.</p> - -<h2 id="Contributing_to_the_project">Contributing to the project</h2> - -<p>If you have any questions about the Firefox OS Endurance tests or are interested in contributing to this important automation development effort, feel free to contact us in the Mozilla #automation IRC channel.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/index.html deleted file mode 100644 index 92bef3f84c..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Gaia UI Tests Introduction -slug: Archive/B2G_OS/Automated_testing/gaia-ui-tests -tags: - - B2G - - Build documentation - - Firefox OS - - Gaia - - Guide - - Mobile - - Testing - - TopicStub - - gaia-ui-test - - gaiatest -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests ---- -<div class="prevnext" style="text-align: right;"> -<p><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_1_Marionette_Firefox_OS_start">Suivant »</a></p> -</div> - - - -<div class="summary"> -<p>Gaia-ui-tests est la suite de tests Mozilla, qui permet de tester le rendu final de l'interface utilisateur pour Gaia, l'interface utilisateur de Firefox OS. Tous les tests sont écrits en Python avec un peu de JavaScript utilisé pour interagir avec les API Firefox OS. Cette série d'articles explique comment configurer l'environnement pour écrire et lancer des tests.</p> -</div> - -<p>Gaia-ui-tests utilise <strong>Gaiatest</strong>, un package Python basé autour de <a href="https://developer.mozilla.org/en-US/docs/Marionette" title="https://developer.mozilla.org/en-US/docs/Marionette">Marionette</a>. Gaiatest est concu pour réunir, les cibles HTML, les appels Marionette, et les appels API pour une communication et un fonctionnement inter-opérable. Marionette est basé sur le standard W3C développé pour le <a href="http://docs.seleniumhq.org/projects/webdriver/" title="http://docs.seleniumhq.org/projects/webdriver/">Selenium WebDriver</a> une interface de programmation pour l'automatisation du navigateur. Si vous avez déjà utilisé WebDriver ainsi que des objets de page/application auparavant, alors l'utilisation de Marionette et gaiatest vous paraitront facile.</p> - -<h2 id="Démarrer_avec_Gaia_UI_tests">Démarrer avec Gaia UI tests</h2> - -<p>Pour ceux qui désirent débuter avec les tests automatisés sur Gaia/Firefox OS, nous avons une séries de tutoriels, qui vous aideront de zéro, jusqu'à écrire vos propres tests. Une fois que vous aurez achevé ce tutoriel, vous aurez assez de connaissance en tests Firefox OS et Marionette, pour contribuer aux tests Mozilla. <strong>Il est fortement recommandé de suivre l'ensemble de ce tutoriel, si vous souhaitez devenir contributeur.</strong></p> - -<dl> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_1_Marionette_Firefox_OS_commencer">Partie 1: Bien commencer avec Marionette et Firefox OS</a></dt> - <dd>Cet article couvre l'installation des outils nécessaire pour démarrer avec les tests, comme le Bureau B2G, Python et Marionette.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_2_Marionette_Firefox_OS_interactions">Partie 2 : Interactions de base avec Firefox OS via l'utilisation de Marionette</a></dt> - <dd>Un apperçu des commandes de base, que vous utiliserez, pour manipuler Firefox OS avec Marionette.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_3_Tests_reutilisables">Partie 3 : Améliorer notre code pour en faire un test réutilisable</a></dt> - <dd>Pour continuer, dans cet article, nous allons assembler quelques commandes de base dans un test simple, à l'intérieur d'un fichier Python, afin qu'ils puissent tous être gérés comme une seule entité.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_4_Reutiliser_commandes_Firefox_OS_configuration">Partie 4 : Réutiliser des commandes pour configurer Firefox OS</a></dt> - <dd>Ici, nous allons déplacer certaines des commandes, dans les méthodes de Python, pour promouvoir la réutilisation du code.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_5_Introduction_executeur_tests">Partie 5 : Introduction à un exécuteur de tests</a></dt> - <dd>Un lanceur de test est un élément central de toute bonne suite de tests, vous permettant d'exécuter de multiples tests, et d'obtenir un rapport et des résultats globaux. Dans cet article, nous allons explorer les bases du lanceur unittest de Python.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_6_Marionette_classe_By">Partie 6: Utiliser des tuples, et la classe By de Marionette</a></dt> - <dd>Cette fois, nous expliquons comment réduire encore la duplication de code, en stockant les localisateurs répétées dans tuples et simplifiant la syntaxe avec la classe <code>By</code> de Marionette.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_7_Ecrire_vos_propres_tests">Partie 7 : Écrire vos propres tests</a></dt> - <dd>Maintenant, les bases sont derrière vous, et il est temps de commencer à écrire vos propres tests! Nous vous donnons ici quelques recommandations d'outils pour vous faciliter le travail, et proposons des tests pour vous exercer à en écrire.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_8_Utiliser_une_classe_base">Partie 8 : Utiliser une classe base</a></dt> - <dd>Dans son état actuel, notre fichier de test contient tout le code du lanceur de test. Ceci va bien pour le moment, mais dès que vous commencez à exécuter de nombreux fichiers de test, cela signifie beaucoup de doublons. Ici, nous résolvons ce problème, en faisant abstraction du code du lanceur de test, dans une classe Python séparée.</dd> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests/Partie_9_objets_app">Partie 9 : Réduire le code dupliqué avec des objets app</a></dt> - <dd>Comme amélioration finale à la maintenabilité du code, dans cet article, nous explorons le code d'abstraction, qui gère l'interaction avec les applications spécifiquent à Firefox OS, dans des objets d'applications Python.</dd> -</dl> - -<h2 id="Sujets_avancés">Sujets avancés</h2> - -<p>Une fois que vous possédez les bases pour écrire et lancer des tests, vous pourriez vouloir avancer pour des travaux avec plus d'implications ou plus avancés, comme lancer la suite de tests complète gaia-ui-tests, ou connecter l'énergie résultante de la suite d'un test.</p> - -<dl> - <dt><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Gaia_UI_Tests_Run_Tests" title="Gaia UI Tests Run Tests">Lancer le gaia-ui-tests</a></dt> - <dd>Des guides pour lancer la suite gaia-ui-tests sur des vrais périphériques Firefox OS et <a href="/en-US/Firefox_OS/Using_the_B2G_desktop_client">Le Bureau B2G</a> dans diverses configurations.</dd> -</dl> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<p><a href="https://github.com/mozilla-b2g/gaia/tree/master/tests/python/gaia-ui-tests">Repo principal Gaia-ui-tests</a></p> - -<h2 id="QuestionsCommentairesPréoccupations_2"><span class="mw-headline" id="QuestionsCommentairesPréoccupations">Questions/Commentaires/Préoccupations </span></h2> - -<p>Ce projet est à un stade d'avancement précoce, et vos retours d'expérience sont grandement appréciés :</p> - -<ul> - <li>Envoyer des mails à la liste <a href="http://mailto:_gaia-ui-automation@mozilla.org">gaia-ui-automation@mozilla.org</a>.</li> - <li>Sinon, retrouvez nous sur <a href="https://wiki.mozilla.org/IRC">l'IRC Mozilla</a> dans les canaux #fxosqa, #fxos-automation, et #moztpeqa.</li> -</ul> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_1_marionette_firefox_os_commencer/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_1_marionette_firefox_os_commencer/index.html deleted file mode 100644 index 6747a2a1dc..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_1_marionette_firefox_os_commencer/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: 'Partie 1: Bien commencer avec Marionette et Firefox OS' -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_1_Marionette_Firefox_OS_commencer -tags: - - Automatisation - - interface utilisateur -translation_of: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_1_Marionette_Firefox_OS_start ---- -<p></p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests" style="float: left;">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_2_Marionette_Firefox_OS_interactions">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Cette série de tutoriels a pour objectif de vous familiariser avec l'écriture et l'exécution des tests automatisés de l'interface utilisateur pour Firefox OS en utilisant <a href="/en-US/docs/Mozilla/QA/Marionette">Marionette</a>, un package d'automatisation qui tourne sur votre ordinateur. Marionette publie des commandes pour exécuter des tests sur les plateformes basées sur Gecko. Cet article va vous faire parcourir plus particulièrement la configuration que vous devez effectuer avant d'exécuter des tests.</span></p> -</div> - -<p>La série de tutoriels va parcourir les concepts de l'automatisation de tests et aussi vous familiariser au travail avec Firefox OS (y compris le très utile outil de test <a href="/en-US/Firefox_OS/Using_the_B2G_desktop_client">B2G Desktop</a>) et Marionette. Occasionnellement, nous présenterons quelques défis pour vous encourager à explorer vos propres solutions.</p> - -<div class="note"> -<p><strong>Note </strong>: le tutoriel n'est pas spécifique aux produits de Mozilla ; par exemple, si vous développez une application HTML5, vous pouvez utiliser ce tutoriel pour constuire un framework de tests.</p> -</div> - -<h2 id="Logiciels_requis_pour_ce_tutoriel">Logiciels requis pour ce tutoriel</h2> - -<p>Au cours de ce tutoriel, nous allons installer et utiliser les logiciels suivants :</p> - -<ul> - <li>Python 2.7</li> - <li>pip installer</li> - <li>Un éditeur de texte ou IDE pour écrire le code</li> - <li>Le client de bureau Boot2Gecko (Firefox OS)</li> - <li>Le client Marionette (client WebDriver pour Firefox OS)</li> -</ul> - -<h2 id="Python_et_pip">Python et pip</h2> - -<p>Des systèmes d'exploitation comme Linux auront Python déjà préinstallé. Avant d'installer Python, vérifiez qu'il n'est pas déjà installé. Depuis une ligne de commande ou un terminal, exécutez :</p> - -<pre class="brush: bash">python --version</pre> - -<p>Toute version de Python 2.6.x ou 2.7.x est valable pour ce tutoriel. Si vous n'avez pas Python 2.7 d'installé, vous pouvez trouver l'installeur sur le <a href="https://www.python.org/download/releases/2.7.6/">site de téléchargement de Python</a>.</p> - -<p>Pip est utilisé pour installer les outils Python et nous en avons besoin pour installer Marionette. Vous pouvez vérifier si pip est installé en saisissant <code>pip</code> dans votre terminal ou votre ligne de commande. Pour installer pip, suivez les instructions dans la <a href="http://pip.readthedocs.org/en/latest/installing.html">documentation pip</a>.<br> - </p> - -<h2 id="Bureau_B2G">Bureau B2G</h2> - -<p>Le client de bureau B2G vous permet d'exécuter Gaia — l'interface utilisateur de Firefox OS — et les applications Firefox OS sur un bureau d'ordinateur. Le client de bureau possède certaines limites — il n'émule pas le matériel de l'appareil comme l'appareil photo, la batterie, etc. — mais il sera parfait pour les sujets de ce tutoriel. Allez, installons-le maintenant.</p> - -<p>Téléchargez la dernière version du bureau B2G depuis le <a href="http://nightly.mozilla.org/">site Firefox Nightly</a> (voir Desktop Boot2Gecko, en bas). Dès que le bureau B2G est téléchargé, extraire les contenus dans un dossier sur votre ordinateur. Pour démarrer le simulateur Firefox OS exécutez le fichier script <strong>b2g</strong> approprié à votre système d'exploitation :</p> - -<ul> - <li><strong>Linux</strong> : naviguez vers le dossier où vous l'avez extrait et exécutez <code>./b2g</code></li> - <li><strong>Mac </strong>: glissez et déplacez B2G.app dans votre dossier Application et exécutez-le depuis celui-ci.</li> - <li><strong>Windows </strong>: exécutez b2g.exe depuis le dossier où vous avez extrait le zip.</li> -</ul> - -<p>Dès que l'application démarre, vous devriez voir une fenêtre similaire à celle-ci :</p> - -<p><img alt="A welcome screen for Firefox OS - says welcome in multiple languages" src="https://mdn.mozillademos.org/files/7207/b2g-start-screen.png" style="width: 322px; height: 509px; display: block; margin: 0px auto;"></p> - -<p>Suivez les étapes de Premier Usage jusqu'à arriver sur l'écran d'accueil Firefox OS. Notez que vous pouvez émuler les boutons du téléphone en utilisant les commandes clavier suivantes, qui peuvent être parfois utiles (par exemple, appuyer sur Home pour éviter que le téléphone ne se mette en veille).</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="row"> - <p> </p> - </th> - <th scope="col"> - <p>Clavier Windows/Linux</p> - </th> - <th scope="col"> - <p>Clavier Mac OS</p> - </th> - </tr> - </thead> - <tbody> - <tr> - <th scope="row"> - <p>Bouton Home</p> - </th> - <td> - <p>Home</p> - </td> - <td> - <p>Fn + flèche gauche</p> - </td> - </tr> - <tr style="height: 0px;"> - <th scope="row"> - <p>Bouton Power</p> - </th> - <td> - <p>Fin</p> - </td> - <td> - <p>Fn + flèche droite</p> - </td> - </tr> - <tr> - <th scope="row"> - <p>Volume haut/bas</p> - </th> - <td> - <p>Haut/Bas de page</p> - </td> - <td> - <p>Fn+ flèche haut/bas</p> - </td> - </tr> - </tbody> -</table> - -<p>À cette étape, vous pouvez laisser ouvert le bureau B2G et mettre la fenêtre de coté. Maintenant nous allons terminer le travail en installant Marionette.</p> - -<h2 id="Marionette">Marionette</h2> - -<p>Marionette est constitué de deux parties ; le client — qui fonctionne sur votre ordinateur — et le serveur — qui fonctionne à l'intérieur de Firefox OS. Le serveur Marionette, comme un marionnettiste, peut contrôler directement Firefox OS.</p> - -<p><img alt="marionette architecture showing marionette server inside Firefox OS and marionette client on its own outside" src="https://mdn.mozillademos.org/files/7223/marionette-basic-diagram.png" style="width: 352px; height: 186px; display: block; margin: 0px auto;"></p> - -<p>Puisque nous utilisons le client bureau B2G, le serveur Marionette est préinstallé (cela est aussi vrai quand vous utilisez une compilation préconfigurée de Firefox OS sur un appareil réel). Avant toutefois de pouvoir contrôler Firefox OS, nous devons installer le client Marionette sur notre ordinateur. On peut le faire en exécutant la commande suivante dans le terminal :</p> - -<pre class="brush: bash">pip install marionette_client</pre> - -<p>C'est tout pour le moment. Nous avons tout configuré et sommes prêts à commencer !</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_2_marionette_firefox_os_interactions/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_2_marionette_firefox_os_interactions/index.html deleted file mode 100644 index 04eed2587c..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_2_marionette_firefox_os_interactions/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: >- - Partie 2 : Interactions de base avec Firefox OS via l'utilisation de - Marionette -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_2_Marionette_Firefox_OS_interactions -tags: - - Automatisation - - interface utilisateur -translation_of: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_2_Marionette_Firefox_OS_interactions ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_1_Marionette_Firefox_OS_start">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_3_Reusable_tests">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Dans la deuxième partie de notre tutoriel nous allons débuter avec des commandes Marionette simples qui vont nous permettre de contrôler à distance Firefox OS. Même si nous n'allons pas couvrir l'écriture d'un test en intégralité, cet article vous enseigne les fonctionnalités basiques de code que vous pourrez utiliser pour écrire un test. Dans la troisième partie, nous irons plus loin pour faire évoluer ce code en un test réel.</span></p> -</div> - -<h2 id="Démarrage_de_Firefox_OS">Démarrage de Firefox OS</h2> - -<p>Pour écrire ces tests vous avez besoin d'avoir Firefox OS déjà en cours d'exécution et prêt à recevoir des commandes :</p> - -<ol> - <li>Démarrer le bureau B2G.</li> - <li>Désactiver l'écran de verrouillage en utilisant <em>Paramètres > Ecran de verrouillage > décocher verrouiller l'écran</em>.</li> - <li>Désactiver la mise en veille de l'écran en changeant le paramètre <em>Paramètres > Affichage > Ecran de veille </em>à <em>jamais</em>.</li> - <li>Déplacer la fenêtre sur le côté en attendant les commandes de test.</li> -</ol> - -<h2 id="Démarrage_de_Marionette">Démarrage de Marionette</h2> - -<p>Maintenant nous allons démarrer une console Python : allez simplement dans une fenêtre de terminal et tapez la commande <code>python</code>.</p> - -<p>Depuis cette console nous pouvons envoyer des commandes au serveur Marionette dans Firefox OS. Après avoir saisi les commandes qui suivent vous devriez voir répondre Firefox OS. Dans la console Python, entrez la commande suivante pour importer la librairie Marionette contenant le code dont nous avons besoin :</p> - -<pre class="brush: bash">from marionette import Marionette</pre> - -<p>Exécutez maintenant les deux lignes suivantes, qui débutent une session Marionette et le préparent à recevoir des commandes de la part du client :</p> - -<pre class="brush: bash">marionette = Marionette() -marionette.start_session()</pre> - -<p>Si vous ne désactivez pas l'écran de verrouillage comme expliqué ci-dessus, vous pouvez déverrouiller l'écran en ligne de commande, en utilisant :</p> - -<pre class="brush: bash">marionette.execute_script('window.wrappedJSObject.lockScreen.unlock();')</pre> - -<h2 id="Accès_à_différents_cadres_dans_Firefox_OS">Accès à différents cadres dans Firefox OS</h2> - -<p>Les applications web dans Firefox OS opèrent dans différents iFrames. Exécuter des applications web dans des cadres séparés leur donnent des conteneurs différents pour la gestion de la sécurité et du visuel (comme une fenêtre). Vous pouvez imaginer que cela fonctionne comme un bac à sable dans lequel l'application s'exécute. Marionette ne peut fonctionner que dans un seul cadre à la fois. Nous avons besoin de Marionette pour passer dans le cadre avec lequel nous voulons interagir.</p> - -<p>Le cadre du haut est aussi l'application Système. Toutes les applications et leurs cadres sont des filles de l'application Système. Notre nouvelle session Marionette commence dans le cadre Système mais pour commencer le test nous devons passer dans l'écran d'accueil.</p> - -<p>Pour trouver le iFrame, nous devons d'abord l'identifier. Comme Marionette est basée sur l'API WebDriver, elle utilise les mêmes stratégies pour localiser des éléments, donc nous pouvons utiliser une de ces stratégies pour identifier les éléments web de WebDriver. Pour plus d'informations, lire <a href="http://www.w3.org/TR/webdriver/#element-location-strategies">element location strategies</a>.</p> - -<p>Dans ce cas, nous allons utiliser le sélecteur CSS <code>div.homescreen iframe</code> pour sélectionner le iFrame de l'écran d'accueil ; la fonction <code>find_element()</code> le prend comme deuxième argument, le premier étant une définition du mécanisme de sélection utilisé pour faire la recherche. Nous allons ensuite stocker ce résultat dans une variable et exécuter la fonction <code>switch_to_frame()</code> avec la variable comme argument. À présent, essayez les deux commandes suivantes :</p> - -<pre class="brush: bash"># Switch context to the homescreen iframe and tap on the Contacts app icon -home_frame = marionette.find_element('css selector', 'div.homescreen iframe') -marionette.switch_to_frame(home_frame)</pre> - -<div class="note"> -<p><strong>Note</strong>: Pour plus d'informations et de diagrammes décrivant le changement de cadres, vous pouvez lire <a href="https://blog.mozilla.org/webqa/2013/02/13/part-2-ui-testing-on-firefox-os-working-with-iframes/">Working with iFrames</a>.</p> -</div> - -<h2 id="Ouverture_d'une_application">Ouverture d'une application</h2> - -<p>OK. Maintenant que nous nous trouvons dans l'application Homescreen nous pouvons cibler les icônes et les cliquer en utilisant la fonction <code>find_element()</code>, combinée avec la fonction <code>tap()</code>.</p> - -<pre class="brush: bash"><code>contacts_icon = marionette.find_element('xpath', "</code><code>//div[@class='icon']//span[contains(text(),'Contacts')]")</code> -contacts_icon.tap()</pre> - -<p>Si tout se passe bien, vous devriez maintenant avoir l'application Contacts ouverte, mais nous devons encore passer dans cadre de l'application Contacts pour interagir avec lui, comme nous l'avions fait précédemment avec l'écran d'accueil :</p> - -<pre class="brush: bash"># First, we need to switch context back to the System frame -marionette.switch_to_frame() - -# Now, switch context to the contacts app frame -contacts_frame = marionette.find_element('css selector', "iframe[data-url*='contacts']") -marionette.switch_to_frame(contacts_frame)</pre> - -<p>Passer dans le cadre devrait renvoyer <code>True</code>. Si c'est le cas, c'est super ! Cela signifie que nous sommes dans le contexte de l'application Contacts et que nous sommes prêts à l'utiliser.</p> - -<h2 id="Manipulation_de_l'application">Manipulation de l'application</h2> - -<p>Dans la prochaine étape, nous allons réaliser une tâche de test typique — créer un nouveau contact, lui entrer un nom, et le sauvegarder. Premièrement, nous allons appuyer sur le bouton d'ajout d'un contact :</p> - -<pre class="brush: bash"># Tap [+] to add a new Contact -marionette.find_element('id', 'add-contact-button').tap()</pre> - -<p>Maintenant, ajoutons le nom du contact en utilisant les deux commandes suivantes (<code>send_keys()</code> est utilisée pour insérer une valeur dans un élément) :</p> - -<pre class="brush: bash">marionette.find_element('id', 'givenName').send_keys('Foo') -# Add the contact's surname -marionette.find_element('id', 'familyName').send_keys('Bar')</pre> - -<p>À présent, appuyons sur le bouton OK pour sauvegarder le contact :</p> - -<pre class="brush: bash"><code class="language-html">marionette.find_element('id', 'save-button').tap()</code></pre> - -<p>Vous devriez voir un nouveau contact entré dans l'application Contacts. Si c'est le cas, c'est parfait !</p> - -<div class="note"> -<p><strong>Note </strong>: si ce n'est pas le cas, redémarrez ou tuez l'application Contacts, retournez sur l'écran d'accueil et essayez d'exécuter la tâche de nouveau.</p> -</div> - -<h2 id="Fermeture_de_votre_session_Marionette">Fermeture de votre session Marionette</h2> - -<p>Pour finir, vous devez fermer votre session Marionette en saisissant la commande suivante :</p> - -<pre class="brush: bash">marionette.delete_session()</pre> - -<p>Tout cela a bien fonctionné, mais vous ne pouvez pas taper dans une console Python à chaque fois que vous voulez exécuter un test ! Dans la partie 3, nous allons compiler ce script dans un fichier Python que nous pourrons réutiliser à chaque fois que l'on voudra exécuter un test. Nous ajouterons également une ligne pour déterminer si le test a réussi ou échoué.</p> - -<div class="note"> -<p><strong>Note </strong>: lors de l'écriture des commandes Marionette, vous avez certainement remarqué que l'accès à la structure HTML sous-jacente de l'application est vitale pour comprendre les repères dont vous avez besoin. <a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_7_Writing_your_own_tests#Resources">Partie 7: Ecrire vos propres tests</a> offre quelques ressources utiles pour vous aider sur ce sujet.</p> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_3_tests_reutilisables/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_3_tests_reutilisables/index.html deleted file mode 100644 index b053f8cf9b..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_3_tests_reutilisables/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: 'Partie 3 : Améliorer notre code pour en faire un test réutilisable' -slug: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_3_Tests_reutilisables -tags: - - Firefox OS - - Marionette - - Python - - test -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_3_Reusable_tests ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_2_Marionette_Firefox_OS_interactions">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_4_Reusing_commands_Firefox_OS_setup">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Nous avons appris dans la partie 2 que nous pouvions contrôler de manière simple Firefox OS en utilisant les commandes du client Marionette. Néanmoins, les saisir dans une console Python est aussi lent que fastidieux. L'avantage clé de l'automatisation de tests est son exécution autonome. Nous allons apprendre comment faire cela dans cette partie, en mettant toutes nos commandes dans un fichier Python qui pourra s'exécuter d'un seul coup.</span></p> -</div> - -<h2 id="Résumé_d'un_cas_de_test">Résumé d'un cas de test</h2> - -<p>Dans la partie 2, nous avons passé les étapes pour exécuter un cas de test typique — ouvrir l'application Contacts et ajouter un nouveau contact :</p> - -<ol> - <li>Déverrouiller Firefox OS (facultatif ; dans la partie 2 nous avons désactivé l'écran de verrouillage manuellement, en conséquence nous ne l'incluerons pas dans le code ci-dessous)</li> - <li>Aller dans l'application Contacts</li> - <li>Appuyer sur l'icône d'ajout d'un nouveau contact</li> - <li>Saisir le nom du contact</li> - <li>Appuyer sur OK</li> - <li>Attendre et vérifier que le contact est présent</li> -</ol> - -<h2 id="Mettre_notre_test_dans_un_fichier_Python">Mettre notre test dans un fichier Python</h2> - -<p>Si nous mettons toutes ces étapes dans un fichier Python, nous pouvons le réutiliser et l'exécuter bien plus rapidement. Créez un nouveau fichier texte nommé <code>test_add_contact.py</code> dans un dossier convenable de votre choix.</p> - -<p>Dans ce fichier, entrez les commandes que nous avons vues dans la partie 2, comme listé ci-dessous. Nous utiliserons une structure de classes Python, puisque c'est une bonne pratique et qui plus est elle constitue une bonne base pour construire les étapes à venir de ce tutoriel.</p> - -<pre class="brush: python">import time -from marionette import Marionette - -class TestContacts: - - def __init__(self): - self.test_add_contacts() - - def test_add_contacts(self): - # Create the client for this session. Assuming you're using the default port on a Marionette instance running locally - self.marionette = Marionette() - self.marionette.start_session() - - # Switch context to the homescreen iframe and tap on the contacts icon - time.sleep(2) - home_frame = self.marionette.find_element('css selector', 'div.homescreen iframe') - self.marionette.switch_to_frame(home_frame) - contacts_icon = self.marionette.find_element('xpath', "//div[@class='icon']//span[contains(text(),'Contacts')]") - contacts_icon.tap() - - # Switch context back to the base frame - self.marionette.switch_to_frame() - time.sleep(2) - - # Switch context to the contacts app - contacts_frame = self.marionette.find_element('css selector', "iframe[data-url*='contacts']") - self.marionette.switch_to_frame(contacts_frame) - - # Tap [+] to add a new Contact - self.marionette.find_element('id', 'add-contact-button').tap() - time.sleep(2) - - # Type name into the fields - self.marionette.find_element('id', 'givenName').send_keys('John') - self.marionette.find_element('id', 'familyName').send_keys('Doe') - - # Tap done - self.marionette.find_element('id', 'save-button').tap() - time.sleep(2) - - # Close the Marionette session now that the test is finished - self.marionette.delete_session() - -if __name__ == '__main__': - TestContacts() -</pre> - -<div class="note"> -<p><strong>Note </strong>: il y a une chose que vous allez remarquer dans le code que nous n'avons pas couverte dans la partie 2 : la fonction Python <code>time.sleep()</code> — cela met le script en pause pour une certaine durée (définie en secondes) avant qu'il ne continue jusqu'à la ligne suivante. Nous avons ajouté ces lignes dans le test automatisé car nous devons simuler l'utilisateur qui, manuellement, appuie sur les boutons, etc. et attendre que Firefox OS effectue les actions qui en résultent. Si nous exécutons le script sans pause, Python effectuera toutes les actions de manière instantanée, mettant probablement le test en échec, puisque Firefox OS n'aurait pas été capable de s'adapter.</p> -</div> - -<p>À présent, nous pouvons lancer le test en allant dans le fichier où le test est enregistré via le terminal et en exécutant la commande suivante :</p> - -<pre class="brush: bash">python test_add_contact.py</pre> - -<div class="note"> -<p><strong>Note</strong> : soyez vigilant par rapport aux règles d'identation de Python. Après avoir copié et collé le code vous devrez probablement tout identer correctement pour qu'il s'exécute. Si vous obtenez une erreur liée à ce point, assurez-vous que tous les niveaux d'indentation sont séparés par une tabulation.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : vous remarquerez également que le nom inséré dans le code ci-dessus est "John Doe", à la différence du nom "Foo Bar" de la partie 2. Nous avons fait ce changement dans le code pour qu'il puisse ajouter avec succès un autre contact. Si vous essayez d'ajouter un contact avec le même nom, Firefox OS vous alertera sur le doublon de contacts. Pour l'instant, la meilleure façon de répéter l'exécution du test est d'aller dans l'interface de Firefox OS et de supprimer manuellement le contact avant chaque exécution.</p> -</div> - -<h2 id="Ajouter_une_assertion">Ajouter une assertion</h2> - -<p>L'élément qui manque toujours dans notre test, qui est important dans les tests automatisés, est une assertion — un rapport ou mesure pour déterminer si Firefox OS a atteint l'état que nous voulions qu'il atteigne ou si le test est un succès. Nous allons régler ce problème en ajoutant du code pour vérifier si le nouveau contact est présent dans l'application.<br> - <br> - Juste avant la ligne <code># Close the Marionette session…</code> ajoutez dans ce code, en s'assurant qu'il est indenté au même niveau que les autres lignes de la classe :</p> - -<pre class="brush: python"># Now let's find the contact item and get its text -contact_name = self.marionette.find_element('css selector', 'li.contact-item:not([data-group$="ice"]) p').text -assert contact_name == 'John Doe'</pre> - -<p>Supprimez l'ancien contact et essayer d'exécuter de nouveau le test, avec la commande suivante :</p> - -<pre class="brush: bash">python test_add_contact.py</pre> - -<p>Si cela s'exécute correctement, alors nous avons un test qui fonctionne !</p> - -<div class="note"> -<p><strong>Note </strong>: si l'assertion échoue, assurez-vous que le précédent contact 'Foo Bar' n'existe plus. Le sélecteur CSS avant l'assertion prend en compte le premier contact de la liste (cela pourrait être visible en appelant <code>print "Contact name: %s" % contact_name</code> avant l'appel de l'assertion).</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: l'assertion n'apparaîtra pas pour faire quelque chose, mais les assertions sont très importantes quand nous commençons à utiliser des exécuteurs de tests, comme présenté dans la <a href="/en-US/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_5_Introducing_a_test_runner">Partie 5: Présentation d'un exécuteur de tests</a>. Les exécuteurs de test comme unittest utilisent les assertions pour vérifier si les tests ont été réalisés avec succès ou non, et ensuite retournent les résultats de ces tests (OK ou FAIL.)</p> -</div> - -<h2 id="Note_sur_le_timing">Note sur le timing</h2> - -<p>Une des choses les plus difficiles à gérer en écrivant un test automatisé est le timing. Si le test passe à l'étape suivant avant que Firefox OS n'effectue la précédente, alors nous allons probablement avoir un échec du test.<br> - <br> - Comme mentionné ci-dessus, dans l'exemple de code que nous avons ajouté, la commande <code>time.sleep(x)</code> résout ce problème. Pourtant, utiliser <code>time.sleep(x)</code> n'est pas une bonne pratique. Utiliser une temporisation codée en dur peut faire que le test va s'exécuter trop longtemps ou pas assez. Le dernier cas est le pire ; il donnera des résultats de tests faux négatifs — ce qui signifie un test qui remonte un échec quand en réalité l'application fonctionne parfaitement mais se comporte de manière plus lente que ce que le test espérait.</p> - -<p>Dans la partie suivante, nous aborderons l'abstraction de certains points du test vers des fonctions Pythons distinctes, et remplacerons les fonctions <code>sleep()</code> par les temporisations dynamiques appropriées.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_4_reutiliser_commandes_firefox_os_configuration/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_4_reutiliser_commandes_firefox_os_configuration/index.html deleted file mode 100644 index c19b0fe951..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_4_reutiliser_commandes_firefox_os_configuration/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: 'Partie 4 : Réutiliser des commandes pour configurer Firefox OS' -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_4_Reutiliser_commandes_Firefox_OS_configuration -tags: - - Automatisation - - B2G - - Firefox OS - - Gaia - - Marionette - - Python - - interface utilisateur - - test -translation_of: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_4_Reusing_commands_Firefox_OS_setup ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_3_Reusable_tests">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_5_Introducing_a_test_runner">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Dans les parties 2 et 3 nous avons écrit un test qui fonctionne, mais si nous voulions réinitialiser son état (par exemple en tuant les applications ouvertes) avant d'exécuter le test, nous devions le faire manuellement. Ceci est un peu fastidieux, nous devrions donc automatiser ce point ! Dans cette partie, nous allons voir comment faire cela en éclatant des bouts de code dans des méthodes Python distinctes que nous pourrons réutiliser.</span></p> -</div> - -<h2 id="Réinitialisation_automatique">Réinitialisation automatique</h2> - -<p>Avant de réaliser une exécution de test typique, nous aurons probablement besoin de déverrouiller l'écran de verrouillage de Firefox OS et tuer toutes les applications en cours d'exécution. Regardons de plus près comment faire.</p> - -<h3 id="Déverrouiller_l'écran_de_verrouillage">Déverrouiller l'écran de verrouillage</h3> - -<p>Avant d'aller plus loin, activez l'écran de verrouillage de nouveau avec <em>Paramètres > Écran de verrouillage > Verrouiller l'écran</em>, si ce n'est pas déjà fait.</p> - -<p>Ajoutez la méthode Python suivante dans votre fichier <code>test_add_contact.py</code>, juste dans la classe :</p> - -<pre class="brush: python">def unlock_screen(self): - self.marionette.execute_script('window.wrappedJSObject.lockScreen.unlock();')</pre> - -<p>Cette méthode va désormais déverrouiller Firefox OS quand elle sera appelée. Maintenant, appelons-la dans notre test en ajoutant les lignes suivantes sous la ligne <code>self.marionette.start_session()</code> :</p> - -<pre class="brush: python"># Unlock the screen -self.unlock_screen()</pre> - -<h3 id="Tuer_toute_application_ouverte">Tuer toute application ouverte</h3> - -<p>Maintenant nous allons ajouter une méthode dans notre code pour tuer toutes les applications ouvertes. Cela ressemble à ceci :</p> - -<pre class="brush: python"> def kill_all(self): - self.marionette.switch_to_frame() - self.marionette.execute_async_script(""" - // Kills all running apps, except the homescreen. - function killAll() { - let manager = window.wrappedJSObject.appWindowManager; - - let apps = manager.getApps(); - for (let id in apps) { - let origin = apps[id].origin; - if (origin.indexOf('verticalhome') == -1) { - manager.kill(origin); - } - } - }; - killAll(); - // return true so execute_async_script knows the script is complete - marionetteScriptFinished(true); - """)</pre> - -<p>Ajoutez ceci juste après la méthode <code>unlock_screen</code> que nous avons ajoutée dans la section précédente.</p> - -<p>Puis, ajoutez les lignes suivantes pour exécuter ceci pour le reste du test ; ajoutez ceci juste après la ligne <code>self.unlock_screen()</code> :</p> - -<pre class="brush: python"># kill all open apps -self.kill_all()</pre> - -<p>Maintenant, essayez de laisser l'application Contacts ouverte après la dernière exécution du test et retournez à l'écran de verrouillage avant d'exécuter le test de nouveau. En plus du déverrouillage de l'écran, l'application Contacts ouverte sera automatiquement tuée avant d'exécuter de nouveau le test, donc son état n'affectera pas le test que vous êtes en train d'exécuter. Ce point est important pour la fiabilité sur le long terme de notre exécution de test.</p> - -<p>Exécutez de nouveau le test plusieurs fois et visualisez si tout fonctionne et si Firefox OS est réinitialisé proprement.</p> - -<h2 id="Attentes_dynamiques">Attentes dynamiques</h2> - -<p>Dans la partie 3, nous avons mentionné l'importance des attentes dynamiques. Marionette possède des attentes comme WebDriver/Selenium2, avec une syntaxe particulière qui ressemble à celle-ci :</p> - -<pre class="brush: python">from marionette_driver import Wait - -# Wait until element is displayed -Wait(self.marionette).until(lambda m: m.find_element('id', 'element_id').is_displayed())</pre> - -<p>Ce code attendra jusqu'à ce que l'élément spécifié soit affiché. À ce moment, nous savons que nous sommes prêts à interagir avec lui. Essayons d'utiliser cette construction de code dans notre test.</p> - -<p>Tout d'abord, incluez la ligne importée Wait, juste après les lignes d'import existantes :</p> - -<pre class="brush: python">from marionette_driver - import Wait</pre> - -<p>À présent, nous pouvons remplacer la deuxième fonction <code>time.sleep(2)</code> après avoir pressé l'icone Contacts (juste après la ligne <code>self.marionette.switch_to_frame()</code>) avec une méthode <code>Wait()</code> qui attendra jusqu'à ce que le cadre Contacts soit affiché :</p> - -<pre class="brush: python">Wait(self.marionette).until(lambda m: m.find_element('css selector', "iframe[data-url*='contacts']").is_displayed())</pre> - -<p>Quand nous appuyons sur le symbole + pour commencer la création d'un nouveau contact, nous voulons attendre que le formulaire d'ajout de contact soit complètement visible. Le bouton OK (sauvegarder) est la chose suivante que nous devons presser, nous allons donc attendre d'être mis en position avant de continuer. Remplacez la troisième fonction <code>time.sleep(2)</code> par la ligne suivante :</p> - -<pre class="brush: python">Wait(self.marionette).until(lambda m: m.find_element('id', 'save-button').location['y']== 0)</pre> - -<p>Dans cet exemple, nous attendons que le bouton OK soit déplacé en haut de l'écran ; cet élément sera visible en de nombreux points suite à l'animation, mais la postition d'arrêt finale est la position la plus sûre à attendre.</p> - -<p>Nous pouvons également attendre les éléments qui ne doivent pas être affichés. Après avoir appuyé sur OK, nous attendons que le bouton OK soit caché en utilisant une méthode <code>Wait()</code> similaire avec une négation, avant d'exécuter le reste du code. Remplacez la quatrième et dernière fonction <code>time.sleep(2)</code> avec ce qui suit :</p> - -<pre class="brush: python">Wait(self.marionette).until(lambda m: not m.find_element('id', 'save-button').is_displayed())</pre> - -<p>SI votre test est bon, alors c'est super ! Nous avons réalisé un test plus modulaire et fiable. Dans la partie 5, nous vous familiariserons à l'utilisation d'un exécuteur de tests.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_5_introduction_executeur_tests/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_5_introduction_executeur_tests/index.html deleted file mode 100644 index bd8ea4f19a..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_5_introduction_executeur_tests/index.html +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: 'Partie 5 : Introduction à un exécuteur de tests' -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_5_Introduction_executeur_tests -tags: - - Automatisation - - B2G - - Firefox OS - - Gaia - - Marionette - - Python - - interface utilisateur - - tests -translation_of: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_5_Introducing_a_test_runner ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_4_Reusing_commands_Firefox_OS_setup">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_6_Marionette_By_class">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Jusqu'ici tout va bien, mais nous avons toujours traité un seul test. Quand on teste une réelle application web il peut y avoir des centaines de cas de tests, et nous ne voulons certainement pas exécuter chacun d'eux manuellement. Dans un tel scénario, nous devons utiliser un exécuteur de tests pour trouver et exécuter les tests à pour nous. C'est le sujet de cet article.</span></p> -</div> - -<h2 id="Exécuteurs_de_tests">Exécuteurs de tests</h2> - -<p>Un exécuteur de tests fournit la bonne base pour un framework de test réel. Il est conçu pour exécuter des tests, des étiquettes de tests avec des attributs (annotations), fournir du reporting et bien d'autres fonctionnalités encore. Il existe de nombreux exécuteurs de tests Python disponibles, mais dans notre cas, nous allons utiliser le <strong>unittest </strong>de Python puisqu'il est simple, efficace et inclus dans le package Python (comme cela nous n'avons pas besoin d'installer quoi que ce soit).</p> - -<p>En général on sépare les tests en 3 sections standard : <code>setUp()</code>, tests, et <code>tearDown()</code>, typique pour une configuration d'exécuteur de tests.<br> - <br> - Les méthodes <code>setUp()</code> et <code>tearDown()</code> sont exécutées automatiquement pour chaque test et contiennent respectivement :</p> - -<ul> - <li>Les étapes de configuration qu'il faut réaliser avant d'exécuter le test, comme déverrouiller l'écran et tuer les applications ouvertes.</li> - <li>Les étapes de refroidissement qu'il faut exécuter après le test, comme fermer la session Marionette.</li> -</ul> - -<p>La partie test de la configuration est le code que vous voulez exécuter pour le test en cours. Regardons maintenant comment nous pouvons appliquer cela au test que nous avons construit dans les parties 2 à 4.</p> - -<h2 id="Exécuter_test_add_contact.py_avec_unittest">Exécuter test_add_contact.py avec unittest</h2> - -<p>Pour utiliser unittest nous devons tout d'abord importer unittest : ajoutez la ligne suivante en dessous de vos autres lignes d'import :</p> - -<pre class="brush: python">import unittest</pre> - -<p>Ensuite, nous devons créer un exécuteur de tests. Pour faire cela, nous allons faire hériter la classe <code>TestContacts</code> de la classe <code>unittest.Testcase</code> ; mettez à jour votre ligne <code>class</code> comme suit :</p> - -<pre class="brush: python">class TestContacts(unittest.TestCase):</pre> - -<p>Nous devons également supprimer ceci :</p> - -<pre class="brush: python"> def __init__(self): - self.test_add_contacts()</pre> - -<p>L'initialisation du test sera gérée à la place par unittest, ainsi nous ne devons pas le gérer nous-mêmes. A la fin du code, remplacez ce qui suit :</p> - -<pre class="brush: python">if __name__ == '__main__': - TestContacts()</pre> - -<p>par :</p> - -<pre class="brush: python">if __name__ == '__main__': - unittest.main()</pre> - -<p>Ensuite, nous devons créer une méthode <code>setUp(self):</code> dans notre classe <code>TestContacts</code> et insérer les étapes suivantes :</p> - -<ol> - <li>Instancier Marionette et démarrer une session Marionette</li> - <li>Déverrouiller l'écran</li> - <li>Tuer les applications ouvertes</li> - <li>Charger l'application Contacts</li> -</ol> - -<p>La méthode devrait ressembler au code ci-dessous. Vous devrez supprimer les lignes identiques qui sont déjà dans <code>test_add_contacts</code>.</p> - -<pre class="brush: python"> def setUp(self): - # Create the client for this session. Assuming you're using the default port on a Marionette instance running locally - self.marionette = Marionette() - self.marionette.start_session() - - # Unlock the screen - self.unlock_screen() - - # kill all open apps - self.kill_all() - - # Switch context to the homescreen iframe - time.sleep(2) - home_frame = self.marionette.find_element('css selector', 'div.homescreen iframe') - self.marionette.switch_to_frame(home_frame)</pre> - -<p>Maintenant passons à la méthode <code>tearDown(self)</code>. A l'intérieur de celle-ci nous devons ajouter le code pour fermer la session Marionette. La méthode devrait ressembler à ceci :</p> - -<pre class="brush: python"> def tearDown(self): - # Close the Marionette session now that the test is finished - self.marionette.delete_session() -</pre> - -<p>Encore une fois, n'oubliez pas de supprimer les lignes identiques dans <code>test_add_contacts</code>.</p> - -<p>Manitenant essayez d'exécuter le test exactement comme vous l'avez fait précédemment. Vous allez voir que vous obtenez un rapport de succès et d'échecs. Ceci est un des avantages d'utiliser un exécuteur de tests comme unittest ou py.test.</p> - -<div class="note"> -<p><strong>Note </strong>: Si vous êtes bloqués, il existe de nombreux guides d'utilisation de unittest sur Internet. Nous recommandons <a href="http://selenium-python.readthedocs.org/en/latest/getting-started.html">http://selenium-python.readthedocs.org/en/latest/getting-started.html</a> et <a href="http://assertselenium.com/2013/10/07/getting-started-with-python-webdriver/">http://assertselenium.com/2013/10/07/getting-started-with-python-webdriver/</a>. Ils sont pour Python et WebDriver mais sont tout de même appropriés.</p> -</div> - -<h2 id="Code_de_référence">Code de référence</h2> - -<p>Pour référence, notre code final à cette étape ressemble à celui-ci :</p> - -<pre class="brush: python">import time -from marionette import Marionette -from marionette_driver import Wait -import unittest - - -class TestContacts(unittest.TestCase): - - def unlock_screen(self): - self.marionette.execute_script('window.wrappedJSObject.lockScreen.unlock();') - - def kill_all(self): - self.marionette.switch_to_frame() - self.marionette.execute_async_script(""" - // Kills all running apps, except the homescreen. - function killAll() { - let manager = window.wrappedJSObject.AppWindowManager; - - let apps = manager.getApps(); - for (let id in apps) { - let origin = apps[id].origin; - if (origin.indexOf('verticalhome') == -1) { - manager.kill(origin); - } - } - }; - killAll(); - // return true so execute_async_script knows the script is complete - marionetteScriptFinished(true); - """) - - def setUp(self): - # Create the client for this session. Assuming you're using the default port on a Marionette instance running locally - self.marionette = Marionette() - self.marionette.start_session() - - # Unlock the screen - self.unlock_screen() - - # kill all open apps - self.kill_all() - - # Switch context to the homescreen iframe and tap on the contacts icon - time.sleep(2) - home_frame = self.marionette.find_element('css selector', 'div.homescreen iframe') - self.marionette.switch_to_frame(home_frame) - - - def test_add_contacts(self): - <code>contacts_icon = self.marionette.find_element('xpath', "</code><code>//div[@class='icon']//span[contains(text(),'Contacts')]")</code> - contacts_icon.tap() - - # Switch context back to the base frame - self.marionette.switch_to_frame() - Wait(self.marionette).until(lambda m: m.find_element('css selector', "iframe[data-url*='contacts']").is_displayed()) - - # Switch context to the contacts app - contacts_frame = self.marionette.find_element('css selector', "iframe[data-url*='contacts']") - self.marionette.switch_to_frame(contacts_frame) - - # Tap [+] to add a new Contact - self.marionette.find_element('id', 'add-contact-button').tap() - Wait(self.marionette).until(lambda m: m.find_element('id', 'save-button').location['y']== 0) - - # Type name into the fields - self.marionette.find_element('id', 'givenName').send_keys('John') - self.marionette.find_element('id', 'familyName').send_keys('Doe') - - # Tap done - self.marionette.find_element('id', 'save-button').tap() - Wait(self.marionette).until(lambda m: not m.find_element('id', 'save-button').is_displayed()) - - def tearDown(self): - # Close the Marionette session now that the test is finished - self.marionette.delete_session() - -if __name__ == '__main__': - unittest.main() - -</pre> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_6_marionette_classe_by/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_6_marionette_classe_by/index.html deleted file mode 100644 index 85b1c5451b..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_6_marionette_classe_by/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 'Partie 6: Utiliser des tuples, et la classe By de Marionette' -slug: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_6_Marionette_classe_By -tags: - - Automatisation - - B2G - - Firefox OS - - Gaia - - Marionette - - Python - - interface utilisateur - - tests -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_6_Marionette_By_class ---- -<p> </p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_5_Introducing_a_test_runner">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_7_Writing_your_own_tests">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Jusqu'à présent dans notre code, nous avons utilisé de nombreux repères pour trouver des éléments spécifiques, que ce soit des applications (iFrames) ou des parties d'applications. De plus, nous avons écrit les repères directement dans le code et en conséquence, dupliqué du code. Pour améliorer la situation par la suite, une bonne pratique est d'abstraire ces repères dans des variables tuples Python pour ensuite les réutiliser. Dans cet article, nous allons vous montrer comment faire.</span></p> -</div> - -<h2 id="Les_tuples_et_la_classe_By_de_Marionette">Les tuples et la classe By de Marionette</h2> - -<p>Considérons comme exemple le repère que nous avons utilisé pour localiser le iFrame de l'application Contacts :</p> - -<pre class="brush: python">'css selector', "iframe[data-url*='contacts']"</pre> - -<p>Nous utilisons ce repère à la fois quand on attend l'affichage du cadre et quand on passe à l'intérieur de ce dernier. Pour rendre les choses plus simples, on peut stocker ceci dans une variable (il faut aussi iomporter <code>By</code>) :</p> - -<pre class="brush: python">from marionette import By - -_contacts_frame_locator = (By.CSS_SELECTOR, "iframe[data-url*='contacts']")</pre> - -<p>La classe <code>By</code> de Marionette fournit un court-circuit pour accéder aux techiques de repérage comme <code>id</code>, le sélecteur CSS... Comme précédemment, on saisit l'élément en utilisant le sélecteur et ensuite on le stocke dans une variable tuple CSS. Si l'HTML (et le repère) change, alors il est plus facile de simplement mettre à jour la variable une fois, plutôt que de réaliser les changements aux deux endroits. Pour utiliser ce tuple, il faut l'inclure dans la méthode <code>find_element()</code> comme suit :</p> - -<pre class="brush: python">self.marionette.find_element(*self._contacts_frame_locator)</pre> - -<div class="note"> -<p><strong>Note </strong>: <code>*</code> — dans ce contexte — est du code Python pour dépiler la liste d'arguments ; cela sépare le tuple d'origine en deux arguments que nous devons passer dans <code>find_element()</code>. Pour plus d'informations et d'exemples, lire <a href="http://docs.python.org/2/tutorial/controlflow.html#unpacking-argument-lists">Unpacking argument lists</a> dans la documentation Python.</p> -</div> - -<p>Un autre exemple de tuple, qui repère via l'attribut <code>id</code> :</p> - -<pre class="brush: python">_add_contact_button_locator = (By.ID, 'add-contact-button')</pre> - -<h2 id="Utilisation_de_tuples_et_By_dans_notre_test_Contacts">Utilisation de tuples et By dans notre test Contacts</h2> - -<p>Maintenant il est temps de réduire la duplication dans notre cas de test <code>test_add_contact.py</code> en déplaçant les repères hors du test vers le périmètre de la classe <code>TestContacts</code> où ils peuvent être partagés. Nous allons vous montrer comment substituer un couple de repères et laisser le reste comme exercice pour le lecteur.</p> - -<p>D'abord vous devez vous assurer d'importer <code>By</code>, en mettant la ligne suivante au début de votre code :</p> - -<pre class="brush: python">from marionette import By</pre> - -<p>Maintenant nous pouvons ajouter nos tuples en haut de la classe <code>TestContacts</code> ; ajoutez les lignes suivantes juste en dessous de la ligne <code>class TestContacts(unittest.TestCase) </code>:</p> - -<pre class="brush: python">_contacts_frame_locator = (By.CSS_SELECTOR, "iframe[data-url*='contacts']") -_save_button_locator = (By.ID, "save-button") -</pre> - -<p>Désormais, vous pouvez parcourir votre code et remplacer toutes les instances de</p> - -<pre class="brush: python">find_element('id', 'save-button')</pre> - -<p>par</p> - -<pre class="brush: python">find_element(*self._save_button_locator)</pre> - -<p>et toutes les instances de</p> - -<pre class="brush: python">find_element('css selector', "iframe[data-url*='contacts']")</pre> - -<p>avec</p> - -<pre class="brush: python">find_element(*self._contacts_frame_locator)</pre> - -<p>Et c'est tout pour le moment. Nous sommes sûrs que vous allez déjà voir les bénéfices de cette réutilisation de code, même dans cet exemple simple. La technique commence à devenir particulièrement efficace dès que vous commencez à écrire des tests plus complexes qui peuvent utiliser le même repère 5, 10 ou 20 fois.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_7_ecrire_vos_propres_tests/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_7_ecrire_vos_propres_tests/index.html deleted file mode 100644 index 77a0cda65b..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_7_ecrire_vos_propres_tests/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: 'Partie 7 : Ecrire vos propres tests' -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_7_Ecrire_vos_propres_tests -tags: - - interface utilisateur -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_7_Writing_your_own_tests ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_6_Marionette_By_class">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_8_Using_a_base_class">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Jusqu'à présent nous vous avons donné la plupart des outils et informations dont vous avez besoin pour commencer à écrire vos propres tests automatisés sur Firefox OS, avec suffisamment d'étapes à suivre pour vous permettre de démarrer rapidement. Dans cette partie nous allons vous lâcher, en vous fournissant des ressources et idées, et ensuite en vous encourageant à faire votre propre chemin. Ici, nous allons vous pousser à écrire vos propres tests - profitez-en !</span></p> -</div> - -<h2 id="Ressources">Ressources</h2> - -<p>Les ressources suivantes seront utiles quand vous commencerez à construire vos propres tests unitaires.</p> - -<ul> - <li>Le <a href="/en-US/Firefox_OS/Using_the_App_Manager">gestionnaire d'applications Firefox OS</a> est un formidable outil pour déboguer Gaia directement sur l'appareil ou sur un simulateur. C'est une bonne manière d'inspecter le code sous-jacent pour trouver quels repères utiliser pour accéder et manipuler des éléments.</li> - <li>Comme mécanisme de contrôle général plus limité mais plus fiable, vous pouvez aussi déposer la source HTML dans la console en utilisant la commande <code>print self.marionette.page_source</code>.</li> - <li>Une autre option est de regarder le HTML brut dans le <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps">dépôt Git de Gaia</a>.</li> - <li>Pour en savoir plus sur les commandes Marionette, lisez les <a href="https://marionette_client.readthedocs.org/en/latest/">documents Marionette</a>.</li> -</ul> - -<h2 id="Idées_pour_des_nouveaux_tests_et_des_modifications_de_tests">Idées pour des nouveaux tests et des modifications de tests</h2> - -<p>Cette section vous fournir un peu d'idées pour vous lancer.</p> - -<h3 id="Modifier_test_add_contact.py">Modifier test_add_contact.py</h3> - -<p>Commençons par modifier le test sur lequel nous avons déjà travaillé :</p> - -<ol> - <li>Faire que le contact testé ait un nom unique à chaque fois.</li> - <li>Supprimer tous les contacts dans l'étape <code>setUp()</code>.</li> - <li>Réveiller l'écran avant le déverrouillage.</li> -</ol> - -<p>Maintenant ajoutons une nouvelle méthode de test. Vous pouvez l'appeler comme vous le souhaitez du moment qu'elle commence par <code>test_</code>. Ce test réalise les choses suivantes :</p> - -<ol> - <li>Ouvrez Contacts.</li> - <li>Créez un contact avec un nom différent de celui créé dans le premier test.</li> - <li>Entrez de nouveau dans le mode édition du contact.</li> - <li>Ajoutez une <em>Société</em>.</li> - <li>Appuyez sur <em>OK</em>.</li> - <li>Vérifiez que l'entreprise est listée.</li> -</ol> - -<p>Maintenant quand vous exécutez le fichier test, les deux tests vont s'exécuter. Nous nous rapprochons de la force de l'automatisation de tests - la capacité d'exécuter une série de tests de manière automatique et de remonter les résultats !</p> - -<h3 id="D'autres_idées_nouvelles_de_tests">D'autres idées nouvelles de tests</h3> - -<ul> - <li>Créer un contact, éditer le contact et changer le nom. Le changement de nom devrait apparaitre sur l'écran.</li> - <li>Créer un contact et appuyer sur l'étoile pour l'ajouter dans les favoris. Sur l'écran principal il devrait s'afficher sous la catégorie des favoris.</li> - <li>Créer un contact avec un numéro de téléphone. Après avoir ouvert le répertoire de contacts et appuyé sur l'icône Message, l'application messages devrait s'ouvrir avec le contact dans le champ des destinataires.</li> -</ul> - -<p> </p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_8_utiliser_une_classe_base/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_8_utiliser_une_classe_base/index.html deleted file mode 100644 index 6529777ae6..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_8_utiliser_une_classe_base/index.html +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: 'Partie 8 : Utiliser une classe base' -slug: >- - Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_8_Utiliser_une_classe_base -tags: - - Automatisation -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_8_Using_a_base_class ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_7_Writing_your_own_tests">« Précédent</a><a href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_9_app_objects">Suivant »</a></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">À présent vous avez des tests multiples et vous sentez probablement que vous avez bien progressé. Pourtant, il existe d'autres manières d'améliorer encore l'efficacité de votre code — vous pouvez remarquer que vous avez dû jusqu'ici inclure les méthodes <code>setUp()</code> et <code>tearDown()</code> dans chaque fichier de test, au fur et à mesure de notre progression. Si vous avez plusieurs douzaines de tests alors il y a beaucoup de duplication de code ! Dans cet article, nous allons regarder comment mettre le code <code>setUp()</code>/<code>tearDown()</code> commun à tous les tests dans une classe <code>TestBase</code>, qui peut ainsi être importée dans chaque fichier de test.</span></p> -</div> - -<h2 id="test_base.py">test_base.py</h2> - -<p>Pour commencer, créez un nouveau fichier nommé <code>test_base.py</code>, dans le même dossier que vos cas de tests existants.</p> - -<p>Ensuite, déplacez vos déclarations relatives à la configuration commune (<code>unittest</code>, <code>Marionette</code> et <code>time</code>) dans le fichier, avec une classe <code>TestBase</code> contenant les méthodes <code>setUp()</code> et <code>tearDown()</code>, et les fonctions d'aide communes (comme <code>unlock_screen()</code>). Le fichier devrait ressembler à cela :</p> - -<pre class="brush: python">import time -import unittest -from marionette import Marionette - - -class TestBase(unittest.TestCase): - - def unlock_screen(self): - self.marionette.execute_script('window.wrappedJSObject.lockScreen.unlock();') - - def kill_all(self): - self.marionette.switch_to_frame() - self.marionette.execute_async_script(""" - // Kills all running apps, except the homescreen. - function killAll() { - let manager = window.wrappedJSObject.AppWindowManager; - - let apps = manager.getApps(); - for (let id in apps) { - let origin = apps[id].origin; - if (origin.indexOf('verticalhome') == -1) { - manager.kill(origin); - } - } - }; - killAll(); - // return true so execute_async_script knows the script is complete - marionetteScriptFinished(true); - """) - - def setUp(self): - # Create the client for this session. Assuming you're using the default port on a Marionette instance running locally - self.marionette = Marionette() - self.marionette.start_session() - - # Unlock the screen - self.unlock_screen() - - # kill all open apps - self.kill_all() - - # Switch context to the homescreen iframe and tap on the contacts icon - time.sleep(2) - home_frame = self.marionette.find_element('css selector', 'div.homescreen iframe') - self.marionette.switch_to_frame(home_frame) - - - def tearDown(self): - # Close the Marionette session now that the test is finished - self.marionette.delete_session() -</pre> - -<h2 id="Mettre_à_jour_vos_fichiers_de_test">Mettre à jour vos fichiers de test</h2> - -<p>Avec la création de votre fichier <code>test_base.py</code>, vous devez importer <code>TestBase</code> dans vos fichiers de test, et les classes de test doivent être changées pour étendre la classe <code>TestBase</code> :</p> - -<pre class="brush: python">import unittest -from marionette import Wait -from marionette import By -from test_base import TestBase - -class TestContacts(TestBase): - - def test(self): - # Tests in here - -if __name__ == '__main__': - unittest.main()</pre> - -<p>Essayez d'exécuter votre fichier de test de nouveau.</p> - -<p>Vous ne devriez pas voir de grande différence maintenant mais si vous avez des douzaines ou des centaines de tests, cela économise beaucoup de code dupliqué.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_9_objets_app/index.html b/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_9_objets_app/index.html deleted file mode 100644 index aecb44aec1..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/gaia-ui-tests/partie_9_objets_app/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: 'Partie 9 : Réduire le code dupliqué avec des objets app' -slug: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Partie_9_objets_app -tags: - - Automatisation -translation_of: Archive/B2G_OS/Automated_testing/gaia-ui-tests/Part_9_app_objects ---- -<p></p><div style="text-align: right;" class="prevnext"> - <p><a style="float: left;" href="/fr/docs/Mozilla/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Part_8_Using_a_base_class">« Précédent</a><br></p> -</div><p></p> - -<div class="summary"> -<p><span class="seoSummary">Dans l'automatisation de tests nous utilisons souvent les objets app pour abstraire le code. Cela réduit la duplication de code et de repères. Si nous avons besoin de changer une section de code commune, nous pouvons la changer juste dans un seul objet <code>app</code>, plutôt que d'avoir à la modifier dans 10 ou 20 fichiers de test. Cet article donne les bases de l'utilisation des objets <code>app</code>.</span></p> -</div> - -<h2 id="Objets_app_bien_démarrer">Objets app : bien démarrer</h2> - -<p>L'objet <code>app</code> est une classe Python qui contient des méthodes et des propriétés qui représentent les actions sur une page. Regardons comment nous pouvons utiliser ceci dans un exemple théorique.</p> - -<h3 id="homepage.py">homepage.py</h3> - -<p>Voici un cadre que nous pouvons utiliser pour l'app Homepage avec un peu de pseudo-code.</p> - -<pre class="brush: python">class Homepage: - __init__(self, marionette): - # Marionette is passed in so that the object can use it - self.marionette = marionette - - def switch_to_homepage_frame(self): - # Code for switching to System then to Homepage frame - - def tap_contacts_icon(self): - # Code to tap the icon - # Switch to Contacts frame - # Now we return the Contacts app object as it has focus - from contacts import Contacts - return Contacts(self.marionette)</pre> - -<h3 id="contacts.py">contacts.py</h3> - -<p>Et voici ce que nous pouvons utiliser pour l'app Contacts, avec encore du pseudo-code.</p> - -<pre class="brush: python">class Contacts: - _new_contact_button = (By.ID, ‘id’) - - def tap_new_contact(self): - # Tap new contact icon - # Wait for event - - def type_given_name(self, name_string): - # element.send_keys(name_string)</pre> - -<h3 id="test_contacts.py"><strong>test_contacts.py</strong></h3> - -<p>Pour comprendre comment cela fonctionne dans le contexte d'un test, voici un exemple rapide qui utilise la classe <code>Homepage</code> :</p> - -<pre class="brush: python">from homepage import Homepage - -def test_add_contact(self): - homepage = Homepage(self.marionette) - homepage.switch_to_homepage_frame() - -contacts = homepage.tap_contacts_icon() -contacts.tap_new_contact()</pre> - -<h2 id="Mettre_à_jour_vos_tests">Mettre à jour vos tests</h2> - -<p>À partir de cela, nous voudrions vous pousser à mettre à jour tous vos fichiers de test pour utiliser le nouveau système d'objets app.</p> - -<p>C'est une tâche difficile si vous n'êtes pas familier avec les structures de classes Python, vous aurez peut-être besoin de consulter quelques livres pour avoir des références et des exemples de code.</p> - -<p>Quand vous aurez fini, idéalement vous aurez une séparation claire entre les fichiers de test :</p> - -<ol> - <li><code>TestBase</code> contiendra les méthodes <code>setUp()</code> et <code>tearDown()</code></li> - <li>Les objets <code>app</code> contiendront les interactions et repères des pages</li> - <li>Vos fichiers de test contiendront uniquement les étapes de test.</li> -</ol> - -<p>Bonne chance !</p> diff --git a/files/fr/archive/b2g_os/automated_testing/index.html b/files/fr/archive/b2g_os/automated_testing/index.html deleted file mode 100644 index 5ec736aa4d..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Test automatisé pour Firefox OS -slug: Archive/B2G_OS/Automated_testing -translation_of: Archive/B2G_OS/Automated_testing ---- -<p></p> - -<div class="summary"> -<p>Vu que Firefox OS est en cours de développement, et que le support pour le nouveau matériel est à venir dans un futur proche, il est important de savoir comment le tester. Cette page présente des articles qui fournissent des informations concernant différents aspects pour le test de Firefox OS, ainsi que l’exécution des tests, l’automatisation, le suivi et l'établissemenr de rapports des résultats.</p> -</div> - -<h2 id="Premiers_pas">Premiers pas</h2> - -<dl> - <dt><a href="/fr/Firefox_OS/Running_Tests_on_Firefox_OS_for_Developers">Exécuter des tests sur Firefox OS: un guide pour les développeurs</a></dt> - <dd> - <p>Un guide rapide, pour les développeurs, pour commencer à exécuter les tests. C’est d’ici que vous devez commencer si vous n’êtes pas confirmés dans l’exécution des tests Mozilla et les systèmes d’automatisation. Si vous l’êtes, vous aurez probablement une idée sur les tests que vous devez exécuter et comment procéder, et vous pouvez aller directement aux guides plus détaillées ci-dessous. </p> - </dd> -</dl> - -<h2 id="Les_tests_Gaia">Les tests Gaia</h2> - -<p>Ces articles couvrent les suites de test primaires destinées à mettre Gaia à l’épreuve.</p> - -<dl> - <dt><a href="/fr/Firefox_OS/Automated_testing/gaia-ui-tests">Tests d'interface utilisateur Gaia</a></dt> - <dd>Tests Python des interactions et caractéristiques de l’interface utilisateur Gaia.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Gaia_integration_tests">Tests d'intégration Gaia</a></dt> - <dd>Tests d’intégration JavaScript pour Gaia, basés sur Marionette.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Gaia_unit_tests" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Gaia_unit_tests">Tests unitaires Gaia</a></dt> - <dd>Tests unitaires sans interaction avec l'interface utilisateur; écrits en JavaScript, et non basés sur Mrionette.</dd> - <dt><a href="/en-US/Firefox_OS/Platform/Automated_testing/Gaia_performance_tests">Tests de performance Gaia</a></dt> - <dd>Mesure des performance de l'application Gaia en se basant sur une instrumentation interne. The testing harness is in-tree.</dd> - <dt><a href="/en-US/Firefox_OS/Automated_testing/Raptor">Raptor: Outils de mesure de performance pour Gaia</a></dt> - <dd>Raptor est un outil qui permet de mesurer la performance spécifique à Firefox OS, qui à pour ambition d'améliorer les outils de test de performance existants.</dd> - <dt><a href="https://github.com/mozilla/b2gperf" title="https://github.com/mozilla/b2gperf">B2GPerf</a></dt> - <dd>Mesure la performance d'applications Gaia, basé sur une cuisine interne.</dd> - <dt><a href="https://wiki.mozilla.org/Project_Eideticker" title="https://github.com/mozilla/eideticker">Eideticker</a></dt> - <dd>Donne des mesures de performance d'applications Gaia, en se basant sur des captures d'écran.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Automated_testing/MTBF_tests">Tests MTBF</a></dt> - <dd>Durée moyenne avant panne(Mean Time Between Failure). Suite de tests lancés sur un périphérique pendant une longue période, essayant de trouver des problèmes de disponibilité de Gaia et de stabilité. (Actuellement, il est dans les mains de l'équipe Qualité à Taiwan et reste un framework de test en développement)</dd> -</dl> - -<h2 id="Les_tests_B2G">Les tests B2G</h2> - -<p>Les tests ci-dessous couvrent différents faisceaux d'essai qui permettent de tester de nombreux aspect et fonctionnalités de B2G.</p> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Mochitests" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Mochitests">Mochitests</a></dt> - <dd>Tests fonctionnels et d'API, basés sur HTML et JavaScript. Les tests n'interagissent pas avec Gaia.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Reftests" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Reftests">Reftests</a></dt> - <dd>Test d'exactitude des rendus des tests Gecko.</dd> - <dt><a href="/en-US/docs/Marionette/Marionette_JavaScript_Tests" title="/en-US/docs/Marionette/Marionette_JavaScript_Tests">WebAPI tests</a></dt> - <dd>Tests des WebAPI Gecko, en se basant sur JavaScript. La majorité de ces tests exigent un émulateur.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/XPCShell" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/XPCShell">xpcshell tests</a></dt> - <dd>Tests 'sans tête' (headless) des API XPCOM de Gecko.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Automated_testing/Cppunit_Tests">Tests cppunit</a></dt> - <dd>Tests unitaires C++ 'sans tête' (headless).</dd> -</dl> - -<h2 id="Supporting_documentation">Supporting documentation</h2> - -<p>Cette section, apporte des liens, sur quelques-unes des technologies de support, sur lesquels les tests Mozilla s'appuient, et pour lesquels vous voudrez surement en savoir plus.</p> - -<dl> - <dt><a href="/en-US/docs/Marionette" title="/en-US/docs/Marionette">Marionette</a></dt> - <dd>Un conducteur de test à distance, basé sur Selenium.</dd> - <dt><a href="/en-US/docs/Marionette/Marionette_JavaScript_Tools">Outils JavaScript Marionette</a></dt> - <dd>Basés sur node.js ils permettent de lancer des tests sur Marionette.</dd> - <dt><a href="/en-US/docs/Marionette/Python_Marionette">Client Python Marionette</a></dt> - <dd>Un client Python pour lancer des tests sur Marionette.</dd> - <dt><a href="https://wiki.mozilla.org/Build:TryServer">Try server</a></dt> - <dd>Serveur de Mozilla permettant de tester les correctifs avant de les intégrer dans le répertoire central. Voir aussi le <a href="http://trychooser.pub.build.mozilla.org/">TryChooser Syntax Builder</a>.</dd> -</dl> - -<div class="note"> -<p><strong>A noter</strong>: Si vous souhaitez lancer Marionette sur une compilation pour la production (pour lancer les tests d'intégration de gaia, gaia-ui-tests, etc.), vous pouvez <a href="https://github.com/mozilla-b2g/marionette-extension">installer Marionette comme une extension</a> (cela fonctionne pour l'instant uniquement sur les compilations en version 1.3, mais le support sera bientôt plus étendu.)</p> -</div> - -<h2 id="Intégration_continue_et_rapport_des_résultats">Intégration continue et rapport des résultats</h2> - -<p>Les articles suivants couvrent les mécanismes d'intégration continue et d'établissement de rapports des résultats utilisés par Mozilla afin de sauvegarder et interpréter les données de test.</p> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Automated_testing/Treeherder">Treeherder</a></dt> - <dd>Comprendre les tests et compilations lancées sur Treeherder.</dd> - <dt><a href="http://raptor-ui.divshot.io">Raptor</a></dt> - <dd>Visualisation des tests de performance lancés avec l'outil <a href="/en-US/Firefox_OS/Automated_testing/Raptor">Raptor</a>.</dd> - <dt><a href="https://wiki.mozilla.org/B2G/Datazilla" title="https://wiki.mozilla.org/B2G/Datazilla">Datazilla [déprécié]</a></dt> - <dd>Comprendre quels tests de performances sont rapportés sur <a href="https://datazilla.mozilla.org/b2g/" title="https://datazilla.mozilla.org/b2g/">Tableau de bord Datazilla</a>, et qu'est ce qu'ils mesurent.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Test_Execution_Chart" title="/en-US/docs/Mozilla/Firefox_OS/Testing/Test_Execution_Chart">Graphe de test d'exécution</a></dt> - <dd>Un graphe montrant quels tests ont été exécutés - sur quels appareils et quand - et quelles sont les plateformes supportées par chaque test.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/automated_testing/marionette_pour_python_interactif/index.html b/files/fr/archive/b2g_os/automated_testing/marionette_pour_python_interactif/index.html deleted file mode 100644 index 729263087f..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/marionette_pour_python_interactif/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Marionette pour du Pyhton interactif -slug: Archive/B2G_OS/Automated_testing/Marionette_pour_Python_interactif -translation_of: Archive/B2G_OS/Automated_testing/Marionette_for_interactive_Python ---- -<p>Ce tutoriel suppose que vous avez <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Setting_up_Marionette" title="https://developer.mozilla.org/en/Mozilla/Boot_to_Gecko/Setting_Up_Marionette_for_B2G">configuré Marionette pour B2G</a>.</p> - -<p>Ouvrez un terminal et lancez Python pour obtenir l'invite interactive :</p> - -<p><code>$ python</code></p> - -<p>Depuis l'invite interactive, exécutez les commandes nécessaire pour invoquer une session Marionette de manière interactive :</p> - -<p><span style='font-family: "Courier New",Courier,monospace;'>>>> from marionette import Marionette<br> - >>> marionette = Marionette('localhost', 2828)<br> - >>> marionette.start_session()<br> - u'session-b2g'</span></p> - -<p>Ici, nous voyons que le système renvoie qu'une session Marionette est en cours d'exécution.</p> - -<p><a class="external" href="http://4.bp.blogspot.com/-wdjTWI_UrH0/Tys1t-VWTMI/AAAAAAAAANM/Hb3pLdPOoMc/s640/Starting+Marionette+Session+Interactively.tiff"><img alt="" class="default" src="http://4.bp.blogspot.com/-wdjTWI_UrH0/Tys1t-VWTMI/AAAAAAAAANM/Hb3pLdPOoMc/s640/Starting+Marionette+Session+Interactively.tiff"></a></p> - -<p>La commande "<code>marionette.execute_script()</code>" peut intégrer des commandes JavaScript, qui peuvent ensuite s'exécuter sur une plateforme B2G. En utilisant ceci, nous pouvons voir quels éléments DOM renvoient des objets HTMLElement ainsi que les attributs et méthodes disponibles :</p> - -<p><span style='font-family: "Courier New",Courier,monospace;'>>>> marionette.execute_script("return navigator.battery;")<br> - {u'onlevelchange': None, u'level': 0.91, u'dischargingTime': None, u'onchargingchange': None, u'ondischargingtimechange': None, u'onchargingtimechange': None, u'chargingTime': None, u'charging': True}<br> - >>> marionette.execute_script("return navigator.battery.level;")<br> - 0.91<br> - >>> marionette.execute_script("return navigator.geolocation;")<br> - {}<br> - >>> marionette.execute_script("return navigator.mozSms;")<br> - {u'onreceived': None, u'ondelivered': None, u'onsent': None}</span></p> - -<p><a class="external" href="http://2.bp.blogspot.com/-WaSbVYa85K0/Tys2-IJC3ZI/AAAAAAAAANU/s7wvpanwmNY/s640/Getting+DOMHTMLelements.tiff"><img alt="" class="default" src="http://2.bp.blogspot.com/-WaSbVYa85K0/Tys2-IJC3ZI/AAAAAAAAANU/s7wvpanwmNY/s640/Getting+DOMHTMLelements.tiff"></a></p> - -<p>Vous pouvez parcourir l'arbre DOM en utilisant cette technique pour évaluer quels objets, méthode et attributs sont disponibles.</p> - -<h2 id="Tester_la_téléphonie_basique_de_manière_interactive">Tester la téléphonie basique de manière interactive</h2> - -<p>Vous pouvez tester de manière interactive la téléphonie de base avec Marionette. L'exemple suivant nécessite deux téléphones en état de fonctionnement, chacun ayant sa carte sim. L'un d'eux est notre Galaxy SII, avec B2G en cours d'exécution.</p> - -<p>Lancez une session Marionette interactive et transférez le port :</p> - -<p><code>$ adb forward tcp:2828 tcp:2828<br> - $ python<br> - >>> from marionette import Marionette<br> - >>> marionette = Marionette('localhost', 2828)<br> - >>> marionette.start_session()<br> - u'5-b2g</code></p> - -<p>À présent, deux approches sont possibles avec Marionette. L'une d'elles est un peu plus<em> Pythonesque </em>:</p> - -<p><code>>>> marionette.set_context("chrome")<br> - True<br> - >>> marionette.execute_script("return navigator.mozTelephony;")<br> - >>> num =<br> - >>> marionette.execute_script("return navigator.mozTelephony.dial('%d');" % num)</code></p> - -<p>Ou la seconde approche qui repose plus sur du JS (embarqué dans <code>marionette.execute_script()</code> ) Remarquez les guillemets autour de la variable JS nombre :</p> - -<p><code>>>> marionette.set_context("chrome")<br> - True<br> - >>> marionette.execute_script("""<br> - ... var num = ""<br> - ... return navigator.mozTelephony.dial(num);<br> - ... """)<br> - {} </code></p> - -<p>Nous allons essayer la première approche :</p> - -<p><a class="external" href="http://3.bp.blogspot.com/-cAsP3Beif4g/Tyxr92r6baI/AAAAAAAAANk/GiMlZsXfFYc/s640/Marionette_interactive_telephony.tiff"><img alt="" class="default" src="http://3.bp.blogspot.com/-cAsP3Beif4g/Tyxr92r6baI/AAAAAAAAANk/GiMlZsXfFYc/s640/Marionette_interactive_telephony.tiff"></a></p> - -<p>Ceci démarre un appel téléphonique, dont la sortie peut être contrôlée dans <code>$adb logcat</code></p> - -<p><a class="external" href="http://4.bp.blogspot.com/-Np12ZkqpRfM/Tyxs3zAf0EI/AAAAAAAAANs/xhr58eU_s00/s640/ADB+LOGCAT+interactive+telephony.tiff"><img alt="" class="default" src="http://4.bp.blogspot.com/-Np12ZkqpRfM/Tyxs3zAf0EI/AAAAAAAAANs/xhr58eU_s00/s640/ADB+LOGCAT+interactive+telephony.tiff"></a></p> diff --git a/files/fr/archive/b2g_os/automated_testing/mtbf_tests/index.html b/files/fr/archive/b2g_os/automated_testing/mtbf_tests/index.html deleted file mode 100644 index 8f624687ac..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/mtbf_tests/index.html +++ /dev/null @@ -1,233 +0,0 @@ ---- -title: MTBF tests -slug: Archive/B2G_OS/Automated_testing/MTBF_tests -translation_of: Archive/B2G_OS/Automated_testing/MTBF_tests ---- -<div class="summary"> -<p>Les essais de MTBF sont une suite de tests de Firefox OS construits au-dessus du framework <a href="https://developer.mozilla.org/en-US/Firefox_OS/Automated_testing/gaia-ui-tests">Gaiatest (Tests IU Gaia)</a> . Les tests effectués sur de vrais dispositifs de Firefox OS, et utilisent <a href="https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette">Marionette </a>pour conduire l'interface utilisateur de l'appareil. Ces tests sont conçus pour mesurer la stabilité / fiabilité de l'application, et de remplacer <a href="https://developer.mozilla.org/en-US/Firefox_OS/Automated_testing/Endurance">les tests d'endurance Gaia</a> maintenant abandonnées.</p> -</div> - -<p><strong>Mean time between failures (MTBF)</strong> is the predicted elapsed time between inherent failures of a system during operation. MTBF can be calculated as the arithmetic mean (average) time between failures of a system. The MTBF is typically part of a model that assumes the failed system is immediately repaired (mean time to repair, or MTTR), as a part of a renewal process. This is in contrast to the mean time to failure (MTTF), which measures average time to failures with the modeling assumption that the failed system is not repaired (infinite repair time).</p> - -<h2 id="Current_Environment_Setup">Current Environment & Setup</h2> - -<p>MTBF tests are run by automation; the test suite collects general test cases like send sms, email, set alarm, etc., and executes them to emulate typical user behavior. Right now we have more than 10 Firefox OS phones concurrently running tests in our test lab.</p> - -<h3 id="How_often_are_the_tests_run">How often are the tests run?</h3> - -<p>MTBF is purposed to test on versions or branches with 0 functional failures. it runs when everything passes in our smoke tests; the testing code should be in the Aurora (next release) branch.</p> - -<h3 id="Where_can_I_see_the_results">Where can I see the results?</h3> - -<p>MTBF is still being developed and you can mail us for an early report (try the <a href="https://lists.mozilla.org/listinfo/dev-b2g">dev-b2g</a> or <a href="https://lists.mozilla.org/listinfo/dev-gaia">dev-gaia</a> mailing lists). You can set up the necessary environment to run the tests yourself and generate your own reports by following the below steps.</p> - -<h2 id="Running_the_tests">Running the tests</h2> - -<p>Let's go through the steps required to set up the Gaia-UI MTBF test environment and run the tests on your local machine and Firefox OS device.</p> - -<h3 id="Prerequisites">Prerequisites</h3> - -<ul> - <li>Ubuntu 12.04 (or better) x64 or Mac OS X (these instructions are confirmed for 10.8 but should work on previous versions of 10, theoretically.)</li> - <li>A Firefox OS device ALREADY FLASHED with an ENGINEERING build of Firefox OS B2G-18 V1-Train (1.1.)</li> - <li><a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB installed</a>, and the environment variable <code>ADB_PATH</code> pointing to your ADB location.</li> -</ul> - -<p>If you are on Ubuntu, you need to check that it is configured to support the USB connection to the Firefox OS device. To verify this, connect the device to your computer via USB, open a terminal and enter the <code>adb logcat</code> command to see if it connects. If not, you may need to set up a <a href="/en-US/Firefox_OS/Firefox_OS_build_prerequisites#For_Linux.3A_configure_the_udev_rule_for_your_phone">udev rule</a> for the device.</p> - -<div class="note"> -<p><strong>Note</strong>: At the point where you start running through the following steps, the Firefox OS device should not be connected to your computer. You will be told when to connect it in the steps below.</p> -</div> - -<h3 id="Step_1_Clone_the_MTBF-Driver_repository_from_Mozilla-TWQA">Step 1: Clone the MTBF-Driver repository from Mozilla-TWQA</h3> - -<p>The Gaia-UI MTBF Tests are located in the Mozilla Github Gaia repository. Assuming that you haven’t done so already, the first step is to clone that repo:</p> - -<pre class="brush: bash">git clone https://github.com/Mozilla-TWQA/MTBF-Driver.git</pre> - -<p>You may want to go get a coffee and come back in five minutes. Furthermore, you can get all the branches and try to switch to the current MTBF branch (e.g. master or v1.4+.) In this case, master matches the current master branch Gaia, and v1.4+ matches the v1.4/v1.3 branch Gaia.</p> - -<h3 id="Step_2_Run_the_GaiaTest_setup">Step 2: Run the GaiaTest setup</h3> - -<p>The Gaia-UI MTBF tests are built upon the GaiaTest framework (which uses <a href="https://developer.mozilla.org/en-US/docs/Marionette" title="Marionette">Marionette</a>). The next step is to run the setup script to install GaiaTest and all of the required dependencies. You may wish to create a new virtual environment to use with the Gaia-UI MTBF Tests. If you don’t, you may need to use <code>sudo</code> while running the setup command. In your terminal, type:</p> - -<pre class="brush: bash">cd MTBF-Driver -python setup.py develop</pre> - -<h3 id="Step_3_Get_memory_tools_if_you_need_them">Step 3: Get memory tools if you need them</h3> - -<p>To access the memory tools, find them in the <code>tools</code> directory in the <code>B2G</code> repo. If you've not already got this, clone it from Github like so (this is also a large download):</p> - -<pre class="brush: bash">git clone https://github.com/mozilla-b2g/B2G.git</pre> - -<p>You should copy the tools folder into the <code>MTBF-Driver/mtbf_drivers</code> directory.</p> - -<h3 id="Step_4_Set_test_vars_and_acknowledge_risks">Step 4: Set test vars and acknowledge risks</h3> - -<p>GaiaTest uses a special file to set certain variables that are required for test configuration, for example to tell the device which WiFi network it should use. Before running the Gaia-UI MTBF Tests, you must set up the test vars file. Make a copy of the <code>gaia/tests/python/gaia-ui-tests/gaiatest/testvars_template.json</code> file in its existing location (rename it to something memorable) and edit it:</p> - -<ul> - <li>If the Firefox OS device has a SIM card, add the corresponding phone number in the phone number field in the <code>carrier</code> section, e.g. <code>"phone_number": "5551234567"</code>.</li> - <li>Add the same phone number inside the <code>"remote_phone_number"</code> field.</li> - <li>In the <code>wifi</code> section, add the SSID for the Wifi network that the Firefox OS device is to connect to during the tests in the <code>ssid</code> field, for example <code>"ssid": "Wifi Network Name"</code>.</li> -</ul> - -<p>Running the Gaia-UI MTBF tests will result in data being erased from the Firefox OS device and microSD card. This is to ensure that the tests start cleanly each time. For example, running a contacts test on a device that already has 10,000 contacts will have very different memory value results compared to running the same test on a device with no existing contacts. In order to run the tests, you must acknowledge that you are aware of this data loss risk. You should also <a href="/en-US/Firefox_OS/Developing_Gaia/Gaia_tools_reference#Backup_and_restore_profile">backup any data</a> you don't want to lose.</p> - -<p>To acknowledge the risks, add the following entry to your <code>testvars</code> file as the first field in the list: <code>"acknowledged_risks": true</code>.</p> - -<div class="note"> -<p><strong>Note</strong>: If the risks are not acknowledged in the <code>testvars</code> file, the tests will not run.</p> -</div> - -<h3 id="Step_5_Connect_to_USB_and_ADB_Forward_the_Device">Step 5: Connect to USB and ADB Forward the Device</h3> - -<p>Attach the Firefox OS device to your computer via USB.</p> - -<div class="note"> -<p><strong>Note</strong>: If you’re using an Ubuntu VM, after attaching the device ensure the VM sees the device and connects to it; in the VM select <strong>VM > Removable Devices > Your Device > Connect</strong> and wait for the device to connect to the VM.</p> -</div> - -<p>Now tell <code>adb</code> to forward the device port to GaiaTest using the following command:</p> - -<pre class="brush: bash">adb forward tcp:2828 tcp:2828</pre> - -<div class="note"> -<p><strong>Note</strong>: If you are using the Firefox OS Leo device, you must first tell ADB to be the root user, like so:</p> - -<pre>adb root -adb forward tcp:2828 tcp:2828</pre> -</div> - -<h3 id="Step_6_Run_a_Test">Step 6: Run a Test</h3> - -<p>Now you’re ready to actually try running a test. Use the following commands:</p> - -<pre class="brush: bash">cd {MTBF Driver Folder} -MTBF_TIME=1d MTBF_CONF=conf/local.json mtbf --address=localhost:2828 --testvars=mytestvars.json</pre> - -<p>We can parse the <code>MTBF_TIME</code> by d(ay), h(our), or m(inute).</p> - -<p>If you get a “connection refused” error it means the device USB connection didn’t work; just repeat the device connection and try again.</p> - -<p>The Firefox OS device b2g process should now restart, then the specified test will run with a single iteration. If you watch the Firefox OS device, you’ll see the device UI being manipulated by Marionette. After the test finishes, a memory checkpoint will be performed.</p> - -<div class="note"> -<p><strong>Note</strong>: The Gaia-UI MTBF tests now grab the Firefox OS device’s b2g process RSS value for the memory use checkpoint (it used to be the V-SIZE value.)</p> -</div> - -<p>The test result will be displayed in the terminal window. Note that this result doesn’t include the b2g process memory value; this value is stored in a text file, created at the time of the checkpoint in the <code>checkpoints</code> directory. To see the resulting b2g process, open this file. This "suite_summary" file will contain the average b2g process memory use (RSS) value, averaged from all the test checkpoints (in our example there was only one checkpoint.)</p> - -<p>There are two other files present in the <code>checkpoints</code> folder (assuming the test run was the "add contact" test):</p> - -<ul> - <li>The <code>checkpoint_add_contact_(datetime)_summary.log</code> file contains a summary for the test run. This includes the number of iterations, all of the RSS value readings from each checkpoint, the average RSS value, etc.</li> - <li>The <code>checkpoint_add_contact_(datetime).log</code> file contains the raw data received from each of the device checkpoints, from which the summary files were produced.</li> -</ul> - -<h3 id="Step_7_Using_Variables_and_Config_Files">Step 7: Using Variables and Config Files</h3> - -<p>We use envrionment variable MTBF_TIME for running duration. The other one is MTBF_CONF which refers to json file, specific runner options include test case repository and list. A normal config file should look like </p> - -<pre><code>{ - "memory_report": false, - "logcat": true, - "overall_status": true, - "b2g_status": true, - "get_event": true, - "rootdir": "tests/mtbf", - "workspace": "/tmp/workspace", - "manifest_prefix": "mtbf", - "archive": "output", - "runlist": "runlist/all.list", - "level": 4 -}</code></pre> - -<ul> - <li>memory_report, locat, overall_status, b2g_status and get event help: options for collecting debug information.</li> - <li>rootdir: root of test case repository for searching and matching in runlist.</li> - <li>workspace: running materials will be stored here for replay.</li> - <li>manifest_prefix: currently not available.</li> - <li>archive: specifying folder for storing report and debug information</li> - <li>runlist: json file by a list of test case file path. Test cases will be randomly picked and put into running queue.</li> - <li>level: specify how often a dummy case (to simulator user not focusing) should be triggered. level 0 is no test will be run, where level 5 means no dummy test enqueued.</li> -</ul> - -<h2 id="Contributing_to_the_project">Contributing to the project</h2> - -<p>If you have any questions about the Firefox OS MTBF tests or are interested in contributing to this important automation development effort, feel free to contact us at wachen@mozilla.com</p> - -<h2 id="How_to_migrate_test_cases_from_Gaia-ui-tests">How to migrate test cases from Gaia-ui-tests</h2> - -<p>This section provides a guide to migrating tests between gaia-ui tests and MTBF.</p> - -<h3 id="Step_1_Rename" dir="ltr">Step 1: Rename</h3> - -<ul> - <li><code>from MtbfTestCase import GaiaMtbfTestCase</code> - - <ul> - <li>(original) <code>from gaiatest import GaiaTestCase</code></li> - </ul> - </li> - <li><code>class XXX(GaiaMtbfTestCase)</code> - <ul> - <li>(original) <code>class XXX(GaiaTestCase)</code></li> - </ul> - </li> - <li>If it has a <code>setUp()</code> or <code>tearDown()</code> method, use <code>GaiaMtbfTestCase</code> - <ul> - <li>(original) <code>GaiaTestCase</code></li> - </ul> - </li> -</ul> - -<h3 id="Step_2_Add" dir="ltr">Step 2: Add</h3> - -<ul> - <li>If there's no <code>setUp()</code> method , add it before the general test function.</li> - <li>Add <code>GaiaMtbfTestCase.setUp(self)</code> as the first step of <code>setUp()</code>. - <ul> - <li>Environment check/recovery and app initialization.</li> - <li><code>launch</code> > <code>launch_by_touch</code> if possible.</li> - <li>Get the handle using <code>self.app_id</code>.</li> - </ul> - </li> - <li>If there's no <code>tearDown()</code> method, add it after the general test function.</li> - <li>Add <code>GaiaMtbfTestCase.tearDown(self)</code> as the last step of <code>tearDown()</code>. - <ul> - <li>Handle data after the test is finished (delete/remove/move/etc.)</li> - </ul> - </li> -</ul> - -<h3 id="Step_3_Principles">Step 3: Principles</h3> - -<ul> - <li>Modify <code>assert()</code> functions in your tests (make sure they work for multiple test cases.)</li> - <li>If porting cases from Gaia-UI-Test, you need to declare <code>app</code> as a test class member.</li> - <li>If multiple apps init/launch in a case; please refer to the <code>card_view</code> cases. - <ul> - <li>Unless your clean actions don't involve UI interactions, avoid this scenario if you can.</li> - <li>For example, use device manager to remove the file on the device.</li> - <li>In such cases, you may need to call <code>marionette.refresh()</code> to get the latest update.</li> - </ul> - </li> - <li>Replace <code>datetime.fromtimestamp</code> with <code>datetime.utcfromtimestamp</code> if you want to implement calendar related cases.</li> -</ul> - -<h3 id="Step_4_About_apps">Step 4: About apps</h3> - -<ol> - <li><code>apps</code> > <code>mtbf_apps</code> if needed.</li> - <li>Import original apps.</li> - <li>Add <code>__init__()</code> and any functions you need.</li> -</ol> - -<h3 id="Step_5_After_you_have_finished">Step 5: After you have finished</h3> - -<ol> - <li>Test each test case using <em>Test full suite > Test full suite with shuffle</em></li> - <li>Check PEP8 errors</li> - <li>Use a pull request to add your test cases to the main repo! Do not push directly.</li> -</ol> diff --git a/files/fr/archive/b2g_os/automated_testing/reftests/index.html b/files/fr/archive/b2g_os/automated_testing/reftests/index.html deleted file mode 100644 index 6bab5de637..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/reftests/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: Firefox OS reftests -slug: Archive/B2G_OS/Automated_testing/Reftests -tags: - - B2G - - Firefox OS - - Tests automatiques -translation_of: Archive/B2G_OS/Automated_testing/Reftests ---- -<div class="summary"> -<p><span class="seoSummary">Les tests de référence (ou reftests), sont des tests simples qui comparent, deux rendus d'interface utilisateur, d'une application web séparément (Des éléments HTML, par exemple) pour vérifier si ils sont identiques ou non. Cet article vous fournit tout ce que vous devez savoir pour lancer la suite reftests de Mozilla sur B2G. Pour en savoir plus sur reftests, lisez <a href="/en-US/docs/Creating_reftest-based_unit_tests">Créer des tests unitaires basés sur reftest (Ressource en anglais)</a>.</span></p> -</div> - -<h2 id="Prérequis_pour_lancer_reftests">Prérequis pour lancer reftests</h2> - -<p>Vous pouvez lancer <a href="/en-US/docs/Creating_reftest-based_unit_tests">reftests</a> sur B2G. Il est principalement essayé sur l'émulateur, mais en théorie doit fonctionner tout aussi bien sur des appareils. Dans cet article <code>$B2G_HOME</code> fait référence au clone du dépôt B2G. Vous trouverez ci-dessous ce que vous aurez besoin de compiler ou paramétrer, avant de pouvoir essayer de lancer les reftests B2G.</p> - -<div class="warning"> -<p>Si vous obtenez ce stacktrace pendant que vous jouez les reftests:</p> - -<p>ImportError: cannot import name expected</p> - -<div class="de2 li2">File "gecko-dev/objdir-b2g-ics-emulator/_tests/reftest/runreftestb2g.py", line <span class="nu0">16</span>, in <module></div> - -<div class="de1 li1"> from b2g_desktop import run_desktop_reftest</div> - -<div class="de2 li2">File "Projects/gecko-dev/objdir-b2g-ics-emulator/_tests/reftest/b2g_desktop.py", line <span class="nu0">14</span>, in <module></div> - -<div class="de2 li2"> from marionette import Marionette, expected</div> - -<div class="de2 li2"> </div> - -<div class="de2 li2">Ceci est un bogue connu sur https://bugzilla.mozilla.org/show_bug.cgi?id=1114474#c7</div> -</div> - -<h3 id="Build_B2G_for_the_target_you're_testing">Build B2G for the target you're testing</h3> - -<p><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Regular B2G build instructions apply</a> — no need for any special build options.</p> - -<p>The B2G config that you will be using (what you pass to <code>./config.sh</code>) will probably be <code>emulator</code> as that is what reftests are typically run on. Before building B2G for the <code>emulator</code> config, pay special attention to the <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Emulator_build_issues" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Emulator_build_issues">Emulator build issues</a> section in the <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites">Firefox OS build prerequisites</a> page.</p> - -<p>As usual, make sure <code>adb</code> is in your path and that it successfully connects to your running emulator or device. Try <code>adb devices</code> to make sure it is working ok.</p> - -<h2 id="Running_reftests">Running reftests</h2> - -<p>Having satisfied the above prerequisites, you can then run reftests using one of the following sets of terminal commands.</p> - -<h3 id="For_the_emulator">For the emulator</h3> - -<p>Use mach:</p> - -<pre>cd $B2G_HOME -./mach reftest-remote</pre> - -<p>This will run all reftests. If you want to run a specific reftest, do the following:</p> - -<pre>cd $B2G_HOME -./mach reftest-remote relative/path/from/B2G/to/reftest.list</pre> - -<h3 id="For_a_real_device"><strong>For a real device</strong></h3> - -<p>Running reftests on a device is not officially supported yet. One problem is that most devices don't support the minimum required resolution (800x1000) for many of the tests. But if you want to try anyway, you should be able to do so using the following steps:</p> - -<pre class="brush: bash">cd $B2G_HOME/objdir-gecko -make package-tests -source _virtualenv/bin/activate -cd dist/test-package-stage/reftest -python runreftestb2g.py --b2gpath $B2G_HOME --xre-path /path/to/dir/containing/desktop/xpcshell --ignore-window-size <code>relative/path/from/B2G/objdir-gecko/to/reftest.list</code></pre> - -<h2 id="Running_crashtests">Running crashtests</h2> - -<p>To run crashtests, do the following:</p> - -<pre>cd $B2G_HOME -./mach crashtest-remote</pre> - -<p>This will run all crashtests. If you want to run a specific crashtest, do the following:</p> - -<pre>cd $B2G_HOME -./mach reftest-remote relative/path/from/B2G/to/crashtests.list</pre> - -<h2 id="Running_jsreftests">Running jsreftests</h2> - -<p>JSReftests are not officially supported yet. See <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=972870">bug 972870</a> for progress updates on adding jsreftests to mach.</p> - -<h2 id="Running_reftest_with_non-default_options">Running reftest with non-default options</h2> - -<p>You can optionally add <code>--total-chunks</code> and <code>--this-chunks</code> arguments as you would with regular desktop reftests. Use:</p> - -<pre class="brush: bash">mach help reftest-remote</pre> - -<p>for a full list of supported arguments.</p> - -<h2 id="Running_reftest_with_a_downloaded_emulator">Running reftest with a downloaded emulator</h2> - -<p>If you've built B2G for another config (like otoro) and want to run the tests on an emulator, you can do so without building an emulator yourself. Just download the latest trunk arm emulator and do the following:</p> - -<pre class="brush: bash">pip install marionette-client -python runreftestb2g.py --emulator arm --b2gpath path/to/emulator --xre-path /path/to/dir/containing/desktop/xpcshell --ignore-window-size <code>--emulator-res 800x1000 <path_to_reftest_manifest></code></pre> - -<h2 id="Running_reftest_with_a_downloaded_emulator_and_downloaded_tests.zip_package">Running reftest with a downloaded emulator and downloaded tests.zip package</h2> - -<p>If you want to run reftests against a downloaded emulator and a downloaded <code>tests.zip</code> package, you should extract them both.</p> - -<p>Then run the following commands:</p> - -<pre class="brush: bash">cd $TESTS_ZIP_DIR/mozbase -python setup_development.py -cd $TESTS_ZIP_DIR/marionette -python setup.py develop -cd $TESTS_ZIP_DIR/reftest -python runreftestb2g.py --emulator arm --b2gpath $EMULATOR_DIR --xre-path /path/to/dir/containing/desktop/xpcshell --ignore-window-size --emulator-res 800x1000 <path_to_reftest_manifest></pre> - -<div class="note"> -<p><strong>Note</strong>: For best results, you should perform the above steps using a <a href="/en-US/docs/Python/Virtualenv" title="/en-US/docs/Python/Virtualenv">Python virtualenv</a>.</p> -</div> - -<h2 id="Troubleshooting">Troubleshooting</h2> - -<p>The following sections provide some answers to common problems encountered when trying to use reftests.</p> - -<h3 id="I_can't_build_the_emulator!">I can't build the emulator!</h3> - -<p>If you have trouble building B2G in the <code>emulator</code> config, check out the <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Emulator_build_issues" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Emulator_build_issues">Emulator build issues</a> section in the <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites">Firefox OS build prerequisites</a> page.</p> - -<h3 id="Check_that_your_B2G_buildemulator_works_and_that_ADB_can_connect_to_it">Check that your B2G build/emulator works and that ADB can connect to it</h3> - -<p>First check that your B2G build runs normally. If this is an emulator build, then <code>./run-emulator.sh</code> should work: it should start up the emulator and boot B2G inside it. If it doesn't, get the log from <code>adb logcat</code> and ask for help. If ADB fails to connect to the running emulator, make sure that you have no other (Android or B2G) devices connected, and try passing in the <code>-e</code> option to tell adb to focus on the emulator:</p> - -<pre class="brush: bash">adb logcat -e</pre> - -<p>Once you have verified that your B2G build/emulator works normally and that ADB can connect to it, the next step is to verify that your xpcshell desktop executable runs normally. If you built B2G for a real device and ADB can't connect to it, check out <a href="/en-US/docs/Mozilla/Firefox_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop">Connecting a Firefox OS device to the desktop</a>.</p> - -<div class="note"> -<p><strong>Note</strong>: None of the errors below should occur if you are using mach. If you have problems with mach, please file a bug under Testing/Reftest and CC :ahal</p> -</div> - -<h3 id="Check_that_you_can_run_your_desktop_xpcshell_executable">Check that you can run your desktop xpcshell executable</h3> - -<p>The <code>python runreftestb2g.py</code> command line above will try to run xpcshell on your desktop with the path specified by the <code>--xre-path</code> argument. Check that running xpcshell from the current directory with this relative path actually works.</p> - -<p>For example, suppose that your command line contains:</p> - -<pre class="brush: bash">--xre-path /hack/mozilla-central/objdir/dist/bin</pre> - -<p>Try running this from the same directory as you want to run <code>python runreftestb2g.py</code> from<code>:</code></p> - -<pre><code class="brush: bash">$ /hack/mozilla-central/objdir/dist/bin/xpcshell</code></pre> - -<p>This should land you in a special-looking shell like this:</p> - -<pre class="brush: bash">js></pre> - -<p>If this fails with an error message complaining about being unable to find or load certain shared libraries, like this</p> - -<pre class="brush: bash">/hack/mozilla-central/objdir/dist/bin/xpcshell: error while loading shared libraries: libxul.so: cannot open shared object file: No such file or directory</pre> - -<p>then you need to set the right environment variable so that it looks for these libraries in the same directory. On Linux, you would set <code>LD_LIBRARY_PATH</code> to the same directory as you want to pass as <code>--xre-path</code>. For example, this should work:</p> - -<pre class="brush: bash">LD_LIBRARY_PATH=<code>/hack/mozilla-central/objdir/dist/bin <code>/hack/mozilla-central/objdir/dist/bin/xpcshell</code></code></pre> - -<p>On Mac OSX, the environment variable to set is <code>DYLD_LIBRARY_PATH</code>.</p> - -<h3 id="Check_that_reftest_can_find_httpd.js">Check that reftest can find httpd.js</h3> - -<p>If reftest still fails to run — returning early with an error — the next most likely cause of trouble is it failing to find certain files that it needs to load. The first file that it could fail to find is <code>httpd.js</code>. Typically, the reason why it would not find it is that you accidentally built xpcshell with <code>--disable-tests</code>. So, make sure that the path you pass to <code>--xre-path</code> does contain a <code>httpd.js</code> file under the <code>components</code> subdirectory.</p> - -<p>This is good:</p> - -<pre class="brush: bash">$ find /hack/mozilla-central/objdir/dist/bin/ -name httpd.js -/hack/mozilla-central/objdir/dist/bin/components/httpd.js -/hack/mozilla-central/objdir/dist/bin/modules/commonjs/sdk/test/httpd.js</pre> - -<p>This is bad (was caused by <code>--disable-tests</code>):</p> - -<pre class="brush: bash">$ find /hack/mozilla-central/objdir/dist/bin/ -name httpd.js -/hack/mozilla-central/objdir/dist/bin/modules/commonjs/sdk/test/httpd.js</pre> - -<h3 id="Check_that_you_didn't_forget_to_make_package-tests">Check that you didn't forget to make package-tests</h3> - -<p>Forgetting the <code>make package-tests</code> step described above would certainly explain why nothing works.</p> - -<h3 id="Check_that_you_passed_a_correct_relative_path_to_the_reftest.list">Check that you passed a correct relative path to the reftest.list</h3> - -<p>The final argumant in the command line running reftest is the <code>relative/path/from/B2G/objdir-gecko/to/reftest.list</code>. This must be a relative path from the <code>B2G/objdir-gecko</code> directory to a <code>reftest.list</code> file under it. So check that a <code>reftest.list </code>file is actually present there! If it isn't, compare your command line to the sample command line below, and/or check that you didn't forget to make <code>package-tests</code> as explained above.</p> - -<p>Sample command line:</p> - -<pre class="brush: bash">$ LD_LIBRARY_PATH=/hack/mozilla-central/objdir/dist/bin python runreftestb2g.py --b2gpath /hack/b2g/B2G/ --xre-path /hack/mozilla-central/objdir/dist/bin --ignore-window-size --emulator arm --emulator-res 800x1000 tests/layout/reftests/css-gradients/reftest.list</pre> - -<p>Here, we are running only the <code>css-gradients</code> directory of reftests.</p> diff --git a/files/fr/archive/b2g_os/automated_testing/test_execution_chart/index.html b/files/fr/archive/b2g_os/automated_testing/test_execution_chart/index.html deleted file mode 100644 index f01bb8274f..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/test_execution_chart/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Tableau d'exécution des tests -slug: Archive/B2G_OS/Automated_testing/Test_Execution_Chart -translation_of: Archive/B2G_OS/Automated_testing/Test_Execution_Chart ---- -<p></p> - -<div class="summary"> -<p>Il y a différentes plate-formes B2G actuellement utilisées par les développeurs. <span class="seoSummary">Le tableau des exécutions de tests montre quels sont les outils de tests supportés pour chaque plate-forme, ainsi que les plate-formes actuellement utilisées pour l'intégration en continu.</span></p> -</div> - -<h2 id="Légende">Légende</h2> - -<ul> - <li>N : Non supporté</li> - <li>S : Supporté</li> - <li>J: Actuellement exécuté dans Jenkins</li> - <li>T: Actuellement exécuté dans TBPL</li> - <li>Tr: Actuellement exécuté avec <a href="https://travis-ci.org/mozilla-b2g/gaia">Travis</a></li> -</ul> - -<table class="standard-table"> - <thead> - <tr> - <th>Outil de test</th> - <th>version b2g pour bureau</th> - <th>émulateur b2g</th> - <th>versions pour appareils</th> - </tr> - </thead> - <tbody> - <tr> - <th>b2gperf</th> - <td style="text-align: center;">N</td> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S J</td> - </tr> - <tr> - <th>eideticker</th> - <td style="text-align: center;">N</td> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S</td> - </tr> - <tr> - <th>tests d'intégration gaia</th> - <td style="text-align: center;">S Tr</td> - <td style="text-align: center;">tbd</td> - <td style="text-align: center;">tbd</td> - </tr> - <tr> - <th>tests ui gaia</th> - <td style="text-align: center;">S T Tr</td> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S J</td> - </tr> - <tr> - <th>tests unitaires gaia</th> - <td style="text-align: center;">S T Tr</td> - <td style="text-align: center;">N</td> - <td style="text-align: center;">N</td> - </tr> - <tr> - <th>tests émulateur webapi</th> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S T</td> - <td style="text-align: center;">N</td> - </tr> - <tr> - <th>mochitests</th> - <td style="text-align: center;">S</td> - <td style="text-align: center;">S T</td> - <td style="text-align: center;">S</td> - </tr> - <tr> - <th>reftests</th> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S T</td> - <td style="text-align: center;">N</td> - </tr> - <tr> - <th>tests xpcshell</th> - <td style="text-align: center;">N</td> - <td style="text-align: center;">S T</td> - <td style="text-align: center;">N</td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/fr/archive/b2g_os/automated_testing/tests_cppunit/index.html b/files/fr/archive/b2g_os/automated_testing/tests_cppunit/index.html deleted file mode 100644 index 3f833b952f..0000000000 --- a/files/fr/archive/b2g_os/automated_testing/tests_cppunit/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Tests Cppunit -slug: Archive/B2G_OS/Automated_testing/Tests_Cppunit -tags: - - Automatisation - - cppunit - - tests -translation_of: Archive/B2G_OS/Automated_testing/Cppunit_Tests ---- -<div class="summary"> -<p><span class="seoSummary">Les tests Cppunit, sont des tests unitaires sans tête (headless) Gecko C++. Vous pouvez lancer les tests Cppunit sur B2G; dans cet article, nous verrons comment les réaliser. Actuellement, les tests sont effectués principalement sur l'émulateur, mais devrait en théorie fonctionner aussi bien sur les appareils.</span></p> -</div> - -<div class="note"> -<p><strong>A noter</strong>: Dans cet article, <code>$B2G_HOME</code> fait référence au clone du dépôt B2G.</p> -</div> - -<h2 id="À_la_dur">À la dur</h2> - -<p>Actuellement, il n'y a pas de commande mach pour lancer les tests cppunit, alors nous sommes cantonnés à les lancer "à la dur".</p> - -<h3 id="Prérequis">Prérequis</h3> - -<ul> - <li>Vous devez compiler B2G pour la cible que vous testez (voir: <a href="/fr/Firefox_OS/Building_and_installing_Firefox_OS">Compiler et installer Firefox OS</a>). Actuellement, seuls les compilations de l'émulateur sont supportés, cependant d'autres appareils peuvent fonctionner.</li> - <li>Vous devez installer quelques paquetages Python, que ce soit pour un environnement virtuel ou autre chose: - <pre>cd $GECKO_DIR/testing/mozbase -python setup_development.py -cd $GECKO_DIR/testing/marionette/client -python setup.py develop -</pre> - </li> - <li>Assurez vous qu'<code>adb</code> soit dans votre variable d'environnement path, ou spécifiez le chemin avec <code>--adbpath</code> (sur Linux il se trouve dans <code>$B2G_HOME/out/host/linux-x86/bin/adb</code><em>.</em>)</li> - <li>Ayez une copie en local de <a href="http://busybox.net/downloads/binaries/latest/busybox-armv6l">Busybox</a> (ce n'est pas strictement nécessaire, mais peut réduire le temps de mise en place de manière significative.)</li> -</ul> - -<h3 id="Lancer_les_tests">Lancer les tests</h3> - -<p>Vous pouvez alors lancer les tests xpcshell en démarrant d'abord un émulateur puis en exécutant les commandes suivante:</p> - -<pre>cd $B2G_HOME/objdir-gecko -make package-tests -cd dist/test-stage/cppunittests -python remotecppunittests.py --xre-path $B2G_HOME/objdir-gecko/dist/bin --adbpath $ADB_PATH --dm_trans=adb --addEnv LD_LIBRARY_PATH=/vendor/lib:/system/lib:/system/b2g <test1> <test2> ...</pre> diff --git a/files/fr/archive/b2g_os/b2g_os_architecture/index.html b/files/fr/archive/b2g_os/b2g_os_architecture/index.html deleted file mode 100644 index 0b01d8807d..0000000000 --- a/files/fr/archive/b2g_os/b2g_os_architecture/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Architecture de B2G OS -slug: Archive/B2G_OS/B2G_OS_Architecture -tags: - - Architecture B2G OS - - B2G - - B2G OS -translation_of: Archive/B2G_OS/Architecture ---- -<h2 id="Cet_article_détaille_l'architecture_de_B2G_OS">Cet article détaille l'architecture de B2G OS</h2> - -<div class="twocolumns"> -<p>B2G OS est constitué de trois couches :</p> - -<ol> - <li><strong>Gaia</strong></li> - <li><strong>Gecko</strong></li> - <li><strong>Gonk</strong></li> -</ol> - -<h3 id="Gaia">Gaia</h3> - -<p>Gaia est l'interface utilisateur ; elle comporte les applications systèmes telles que téléphone, SMS, Horloge, Agenda qui sont réalisées en HTML, CSS et Javascript.</p> - -<p><strong>Code source </strong>: <a href="https://github.com/mozilla-b2g/gaia">https://github.com/mozilla-b2g/gaia</a></p> - -<h3 id="Gecko">Gecko</h3> - -<p>Gecko est le moteur de rendu web qui affiche et traite HTML, CSS et Javascript et qui implémente divers composants <a href="https://discourse.mozilla-community.org/t/why-gaia-apps-are-turned-to-chrome/8011">chrome://</a> et <a href="https://developer.mozilla.org/fr/docs/B2G_OS/API">API Web</a>.</p> - -<p><strong>Code source </strong>: <a href="https://github.com/mozilla/gecko-dev">https://github.com/mozilla/gecko-dev</a></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13803/b2gos.png" style="height: 400px; margin-left: 10px; margin-right: 10px; width: 300px;"></p> -</div> - -<h3 id="Gonk">Gonk</h3> - -<p>Gonk se compose du noyau Android, de la couche d'abstraction matérielle HAL (<a href="https://source.android.com/devices/halref/">Hardware Abstraction Layer</a>) et des pilotes de périphériques.</p> diff --git a/files/fr/archive/b2g_os/bluetooth_api/index.html b/files/fr/archive/b2g_os/bluetooth_api/index.html deleted file mode 100644 index b9c49720fe..0000000000 --- a/files/fr/archive/b2g_os/bluetooth_api/index.html +++ /dev/null @@ -1,223 +0,0 @@ ---- -title: L'API Web Bluetooth -slug: Archive/B2G_OS/Bluetooth_API -tags: - - API - - B2G - - Non-standard - - WebAPI -translation_of: Archive/B2G_OS/Bluetooth_API ---- -<div><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Web_Bluetooth_API">Web Bluetooth API</a></strong></li><li><strong><a href="/fr/docs/Web/API/Archive"><code>Archive</code></a></strong></li><li class="toggle"><details open><summary>Pages liées à Bluetooth API</summary><ol><li><a href="/fr/docs/Web/API/BluetoothAdvertisingData"><code>BluetoothAdvertisingData</code></a></li><li><a href="/fr/docs/Web/API/BluetoothDevice"><code>BluetoothDevice</code></a></li><li><a href="/fr/docs/Web/API/BluetoothGATTCharacteristic"><code>BluetoothGATTCharacteristic</code></a></li><li><a href="/fr/docs/Web/API/BluetoothGATTDescriptor"><code>BluetoothGATTDescriptor</code></a></li><li><a href="/fr/docs/Web/API/BluetoothGATTRemoteServer"><code>BluetoothGATTRemoteServer</code></a></li></ol></details></li></ol></section><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications internes</a> seulement.</p> -</div></div> - -<p>L'API <strong>WebBluetooth</strong> permet à une application web de se connecter à des périphériques Bluetooth. C'est une API complètement expérimentale et non-standard, elle n'est actuellement disponible que pour les applications certifiées. Cependant, il y a de bonnes raisons d'avoir une telle API disponible ; cette question sera examinée dans le cadre du <a class="external external-icon" href="http://www.w3.org/2012/sysapps/">groupe de travail des applications système du W3C</a> .</p> - -<div class="note"> -<p><strong>Remarque:</strong> Les développeurs d'applications qui souhaitent envoyer des données à un périphérique Bluetooth peuvent utiliser <a href="https://developer.mozilla.org/en-US/docs/WebAPI/Web_Activities#Firefox_OS_activities">share activity</a>. Cette activity permet seulement le partage d'images, d'audio, de vidéo et de contenu <a href="https://fr.wikipedia.org/wiki/VCard">vCard</a>.</p> -</div> - -<h2 id="Aperçu_de_l'API">Aperçu de l'API</h2> - -<p>Le principal point d'entrée de l'API est la propriété <a href="/fr/docs/Web/API/Navigator/mozBluetooth" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Navigator.mozBluetooth</code></a> qui retourne un objet <a href="/fr/docs/Web/API/BluetoothManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothManager</code></a>.</p> - -<h3 id="Interfaces_de_base">Interfaces de base</h3> - -<p>Les interfaces suivantes fournissent une application avec les fonctionnalités de base Bluetooth</p> - -<dl> - <dt><a href="/fr/docs/Web/API/BluetoothManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothManager</code></a></dt> - <dd>Permet l'accès à tous les adaptateurs Bluetooth disponibles sur l'appareil. Des adaptateurs sont l'interface de connexion pour connecter un autre périphérique Bluetooth à l'appareil actuel.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothAdapter" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter</code></a></dt> - <dd>Utilisé pour traiter toutes les opérations demandées par les réseaux Bluetooth.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothClassOfDevice" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothClassOfDevice</code></a></dt> - <dd>Fournit identifiant / informations d'un périphérique Bluetooth distant, disponible au stade recherche.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothDevice" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothDevice</code></a></dt> - <dd>Fournit des informations concernant un périphérique Bluetooth distant.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothDiscoveryHandle" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothDiscoveryHandle</code></a></dt> - <dd>Utilisé pour notifier à l'application en cours de la découverte d'un périphérique Bluetooth distant.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothPairingHandle" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothPairingHandle</code></a></dt> - <dd>Contient les fonctionnalités nécessaires pour achever une opération de connexion, y compris les clés d'accès, et les mécanismes pour répondre aux codes PIN saisis par l'utilisateur et confirmer des codes d'authentification.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothPairingListener" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothPairingListener</code></a></dt> - <dd>Définit les gestionnaires d'événements déclenchés pour différentes opérations d'appariement.</dd> -</dl> - -<h3 id="Interfaces_Gatt">Interfaces Gatt</h3> - -<p>Les interfaces suivantes permettent à Firefox OS de communiquer avec les services basés sur <a href="https://developer.bluetooth.org/TechnologyOverview/Pages/GATT.aspx">Gatt (Generic Attribute Profile)</a> sur les périphériques distants Smart/<a href="https://fr.wikipedia.org/wiki/Wibree">LE</a>(intelligent/basse énergie).</p> - -<dl> - <dt><a href="/fr/docs/Web/API/BluetoothGatt" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGatt</code></a></dt> - <dd>Handles de communications initiales et de connexions avec les services Gatt.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothGattServer" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGattServer</code></a></dt> - <dd>Fournit des fonctionnalités serveur Bluetooth GATT pour permettrent la création de services et caractéristiques Bluetooth Smart/LE.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothGattService" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGattService</code></a></dt> - <dd>Représente un service fourni par un serveur GATT, y compris la définition du service, la liste des services inclus, et la liste des caractéristiques de ce service.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothGattCharacteristic" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGattCharacteristic</code></a></dt> - <dd>Représente une caractéristique de service GATT, qui comprend la définition de la caractéristique, la valeur des propriétés et les informations de configuration, et la liste de descripteurs qui fournissent des informations connexes.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothGattDescriptor" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGattDescriptor</code></a></dt> - <dd>Représente un descripteur GATT, qui contient des informations connexes sur une valeur caractéristique.</dd> -</dl> - -<h3 id="Interfaces_d'événements_Bluetooth">Interfaces d'événements Bluetooth</h3> - -<p>Ces objets représentent différents événements ayant lieu au sein d'une interaction Bluetooth.</p> - -<dl> - <dt><a href="/fr/docs/Web/API/BluetoothAdapterEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapterEvent</code></a></dt> - <dd>Donne accès à l'objet <a href="/fr/docs/Web/API/BluetoothAdapter" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter</code></a> et à son adresse comme paramètre d'un gestionnaire d'événement <code><a class="new" href="https://developer.mozilla.org/fr/docs/Web/Events/adapteradded">adapteradded</a></code> ou <code><a class="new" href="https://developer.mozilla.org/fr/docs/Web/Events/adapterremoved">adapterremoved</a></code> (voir <a href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothManager/onadapteradded"><code>BluetoothManager.onadapteradded</code></a> et<a class="new" href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothManager/onadapterremoved"><code> BluetoothManager.onadapterremoved</code></a>).</dd> - <dt><a href="/fr/docs/Web/API/BluetoothAttributeEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAttributeEvent</code></a></dt> - <dd>Permet d'accéder à des attributs modifiés et à leurs nouvelles valeurs par le paramètre <code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/attributechanged">attributechanged</a></code> du gestionnaires d'événements (y compris <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothManager/onattributechanged"><code>BluetoothManager.onattributechanged</code></a>, <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothAdapter/onattributechanged"><code>BluetoothAdapter.onattributechanged</code></a> et<a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothDevice/onattributechanged"><code> BluetoothDevice.onattributechanged</code></a> ).</dd> - <dt><a href="/fr/docs/Web/API/BluetoothDeviceEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothDeviceEvent</code></a></dt> - <dd>Fournit un accès à un périphérique trouvé/apparié (<a href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothDevice"><code>BluetoothDevice</code></a>) ou à l'adresse ou à un dispositif non apparié comme paramètre d'un gestionnaire d'événement <code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/devicefound">devicefound</a></code>,<code> </code><code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/devicepaired">devicepaired</a></code> ou <code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/deviceunpaired">deviceunpaired</a></code>.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothGattCharacteristicEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothGattCharacteristicEvent</code></a></dt> - <dd>Fournit un accès à une mise à jour <a href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothGattCharacteristic"><code>BluetoothGattCharacteristic</code></a> comme paramètre du gestionnaire <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothGatt/oncharacteristicchanged"><code>BluetoothGatt.oncharacteristicchanged</code></a>, lorsque l'événement <code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/characteristicchanged">characteristicchanged</a></code> est déclenché.</dd> - <dt><a href="/fr/docs/Web/API/BluetoothLeDeviceEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothLeDeviceEvent</code></a></dt> - <dd>Permet d'accéder à un objet <a href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothDevice"><code>BluetoothDevice</code></a> de <a href="https://fr.wikipedia.org/wiki/Wibree">LE</a>, à sa valeur <a href="https://fr.wikipedia.org/wiki/Received_Signal_Strength_Indication">RSSI</a> et son annonce d'enregistrement, par le paramètre d'un gestionnaire d'événement <code><a class="new" href="https://developer.mozilla.org/en-US/docs/Web/Events/devicefound">devicefound</a></code> (voir<a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothDiscoveryHandle/ondevicefound"><code> BluetoothDiscoveryHandle.ondevicefound</code></a>).</dd> - <dt><a href="/fr/docs/Web/API/BluetoothPairingEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothPairingEvent</code></a></dt> - <dd>Permet d'accéder à un nom de dispositif et à l'objet <a href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothPairingHandle"><code>BluetoothPairingHandle</code></a> requis pour l'association de périphériques (incluant par exemple <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/BluetoothPairingListener/ondisplaypasskeyreq"><code>BluetoothPairingListener.ondisplaypasskeyreq</code></a> et<a class="new" href="https://developer.mozilla.org/fr/docs/Web/API/BluetoothPairingListener/onenterpincodereq"><code> BluetoothPairingListener.onenterpincodereq</code></a>).</dd> -</dl> - -<h3 id="Les_messages_du_système">Les messages du système</h3> - -<p>Comme certaines actions de périphériques distants peuvent nécessiter le réveil d'une application pour les manipuler, il y a plusieurs messages système liés à Bluetooth:</p> - -<ul> - <li><code>bluetooth-dialer-command</code></li> - <li><code>bluetooth-cancel</code></li> - <li><code>bluetooth-hid-status-changed</code></li> - <li><code>bluetooth-pairing-request</code></li> - <li><code>bluetooth-opp-transfer-complete</code></li> - <li><code>bluetooth-opp-update-progress</code></li> - <li><code>bluetooth-opp-receiving-file-confirmation</code></li> - <li><code>bluetooth-opp-transfer-start</code></li> -</ul> - -<div class="note"> -<p><strong>Note :</strong> une application peut réagir à ces messages en les demandant dans son <a href="https://developer.mozilla.org/fr/Apps/Build/Manifest">fichier manifeste</a> et en utilisant la fonction <a class="new" href="https://developer.mozilla.org/fr/docs/Web/API/Navigator/mozSetMessageHandler"><code>navigator.mozSetMessageHandler()</code></a> pour définir un gestionnaire de messages.</p> -</div> - -<h3 id="Interfaces_obsolètes">Interfaces obsolètes</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/BluetoothStatusChangedEvent" title="L'API BluetoothStatusChangedEvent donne accès aux informations de modification du statut de l'équipement Bluetooth."><code>BluetoothStatusChangedEvent</code></a></dt> - <dd>Fournit un accès à l'information concernant tout changement d'état d'un périphérique Bluetooth.</dd> -</dl> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td><a class="external" href="https://webbluetoothcg.github.io/web-bluetooth/" hreflang="en" lang="en" title="La spécificaction 'Web Bluetooth'">Web Bluetooth</a></td> - <td><span class="spec-Draft">Projet</span></td> - <td>Brouillon. Ne fait partie d'aucune spécification à l'heure actuelle. Doit être discuté avec le <a href="http://www.w3.org/2012/sysapps/">W3C's System Applications Working Group</a>.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div><p class="warning"><strong><a href="https://github.com/mdn/browser-compat-data">Nous convertissons les données de compatibilité dans un format JSON</a></strong>. - Ce tableau de compatibilité utilise encore l'ancien format - car nous n'avons pas encore converti les données qu'il contient. - <strong><a href="/fr/docs/MDN/Contribute/Structures/Compatibility_tables">Vous pouvez nous aider en contribuant !</a></strong></p> - -<div class="htab"> - <a id="AutoCompatibilityTable" name="AutoCompatibilityTable"></a> - <ul> - <li class="selected"><a>Ordinateur</a></li> - <li><a>Mobile</a></li> - </ul> -</div></div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Support simple</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Android</th> - <th>Android Webview</th> - <th>Firefox Mobile (Gecko)</th> - <th>Firefox OS</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - <th>Chrome for Android</th> - </tr> - <tr> - <td>Bluetooth 'v2' support</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td>2.1</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - <tr> - <td>Bluetooth initial support: <code>BluetoothManager</code>, <code>BluetoothAdapter</code>, <code>BluetoothDevice</code>, <code>BluetoothDeviceEvent</code>, <code>BluetoothStatusChangedEvent</code></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td>1.0.1</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Notes_de_compatibilité">Notes de compatibilité</h3> - -<ul> - <li>L'API Web Bluetooth est implémenté dans Firefox OS 1.0.1 et au-dessus.</li> - <li>Cependant, sur Firefox OS <1.2, vous devez être prudent avec le partage de fichiers Bluetooth. Si vous partagez un fichier directement à partir de la SDCard vous êtes ok, mais si vous partagez un blob d'image directement depuis l'appareil via une application Web vous rencontrerez des problèmes, parce que Bluetooth attend un chemin d'accès valide via la SDCard (voir <a class="external external-icon" href="https://github.com/mozilla-b2g/gaia/blob/v1.0.1/apps/bluetooth/js/transfer.js#L277">1.0.1 B2G app Gaia Bluetooth</a>). Ceci est <a class="external external-icon" href="https://github.com/mozilla-b2g/gaia/blob/15b019e3acbbc111652640c6ef95882e90d65e18/apps/bluetooth/js/transfer.js#L159-L179">fixé dans Firefox OS 1.2</a>. Dans Firefox <1.2 vous auriez à écrire sur une carte SD via <a href="https://developer.mozilla.org/fr/docs/WebAPI/Device_Storage">le périphérique de stockage</a>, puis à transférer via Bluetooth.</li> - <li>Il y a une complication supplémentaire : le stockage du périphérique est uniquement disponible pour les applications privilégiées (empaquetées), donc si votre application est hébergée, vous ne pouvez pas utiliser le stockage de périphériques pour résoudre le problème ci-dessus.</li> - <li>Un autre problème que vous pouvez rencontrer lorsque vous tentez d'utiliser le partage de fichiers Bluetooth entre Firefox OS et un autre dispositif est que l'autre périphérique peut ne pas avoir de partage Bluetooth (Firefox OS est activé par défaut.) Pour exemple sur Mac OSX 10.9 il est allumé via <em>System Preferences > Sharing > check "Bluetooth Sharing"</em>. </li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API/Using_the_Web_Bluetooth_API">Utilisation de l'API Web Bluetooth</a></li> -</ul> - -<p> </p> - -<p> </p> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/chirimen_faq/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/chirimen_faq/index.html deleted file mode 100644 index ec8a0fcd1a..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/chirimen_faq/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: FAQ CHIRIMEN -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/CHIRIMEN_FAQ -tags: - - Boot to Gecko - - CBC - - MozOpenHard -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/CHIRIMEN_FAQ ---- -<h2 id="FAQ_sur_CHIRIMEN">FAQ sur CHIRIMEN</h2> - -<p style="line-height: 1.656; margin-top: 0pt; margin-bottom: 0pt;" dir="ltr"> </p> - -<p><strong>déplacée vers : </strong><a href="https://chirimen.org/docs/en/FAQ.html">https://chirimen.org/docs/en/FAQ.html</a></p> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/index.html deleted file mode 100644 index 7bb603c9f4..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: CHIRIMEN -slug: Archive/B2G_OS/Board_guide/CHIRIMEN -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p>Une communauté de <a href="http://ja.mozillafactory.org/">Mozilla Factory</a>, appelée "<a href="http://mozopenhard.mozillafactory.org/">MozOpenHard Project</a>", est en train de développer une puissante carte développeur sous <a href="https://wiki.mozilla.org/B2G">B2G</a> (version OSS de Firefox OS) avec des APIs Web pour le contrôle du matériel (I2C et GPIO). L'environnement qui comporte aussi bien le matériel que le logiciel est appelé CHIRIMEN. Il est en cours de développement et n'est pas encore prêt pour être commercialisé.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: La version japonaise de cette page est actualisée en premier.</p> -</div> - -<h2 id="À_propos_de_CHIRIMEN">À propos de CHIRIMEN</h2> - -<p dir="ltr" id="docs-internal-guid-c108f47b-5781-ba06-59cc-bf9a1a4a56cd" style="line-height: 1.656; margin-top: 0pt; margin-bottom: 0pt;"><span style="background-color: transparent; color: #000000; font-family: arial; font-size: 14.666666666666666px; font-style: normal; font-variant: normal; font-weight: 400; text-decoration: none; vertical-align: baseline;">CHIRIMEN est un environnement de développement pour contrôler des périphériques physiques, comme des capteurs et des actionneurs, qui utilisent des technologies Web. C'est le terme fourre-tout pour à la fois l'ordinateur monocarte et son logiciel.</span></p> - -<p dir="ltr" style="line-height: 1.656; margin-top: 0pt; margin-bottom: 0pt;"><span style="background-color: transparent; color: #000000; font-family: arial; font-size: 14.666666666666666px; font-style: normal; font-variant: normal; font-weight: 400; text-decoration: none; vertical-align: baseline;">Le paquet contient le matériel de l'ordinateur monocarte, le logiciel Boot to Gecko le faisant fonctionner et la version des APIs de bas-niveau telles que WebGPIO et WebI2C qui peuvent contrôler les capteurs et périphériques grâce à JavaScript. Il a été développé par la communauté MozOpenHard au Japon et le nom de code CHIRIMEN lui a été donné.</span></p> - -<p><span style="background-color: transparent; color: #000000; font-family: arial; font-size: 14.666666666666666px; font-style: normal; font-variant: normal; font-weight: 400; text-decoration: none; vertical-align: baseline;">Le code du matériel et du logiciel de CHIRIMEN sera bientôt rendu open source.</span></p> - -<p><a href="/en-US/docs/Mozilla/Firefox_OS/Board_guide/CHIRIMEN/CHIRIMEN_FAQ">FAQ</a></p> - -<h2 id="Obtenir_une_carte">Obtenir une carte</h2> - -<dl> - <dt>Carte assemblée</dt> - <dd>Il n'est pas possible pour l'instant d'acheter cette carte, elle est toujours en développement. Il est prévu que le prix soit inférieur à 50 dollars.</dd> - <dt>Code source du matériel et du logiciel</dt> - <dd>Il est en cours de préparation pour être distribué au public en open source. </dd> - <dt>Comment obtenir l'image de l'OS</dt> - <dd>Voir<a href="/fr/docs/Mozilla/B2G_OS/Board_guide/CHIRIMEN/OS_Image"> cette </a>page.</dd> -</dl> - -<h2 id="Guide_de_démarrage_rapide">Guide de démarrage rapide</h2> - -<p>Voir la <a href="/fr/docs/Mozilla/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide">page d'accueil démarrage rapide</a></p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous trouverez plus d'informations sur les spécifications de l'appareil sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page de spécifications des téléphones et appareils</a>.</p> - -<h3 id="Matériel">Matériel</h3> - -<ul> - <li>SoC RK3066</li> - <li>DDR3 1Go (RAM)</li> - <li>NAND Flash 1Go</li> - <li>1 slot MicroSD</li> - <li>Vidéo micro HDMI femelle</li> - <li>Dimensions 80 mm x 48 mm</li> - <li>USB microUSB x 1 (OTG) , USB x 1 , microUSB x 1 (débogage UART)</li> - <li>WiFI (absent de la carte. <span class="_5yl5"><span>Utilisez un adaptateur USB WiFi compatible RTL8188CUS</span></span>)</li> - <li>GPIO >1(configurable)</li> - <li>I2C 2</li> - <li>UART 2</li> - <li>SPI 2</li> - <li>Audio stéréo analogique IN x 1 / OUT x 1</li> - <li>PWM 1</li> - <li>Analogique IN x 1</li> -</ul> - -<h2 id="EditDépôt"><a class="button section-edit only-icon" href="https://developer.mozilla.org/ja/docs/Mozilla/Firefox_OS/Board_guide/CHIRIMEN$edit#リポジトリ"><span>Edit</span></a>Dépôt</h2> - -<ul> - <li><a class="external external-icon" href="https://github.com/chirimen-oh">https://github.com/chirimen-oh</a></li> - <li><a class="external external-icon" href="https://github.com/chirimen-oh/CHIRIMEN-tools">https://github.com/chirimen-oh/CHIRIMEN-tools</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/os_image/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/os_image/index.html deleted file mode 100644 index 83bebc0961..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/os_image/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Comment obtenir l'image de l'OS -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/OS_Image -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/OS_Image ---- -<h2 id="Comment_obtenir_l'image_de_l'OS">Comment obtenir l'image de l'OS</h2> - -<p>Cette section donne les instructions pour mettre à jour B2G sur votre carte CHIRIMEN.<br> - <br> - voir aussi <a href="https://github.com/MozOpenHard/CHIRIMEN/wiki/Setup">https://github.com/MozOpenHard/CHIRIMEN/wiki/Setup</a></p> - -<div class="note"> -<p><strong>À FAIRE : écrire les instructions.</strong></p> -</div> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/basic_startup/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/basic_startup/index.html deleted file mode 100644 index 9d948af50b..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/basic_startup/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Section Mise en route -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/basic_startup -tags: - - CHIRIMEN -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/basic_startup ---- -<p>Page déplacée sur <a href="https://chirimen.org/docs/en/basic_startup.html">chirimen.org.</a></p> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/board_connectors/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/board_connectors/index.html deleted file mode 100644 index 7e720fd668..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/board_connectors/index.html +++ /dev/null @@ -1,163 +0,0 @@ ---- -title: Disposition des connecteurs -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/board_connectors -tags: - - CHIRIMEN - - Connecteurs -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/board_connectors ---- -<p>Cette section présente la disposition des connecteurs et des interrupteurs d'un ordinateur monocarte CHIRIMEN. </p> - -<h2 id="Disposition_des_connecteurs">Disposition des connecteurs</h2> - -<p><img alt="chirimen_board_front" src="http://svg2.mbsrv.net/chirimen/MDNresources/chirimen_board_front.jpg" style="height: 360px; width: 756px;"></p> - -<p><img alt="chirimen_board_back" src="http://svg2.mbsrv.net/chirimen/MDNresources/chirimen_board_back.jpg" style="height: 360px; width: 756px;"></p> - -<ol> - <li>USB OTG<br> - Port USB de type MicroUSB Type B utilisé pour brancher l'ordinateur hôte pour les développements.</li> - <li>Connecteur vidéo de type Micro HDMI<br> - Connecteur pour brancher un moniteur vidéo HDMI.</li> - <li>USB UART<br> - Ce connecteur n'est pas utilisé dans de nombreux cas. Le signal produit par le Soc et en provenance du port UARTx est sorti ici converti en USB.</li> - <li>Entrée alimentation 5V<br> - C'est un connecteur pour l'alimentation de 5V avec un diamètre externe de 2, 5 mm.</li> - <li>USB HOST<br> - Port USB Type A pour brancher un adaptateur réseau, un périphérique de pointage etc.</li> - <li>Interrupteur du mode de récupération<br> - Interrupteur essentiellement utilisé lors de la mise à jour d'un système d'exploitation.</li> - <li>CN1 (Connecteur1)<br> - C'est un groupe de broches d'entrées/sorties à usage générique constituant un point central où sont collectés les signaux tels que GPIO, I2C, émetteur-récepteur universel synchrone-asynchrone et SPI. Se référer au chapitre suivant pour la signification de chaque broche de ce connecteur.</li> - <li>CN2 (Connecteur2)<br> - C'est un autre groupe de broches d'entrées/sorties à usage générique.</li> - <li>Slot Micro SD<br> - C'est un slot MicroSD. Il n'est pas supporté par le système d'exploitation à la date de février 2016.</li> -</ol> - -<h2 id="Brochage_de_l'interface_ES_à_usage_générique">Brochage de l'interface E/S à usage générique</h2> - -<table> - <tbody> - <tr> - <th> </th> - <th>CN1 (Connecteur1)</th> - <th> </th> - <th>CN2 (Connecteur2)</th> - </tr> - <tr> - <th>Numéro</th> - <th>Description</th> - <th> </th> - <th>Description</th> - </tr> - <tr> - <td>1</td> - <td>GND</td> - <td> </td> - <td>GND</td> - </tr> - <tr> - <td>2</td> - <td>I2C-2 SDA</td> - <td> </td> - <td>GND</td> - </tr> - <tr> - <td>3</td> - <td>I2C-2 SCL</td> - <td> </td> - <td>GND</td> - </tr> - <tr> - <td>4</td> - <td>UART-3 RX</td> - <td> </td> - <td>GND</td> - </tr> - <tr> - <td>5</td> - <td>UART-3 TX</td> - <td> </td> - <td>Sortie audio G</td> - </tr> - <tr> - <td>6</td> - <td>ADC-0 in</td> - <td> </td> - <td>Sortie audio D</td> - </tr> - <tr> - <td>7</td> - <td>SPI-0 CS</td> - <td> </td> - <td>Entrée audio G</td> - </tr> - <tr> - <td>8</td> - <td>SPI-0 CLK</td> - <td> </td> - <td>Entrée audio D</td> - </tr> - <tr> - <td>9</td> - <td>SPI-0 RX</td> - <td> </td> - <td>GND audio</td> - </tr> - <tr> - <td>10</td> - <td>SPI-0 TX</td> - <td> </td> - <td>PWM-0</td> - </tr> - <tr> - <td>11</td> - <td>SPI-1 CS</td> - <td> </td> - <td>I2C-0 SCL</td> - </tr> - <tr> - <td>12</td> - <td>SPI-1 CLK</td> - <td> </td> - <td>I2C-0 SDA</td> - </tr> - <tr> - <td>13</td> - <td>SPI-1 RX</td> - <td> </td> - <td>UART-0 TX</td> - </tr> - <tr> - <td>14</td> - <td>SPI-1 TX</td> - <td> </td> - <td>UART-0 RX</td> - </tr> - <tr> - <td>15</td> - <td>GND</td> - <td> </td> - <td>GPIO-6 A1</td> - </tr> - <tr> - <td>16</td> - <td>VCC 3.3V</td> - <td> </td> - <td>Power ON</td> - </tr> - <tr> - <td>17</td> - <td>VCC 3.3V</td> - <td> </td> - <td>GND</td> - </tr> - <tr> - <td>18</td> - <td>VCC 5V</td> - <td> </td> - <td>VSYS 5V</td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/dev_windows/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/dev_windows/index.html deleted file mode 100644 index 7d08b3bd7f..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/dev_windows/index.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Version Windows de la section Préparation de l'environnement de développement -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/dev_windows -tags: - - CHIRIMEN - - Firefox WebIDE -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/dev_windows ---- -<p>Page déplacée vers <a href="https://chirimen.org/docs/en/dev_windows.html">chirimen.org</a>.</p> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/firmware_update_guide_for_windows/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/firmware_update_guide_for_windows/index.html deleted file mode 100644 index 85a13a85d4..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/firmware_update_guide_for_windows/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Guide de mise à jour du firmware pour windows -slug: >- - Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/firmware_update_guide_for_windows -tags: - - CHIRIMEN - - Windows -translation_of: >- - Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/firmware_update_guide_for_windows ---- -<p>Page déplacée vers <a href="https://chirimen.org/docs/en/firmware_update_guide_for_windows.html">chrimen.org.</a></p> diff --git a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/index.html b/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/index.html deleted file mode 100644 index 86434da533..0000000000 --- a/files/fr/archive/b2g_os/board_guide/chirimen/quick_start_guide/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Guide de démarrage rapide CHIRIMEN -slug: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide -translation_of: Archive/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide ---- -<p>Pour débuter avec CHIRIMEN, consultez nos guides de démarrage rapide : </p> - -<ul> - <li>La <a href="/fr/docs/Mozilla/B2G_OS/Board_guide/CHIRIMEN/Quick_start_guide/board_connectors">disposition des connecteurs </a>d'une carte CHIRIMEN </li> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Board_guide/CHIRIMEN/Quick_start_guide/basic_startup">Section Démarrage</a></li> - <li>Section préparation de l'environnement de développement - <ul> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Board_guide/CHIRIMEN/Quick_start_guide/dev_windows">Windows</a></li> - <li>MacOSX</li> - <li>Linux</li> - </ul> - </li> - <li>Section mise à jour de l'OS - <ul> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Board_guide/CHIRIMEN/Quick_start_guide/firmware_update_guide_for_windows">Windows</a></li> - <li>Linux (MacOSX)</li> - </ul> - </li> -</ul> - -<p>Note : Les articles sans lien sont en cours de réalisation.</p> diff --git a/files/fr/archive/b2g_os/board_guide/index.html b/files/fr/archive/b2g_os/board_guide/index.html deleted file mode 100644 index 1bb20aff0a..0000000000 --- a/files/fr/archive/b2g_os/board_guide/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Guide des cartes Firefox OS -slug: Archive/B2G_OS/Board_guide -tags: - - Cartes - - Firefox OS -translation_of: Archive/B2G_OS/Board_guide ---- -<div class="summary"> -<p><span class="seoSummary">Cette section contient des informations à destination des développeurs, en rapport avec des téléphones spécifiques sous Firefox OS — à la fois des appareils développeurs et utilisateurs.</span> Des informations génériques sont disponibles pour <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko" title="Building and installing Firefox OS">Compiler et installer Firefox OS</a> et <a href="/fr/Firefox_OS/Developing_Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS/Hacking_Firefox_OS">Développer Firefox OS</a>. Veuillez vous y rendre pour construire et installer la plate-forme à partir de zéro. Les développeurs en possession de téléphones particuliers peuvent cependant trouver les articles suivants utiles.</p> -</div> - -<h2 id="Informations_sur_les_cartes_développeur">Informations sur les cartes développeur</h2> - -<p>Les cartes ci-dessous sont spécialement destinées aux développeurs qui veulent expérimenter Firefox OS, en développant des applications ou en contribuant au système d'exploitation lui-même. </p> - -<dl> - <dt>Raspberry Pi</dt> - <dd>Cet article contient des informations sur le Raspberry Pi avec Firefox OS.</dd> - <dt><a href="https://developer.mozilla.org/en-US/Firefox_OS/Board_guide/CHIRIMEN">CHIRIMEN</a></dt> - <dd>Cet article contient des informations sur la carte de développement Firefox OS CHIRIMEN.</dd> -</dl> - -<h2 id="Informations_générales_sur_Firefox_OS">Informations générales sur Firefox OS</h2> - -<dl> - <dt><a href="/en-US/Firefox_OS/Phone_guide/Phone_specs">Données sur les téléphones Firefox OS</a></dt> - <dd>Dans cet article sont listés les différents téléphones Firefox OS disponibles accompagnés d'informations telles que leurs noms de code, leur disponibilité et leurs caractéristiques matérielles spécifiques.</dd> - <dt><a href="/en-US/Firefox_OS/Phone_guide/Firefox_OS_device_features">Caractéristiques des appareils</a></dt> - <dd>Cette page recense les caractéristiques matérielles classiques sous Firefox OS et les configurations matérielles minimales requises.</dd> - <dt><a href="/en-US/Firefox_OS/Troubleshooting">Dépannage</a></dt> - <dd>Cet article propose des astuces pour résoudre les problèmes les plus couramment rencontrés en utilisant Firefox OS.</dd> - <dt><a href="/en-US/Firefox_OS/Phone_guide/Best_practices_open_reference_devices">Bonnes pratiques pour appareils de référence ouverts</a></dt> - <dd>Un ensemble de bonnes pratiques que nous considérons comme devant être recommandées pour tout appareil de référence ouvert disponible. Tous les appareils de référence Firefox OS récents ont respecté ces pratiques.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/appareils_compatibles/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/appareils_compatibles/index.html deleted file mode 100644 index 8eb4bbec5a..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/appareils_compatibles/index.html +++ /dev/null @@ -1,360 +0,0 @@ ---- -title: Appareils compatibles -slug: Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles -tags: - - Téléphones B2G OS - - Téléphones supportés par B2G OS -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices ---- -<div class="note"> -<p><strong>Installez facilement B2G OS sur votre appareil</strong> avec <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_installer_add-on">B2G installer </a>- un module Firefox.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Chaque appareil a <strong>sous son nom la cible de construction recommandée</strong> (voir <strong>nom de code ou surnom</strong>). Par exemple, pour compiler pour le Nexus 6, utilisez<code> ./build.sh nexus-6-l</code>.<span class="rendered_qtext"> Les noms de code des appareils sont donnés directement par les fabricants. Vous pouvez les trouver dans le fichier <code>build.prop</code> d'une ROM stock.</span></p> -</div> - -<h2 id="Appareils_de_développement">Appareils de développement</h2> - -<p>Ce sont les appareils de référence officiels pour le développement de B2G OS.</p> - -<table class="standard-table" style="height: 380px; width: 680px;"> - <tbody> - <tr> - <td style="text-align: center;"><strong>Image</strong></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/13384/Z3C_B2G.png" style="height: 154px; width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12039/generic.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12039/generic.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom<br> - (version Android)</strong></td> - <td style="text-align: center;"><strong>Z3 Compact (Kitkat)</strong><br> - Plate-forme Sony Shinano</td> - <td style="text-align: center;"><strong>Z3</strong> <strong>(Kitkat)</strong><br> - Plate-forme Sony Shinano</td> - <td style="text-align: center;"><strong>Flame (Kitkat)</strong></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom de code</strong></td> - <td style="text-align: center;">aries-kk</td> - <td style="text-align: center;">leo-kk</td> - <td style="text-align: center;">flame-kk</td> - </tr> - <tr> - <td style="text-align: center;"><strong>Build et instructions d'installation</strong></td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/building-b2g-os-for-aries-z3c/8082">https://discourse.mozilla-community.org/t/building-b2g-os-for-aries-z3c/8082</a></td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/flame-builds/8548">https://discourse.mozilla-community.org/t/flame-builds/8548</a></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Disponible dans B2G Installer</strong></td> - <td style="text-align: center;">Oui</td> - <td style="text-align: center;">Non</td> - <td style="text-align: center;">Oui</td> - </tr> - </tbody> -</table> - -<h2 id="Appareils_supportés_par_la_communauté">Appareils supportés par la communauté</h2> - -<p>Ces appareils sont pris en charge grâce aux efforts de la communauté. N'hésitez pas à y contribuer !</p> - -<div class="note"> -<p><strong>La fréquence de distribution des builds peut fortement varier</strong> selon le nombre de mainteneurs et le temps disponible.</p> -</div> - -<h3 id="Appareils_fonctionnels">Appareils fonctionnels</h3> - -<p>Ces appareils disposent de builds pour faire tourner B2G OS :</p> - -<table class="standard-table" style="height: 380px; width: 355px;"> - <tbody> - <tr> - <td style="text-align: center;"><strong>Image</strong></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12039/generic.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12035/nexus5.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/13665/WileyFoxSwift_B2G.png" style="height: 157px; width: 79px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12039/generic.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom<br> - (version Android)</strong></td> - <td style="text-align: center;"><strong>ZTE Open C</strong></td> - <td style="text-align: center;"><strong>Nexus 5</strong></td> - <td style="text-align: center;"><strong>WileyFox Swift</strong></td> - <td style="text-align: center;"><strong>Fairphone 2</strong></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom de code</strong></td> - <td style="text-align: center;">openc-fr / openc-ebay</td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"> </td> - </tr> - <tr> - <td style="text-align: center;"><strong>Build et instructions d'installation</strong></td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/zte-open-c/8402/">https://discourse.mozilla-community.org/t/zte-open-c/8402/</a></td> - <td style="text-align: center;"> - <p><a href="https://discourse.mozilla-community.org/t/test-b2gos-on-nexus-5/9405/1">https://discourse.mozilla-community.org/t/test-b2gos-on-nexus-5/9405/1</a></p> - </td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"> - <p><a href="https://discourse.mozilla-community.org/t/fairphone-2-build/8641/">https://discourse.mozilla-community.org/t/fairphone-2-build/8641/</a><br> - <a href="https://discourse.mozilla-community.org/t/fairphone-2-support-for-b2g-installer-landed/8334">https://discourse.mozilla-community.org/t/fairphone-2-support-for-b2g-installer-landed/8334</a></p> - </td> - </tr> - <tr> - <td style="text-align: center;"><strong>Disponible dans B2G Installer</strong></td> - <td style="text-align: center;"> - <p>Non</p> - - <p>(mais un buildbot est disponible)</p> - </td> - <td style="text-align: center;">Oui</td> - <td style="text-align: center;">Oui</td> - <td style="text-align: center;">Pas pour l'instant, mais presque terminé. La version avec blob fonctionne.</td> - </tr> - </tbody> -</table> - -<h3 id="Travaux_en_cours">Travaux en cours</h3> - -<p>Le support de ces appareils est en cours :</p> - -<table class="standard-table" style="height: 380px; width: 680px;"> - <tbody> - <tr> - <td style="text-align: center;"><strong>Image</strong></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12025/flamingo.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12017/amami.png" style="max-width: 133px;"></td> - <td style="text-align: center;"> </td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom<br> - (version Android)</strong></td> - <td style="text-align: center;"><strong>E3</strong><br> - Plate-forme Sony Yukon</td> - <td style="text-align: center;"><strong>Z1 Compact (Lollipop)</strong><br> - Plate-forme Sony Rhine</td> - <td style="text-align: center;"><strong>Xiaomi Redmi 1S</strong></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nom de code</strong></td> - <td style="text-align: center;">flamingo-l</td> - <td style="text-align: center;">amami-l</td> - <td style="text-align: center;">armani</td> - </tr> - <tr> - <td style="text-align: center;"><strong>Build et instructions d'installation</strong></td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/b2g-os-flamingo-sony-xperia-e3-builds/8361">https://discourse.mozilla-community.org/t/b2g-os-flamingo-sony-xperia-e3-builds/8361</a></td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/support-for-amami-xperia-z1c-building-debugging-providing-builds/8348">https://discourse.mozilla-community.org/t/support-for-amami-xperia-z1c-building-debugging-providing-builds/8348</a></td> - <td style="text-align: center;"><a href="https://discourse.mozilla-community.org/t/wip-xiaomi-redmi-1s-hongmi-1s/10273">https://discourse.mozilla-community.org/t/wip-xiaomi-redmi-1s-hongmi-1s/10273</a></td> - </tr> - <tr> - <td style="text-align: center;"><strong>État du support</strong></td> - <td style="text-align: center;">Bloqué, problème avec les outils de flashage</td> - <td style="text-align: center;">Tout début des tests de compilation</td> - <td style="text-align: center;">Tests préliminaires de compilation</td> - </tr> - </tbody> -</table> - -<h2 id="Appareils_sur_lesquels_un_portage_est_envisageable">Appareils sur lesquels un portage est envisageable</h2> - -<p>Voici une liste (<em>non exhaustive</em>) d'appareils sur lesquels un portage est <em>éventuellement possible</em>, grâce à la disponibilité de version AOSP ou Cyanogen Mod, ou parce qu'ils fonctionnaient sous Firefox OS jusqu'à la version 2.6.</p> - -<div class="note"> -<p><strong>Note :</strong> Pour l'instant, il n'existe aucun portage pour ces téléphones mais la construction de B2G OS est possible. Voir la section<a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko"> Comment compiler</a> pour plus d'informations. N'hésitez pas à maintenir ces builds.</p> -</div> - -<h3 id="Appareils_Nexus">Appareils Nexus</h3> - -<p>Ces appareils sont (presque) automatiquement supportés par B2G OS car ceux sont les appareils de référence de Google pour AOSP.</p> - -<table class="standard-table" style="height: 282px; line-height: 1.5; width: 451px;"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12037/nexus6.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12033/nexus4.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Nexus 6</strong></td> - <td style="text-align: center;"><strong>Nexus 4</strong></td> - </tr> - <tr> - <td style="text-align: center;"> </td> - <td style="text-align: center;"> </td> - </tr> - </tbody> -</table> - -<h3 id="Appareils_Sony">Appareils Sony</h3> - -<p>Ces appareils bénéficient de l'initiative Open Devices de Sony Mobile dont le but est de supporter dans AOSP tous les appareils Xperia modernes.</p> - -<p>Ils sont construits sur une base AOSP Lollipop.</p> - -<div class="note"> -<p>À l'heure actuelle, le support de l'appareil photo est absent de la plupart des appareils Sony. Cela est tributaire des travaux en cours des développeurs de Sony.<br> - Là aussi, nous avons besoin de contributeurs pour maintenir ces portages.</p> -</div> - -<p>Les appareils dont le support B2G OS est à venir ne sont pas listés ici.</p> - -<h4 id="Plate-forme_Sony_Shinano">Plate-forme Sony Shinano</h4> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12007/leo.png" style="max-width: 133px;"></td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12011/scorpion.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12013/sirius.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Z3</strong></td> - <td style="text-align: center;"> </td> - <td style="text-align: center;"><strong>Z3 Tablet Compact</strong></td> - <td style="text-align: center;"><strong>Z2</strong></td> - </tr> - <tr> - <td style="text-align: center;">leo-l</td> - <td style="text-align: center;"> </td> - <td style="text-align: center;">scorpion-l</td> - <td style="text-align: center;">sirius-l</td> - </tr> - </tbody> -</table> - -<dl> -</dl> - -<h4 id="Plate-forme_Sony_Rhine">Plate-forme Sony Rhine</h4> - -<div class="note"> -<p>Les appareils Rhine étant dotés d'une puce NFC ancienne, cette fonctionnalité est actuellement absente. Voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1226720">bogue 1226720 </a>Nous avons besoin de contributeurs pour maintenir ces portages.</p> -</div> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12015/honami.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Z1</strong></td> - </tr> - <tr> - <td style="text-align: center;">honami-l</td> - </tr> - </tbody> -</table> - -<h4 id="Plate-forme_Sony_Yukon">Plate-forme Sony Yukon</h4> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12019/tianchi.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12021/seagull.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12023/eagle.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>T2 Ultra</strong></td> - <td style="text-align: center;"><strong>T3</strong></td> - <td style="text-align: center;"><strong>M2</strong></td> - </tr> - <tr> - <td style="text-align: center;">tianchi-l</td> - <td style="text-align: center;">seagull-l</td> - <td style="text-align: center;">eagle-l</td> - </tr> - </tbody> -</table> - -<h3 id="Appareils_CyanogenMod_supportés"><strong>Appareils CyanogenMod supportés</strong></h3> - -<p>Voici des dragons ! (à compléter)</p> - -<h2 id="Anciens_appareils">Anciens appareils</h2> - -<p>Certains anciens appareils ne sont plus maintenus par la communauté mais il est encore possible pour des bénévoles de les garder en vie (Ouais Open-Source !). N'hésitez pas à contacter l'équipe qui travaillait dessus auparavant pour avoir de l'aide.</p> - -<p>Pour l'instant, aucun appareil n'est présent ici.</p> - -<h2 id="Appareils_obsolètes">Appareils obsolètes</h2> - -<div class="warning"> -<p>Oubliez le support de ces appareils si vous disposez de l'un d'eux.</p> -</div> - -<p>Plusieurs vieux appareils ne sont plus maintenus sous B2G OS, et aucune communauté n'est là pour les garder en vie. La situation actuelle de ces appareils est inconnue ce qui signifie que les principales branches de B2G OS ne pourront sans doute pas être compilées dessus.</p> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12069/peak.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12067/keon.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12071/inari.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12077/hamachi.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Geeksphone Peak</strong></td> - <td style="text-align: center;"><strong>Geeksphone Keon</strong></td> - <td style="text-align: center;"><strong>ZTE Open</strong></td> - <td style="text-align: center;"><strong>TCL Fire</strong></td> - </tr> - <tr> - <td style="text-align: center;">peak</td> - <td style="text-align: center;">keon</td> - <td style="text-align: center;">inari</td> - <td style="text-align: center;">hamachi</td> - </tr> - </tbody> -</table> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12083/galaxy-s2.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12085/galaxy-nexus.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12087/nexus-s.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12087/nexus-s.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Samsung Galaxy S2</strong></td> - <td style="text-align: center;"><strong>Galaxy Nexus</strong></td> - <td style="text-align: center;"><strong><a href="/en-US/docs/Mozilla/Firefox_OS/Samsung_Nexus_S">Nexus S</a></strong></td> - <td style="text-align: center;"><strong><a href="/en-US/docs/Mozilla/Firefox_OS/Samsung_Nexus_S">Nexus S 4G</a></strong></td> - </tr> - <tr> - <td style="text-align: center;">galaxy-s2</td> - <td style="text-align: center;">galaxy-nexus</td> - <td style="text-align: center;">nexus-s</td> - <td style="text-align: center;">nexus-s-4g</td> - </tr> - </tbody> -</table> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12073/flatfish.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12075/vixen.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12079/pandaboard.png" style="max-width: 133px;"></td> - <td style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/12081/rpi.png" style="max-width: 133px;"></td> - </tr> - <tr> - <td style="text-align: center;"><strong>Foxconn InFocus</strong></td> - <td style="text-align: center;"><strong>Via Vixen</strong></td> - <td style="text-align: center;"><strong><a href="/fr/Firefox_OS/Pandaboard">Pandaboard</a></strong></td> - <td style="text-align: center;"><strong>Raspberry Pi</strong></td> - </tr> - <tr> - <td style="text-align: center;">flatfish</td> - <td style="text-align: center;">vixen</td> - <td style="text-align: center;">pandaboard</td> - <td style="text-align: center;">rpi</td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_build_variables_reference_sheet/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_build_variables_reference_sheet/index.html deleted file mode 100644 index 4b4f08fc2f..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_build_variables_reference_sheet/index.html +++ /dev/null @@ -1,261 +0,0 @@ ---- -title: Variable de référence pour les builds B2G -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_Build_Variables_Reference_Sheet -tags: - - B2G - - Commandes - - Compilation - - Firefox OS - - Gaia - - Gecko - - Références(2) - - Variables -translation_of: >- - Archive/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet ---- -<p class="summary">Cet article fournit une référence pour toutes les variables des builds B2G, les builds Gaia et les builds Gecko et les commandes dont vous pouvez avoir besoin durant des opérations relative à la compilation de Firefox OS.</p> - -<h2 id="B2G_build">B2G build</h2> - -<h3 id="Variables">Variables</h3> - -<dl> - <dt>Example</dt> - <dd>xxx</dd> -</dl> - -<h3 id="Commandes">Commandes</h3> - -<dl> - <dt><code>./repo sync</code></dt> - <dd>xxx</dd> - <dt><code>./config.sh</code></dt> - <dd>xxx</dd> -</dl> - -<h2 id="Gaia_build">Gaia build</h2> - -<h3 id="Variables_2">Variables</h3> - -<p>Voir le <a href="https://github.com/mozilla-b2g/gaia/blob/master/Makefile#L497">Gaia MakeFile</a> pour la définition de toutes ces variables.</p> - -<dl> - <dt><code>ADB</code></dt> - <dd><code>xxx</code></dd> - <dt><code>APP</code></dt> - <dd>Certaines commandes peuvent agir sur tout gaia ou seulement sur une seule application. Cette variable d'environnement défini si l'on veut qu'une commande agisse sur une app seulement, et si c'est le cas, sur laquelle.</dd> - <dt><code>GAIA_DIR</code></dt> - <dd><code>xxx</code></dd> - <dt><code>PROFILE_DIR</code></dt> - <dd><code>xxx</code></dd> - <dt><code>PROFILE_FOLDER</code></dt> - <dd>Cela défini le dossier où le profil sera généré. Par défaut il est défini à <code>gaia/profile</code> pour les profils normaux et <code>gaia/profile-debug</code> pour les profils <code>DEBUG=1</code> profils (voir plus loin.)</dd> - <dt><code>COREWEBAPPS_DIR</code></dt> - <dd><code>xxx</code></dd> - <dt><code>SCHEME</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_DOMAIN</code></dt> - <dd><code>xxx</code></dd> - <dt><code>DEBUG</code></dt> - <dd>Lorsque la valeur est à 1, les profils généreés peuvent être utilisés avec Firefox desktop ou le simulator Firefox OS (B2G Desktop): <code>DEBUG=1 DESKTOP=0 make</code>.<br> - Il inclut l'extension <code>httpd.js</code> et les préférences de configurations pour accèder aux applications en utilisant <code>app://<appname>.gaiamobile.org/</code>. Quelques applications sont connues pour fonctionner ainsi, notamment l'application SMS.</dd> - <dt><code>LOCAL_DOMAINS</code></dt> - <dd><code>xxx</code></dd> - <dt><code>DESKTOP</code></dt> - <dd>Cela inclus un set d'extensions dans le profil <code>DEBUG</code> pour permettre aux applications systèmes de Gaia d'être chargées dans Firefox. Cela ne fonctionne plus bien et est <span class="short_text" id="result_box" lang="fr"><span class="hps">obsolète en faveur de Mulet</span></span>. La valeur par defaut est mise à 1 lorsque <code>DEBUG=1</code> est utilisé, mais vous pouvez vouloir le désactiver du fait de son non fonctionnement.<br> - Prenez des précautions car cela ne fonctionne pas aussi avec le Simulator Firefox OS (B2G Desktop).</dd> - <dt><code>DEVICE_DEBUG</code></dt> - <dd>Active une expérience plus developer-friendly : active le debuggage adb avec les devtools, désactive le lock screen et active les préférences pour permettre de debugger les applications certifiées.</dd> - <dt><code>NO_LOCK_SCREEN</code></dt> - <dd><code>xxx</code></dd> - <dt><code>SCREEN_TIMEOUT</code></dt> - <dd>Lorsque la valeur est à 0, cette préférence désactive le timeout de l'écran.</dd> - <dt><code>SYSTEM</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_PORT</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_LOCALES_PATH</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_INSTALL_PARENT</code></dt> - <dd><code>xxx</code></dd> - <dt><code>LOCALES_FILE</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_KEYBOARD_LAYOUTS</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_KEYBOARD_DOWNLOADABLE_LAYOUTS</code></dt> - <dd><code>xxx</code></dd> - <dt><code>GAIA_KEYBOARD_ENABLE_USER_DICT</code></dt> - <dd><code>xxx</code></dd> - <dt><code>LOCALE_BASEDIR</code></dt> - <dd><code>xxx</code></dd> - <dt><code>BUILD_APP_NAME</code></dt> - <dd>Essentiellement un alias pour <code>APP</code> (voir plus haut).</dd> - <dt><code>PRODUCTION</code></dt> - <dd>Crée des builds productions (à la place d'une build ingénieur); L'id de l'app Facebook et d'autres id d'applications productions sont utilisées dedans. Sinon <code>make production</code> fonctionnera</dd> - <dt><code>GAIA_OPTIMIZE</code></dt> - <dd>Lorsque la valeur est mise à 1 cela active les étapes d'optimisations lorsqu'on compile Gaia comme la minification du code JS. Toutes les applications gaia ne sont pas affectées par cela, tant que la fonction est opt-in.</dd> - <dt><code>GAIA_DEVICE_TYPE</code></dt> - <dd><code>xxx</code></dd> - <dt><code>G</code><code>AIA_DEV_PIXELS_PER_PX</code></dt> - <dd>Définis la densité de pixels pour l'appareil visé. Cela affecte les images et/ou les vidéos qui sont copiées dans la build. La valeur par défaut est à 1, mais les appareils avec des spécifications plus haute - par exemple le <a href="/en-US/Firefox_OS/Phone_guide/Flame">Flame</a> doivent utiliser une valeur de 1.5. C'est aliasé comme <code>GAIA_DPPX</code>.</dd> - <dt><code>DOGFOOD</code></dt> - <dd>Active les build Dogfood gaia.</dd> - <dt><code><span class="pl-s"><span class="pl-smi">MOZILLA_OFFICIAL</span></span></code></dt> - <dd><span class="pl-s"><span class="pl-smi">Lorsque la valeur n'est pas à 0, une build Mozilla-branded sera produite. La valeur par défaut est</span></span> à 0.</dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_DEFAULT_LOCALE</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_PRETRANSLATE</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_CONCAT_LOCALES</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_DISTRIBUTION_DIR</span></span></code></dt> - <dd>Utilisez cela pour spéficier une Gaia customisée; voir le <a href="/en-US/Firefox_OS/Developing_Gaia/Market_customizations_guide">Market customizations guide</a> pour plus détails.</dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_APPDIRS</span></span></code></dt> - <dd><code>xxx</code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_ALLAPPDIRS</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_MEMORY_PROFILE</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">NOFTU</span></span></code></dt> - <dd>Lorsque la valeur est à 1, cela met la préférence pour déactiver le FTU.</dd> - <dt><code><span class="pl-s"><span class="pl-smi">REMOTE_DEBUGGER</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">TARGET_BUILD_VARIANT</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-s"><span class="pl-smi">SETTINGS_PATH</span></span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-s"><span class="pl-smi">xxx</span></span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">FTU_PING_URL</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">KEYBOARD_LAYOUTS_PATH</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">CONTACTS_IMPORT_SERVICES_PATH</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">EMAIL_SERVICES_PATH</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">STAGE_DIR</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">GAIA_APP_TARGET</span></span></code></dt> - <dd><code><span class="pl-s"><span class="pl-smi">xxx</span></span></code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">BUILD_DEBUG</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">VARIANT_PATH</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">REBUILD</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">P</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">VERBOSE</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">RAPTOR</span></span></code></dt> - <dd>Active les marques de performances en mesurant et sortant les meta-données dans le logcat. Utilisation : <code>RAPTOR=1 make reset-gaia</code></dd> - <dt><code><span class="pl-s"><span class="pl-smi">SHARE_PERF_USAGE</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">DEFAULT_KEYBOAD_SYMBOLS_FONT</span></span></code></dt> - <dd>xxx</dd> - <dt><code><span class="pl-s"><span class="pl-smi">DEFAULT_GAIA_ICONS_FONT</span></span></code></dt> - <dd>xxx</dd> - <dt><code>MOZ_APPROX_LOCATION</code></dt> - <dd>Utilisez cela pour activer le panneau vie privée, par défaut la valeur est à off sauf dans les build ingénieur.</dd> -</dl> - -<h3 id="Commandes_2">Commandes</h3> - -<p>La suite est une liste d'abreviations des commandes les plus utilisées dont vous aurez besoin. Une liste plus détaillée peut être trouvée dans <a href="/en-US/Firefox_OS/Developing_Gaia/make_options_reference">Gaia make options reference</a>.</p> - -<dl> - <dt><code>make</code></dt> - <dd>Construit uniquement le profil.</dd> - <dt><code>make reset-gaia</code></dt> - <dd>Supprime le profil précédent et installe un nouveau profil Gaia.</dd> - <dt><code>make install-gaia</code></dt> - <dd>Install Gaia par dessus sans rien supprimer.</dd> - <dt><code>make production</code></dt> - <dd>Fait la même chose que <code>PRODUCTION=1 make reset-gaia</code>.</dd> - <dt><code>make clean</code></dt> - <dd>Supprime le profil généré.</dd> - <dt><code>make really-clean</code></dt> - <dd>Supprime le profil généré et le dossier de xul-runner; vous devez utiliser cela seulement quand tout est cassé.</dd> -</dl> - -<h2 id="Gecko_build">Gecko build</h2> - -<h3 id="Variables_3">Variables</h3> - -<dl> - <dt><code>B2G_DEBUG</code></dt> - <dd>xxx</dd> - <dt><code>VARIANT</code></dt> - <dd>Spéficie les variantes de gecko que vous voulez compiler. Les types valides sont listés ci-dessous:</dd> -</dl> - -<table> - <tbody> - <tr> - <th scope="row"><code>eng<code> </code></code></th> - <td> - <p>Ceci est le flag par défaut. Un <code>make</code> est la même chose que <code>make eng</code>.</p> - - <ul> - <li>Installe les modules tagger avec: <code>eng</code>, <code>debug</code>, <code>user</code>, et/ou <code>development</code>.</li> - <li>Installe les modules non-APK qui n'ont pas de tags spéficiés.</li> - <li>Installe les APK selon les fichiers de définition du produit, en plus des tagger APK.</li> - <li><code>ro.secure=0</code></li> - <li><code>ro.debuggable=1</code></li> - <li><code>ro.kernel.android.checkjni=1</code></li> - <li><code>adb</code> est activé par defaut.</li> - <li>marionette est activé</li> - <li>Ne possède pas les notifications de mise à jour par défaut ( B2G_UPDATER=1 est activé )</li> - </ul> - </td> - </tr> - <tr> - <th scope="row"><code>user<code> </code></code></th> - <td> - <p>Ceci est le flag attendu pour une release final.</p> - - <ul> - <li>Installe les modules tagger avec <code>user</code>.</li> - <li>Installe les modules non-APK qui n'ont pas de tags spéficiés.</li> - <li>Installe les APK selon les fichiers de définition du produit, les tags sont ignorés pour les modules APK.</li> - <li><code>ro.secure=1</code></li> - <li><code>ro.debuggable=0</code></li> - <li><code>adb</code> est désactivé par défaut.</li> - <li>Optimise par défaut</li> - </ul> - </td> - </tr> - <tr> - <th scope="row"><code>userdebug<code> </code></code></th> - <td><code>make userdebug</code> - <p>La même chose que <code>user</code>, excepté:</p> - - <ul> - <li>Installe aussi les modules tagger avec <code>debug</code>.</li> - <li><code>ro.debuggable=1</code></li> - <li><code>adb</code> est activé par défaut.</li> - <li>marionette est activé</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note</strong>: Cette table est inspirée par la table <a href="http://www.kandroid.org/online-pdk/guide/build_system.html#androidBuildVariants">Android Build Variants</a> .</p> -</div> - -<h3 id="Commandse">Commandse</h3> - -<dl> - <dt><code>./build.sh buildsymbols</code></dt> - <dd>Crée une build symbols pour debugger; voir <a href="/en-US/docs/Uploading_symbols_to_Mozillas_symbol_server">Uploading symbols to Mozilla's symbol server</a>.</dd> - <dt><code>./build.sh gecko-update-full</code></dt> - <dd>Crée un fichier mar OTA; voir <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages">Firefox OS update packages</a>.</dd> - <dt><code>./build.sh gecko-update-fota</code></dt> - <dd>Crée un mar/zip FOTA basé sur des fichiers qui contiennent seulement un sous-ensemble de fichiers et de dossiers; see <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages">Firefox OS update packages</a>.</dd> - <dt><code>./build.sh gecko-update-fota-full</code></dt> - <dd>Crée un mar/zip FOTA basé sur les fichiers; voir <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages">Firefox OS update packages</a>.</dd> - <dt><code>./build.sh gecko-update-fota-fullimg</code></dt> - <dd>Crée un mar/zip FOTA basé sur les partitions; voir <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_update_packages">Firefox OS update packages</a>.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_installer_add-on/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_installer_add-on/index.html deleted file mode 100644 index 35dcacb05d..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_installer_add-on/index.html +++ /dev/null @@ -1,284 +0,0 @@ ---- -title: Module complémentaire B2G installer -slug: Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_installer_add-on -tags: - - B2G - - B2G installer - - Installation - - Module complémentaire - - blobfree -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p class="summary">Le module complémentaire <strong>B2G installer contribue à résoudre un problème de longue date : l'impossibilité de redistribuer des builds du système complet à cause des </strong>blobs (composants propriétaires.) Cet article détaille comment le module fonctionne et comment l'installer.</p> - -<div class="warning"> -<p><strong>Important </strong>: Ce module complémentaire en est encore à un stade expérimental et il a besoin d'un <strong>mainteneur</strong>. À l'heure actuelle, il est conseillé de ne l'utiliser qu'avec un appareil que vous savez comment reflasher en cas de problème. Il n'est supporté que sur Linux (32 et 64 bits) et OSX (64 bits) pour l'instant.</p> -</div> - -<div class="warning"> -<p><strong>Important</strong> : En ce qui concerne la première version de ce module, il est important de comprendre que ses objectifs sont en réalité de prendre en charge le cas pratique de base suivant : flasher B2G sur un appareil supporté, fonctionnant sous le système Android (ou CyanogenMod). La gestion des mises à jour de B2G et l'obtention des Blobs à partir d'une source autre que l'appareil lui-même ne sont pas (encore) abordées.</p> -</div> - -<h2 id="Construire_une_distribution_sans_blob">Construire une distribution sans blob</h2> - -<p>Une solution au problème cité plus haut consiste à produire une distribution dite sans blob ou "blobfree" (voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1175934" title="FIXED: [B2G] Add support to build blobfree images">bug 1175934</a>) qui englobe tout ce qui est nécessaire pour la compilation d'un appareil :</p> - -<ul> - <li>Système complet construit depuis les sources.</li> - <li>Informations sur la compatibilité de l'appareil.</li> - <li>Description des partitions.</li> - <li>Liste des Blobs nécessaires, avec les informations sur leurs destinations requises dans le build final.</li> -</ul> - -<p>Une telle distribution sans blob peut être construite en spécifiant la cible <code>|blobfree|</code> <code>make</code> lors de la compilation de B2G :</p> - -<pre class="brush: bash">$ ./build.sh blobfree</pre> - -<div class="note"> -<p><strong>Note</strong> : Plus de détails là-dessus figurent dans la <a href="/fr/Firefox_OS/Compiler#Générer_une_archive_système_sans_aucun_blob_binaire">section blobfree de la page sur la compilation de B2G</a>.</p> -</div> - -<p>Le module complémentaire B2G installer simplifie l'installation de ce type de distribution.</p> - -<h2 id="Ajout_du_support_d'un_nouvel_appareil">Ajout du support d'un nouvel appareil</h2> - -<p>Pour rendre un nouvel appareil disponible dans le module lorsque l'utilisateur branche un appareil compatible, quelques étapes sont requises :</p> - -<ol> - <li>Assurez-vous que la génération d'une distribution sans blob est prise en charge par votre appareil. Vérifiez la <a href="/fr/Firefox_OS/Compiler#Générer_une_archive_système_sans_aucun_blob_binaire">section blobfree de la page Compiler B2G. </a></li> - <li>Dès lors que votre appareil dispose de ce support, vous pouvez faire en sorte qu'il soit disponible à partir du module. Tout d'abord, clonez le <a href="https://github.com/mozilla-b2g/b2g-installer-builds/">dépôt des builds</a>.</li> - <li>Enregistrez un bogue dans <a href="https://bugzilla.mozilla.org">Bugzilla</a> pour le composant <strong>Firefox OS :: B2GInstaller</strong>.</li> - <li>Enrichissez <code>builds.json</code> avec les informations relatives à votre nouvel appareil.</li> - <li>Envoyez un PR sur Github, joignez-le au bogue que vous avez créé et faîtes une demande de <em>review :gerard-majax</em>.</li> -</ol> - -<p>Le fichier <code>builds.json</code> contient un tableau d'objets, chacun décrivant un appareil compatible. Ces objets possèdent les propriétés suivantes :</p> - -<ul> - <li><code>id</code>: Le nom de l'appareil tel qu'il est affiché à l'utilisateur.</li> - <li><code>builds</code>: Un tableau des builds disponibles pour cet appareil. Chaque objet build du tableau doit avoir ces propriétés : - <ul> - <li><code>name </code>: La chaîne affichée lors de la sélection du build.</li> - <li><code>description </code>: Une description claire de ce qu'est ce build.</li> - <li><code>url</code> : URL du fichier de la distribution blobfree.</li> - </ul> - </li> - <li><code>adb </code>: Un ensemble de propriétés Android que l'appareil <strong>DOIT</strong> posséder pour être détecté comme compatible.</li> - <li><code>fastboot </code>: Un ensemble de variables Fastboot auxquelles celles de l'appareil <strong>DOIVENT</strong> correspondre pour être détecté comme compatible.</li> - <li><code>requiresRoot </code>: Valeur optionnelle qui définit si l'appareil doit être rootable pour pouvoir poursuivre l'installation. Par défaut, elle est définie à <code>true</code>.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Chaque propriété Android ou variable Fastboot peut être comparée soit avec une chaîne de caractères (égalité stricte) soit avec un tableau (égalité stricte avec une des valeurs du tableau.)</p> -</div> - -<h2 id="Installation">Installation</h2> - -<p>Pour installer le module complémentaire B2G installer, il faut suivre ces étapes :</p> - -<ul> - <li>Assurez-vous d'être sous <a href="https://nightly.mozilla.org/">Firefox Desktop Nightly</a> et d'avoir ADB Helper installé (v0.8.6 au minimum) — voir le lien en bas de la <a href="https://ftp.mozilla.org/pub/labs/fxos-simulator/">page fxos-simulator</a> pour l'installation.</li> - <li>Créez un <a href="/Firefox/Multiple_profiles">profil distinct</a> - <pre class="brush: bash">./firefox -P</pre> - </li> - <li><a href="https://wiki.mozilla.org/Addons/Extension_Signing#FAQ">outrepassez la signature des modules complémentaires</a> (risque de sécurité : c'est la raison pour laquelle vous devriez utiliser un profil séparé dans ce cas) : - <ul> - <li>Allez sur <code>about:config</code> (écrivez-le dans la barre de recherche).</li> - <li>désactivez <code>xpinstall.signatures.required</code> en double-cliquant dessus (la valeur par défaut est true, et la modifier en false va faire passer la ligne en gras).</li> - </ul> - </li> - <li>Installez le module complémentaire XPI B2G installer en utilisant une de ces méthodes : - <ul> - <li>Installez-le depuis les <a href="http://lissyx.github.io/b2g-installer/">pages Github</a> (recommandé).</li> - <li>Construisez-le vous-même — voir la section <a href="#Hacking">Hacking</a>.</li> - </ul> - </li> - <li>Vérifiez que vous disposez d'au moins 2Go d'espace disponible dans /tmp/.</li> - <li>Chargez la page <code>about:b2g-installer</code> (écrivez cela dans la barre de recherche). Vous pouvez avoir besoin de redémarrer le navigateur avant que cela ne marche pour la première fois.</li> - <li>Si vous souhaitez nous aider à améliorer le module, vous pouvez cocher la case pour collecter des informations directement à partir des sessions d'utilisation. Ce qui est collecté comme information est expliqué plus loin, dans la section <a href="#Données">Données</a>.</li> -</ul> - -<p>Vous pouvez également faire usage d'une machine virtuelle préconçue sous la forme d'un paquet OVA. Elle offre une installation prête à l'emploi de B2G Installer qui prend en charge certains appareils automatiquement (udev, etc. déjà configurés.) Voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1204482" title="FIXED: Provide a VirtualBox VM ready for B2G Installer use">bug 1204482</a> pour plus de détails.</p> - -<pre class="comment-text " id="ct-19"><a href="https://drive.google.com/file/d/0B8Ju6ek0Knd6aE5RdUkwTnlUTjQ/view?usp=sharing">https://drive.google.com/file/d/0B8Ju6ek0Knd6aE5RdUkwTnlUTjQ/view?usp=sharing</a> -SHA1: 9cbf309fa48eb73d983150e6aab21f7facb4f327</pre> - -<h2 id="Utilisation">Utilisation</h2> - -<ol> - <li>Lorsque le module complémentaire démarre, il télécharge <code>builds.json</code> depuis <a href="https://github.com/mozilla-b2g/b2g-installer-builds/blob/master/builds.json">Github</a> pour obtenir la liste des builds disponibles. Il est toujours possible d'utiliser un fichier zip local.</li> - <li>Branchez votre appareil en USB et attendez qu'il soit détecté par le module.</li> - <li>Après que l'appareil ait été détecté comme étant supporté, une liste des builds sera proposée.</li> - <li>Sélectionnez le build que vous voulez, cliquez sur <em>Flash</em> et patientez.<span id="cke_bm_232E" style="display: none;"> </span></li> -</ol> - -<h2 id="Captures_d'écran">Captures d'écran</h2> - -<p>Quand aucun appareil n'est branché :</p> - -<p><img alt="First page, no device plugged" src="https://mdn.mozillademos.org/files/12353/Capture%20du%202016-01-27%2016-13-38.png" style="display: block; height: 232px; margin: 0px auto; width: 320px;"></p> - -<p>Quand un build est sélectionné :</p> - -<p><img alt="Device plugged in and detected" src="https://mdn.mozillademos.org/files/12355/Capture%20du%202016-01-27%2016-14-25.png" style="display: block; height: 232px; margin: 0px auto; width: 320px;"></p> - -<p>Lors du flashage d'un appareil :</p> - -<p><img alt="Device plugged in and flashing a device" src="https://mdn.mozillademos.org/files/12357/Capture%20du%202016-01-27%2016-14-43.png" style="display: block; height: 232px; margin: 0px auto; width: 320px;"></p> - -<h2 id="Données">Données</h2> - -<p>Dans le but d'améliorer le module, nous collectons certaines données lorsqu'il est utilisé. Le principal objectif est de s'assurer que le module fonctionne correctement chez tout le monde. Nous collectons également des données pour savoir quels appareils intéressent les utilisateurs, de manière à ajuster les builds supportés en conséquence. Aucun pistage n'est fait.</p> - -<p>Nous envoyons deux pings de télémétrie externes pour collecter ces données :</p> - -<ul> - <li>Un lorsque l'appareil est détecté par le module après avoir été branché sur l'ordinateur (cela arrive à chaque fois que le module est actif <strong>*et*</strong> qu'un appareil avec ADB activé est branché.) À l'occasion de ce ping, nous enregistrons : - - <ul> - <li>Les variables d'identification de l'appareil (modèle, id du build, fabricant, bootloader.)</li> - <li>Le fait qu'un build CyanogenMod est installé ou non sur cet appareil.</li> - <li>Le fait qu'un build supporté a été détecté ou non sur l'appareil.</li> - </ul> - - <p>Exemple de données collectées lors du branchement d'un appareil supporté :</p> - - <pre class="brush: json">{ - "payload": { - "buildid": "KOT49H", - "isSupported": true, - "model": "Xperia Z3 Compact (B2G)", - "bootloader": "s1", - "manufacturer": "Sony" - }, [...] -}</pre> - - <p>Exemple de données collectées lors du branchement d'un appareil non supporté :</p> - - <pre class="brush: json">{ - "payload": { - "buildid": "LVY48I", - "isSupported": false, - "model": "Xperia Z1 Compact (B2G)", - "bootloader": "s1", - "manufacturer": "Sony" - }, [...] -} -</pre> - </li> - <li>Un à chaque fois qu'une procédure de flashage d'un appareil est exécutée. Cela se produit soit à la fin d'une procédure de flashage réussie, soit en cas d'échec. Pour ce ping, nous enregistrons : - <ul> - <li>Les mêmes variables que ci-dessus.</li> - <li>Si l'appareil fait déjà tourner un build B2G.</li> - <li>L'URL du build flashé (chemin complet pour un build public, nom du fichier sans le chemin complet pour un build local.)</li> - <li>Le fait que l'utilisateur conserve ses données ou non.</li> - <li>Le fait que le flashage ait réussi ou non.</li> - </ul> - - <p>Exemple de données collectées si le flashage a réussi :</p> - - <pre class="brush: json">{ - "payload": { - "isSupported": true, - "installResult": true, - "runsB2G": true, - "buildid": "KOT49H", - "keepData": false, - "buildURL": "https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-4-kk-user.opt/artifacts/public/build/mako.blobfree-dist.zip", - "model": "AOSP on Mako", - "bootloader": "MAKOZ30d", - "manufacturer": "LGE" - }, [...] -}</pre> - - <p>Exemple de données collectées en cas d'échec du flashage :</p> - - <pre class="brush: json">{ - "payload": { - "isSupported": true, - "installResult": false, - "runsB2G": true, - "buildid": "KOT49H", - "keepData": false, - "buildURL": "https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-4-kk-eng.opt/artifacts/public/build/mako.blobfree-dist.zip", - "model": "AOSP on Mako", - "bootloader": "MAKOZ30d", - "manufacturer": "LGE" - }, [...] -}</pre> - </li> -</ul> - -<h2 id="Hacking">Hacking</h2> - -<ul> - <li>Le code réside dans le dépôt <a href="https://github.com/mozilla-b2g/b2g-installer/">b2g-installer</a>. Vous devez appliquer le patch sur un clone de mozilla-central, puis créer un lien symbolique <code>browser/extensions/b2g-installer</code> vers votre clone du dépôt <code>b2g-installer</code>.</li> - <li>Pour le compiler, vous devez lancer <code>|./mach build && ./mach build package|</code>.</li> - <li>Le XPI résultant sera produit dans votre répertoire <code>MOZ_OBJDIR/dist/xpi-stage/b2g-installer/</code>.</li> - <li>Il contient une copie du code source des outils externes d'AOSP/CAF nécessaires à la construction des partitions.</li> - <li>Les tests sont écrits sous forme de tests mochitest/xpcshell.</li> - <li>Vérifiez également le méta-bogue et ses dépendances : <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1166276">Bogue 1166276</a></li> -</ul> - -<h2 id="À_FAIRE">À FAIRE</h2> - -<ol> - <li>Sortir de la branche mozilla-central pour la compilation. Cela va sans doute imposer la réécriture des tests avec autre chose que mochitests.</li> - <li>Convertir moz.build en Makefile pour la construction des outils.</li> - <li>Prendre en charge des sources externes de blobs (nécessaire pour gérer les cas de mise à jour).</li> -</ol> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_os_update_packages/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_os_update_packages/index.html deleted file mode 100644 index 021099552f..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/b2g_os_update_packages/index.html +++ /dev/null @@ -1,534 +0,0 @@ ---- -title: Créer et appliquer des paquets de mise à jour B2G OS -slug: Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_OS_update_packages -tags: - - B2G OS - - FOTA - - Firefox OS - - Gaia - - Mise à jour - - OTA - - Paquets -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p>Si vous souhaitez permettre aux utilisateurs de B2G OS de mettre à jour facilement la version de leur système sur leurs appareils, vous devez leur créer un paquet de mise à jour qu'ils puissent utiliser. Cet article décrit les différents types de paquets disponibles pour les mises à jour et détaille la construction du paquet, l'hébergement des mises à jour (et comment le système scrute les mises à jour disponibles), ainsi que l'application et la vérification de ces mises à jour.</p> -</div> - -<p>Créer et appliquer une mise à jour se divise en quatre étapes :</p> - -<ol> - <li>Construire des paquets de mise à jour incrémentale à partir d'ancienne(s) version(s) vers une nouvelle version compilée sur un hôte.</li> - <li>Rechercher le bon paquet de mise à jour à télécharger sur le client.</li> - <li>Télécharger la mise à jour.</li> - <li>Appliquer la mise à jour aux fichiers existants sur l'appareil.</li> -</ol> - -<p>Chacune de ces étapes est abordée ci-dessous.</p> - -<div class="note"> -<p><strong>Note</strong> : Il existe un certain nombre d'outils pratiques pour construire et tester les mises à jour système de Firefox OS, disponibles dans <a href="https://github.com/mozilla-b2g/B2G/tree/master/tools/update-tools">b2g/tools/update-tools</a>.</p> -</div> - -<h2 id="Prérequis"><span class="mw-headline" id="Prerequisites">Prérequis</span></h2> - -<p>Pour construire et appliquer des mises à jour, vous devez vous assurer que votre build dispose de l'updater et des outils de mise à jour associés. Par défaut, ceux-ci ne sont présents que dans les variantes <strong>userdebug</strong> et <strong>user</strong>. Vous pouvez néanmoins forcer leur construction en ajoutant la ligne suivante dans votre <a href="/fr/Firefox_OS/Customisation_avec_le_fichier_.userconfig">fichier .userconfig </a>:</p> - -<pre>export B2G_UPDATER=1</pre> - -<p>Pour signer les paquets de mise à jour, vous aurez besoin d'installer un environnement d'exécution Java (JRE) ou le kit de développement logiciel Java (JDK), et d'avoir la commande <strong>java</strong> accessible via le path par défaut.</p> - -<h2 id="Types_de_mise_à_jour"><span class="mw-headline" id="Types_of_updates">Types de mise à jour</span></h2> - -<p>Il existe deux types de mise à jour à connaître : FOTA (Firmware Over-The-Air) et OTA Gecko/Gaia (Over-The-Air). Voyons les différences qu'il y a entre les deux.</p> - -<h3 id="Mises_à_jour_FOTA"><span class="mw-headline" id="FOTA_updates">Mises à jour FOTA</span></h3> - -<p><span class="mw-headline">Le système B2G OS entier peut être actualisé via les <strong>mises à jour FOTA</strong>, la technologie sous-jacente qui est commune avec le projet Android. Parmi les emplacements du disque dur du téléphone qui peuvent être modifiés par les mises à jour FOTA figurent la partition système, le noyau, le modem en bande de base, l'image de recovery utilisée pour la mise à jour, ou tout autre fichier présent sur l'appareil.</span></p> - -<p>B2G OS ne dépend pas d'un client FOTA en particulier, une API que nous appelons <a class="externallink" href="http://git.mozilla.org/?p=b2g/librecovery.git;a=blob;f=librecovery.h;h=a6e13374f9bffcf947a39d6f3348290d67113321;hb=HEAD" rel="nofollow" title="http://git.mozilla.org/?p=b2g/librecovery.git;a=blob;f=librecovery.h;h=a6e13374f9bffcf947a39d6f3348290d67113321;hb=HEAD">librecovery</a> constituant une interface d'abstraction. Néanmoins, nous recommandons l'utilisation du client de recovery GOTA (voir plus bas pour plus de détails), et le texte présent se base sur le fait que GOTA est utilisé.</p> - -<p>Les paquets de mise à jour FOTA consistent essentiellement en un fichier nommé <code>update.zip</code>. Ce paquet est constitué des éléments suivants</p> - -<ul> - <li>Un ensemble de diffs binaires et de nouveaux fichiers requis pour mettre à jour le client vers la nouvelle version du logiciel</li> - <li>Un "script de mise à jour" qui contrôle la façon dont les diffs et les nouveaux fichiers sont chargés sur le client</li> - <li>Une signature interne servant à vérifier le paquet de mise à jour</li> -</ul> - -<p>Ce format et l'ensemble des fichiers sont identiques à ceux utilisés pour les mises à jour Android normales, excepté que B2G OS encapsule en plus le paquet <code>update.zip</code> dans un wrapper <code>mar</code> (MAR signifie <strong>Mozilla ARchive</strong>). Ce wrapper <code>mar</code> offre un degré supplémentaire de vérification, ce qui est expliqué plus bas.</p> - -<h3 id="Mises_à_jour_OTA_GeckoGaia"><span class="mw-headline" id="Gecko.2FGaia_OTA_updates">Mises à jour OTA Gecko/Gaia</span></h3> - -<p><span class="mw-headline">Autrement, il est possible de ne mettre à jour sur un appareil B2G OS</span> <em>que</em> l<span class="mw-headline">es fichiers de Gecko et Gaia, à travers un mécanisme que nous appelons <strong>mises à jour OTA Gecko/Gaia</strong>. L'ensemble des fichiers de Gecko et Gaia — ce qui comprend le cœur exécutif de Gecko et l'interface utilisateur de l'appareil — se trouve dans le répertoire <code>/system/b2g</code> de l'appareil.</span> Il s'agit du seul répertoire auquel les mises à jour OTA peuvent apporter des modifications.</p> - -<p>Les mises à jour OTA Gecko/Gaia utilisent la même technologie que celle mise en œuvre pour mettre à jour le navigateur web Firefox pour ordinateur de bureau. Un peu comme les paquets FOTA <code>update.zip</code> abordés plus haut, les mises à jour OTA consistent en un fichier MAR contenant un ensemble de diffs binaires et de nouveaux fichiers nécessaires à la mise à jour du client vers une version plus récente du logiciel.</p> - -<p>Le client Gecko vérifie l'intégrité des <code>MARs</code> qu'il a téléchargés, ces derniers pouvant être signés par plusieurs parties.</p> - -<h2 id="Pourquoi_avoir_deux_technologies_de_mise_à_jour"><span class="mw-headline" id="Why_have_two_update_technologies.3F">Pourquoi avoir deux technologies de mise à jour ?</span></h2> - -<p>Les mises à jour OTA ne sont pas aussi complètes que les FOTA, mais elles sont beaucoup plus ergonomiques et simples à appliquer, et elles correspondront mieux à vos besoins concernant les mises à jour :</p> - -<ul> - <li>Les mises à jour OTA Gecko/Gaia peut être appliquées "en arrière-plan" pendant que B2G OS continue à fonctionner normalement. Cela apporte une meilleure expérience utilisateur car les utilisateurs n'ont pas besoin de redémarrer leur téléphone ni d'attendre pendant que la mise à jour se fait. Au lieu de ça, la mise à jour est appliquée pendant que l'utilisateur continue à utiliser le téléphone, puis, une fois la mise à jour terminée, l'utilisateur a juste à accepter de redémarrer le processus <code>b2g</code> principal. Cela ne prend que quelques secondes, au lieu des minutes qu'il faut généralement attendre pour l'application des mises à jour FOTA.</li> - <li>Les paquets de mise à jour OTA Gecko/Gaia peuvent parfois être plus petits que ceux des mises à jour FOTA, bien que ce ne soit pas toujours le cas ; ils ne seront par contre jamais plus gros. Cela signifie que les utilisateurs pourront quelquefois avoir moins de données à télécharger.</li> -</ul> - -<p>Bien sûr, s'il vous faut actualiser des fichiers autres que ceux de Gecko/Gaia, vous n'aurez pas d'autre choix que de passer par un paquet FOTA complet.</p> - -<p>Voyons à présent la suite avec l'examen du processus de construction du paquet.</p> - -<h2 id="Construire_des_paquets_de_mise_à_jour"><span class="mw-headline" id="Building_updates_for_multiple_software_versions">Construire des paquets de mise à jour</span></h2> - -<p>La construction des mises à jour est le processus consistant à générer les fichiers nécessaires à la mise à jour des clients B2G OS d'une <em>version X</em> du logiciel vers une nouvelle <em>version Y</em>. Le paquet de mise à jour requis pour le client dépend des fichiers qui ont été modifiés entre la <em>version X</em> et la <em>version Y</em>.</p> - -<ul> - <li>Si <strong>seuls</strong> des fichiers présents dans <code>/system/b2g</code> ont été modifiés, il faudra générer une mise à jour OTA Gecko/Gaia</li> - <li>Si un fichier situé ailleurs que dans <code>/system/b2g</code> a été changé, une mise à jour FOTA devra être générée</li> -</ul> - -<p>Pour générer un paquet de mise à jour incrémentale (que ce soit pour des mises à jour FOTA ou OTA Gecko/Gaia), nos outils nécessitent la construction complète de la <em>version X</em> et de la <em>version Y</em>. Une <strong>construction complète</strong> signifie que le paquet intègre tous les fichiers nécessaires au flashage d'un client. Lorsque nous produisons une construction complète pour la <em>version X</em>, nous ne savons pas quelle sera la future version vers laquelle il faudra effectuer la mise à jour de la version <em>X</em> . C'est pour cette raison que les paquets FOTA et les paquets Gecko/Gaia complets doivent être construits pour chaque version. Cela permet de générer aussi bien une mise à jour OTA Gecko/Gaia incrémentale qu'une mise à jour FOTA incrémentale si besoin, entre la <em>version X </em>et toutes les versions futures.</p> - -<p>Schématiquement, le processus de construction d'un mise à jour ressemble à ceci :</p> - -<ol> - <li>Avec le logiciel <em>version X</em> - - <ul> - <li>Générer un fichier <code>MAR</code> OTA Gecko/Gaia complet du contenu de <code>/system/b2g</code>.</li> - <li>Générer une archive zip des fichiers cibles pour la mise à jour FOTA complète, éventuellement signée, pour les partitions de l'appareil. Le zip des fichiers cibles est référencé plus bas sous le nom <code>DEVICE-target_files-$VARIANT.$USER.zip</code>, c'est un zip contenant les fichiers pour mettre à jour les répertoires du téléphone, dont <code>SYSTEM/</code>, <code>BOOT/</code>, etc. Un fichier FOTA complet <code>update.zip</code> peut être produit à partir du zip des fichiers cibles.</li> - </ul> - </li> - <li>Avec le logiciel <em>version Y</em> - <ul> - <li>Générer un fichier <code>MAR</code> OTA Gecko/Gaia complet du contenu de <code>/system/b2g</code>.</li> - <li>Générer une archive zip des fichiers cibles pour la mise à jour FOTA complète, éventuellement signée, pour les partitions de l'appareil. Le zip des fichiers cibles est référencé plus bas sous le nom <code>DEVICE-target_files-$VARIANT.$USER.zip</code>, c'est un zip contenant les fichiers pour mettre à jour les répertoires du téléphone, dont <code>SYSTEM/</code>, <code>BOOT/</code>, etc. Un fichier FOTA complet <code style="font-style: normal;">update.zip</code> peut être produit à partir du zip des fichiers cibles.</li> - </ul> - </li> - <li>Si seuls des fichiers de <code>/system/b2g</code> ont changé, générer un fichier <code>MAR</code> pour une mise à jour OTA Gecko/Gaia incrémentale de la <em>version X</em> vers la <em>version Y</em>.</li> - <li>Sinon, générer un fichier FOTA incrémental <code>update.zip</code> de la <em>version X </em>vers la <em>version Y</em>. Intégrer cette mise à jour FOTA incrémentale <code>update.zip</code> dans un fichier <code>MAR</code> pour le distribuer auprès du client B2G.</li> - <li>Signer les paquets comme cela est requis pour les autorisations de distribution.</li> -</ol> - -<p>Les sous-sections ci-dessous décrivent comment utiliser les outils de B2G pour implémenter chacune de ces étapes.</p> - -<div class="note"> -<p><strong>Note </strong>: les étapes ci-après supposent que vous avez déjà mis en place un environnement de compilation b2g à l'emplacement <code>$b2g</code>. Les commandes ci-dessous font référence au script <code>$b2g/build.sh</code> mais <code>make</code> peut tout aussi bien être utilisé.</p> -</div> - -<h3 id="Générer_un_fichier_MAR_complet_de_mise_à_jour_OTA_GeckoGaia"><span class="mw-headline" id="Generating_a_complete_Gecko.2FGaia_OTA_update_MAR">Générer un fichier MAR complet de mise à jour OTA Gecko/Gaia</span></h3> - -<p>Pour générer un MAR de mise à jour OTA complète à partir de la dernière compilation de <code>b2g</code> réussie (e.g. que vous avez <a href="/fr/Firefox_OS/Compiler">compilée</a> vous-même), vous devez invoquer la cible <code>gecko-update-full</code>. Pour placer le MAR dans <code>$b2g/objdir-gecko/dist/b2g-update/b2g-gecko-update.mar</code>, utilisez les commandes suivantes :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build.sh gecko-update-full -$ cp objdir-gecko/dist/b2g-update/b2g-gecko-update.mar <destination> -</pre> - -<h3 id="Générer_un_fichier_MAR_de_mise_à_jour_FOTA_complète"><span class="mw-headline" id="Generating_a_complete_Gecko.2FGaia_OTA_update_MAR">Générer un fichier MAR de mise à jour FOTA complète</span></h3> - -<p>Pour générer un MAR de mise à jour FOTA complète à partir de la dernière compilation de <code>b2g</code> réussie (e.g. que vous avez <a href="/fr/Firefox_OS/Compiler">compilée</a> vous-même), vous devez invoquer la cible <code>gecko-update-fota-full</code>. Cela intègre le contenu de la partition <code>/system</code> dans sa totalité. Voici les commandes dont vous avez besoin :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build.sh gecko-update-fota-full -</pre> - -<p>Un fichier ZIP sera généré (<code>$PRODUCT_OUT/fota/full/update.zip</code>) ainsi qu'un fichier MAR (<code>$PRODUCT_OUT/fota-$TARGET_DEVICE-update-full.mar</code>). Le fichier ZIP peut être utilisé directement avec <code>adb sideload</code>, tandis que le MAR est prévu pour être distribué de la même manière que tout autre paquet de mise à jour.</p> - -<h3 id="Générer_un_fichier_MAR_de_mise_à_jour_FOTA_plus_un_paquet_de_recovery">Générer un fichier MAR de mise à jour FOTA plus un paquet de recovery</h3> - -<p>Depuis Firefox OS 2.2 (mi-avril et après) nous avons ajouté une nouvelle cible pour make, elle peut être appelée ainsi :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build.sh gecko-update-fota-fullimg</pre> - -<p>Elle est utilisée pour produire un paquet de recovery constituant un dump du jeu d'images de partitions. Le jeu par défaut est contrôlé par la variable <code>B2G_FOTA_FULLIMG_PARTS</code>, définie dans <code>gonk-misc/Android.mk</code> (parmi la plupart des autres nouvelles fonctionnalités vues plus bas.) Il s'agit d'une chaîne de caractères utilisant l'espace comme séparateur, listant les instances <code>mountpoint:image</code> à inclure. La valeur par défaut est <code>"/boot:boot.img /system:system.img /recovery:recovery.img /cache:cache.img"</code>.</p> - -<p>Avec tout ça, nous avons également introduit quelques nouvelles variables d'environnement pour contrôler la production de deux autres cibles make — <code>gecko-update-fota</code> et <code>gecko-update-fota-full</code> :</p> - -<ul> - <li>La première est <code>B2G_FOTA_PARTS</code>, elle suit le même modèle de syntaxe que <code>B2G_FOTA_FULLIMG_PARTS</code>. Cela nous permet de produire ces paquets de mise à jour et de faire un dump des images de partitions avec ceux-ci, p.ex. la partition de boot, le firmware du modem, etc.</li> - <li><code>B2G_FOTA_PARTS_FORMAT</code> offre un moyen de décrire un jeu de partitions dont le formatage est souhaité durant l'installation du paquet de recovery. C'est une liste de points de montage, séparés par des espaces, à utiliser lors du formatage.</li> - <li>Deux nouvelles variables permettent d'effacer (wipe) les caches et/ou les données pendant la procédure de construction : - <ul> - <li><code>B2G_FOTA_WIPE_DATA</code></li> - <li><code>B2G_FOTA_WIPE_CACHE</code></li> - </ul> - </li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Toutes ces nouvelles fonctionnalités reposent fortement sur la disponibilité d'un fichier <code>recovery.fstab</code> correct fourni pour l'appareil concerné.</p> -</div> - -<h3 id="Générer_un_fichier_MAR_de_mise_à_jour_FOTA_GeckoGaia_partielle"><span class="mw-headline" id="Generating_a_complete_Gecko.2FGaia_OTA_update_MAR">Générer un fichier MAR de mise à jour FOTA Gecko/Gaia partielle</span></h3> - -<p>Une mise à jour FOTA partielle utilise le même mécanisme que pour celles complètes, mais par défaut, seuls sont inclues les mises à jour Gecko/Gaia, tout comme une mise à jour OTA normale. Des fichiers supplémentaires autres que ceux de Gecko/Gaia peuvent aussi être intégrés (tels que des polices de caractères).</p> - -<p>La logique derrière la génération d'un paquet de mise à jour FOTA partielle est principalement conditionnée par des problèmes de licence : lors de la construction d'un paquet de mise à jour FOTA complet, la partition système entière (au moins) sera intégrée. Elle peut comporter des blobs que vous n'êtes pas autorisé à redistribuer. Cependant, comme la distribution de MAR est utile et que Gecko/Gaia eux-mêmes sont des logiciels libres, il n'y a aucune raison pour que nous ne puissions pas être en mesure de les distribuer de cette façon. Une FOTA partielle permet de ne mettre à jour qu'un sous-ensemble du système. Dans un tel scénario, une mise à jour OTA pourrait être employée à la place, mais cela aurait un coût : les mises à jour OTA ont besoin d'assez d'espace sur la partition système pour contenir à la fois les fichiers Gecko/Gaia existants et les fichiers de mise à jour décompressés. Une mise à jour FOTA partielle ne possède pas cette contrainte car elle écrase les fichiers existants par ceux de la mise à jour.</p> - -<p>Pour créer une mise à jour FOTA partielle à partir de la dernère compilation de <code>b2g</code> réussie (e.g. que vous avez <a href="/fr/Firefox_OS/Compiler">compilée</a> vous-même), invoquez la cible <code>gecko-update-fota</code> avec les commandes suivantes :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build.sh gecko-update-fota -</pre> - -<p>Elles vont générer un fichier ZIP (<code>$PRODUCT_OUT/fota/partial/update.zip</code>) et un fichier MAR (<code>$PRODUCT_OUT/fota-$TARGET_DEVICE-update.mar</code>). Le fichier ZIP peut être utilisé directement avec <code>adb sideload</code>, tandis que le fichier MAR est destiné à être distribué de la même manière que tout autre paquet de mise à jour.</p> - -<p>La construction peut être contrôlée par un certain nombre de variables d'environnement, les plus utiles d'entre-elles sont documentées ci-dessous :</p> - -<table> - <thead> - <tr> - <th scope="col">Variable</th> - <th scope="col">Signification</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>$B2G_FOTA_DIRS</code></td> - <td>Liste des répertoires à inclure dans la mise à jour, séparés par des espaces. <code>system/b2g</code> par défaut.</td> - </tr> - <tr> - <td><code>$TARGET_UPDATE_BINARY</code></td> - <td>Binaire utilisé pour exécuter le script Edify à l'intérieur du paquet. Si aucun binaire n'est spécifié, un updater binaire pré-construit issu de ICS sera utilisé.</td> - </tr> - <tr> - <td><code>$FOTA_FINGERPRINTS</code></td> - <td>Liste d'empreintes Android, séparées par des virgules, avec lesquelles faire les contrôles. Le cas pratique est la possibilité de distribuer des paquets de mise à jour Gecko/Gaia par-dessus un système de base Gonk sous contrôle qu'il ne nous est pas possible de distribuer légalement. Par exemple, les builds communautaires de l'Open C les utilisent.</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note</strong> : Un ensemble complet de ces variables est défini dans le <a href="https://github.com/mozilla-b2g/gonk-misc/blob/master/Android.mk">fichier Android.mk du répertoire gonk-misc</a> ; remarquez que <code>$FOTA_FINGERPRINTS</code> est utilisé dans notre outil <a href="https://github.com/mozilla-b2g/B2G/blob/d75c2351fb32216c78a1f6c50835796af8756068/tools/update-tools/update_tools.py#L837">update_tools.py</a>.</p> -</div> - -<h3 id="Générer_une_archive_zip_des_fichiers_cibles_pour_une_mise_à_jour_FOTA_complète"><span class="mw-headline" id="Generating_a_complete_FOTA_update_zip_and_target_files_zip">Générer une archive zip des fichiers cibles pour une mise à jour FOTA complète</span></h3> - -<p>Invoquez la cible <code>target-files-package</code> pour construire un zip des fichiers cibles qui pourra servir à générer des mises à jour FOTA tant complète qu'incrémentale. Le zip des fichiers cibles peut aussi être signé avec des clés personnalisées pour garantir que seules les mises à jour FOTA en provenance de sources connues puissent être installées. Après signature des fichiers cibles, toutes les images et mises à jour (OTA aussi) doivent à nouveau être générées pour obtenir les clés insérées.</p> - -<div class="note"> -<p><strong>Note</strong> : Le zip des fichiers cibles est généré à l'emplacement <code>out/target/product/$DEVICE/obj/PACKAGING/target_files_intermediates/$DEVICE-target_files-$VARIANT.$USER.zip</code></p> -</div> - -<p>Cette étape est réalisée par les commandes suivantes :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build.sh target-files-package -$ cp out/target/product/$DEVICE/obj/PACKAGING/target_files_intermediates/$DEVICE-target_files-$VARIANT.$USER.zip <destination> -</pre> - -<p>Les valeurs des variables dans les commandes listées ci-dessus doivent être remplies comme suit :</p> - -<table> - <thead> - <tr> - <th scope="col">Variable</th> - <th scope="col">Signification</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>$DEVICE</code></td> - <td>Nom de l'appareil pour le produit AOSP</td> - </tr> - <tr> - <td><code>$VARIANT</code></td> - <td><code>eng</code>, <code>user</code>, ou <code>userdebug</code></td> - </tr> - <tr> - <td><code>$USER</code></td> - <td>Le nom d'utilisateur du build</td> - </tr> - </tbody> -</table> - -<h3 id="Signer_le_zip_des_fichiers_cibles_d'une_FOTA_complète"><a name="signing-target-files-package"></a>Signer le zip des fichiers cibles d'une FOTA complète</h3> - -<p>Les distributions correctes devraient en principe être signées par des clés personnalisées connues uniquement du vendeur. Grâce à l'introduction de cette couche de sécurité supplémentaire, le fait de posséder de telles clés empêchera l'installation de mises à jour FOTA dont la source est inconnue. Pour que cela fonctionne, les images flashées sur un appareil doivent inclure les clés publiques tandis que les mises à jour doivent être signées avec les clés privées correspondantes. </p> - -<p>La première étape consiste à générer des clés personnalisées et à les stocker en lieu sûr. Android Open Source Project dispose d'un script pour générer ces clés. Pour une compatibilité totale, récupérez ce script depuis la branche correspondant à la version de Gonk présente sur l'appareil en question. <a href="https://android.googlesource.com/platform/development/+/master/tools/make_key">La version pour la branche master se trouve ici</a>.</p> - -<p>Plusieurs clés sont requises — créez-les avec les commandes suivantes. <code>releasekey</code> est la clé à utiliser pour signer les paquets de mise à jour FOTA.</p> - -<pre class="brush: bash">$ development/tools/make_key releasekey '/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com' -$ development/tools/make_key platform '/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com' -$ development/tools/make_key shared '/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com' -$ development/tools/make_key media '/C=US/ST=California/L=Mountain View/O=Android/OU=Android/CN=Android/emailAddress=android@android.com' -</pre> - -<p>Une fois les clés présentes, le fichier zip des fichiers cibles peut être signé par l'emploi des commandes suivantes. Elles vont insérer les clés publiques et modifier les propriétés du build pour refléter le fait qu'il ait été signé.</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build/tools/releasetools/sign_target_files_apks \ -<span style="font-size: 1rem;"> --default_key_mappings $RELEASEKEY_FOLDER \</span> -<span style="font-size: 1rem;"> --replace_ota_keys \</span> -<span style="font-size: 1rem;"> --signapk_path prebuilts/sdk/tools/lib/signapk.jar \</span> -<span style="font-size: 1rem;"> $UNSIGNED_TARGET_FILES_ZIP \</span> -<span style="font-size: 1rem;"> $SIGNED_TARGET_FILES_ZIP</span></pre> - -<p><span style="font-size: 1rem;">Les valeurs des variables présentes dans les commandes listées plus haut doivent être remplies de la manière qui suit :</span></p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Variable</th> - <th scope="col">Signification</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>$RELEASEKEY_FOLDER</code></td> - <td>Le chemin du dossier contenant les clés personnalisées</td> - </tr> - <tr> - <td><code>$UNSIGNED_TARGET_FILES_ZIP</code></td> - <td>Le zip des fichiers cibles FOTA à signer.</td> - </tr> - <tr> - <td><code>$SIGNED_TARGET_FILES_ZIP</code></td> - <td>Le zip des fichiers cibles FOTA qui doit être généré</td> - </tr> - </tbody> -</table> - -<h3 id="Générer_un_fichier_MAR_de_mise_à_jour_OTA_incrémentale"><span class="mw-headline" id="Generating_an_incremental_OTA_update_MAR">Générer un fichier MAR de mise à jour OTA incrémentale</span></h3> - -<p>Dans cet exemple, nous supposons générer une mise à jour du logiciel <em>version X</em> vers la <em>version Y</em>. L'emplacement du fichier <code>MAR</code> de l'OTA Gecko/Gaia complète compilé à partir du logiciel <em>version X</em> en suivant les instructions ci-dessus sera appelé <code>$MAR_X</code> par la suite. ll peut s'agir d'un chemin sur le serveur de compilation comme <code>/home/build/b2g/versions/X/update.mar</code>. De manière similaire, l'emplacement du <code>MAR</code> complet compilé à partir de la <em>version Y</em> sera appelé <code>$MAR_Y</code>.</p> - -<p>L'outil <code>build-gecko-mar.py</code> va générer un fichier MAR de mise à jour OTA Gecko/Gaia incrémental en utilisant <code>$MAR_X</code> et <code>$MAR_Y</code>. La destination du fichier généré sera appelée <code>$GENERATED_INCREMENTAL_MAR_X_Y</code>. Utilisez les commandes suivantes pour cette étape :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./tools/update-tools/build-gecko-mar.py --from $MAR_X --to $MAR_Y $GENERATED_INCREMENTAL_MAR_X_Y -</pre> - -<h3 id="Générer_une_archive_zip_de_mise_à_jour_FOTA_incrémentale"><span class="mw-headline" id="Generating_an_incremental_FOTA_update_zip">Générer une archive zip de mise à jour FOTA incrémentale</span></h3> - -<p>Dans cet exemple, nous supposons générer une mise à jour du logiciel <em>version X</em> vers la <em>version Y</em>. L'emplacement du zip cible pour la FOTA complète construite à partir du logiciel <em>version X </em>en utilisant les instructions ci-dessus sera appelé <code>$TARGET_FILES_X</code> par la suite. Il peut s'agir d'un chemin sur un serveur de compilation comme <code>/home/build/b2g/versions/X/target_files.zip</code>. De manière similaire, l'emplacement du zip cible pour la FOTA complète construite à partir de la <em>version Y </em>sera appelé <code>$TARGET_FILES_Y</code>.</p> - -<p>L'outil <code>build/tools/releasetools/ota_from_target_files</code> va générer un fichier FOTA update.zip incrémental en se servant de <code>$TARGET_FILES_X</code> et de <code>$TARGET_FILES_Y</code>. La destination de ce fichier intermédiaire sera appelée <code>$INTERMEDIATE_FOTA_UPDATE_FOTA_X_Y</code>.</p> - -<p>Après la génération de ce <code>update.zip</code>, la dernière étape sera de l'encapsuler dans un <code>MAR</code> pour le livrer au client B2G. L'outil <code>tools/update-tools/build-fota-mar.p</code> effectue cette opération. La destination où générer le fichier sera appelée <code>$GENERATED_INCREMENTAL_FOTA_X_Y</code>.</p> - -<p>Utilisez les commandes suivantes pour achever cette étape :</p> - -<pre class="brush: bash">$ cd $b2g -$ ./build/tools/releasetools/ota_from_target_files -v \ - --incremental_from $TARGET_FILES_X \ - --signapk_path prebuilts/sdk/tools/lib/signapk.jar \ - --package_key $FOTA_SIGNING_KEY \ - $TARGET_FILES_Y \ - $INTERMEDIATE_FOTA_UPDATE_FOTA_X_Y -$ ./tools/update-tools/build-fota-mar.py $INTERMEDIATE_FOTA_UPDATE_FOTA_X_Y --output=$GENERATED_INCREMENTAL_FOTA_X_Y -</pre> - -<p>Les valeurs des variables employées dans les commandes listées ci-dessus devraient être remplies de la manière suivante :</p> - -<table> - <thead> - <tr> - <th scope="col">Variable</th> - <th scope="col">Meaning</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>$TARGET_FILES_X</code></td> - <td>Le zip des fichiers cibles FOTA pour la <em>version X</em></td> - </tr> - <tr> - <td><code>$TARGET_FILES_Y</code></td> - <td>Le zip des fichers cibles FOTA pour la <em>version Y</em></td> - </tr> - <tr> - <td><code>$INTERMEDIATE_FOTA_UPDATE_FOTA_X_Y</code></td> - <td>Un fichier update.zip temporaire à partir duquel générer un <span style="font-family: courier new,andale mono,monospace;">MAR</span></td> - </tr> - <tr> - <td><code>$GENERATED_INCREMENTAL_FOTA_X_Y</code></td> - <td>Le zip destination de la mise à jour incrémentale encapsulé dans un fichier <code>MAR</code> pour être livré aux clients</td> - </tr> - <tr> - <td><code>$FOTA_SIGNING_KEY</code></td> - <td>Chemin vers le préfixe d'une clé privée et d'un certificat public destinés à signer le fichier update zip. <code>$FOTA_SIGNING_ZIP.pk8</code> et <code>$FOTA_SIGNING_ZIP.x509.pem</code> doivent tous deux être présents sur le système de fichiers. Si <code>$TARGET_FILES_X</code> n'est pas signé, cette option peut être omise ; la clé de test par défaut sera alors récupérée. Dans le cas où <code>$TARGET_FILES_X</code> est une clé personnalisée, se référer à la <a href="#signing-target-files-package">section pour la signature du zip des fichiers cibles</a> pour savoir comment la créer, et ne pas oublier de signer <code>$TARGET_FILES_Y</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Hébergement_des_mises_à_jour_et_recherche_de_nouvelles_versions_côté_client"><span class="mw-headline" id="Hosting_updates_.28respectively.2C_polling_for_updates_on_the_client_side.29">Hébergement des mises à jour et recherche de nouvelles versions côté client</span></h2> - -<p>Les clients B2G OS scrutent les mises à jour en récupérant et analysant un <strong>manifeste de mise à jour </strong>: <code>update.xml</code>. Les clients B2G OS sont configurés pour rechercher des mises à jour sur des serveurs spécifiques — ils interrogent un chemin construit spécialement sur le serveur. HTTPS est le protocole recommandé pour être utilisé par le client pour interroger le serveur, cependant, HTTP est aussi pris en charge. Le serveur et le chemin consultés par les clients peuvent être modifiés par la livraison aux clients existants d'une mise à jour qui change le code de scrutation.</p> - -<p>Dans les exemples ci-dessous, nous estimerons que les mises à jour sont hébergées sur le serveur <code>updates.b2g.com</code>.</p> - -<p>L'URL scrutée par le client contient habituellement les paramètres suivants :</p> - -<table> - <thead> - <tr> - <th scope="col">Paramètre</th> - <th scope="col">Explication</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>PRODUCT_MODEL</code></td> - <td>Le nom du modèle d'appareil. C'est la valeur <code>ro.product.model</code> de la base de données des propriétés de B2G.</td> - </tr> - <tr> - <td><code>CHANNEL</code></td> - <td>Le "canal" de mise à jour. Il est utile pour les tests : les serveurs peuvent être configurés pour héberger, par exemple, les canaux "nightly", "beta", et "release".</td> - </tr> - <tr> - <td><code>VERSION</code></td> - <td>La version du logiciel du client. Par exemple, "18.0.2".</td> - </tr> - <tr> - <td><code>BUILD_ID</code></td> - <td>Un ID unique, comme un horodatage, configuré pour une compilation en particulier.</td> - </tr> - </tbody> -</table> - -<p>Le client Firefox utilise les valeurs de son hôte de mise à jour configuré et de ces valeurs pour construire une URL à interroger pendant l'exécution. La structure est la suivante :</p> - -<pre>https://aus4.mozilla.org/update/3/%PRODUCT%/%VERSION%/%BUILD_ID%/%PRODUCT_DEVICE%/%LOCALE%/%CHANNEL%/%OS_VERSION%/%DISTRIBUTION%/%DISTRIBUTION_VERSION%/update.xml</pre> - -<p>Un exemple réel d'une telle URL est comme ceci :</p> - -<pre class="brush: xml">https://aus4.mozilla.org/update/3/B2G/37.0a1/20141214040212/flame/en-US/nightly-b2g37/Boot2Gecko%202.2.0.0-prerelease%20%28SDK%2019%29/default/default/update.xml?force=1</pre> - -<p>Si le serveur renvoie "404 Not Found" en réponse à la requête du client, cela signifie qu'aucune mise à jour n'est disponible. S'il renvoie "200" et un fichier de manifeste, alors c'est qu'une mise à jour peut être disponible. Le manifeste décrit la version nouvellement disponible ; autrement dit, celle <strong>vers laquelle le client peut être mis à jour</strong>. Voici un exemple de manifeste :</p> - -<pre class="brush: xml"><?xml version="1.0"?> -<updates> - <update type="major" appVersion="19.0" version="19.0" extensionVersion="19.0" buildID="20121210123456" - licenseURL="http://www.mozilla.com/test/sample-eula.html" - detailsURL="http://www.mozilla.com/test/sample-details.html" - isOSUpdate="true"> - <patch type="partial" URL="https://updates.b2g.com/release/unagi1/18.0/20121203123456/update.mar" - hashFunction="SHA512" hashValue="5111e033875752b7d9b32b4795152dea5ef954cb8a9d4a602dd19a923b464c43521287dcb5781faf3af76e6dc5e8a3dd9c13edea18c1f2c8f3bd89e17d103d6f" - size="41901319"/> - </update> -</updates> -</pre> - -<p>Il suit le même schéma que le manifeste de compilation B2G (voir le <a href="https://wiki.mozilla.org/Software_Update:updates.xml_Format">format updates.xml</a> pour plus de détails). Les champs du manifeste décrivent :</p> - -<ul> - <li>Métadonnées utilisées pour afficher une interface utilisateur sur le client.</li> - <li>Métadonnées sur la version nouvellement disponible.</li> - <li>L'emplacement du paquet de mise à jour.</li> - <li>Métadonnées utilisées pour vérifier le téléchargement du paquet de mise à jour.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Il existe un script utile de mise à jour disponible sur <a href="https://github.com/mozilla-b2g/B2G/blob/master/tools/update-tools/build-update-xml.py">build-update-xml.py</a>, lequel, à partir d'un fichier MAR donné, construit un fichier B2G OS update.xml pour test.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: L'appareil du client ou l'utilisateur peut choisir de refuser une mise à jour.</p> -</div> - -<div class="note"> -<p><strong>Note :</strong> <code>isOSUpdate="true"</code> est requis pour les mises à jour FOTA mais pas pour les OTA.</p> -</div> - -<p>En utilisant le mécanisme décrit plus haut, les serveurs peuvent héberger des paquets de mise à jour pour que tout client avec une ancienne version puisse passer à une nouvelle version. Ou alors, ils peuvent héberger uniquement un "historique linéaire de mises à jour" à partir duquel les clients peuvent se mettre à jour via un chemin unique.</p> - -<p>Les détails de l'interaction entre les serveurs de compilation et l'hôte de mise à jour dépassent pour l'instant la portée de ce document. Elle est très grandement dépendante de l'environnement de production. Vous pouvez trouver quelques détails supplémentaires sur notre page de wiki <a href="https://wiki.mozilla.org/Software_Update">Software Update</a>.</p> - -<h2 id="Vérifier_et_appliquer_les_mises_à_jour"><span class="mw-headline" id="Verifying_and_applying_updates">Vérifier et appliquer les mises à jour</span></h2> - -<p>Après qu'un client B2G OS ait détecté avec succès une mise à jour (<a href="https://support.mozilla.org/fr/kb/comment-verifier-installer-mises-jour-firefox-os?redirectlocale=en-US&redirectslug=how-do-i-check-firefox-os-updates-and-install-them">ce qui est fait depuis le système lui-même</a>), téléchargé celle-ci et vérifié l'intégrité du paquet de mise à jour téléchargé, l'étape finale est d'appliquer la mise à jour.</p> - -<p>La première chose dans l'application d'une mise à jour est la vérification de la signature embarquée dans les paquets <code>MAR</code> (voir <a href="#Generating_an_incremental_FOTA_update_zip">Generating an incremental FOTA update zip</a> sur la façon dont elles sont créées). Cela est réalisé par le client B2G OS lui-même après le contrôle de l'intégrité du paquet téléchargé. Le code utilisé pour cette tâche est le même que ce soit pour les mises à jour FOTA ou pour celles OTA Gecko/Gaia.</p> - -<div class="note"> -<p><strong>Note</strong> : Ce n'est pas le fichier MAR qui est signé : c'est le fichier zip FOTA empaqueté dans le MAR qui est signé par <code>build/tools/releasetools/ota_from_target_file</code>. La signature de la mise à jour FOTA fonctionne de la même manière que sur Android ; si vous lancez simplement le script sans spécifier de clé, il utilisera les clés développeurs <code>build/target/product/security/testkeys.*</code>. Ça ne pose pas de problème pour des tests, mais lorsque vous créez une véritable mise à jour vous aurez besoin d'une clé sécurisée — i.e. une que personne d'autre ne connaît. Comme l'appareil va également vérifier cette signature avant d'appliquer le patch, les images initiales de l'appareil doivent elles aussi contenir la clé.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Les clés mentionnées plus haut se trouvent dans les systèmes de compilation d'Android ; nous les avons dupliquées sur notre <a href="https://github.com/mozilla-b2g/platform_build">dépot platform_build</a>.</p> -</div> - -<p>Après la vérification des signatures, le processus d'application d'une mise à jour diverge selon le type de mise à jour, OTA Gecko/Gaia ou FOTA. À ce stade, voyons les différences entre les deux.</p> - -<h3 id="Appliquer_des_mises_à_jour_OTA_GeckoGaia"><span class="mw-headline" id="Applying_Gecko.2FGaia_OTA_updates">Appliquer des mises à jour OTA Gecko/Gaia</span></h3> - -<p>Le client B2G OS applique celles-ci grâce à l'utilisation du binaire <code>updater</code>. Il fait partie de la distribution Gecko et son code est le même que celui utilisé pour mettre à jour la version de bureau de Firefox. Comme cela a été décrit précédemment, la mise à jour est appliquée pendant que le client B2G OS continue de fonctionner normalement. Pendant l'application des mises à jour, les utilisateurs sont toujours en mesure de passer des appels ou d'en recevoir, de lancer des applications, de naviguer sur le web etc.</p> - -<p>Les détails spécifiques au binaire <code>updater</code> dépassent le cadre de ce document mais il fonctionne approximativement de cette manière :</p> - -<ul> - <li>Il réalise une copie des fichiers présents dans <code>/system/b2g</code>.</li> - <li>Il applique les patches binaires, supprime les anciens fichiers et ajoute les nouveaux comme cela est spécifié dans le fichier <code>MAR</code>.</li> - <li>Il redémarre le processus principal <code>b2g</code> afin que celui-ci utilise tous les nouveaux fichiers.</li> -</ul> - -<p>Après le redémarrage du processus <code>b2g</code>, l'utilisateur bénéficiera de la nouvelle version du logiciel client B2G.</p> - -<h3 id="Appliquer_des_mises_à_jour_FOTA"><span class="mw-headline" id="Applying_FOTA_updates">Appliquer des mises à jour FOTA</span></h3> - -<p>Elles sont appliquées par le client FOTA. Le client Gecko se "débarrasse" de la mise à jour en appelant l'API <a class="externallink" href="http://git.mozilla.org/?p=b2g/librecovery.git;a=blob;f=librecovery.h;h=a6e13374f9bffcf947a39d6f3348290d67113321;hb=HEAD" rel="nofollow" title="http://git.mozilla.org/?p=b2g/librecovery.git;a=blob;f=librecovery.h;h=a6e13374f9bffcf947a39d6f3348290d67113321;hb=HEAD">librecovery</a> qui se chargera de l'appliquer. Ce qui arrive après cette étape est spécifique à chaque client FOTA.</p> - -<p>Dans l'implémentation de librecovery utilisée par le client GOTA, l'application du paquet de mise à jour téléchargé est planifiée et des commandes particulières sont mises en file d'attente pour le client de recovery. librecovery redémarre ensuite l'appareil en mode recovery. Le client recovery lance ensuite le script de mise à jour situé dans le fichier <code>update.zip</code> pour mettre à jour les fichiers et les partitions si nécessaire. Le client de recovery peut avoir besoin de redémarrer plusieurs fois afin de mettre à jour tous les fichiers.</p> - -<p>Après le redémarrage final, l'appareil fonctionnera avec la nouvelle version du logiciel client B2G OS.</p> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/compiler_pour_le_flame_sur_os_x/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/compiler_pour_le_flame_sur_os_x/index.html deleted file mode 100644 index 263c6b7e7c..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/compiler_pour_le_flame_sur_os_x/index.html +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Compiler Firefox OS pour le Flame sur Mac OS X -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Compiler_pour_le_Flame_sur_OS_X -tags: - - Documentation de compilation - - Firefox OS - - Flame - - Guide - - Mac OS X -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X ---- -<p><span class="seoSummary">Cet article donne les instructions sur la façon de compiler Firefox OS pour les appareils Flame en utilisant un système Mac OS X comme plate-forme de compilation.</span></p> - -<div class="note"><strong>Note :</strong> Ce guide part du principe que le célèbre gestionnaire de paquets <a href="brew.sh">Homebrew</a> est installé. Si ce n'est pas le cas, vous allez devoir soit l'installer, soit installer un gestionnaire de paquets équivalent et apprendre à vous en servir.</div> - -<h2 id="Préparation_de_l'environnement_de_compilation">Préparation de l'environnement de compilation</h2> - -<p>La première étape consiste à <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Installation_des_pr.C3.A9requis_pour_OS_X">installer les prérequis pour la compilation</a> comme d'habitude. Installez ensuite binutils afin que la commande <code>objdump</code> soit disponible pour les builds de débogage :</p> - -<pre>brew install binutils</pre> - -<p>Créez une image disque en utilisant le système de fichiers journalisé et sensible à la casse HFS+ puis montez l'image avec les commandes suivantes.</p> - -<pre>hdiutil create -volname 'firefoxos' -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 40g ~/firefoxos.sparseimage -open ~/firefoxos.sparseimage -cd /Volumes/firefoxos/</pre> - -<div class="note"> -<p><strong>Note :</strong> Comme l'image est créée en tant qu'image de type "sparse", seuls les blocs du disque réellement utilisés prendront de l'espace disque sur le support physique. Cela signifie qu'une image de 40 Go, comme celle ci-dessus, ne prendra pas vraiment jusqu'à 40 Go d'espace. Au lieu de ça, elle va croître progressivement au fur et à mesure que vous y écrirez des données.</p> -</div> - -<h2 id="Clonage_du_dépôt_B2G">Clonage du dépôt B2G</h2> - -<p>Évidemment, avant de pouvoir lancer votre première compilation, il est nécessaire de cloner le dépôt B2G. Il est important de noter que cela ne va pas tout récupérer. Seuls le système de construction et les utilitaires de configuration seront obtenus. La quasi-totalité du code proprement dit se trouve dans le principal dépôt <a href="/fr/docs/Mercurial" title="Mercurial">Mercurial</a> de Mozilla ; ces fichiers seront rapatriés plus tard lors du processus de configuration.</p> - -<p>Pour cloner le dépôt, utilisez <a href="https://git-scm.com/">git</a> :</p> - -<pre style="font-size: 14px;">git clone git://github.com/mozilla-b2g/B2G.git</pre> - -<p>Une fois l'opération terminée (ça ne devrait prendre qu'une minute avec une connexion rapide), utilisez <code>cd</code> pour aller dans le répertoire B2G :</p> - -<pre>cd B2G</pre> - -<h2 id="Configuration_de_B2G_pour_le_flame">Configuration de B2G pour le flame</h2> - -<p>Après avoir récupéré le cœur du système de construction de B2G, vous devez le configurer pour l'appareil sur lequel vous prévoyez de l'installer ; dans le cas présent, il s'agit du "flame". Exécutez la commande suivante depuis le répertoire B2G :</p> - -<pre>./config.sh flame-kk</pre> - -<p>C'est à ce moment que la plus grande partie du code sera téléchargée. Le code source faisant environ une quinzaine de giga-octets, le téléchargement va prendre un certain temps même avec une connexion internet rapide. Même avec une bonne connexion haut-débit, cela peut prendre une heure ou davantage.</p> - -<div class="note"> -<p><strong>Note :</strong> Sérieusement, cela prendra vraiment énormément de temps si vous avez une connexion Internet plutôt lente. Tenez-en compte (ainsi que des coûts de connexion au méga-octet que vous pourriez avoir à payer) avant d'effectuer cette étape.</p> -</div> - -<h3 id="Sauvegarde_des_fichiers_importants_de_l'appareil">Sauvegarde des fichiers importants de l'appareil</h3> - -<p>Avant de commencer le processus d'installation, il est important de faire une sauvegarde de certains fichiers clés de l'appareil. Ceux-ci seront nécessaires si vous avez besoin de reflasher l'appareil. </p> - -<p>À ce stade, branchez votre Flame s'il ne l'était pas déjà ; le processus de configuration aura besoin d'y accéder. Utilisez la commande <code>adb devices</code> pour vérifier s'il est connecté :</p> - -<pre>adb devices -l -</pre> - -<p>Seront listés tous les appareils compatibles Android ou B2G connectés. Si le vôtre n'est pas dans la liste, c'est que quelque chose n'est pas connecté correctement.</p> - -<p>Après avoir obtenu la confirmation que l'appareil est bien connecté, vous pouvez réaliser la sauvegarde avec les commandes suivantes :</p> - -<pre>mkdir flame-backup -cd flame-backup -adb pull /system system -adb pull /data data</pre> - -<p>À noter, si vous compilez pour la première fois, vous pouvez décider de partir sur la version la plus récente de l'image de base du flame ; voir <a href="https://developer.mozilla.org//fr/Firefox_OS/Guide_Telephone_Developpeur/Flame/mettre_a_jour_Flame#Flashage_vers_la_dernière_image_(2.5)">https://developer.mozilla.org//fr/Firefox_OS/Guide_Telephone_Developpeur/Flame/mettre_a_jour_Flame#Flashage_vers_la_dernière_image_(2.5)</a> pour davantage de détails.</p> - -<h3 id="Contournement_d'un_problème_de_compilation_avec_Mac_OS_X">Contournement d'un problème de compilation avec Mac OS X</h3> - -<p>Un problème peut survenir lors de la compilation sur Mac OS X. La communauté Mozilla a conçu une solution pour celui-ci ; elle a été testée sur Mac OS X 10.9.4 "Mavericks."</p> - -<h4 id="mkfs.vfat_non_existant">mkfs.vfat non existant</h4> - -<p>Il est nécessaire d'installer un port de <code><a href="https://github.com/sv99/dosfstools-osx">dosfstools</a></code> afin de pouvoir utiliser l'image.</p> - -<pre><code><code>brew create https://github.com/sv99/dosfstools-osx.git</code></code></pre> - -<p>Éditez ensuite la formule que <code>brew</code> va utiliser pour construire le logiciel <code>dosfstools</code> :</p> - -<pre class="brush: js"><code>require "formula" - -class Dosfstools < Formula - homepage "https://github.com/sv99/dosfstools-osx" - url "https://github.com/sv99/dosfstools-osx.git" - sha1 "" - - def install - system "make", "install" - end -end -</code></pre> - -<p>À présent, vous êtes prêt pour l'installer :</p> - -<pre><code><code>brew install dosfstools</code></code></pre> - -<h3 id="Modification_de_la_configuration_pour_contourner_les_bogues">Modification de la configuration pour contourner les bogues</h3> - -<p>Dans certaines circonstances, des bogues du système de construction peuvent empêcher la compilation sur Mac OS X. Les cas en question sont :</p> - -<ul> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1039223">Bug 1039223</a> - La compilation pour le flame échoue en indiquant l'absence de dt.img</li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1027682">Bug 1027682</a> - [Flame][Build] Échec de la compilation sur Mac OS X 10.9, fichier elf.h introuvable</li> -</ul> - -<p>Utilisez votre éditeur de texte préféré pour créer un fichier appelé <code>.userconfig</code> dans le répertoire B2G. Le contenu suivant doit être placé à l'intérieur de ce fichier <code>.userconfig</code> :</p> - -<div> -<div> -<pre><code><code># .userconfig for Flame build 14.08.2014 -# osx repo change -# Bug 1039223 - Build for flame fails complaining of missing dt.img -# https://bugzilla.mozilla.org/show_bug.cgi?id=1039223 -pushd device/qcom/common/dtbtool -patch -N << EOF ---- a/dtbtool/dtbtool.c -+++ b/dtbtool/dtbtool.c -@@ -616,7 +616,7 @@ int main(int argc, char **argv) - extract "qcom,msm-id" parameter - */ - while ((dp = readdir(dir)) != NULL) { -- if ((dp->d_type == DT_REG)) { -+ if ((dp->d_type == DT_REG||dp->d_type == DT_UNKNOWN)) { - flen = strlen(dp->d_name); - if ((flen > 4) && - (strncmp(&dp->d_name[flen-4], ".dtb", 4) == 0)) { -EOF - -popd - -# Bug 1027682 - [Flame][Build] Failed to build on Mac OS X 10.9, elf.h file not found -# https://bugzilla.mozilla.org/show_bug.cgi?id=1027682 -if [[ ! -e /usr/local/include/elf.h ]]; then - cp "${B2G_DIR}/external/elfutils/libelf/elf.h" /usr/local/include - echo "Bug 1027682: elf.h copied into /usr/local/include" -fi - -# Disable First Time User experience -export NOFTU=1 -echo "NOFTU = ${NOFTU}" - -# Enable gaia developer mode -export DEVICE_DEBUG=1 -echo "DEVICE_DEBUG = ${DEVICE_DEBUG}" - -# Keeping both debug and non-debug objects -#export GECKO_PATH=${B2G_DIR}/mozilla-inbound -echo "GECKO_PATH = ${GECKO_PATH}" - -export B2G_DEBUG=1 -echo "B2G_DEBUG = ${B2G_DEBUG}" - -#export GECKO_OBJDIR=${GECKO_PATH}/objdir-gonk -if [[ "${B2G_DEBUG}" != "0" ]]; then - export GECKO_OBJDIR=${GECKO_OBJDIR}-debug -fi -echo "GECKO_OBJDIR = ${GECKO_OBJDIR}"</code></code></pre> - -<h2 id="Lancement_de_votre_première_compilation">Lancement de votre première compilation</h2> - -<p>Maintenant vous êtes enfin prêt à lancer la compilation ! Lancez-la de la même manière que pour toute autre compilation de Firefox OS :</p> - -<pre><code><code>./build.sh</code></code></pre> -</div> -</div> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/configurer_votre_première_construction/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/configurer_votre_première_construction/index.html deleted file mode 100644 index 6840a7f37b..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/configurer_votre_première_construction/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: Configurer votre première construction -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Configurer_votre_première_construction -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/Configure_your_first_build ---- -<h2 id="Cloner_le_dépôt_B2G">Cloner le dépôt B2G</h2> - -<p>Vous disposez de plusieurs outils utiles pour construire Firefox OS, tous contenus dans un unique dépôt. Téléchargez-les via git pour créer votre répertoire de travail.</p> - -<pre>git clone git://github.com/mozilla-b2g/B2G.git && cd B2G</pre> - -<h2 id="Configurer_B2G_pour_votre_appareil">Configurer B2G pour votre appareil</h2> - -<p>Nous devons à présent télécharger le code source. La commande suivante affichera une liste des cibles.</p> - -<pre>./config.sh -</pre> - -<p>Cela montrera une liste d'appareils compatibles. Pour plus d'informations sur les appareils qu'il est possible de construire, se reporter à la page des <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils Compatibles</a>.</p> - -<pre>Valid devices to configure are: - -<strong>* [LEGACY] AOSP Ice Cream Sandwich base</strong> -- emulator -- emulator-x86 - -<strong>* [LEGACY] AOSP Jellybean base</strong> -- emulator-jb -- emulator-x86-jb -- nexus-4 -- flame - -<strong>* AOSP KitKat base</strong> -- emulator-kk -- emulator-x86-kk -- nexus-4-kk -- nexus-5 -- flame-kk -- leo-kk (Z3 KK) -- aries-kk (Z3 Compact KK) - -<strong>* AOSP Lollipop base</strong> -- emulator-l -- emulator-x86-l -- nexus-5-l -- nexus-6-l -- flame-l -- leo-l (Z3 L) -- aries-l (Z3 Compact L) -- scorpion-l (Z3 Tablet Compact L) -- sirius-l (Z2 L) -- honami-l (Z1 L) -- amami-l (Z1 Compact L) -- tianchi-l (T2U L) -- seagull-l (T3 L) -- eagle-l (M2 L) -- flamingo-l (E3 L) -</pre> - -<p>Si votre appareil n'est pas (encore) compatible avec B2G, reportez-vous au <a href="/en-US/docs/Mozilla/Firefox_OS/Porting_Firefox_OS">Guide de portage</a>.</p> - -<p>Sélectionnez votre cible en l'ajoutant à la commande <code>./config.sh</code>. Si vous voyez votre cible plusieurs fois, choisissez la variante en fonction de la base AOSP la plus récente disponible. Par exemple, construire pour le Nexus 5 :</p> - -<pre>./config.sh nexus-5-l -</pre> - -<p>Cela téléchargera beaucoup de données (jusqu'à 20Go), aussi nous vous recommandons d'effectuer cette tâche avant de manger ou même la nuit si vous avez une connexion lente.</p> - -<h2 id="Blobs_propriétaires">Blobs propriétaires</h2> - -<p>Malheureusement, chaque appareil nécessite un ensemble de blobs propriétaires. Comme le système de construction va les extraire directement depuis votre appareil, vous devez le brancher avant de lancer la construction.</p> - -<p>Pour les appareils Nexus et Sony, le processus de construction téléchargera également certains blobs directement depuis Google ou Sony, assurez-vous de bien suivre les instructions affichées à l'écran pour ces modèles ; vous aurez besoin d'accepter un accord de licence.</p> - -<h2 id="Construire_Firefox_OS">Construire Firefox OS</h2> - -<p>Tout ce que vous avez à faire consiste à lancer :</p> - -<pre>./build.sh -</pre> - -<h2 id="Étapes_suivantes">Étapes suivantes</h2> - -<p>Si vous compilez pour l'émulateur, voir <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Run_Firefox_OS_on_the_emulator">Exécuter Firefox OS sur l'émulateur</a></p> - -<p>Si vous compilez pour un appareil, voir <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS/Install_Firefox_OS_to_a_device">Installer Firefox OS sur un appareil</a></p> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/construire_anciennes_branches/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/construire_anciennes_branches/index.html deleted file mode 100644 index 47266ce72f..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/construire_anciennes_branches/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Construire d'anciennes branches -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Construire_anciennes_branches -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/Build_legacy_branches ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p>Les anciennes branches de Firefox OS nécessitent la présence des paquets multi-architectures. Ils ne sont pas installés par défaut sur les systèmes d'exploitation récents. </p> - -<p>Lancez ces commandes pour permettre l'utilisation de l'architecture i386 :</p> - -<pre><code>sudo dpkg --add-architecture i386 -sudo apt-get update</code></pre> - -<p>Exécutez cette commande pour installer les paquets nécessaires :</p> - -<pre><code>sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib gcc-4.7 g++-4.7 g++-4.7-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip ia32-libs libxml2-utils lzop openjdk-7-jdk -</code></pre> - -<p>Utilisez ces commandes pour faire de <code>gcc-4.7</code> le compilateur par défaut :</p> - -<pre><code>sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.7 1 -sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.7 1 -sudo update-alternatives --set gcc "/usr/bin/gcc-4.7" -sudo update-alternatives --set g++ "/usr/bin/g++-4.7"</code></pre> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/index.html deleted file mode 100644 index 52afc81e6b..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: Compiler et installer B2G OS -slug: Archive/B2G_OS/Building_and_installing_Boot_to_Gecko -tags: - - B2G OS - - Build documentation - - Firefox OS -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p><span class="seoSummary">B2G OS étant actuellement développé à un rythme très soutenu et en phase de pré-lancement, le meilleur moyen d'avoir une installation à jour est de le compiler et de l'installer par vous-même. Les articles listés sur cette page vous guideront à travers la compilation et l'installation de B2G OS sur un émulateur ou un appareil compatible, ou l'interface utilisateur <a href="/en-US/docs/Mozilla/B2G_OS/Platform/Gaia/Introduction_to_Gaia" title="Mozilla/B2G_OS/Platform/Gaia/Introduction to Gaia">Gaia</a> dans le navigateur Firefox.</span></p> -</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Obtenir_et_compiler_B2G_OS">Obtenir et compiler B2G OS</h2> - - <dl> - <dt><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Résumé_processus_compilation_Firefox_OS">Résumé du processus de compilation de B2G OS</a></dt> - <dd>Compiler et installer B2G OS demande du temps de manière significative, de la bande passante réseau et de la puissance de calcul. Cette page décrit les objectifs du processus de compilation et les étapes de ce processus afin d'aider les utilisateurs en les guidant tout au long du processus.</dd> - <dt><a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour compiler B2G OS</a></dt> - <dd>Étapes à effectuer avant de compiler B2G OS pour la première fois.</dd> - <dt><a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Préparation pour votre première compilation de B2G</a></dt> - <dd>Avant que vous ne puissiez compiler B2G OS, vous devez cloner le dépôt et configurer votre compilation. Cet article explique comment le faire.</dd> - <dt><a href="/fr/Firefox_OS/Compiler">Compiler B2G OS</a></dt> - <dd>Comment compiler B2G OS.</dd> - <dt><a href="/en-US/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">Module complémentaire B2G installer</a></dt> - <dd>Le <strong>module complémentaire B2G installer</strong> contribue à résoudre le problème de longue date qui empêche de redistribuer des compilations systèmes complètes à cause des blobs (composants propriétaires). Cet article détaille le fonctionnement du module, et comment l'installer.</dd> - </dl> - - <h2 id="Davantage_de_ressources_de_référence">Davantage de ressources de référence</h2> - - <dl> - <dt><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Compiler_pour_le_Flame_sur_OS_X">Compiler B2G OS sur Mac OS X pour un appareil Flame</a></dt> - <dd>Un guide rédigé par la communauté, pour compiler B2G OS sur Mac OS X pour l'appareil de référence Flame.</dd> - <dt><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils compatibles</a></dt> - <dd>Une liste officielle des appareils de développement qui supportent B2G OS.</dd> - <dt><a href="/en-US/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Créer et appliquer des paquets de mise à jour B2G OS</a></dt> - <dd>Ce guide très détaillé explique comment créer des paquets de mise à jour OTA/FOTA, ceux-ci pouvant ensuite être distribués sur les appareils des utilisateurs pour fournir des mises à jour logicielles.</dd> - <dt><a href="/fr/Firefox_OS/Compiler/FOTA_community_builds">Construire et installer des builds communautaires FOTA</a></dt> - <dd>Un guide de démarrage rapide, rédigé par la communauté, pour créer et installer des paquets FOTA.</dd> - <dt><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/B2G_Build_Variables_Reference_Sheet">Carte de référence des variables de compilation B2G</a></dt> - <dd>Une référence de toutes les variables de compilations B2G, Gaia et Gecko, et des commandes dont vous pourriez avoir besoin pendant les opérations de compilations relatives à B2G OS.</dd> - </dl> - </td> - <td> - <h2 class="Community" id="Installer_B2G_OS_etou_Gaia">Installer B2G OS et/ou Gaia</h2> - - <dl> - <dt><a href="/fr/Firefox_OS/Choisir_comment_lancer_Gaia_ou_B2G">Choisir comment exécuter Gaia ou B2G</a></dt> - <dd>Vous pouvez utiliser Gaia dans B2G, ou vous pouvez exécuter B2G OS sur un appareil mobile ou dans un simulateur pour ordinateur. Ce guide vous aidera à décider quelle est la solution la plus adaptée à vos besoins.</dd> - <dt><a href="/fr/Firefox_OS/Building_the_Firefox_OS_simulator">Compiler le simulateur B2G OS</a></dt> - <dd>Un guide pour compiler le simulateur B2G OS ; il vous permet de lancer Gaia et des Web apps dans un environnement basé sur Gecko, sur votre ordinateur de bureau, de manière similaire à un véritable appareil.</dd> - <dt><a href="/fr/Firefox_OS/Using_the_B2G_emulators">Utiliser les émulateurs B2G</a></dt> - <dd>Un guide pour compiler et utiliser les émulateurs B2G OS, et quand utiliser ces émulateurs.</dd> - <dt><a href="/fr/Firefox_OS/Installer_sur_un_telephone_mobile">Installer B2G OS sur un appareil mobile</a></dt> - <dd>Comment installer B2G OS sur un vrai appareil mobile.</dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/mettre_en_place_un_environnement_de_construction/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/mettre_en_place_un_environnement_de_construction/index.html deleted file mode 100644 index ac146a4572..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/mettre_en_place_un_environnement_de_construction/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Mettre en place un environnement de construction -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Mettre_en_place_un_environnement_de_construction -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/Establish_a_Build_Environment ---- -<div class="summary"> -<p><span class="seoSummary">Avant de télécharger le code pour construire Firefox OS, vous devez configurer votre système de construction — cette page vous montre comment faire. Actuellement, les distributions Linux 64 bits et OS X peuvent être utilisées.</span></p> -</div> - -<h2 id="Prérequis_pour_un_environnement_de_construction_sous_Linux">Prérequis pour un environnement de construction sous Linux</h2> - -<p>Pour compiler sous Linux, vous avez besoin de :</p> - -<ul> - <li>Une distribution Linux <strong>64 bit</strong>.</li> - <li>Au moins <strong>4 Go</strong> de RAM.</li> - <li>Au moins <strong>40 Go</strong> d'espace disque disponible.</li> -</ul> - -<p>Ubuntu 14.04 LTS est testée et recommandée.</p> - -<h3 id="Installation_des_paquets_requis">Installation des paquets requis</h3> - -<pre>sudo apt-get install git-core gnupg flex bison gperf build-essential \ - zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ - lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \ - libgl1-mesa-dev libxml2-utils xsltproc unzip autoconf2.13 lzop</pre> - -<h3 id="Configuration_de_l'accès_USB">Configuration de l'accès USB</h3> - -<p>Sur les systèmes Linux, par défaut, un utilisateur normal ne peut pas accéder directement aux périphériques USB. Vous devez configurer des règles udev. Créez un fichier <code>/etc/udev/rules.d/51-android.rules</code> avec la commande suivante :</p> - -<pre>wget -S -O - https://raw.githubusercontent.com/mozilla-b2g/B2G/master/tools/51-android.rules | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules</pre> - -<p>Les nouvelles règles prendront effet la prochaine fois qu'un périphérique sera branché.</p> - -<h2 id="Prérequis_pour_un_environnement_de_construction_sous_OS_X">Prérequis pour un environnement de construction sous OS X</h2> - -<p>Pour compiler sur OS X, vous avez besoin de :</p> - -<ul> - <li>Un ordinateur Macintosh moderne.</li> - <li>Une machine virtuelle avec Ubuntu 14.04 LTS installé.</li> -</ul> - -<p>Maintenant que vous avez mis en place votre machine de construction, il est temps de <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Configurer_votre_première_construction">Configurer votre première construction</a>.</p> diff --git a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/résumé_processus_compilation_firefox_os/index.html b/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/résumé_processus_compilation_firefox_os/index.html deleted file mode 100644 index bec1671e7d..0000000000 --- a/files/fr/archive/b2g_os/building_and_installing_boot_to_gecko/résumé_processus_compilation_firefox_os/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Résumé du processus de compilation de Firefox OS -slug: >- - Archive/B2G_OS/Building_and_installing_Boot_to_Gecko/Résumé_processus_compilation_Firefox_OS -tags: - - Firefox OS - - build - - install -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary ---- -<div class="summary"> -<p>Compiler, construire et installer Firefox OS demande du temps, une connexion Internet et de la puissance de calcul. Plusieurs obstacles peuvent poser problème en chemin. Cette page liste les différentes étapes dans leur ensemble pour aider l'utilisateur. Chacune des étapes est traitée par une page distincte, liée depuis cet article.</p> -</div> - -<div class="note"> -<p><strong style="font-weight: bold;">Note :</strong> Le processus de compilation de Firefox OS contient de nombreuses références à « B2G » ou « Boot2Gecko ». Boot2Gecko était le nom de code original du projet Firefox OS.</p> -</div> - -<h2 id="L'objectif_de_la_compilation_quatre_fichiers_image">L'objectif de la compilation : quatre fichiers image</h2> - -<p>Le but général de la compilation est de construire quatre fichiers, appelés images, qui peuvent être copiés sur un appareil Firefox OS.</p> - -<table style="margin: 4px auto; vertical-align: top; width: 90%;"> - <tbody> - <tr> - <td><strong>boot.img</strong></td> - <td>Le noyau Linux et l'image d'un système de fichiers racine (<em>root filesystem</em>). Ce dernier fournit un ensemble d'outils Unix de base.</td> - </tr> - <tr> - <td><strong>system.img</strong></td> - <td>Le cœur de Firefox OS, avec des fragments de Gonk, la version de Gecko portée et l'exécutable b2g.</td> - </tr> - <tr> - <td><strong>userdata.img</strong></td> - <td>Le profil Gecko de l'utilisateur ainsi que les applications web de Gaia pour l'appareil.</td> - </tr> - <tr> - <td><strong>recovery.img</strong></td> - <td>Un noyau Linux accompagné d'une image d'un système de fichiers racine (<em>root filesystem</em>) et d'un outil permettant aux utilisateurs de réparer une installation défectueuse.</td> - </tr> - </tbody> -</table> - -<p>Une fois que ces quatre images auront été créées, elles pourront être transférées sur l'appareil.</p> - -<p>Firefox OS est construit sur le projet Android Open Source Project (AOSP). Les outils AOSP <code>adb</code> et <code>fastboot</code> permettent d'accéder et de manipuler l'appareil de façon efficace. On notera la commande <code>adb reboot-bootloader</code> qui permet de redémarrer un appareil connecté à l'ordinateur et de l'arrêter à l'étape où le chargeur d'amorçage (<em>bootloader</em>) rentre en jeu. Ainsi, on pourra utiliser la commande <code>fastboot flash $partition $image</code> pour copier une image sur une des partitions de l'appareil.</p> - -<h3 id="L'image_boot.img">L'image boot.img</h3> - -<p>L'image d'amorce (<em>boot</em>) <code>boot.img</code> combine un noyau Linux et une partition racine initiale afin de fournir un certain nombre d'outils logiciels de base et le nécessaire pour exécuter le script d'initialisation. Ce script sera copié depuis l'image vers la mémoire de l'appareil pour être utilisé efficacement par ce dernier. C'est ce qu'on appelle un <em>ramdisk</em>. L'image boot.img sera copiée sur la partition '<code>boot</code>' de l'appareil et les contenus du ramdisk seront visibles à la racine lorsqu'on accédera au système de fichiers lors de l'exécution (par exemple lorsqu'on utilisera <code>adb shell</code>).</p> - -<p>L'image de boot permet de définir les permissions de l'utilisateur administrateur (root) dans le fichier <code>default.prop</code> situé à la racine.</p> - -<p>Il est aussi possible de modifier des images de boot existantes en inspectant le fichier puis en découpant ce fichier entre le noyau (<em>kernel</em>) et l'image du ramdisk, puis en extrayant les contenus de l'image du ramdisk, en les modifiant avant de ré-assembler l'image du ramdisk et de reconstruire un fichier boot.img fonctionnel. Voir la page <a href="http://k.japko.eu/alcatel-otf-hackers-guide-1.html">Alcatel One Touch Fire Hacking (Mini) Guide</a> (en anglais).</p> - -<p>Les images d'amorce peuvent être testées avant d'être installées en les téléchargeant sur l'appareil depuis l'ordinateur (<em>sideloading</em>). L'appareil peut être démarré et on peut faire une pause au niveau du chargeur d'amorçage pour utiliser la commande <code>fastboot boot /un/chemin/vers/boot.img</code> sans avoir installé l'image.</p> - -<h3 id="L'image_système">L'image système</h3> - -<p>L'image système (<code>system.img</code>) fournit le noyau de Firefox OS :</p> - -<ul> - <li><strong>Gonk</strong> : les composants de bas niveau du système d'exploitation</li> - <li><strong>Gecko</strong> : une version portée du moteur de rendu HTML et du moteur JavaScript de Firefox</li> - <li><strong>B2G</strong> : les outils et processus liés au système d'exploitation</li> -</ul> - -<div class="note"> -<p>Voir la page concernant <a href="/Firefox_OS/Platform">la plate-forme Firefox OS</a>, pour plus de détails sur l'architecture utilisée.</p> -</div> - -<p>L'image système sera copiée sur la partition <code>system</code> et sera visible dans le répertoire <code>/system/</code> lorsqu'on accédera au système de fichiers lors de l'exécution.</p> - -<div class="note"> -<p><strong>Note </strong>: L'image système fournit également les blobs binaires pouvant être utilisés par l'appareil, notamment le blob de la RIL (Radio Interface Layer) qui permet de contrôler les composants liés à la communication radio de l'appareil.</p> -</div> - -<h3 id="L'image_des_données_utilisateur">L'image des données utilisateur</h3> - -<p>L'image des données utilisateur (<code>userdata.img</code>) fournit les applications Gaia chargées lors de l'exécution.</p> - -<p>Cette image sera copiée sur la partition <code>userdata</code> de l'appareil et son contenu pourra être visible depuis le répertoire <code>/data/</code> lorsque le système de fichiers sera accessible. On retrouvera notamment le dossier <code>/data/b2g/</code> qui contient le profil Mozilla Gecko de l'utilisateur de l'appareil et le répertoire <code>/data/local/webapps/</code> qui contient les applications web à la disposition de l'appareil.</p> - -<h3 id="L'image_de_récupération">L'image de récupération</h3> - -<p>L'image de récupération/dépannage (<code>recovery.img</code>) contient le même noyau Linux ainsi qu'un ramdisk semblables à ceux présents sur l'image d'amorce (boot). Cependant, l'image de récupération utilise un autre script d'initialisation qui permet à l'utilisateur de pouvoir utiliser des commandes pour dépanner/récupérer l'appareil grâce aux boutons physiques de l'appareil.</p> - -<p>Cette image sera copiée sur la partition <code>recovery</code> de l'appareil. Cette partition n'est pas montée dans le système de fichiers lors d'une exécution normale.</p> - -<h2 id="Le_processus_de_compilation_préparation_configuration_compilation_et_installation">Le processus de compilation : préparation, configuration, compilation et installation</h2> - -<p>L'ensemble de la compilation et de l'installation de Firefox OS se déroule selon quatre étapes :</p> - -<table style="margin: 4px auto; vertical-align: top; width: 90%;"> - <tbody> - <tr> - <td><strong>La préparation</strong></td> - <td>Récupérer les programmes utilisés lors de la compilation comme les compilateurs, les bibliothèques...</td> - </tr> - <tr> - <td><strong>La configuration</strong></td> - <td>Télécharger le code source qui sera compilé et créer le fichier <code>.configure</code> qui définit les variables d'environnement nécessaires et d'autres valeurs utilisées lors de la compilation.</td> - </tr> - <tr> - <td><strong>La compilation</strong></td> - <td>Compiler le profil Gecko de l'utilisateur ainsi que les applications Gaia pour l'appareil</td> - </tr> - <tr> - <td><strong>L'installation</strong></td> - <td>Installer les fichiers sur l'appareil.</td> - </tr> - </tbody> -</table> - -<p> </p> - -<h3 id="La_préparation">La préparation</h3> - -<p>La préparation initiale permet de s'assurer que l'ordinateur possède bien l'ensemble des outils logiciels nécessaires à la compilation (tels que les compilateurs et les outils de compilation).</p> - -<p>Cette étape peut être réalisée manuellement ou grâce à un script. Vous pourrez trouver les informations nécessaires sur la page concernant <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS" title="Firefox OS build prerequisites">les prérequis pour construire Firefox OS</a>.</p> - -<div class="note"> -<p><strong>Note</strong> : Sur les systèmes UNIX (ou proches d'UNIX), il est possible de vérifier la présence d'un logiciel en utilisant la commande <code>which</code> qui prend en argument le nom du programme.</p> -</div> - -<h3 id="La_configuration">La configuration</h3> - -<p>Le processus de compilation commence au moment où on obtient un exemplaire du code logiciel de Firefox OS (alias B2G), généralement en créant un clone git du projet <code>B2G</code>. Cette étape permettra de récupérer l'ensemble du code source à compiler et de créer un fichier <code>.config</code> qui permet de définir les variables liées à la compilation.</p> - -<p>Cette étape est réalisée grâce au script <code>config.sh</code>. Vous pourrez trouver les informations nécessaires sur la page de <a href="/fr/Firefox_OS/Preparing_for_your_first_B2G_build" title="Preparing for your first B2G build">préparation à la première compilation de B2G</a>.</p> - -<p>Le script de configuration prendra en argument le type d'appareil pour lequel compiler. Les noms utilisés ici sont des noms de code liés à l'architecture du processeur (CPU) plutôt que des noms d'appareils spécifiques. Il n'y a, pour le moment, aucun moyen de déterminer quelle version fonctionne sur quel appareil physique. La liste de ces noms de code peut être trouvée <a href="/en-US/Firefox_OS/Phones">ici</a>.</p> - -<p>Ce sera également lors de l'étape de configuration qu'on utilisera l'outil <code>repo</code> du projet Android Open Source Project pour télécharger (ou mettre à jour) une copie du code utilisé lors de la compilation. Cet exemplaire sera stocké dans le répertoire <code>.repo/projects</code>. Cette partie de la configuration nécessitera de télécharger beaucoup de données et pourra prendre beaucoup de temps. Cela explique en grande partie pourquoi la configuration, dans son ensemble, prend beaucoup de temps.</p> - -<h3 id="La_compilation">La compilation</h3> - -<p>L'étape de compilation consiste à compiler le code source mis à disposition pour produire les images nécessaires.</p> - -<p>Pour exécuter cette étape, on lancera le script <code>build.sh</code>. Vous pourrez trouver toutes les informations nécessaires sur la page dédiée à <a href="/en-US/Firefox_OS/Building" title="Building">la compilation de Firefox OS</a>.</p> - -<p>Par défaut, l'étape de compilation est effectuée en une fois, de la compilation du projet Android AOSP, en passant par celle du noyau Linux jusqu'aux applications de Gaia. Si jamais la compilation échoue, il peut être compliqué de déterminer laquelle de ces étapes est en cause.</p> - -<p>Pour cette raison, il est possible de ne compiler que certaines parties de la pile logicielle concernant Firefox. Ainsi, on peut compiler uniquement Gecko en appelant le script avec le paramètre <code>gecko</code>. On peut faire de même avec le paramètre <code>gaia</code>. Ces composants pourront ensuite être installés séparément sur l'appareil (voir ci-après).</p> - -<p>On peut également compiler les fichiers pour créer les images une à une. L'image système, par exemple, peut être construite grâce à la commande <code>./build.sh out/platform/$target/system.img</code>, avec le paramètre <code>$target</code> étant celui utilisé lors de la configuration.</p> - -<h3 id="L'installation">L'installation</h3> - -<p>L'installation consiste à envoyer le code compilé sur l'appareil. Cette étape est exécutée grâce au script <code>flash.sh</code>.</p> - -<p>Il est possible d'installer (ou de réinstaller) uniquement certains fragments en utilisant un paramètre du script. On peut par exemple installer uniquement Gaia grâce à la commande <code>./flash.sh gaia</code>.</p> diff --git a/files/fr/archive/b2g_os/building_b2g_for_qemu_emulator/index.html b/files/fr/archive/b2g_os/building_b2g_for_qemu_emulator/index.html deleted file mode 100644 index 936338ec2a..0000000000 --- a/files/fr/archive/b2g_os/building_b2g_for_qemu_emulator/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Construire B2G pour l'émulateur QEMU -slug: Archive/B2G_OS/Building_B2G_for_QEMU_Emulator -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS ---- -<p></p><div class="overheadIndicator obsolete obsoleteHeader"><p><strong><span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> Obsolète</strong><br>Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.</p></div><p></p> - -<p></p><div class="warning">Cet article est obsolète. Voir le guide complet <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko" title="/en-US/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a> pour construire Firefox OS.</div><p></p> - -<p>Il est nécessaire d'avoir déjà <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS" title="https://developer.mozilla.org/en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment">configuré votre environnement de construction et cloné les dépôts</a>.</p> - -<p>Les étapes suivantes vous permettront de<strong> construire - et faire fonctionner - B2G sur votre émulateur</strong>. NE les exécuter PAS en tant que root.</p> - -<p><span style="font-family: inherit;"><span style="font-family: courier new,courier,monospace;">$ cd B2G</span></span><br> - <span style="font-family: inherit;"><span style="font-family: courier new,courier,monospace;">$ make sync</span></span></p> - -<p><a class="external" href="http://3.bp.blogspot.com/-5o6HoCR0xE0/Tydf8jj-UPI/AAAAAAAAAMk/EfcvWBaWv-w/s320/Make+Sync.tiff"><img alt="" class="default" src="http://3.bp.blogspot.com/-5o6HoCR0xE0/Tydf8jj-UPI/AAAAAAAAAMk/EfcvWBaWv-w/s320/Make+Sync.tiff"></a></p> - -<p>Construisez la configuration pour QEMU :<br> - <code>$ make config-qemu</code></p> - -<p>Ensuite, construisez la sous-couche gonk puis le système lui-même :<br> - <code>$ make gonk<br> - $ make</code><br> - <br> - REMARQUE : si ./emu.sh - votre émulateur - ne s'exécute pas, vous devez le rendre exécutable :<br> - <code>$ chmod +x emu.sh</code><br> - <br> - Enfin, lancez l'émulateur :<br> - <code>$ ./emu.sh</code></p> - -<p>REMARQUE : Après avoir cloné vos dépôts ou avoir procédé à votre première construction, vous pouvez les nettoyer ("clean") - c'est-à-dire les mettre dans un état où la dernière récupération est identique à un nouveau clone.</p> - -<p>Pour faire cela, depuis la racine de votre dépôt :<br> - <span style="font-family: courier new,courier,monospace;">$ make sync; git clean -xfd; git submodule foreach "git clean -xfd"</span><br> - Ou sinon, vous pouvez essayer :<br> - <span style="font-family: courier new,courier,monospace;"><span style="font-family: inherit;"><span style="font-family: courier new,courier,monospace;">$ make mrproper</span></span></span></p> diff --git a/files/fr/archive/b2g_os/building_the_firefox_os_simulator/index.html b/files/fr/archive/b2g_os/building_the_firefox_os_simulator/index.html deleted file mode 100644 index 3347a9da08..0000000000 --- a/files/fr/archive/b2g_os/building_the_firefox_os_simulator/index.html +++ /dev/null @@ -1,264 +0,0 @@ ---- -title: Compilation du Simulateur Firefox OS -slug: Archive/B2G_OS/Building_the_Firefox_OS_simulator -tags: - - Appareil - - Firefox OS - - Gaia - - Mobile - - simulateur -translation_of: Archive/B2G_OS/Building_the_B2G_OS_simulator ---- -<div class="summary"> -<p>Le simulateur Firefox OS permet d'exécuter Gaia et des applications Web dans un environnement basé sur Gecko, un peu comme sur un véritable appareil. Il n'émule pas la couche matérielle et n'est donc pas adapté aux tests des APIs des appareils, et ce n'est pas une alternative pour faire des tests sur du vrai matériel. Cependant, il comporte plusieurs APIs qui ne sont pas disponibles sur Firefox comme les APIs <a href="/en-US/docs/WebAPI/Contacts">Contacts</a> et <a href="/en-US/docs/WebAPI/Settings">Settings</a>. Il peut par conséquent être utile pendant le développement de votre application, ou lors du travail sur l'interface utilisateur Gaia elle-même. Cet article aborde le téléchargement et la compilation du simulateur Firefox OS ainsi que son utilisation.</p> -</div> - -<div class="note"> -<p><strong>Note :</strong> La méthode la plus simple pour utiliser le client Firefox OS pour bureau consiste à installer le <a href="/fr/docs/Outils/Simulateur_Firefox_OS">module Simulateur Firefox OS</a> via <a href="/fr/docs/Outils/WebIDE">WebIDE</a>. La compilation du simulateur par vous-même n'est pas nécessaire.</p> -</div> - -<h2 id="Téléchargement_de_la_version_nocturne">Téléchargement de la version nocturne</h2> - -<p>Tout comme les <a href="http://nightly.mozilla.org" title="http://nightly.mozilla.org">Nocturnes de Firefox</a>, le simulateur Firefox OS (identifié par <em>b2g-</em>) est automatiquement reconstruit chaque jour à partir du code source le plus récent. La dernière version compilée est <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/" title="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">disponible sur le serveur FTP de Mozilla</a>. Assurez-vous de prendre la dernière version et la bonne archive en fonction de votre système d'exploitation. Cela vous évitera de devoir le compiler vous-même. De plus, vous n'aurez pas à télécharger Gaia non plus.</p> - -<p>L'application doit être installée dans un endroit accessible en écriture ; elle a besoin de pouvoir mettre à jour le profil Gaia inclus.</p> - -<p>Vous pouvez maintenant vous rendre directement à <a href="#Running_the_simulator" title="#Running_the_simulator">Exécution du simulateur</a>, sauf si vous souhaitez réellement le compiler vous-même. Vous devrez le faire dans le cas où vous voulez apporter des modifications au code et tester ces modifications.</p> - -<h2 id="Compilation_du_simulateur">Compilation du simulateur</h2> - -<p>La première chose nécessaire est la mise en place un <a href="/En/Developer_Guide/Build_Instructions#Build_prerequisites" title="En/Developer_Guide/Build_Instructions#Build_prerequisites">environnement de construction Mozilla standard</a>. Une fois fait, vous pouvez récupérer le code dont vous avez besoin et le configurer pour compiler le client Firefox OS pour ordinateur.</p> - -<h3 id="Téléchargement_du_code_pour_la_première_fois">Téléchargement du code pour la première fois</h3> - -<p>Dans le répertoire où vous voulez placer le code source, clonez le dépôt <code>mozilla-central</code> qui contient l'ensemble de Gecko :</p> - -<pre class="brush: bash"> hg clone http://hg.mozilla.org/mozilla-central</pre> - -<p><span style="line-height: 21px;">Sinon, vous pouvez télécharger le même code depuis Github :</span></p> - -<pre class="brush: bash"> git clone https://github.com/mozilla/gecko-dev</pre> - -<h3 id="Mise_à_jour_du_code">Mise à jour du code</h3> - -<p>Pour les compilations ultérieures, il faut être sûr d'avoir récupéré les dernières modifications :</p> - -<pre class="brush: bash">cd mozilla-central -hg pull -u -</pre> - -<p>ou</p> - -<pre class="brush: bash">cd gecko-dev -git pull -</pre> - -<h3 id="Création_de_mozconfig">Création de mozconfig</h3> - -<p>Ensuite, vous devez créer un fichier appelé <code>.mozconfig</code> dans le répertoire <code>mozilla-central</code> pour que le système de construction soit configuré pour compiler le client Boot to Gecko au lieu de Firefox. Ce fichier doit avoir le contenu suivant :</p> - -<pre class="brush: bash">. "$topsrcdir/b2g/config/mozconfigs/common" - -mk_add_options MOZ_OBJDIR=../build # This line should be commented if you use gecko-dev or <code>mozilla-central</code> -mk_add_options MOZ_MAKE_FLAGS="-j9 -s" - -ac_add_options --enable-application=b2g -ac_add_options --disable-libjpeg-turbo - -# This option is required if you want to be able to run Gaia's tests -ac_add_options --enable-tests - -# turn on mozTelephony/mozSms interfaces -# Only turn this line on if you actually have a dev phone -# you want to forward to. If you get crashes at startup, -# make sure this line is commented. -#ac_add_options --enable-b2g-ril</pre> - -<p>Vous devez également inclure la ligne <code>ENABLE_MARIONETTE=1</code> dans le fichier si vous souhaitez exécuter <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Mochitests">Mochitests</a> dans le client B2G pour ordinateur (soit <code>mochitest-b2g-desktop</code>, soit <code>mochitest-plain</code>) ou si vous voulez lancer les <a href="/en-US/Firefox_OS/Platform/Automated_testing/gaia-ui-tests/Gaia_UI_Tests_Run_Tests">tests unitaires Gaia</a>.</p> - -<h3 id="Compilation">Compilation</h3> - -<p>Vous pouvez à présent construire le client pour ordinateur avec la commande suivante (exécutez-la à l'intérieur du répertoire <code>mozilla-central</code>) :</p> - -<pre class="brush: bash">./mach build -</pre> - -<p>Le client compilé sera placé dans le répertoire <code>objdir/dist/bin</code> (en fonction de la valeur de <code>MOZ_OBJDIR</code> spécifiée dans le fichier <code>mozconfig</code>).</p> - -<div class="note"> -<p><strong>Note :</strong> Si vous avez le moindre problème, commencez par <a href="/fr/docs/Documentation_sur_la_compilation#Pr.C3.A9alables_.C3.A0_la_compilation">vérifier les dépendances</a>.</p> -</div> - -<h2 id="Téléchargement_de_Gaia">Téléchargement de Gaia</h2> - -<p>Par défaut, le simulateur affichera un écran vide car il ne sait pas quelle application web il doit charger au démarrage comme application système. L'ensemble des applications système et celles par défaut qui sont fournies avec Firefox OS — Gaia — doivent être téléchargés.</p> - -<p>Pour télécharger Gaia pour la première fois, clonez le dépôt contenant le code source sur GitHub :</p> - -<pre class="brush: bash">git clone https://github.com/mozilla-b2g/gaia -cd gaia</pre> - -<p>Pour actualiser une copie de Gaia déjà existante, vous pouvez récupérer les dernières modifications depuis GitHub :</p> - -<pre class="brush: bash">cd gaia -git pull -</pre> - -<h2 id="Création_de_custom-settings.json">Création de custom-settings.json</h2> - -<p>Si vous savez ce que vous faîtes et que vous souhaitez définir des options de configuration, vous pouvez créer le fichier <code>gaia/build/config/custom-settings.json</code> pour les y ajouter, par exemple :</p> - -<pre><span class="brush: js">{ - "lockscreen.enabled": false, - "lockscreen.locked": false, - "devtools.debugger.remote-enabled": true -}</span></pre> - -<p>Cet exemple est utile pour outrepasser l'écran de verrouillage, ce dernier étant autrement impossible à passer sur ordinateur car il ne peut pas être déverrouillé avec une souris ou un pavé tactile.</p> - -<h2 id="Génération_d'un_profil">Génération d'un profil</h2> - -<p>Ensuite, nous devons préparer les applications de Gaia pour le simulateur. Cela comprend le fait d'empaqueter les applications Gaia de la même façon que si elles étaient installées sur l'appareil, ainsi que la mise en place des permissions pour les applications systèmes privilégiées. Cela est réalisé par la génération d'un profil. La commande suivante (à lancer dans le dossier de téléchargement de <code>gaia</code>) effectuera cette tâche :</p> - -<pre class="brush: bash">make DESKTOP_SHIMS=1 NOFTU=1 DEBUG=1 -</pre> - -<p>Un dossier <code>profile-debug</code> sera créé sous le répertoire <code>gaia</code>. Le nouveau profil contient une extension personnalisée et d'autres éléments de configuration nécessaires au bon fonctionnement de B2G.</p> - -<div class="note"> -<p><strong>Note</strong> : Il existe actuellement un bogue (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180103" title="B2G desktop client get an empty homescreen when run w/ debug profile (gaia/profile-debug)">bug 1180103</a>) qui fait qu'avec les profils de débogage de Gaia l'écran d'accueil est vide lors de l'exécution avec le Simulateur Firefox OS (depuis WebIDE, ou autre.) Il peut être contourné en compilant avec <code>DEBUG=1 DESKTOP=0 make au lieu de</code> <code>DEBUG=1</code>.</p> -</div> - -<h2 id="Exécution_du_simulateur">Exécution du simulateur</h2> - -<p>Une fois que vous avez construit le client (ou téléchargé et installé la version nocturne de l'application de bureau) et téléchargé Gaia , vous êtes prêt à lancer le simulateur.</p> - -<h3 id="Exécution_sous_Linux">Exécution sous Linux</h3> - -<p>Pour lancer le simulateur sur Linux en utilisant le profil Gaia qu'il contient, exécutez simplement l'exécutable <code>b2g</code>. Le binaire se trouve dans l'archive téléchargée plus tôt ou dans le répertoire <code>objdir/dist/bin</code> si vous avez compilé le client vous-même.</p> - -<pre class="brush: bash">b2g -profile gaia/profile-debug -</pre> - -<p>Vous pouvez rencontrer des problèmes gênants de rendu. Pour les éviter, ajoutez la ligne suivante dans votre fichier <code>gaia/profile/user.js</code> :</p> - -<pre>user_pref("layers.acceleration.disabled", true); -</pre> - -<h3 id="Exécution_sur_Mac">Exécution sur Mac</h3> - -<p>Si vous avez téléchargé la version Nocturne, vous pouvez l'exécuter simplement à partir du Finder de manière classique. Les sorties de la console sont visibles en lançant l'utilitaire Console standard fourni avec votre Mac.</p> - -<p>Si vous souhaitez spécifier un profil Gaia différent (tel que votre téléchargement Gaia fait plus haut), vous devez ignorer le wrapper <code>b2g</code> et exécuter le binaire <code>b2g</code>. La ligne de commandes est légèrement plus compliquée en raison de l'emplacement du binaire <code>b2g</code> et de l'obligation d'utiliser des chemins absolus pour indiquer le répertoire du profil :</p> - -<pre>.../B2G.app/Contents/MacOS/b2g-bin -profile /chemin/complet/vers/profile-debug/gaia -</pre> - -<h3 id="Exécution_sous_Windows">Exécution sous Windows</h3> - -<p>Exécuter la version Nocturne sous Windows se résume à lancer <code>b2g.exe</code>. Si vous voulez personnaliser l'exécution, vous pouvez le faire en lançant l'exécutable <code>b2g.exe</code> à la place ; cela contourne le wrapper qu'utilise automatiquement Gaia.</p> - -<h2 id="Options_de_la_ligne_de_commandes">Options de la ligne de commandes</h2> - -<p>Il y a un certain nombre d'options de ligne de commandes qu'il est possible de préciser afin d'ajuster l'expérience lors de l'utilisation du simulateur. Vous pouvez en obtenir une liste avec l'option <code>-help</code>. Cette section en décrit certaines particulièrement intéressantes.</p> - -<h3 id="option-screen" name="option-screen">Configuration de la taille de l'écran</h3> - -<p>Vous pouvez spécifier la taille de l'écran de l'appareil à simuler avec l'option <code>-screen</code> :</p> - -<pre class="brush: bash">b2g -screen<em> <largeur></em>x<em><hauteur></em>@<em><ppp></em></pre> - -<p>Où <em><largeur></em>, <em><hauteur></em>, et <em><ppp></em> sont des paramètres aux noms explicites : la largeur et la hauteur de l'écran en pixels et la résolution en PPP. Voici des exemples concrets :</p> - -<pre class="brush: bash">b2g -screen 320x480 -b2g -screen 320x480@160 -</pre> - -<p>De manière facultative, il est possible d'indiquer par leur nom des appareils spécifiques pour simuler leurs tailles d'écran et résolutions :</p> - -<ul> - <li><code>iphone</code></li> - <li><code>ipad</code></li> - <li><code>nexus_s</code></li> - <li><code>galaxy_nexus</code></li> - <li><code>galaxy_tab</code></li> - <li><code>wildfire</code></li> - <li><code>tattoo</code></li> - <li><code>salsa</code></li> - <li><code>chacha</code></li> -</ul> - -<p>Ces appareils préréglés sont définis dans <a href="https://github.com/mozilla/gecko-dev/blob/master/b2g/chrome/content/screen.js">screen.js</a>.</p> - -<p>Afin de sélectionner des écrans différents, le chemin du profil doit être spécifié comme ceci :</p> - -<div class="geckoVersionNote"> -<p>./b2g-bin --profile ./gaia/profile/ --screen=galaxy_tab</p> -</div> - -<h3 id="option-console" name="option-console">Ouverture de la console JavaScript</h3> - -<p>La console JavaScript peut être ouverte lors du lancement du simulateur en l'exécutant à partir de la ligne de commandes avec l'option <code>-jsconsole</code>. Après la compilation, tapez :</p> - -<pre class="brush: bash">.../b2g -jsconsole -profile <em>/chemin/vers/votre/profil</em></pre> - -<p>Si vous avez installé la version Nocturne sur un Mac, vous pouvez utiliser ce qui suit :</p> - -<pre class="brush: bash">/Applications/B2G.app/Contents/MacOS/b2g -jsconsole -profile <em>/chemin/vers/votre/profil-debug</em></pre> - -<div class="note"> -<p><strong>Note :</strong> Sur les versions de production de Firefox OS, la journalisation vers la console (par exemple <a href="/fr/docs/Web/API/Console/log" title="Affiche un message dans la Console Web."><code>console.log()</code></a>) est désactivée par défaut. Pour l'activer, ouvrez les <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">paramètres Développeurs</a> et activez le paramètre <em>Activer la console</em>.</p> -</div> - -<h3 id="option-runapp" name="option-runapp">Exécution d'une application spécifique au démarrage</h3> - -<p>Vous pouvez spécifier une application à lancer automatiquement lorsque le simulateur démarre b2g. Son lancement se fera dès que le chargement du reste du système sera terminé. Dans ce but, utilisez simplement l'option <code>-runapp</code>, elle prend comme paramètre le nom de l'application à exécuter. Par exemple :</p> - -<pre class="brush: bash"> .../b2g -profile <em>/chemin/vers/votre/profil-debug/gaia</em> -runapp email</pre> - -<div class="note"> -<p><strong>Note</strong> : Le nom spécifié est normalisé en le convertissant tout en minuscules et en supprimant tous les tirets et espaces. Ce nom normalisé est ensuite comparé aux noms normalisés similaires extraits des manifestes des applications disponibles. Par exemple, le nom de l'application de courriel est actuellement "E-mail", mais <code>-runapp email</code> fonctionnera grâce à cette normalisation.</p> -</div> - -<p>Si vous spécifiez l'option <code>-runapp</code> sans argument, ou avec un argument vide, le simulateur affichera sur votre terminal une liste des applications connues ainsi qu'un bref message informatif.</p> - -<div class="note"> -<p><strong>Note :</strong> L'utilisation de l'option <code>-runapp</code> a pour effet de bord la désactivation de l'écran de verrouillage et sa non-réactivation. Cela implique de ne pas utiliser cette commande avec un profil sur lequel vous voulez tester l'écran de verrouillage, ou le réactiver manuellement en utilisant <em>Paramètres > Écran de verrouillage</em>. N'hésitez pas à contribuer avec un patch pour modifier ce comportement si c'est un problème.</p> -</div> - -<h2 id="Astuces_pratiques">Astuces pratiques</h2> - -<p>Cette section offre quelques trucs utiles pour utiliser le client de bureau B2G.</p> - -<ul> - <li>La touche Échap a la même fonction que le bouton "retour".</li> - <li>La touche Début a la même fonction que le bouton "home" ; si vous êtes sur Mac, la touche Début est disponible avec Fn + ← (Fn + Flèche Gauche).</li> - <li>La touche Fin a la même fonction que le bouton "power" ; si vous êtes sur Mac, la touche Fin est accessible avec Fn + → (Fn + Flèche Droite).</li> - <li>Les touches Page Haut et Page Bas ont respectivement les mêmes fonctions que les boutons "Volume Haut" et "Volume Bas" ; si vous êtes sur Mac, la touche Page Haut est disponible via Fn + ↑ (Fn + Flèche Haut) et Page Bas avec Fn + ↓ (Fn + Flèche Bas).</li> - <li>Un appui long sur la touche Home ouvre la "Vue Miniatures" ; sur Mac, Cmd + Fn + ← (Cmd + Fn + Flèche Gauche) ouvre la "Vue Miniatures".</li> -</ul> - -<h2 id="Dépannage_Écran_vide_lors_du_démarrage_du_simulateur">Dépannage : Écran vide lors du démarrage du simulateur</h2> - -<p>Lorsque vous démarrez b2g avec <code>b2g -profile gaia/chemin/vers/profil/gaia</code>, un écran vide peut apparaître avec une erreur "Cannot reach app://system.gaiamobile.org". Pour résoudre ce problème, il y a plusieurs choses à vérifier :</p> - -<ul> - <li>Reconstruire le profil gaia en utilisant le profil <code>DEBUG=1 make</code> du répertoire gaia.</li> - <li>Relancer b2g.</li> - <li>Si cela ne corrige pas le problème, vérifiez s'il y a d'autres processus en écoute sur le port 8080. Le profil par défaut de Gaia démarre <code>httpd.js</code> qui utilise ce port. Quand un profil de débogage est utilisé, B2G se connecte à localhost:8080. Si un autre processus fonctionne sur ce même port, b2g ne réussira pas à afficher la page d'accueil de gaia. - <ol> - <li>Pour déterminer si c'est le cas, vous pouvez activer les journaux de <code>httpd.js</code>. Le <code>httpd.js</code> du profil se trouve à l'emplacement <code>gaia/profile/extensions/httpd/content/httpd.js</code>. Ouvrez ce fichier pour édition.</li> - <li>Remplacez la ligne <code>var DEBUG=false;</code> par <code>var DEBUG=true;</code></li> - <li>Enregistrez le fichier et redémarrez B2G. Vous devriez maintenant voir les journaux d'httpd sur la console.</li> - </ol> - </li> -</ul> - -<h2 id="Étapes_suivantes">Étapes suivantes</h2> - -<p>Maintenant que vous disposez d'une version simulée de Boot to Gecko fonctionnelle, vous pouvez faire des tests, du développement, ou tout autre chose avec :</p> - -<ul> - <li><a href="/fr/Firefox_OS/Déboguer" title="en/Mozilla/Boot_to_Gecko/Debugging_on_Boot_to_Gecko">Débogage de Boot to Gecko</a></li> - <li><a href="/fr/Firefox_OS/Automated_testing" title="en/Mozilla/Boot_to_Gecko/Testing_Boot_to_Gecko">Tester Boot to Gecko</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/choisir_comment_lancer_gaia_ou_b2g/index.html b/files/fr/archive/b2g_os/choisir_comment_lancer_gaia_ou_b2g/index.html deleted file mode 100644 index fac1f61ab1..0000000000 --- a/files/fr/archive/b2g_os/choisir_comment_lancer_gaia_ou_b2g/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Choisir comment exécuter Gaia ou B2G -slug: Archive/B2G_OS/Choisir_comment_lancer_Gaia_ou_B2G -tags: - - B2G - - Compilation - - Gaia -translation_of: Archive/B2G_OS/Choosing_how_to_run_Gaia_or_B2G ---- -<p></p> - -<p>En fonction de vos besoins spécifiques, vous avez un large choix d'options disponibles, <span id="result_box" lang="fr"><span class="hps">à prendre en considération </span><span class="hps">lors d'expérimentations</span> <span class="hps">avec Firefox</span> <span class="hps">OS</span> <span class="hps">ou</span> <span class="hps">l'interface utilisateur</span> <a href="/fr/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_a_Gaia"><span class="hps">Gaia</span></a><span>.</span> <span class="hps">Vous pouvez choisir</span> <span class="hps">parmi les</span> <span class="hps">options suivantes </span><span>;</span> <span class="hps">chacune possède ses avantages</span> <span class="hps">et ses</span> <span class="hps">inconvénients</span><span>,</span> <span class="hps">et</span> <span class="hps">certaines sont plus</span> <span class="hps">souples que d'autres</span><span>.</span></span></p> - -<h2 id="Exécuter_B2G_sur_le_bureau">Exécuter B2G sur le bureau</h2> - -<p>Il est possible de compiler un simulateur de Firefox OS et d'exécuter Gaia sur celui-ci. Ce logiciel est basé sur Firefox, mais propose une expérience semblable à un appareil sur Firefox OS. <span id="result_box" lang="fr"><span class="hps">Actuellement</span> <span class="hps">Mozilla</span> <span class="hps">fournit des</span> <a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Gaia"><span class="hps">nightly builds</span></a> <span class="hps">de</span> <span class="hps">cette application</span> <span class="hps">pour les développeurs</span><span>.</span> <span class="hps">Si vous</span> <span class="hps">êtes familier avec</span> <span class="hps">la construction du</span> <span class="hps">code de base</span> <span class="hps">de Firefox</span> <span class="hps">ou</span> des <span class="hps">projets</span> <span class="hps">C++ </span><span>, vous pouvez compiler</span> <span class="hps">vous-même</span> <span class="hps">cette application</span><span>.</span></span></p> - -<h3 id="Avantages">Avantages</h3> - -<ul> - <li>Le simulateur fournit une fenêtre de la taille d'un mobile.</li> - <li>L'expérience est, pratiquement à tous les égards, similaire à celle d'un véritable appareil mobile.</li> - <li>La plupart des APIs sont disponibles (mais pas toutes).</li> -</ul> - -<h3 id="Inconvénients">Inconvénients</h3> - -<ul> - <li>Vous devez avoir au préalable un compilateur C/C++ d'installé.</li> - <li>Vous devez compiler Gecko et le simulateur vous-même.</li> - <li>Les outils de développement de Firefox ne sont pas disponibles.</li> -</ul> - -<h3 id="Pourquoi_exécuter_le_simulateur_B2G">Pourquoi exécuter le simulateur B2G ?</h3> - -<p>C'est une solution convenable pour tester tout en développant. C'est un bon moyen pour obtenir une meilleure idée de la façon dont votre application ou votre code va fonctionner dans un environnement semblable, sans avoir à flasher un téléphone à chaque fois que vous voulez tester quelque chose.</p> - -<div class="note"><strong>Note:</strong> Avant de proposer une application, vous devez absolument le tester sur un véritable appareil !</div> - -<h3 class="note" id="Variétés_de_simulateurs">Variétés de simulateurs</h3> - -<p>Il y a plusieurs variétés de simulateurs Firefox OS disponibles :</p> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Boot_to_Gecko/Using_Firefox_OS_Simulator" title="/en-US/docs/Mozilla/Boot_to_Gecko/Using_Firefox_OS_Simulator">Firefox OS Simulator add-on</a></dt> - <dd>Cette extension est le premier outil pour tester les applications sur Firefox OS et la solution recommandée pour la plupart des utilisateurs. Elle supporte les outils de développement, l'ajout d'applications à l'environement de test...</dd> - <dt>Developer desktop builds</dt> - <dd>Ces compilateurs du simulateur sont des applications stand-alone qui servent principalement d'aide aux développeurs du coeur de Firefox OS, pour vérifier les caractéristiques techniques. </dd> - <dt>Localizer desktop builds</dt> - <dd>Les compilateurs sont utilisés par les équipes de localisation dans leur travail et pour tester leurs localisations de Firefox OS et des aplications Firefox OS.</dd> - <dt> - <h2 id="Exécuter_B2G_sur_un_émulateur">Exécuter B2G sur un émulateur</h2> - </dt> - <dd>Cette solution se situe entre les simulateurs (qui sont seulement des reproductions des plus hauts niveaux de Firefox OS) et l'appareil mobile (qui vous fait bénéficier de l'expérience complète). Par rapport aux simulateurs, les émulateurs exécutent un Firefox OS basé sur un système ARM (l'émulateur x86 étant obsolète) qui reprioduit la quasi-totalité de l'expérience sur téléphone (à l'exception de quelques évènements réseau/radio).</dd> -</dl> - -<h2 id="Exécuter_B2G_sur_un_appareil_mobile">Exécuter B2G sur un appareil mobile</h2> - -<p>La meilleure façon de tester votre travail sur B2G ou Gaia est de compiler puis installer Firefox OS sur un véritable appareil mobile. C'est également le processus le plus compliqué.</p> - -<h3 id="Avantages_2">Avantages</h3> - -<ul> - <li>Vous bénéficiez de l'expérience complète sur appareil mobile.</li> - <li>Toutes les APIs sont disponibles.</li> - <li>Vous pouvez tester les performances de votre code dans un cadre réel.</li> -</ul> - -<h3 id="Inconvénients_2">Inconvénients</h3> - -<ul> - <li>Vous devez avoir installé un compilateur C/C++ complet.</li> - <li>Vous devez compiler Gecko et Gaia vous-même.</li> - <li>Vous devez avoir un appareil mobile compatible sur lequel installer le système d'exploitation B2G.</li> - <li>Vous devez flasher l'appareil avec B2G, ce qui désinstallera n'importe quel système d'exploitation présent.</li> -</ul> - -<h3 id="Pourquoi_exécuter_B2G_sur_un_appareil_mobile">Pourquoi exécuter B2G sur un appareil mobile</h3> - -<p>Il s'agit, évidemment, de la façon la plus précise pour tester tout code ou tout projet web sur B2G ou Gaia. En testant votre projet sur un véritable appareil mobile, vous pouvez vous assurer que votre projet fonctionne et s'affiche bien et utilise toutes les APIs de l'appareil correctement. De plus, vous devriez <strong>toujours</strong> tester sur du matériel réel avant d'embarquer du code ; omettre cette étape peut avoir des conséquences imprévues qui peuvent être difficiles à prévoir.</p> diff --git a/files/fr/archive/b2g_os/compiler/building_an_engineering_build_like_the_ones_publis/index.html b/files/fr/archive/b2g_os/compiler/building_an_engineering_build_like_the_ones_publis/index.html deleted file mode 100644 index 4a600e1eaa..0000000000 --- a/files/fr/archive/b2g_os/compiler/building_an_engineering_build_like_the_ones_publis/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Compiler une version « engineering build officielle » -slug: Archive/B2G_OS/Compiler/Building_an_engineering_build_like_the_ones_publis -translation_of: Archive/B2G_OS/Building#Building_an_official-style_engineering_build ---- -<div class="warning"> -<p><strong>Note éditoriale </strong>: Le contenu de cette page a été déplacé vers <a href="/fr/Firefox_OS/Compiler#Compiler_une_version_«_engineering_build_officielle_»">https://developer.mozilla.org/fr/Firefox_OS/Compiler#Compiler_une_version_«_engineering_build_officielle_»</a>.</p> -</div> diff --git a/files/fr/archive/b2g_os/compiler/compiler_pour_le_fairphone/index.html b/files/fr/archive/b2g_os/compiler/compiler_pour_le_fairphone/index.html deleted file mode 100644 index 1ebbcaf096..0000000000 --- a/files/fr/archive/b2g_os/compiler/compiler_pour_le_fairphone/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Compiler pour le Fairphone -slug: Archive/B2G_OS/Compiler/Compiler_pour_le_Fairphone -translation_of: Archive/B2G_OS/Building/Building_for_Fairphone ---- -<h3 id="EXECUTER_B2GOS_sur_FAIRPHONE">EXECUTER B2GOS sur FAIRPHONE</h3> - -<h5 id="Salut_à_tous_les_possesseurs_de_Fairphones_!_Ce_site_va_vous_permettre_de_construire_et_installer_tout_ce_qu'il_faut_pour_faire_tourner_B2GOS_sur_un_Fairphone_!">Salut à tous les possesseurs de Fairphones !<br> - Ce site va vous permettre de construire et installer tout<br> - ce qu'il faut pour faire tourner B2GOS sur un Fairphone !</h5> - -<p> </p> - -<p>Il comporte :</p> - -<p>Les instructions de construction pour OSX<br> - Les instructions de construction pour Ubuntu 14.4<br> - Les instructions de construction pour Ubuntu 16.4<br> - Comment flasher un appareil sans avoir à récupérer le code !</p> - -<h4 id="Compiler_sur_OSX">Compiler sur OSX</h4> - -<p>En raison de calculs faux ou différents pour la somme de contrôle md5, il ne sera pas possible de compiler sur OS X. Mais vous pouvez y aller avec un Linux virtuel !</p> - -<h4 id="Compiler_sur_14.4.">Compiler sur 14.4.</h4> - -<p>Enchaîner les commandes suivantes permet d'obtenir une version accélérée du processus.</p> - -<p>-> ouvrez un terminal (ctrl, alt et T)</p> - -<p>Tapez ces commandes les unes après les autres :</p> - -<pre class="brush: bash">sudo dpkg --add-architecture i386 -sudo dpkg --add-architecture amd64 -sudo apt-get install git -git config --global user.email " *votreemail@url.tld* " -git config --global user.name " *votrenomdutilisateur* " -git config --global color.ui False</pre> - -<h5 id="Installation">Installation</h5> - -<pre class="brush: bash">sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip lzop libxml2-utils openjdk-7-jdk nodejs unzip python mercurial && ccache -M 50G && echo $PWD && echo "commanding: git clone git://github.com/mozilla-b2g/B2G.git" && git clone git://github.com/mozilla-b2g/B2G.git && cd B2G && echo $PWD && echo "commanding: ./config.sh fairphone2" && ./config.sh fairphone2 && echo $PWD && echo "commanding: cd .. " && cd .. && echo $PWD && echo "commanding: curl -O http://dl.google.com/android/repository/android-ndk-r11b-linux-x86_64.zip" && curl -O http://dl.google.com/android/repository/android-ndk-r11b-linux-x86_64.zip && echo "commanding: unzip android-ndk-r11b-linux-x86_64.zip -d ~/ -home dir- " && unzip android-ndk-r11b-linux-x86_64.zip -d ~/ && echo $PWD && echo "commanding: curl -O https://nodejs.org/download/release/v4.4.7/node-v4.4.7.tar.gz" && curl -O https://nodejs.org/download/release/v4.4.7/node-v4.4.7.tar.gz && echo "commanding: tar -zxvf node-v4.4.7.tar.gz" && tar -zxvf node-v4.4.7.tar.gz && echo "commanding: cd node-v4.4.7" && cd node-v4.4.7 && echo "commanding: ./configure" && ./configure && echo "commanding: make install" && sudo make install && echo $PWD && echo "commanding: back to B2G folder!" && cd ~/B2G -</pre> - -<p>vérifiez ou faites un .userconfig dans le dossier B2G et <strong>n'oubliez pas de remplacer le texte en GRAS par votre nom d'utilisateur système </strong>:</p> - -<pre class="brush: bash">echo "*** entering .userconfig ***" -export B2G_ANDROID_NDK_PATH=/home/<strong>ÉCRIVEZ ICI VOTRE NOM D'UTILISATEUR SYSTÈME</strong>/android-ndk-r11b -echo "B2G_ANDROID_NDK_PATH=$B2G_ANDROID_NDK_PATH" -export B2G_DIR=${B2G_DIR:-$(cd $(dirname $0); pwd)} -echo "B2G_DIR=${B2G_DIR}" -echo "GECKO_OBJDIR = ${GECKO_OBJDIR}" -echo "*** exit .userconfig ***"</pre> - -<p>Si vous souhaitez générer une version pour flasher votre téléphone :</p> - -<pre class="brush: bash">./build.sh -</pre> - -<p>Si vous voulez faire une version pour flasher votre téléphone et mettre à jour le build communautaire :</p> - -<pre class="brush: bash">./build.sh blobfree -</pre> - -<p>Si vous rencontrez des erreurs et que vous avez besoin d'un log de la compilation :</p> - -<pre class="brush: bash">./build.sh showcommands 2>&1 | tee build.log -</pre> - -<p>à chaque fois que vous lancez une nouvelle compilation, nettoyez les répertoires avec ces commandes :</p> - -<pre class="brush: bash">sudo rm -rf out && rm -rf objdir-gecko && rm -rf gaia/profile* && ccache -C -</pre> - -<p> </p> - -<h4 id="B2G-Installer_pour_Fairphone">B2G-Installer pour Fairphone</h4> - -<p>Vous n'avez pas envie de construire votre propre B2G OS ? Vous pouvez flasher votre appareil avec le module b2g-installer et un build communautaire !</p> diff --git a/files/fr/archive/b2g_os/compiler/fota_community_builds/index.html b/files/fr/archive/b2g_os/compiler/fota_community_builds/index.html deleted file mode 100644 index 8d3a7eec38..0000000000 --- a/files/fr/archive/b2g_os/compiler/fota_community_builds/index.html +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Construire et installer des builds communautaires FOTA -slug: Archive/B2G_OS/Compiler/FOTA_community_builds -tags: - - Firefox OS - - Tutoriel - - build -translation_of: Archive/B2G_OS/Building/FOTA_community_builds ---- -<p>Cet article peut vous aider à installer des builds communautaires de Firefox OS sur votre téléphone. Les mises à jour "firmware over the air" (FOTA) de l'OS seront activées sur ces versions.</p> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Afin de compiler et installer cette build, vous devez avoir <em>une machine sur laquelle compiler</em> et <em>une machine hôte</em>. Il peut s'agir d'une seule et même machine.</p> - -<p>Sur la machine de compilation, il est nécessaire d'avoir tous les logiciels requis pour construire une version destinée au téléphone cible (<a href="https://developer.mozilla.org/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour construire Firefox OS</a> apporte davantage d'informations).</p> - -<p>Tout d'abord, vous devez vérifier l'appareil :</p> - -<ul> - <li>Il doit s'agir d'un appareil rooté.</li> - <li>Clés de recovery : nous devons vérifier les clés utilisées au cours du recovery ; celles-ci correspondent aux clés AOSP. Elles sont situées dans : /res/keys/. Ce devrait être les mêmes.</li> - <li>Téléphone déjà doté d'un recovery (librecovery)</li> -</ul> - -<p>Il est possible de construire les versions nocturne, aurora et bêta ; dans ce but, créez simplement 3 dossiers différents : nightly aurora beta (si vous ne souhaitez construire qu'une branche, vous pouvez vous contenter d'un seul répertoire). Nightly est mise à jour chaque nuit, aurora correspond à la dernière version stable et beta à la version qui précède aurora.</p> - -<p>En fonction de vos besoins, vous pouvez décider de construire toutes les branches ou seulement une ou deux. Pour chaque branche dont vous avez besoin, suivez les étapes décrites sur cette page. Lorsque vous aurez atteint le paragraphe "Compilation", les instructions seront de nouveau spécifiques selon les branches.</p> - -<p>Préparez votre première compilation B2G avec la BRANCHE correcte, comme si vous étiez en train de créer une version pour le téléphone cible. Suivez les instructions de cette page (<a href="https://developer.mozilla.org/fr/Firefox_OS/Preparing_for_your_first_B2G_build">Se préparer pour la première construction de B2G</a>) jusqu'à la fin de la section "Configurer B2G pour votre appareil".</p> - -<div class="note"> -<p>Note : si vous avez un manifeste (xml) spécifique pour <code>config.sh</code>, ouvrez ce fichier et remplacez "<em>master</em>" par le nom de la branche que vous voulez dans les "choses spécifiques de B2G".</p> -</div> - -<p>À présent, votre répertoire de travail devrait être <code>[BRANCH]/B2G/</code></p> - -<p>NE PAS COMPILER POUR L'INSTANT ! </p> - -<p>Il y a encore beaucoup de modifications à faire.</p> - -<p><strong>Signatures (seulement pour les appareils Firefox OS par défaut) :</strong></p> - -<p>Toutes les ROMs des appareils Firefox OS doivent être signées ; par contre, pour les appareils Android, ce n'est pas obligatoire.</p> - -<p>Nous ne pouvons fournir que gecko et gaia ; la mise à jour sera signée pour éviter son installation sur un mauvais téléphone.</p> - -<p>Pour cela, vous aurez besoin de la signature de la build racine ; il y a juste à récupérer build.prop depuis le téléphone :</p> - -<pre class="brush: bash">adb pull /system/build.prop</pre> - -<p>Maintenant, cherchez dans ce fichier la valeur de <code>ro.build.fingerprint</code> ; il s'agit de l'empreinte.</p> - -<p><strong>Localisation :</strong></p> - -<p>Il est possible de construire une version contenant toutes les locales en ajoutant ce script (<code>langs.sh</code>) dans <code>gaia/locales </code>ou de choisir de ne cloner que certaines langues. Dans ce dernier cas, modifiez <code>gaia/locales/languages_all.json</code> pour que seules les langues clonées ne soient employées <code>#TOVERIF</code> => <a href="https://developer.mozilla.org/fr/Firefox_OS/Compiler#Compiler_une_version_multilocales">Compilation multilocale</a></p> - -<p>Si vous compilez pour les branches aurora ou beta, remplacez <code>git checkoutmozillaorg/master</code> par <code>git checkout v2.1</code> pour aurora et par <code>git checkout v2.0</code> pour beta dans<code> langs.sh</code></p> - -<p>N'oubliez pas de mettre à jour vos dépôts avant de lancer une nouvelle compilation.</p> - -<p>langs.sh :</p> - -<pre class="brush: bash"> #!/bin/sh - - set -e - GIT_ROOT="<a href="https://git.mozilla.org/releases/l10n/">https://git.mozilla.org/releases/l10n/</a>" - GIT_PROJ="/gaia.git" - LANGS=$(json_pp < languages_all.json | grep ':' | cut -d':' -f1 | cut -d'"' -f2) - for lang in ${LANGS}; do - echo "Syncing $lang" - if [ ! -d ${lang}/.git/ ]; then - echo "No repo for ${lang}, cloning new one" - git clone ${GIT_ROOT}${lang}${GIT_PROJ} $lang || true - else - echo "Updating close for ${lang}" - cd ${lang} && (git fetch origin && git checkout origin/master) || true && cd .. - fi; - done; -</pre> - -<h2 id="Configuration_de_la_compilation">Configuration de la compilation</h2> - -<p>Il est aussi nécessaire d'avoir un fichier <code>.userconfig</code> pour votre construction :</p> - -<p>Créez à la racine de <code>[BRANCH]/B2G/</code> un fichier nommé <code>.userconfig</code> et collez-y ces lignes :</p> - -<pre class="brush: bash"> export SYSTEM_PARTITION=/dev/block/platform/msm_sdcc.1/by-name/system # to specify the system partition, find info with adb shell cat /proc/mounts - export DATA_PARTITION=/dev/block/platform/msm_sdcc.1/by-name/userdata # to specify the data partition, find info with adb shell cat /proc/mounts - export VARIANT=userdebug #to include gaia - export PRODUCTION=1 #to have a user build - export B2G_UPDATER=1 - export B2G_UPDATE_CHANNEL=aurora #to modify [BRANCH] - export ENABLE_DEFAULT_BOOTANIMATION=true #to have B2G boot animation - export GAIA_DEV_PIXELS_PER_PX=1.5 - export LOCALE_BASEDIR=locales/ #Languages folder - export LOCALES_FILE=locales/languages_all.json #all languages for the build - export GAIA_KEYBOARD_LAYOUTS="$((find gaia/apps/keyboard/js/layouts/*.js | sed -e 's|gaia/apps/keyboard/js/layouts/||g' -e 's/\.js$//g') | tr -s '\r\n' ',' | sed -e 's/,$//g')" #All keyboard, you can change this with keyboard you want - export GAIA_DEFAULT_LOCALE=fr #languages by default, fr (french) for example - export B2G_FOTA_DIRS="system/fonts system/b2g" #fira font bug - export FOTA_FINGERPRINTS="[your fingerprint]" -</pre> - -<p>Les variables suivantes devront être éditées :</p> - -<ul> - <li><code>SYSTEM_PARTITION</code> (utilisez <code>adb shell cat /proc/mounts</code> pour connaître la partition)</li> - <li><code>DATA_PARTITION</code> (ici aussi, il est possible d'utiliser <code>adb shell cat /proc/mounts </code>)</li> - <li><code>B2G_UPDATE_CHANNEL</code> dépend de votre canal (aurora, beta, nightly)</li> - <li><code>GAIA_DEFAULT_LOCALE</code> en fonction de la locale souhaitée</li> - <li>(facultatif mais peut-être utile : <code>GAIA_KEYBOARD_LAYOUTS</code> (voir le commentaire))</li> - <li><code>FOTA_FINGERPRINTS</code>: ajoutez la valeur de ro.build.fingerprint</li> - <li> - <p class="brush: bash">GAIA_DEV_PIXELS_PER_PX: pour connaître les réglages corrects de votre appareil, veuillez vous rendre sur <a href="http://devicepixelratio.com/">ce site web </a>avec cet appareil.</p> - </li> -</ul> - -<p>Le texte qui suit le symbole dièse (<code>#</code>) peut être supprimé (y compris le symbole lui-même). Ce sont des commentaires et leur seule raison d'être est d'expliquer à quoi sert la ligne.</p> - -<p>Après cela, il faut définir les informations à propos de l'url de mise à jour :</p> - -<pre class="brush: bash"> cd gecko/ - git checkout -b [VERSION NUMBER ou master pour nightly]-local --track mozillaorg/[VERSION NUMBER ou master pour nightly] - éditez app.update.url dans b2g/app/b2g.js vous pouvez conserver %target% etc.. ou sinon vous pouvez juste avoir quelque chose du genre - pref("app.update.url", "http://[DOMAIN]/[PHONE NAME]/[BRANCH]/update.xml"); - </pre> - -<p>Ensuite, pour appliquer vos modifications, effectuez un commit :</p> - -<pre class="brush: bash"> git commit -a - Répétez toutes ces étapes avec les différentes branches pour avoir une version beta/aurora/nightly.</pre> - -<p>La configuration de la compilation est à présent terminée. Toutes les étapes qui suivent devront être répétées à chaque compilation dans chacun des dossiers de branche.</p> - -<h2 id="Compilation">Compilation</h2> - -<p>La mise en place de la construction d'une (nouvelle) mise à jour est : </p> - -<pre class="brush: bash"> cd [BRANCH]/B2G/ #pour se placer dans le bon dossier - git pull # pour actualiser le code du dépôt - ./repo sync #pour actualiser le code du dépôt pour android et B2G ne pas utiliser l'option -d, le faire supprimerait vos modifications - cd gaia/locales/ && ./langs.sh && cd ../../ #pour actualiser les langues - - ./build.sh # pour construire b2g - ./build.sh gecko-update-fota # pour construire b2g et gaia dans des fichiers .zip et .mar - - BUILDID=$(grep 'BuildID=' objdir-gecko/dist/bin/application.ini | cut -d'=' -f2) # définit la variable buildid - VERSION=$(grep '\nVersion=' objdir-gecko/dist/bin/application.ini | cut -d'=' -f2) # définit la variable de la version de gecko - python tools/update-tools/build-update-xml.py -c out/target/product/[PHONE NAME]/fota-[PHONE NAME]-update.mar -O -u http://[DOMAIN]/[PHONE NAME]/[BRANCH]/fota-[PHONE NAME]-update.mar -i $BUILDID -v $VERSION -V $VERSION | tee /var/www/[BRANCH]/update.xml # Modifiez cette commande avec vos informations : chemin correct vers .mar, chemin correct vers .mar dans l'url de update.xml, la commande produira en sortie un fichier update.xml; ce dernier ira sur votre machine hôte, il correspond au fichier appelé par le système pour chercher de nouvelles mises à jour. - cp out/target/product/[PHONE NAME]/fota-[PHONE NAME]-update.mar /var/www/[BRANCH]/fota-[PHONE NAME]-update.mar #pour déplacer le .mar sur le serveur - cp out/target/product/[PHONE NAME]/fota/partial/update.zip /var/www/[BRANCH]/update.zip #pour déplacer le .zip sur le serveur - pushd /var/www/[BRANCH]/ # pour aller dans les fichiers du serveur - sha1sum $(ls) | tee sha1.checksum #pour avoir un fichier de signature - popd -</pre> - -<p>Si vous souhaitez un bot IRC, vous pouvez utiliser ii ou buildbot. J'ai réalisé un script pour ça <a href="https://github.com/dattaz/build-firefoxos/blob/master/scriptauto.sh">ICI</a> (pour plus d'informations sur ce qu'est buildbot, voir <a href="http://buildbot.net/">http://buildbot.net/</a> )</p> - -<p><strong>Flashez le téléphone et essayez votre build :</strong></p> - -<p>Pour installer la version sur un téléphone, suivez simplement ces étapes :</p> - -<pre class="brush: bash"> adb reboot recovery</pre> - -<p>Dans le recovery, descendez avec le bouton de volume bas pour sélectionner la ligne "apply update from adb", puis appuyez sur le bouton power :</p> - -<pre class="brush: bash"> adb sideload out/target/product/[PHONE NAME]/fota/partial/update.zip</pre> - -<h2 id="Builds_existantes_par_communauté">Builds existantes par communauté</h2> - -<ul> - <li>ZTE OPEN C : <a href="http://builds.firefoxos.mozfr.org">frenchmoz</a></li> - <li>ZTE OPEN & Alcatel One Touch Fire : <a href="http://firefoxosbuilds.org">communauté hispanique</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/compiler/index.html b/files/fr/archive/b2g_os/compiler/index.html deleted file mode 100644 index 7227ce6ddd..0000000000 --- a/files/fr/archive/b2g_os/compiler/index.html +++ /dev/null @@ -1,442 +0,0 @@ ---- -title: Compiler Firefox OS -slug: Archive/B2G_OS/Compiler -translation_of: Archive/B2G_OS/Building ---- -<div class="summary"> -<p>Une fois que vous <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS" title="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">avez mis en place votre système de compilation</a> puis<a href="/fr/Firefox_OS/Preparing_for_your_first_B2G_build" title="/fr/Firefox_OS/Preparing_for_your_first_B2G_build"> récupéré et configuré le code</a>, vous pouvez compiler Boot to Gecko. Ce guide détaille les étapes nécessaires à la compilation.</p> -</div> - -<h2 id="Mettre_à_jour_votre_code">Mettre à jour votre code</h2> - -<p>Si ce n'est pas la première fois que vous compilez B2G, vous pouvez récupérer la dernière version du code avant de commencer à compiler. Pour ce faire, vous devez mettre à jour les outils B2G ainsi que les dépendances grâce aux commandes suivantes :</p> - -<pre>git pull -./repo sync -d -</pre> - -<p>L'option <code>-d</code> permet de récupérer les dernières versions (HEAD) des projets Android selon le manifeste de révision (c'est-à-dire la version principale, par défaut, du dépôt). Cette option est pratique si vous avez effectué des modifications mais que vous voulez revenir à l'état de la branche <code>master</code> de façon temporaire. Vos changements seront mis de côté (staged) le répertoire de travail ne sera pas modifié (voir la <a href="http://stackoverflow.com/questions/11448864/what-is-the-usage-for-repo-sync-d-in-android-source-repository">question Stack Overflow</a> sur ce sujet ou la page de documentation sur la commande <a href="https://source.android.com/source/using-repo.html#sync">repo</a>). Si vous n'avez pas modifié les sources, vous pouvez utiliser :</p> - -<pre>git pull -./repo sync</pre> - -<p>Vous pouvez mettre à jour votre dépôt selon une cible donnée en indiquant son nom :</p> - -<pre>./repo sync gaia -</pre> - -<p>La commande <code>repo</code> possède d'autres options qui peuvent être utilisées. Utilisez la commande <code>repo help</code> pour avoir plus d'informations.</p> - -<h2 id="Compiler_Boot_to_Gecko">Compiler Boot to Gecko</h2> - -<div class="note"> -<p><strong>Note :</strong> Avant la compilation, vous pouvez utiliser un fichier <code>.userconfig</code> pour personnaliser votre version. Voir la page <a href="/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file" title="Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">Personnaliser la version grâce au fichier .userconfig </a>pour plus d'informations.</p> -</div> - -<p>Pour compiler Boot to Gecko, il suffit d'utiliser le script <code>build.sh</code> :</p> - -<pre>cd B2G -./build.sh -</pre> - -<p>À ce moment, vous pouvez sans doute prendre une autre pause café (voire une sieste si c'est votre première compilation). Pour indication, la compilation dure environ 30 minutes sur un Core i7 avec 8 Go de RAM). Comme expliqué dans la page précédente, si vous utilisez un autre répertoire dans lequel vous avez sauvegardé des fichiers système Android, vous devrez définir la variable d'environnement <code>ANDROIDFS_DIR</code> avant de lancer <code>build.sh</code>.</p> - -<div class="note"> -<p><strong>Note</strong> : Pour plus d'informations sur l'installation (<em>flashing</em>) d'une nouvelle version sur un téléphone, lire la page <a href="/fr/Firefox_OS/Installer_sur_un_telephone_mobile">Installer Firefox OS sur un appareil mobile</a>.</p> -</div> - -<h3 id="Compiler_des_modules_particuliers">Compiler des modules particuliers</h3> - -<p>Si vous souhaitez compiler uniquement un certain module, vous pouvez spécifier le nom du module souhaité comme argument du script. Ainsi, si vous souhaitez ne compiler que Gecko, vous pourrez utiliser la commande suivante :</p> - -<pre>./build.sh gecko -</pre> - -<p>Si vous souhaitez ne rafraîchir qu'une seule application, vous pouvez compiler le module <code>gaia</code> et spécifier la variable d'environnement <code>BUILD_APP_NAME</code> avec le nom de l'application :</p> - -<pre>BUILD_APP_NAME=calendar ./build.sh gaia</pre> - -<p>Afin d'obtenir une liste des modules que vous pouvez compiler, vous pouvez utiliser la commande suivante :</p> - -<pre>./build.sh modules -</pre> - -<h3 id="Définir_le_nombre_de_tâches_parallèles">Définir le nombre de tâches parallèles</h3> - -<p>Par défaut, les scripts B2G lancent des tâches parallèles (le nombre de tâches par défaut étant égal au nombre de cœurs plus (+) deux). Le nombre de tâches à lancer en parallèle est défini grâce au paramètre <code>-j</code> de <code>build.sh</code>. Cet argument peut s'avérer utile lorsque vous souhaitez réduire la charge CPU prise par la compilation pour pouvoir faire autre chose. De plus, n'avoir qu'une seule tâche pour la compilation permet d'interpréter beaucoup plus facilement les informations affichées par le script.</p> - -<p>Ainsi, pour compiler en utilisant uniquement deux tâches parallèles, vous pouvez utiliser la commande suivante :</p> - -<pre>./build.sh -j2 -</pre> - -<p>Le plus souvent, ce paramètre est utilisé pour empêcher toute exécution parallèle. De cette façon, le processus peut être analysé plus simplement. Pour n'avoir qu'une seule tâche, lancer la commande suivante :</p> - -<pre>./build.sh -j1 -</pre> - -<h3 id="Compiler_une_version_multilocales">Compiler une version multilocales</h3> - -<p>Pour compiler une version avec plusieurs locales, il faut réaliser les étapes suivantes :</p> - -<ol> - <li>Déterminer le fichier de locales à utiliser. Actuellement, ce sont les fichiers <a href="https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_dev.json"><code>locales/languages_dev.json</code></a> et <a href="https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_all.json"><code>locales/languages_all.json</code></a> qui sont utilisés comme fichiers de locales.</li> - <li>Cloner les locales adéquates depuis <a href="http://hg.mozilla.org/gaia-l10n">http://hg.mozilla.org/gaia-l10n</a> vers un répertoire. Le répertoire utilisé est <code>gaia-l10n/</code>. Vous pourriez très bien utiliser un répertoire <code>locales/</code>. Vous devrez cloner un dépôt pour chaque locale listée dans le fichier de langues.</li> - <li>Dans votre environnement définissez la variable d'environnement <code>LOCALE_BASEDIR</code> avec le chemin absolu du répertoire choisi à l'étape 2. La variable d'environnement <code>LOCALES_FILE</code> doit être définie avec le chemin absolu du répertoire utilisé à l'étape 1.</li> - <li>Vous pouvez également définir la variable d'environnement <code>GAIA_DEFAULT_LOCALE</code> si vous souhaitez définir une locale par défaut.</li> -</ol> - -<pre style="font-size: 12px;">cd gaia/locales/ -hg clone https://hg.mozilla.org/releases/gaia-l10n/v1_2/es</pre> - -<div>Définir les variables d'environnement :</div> - -<div> </div> - -<pre>export LOCALE_BASEDIR=$PWD/locales -export LOCALES_FILE=$PWD/locales/languages_dev.json -export GAIA_DEFAULT_LOCALE=fr -</pre> - -<p>Le fichier <code>languages-dev.json</code> peut être remplacé par votre propre fichier <code>mes-langues.json</code> à condition que celui-ci respecte le format suivant (où chaque entrée correspond à une locale clonée dans le répertoire des locales) <span style="line-height: 1.5;">:</span></p> - -<pre>{ - "en-US" : "English (US)", - "es" : "Español" -} -</pre> - -<div> -<p>Depuis la livraison du bug 884752 (en novembre 2013), il est possible d'utiliser la variable d'environnement GAIA_KEYBOARD_LAYOUTS pour ajouter des agencements de clavier.</p> - -<p>Voir la fiche du bug : <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=884752">https://bugzilla.mozilla.org/show_bug.cgi?id=884752</a></p> - -<p>Voir des exemples d'agencements: <a href="https://github.com/mozilla-b2g/gaia/tree/v1.2/keyboard/layouts">https://github.com/mozilla-b2g/gaia/tree/v1.2/keyboard/layouts </a></p> - -<p>Ainsi, si vous souhaitez ajouter des agencements de clavier pour l'espagnol, l'italien et l'anglais, vous pouvez définir la variable d'environnement de cette façon :</p> - -<pre> GAIA_KEYBOARD_LAYOUTS=en,es,it</pre> - -<p><span style="line-height: 1.5;">Vous pouvez alors flasher Gaia sur le téléphone. Connectez le téléphone et vérifiez que le débogage USB est activé dans l'écran Paramètres > Informations > Plus d'informations > Développeurs. Vous n'aurez pas besoin de répéter cette étape. En effet, votre version de Gaia aura le paramètre REMOTE_DEBUGGER à 1. Pour compiler une version multilocales :</span></p> - -<pre> make clean && make production LOCALES_FILE=locales/languages-own.json</pre> - -<div class="note"> -<p>Si vous souhaitez cloner et/ou mettre à jour l'ensemble des locales prises en charge pour une branche donnée, vous pouvez utiliser <a href="https://raw.githubusercontent.com/dattaz/build-firefoxos/master/langs.sh">ce script</a>.</p> -</div> - - -<h3 id="Compiler_une_version_«_engineering_build_officielle_»">Compiler une version « engineering build officielle »</h3> - -<div class="note"> -<p>If this paragraph gets outdated. Please refer to the logs of the <strong>Be </strong>job <a href="https://treeherder.mozilla.org/#/jobs?repo=mozilla-central">in Treeherder</a> to get the latest variables set.</p> -</div> - -<p>Pour compiler une version « engineering build officielle » comme <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central-flame-kk-eng/">celles publiées par Mozilla</a>, vous devez utiliser les options suivantes sur votre ligne de commande:</p> - -<pre>VARIANT=eng MOZILLA_OFFICIAL=1 B2G_SYSTEM_APPS=1 GAIA_OPTIMIZE=1 B2G_UPDATER=1 B2G_UPDATE_CHANNEL=default MOZ_TELEMETRY_REPORTING=1 MOZ_CRASHREPORTER_NO_REPORT=1 LOCALES_FILE=locales/languages_all.json GAIA_KEYBOARD_LAYOUTS=en,pt-BR,es,de,fr,pl,zh-Hans-Pinyin,zh-Hant-Zhuyin,en-Dvorak ./build.sh</pre> - -<p>Ci-dessous l'explication des paramètres:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Variable</th> - <th scope="col">Explication</th> - </tr> - </thead> - <tbody> - <tr> - <td>VARIANT=eng</td> - <td>Définition d'une version de type « engineering ». C'est aussi la valeur par défaut.</td> - </tr> - <tr> - <td>MOZILLA_OFFICIAL=1</td> - <td>Génère une version affichant le logo et <a href="https://github.com/mozilla-b2g/gaia/blob/master/shared/locales/branding/official/branding.en-US.properties">la marque</a> Firefox OS. Ne pas utiliser cette option avec des versions que vous souhaitez distribuer. Mozilla se réserve ce droit.</td> - </tr> - <tr> - <td>B2G_SYSTEM_APPS=1</td> - <td>Installe lest applications dans le dossier /system/b2g/webapps (au lieu de /data/local/webapps).</td> - </tr> - <tr> - <td>GAIA_OPTIMIZE=1</td> - <td>Concatène les sources de Gaia.</td> - </tr> - <tr> - <td>B2G_UPDATER=1</td> - <td>Active les mises à jour quotidienne.</td> - </tr> - <tr> - <td>B2G_UPDATE_CHANNEL=default</td> - <td>Le <a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Flame/Updating_your_Flame#Switch_to_nightly_update_channel">canal de mises à jour Firefox OS.</a> La valeur «default» pointe vers mozilla-central.</td> - </tr> - <tr> - <td>MOZ_TELEMETRY_REPORTING=1</td> - <td>Active la <a href="https://wiki.mozilla.org/Telemetry">Télémétrie</a> permettant de partager les données concernant l'utilisation du téléphone.</td> - </tr> - <tr> - <td>MOZ_CRASHREPORTER_NO_REPORT=1</td> - <td>Désactive l'interface <a href="https://developer.mozilla.org/fr/docs/Environment_variables_affecting_crash_reporting">Firefox Desktop lors d'un crash</a>, so the Gaia reporter only is used.</td> - </tr> - <tr> - <td>LOCALES_FILE=locales/languages_all.json</td> - <td>Défini les langues disponibles dans Gaia (l'arborescence relative part du dossier de gaia).</td> - </tr> - <tr> - <td>GAIA_KEYBOARD_LAYOUTS=en,pt-BR,es,de,fr,pl,zh-Hans-Pinyin,zh-Hant-Zhuyin,en-Dvorak</td> - <td>Défini les dispositions de clavier inclues dans Gaia.</td> - </tr> - </tbody> -</table> - -<h3 id="Générer_une_archive_système_sans_aucun_blob_binaire">Générer une archive système sans aucun blob binaire</h3> - -<p>Il est possible de générer une archive de système complet sans recourrir à un seul blob binaire, qui peut être utilisée pour convertir un appareil, fonctionnant sous Android, à Firefox OS, en s'affranchissant de l'interdiction de distribution de systèmes contenant des blobs binaires. Cette possibilité doit être développée séparément pour chaque type d'appareil, avec seulement les téléphones Flame et Z3/Z3 Compact supportés initialement.</p> - -<div class="note"> -<p><strong>Note</strong>: Nous devrions pouvoir le faire pour n'importe quel appareil pour lequel nous générons déjà des systèmes, mais il faut faire des vérifications dans chaque cas avant de pouvoir l'affirmer.</p> -</div> - -<p>Une telle archive est générée à l'aide de l'option suivante :</p> - -<pre class="bz_comment_text" id="comment_text_14">./build.sh blobfree</pre> - -<p>Ceci produit une archive zip composé de :</p> - -<ul> - <li>Un fichier .zip contenant toutes les partitions du système prêtes à être utilisée mais pas sous forme de fichier image (dossiers <code>BOOT</code>, <code>RECOVERY</code> et <code>SYSTEM</code>)</li> - <li>Un fichier <code>devices.json</code> décrivant les appareils supportés avec les propriétés adb et les variables fastboot à lire et gérées pour chacun d'eux.</li> - <li>fstab de secours, permettant le partitionnement et le mapping des images.</li> - <li><code>dt.img</code> si nécessaire.</li> - <li>Blob de mapping système, basé sur le résultat de <code>extract-files.sh</code>.</li> -</ul> - -<p>Le but de cette archive est d'être utilisée avec l'installeur d'addon B2G (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1166276" title="[meta] Getting a B2G Installer Addon">bug 1166276</a>.)</p> - -<h2 id="Erreurs_fréquentes">Erreurs fréquentes</h2> - -<h3 id="Build_failed!">"Build failed!"</h3> - -<p><span id="cke_bm_81S" style="display: none;"> </span>Si vous obtenez le message générique "Build failed" (« la compilation a échoué), vous pouvez essayer de reconnecter votre téléphone à votre ordinateur. Il peut arriver que le volume du téléphone soit démonté du système.</p> - -<div class="note"> -<p><strong>Attention, configurer et compiler B2G pour un Keon ne FONCTIONNERA PAS pour Mac.</strong> Pour cet appareil, il est nécessaire d'utiliser Linux.<span id="cke_bm_81E" style="display: none;"> </span></p> -</div> - -<h3 id="Erreurs_propres_à_Mountain_Lion">Erreurs propres à Mountain Lion</h3> - -<div> -<p>1. Si vous compilez sur OS X 10.8 <em>Mountain Lion</em> (Xcode 4.4.1 ou ultérieur) et que vous obtenez l'erreur suivante :</p> - -<pre style="font-size: 14px;">external/qemu/android/skin/trackball.c:130:25: error: 'M_PI' undeclared (first use in this function)</pre> -Éditez le fichier : <code style="font-size: 14px;">B2G/external/qemu/Makefile.android</code> et ajoutez le code suivant à la ligne 78: - -<pre style="font-size: 14px;">MY_CFLAGS += -DM_PI=3.14159265358979323846264338327950288 #/* B2G_fix: not finding M_PI constant */ -</pre> -</div> - -<div>2. Si vous utilisez Mountain Lion et que vous obtenez l'erreur suivante avec ./build.sh :</div> - -<div> -<pre>/System/Library/Frameworks/IOKit.framework/Headers/usb/USB.h:797:9: error: too many #pragma options align=reset</pre> - -<p>Remplacez les occurences de '#pragma options align=reset' par '#pragma pack()' dans le fichier /System/Library/Frameworks/IOKit.framework/Headers/usb/USB.h</p> -</div> - -<h3 id="Undefined_symbols__sqlite3_androidopt_handle_pragma_and__sqlite3_androidopt_open">Undefined symbols "_sqlite3_androidopt_handle_pragma" and "_sqlite3_androidopt_open"</h3> - -<p>Cette erreur se produit si vous compilez sur OS X 10.7 ou ultérieur avec Xcode 4.5 ou ultérieur. Pour résoudre le problème, appliquez le correctif <a href="https://groups.google.com/forum/#!msg/android-building/yAfPyUqCsiQ/7zvICk4GWjYJ">https://groups.google.com/forum/#!msg/android-building/yAfPyUqCsiQ/7zvICk4GWjYJ</a> au fichier external/sqlite/dist/Android.mk.</p> - -<h3 id="KeyedVector.h19331_error_indexOfKey_was_not_declared_in_this_scope">KeyedVector.h:193:31: error: indexOfKey was not declared in this scope</h3> - -<p>Cette erreur se produit lorsque la version de gcc utilisée est trop récente. Installez les versions gcc/g++/g++-multilib. Voir la page <a href="/fr/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file" title="Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">personnaliser la version compilée avec le fichier .userconfig</a> pour plus d'informations.</p> - -<div class="note"> -<p><strong>Note :</strong> Vous pouvez utiliser gcc 4.7.x en apportant de légères modifications. En raison des priorités de développement, les bugs liés à ces modifications ne seront pas corrigés.</p> -</div> - -<h3 id="arm-linux-androideabi-g_Internal_error_Killed_(program_cc1plus)">arm-linux-androideabi-g++: Internal error: Killed (program cc1plus)</h3> - -<p>Si vous obtenez ce message, cela signifie probablement qu'il manque de la mémoire. Assurez-vous de disposer de suffisamment de mémoire avant de lancer <code>./build.sh</code>. Si vous disposez de 4 Go, cela devrait suffire.</p> - -<h3 id="Erreur_«_...is_referenced_by_DSO_»">Erreur « ...is referenced by DSO »</h3> - -<p>Lors de la compilation de l'émulateur, si vous obtenez « /usr/bin/ld: out/host/linux-x86/obj/EXECUTABLES/triangleCM_intermediates/triangleCM: hidden symbol `_XGetRequest' in out/host/linux-x86/obj/STATIC_LIBRARIES/libSDL_intermediates/libSDL.a(SDL_x11dyn.o) is referenced by DSO ».</p> - -<p>Cela peut arriver avec certaines versions de binutils. Si vous utilisez Debian Stable, vous pouvez utiliser le linker <em>gold </em>en installant le paquet <code>binutils-gold</code>. Le linker <em>gold</em> est déjà installé avec <code>binutils</code> mais il n'est pas utilisé par défaut. <code>binutils-gold</code> permet de le passser en linker par défaut.</p> - -<h3 id="Si_vous_obtenez_des_erreurs_de_compilation_lorsque_le_système_de_compilation_exécute_les_tests">Si vous obtenez des erreurs de compilation lorsque le système de compilation exécute les tests</h3> - -<p>Certaines fois (surtout lorsque les outils de compilation et/ou le système sont mis à jour) vous pouvez obtenir certaines erreurs étranges lorsque le script effectue les tests post-compilation :</p> - -<pre>Generating permissions.sqlite... -test -d profile || mkdir -p profile -run-js-command permissions -WARNING: permission unknown:offline-app -WARNING: permission unknown:indexedDB-unlimited -build/permissions.js:122: NS_ERROR_UNEXPECTED: Component returned failure code: 0x8000ffff (NS_ERROR_UNEXPECTED) [nsIPermissionManager.add] -make[1]: *** [permissions] Error 3 -make: *** [gaia/profile.tar.gz] Error 2</pre> - -<p>Pour résoudre ce problème, supprimez le répertoire <code>gaia/xulrunner-sdk</code> avant de récupérer le code :</p> - -<pre>rm -r gaia/xulrunner-sdk -</pre> - -<p>Cette commande permettra de supprimer la version téléchargée, précompilée de <a href="/en-US/docs/XULRunner" title="/en-US/docs/XULRunner">XULRunner</a> que le système de compilation récupère automatiquement. Lors de la prochaine compilation, le système téléchargera automatiquement une nouvelle version de XULRunner.</p> - -<h3 id="Impossible_de_récupérer_platformlibcore">Impossible de récupérer platform/libcore</h3> - -<p>Si vous essayez de configurer B2G pour Nexus S (<code>./config.sh nexus-s</code>) et que vous obtenez une erreur liée à libcore, cela est dû à un problème avec le git linaro. Pour résoudre ce problèmé, récupérez le manifeste de B2G :</p> - -<pre class="brush: bash">git clone https://github.com/mozilla-b2g/b2g-manifest.git</pre> - -<p>Puis éditez le fichier <code>nexus-s.xml</code> dans ce dépôt, remplacez l'entrée pour le git linaro avec une référence à l'entrée aosp. Le résultat obtenu devrait ressembler à :</p> - -<pre class="brush: xml"><default revision="refs/tags/android-4.0.4_r1.2" - remote="aosp" - sync-j="4" /></pre> - -<p>Effectuez un commit ces modifications (<code>git commit -a</code>) puis modifiez le fichier <code>config.sh</code> dans la branche <code>master</code> du dépôt principal de B2G puis modifiez le pour pointer vers votre fichier de manifeste local (plutôt que celui de Mozilla) avec la commande suivante :</p> - -<pre class="brush: bash">GITREPO=${GITREPO:-"file:///home/path/to/my/b2g-manifest"}</pre> - -<h3 id="Erreurs_clang_lors_de_la_compilation_avec_Xcode_5_sur_OS_X">Erreurs clang lors de la compilation avec Xcode 5 sur OS X</h3> - -<p>Si vous compilez en utilisant Xcode 5 sur OS X 10.8, il est probable que vous rencontriez les erreurs suivantes :</p> - -<pre class="brush: bash">clang: error: argument unused during compilation: '-include system/core/include/arch/darwin-x86/AndroidConfig.h' -clang: error: argument unused during compilation: '-U DEBUG' -clang: error: argument unused during compilation: '-U DEBUG' -clang: error: argument unused during compilation: '-MF out/host/darwin-x86/obj/EXECUTABLES/obbtool_intermediates/Main.d' -make: *** [out/host/darwin-x86/obj/EXECUTABLES/obbtool_intermediates/Main.o] Error 1</pre> - -<p>Cela est dû à la modification du compilateur g++ dans le dossier <code>/usr/bin</code> par Xcode 5, ce qui fait planter le processus de compilation. Pour résoudre ce problème, éditer la ligne du fichier <code>build/core/combo/HOST_darwin-x86.mk:</code></p> - -<pre class="brush: bash">HOST_CXX := g++</pre> - -<p>en</p> - -<pre class="brush: bash">HOST_CXX := g++-4.7 -ifeq (,$(wildcard /usr/local/bin/g++-4.7)) - HOST_CXX := g++ -endif</pre> - -<p>Ensuite, désinstaller gcc avec brew (ici, on considère que vous avez utilisé le <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Installer_les_pr.C3.A9requis_Firefox_OS_pour_Mac">script de mise en route pour Mac OS</a>, si ce n'est pas le cas, utiliser ce script avant de continuer) :</p> - -<pre class="brush: bash">brew uninstall gcc-4.7</pre> - -<p>Puis réinstaller gcc avec le support multilib et c++ :</p> - -<pre class="brush: bash">brew install --enable-cxx https://gist.github.com/artlogic/6988658/raw/aeb9d1ea098274ad3f3fe2637b9df7f308a8a120/gcc-4.7.rb</pre> - -<p>Assurez vous que /usr/local/bin soit bien dans votre PATH. Vous pouvez l'ajouter temporairement à votre PATH grâce à la ligne suivante :</p> - -<pre class="brush: bash">export PATH=/usr/local/bin:$PATH</pre> - -<p>Pour rendre cette modification permanente, vous pouvez ajouter cette ligne dans le fichier <code>.bash_profile</code> de votre répertoire home.</p> - -<p>Une fois que vous avez bien défini votre PATH, assurez-vous de pouvoir lancer chacune d eces commandes :</p> - -<pre class="brush: bash">gcc-4.7 -v - -g++-4.7 -v</pre> - -<p>Si l'une de ces commandes échoue, il faudra peut-être lier de nouveau GCC à brew grâce à la commande suivante :</p> - -<pre class="brush: bash">brew link --overwrite gcc-4.7</pre> - -<p>Il se peut également que <code>/usr/bin/c++</code> ne pointe pas vers clang++ alors que ça devrait être le cas avec Xcode 5 installé. Vous pouvez le vérifier en tapant la commande suivante :</p> - -<pre class="brush: bash">ls -l /usr/bin/c++</pre> - -<p>Le résultat de cette commande devrait ressembler à :</p> - -<pre class="brush: bash">lrwxr-xr-x 1 root admin 7 Sep 19 11:40 /usr/bin/c++ -> clang++ -</pre> - -<p>Si c++ pointe vers autre chose que vers clang++, il faut mettre à jour avec le lien :</p> - -<pre class="brush: bash">sudo rm /usr/bin/c++ - -sudo ln -s /usr/bin/clang++ /usr/bin/c++</pre> - -<h3 id="systemcoreincludeloglog.h3820_error_stdarg.h_No_such_file_or_directory">"system/core/include/log/log.h:38:20: error: stdarg.h: No such file or directory"</h3> - -<p>Cette erreur peut se produire si vous utilisez 10.6 SDK pour compiler sur Mac OSX 10.10, ou tout autre configuration SDK qui n'est pas supportée par la cible que vous essayer de compiler. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1071266" title="FIXED: [flame] XCode 6 only provides 10.9 SDK causing flame builds to fail">bug 1071266</a> pour plus de détails.</p> - -<h3 id="Impossible_de_récupérer_les_fichiers_depuis_le_répertoire_de_sauvegarde">Impossible de récupérer les fichiers depuis le répertoire de sauvegarde</h3> - -<p>Cela peut arriver lorsque la connexion USB a été interrompue lors de la récupération des données de l'appareil vers l'ordinateur.</p> - -<p>Lorsque vous lancez le script, vous obtenez un résultat semblable à celui-là (obtenu pour un Peak) :</p> - -<pre class="brush: bash"><code>Pulling files from ../../../backup-peak -cat: ../../../backup-peak/system/build.prop: No such file or directory -Found firmware with build ID -Pulling "libaudioeq.so" -cp: cannot stat `../../../backup-peak/system/lib/libaudioeq.so': No such file or directory -Failed to pull libaudioeq.so. Giving up. - -> Build failed! < - -Build with |./build.sh -j1| for better messages -If all else fails, use |rm -rf objdir-gecko| to clobber gecko and |rm -rf out| to clobber everything else.</code></pre> - -<p>Pour résoudre ce problème, il n'est pas nécessaire de supprimer les répertoires <code>objdir-gecko</code> et <code>out</code> dans leur intégralité. Il suffit de supprimer le répertoire de sauvegarde avec cette commande) :</p> - -<pre class="brush: bash"><code class="brush: bash">$rm -rf backup-peak</code></pre> - -<h3 id="Problèmes_de_compilation_pour_l'émulateur"><strong>Problèmes de compilation pour l'émulateur</strong></h3> - -<p>Si vous construisez une version d'un <strong>émulateur</strong>, vous pourrez rencontrer certains problèmes. Les informations détaillées ici permettent d'en résoudre certains.</p> - -<div class="note"> -<p><strong>Attention : l'émulateur x86 est plus difficile à installer et n'est pas très bien supporté.</strong></p> -</div> - -<p>Le système de compilation d'un émulateur construit à la fois la version 32 bits et la version 64 bits de l'émulateur. L'émulateur aura besoin d'utiliser OpenGL, cela signifie qu'il vous faudra avoir installé les bibliothèques 32 bits et 64 bits pour OpenGL. Voir la discussion à ce sujet sur le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=897727" title="https://bugzilla.mozilla.org/show_bug.cgi?id=897727">bug 897727</a>.</p> - -<p>Deux méthodes permettent de résoudre ce problème :</p> - -<h4 id="Première_solution_avoir_installé_les_deux_bibliothèques_OpenGL_32_bits_et_64_bits_et_avoir_construit_les_liens_symboliques_(symlinks)">Première solution : avoir installé les deux bibliothèques OpenGL 32 bits et 64 bits et avoir construit les liens symboliques (<em>symlinks</em>)</h4> - -<p>Si votre distribution Linux dispose de paquets multilib pour les bibliothèques OpenGL, vous pouvez les installer manuellement. Il vous faudra peut être ajouter manuellement certains liens symboliques.</p> - -<p>Par exemple, sur Ubuntu 12.04 LTS x86-64, le paquet <code>libgl1-mesa-dev</code> ne peut pas être installé simultanément pour les versions x86-64 et i386 mais la combinaison de paquets suivante peut être installée :</p> - -<pre class="bz_comment_text" id="comment_text_12">sudo apt-get install libgl1-mesa-dev libglapi-mesa:i386 libgl1-mesa-glx:i386</pre> - -<p>Une fois avoir lancé la commande précédente, il vous faudra créer quelques liens symboliques pour que la compilation puisse fonctionner :</p> - -<pre class="note">sudo ln -s /usr/lib/i386-linux-gnu/libX11.so.6 /usr/lib/i386-linux-gnu/libX11.so -sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so</pre> - -<h4 id="Seconde_solution_corriger_le_dépôt_pour_que_l'émulateur_ne_soit_compilé_qu'en_64_bits">Seconde solution : corriger le dépôt pour que l'émulateur ne soit compilé qu'en 64 bits</h4> - -<p>Il suffit d'appliquer <a href="https://bug897727.bugzilla.mozilla.org/attachment.cgi?id=786280" title="https://bug897727.bugzilla.mozilla.org/attachment.cgi?id=786280">ce correctif</a> au dépôt git sdk/ situé sous le dépôt B2G. L'émulateur B2G ne sera ainsi compilé qu'en une version 64 bits, ce qui permettra d'éviter tout problème e gestion des bibliothèques pour différentes architectures. Dans tous les cas, l'émulateur 32 bits ne sera pas utilisé sur un système 64 bits. Cette solution est la plus simple à mettre en œuvre (sauf si le patch devient un jour corrompu...).</p> - -<h2 id="Prochaines_étapes">Prochaines étapes</h2> - -<p>Une fois la compilation achevée, la suite dépendra de votre cible : un appareil mobile « réel » ou un émulateur. Pour obtenir les informations pertinentes, vous pouvez lire les articles suivants :</p> - -<ul> - <li><a href="/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="Mozilla/Firefox_OS/Using_the_B2G_emulators">Utiliser les émulateurs B2G</a></li> - <li><a href="/fr/Firefox_OS/Building_the_B2G_desktop_client" title="Mozilla/Firefox_OS/Using_the_B2G_desktop_client">Utiliser le client B2G pour ordinateur</a></li> - <li><a href="/fr/Firefox_OS/Installer_sur_un_telephone_mobile" title="Mozilla/Firefox_OS/Installing_on_a_mobile_device">Installer Boot to Gecko sur un appareil mobile</a></li> - <li><a href="/docs/Mozilla/Firefox_OS/Pandaboard" title="Mozilla/Firefox_OS/Pandaboard">Installer Boot to Gecko sur une PandaBoard</a></li> -</ul> -</div> - -<h3 id="Soumettre_des_bugs_sur_B2GFirefox_OSGaia">Soumettre des bugs sur B2G/Firefox OS/Gaia</h3> - -<p>Une fois que votre version de B2G/Firefox OS fonctionne, vous serez en mesure de rapporter des bogues et d'aider à l'amélioration de Firefox OS. Si vous trouvez un bug<a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20OS">, vous pouvez le décrire sur Bugzilla</a>, grâce au projet "Firefox OS" en spécifiant bien les éléments de version :</p> - -<ol> - <li>Pour commencer, indiquez le numéro de version <em>majeur</em>, par exemple <em>1.4.0.0-prerelease</em>. Cette information se trouve dans <em>Paramètres > Informations</em>.</li> - <li>Vous pouvez fournir des identifiants de versions plus spécifiques en indiquant les hash correspondant aux dépôt gaia et gecko. Pour obtenir ces informations, vous pouvez utiliser les commanes suivantes : - <pre class="brush: bash">#!/bin/bash -(cd gaia; echo "gaia $(git rev-parse HEAD)") -(cd gecko; echo "gecko $(git rev-parse HEAD)")</pre> - </li> -</ol> diff --git a/files/fr/archive/b2g_os/customisation_avec_le_fichier_.userconfig/index.html b/files/fr/archive/b2g_os/customisation_avec_le_fichier_.userconfig/index.html deleted file mode 100644 index b9a23a766d..0000000000 --- a/files/fr/archive/b2g_os/customisation_avec_le_fichier_.userconfig/index.html +++ /dev/null @@ -1,201 +0,0 @@ ---- -title: Customisation avec le fichier .userconfig -slug: Archive/B2G_OS/Customisation_avec_le_fichier_.userconfig -translation_of: Archive/B2G_OS/Customization_with_the_.userconfig_file ---- -<div class="summary"> -<p>Vous pouvez customiser certains aspects du processus de construction en ajoutant un peu de code dans votre source B2G, dans le fichier <code>.userconfig. </code> Cet article montre ce que l'on peut faire en effectuant ces changements et comment on les réalise.</p> -</div> - -<p>Le fichier <code>.userconfig</code> n'est pas vérifié dans le contrôle du code source, donc vos changements ne seront pas effacés quand vous mettrez a jour votre arbre source. Il a besoin d'être créé dans la <a href="https://github.com/mozilla-b2g/B2G"> base de l'arbre du B2G</a>; qui est dans le même dossier que <code>flash.sh</code>, <code>build.sh</code>, etc... Vous devriez ajouter ceci avant de lancer votre config et de construire vos étapes.</p> - -<p>Le fichier <code>.userconfig</code>, s'il existe, est créé de source par le script <code>load-config.sh</code> qui est lui même créé de source par ces scripts : <code>flash.sh</code>, <code>build.sh</code> (Par <code>setup.sh</code>), <code>run-gdb.sh</code>, <code>run-emulator.sh</code> et <code>tools/mach_b2g_bootstrap.py</code>. Le script <code>run-<em>*</em>.sh</code> l'utilise pour déterminer où vous devez avoir Gecko. Le script <code>mach_b2g_boostrap.py</code> est utilisé par toutes commandes <a href="/en-US/docs/Developer_Guide/mach">mach</a> en rapport avec le B2G.</p> - -<div class="warning"> -<p><strong>Important :</strong> votre fichier <code>.userconfig</code> devrait être à la racine de votre répertoire source de B2G, non pas dans votre répertoire /home !</p> -</div> - -<h2 id="Changer_l'arbre_source_de_Gecko">Changer l'arbre source de Gecko</h2> - -<p>Par defaut, la construction utilise l'arbre source de gecko, qui est cloné d'un autre arbre de source depuis Github. Certaines personnes préfèrent utiliser <a href="https://developer.mozilla.org/en-US/docs/Developer_Guide/Source_Code/Mercurial#mozilla-inbound_%28used_for_landing_your_patches%29" title="https://developer.mozilla.org/en-US/docs/Developer_Guide/Source_Code/Mercurial#mozilla-inbound_%28used_for_landing_your_patches%29">mozilla-inbound</a>, ou <a href="https://developer.mozilla.org/en-US/docs/Developer_Guide/Source_Code/Mercurial#mozilla-central_%28main_development_tree%29" title="https://developer.mozilla.org/en-US/docs/Developer_Guide/Source_Code/Mercurial#mozilla-central_%28main_development_tree%29">mozilla-central</a>. Pour faire ceci, créez votre clone là où vous le désirez et ajoutez une ligne dans votre <code>.userconfig</code> qui met en place <code>GECKO_PATH</code>, par exemple :</p> - -<pre>export B2G_DIR=${B2G_DIR:-$(cd $(dirname $0); pwd)} -echo "B2G_DIR = ${B2G_DIR}" - -export GECKO_PATH=${B2G_DIR}/mozilla-inbound -echo "GECKO_PATH = ${GECKO_PATH}" -</pre> - -<div class="note"> -<p><strong>Note </strong>: si vous construisez avec un Gecko modifié sue Mac OS X, le dossier <code>mozilla-central</code> doit être dans un fichier système sensible à la casse sinon <code>GECKO_PATH</code> sera ignoré. Vous pouvez vérifier si le fichier système est sensible au majuscules en lançant cette ligne de commande dans un terminal :</p> - -<pre>echo -n This file system is case->tmp; echo -n in>>TMP; echo sensitive>>tmp; cat tmp</pre> - -<p>Récupérer <code>B2G_DIR</code> comme fait ci-dessus permet à votre <code>.userconfig</code> de fonctionner sans avoir des chemins d'accès compliqués.</p> -</div> - -<h2 id="Changer_les_paramètres_de_Gaia">Changer les paramètres de Gaia</h2> - -<p>Parfois, vous aimeriez pouvoir changer les paramètres de Gaia. Par exemple, autoriser adb dans une construction utilisateur.</p> - -<p><strong><!-- cette partie reste à traduire </strong></p> - -<p><strong>The gaia Makefile passes in <code>--override build/custom-settings.json</code> when calling <code>build/settings.py</code>, so we can write some bash which will write <code>{"devtools.debugger.remote-enabled": true}</code> into the <code>custom-settings.json</code> file. We try to avoid changing <code>custom-settings.json</code> if we don't need to, so we actually write into <code>custom-settings.json.new</code> and if the contents differ from <code>custom-settings.json</code> then we'll replace it.</strong></p> - -<p><strong>--></strong></p> - -<pre>export GAIA_PATH=${GAIA_PATH:-$(cd gaia; pwd)} -export CUSTOM_SETTINGS="${GAIA_PATH}/build/config/custom-settings.json" -cat > "${CUSTOM_SETTINGS}.new" <<EOF -{"devtools.debugger.remote-enabled": true} -EOF -if [[ -f ${CUSTOM_SETTINGS} ]] && cmp "${CUSTOM_SETTINGS}" "${CUSTOM_SETTINGS}.new" >& /dev/null; then - rm "${CUSTOM_SETTINGS}.new" -else - mv "${CUSTOM_SETTINGS}.new" "${CUSTOM_SETTINGS}" -fi -</pre> - -<p>Une autre façon plus simple de configurer<code> consiste à utiliser le fichier build/config/custom-prefs.js</code> présent dans le répertoire de Gaia, c'est-à-dire dans <code>gaia/build/config/custom-prefs.js</code> si vous êtes dans le répertoire B2G. Voir aussi <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer#Customizing_the_preferences" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer#Customizing_the_preferences">Personnaliser les réglages utilisateurs Gaia</a>.</p> - -<div class="note"> -<p><strong>Note:</strong> Currently the build is not smart enough to look in a different directory based on <code>GAIA_PATH</code>. This is different from how <code>GECKO_PATH</code> behaves. If you wish to use a separate Gaia clone you can <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Build_System_Primer">manually run make</a> from that directory.</p> -</div> - -<h2 id="Créer_des_modèles_de_builds">Créer des modèles de builds</h2> - -<p>Vous pouvez créer plusieurs types de compilations automotiques de Gaia avec la commande <code>make </code>en pramaétrant le fichier <code>.userconfig</code> - cette section dénombre quelques options.</p> - -<div class="note"> -<p><strong>Note</strong>: You can also set many different build options dynamically at build time by including different options along with the make command when you build. For a complete reference, see our <a href="/en-US/Firefox_OS/Developing_Gaia/make_options_reference">make options reference</a> article.</p> -</div> - -<h3 id="Creating_production_and_engineering_builds">Creating production and engineering builds</h3> - -<p>To create different production builds (built with the final apps you'd want users to see) and engineering builds (built with additional test apps and other engineering features), you can add the following lines into <code>.userconfig</code>:</p> - -<pre class="brush: bash">PRODUCTION=1</pre> - -<p class="p1">On its own, this creates a production build. This can also be achieved on the fly by setting the <code>production</code> make option.</p> - -<p class="p1">Alternatively, there are variants, which set various levels of engineering capabilities:</p> - -<pre class="p1">VARIANT=user - -VARIANT=userdebug - -VARIANT=eng</pre> - -<p class="p1">The differences between these variants are as follows:</p> - -<ul> - <li class="p1">The <strong>eng</strong> variant places the default apps in <code>/data</code> and includes many more apps than user/userdebug, for testing purposes. It also has Marionette enabled by default so you can run tests. This is the default value if no variant is specified.</li> - <li class="p1">The <strong>userdebug</strong> variant puts apps in <code>/system</code>, has Marionette enabled by default so you can run tests, and has the updater enabled, so you can get over-the-air (OTA/FOTA) updates.</li> - <li class="p1">The <strong>user</strong> variant places the default apps in <code>/system</code> and has the updater enabled, so you can get over-the-air (OTA/FOTA) updates.</li> -</ul> - -<div class="note"> -<p class="p1"><strong>Note</strong>: Les deux valeurs <code>user </code>et <code>userdebug </code>impliquent <code>PRODUCTION=1</code> quand la compilation est faite pour un terminal ou un émulateur.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: <code style="font-style: normal;">make production</code> is really a way to build a user version of Gaia and flash it to the device. Specifying a <code style="font-style: normal;">VARIANT</code> is the way to do this when building for Gaia in Nightly or B2G Desktop.</p> -</div> - -<h3 id="Creating_a_debug_build">Creating a debug build</h3> - -<p>To build a debug build, put the following line in your <code>.userconfig</code> file:</p> - -<pre>export B2G_DEBUG=1</pre> - -<p>This can be achieved on the fly at build time by including the <span style="line-height: 1.5;"><code>DEBUG=1</code> make option.</span></p> - -<h3 id="Creating_a_profiling_build">Creating a profiling build</h3> - -<p>To enable profiling (for best results with the built-in (SPS) platform profiler), add the following to your <code>.userconfig</code> file then rebuild:</p> - -<pre>export MOZ_PROFILING=1</pre> - -<div class="warning"> -<p><strong>Important</strong>: Do NOT pair with B2G_NOOPT. The results will be meaningless!</p> -</div> - -<h3 id="Disabling_the_optimizer">Disabling the optimizer</h3> - -<p>To disable the optimizer (which may create builds that are easier to debug), add the following to your <code>.userconfig</code> file then rebuild:</p> - -<pre>export B2G_NOOPT=1</pre> - -<h3 id="Disabling_First_Time_User_experience">Disabling First Time User experience</h3> - -<p>If you build and reflash a lot, going through the First Time User experience constantly can be annoying. You can disable this by adding the following to your <code>.userconfig</code>:</p> - -<pre>export NOFTU=1</pre> - -<p>This can be achieved on the fly at build time by including the <code>NOFTU=1</code> make option.</p> - -<h2 id="Enabling_Gaia_developer_mode">Enabling Gaia developer mode</h2> - -<p>If you plan to develop apps or hack gaia, you can automatically set various usefull settings and preferences to ease working with the device. For example, it will automatically enable the remote debugging feature and disable the prompt when an incoming debugging connection starts.</p> - -<p>What you need is the following export added to your .userconfig:</p> - -<pre>export DEVICE_DEBUG=1</pre> - -<h2 id="Enabling_Valgrind">Enabling Valgrind</h2> - -<p>Valgrind is useful for debugging memory or threading issues with your application. For more information on running valgrind, see <a href="/en-US/Firefox_OS/Debugging/Debugging_B2G_using_valgrind">Debugging B2G using valgrind [en-US]</a>.</p> - -<p>To use valgrind under B2G, add the following to your .userconfig:</p> - -<pre>export B2G_VALGRIND=1</pre> - -<h2 id="Changing_the_default_host_compiler">Changing the default host compiler</h2> - -<p>On some recent distributions which use GCC 4.7 or later as the default compiler you will need to specify an older version in order to be able to build, to do so add two lines to your <code>.userconfig</code> file setting the <code>CC</code> and <code>CXX</code> variables to set the alternate C and C++ compilers respectively. For example to set the GCC 4.6 compiler on Ubuntu 12.10 use:</p> - -<pre>export CC=gcc-4.6 -export CXX=g++-4.6 -</pre> - -<p>Or if you're using a version built from sources provide the full path to the exectuables:</p> - -<pre>export CC=/opt/gcc-4.6.4/bin/gcc -export CXX=/opt/gcc-4.6.4/bin/g++ -</pre> - -<h2 id="Specifying_a_custom_Gecko_object_tree_location">Specifying a custom Gecko object tree location</h2> - -<p>Once you start changing gecko source trees and other build options, you may want to also modify where your objects get stored (so, for example, all of your debug objects go into a different tree from your non-debug objects). So you might do something like:</p> - -<pre>export GECKO_OBJDIR=${GECKO_PATH}/objdir-gonk-debug -</pre> - -<p>Using <code>${GECKO_PATH}</code> makes it easy to switch between different gecko trees (eg: central, beta, aurora, etc).</p> - -<h2 id="Keeping_both_debug_and_non-debug_objects">Keeping both debug and non-debug objects</h2> - -<p>You can use your <code>.userconfig</code> file to switch back and forth between debug and release builds without having to rebuild everything each time!</p> - -<dl> -</dl> - -<pre class="brush:bash;">export B2G_DIR=${B2G_DIR:-$(cd $(dirname $0); pwd)} -echo "B2G_DIR = ${B2G_DIR}" - -export GECKO_PATH=${B2G_DIR}/mozilla-inbound -echo "GECKO_PATH = ${GECKO_PATH}" - -export B2G_DEBUG=1 -echo "B2G_DEBUG = ${B2G_DEBUG}" - -export GECKO_OBJDIR=${GECKO_PATH}/objdir-gonk -if [[ "${B2G_DEBUG}" != "0" ]]; then - export GECKO_OBJDIR=${GECKO_OBJDIR}-debug -fi -if [[ "${GECKO_PATH/*mozilla-inbound*/mozilla-inbound}" == "mozilla-inbound" ]]; then - export GECKO_OBJDIR=${GECKO_OBJDIR}-m-i -fi -echo "GECKO_OBJDIR = ${GECKO_OBJDIR}"</pre> - -<p>The <code>echo</code> commands help remind you what your current settings are. To switch between debug and release builds, simply change the value of <code>B2G_DEBUG</code> on line 7.</p> diff --git a/files/fr/archive/b2g_os/debugging/connecting_a_firefox_os_device_to_the_desktop/index.html b/files/fr/archive/b2g_os/debugging/connecting_a_firefox_os_device_to_the_desktop/index.html deleted file mode 100644 index f96309e2ec..0000000000 --- a/files/fr/archive/b2g_os/debugging/connecting_a_firefox_os_device_to_the_desktop/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Connexion d'un appareil Firefox OS à un ordinateur -slug: Archive/B2G_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop -tags: - - ADB - - Firefox OS -translation_of: Archive/B2G_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop ---- -<div class="summary"> -<p><span class="seoSummary">Ce guide explique comment connecter un appareil Firefox OS à votre ordinateur en USB.</span></p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Si vous souhaitez seulement déboguer des applications sur un appareil Firefox OS et que vous avez Firefox OS 1.2+, le meilleur choix consiste à utiliser <a href="/en-US/docs/Tools/WebIDE">WebIDE</a>. Si votre version de Firefox OS est inférieure à 1.2, lisez <a href="/fr/Firefox_OS/Déboguer/Étapes_préparatoires">Préparations pour déboguer sur Firefox OS avec les outils pour Développeur Web de Firefox</a> pour découvrir comment utiliser le débogage distant classique.</p> -</div> - -<h2 id="Configuration_de_l'appareil">Configuration de l'appareil</h2> - -<p>Sur votre appareil Firefox OS (<a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">voir la présentation</a>) :</p> - -<ol> - <li>Ouvrez l'application Paramètres, puis <code>Informations sur l'appareil</code> > <code>Plus d'informations</code> > <code>Développeurs</code>.</li> - <li>Dans le menu développeurs, cochez "Débogage distant".</li> -</ol> - -<h2 id="Configuration_de_l'ordinateur">Configuration de l'ordinateur</h2> - -<p>Pour connecter un appareil à l'ordinateur, vous devez installer <a class="external" href="http://developer.android.com/tools/help/adb.html" title="http://developer.android.com/tools/help/adb.html">Android Debug Bridge (adb)</a>. Remarquez que l'extension ADB Helper (pour utiliser avec <a href="/en-US/docs/Tools/WebIDE">WebIDE</a>) intègre déjà adb.</p> - -<p>Les instructions pour configurer votre ordinateur sont spécifiques à votre système d'exploitation et sont détaillées au point 3 de <a class="external" href="https://developer.android.com/tools/device.html" title="https://developer.android.com/tools/device.html">"Setting up a Device for Development"</a> sur le site de développement d'Android. Des instructions supplémentaires sont énumérées ci-dessous.</p> - -<h3 id="Instructions_spécifiques_à_Mac_OS_X">Instructions spécifiques à Mac OS X</h3> - -<p>Si vous êtes sous Mac OS X, vous avez téléchargé un paquet dont le nom ressemble à <code>adt-bundle-mac-x86_64-20130522</code>. Placez-le dans le dossier Applications afin d'avoir deux répertoires dans <code>/Applications/adt-bundle-mac-x86_64-20130522/</code> : <code>eclipse</code> et <code>sdk</code>. Éditez ensuite votre <code>~/.bashrc</code> et ajoutez</p> - -<pre>export PATH="/Applications/adt-bundle-mac-x86_64-20130522/sdk/platform-tools:$PATH"</pre> - -<p>(Cela sera pris en compte la prochaine fois que vous démarrerez votre shell). À l'invite du shell, vous pouvez maintenant taper :</p> - -<pre>adb devices -</pre> - -<p>Cela affichera une liste des périphériques connectés de ce genre :</p> - -<pre>List of devices attached -AA:BB:A5:B5:AA:BB device</pre> - -<h3 id="Instructions_spécifiques_à_Linux">Instructions spécifiques à Linux</h3> - -<p>Si vous êtes sous Linux, l'ID (identifiant) vendeur à utiliser pour les appareils Geeksphone Firefox OS est <code>05c6</code>, votre fichier <code>/etc/udev/rules.d/51-android.rules</code> doit donc contenir une entrée semblable à :</p> - -<pre class="bash" style="font-family: monospace;"><span style="color: #007800;">SUBSYSTEM</span>=="usb", ATTR<strong style="color: #7a0874; font-weight: bold;">{</strong>idVendor<strong style="color: #7a0874; font-weight: bold;">}</strong>=="05c6", <span style="color: #007800;">MODE</span>="0666", <span style="color: #007800;">GROUP</span>="plugdev"</pre> - -<h3 id="Instructions_spécifiques_à_Windows">Instructions spécifiques à Windows</h3> - -<p>Vous pouvez télécharger les pilotes Windows du Geeksphone sur le <a href="http://www.geeksphone.com/downloads/fos/fos_usb_driver.zip" title="http://www.geeksphone.com/downloads/fos/fos_usb_driver.zip">site web de Geeksphone</a>.</p> - -<p>Par défaut, Windows 8 ne permet pas l'installation de pilotes non signés. Consultez le tutoriel <a href="http://www.craftedge.com/tutorials/driver_install_windows8/driver_install_win8.html" title="http://www.craftedge.com/tutorials/driver_install_windows8/driver_install_win8.html">"Comment installer un pilote non signé sous Windows 8"</a>.</p> - -<p>Comme Windows XP Édition familiale ne comporte pas <code>tasklist.exe</code>, le Simulateur ne détecte pas le périphérique. Cela peut être résolu en téléchargeant ce fichier depuis <a href="http://www.computerhope.com/download/winxp.htm">le site web ComputerHope</a> et en le plaçant dans le dossier <code>Windows\System32</code>.</p> - -<h2 id="Vérification_de_votre_configuration">Vérification de votre configuration</h2> - -<p>Après avoir suivi ces instructions, branchez l'appareil sur l'ordinateur avec un câble USB, ouvrez un interpréteur de commandes et tapez "<code>adb devices</code>" (assurez-vous que adb est dans votre path). Votre appareil Firefox OS devrait apparaître dans le résultat de la commande.</p> diff --git a/files/fr/archive/b2g_os/debugging/index.html b/files/fr/archive/b2g_os/debugging/index.html deleted file mode 100644 index 18edc0b003..0000000000 --- a/files/fr/archive/b2g_os/debugging/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Déboguer sur Firefox OS -slug: Archive/B2G_OS/Debugging -tags: - - AQ - - B2G - - Déboguer - - Firefox OS - - Tester -translation_of: Archive/B2G_OS/Debugging ---- -<p>Vous pouvez réaliser trois types de débogage sur Firefox OS.</p> - -<ul> - <li>Vous pouvez faire un débogage haut-niveau en lançant Gaia (ainsi que de nombreuses applications web compatibles avec B2G) dans Firefox 15 ou plus récent sur ordinateur. Ceci vous permet d'utiliser les excellents outils pour développeur disponibles dans Firefox pour vous aider à déboguer l'interface utilisateur de Gaia, tout comme votre application web.</li> - <li>Vous pouvez utiliser l'application dédié B2G pour ordinateur.</li> - <li>Ou vous pouvez faire tourner Firefox OS sur votre appareil mobile ou un simulateur sous le contrôle du débogueur gdb. Et il y a des outils pour vous aider à faire tourner le client B2G sur ordinateur.</li> -</ul> - -<p>Cette page fournit les liens vers les informations utiles sur les différents moyens de déboguer votre code Firefox OS.</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentaaction" name="Documentaaction">Documentation à propos du débogage sur Firefox OS</h2> - - <dl> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/deboguer_applications_firefox_os_dans_firefox_ordinateur" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Debugging_Firefox_OS_apps_in_desktop_Firefox">Déboguer des applications Firefox OS dans Firefox pour ordinateur</a></dt> - <dd>Vous pouvez utiliser Firefox sur ordinateur pour déboguer une bonne partie des applications web. Cet article fournit un guide des fonctionnalités de Firefox utiles dans ce genre de situation.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/preparations" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Setting_up">Préparations pour déboguer du code Firefox OS</a></dt> - <dd>Avant de pouvoir utiliser la plupart des outils intégrés à Firefox pour déboguer du code s'exécutant sur Firefox OS, vous devez faire un peu de configuration. Cet article vous explique ce qu'il faut faire.</dd> - <dt><a href="/en-US/docs/Tools/Debugger" title="/en-US/docs/Tools/Debugger">Utiliser le débogueur</a></dt> - <dd>Vous pouvez utiliser le débogueur distant de Firefox pour déboguer du code s’exécutant dans Firefox OS sur un appareil avec une connexion partagée (<em>tethered</em>), ou dans le simulateur Firefox OS.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/journalisation_console_sur_appareil" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/On-device_console_logging">Journalisation console sur l'appareil</a></dt> - <dd>Comment activer la journalisation (<em>log</em>) console sur un appareil Firefox OS, et comment accéder aux journaux créés sur l'appareil pour les analyser sur ordinateur.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/utiliser_console_web_distante" title="/en-US/docs/Mozilla/Boot_to_Gecko/Debugging_on_Boot_to_Gecko/Using_the_Remote_Web_Console_with_Firefox_OS">Utiliser la Console Web distante avec Firefox OS</a></dt> - <dd>La Console Web distante inclue dans Firefox vous permet de surveiller la sortie console d'un appareil Firefox OS.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/parametres_developpeurs" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Developer_settings">Paramètres pour développeurs sur les appareils Firefox OS</a></dt> - <dd>Il y a plusieurs paramètres à destination des développeurs sur Firefox OS. Ce guide explique ce qu'ils font et comment en tirer partis.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Debugging/Debugging_B2G_using_gdb" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Debugging_B2G_using_gdb">Déboguer B2G en utilisant gdb</a></dt> - <dd>Le débogueur populaire gdb peut être utilisé pour déboguer Firefox OS et les applications tournant soit sur un appareil, soit sur un émulateur. Ce guide vous montre comme faire.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/deboguer_avec_client_ordinateur_b2g" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Debugging_using_the_desktop_B2G_client">Déboguer en utilisant le client ordinateur B2G</a></dt> - <dd>Des fonctionnalités accessibles sur le client ordinateur B2G peuvent aider dans le débogage de vos applications. Découvrez-les dans cet article.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Debugging/General_B2G_debugging_tips" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/General_B2G_debugging_tips">Conseils généraux pour déboguer B2G</a></dt> - <dd>Des conseils généraux qui peuvent s'appliquer à tout débogage sur B2G que vous pourriez réaliser.</dd> - <dt><a href="/fr/docs/Mozilla/Firefox_OS/deboguer/personnaliser_script_b2g.sh" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Customizing_the_b2g.sh_script">Personnaliser le script <code>b2g.sh</code></a></dt> - <dd>Vous pouvez personnaliser le script <code>b2g.sh </code>pour ajuster les variables d'environnement et ainsi changer le comportement de Gecko.</dd> - <dt><a href="/en-US/docs/Mozilla/Debugging/HTTP_logging#Firefox_OS_phones" title="/en-US/docs/Mozilla/Debugging/HTTP_logging#Firefox_OS_phones">Obtenir des journaux NSPR dans B2G</a></dt> - <dd>Vous pouvez utiliser les journaux (<em>logs</em>) NSPR pour enregistrer HTTP et autre trafic réseaux.</dd> - <dt><a href="/en-US/docs/Mozilla/Debugging/HTTP_logging" title="/en-US/docs/Mozilla/Debugging/HTTP_logging">Journalisation HTTP</a></dt> - <dd>Comment journaliser (log) votre trafic réseau HTTP pour déboguer.</dd> - </dl> - - <p><span class="alllinks"><a href="/fr/docs/tag/B2G" title="/en-US/docs/tag/B2G">Voir tout...</a></span></p> - </td> - <td> - <h2 class="Community" id="Community" name="Community">Obtenir de l'aide de la communautré</h2> - - <p>Si vous travaillez avec Firefox OS ou développez des applications que vous aimeriez voir fonctionner sur des appareils Firefox OS, des ressources communautaires sont à votre disposition !</p> - - <ul> - <li>Consultez le forum du projet Boot to Gecko : <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-b2g"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.b2g"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.b2g/feeds"> Flux de syndication</a></li> -</ul></li> - <li>Posez votre question sur le canal IRC de Mozilla : <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a></li> - </ul> - - <p><span class="alllinks"><a class="external" href="http://www.gnurou.org/writing/smartquestionsfr" title="http://www.gnurou.org/writing/smartquestionsfr">N'oubliez pas la <em>netiquette</em></a> pour poser vos questions…</span></p> - </td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/fr/archive/b2g_os/debugging/installer_adb/index.html b/files/fr/archive/b2g_os/debugging/installer_adb/index.html deleted file mode 100644 index 24ed61578e..0000000000 --- a/files/fr/archive/b2g_os/debugging/installer_adb/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: Installer et utiliser ADB -slug: Archive/B2G_OS/Debugging/Installer_ADB -translation_of: Archive/B2G_OS/Debugging/Installing_ADB ---- -<div class="summary"> -<p><span id="result_box" lang="fr"><span class="hps">De nombreux</span> <span class="hps">aspects du développement</span> <span class="hps">de Firefox</span> <span class="hps">OS</span> <span class="hps">nécessitent l'installation</span> <span class="hps">d'ADB</span><span>, </span>(<span class="hps">Android</span> <span class="hps">Debug</span><span> Bridge).</span> <span class="hps">Cet article explique</span> <span class="hps">comment faire</span> <span class="hps">et propose quelques</span> <span class="hps">commandes</span> usuelles et <span class="hps">utiles d'ADB</span><span>.</span></span></p> -</div> - -<h2 id="Installer_ADB">Installer ADB</h2> - -<p>Vous pouvez installer adb à partir du paquet Android SDK disponible pour Mac, Linux et Windows — allez sur la page <a href="http://developer.android.com/sdk/index.html">Get the Android SDK</a>.</p> - -<p>Vous pouvez aussi installer cette <a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">extension Firefox</a>, ce qui est plus rapide.</p> - -<p>Si vous utilisez la dernière version stable de votre système d'exploitation, alors ADB a de grandes chances d'être maintenu par un membre de la communauté dans les dépôts :</p> - -<p>Le résumé suivant (WIP) indique comment télécharger ADB pour les distributions utilisant les dépôts de Debian, Fedora et Archlinux ainsi que pour Mac OS X.</p> - -<h3 id="Debian_et_distributions_dérivées_(TAILS_*buntu_Elementary_OS)">Debian et distributions dérivées (TAILS, *buntu, Elementary OS)</h3> - -<pre>sudo apt-get install android-tools-adb</pre> - -<h3 id="Fedora_19_20_21_et_distributions_dérivées">Fedora 19, 20, 21, et distributions dérivées</h3> - -<pre>sudo yum install android-tools</pre> - -<h3 id="Archlinux_et_distributions_dérivées">Archlinux et distributions dérivées</h3> - -<pre>yaourt -S android-tools android-udev</pre> - -<h3 id="Mac_OS_X">Mac OS X</h3> - -<p>Vous aurez besoin de Homebrew pour utiliser l'utilitaire adb : <a href="http://brew.sh">brew.sh</a>.</p> - -<p>Lancez ensuite la commande suivante :</p> - -<pre>brew install android-platform-tools</pre> - -<h3 id="Autre">Autre</h3> - -<p>Si votre distribution ne possède pas les paquets adb (par exemple Ubuntu 12.04 ou Fedora 17/18), vous aurez besoin d'installer <a class="external" href="http://developer.android.com/sdk/index.html" title="http://developer.android.com/sdk/index.html">le paquet starter Android SDK</a> pour votre plateforme (choisissez l'<em>ADT Bundle</em>, et non pas l'option <em>SDK Tools Only</em>). Puis démarrer le gestionnaire de paquet, <code>$SDK_HOME/tools/android</code>, et utiliser l'interface graphique pour installer "Android SDK Platform-tools".</p> - -<p>Regardez où <code>adb</code> est installé (généralement dans <code>usr/bin</code>, et peut être aussi à l'intérieur de <code>adt/platform-tools</code>, selon où vous l'avez installé). Pensez à ajouter ce répertoire à votre <code>PATH</code>. Vous pouvez faire ça en ajoutant la ligne</p> - -<pre>PATH=$SDK_HOME:$PATH</pre> - -<p>en remplaçant <code>$SDK_HOME</code> avec l'emplacement du SDK Android, dans votre <code>~/.bashrc</code> ou équivalent.</p> - -<h2 id="Dépannage">Dépannage</h2> - -<h3 id="Installer_les_bibliothèques_de_compatibilité_32_bits">Installer les bibliothèques de compatibilité 32 bits</h3> - -<p>Vous pourrez traiter de données en 32 bits. Si votre système d'exploitation est en 64 bits, cela signifie qu'il vous faudra des bibliothèques de compatibilité 32 bits.</p> - -<p>Le résumé ci-dessous (WIP) indique comment les télécharger depuis les dépôts de Debian et Archlinux :</p> - -<h3 id="Debian_et_distributions_dérivées_(TAILS_*buntu_Elementary_OS)_2">Debian et distributions dérivées (TAILS, *buntu, Elementary OS)</h3> - -<pre>sudo apt-get install ia32-libs</pre> - -<h3 id="Archlinux_et_distributions_dérivées_2">Archlinux et distributions dérivées</h3> - -<p>Pour intégrer des bibliothèques de compatibilité 32 bits, il faut indiquer à pacman que vous souhaitez les paquets venant de multilib.</p> - -<p>Le dépôt multilib devrait être présent par défaut, mais vous pouvez, dans le cas contraire, modifier votre pacman.conf et décommenter ou taper les lignes suivantes :</p> - -<pre>[multilib] - -Include = /etc/pacman.d/mirrorlist</pre> - -<p>Installez ensuite les paquets <a href="https://www.archlinux.org/packages/multilib/x86_64/lib32-libstdc++5/">lib32-libstdc++5</a> et <a href="https://www.archlinux.org/packages/multilib/x86_64/lib32-zlib/">lib32-zlib</a> à l'aide de la commande suivante :</p> - -<pre>yaourt -S lib32-libstdc++5 lib32-zlib</pre> - -<h3 id="Appareil_non_listé_par_'adb_devices'">Appareil non listé par 'adb devices'</h3> - -<p>Si votre appareil n'est pas affiché en tapant 'adb device', <a href="https://gist.github.com/justinpotts/f0b0c3883d5947c219b5">cliquez ici</a> pour suivre les étapes de résolutions.</p> - -<h2 id="Commandes_ADB_usuelles">Commandes ADB usuelles</h2> - -<p>Les sections suivantes expliquent quelques commandes usuelles d'adb.</p> - -<h3 id="Redémarrer_le_processus_b2g">Redémarrer le processus b2g</h3> - -<p>b2g est l'équivalent d'une application <a href="/en-US/docs/XULRunner" title="/en-US/docs/XULRunner">XULRunner</a> fonctionnant sur le téléphone sur un kernel basé sur Android. Si vous souhaitez le redémarrer, c'est une manière de mettre à zéro l'environnement applicatif sans redémarrer entièrement l'appareil. Vous pouvez faire cela en entrant la commande suivante dans votre terminal en ayant votre appareil connecté à votre ordinateur (ou lorsque le déboggeur est installé) :</p> - -<pre>adb shell killall b2g</pre> - -<h3 id="Activer_la_redirection_de_port_pour_le_déboggage">Activer la redirection de port pour le déboggage</h3> - -<p>Pour activer simplement la redirection de port (par exemple si vous souhaitez utiliser le gestionnaire d'applications pour débogger des applications Firefox OS sur un appareil), entrez la commande suivante dans votre terminal :</p> - -<pre class="language-html">adb forward tcp:6000 localfilesystem:/data/local/debugger-socket</pre> - -<p>Vous aurez besoin de faire ça à chaque fois que le téléphone est redémarré ou débranché puis rebranché. Vous pouvez changer le nombre du socket si nécessaire.</p> - -<h3 id="Rediriger_des_ports_à_une_machine_locale">Rediriger des ports à une machine locale</h3> - -<p>Pour rediriger des ports à une machine locale, vous aurez besoin de télécharger les binaires <a href="http://people.mozilla.org/~jmuizelaar/forward/">netcat et ssh</a>, et exécuter les commandes suivantes :</p> - -<pre class="brush: bash"># Ceci est un hack horrible, mais il fonctionne... -hôte$ adb forward tcp:7979 tcp:6969 - -# Crée quelques pipes nommés pour faire un netcat bi-directionnel -téléphone$ mknod readback p -hôte$ mknod readback p - -# cela met en place une connexion utilisable une seule fois pour se connecter à l'hôte -# écoute sur les ports 6969 et 5959 et redirige toutes les informations entre elles -téléphone$ ./netcat -l -p 6969 < readback | ./netcat -l -p 5959 > readback -# connecte au port 7979 (port 6969 sur l'appareil) et le serveur ssh local et redirige toutes les informations entre elles -hôte$ ./netcat localhost 7979 < readback | ./netcat localhost 22 > readback - -# maintenant lorsque nous nous connectons au port 5959 sur le téléphone cela sera comme si nous nous connectons au serveur ssh sur l'hôte - -# utilise le reverse netcat pour paramétrer une connexion ssh de retour à l'hôte et redirige le port 9999 sur l'appareil à 'localhost:8000' (cela peut être n'importe quoi comme 'google.com:80') -téléphone$ ./ssh localhost -p 5959 -L 9999:localhost:8000</pre> - -<p>Celà redirigera le port 9999 sur l'appareil au port 8000 de l'hôte.</p> - -<p>Sinon vous pouvez utiliser un serveur SSH (<a href="http://people.mozilla.org/~jmuizelaar/forward/dropbear">dropbear</a> et <a href="http://people.mozilla.org/~jmuizelaar/forward/host_key">host_key</a>) directement sur l'appareil en entrant les commandes suivantes :</p> - -<pre class="brush: bash">téléphone$ DROPBEAR_PASSWORD=root ./dropbear -p 9000 -F -v -a -r host_key ./dropbear -hôte$ adb forward tcp:8888 tcp:9000 -# l'<span class="short_text" id="result_box" lang="fr"><span class="hps">authentification avec clé publique à été codée en dur pour </span></span>fonctionner (<span id="result_box" lang="fr"><span class="hps">assurez-vous que</span> <span class="hps">vous avez</span> <span class="hps">une clé publique</span> <span class="hps">ssh</span> <span class="hps">à utiliser</span></span>) -hôte$ ssh -vvv root@localhost -p 8888 -R 9999:people.mozilla.org:80 -</pre> - -<p>Plus de ressources :</p> - -<ul> - <li><a href="http://k.japko.eu/android-dropbear.html">Instructions pour compiler dropbear</a></li> - <li><a href="http://people.mozilla.org/~jmuizelaar/forward/dropbear-b2g.patch">Patch dropbear</a> pour désactiver le crash dû à des variables d'environnement manquantes <span class="short_text" id="result_box" lang="fr"><span class="hps">et</span> <span class="hps">succès</span> <span class="hps">d'authentification <span class="short_text" id="result_box" lang="fr"><span class="hps">codé en dur</span></span></span><span>.</span></span></li> -</ul> diff --git a/files/fr/archive/b2g_os/debugging/journalisation_console/index.html b/files/fr/archive/b2g_os/debugging/journalisation_console/index.html deleted file mode 100644 index d20e6ce712..0000000000 --- a/files/fr/archive/b2g_os/debugging/journalisation_console/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Journalisation console sur l'appareil -slug: Archive/B2G_OS/Debugging/Journalisation_console -tags: - - B2G - - Console Web - - Déboguer - - Firefox OS - - Journaliser -translation_of: Archive/B2G_OS/Debugging/On-device_console_logging ---- -<p>En plus de la possibilité de journaliser vers la console et de lire depuis la <a href="/en-US/docs/Mozilla/Firefox_OS/Debugging/Using_the_Remote_Web_Console" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Using_the_Remote_Web_Console">Console Web distante</a>, vous pouvez journaliser directement vers le stockage de fichiers de l'appareil, et ensuite récupérer les journaux plus tard depuis votre ordinateur en utilisant l'utilitaire <a href="https://developer.android.com/tools/help/logcat.html" title="https://developer.android.com/tools/help/logcat.html">logcat</a> et une connection USB. Cet article explique comment activer la fonctionnalité, comment journaliser, et comment récupérer les journaux.</p> -<h2 id="Activer_la_console_sur_Firefox_OS">Activer la console sur Firefox OS</h2> -<p>Les builds de production de Firefox ont la journalisation console (tel que <a href="/fr/docs/Web/API/Console/log" title="Affiche un message dans la Console Web."><code>console.log()</code></a>) désactivée par défaut. Pour la rétablir, ouvrez l'application Paramètres, et ensuite allez dans <code>Informations > Plus d'informations > Développeurs</code>. Dans ce menu, sélectionnez <em>Console activée</em>.</p> -<h2 id="Journaliser">Journaliser</h2> -<p>Une fois que la journalisation est activée, cela marche comme pour Firefox sur ordinateur. Vous utilisez simplement les méthodes de l'objet <a href="/fr/docs/Web/API/Console" title="L'objet console donne accès à la console de débogage du navigateur (par exemple., la Console Web dans Firefox). Les spécificités de fonctionnement varient d'un navigateur à l'autre, mais il y a tout de même un ensemble de fonctionnalités qui sont fournies de base."><code>console</code></a> pour envoyer du texte vers la console. Par exemple :</p> -<pre class="brush: js">console.info("Démarrage du matériel foobar !" -var err = foobar.start(); -if (err) { - console.error("--Erreur %d démarrage du matériel foobar !", err); -} -</pre> -<p>Voir <a href="/fr/docs/Web/API/Console" title="L'objet console donne accès à la console de débogage du navigateur (par exemple., la Console Web dans Firefox). Les spécificités de fonctionnement varient d'un navigateur à l'autre, mais il y a tout de même un ensemble de fonctionnalités qui sont fournies de base."><code>console</code></a> pour plus de détails sur les fonctionnalités de journalisation qui vous sont offertes.</p> -<h2 id="Utiliser_logcat">Utiliser logcat</h2> -<p>Parce que les journaux sont stockés sur l'appareil Firefox OS, et qu'il n'y a pas actuellement d'interface utilisateur pour voir ces journaux sur l'appareil, vous devrez les récupérer depuis un ordinateur pour les analyser. Vous aurez besoin d'utiliser la commande <code>logcat</code> depuis <code>adb</code>, qui fait partie du SDK Android que vous avez peut-être déjà installé lors de votre préparation pour développer pour et sur Firefox OS.</p> diff --git a/files/fr/archive/b2g_os/debugging/les_paramètres_développeurs/index.html b/files/fr/archive/b2g_os/debugging/les_paramètres_développeurs/index.html deleted file mode 100644 index 43ea1216c8..0000000000 --- a/files/fr/archive/b2g_os/debugging/les_paramètres_développeurs/index.html +++ /dev/null @@ -1,421 +0,0 @@ ---- -title: Paramètres pour développeurs sur Firefox OS -slug: Archive/B2G_OS/Debugging/Les_paramètres_développeurs -tags: - - Déboguer - - Firefox OS -translation_of: Archive/B2G_OS/Debugging/Developer_settings ---- -<div class="summary"> -<p>Caché au fond de l'application Paramètres de Firefox OS, se trouve le panneau Développeurs. Ce panneau offre de nombreuses options qui vous simplifieront le débogage de votre application Open Web et de Firefox OS. Cet article présente les options disponibles et explique comment les utiliser.</p> -</div> - -<p>Le panneau de paramétrage à destination des développeurs est intentionnellement difficile d'accès afin d'éviter aux utilisateurs courants d'activer par erreur des options qui pourraient ralentir leur appareil ou modifier l'affichage.</p> - -<p>Dans les versions de Firefox OS 1.4 et suivantes, pour atteindre ce panneau, il faut d'abord l'activer via <em>Paramètres > Informations > Plus d'informations > Cocher "Menu Développeurs"</em>. Ensuite ouvrez l'application "Paramètres", et touchez le bouton "Développeurs" (dans la section "Appareil") :</p> - -<p><img alt="capture d'écran de l'application Paramètres" src="https://mdn.mozillademos.org/files/11393/parameters_menu.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<p>Ce panneau "Développeurs" ressemble à ceci (Capture d'écran prise sur un ZTE Open C, avec Firefox OS 2.2) :</p> - -<p><img alt="Capture d'écran du contenu du menu Développeurs" src="https://mdn.mozillademos.org/files/11395/developpeurs_menu.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<p>Dans les versions de Firefox OS antérieures à la 1.4, c'est via <em>Paramètres > Informations > Plus d'informations > Développeurs</em>.</p> - -<div class="warning"> -<p><strong>Important</strong>: Ces outils sont puissants mais peuvent provoquer des bugs au cours d'une utilisation classique. Les fonctionnalités connues pour en provoquer ont été désactivées par défaut. Si vous rencontrez des problèmes, essayez de désactiver les fonctionnalités développeur que vous avez activées.</p> -</div> - -<h2 id="Options_du_panneau_Développeurs">Options du panneau Développeurs</h2> - -<h3 id="Débogage_via_USB">Débogage via USB</h3> - -<p>L'option "Débogage USB" permet le <a href="https://developer.mozilla.org/fr/docs/Tools/Debugger">débogage à distance</a> de votre appareil Firefox OS. Ceci permet aussi l'utilisation des commandes <a href="https://developer.mozilla.org/fr/Firefox_OS/Debugging/Installing_ADB">ADB</a>. Dans les versions antérieures à la 1.4, il n'y a qu'une case à cocher, à partir de la version 1.4, il y a 3 options disponibles :</p> - -<ul> - <li>Désactivé: le débogage distant est désactivé (choix par défaut).</li> - <li>ADB uniquement: accorde l'accès à l'appareil par ADB.</li> - <li>ADB et outils de développement: accorde l'accès à l'appareil par ADB et par des outils de développement Firefox tel que <a href="https://developer.mozilla.org/fr/docs/Tools/WebIDE">WebIDE</a>.</li> -</ul> - -<h3 id="Outils_de_développement_via_Wi-Fi">Outils de développement via Wi-Fi</h3> - -<div class="note"> -<p><strong>Note</strong>: Introduit dans Firefox OS 3.0 et Firefox 39.0 (27 Mars 2015 et ultérieur)</p> -</div> - -<p>Cocher cette case permet de connecter l'appareil Firefox OS à <a href="https://developer.mozilla.org/fr/docs/Tools/WebIDE">WebIDE</a> -que vous trouverez sur Firefox Bureau- via un réseau Wi-Fi local. Cela vous permettra d'envoyer vos applications sur votre appareil Firefox OS pour les tester facilement. Pour plus de détails, voir <a href="http://convolv.es/blog/2015/03/25/wifi-debug-fxos/">Débogage Wi-Fi de Firefox OS</a> de J. Ryan Stinnett (en anglais).</p> - -<h3 id="Nom_d'appareil_Wi-Fi_pour_DevTools">Nom d'appareil Wi-Fi pour DevTools</h3> - -<div class="note"> -<p><strong>Note</strong>: Introduit dans Firefox OS 3.0 et Firefox 39.0 (27 Mars 2015 et ultérieur)</p> -</div> - -<p>Ce champ texte vous permet de définir le nom sous lequel votre appareil sera identifié par votre réseau Wi-Fi, lorsqu'il sera connecté aux outils de développement (voir paragraphe précédent).</p> - -<h3 id="Informations_Développeurs">Informations Développeurs</h3> - -<p>À partir de la version 1.4 de Firefox OS, toucher cette section vous amène dans le panneau "Informations Développeurs":</p> - -<p><img alt="Contenu du panneau Informations Développeurs" src="https://mdn.mozillademos.org/files/11397/InformationsDeveloppeurs.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<p>Les 2 premières cases à cocher (toujours actives) sont:</p> - -<ul> - <li><strong>Images par seconde</strong>: affiche le nombre d'images par seconde, comme expliqué dans la section <a href="#Images_par_seconde">Images_par_seconde</a> ci-dessous.</li> - <li><strong>Durée de chargement</strong>: affiche les durées de chargement, comme expliqué dans la section <a href="#Durée_de_chargement">Durée_de_chargement</a> ci-dessous.</li> -</ul> - -<p>Ensuite, il y a l'option "Outils de développement" qui gère l'accès aux options qui se trouvent dessous, chacune contrôlable par une case à cocher:</p> - -<ul> - <li><strong>Outils de développement</strong> - - <ul> - <li><strong>Changement dans ADB</strong>: active l'enregistrement de changements sur l'appareil par adb logcat.</li> - <li><strong>Informations système:</strong> permet de superposer sur l'affichage, différentes informations de différents types.</li> - </ul> - </li> - <li><strong>Problèmes</strong> - <ul> - <li><strong>Avertissements:</strong> affiche les avertissements de la console.</li> - <li><strong>Erreurs</strong>: affiche les erreurs de la console.</li> - <li><strong>Problèmes de sécurité:</strong> affiche les problèmes potentiels de sécurité.</li> - </ul> - </li> - <li><strong>Performances</strong> - <ul> - <li><strong>Reflows</strong>: displays reflows as they occur.</li> - <li><strong><a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Architecture#Jank">Blocages</a></strong>: prévient l'utilisateur des blocages dépassant une durée inacceptable (durée paramétrable).</li> - </ul> - </li> - <li><strong>Mémoire</strong> - <ul> - <li><strong>Unique set size</strong>: mesure de la mémoire utilisée par une application et dédiée à celle-ci. C'est une mesure importante pour faire des optimisations d'utilisation mémoire, mais il y en a d'autres. Voir la section <a href="https://developer.mozilla.org/fr/Firefox_OS/Developing_Gaia/Testing_Gaia_code_changes#Performance_tests">Tests de Performance</a> pour plus d'informations.</li> - <li><strong>Mémoire application</strong>: affiche des informations concernant la quantité de mémoire utilisée par l'application et permet d'activer ou désactiver différents facteurs d'utilisation. Voir <a href="#Mémoire_application">Mémoire_application</a> ci-dessous pour plus de détails.</li> - <li><strong>Objets JS</strong>: mesure de la quantité de mémoire utilisée par l'application en objets JS.</li> - <li><strong>Chaînes JS</strong>: mesure de la quantité de mémoire utilisée par l'application en chaînes JS.</li> - <li><strong>JS (autre)</strong>: mesure de la quantité de mémoire utilisée par l'application avec d'autres fonctionnalités JS.</li> - <li><strong>DOM</strong>: mesure de la quantité de mémoire utilisée par l'application avec son DOM.</li> - <li><strong>Style</strong>: mesure de la quantité de mémoire utilisée par l'application avec son CSS.</li> - <li><strong>Autre</strong>: mesure de la quantité de mémoire utilisée par l'application par des éléments non pris en compte par les catégories précédentes.</li> - </ul> - </li> -</ul> - -<h4 id="Images_par_seconde">Images par seconde</h4> - -<p>Activer cette option affiche 3 nombres dans le coin en haut à gauche de l'affichage Firefox OS (voir capture d'écran précédente). Ces valeurs sont une moyenne des résultats récents au sein d'une fenêtre défilant. Ces valeurs sont voulues "instantanées" mais assez précises. Ces nombres sont donc des "déductions":</p> - -<ul> - <li>Le nombre de gauche est la <strong>fréquence de composition</strong>: l'estimation du nombre de fois par seconde que Firefox OS dessine les trames pour le framebuffer matériel. Ceci est une estimation de la vitesse de rafraîchissement perçue par l'utilisateur (et bien uniquement une estimation). Par exemple, le compteur peut afficher 60 compositions par seconde même si l'écran ne change pas. Dans ce cas le taux de rafraîchissement perçu par l'utilisateur serait 0. Cependant cette mesure peut s'avérer être un outil simple et utile, si l'on n'oublie pas cette particularité et si on la compare avec d'autres mesures.</li> - <li>Le nombre du milieu est la <strong>fréquence de la couche de transaction</strong>: l'estimation du nombre de fois par seconde que les processus repeignent et le notifient au compositeur. Cette estimation est principalement utile pour les développeurs de Gecko. Ce nombre devrait être inférieur ou égal à la fréquence de composition.</li> - <li>Le nombre de droite est une mesure du nombre de pixels dessinés exprimés en pourcentage de la taille de l'écran. Une valeur de 317 signifie que l'écran a été dessiné 3,17 fois. Idéalement ce nombre devrait s'approcher le plus possible de 100.</li> -</ul> - -<h4 id="Durée_de_chargement">Durée de chargement</h4> - -<p>Firefox OS possède un outil aidant à la mesure de la durée de chargement, particulièrement la durée du "premier affichage". Les valeurs fournies par l'outil — dans le coin en haut à droite de l'écran (voir capture d'écran précédente) — représentent la durée écoulée entre l'instant de lancement de l'application par l'utilisateur et une estimation du premier instant où l'application s'affiche à l'écran, en millisecondes. Ce nombre est uniquement une estimation de la durée réelle d'affichage et a tendance à la sous estimer. Cependant, faire baisser cette valeur se traduit quasiment toujours par une amélioration de la durée de chargement. Cette valeur peut donc être utile pour mesurer rapidement l'efficacité de travaux d'optimisation.</p> - -<h4 id="Mémoire_application">Mémoire application</h4> - -<p>Affiche la quantité de mémoire que les différentes catégories sélectionnées utilisent au sein de l'application courante. Par exemple, la capture d'écran ci-dessous n'a que les options <em>Mémoire application</em> et <em>Objets JS</em> de cochées, donc l'indicateur en bas à droite de l'écran montre que l'application Paramètres utilise 1,15MB en objets JS.</p> - -<p><img alt="Exemple d'activation de l'option Mémoire Application" src="https://mdn.mozillademos.org/files/11399/MemoireApplication.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<h2 id="Accélération_graphique">Accélération graphique</h2> - -<h3 id="Zones_repeintes">Zones repeintes</h3> - -<p>Dans ce mode, chaque fois qu'une région de l'écran est peinte par Gecko, Gecko ajoute une couche translucide de couleur aléatoire sur la région. Idéalement, seules les régions de l'écran qui changent visuellement "flasheront" avec une nouvelle couleur. Mais il arrive qu'il y ait plus de régions repeintes que nécessaire, faisant "flasher" de grosses parties de l'écran. Ce symptôme peut indiquer une trop forte mise à jour de l'écran de la part de l'application, ou être le reflet de bogues de Gecko lui-même.</p> - -<p><img alt="Capture d'écran montrant l'option Zones repeintes en action" src="https://mdn.mozillademos.org/files/11401/ZonesRepeintes.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<h3 id="Overscrolling">Overscrolling</h3> - -<p>Active ou désactive le comportement des versions 2.1 et ultérieures de Firefox OS qui consiste a étirer l'affichage lorsque l'utilisateur tente de faire défiler la page au delà de la fin puis remet l'affichage à sa taille normale une fois le défilement arrêté, un peu comme le ferait un élastique. Le nom complet de ce comportement est <em>elastic overscroll</em>.</p> - -<h3 id="Tuilage_(was_Layers_Enable_tiles)">Tuilage (was Layers: Enable tiles)</h3> - -<p>Introduite à partir de la version 1.4 de Firefox OS, cette fonctionnalité active l'affichage de contenu sur l'écran en petites parties ("tuiles") plutôt que d'afficher tout l'écran d'un seul coup. Ceci est principalement utile pour le travail du service QA impliquant la réduction de l'effet damier et la recherche de fenêtres de régression.</p> - -<h3 id="Painting_basse_précision">Painting basse précision</h3> - -<p>Activer cette option fait dessiner à Gecko une version basse précision (floue) du contenu lors d'un défilement vraiment rapide. Ceci est utile parce que plus rapide à dessiner et aide donc à éviter d'afficher des zones blanches (effet damier) lors d'un défilement rapide. Cela ne devrait être visible que temporairement pour l'utilisateur, car le contenu basse précision sera remplacé par le contenu haute précision dès que le défilement s'arrêtera.</p> - -<h3 id="Transparence_basse_précision">Transparence basse précision</h3> - -<p>Ceci est une option supplémentaire pour le "painting" basse précision qui rend le contenu basse précision à moitié transparent. Ceci rend l'effet un peu plus subtile et moins déroutant pour l'utilisateur.</p> - -<h3 id="Composition_matérielle_(was_Enable_hardware_compositing)">Composition matérielle (was Enable hardware compositing)</h3> - -<p>Lorsque cette option est activée, l'appareil utilise son <a href="https://source.android.com/devices/graphics/index.html#hardware_composer">Composeur matériel</a> pour composer les éléments visuels (surfaces) de l'écran.</p> - -<h3 id="Dessiner_bords_du_tuilage_(was_Layers_Draw_tile_borders)">Dessiner bords du tuilage (was Layers: Draw tile borders)</h3> - -<p>Ceci est similaire à l'option <a href="#Dessiner_bords_du_calque">Dessiner_bords_du_calque</a>, mis à part qu'elle dessine les bords des tuiles individuelles en plus des bords des calques.</p> - -<h3 id="Dessiner_bords_du_calque">Dessiner bords du calque</h3> - -<p>Lorsque cette option est activée, un bord de couleur vive est ajouté autour des différentes calques affichés à l'écran — très pratique pour investiguer les problèmes de calques.</p> - -<p><img alt="Une capture d'écran montrant l'effet de l'option Dessiner bord du calque" src="https://mdn.mozillademos.org/files/11411/DessinerBordsCalques.png" style="display: block; height: 533px; margin: 0px auto; width: 320px;"></p> - -<h3 id="Informations_arbres_de_calques">Informations arbres de calques</h3> - -<p>Cette option active <code>layers.dump</code>, qui copie l'arbre de calque du composeur dans logcat à chaque image composée à l'écran. Ceci est principalement utile pour travailler sur les performances graphiques de la plate-forme, plutôt que pour du développement web classique.</p> - -<h3 id="Information_layerscope">Information layerscope</h3> - -<p>Active les traces du layerscope permettant de voir des informations concernant les calques des applications installées sur un PC. Lire <a href="https://wiki.mozilla.org/Platform/GFX/LayerScope">Layerscope sur le wiki Mozilla (en anglais)</a> pour avoir plus de détails et savoir comment l'utiliser.</p> - -<h3 id="Miniatures_captures_d'écran">Miniatures: captures d'écran</h3> - -<p>Dans la vue miniature, active l'affichage de capture d'écran des applications lancées. Sinon, les icônes des applications seront affichés au centre de miniatures vides.</p> - -<h2 id="Gestion_de_la_fenêtre">Gestion de la fenêtre</h2> - -<h3 id="Émuler_le_bouton_Accueil">Émuler le bouton Accueil</h3> - -<p>Crée un bouton Accueil logiciel offrant les mêmes fonctionnalités que son équivalent matériel s'il n'est pas disponible. Cette option existe pour une utilisation future par des appareils qui n'auront probablement pas de bouton Accueil matériel, comme les tablettes.</p> - -<h3 id="Geste_de_retour_à_l'accueil">Geste de retour à l'accueil</h3> - -<p>Permet de faire un geste (partir hors de l'écran et monter vers le centre de l'écran) pour revenir à l'accueil. Encore une fois cette option propose une fonctionnalité du bouton Accueil matériel et existe pour une utilisation future par des appareils qui n'auront probablement pas de bouton Accueil matériel, comme les tablettes.</p> - -<h3 id="Transition_continue">Transition continue</h3> - -<p>Cette option permet de contrôler si l'application clavier s'ouvre immédiatement ou de manière continue (avec une transition). Désactiver une telle transition peut être utile sur des appareils bas de gamme qui souffrent de mauvaises performances.</p> - -<h3 id="Transition_d'application">Transition d'application</h3> - -<p>Active et désactive toutes les transitions d'ouverture et de fermeture d'applications: toutes les applications s'afficheront immédiatement -sans douce animation- et les claviers apparaîtront et disparaîtront sans animation non plus. Comme l'option "Transition continue", elle a pour but d'améliorer les performances sur des appareils bas de gamme, avec des effets plus notables.</p> - -<h3 id="Suspension_d'application">Suspension d'application</h3> - -<p>Cette option activée fait qu'une application fermée en tâche de fond sera gardée dans l'historique et ré-ouverte lorsque vous la sélectionnerez depuis l'écran d'accueil ou la vue miniature. L'option désactivée, une telle application ne sera pas gardée dans l'historique ou la vue miniature.</p> - -<h3 id="Copier-coller">Copier-coller</h3> - -<p>Active la fonctionnalité, encore expérimentale, de copier-coller en cours d'implémentation dans Firefox OS.</p> - -<h2 id="Débogage">Débogage</h2> - -<h3 id="Pseudo-localisation">Pseudo-localisation</h3> - -<p>Cette option activée, pseudo-langues comme <em>l'anglais accentué </em>et <em>l'anglais miroir</em> sont sélectionnables dans <em>Paramètres > Langue</em>. Avec les pseudo-localisations, vous pouvez tester le support de la localisation de votre code sur une compilation classique de Gaia, sans avoir à ajouter les ressources d'une langue réelle ou devoir parler une autre langue que l'anglais. Par exemple, vous pouvez vous assurer que les calques se redimensionnent bien avec du texte plus long, prévisualiser l'application dans une fausse langue RTL, ou repérer les éléments HTML sans l'attribut <code>data-l10n-id</code> (ils seront affichés en anglais).</p> - -<p><img alt="Screenshot of pseudolocales" src="http://informationisart.com/images/qps.png" style="display: block; height: 440px; margin: 0px auto; width: 600px;"></p> - -<p>Lors de la compilation de Gaia, vous pouvez ajouter les pseudo-langues dans la liste des langues par défaut en ajoutant la ligne suivante dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/common-settings.json">gaia/build/config/common-settings.json</a>:</p> - -<pre class="brush: json language-json"><code class="language-json"><span class="key token">"devtools.qps.enabled":</span> <span class="keyword token">true</span></code></pre> - -<p>Selon la configuration de la compilation, les pseudo-localisations sont soit construites au moment de la compilation (ce qui prend de l'espace disque), soit générées dynamiquement au moment de l'exécution (modifiant les performances et l'empreinte mémoire).</p> - -<ul> - <li> - <p><strong>À la compilation</strong>: vous pouvez ajouter les codes des pseudo-langues (<code>qps-ploc</code> et <code>qps-plocm</code>) à <a href="https://github.com/mozilla-b2g/gaia/blob/master/shared/resources/languages.json">shared/resources/languages.json</a> ou n'importe quel autre fichier JSON que vous utilisez comme <code>LOCALES_FILE</code> (voir <a href="https://developer.mozilla.org/fr/Firefox_OS/Compiler#Compiler_une_version_multilocales">building multilocale Gaia</a>). Ceci est pratique pour tester la performance des autres langues que l'anglais. Par exemple:</p> - - <pre class="brush: json language-json"><code class="language-json"><span class="punctuation token">{</span> - <span class="key token">"en-US" :</span> <span class="string token">"English (US)"</span><span class="punctuation token">,</span> - <span class="key token">"qps-ploc" :</span> <span class="string token">"Ȧȧƈƈḗḗƞŧḗḗḓ Ḗḗƞɠŀīīşħ"</span><span class="punctuation token">,</span> - <span class="key token">"qps-plocm" :</span> <span class="string token">"ɥsıʅƃuƎ pǝɹoɹɹıW"</span> -<span class="punctuation token">}</span></code></pre> - </li> - <li><strong>À l'exécution:</strong> si la pseudo-localisation n'est pas construite à la compilation, il est encore possible d'avoir recours à la génération dynamique. Ceci permet de tester le support de la localisation même sur une version compilée existante, sans avoir besoin de flasher une nouvelle compilation. Il faut cependant garder en tête que la pseudo-localisation à l'exécution possède différentes caractéristiques de performance et de mémoire et ne devrait donc pas être utilisée pour mesurer et comparer les performances de langues autre que l'anglais.</li> -</ul> - -<h3 id="Enregistrer_les_animations_lentes">Enregistrer les animations lentes</h3> - -<p>Cet outil a pour but d'aider les développeurs à comprendre pourquoi les animations ne sont pas déléguées au composeur pour être jouées le plus efficacement possible. Il rapporte des "problèmes" comme essayer d'animer des éléments trop gros, ou d'animer des propriétés CSS qui ne peuvent pas être déléguées. Les messages obtenus ressembleront à ceci:</p> - -<pre class="language-html"><code class="language-html">I/Gecko ( 5644): Performance warning: Async animation disabled because frame size (1280, 410) is bigger than the viewport (360, 518) [div with id 'views']</code></pre> - -<div class="line-number" style="top: 0px;"> </div> - -<h3 id="Sortie_géolocalisation_dans_ADB">Sortie géolocalisation dans ADB</h3> - -<p>Active l'enregistrement des données de géolocalisation vers adb logcat. Ceci aide à déboguer à la fois la partie GPS (à savoir les appels NMEA) et l'utilisation MLS.</p> - -<h3 id="Ignorer_les_positions_GPS">Ignorer les positions GPS</h3> - -<p>Activer cette option oblige l'API de géolocalisation à ignorer les informations de localisation provenant du GPS (l'API n'obtiendra d'information que les services de localisation basés sur le réseau). Ceci est utile pour déboguer des problèmes en rapport avec le fournisseur de géolocalisation GPS de Gonk. voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1056857" title="FIXED: Developer Settings: add checkbox to disable GPS Locations">bug 1056857</a> pour plus d'informations.</p> - -<h3 id="Sortie_Wi-Fi_dans_ADB">Sortie Wi-Fi dans ADB</h3> - -<p>Activer cette option ajoute des informations à propos du Wi-Fi aux log adb (les log d'erreur de la console sont accessibles via la commande <code>adb logcat | grep "Error"</code> dans un Terminal).</p> - -<h3 id="Sortie_Bluetooth_dans_ADB">Sortie Bluetooth dans ADB</h3> - -<p>Activer cette option ajoute des informations à propos du Bluetooth aux log adb (les log d'erreur de la console sont accessibles via la commande <code>adb logcat | grep "Error"</code> dans un Terminal).</p> - -<h3 id="Bluetooth_HCI_Sniffing_Logs_to_SDCard">Bluetooth HCI Sniffing Logs to SDCard</h3> - -<p>Enabling this option causes the device's HCI sniffing logs to be recorded to its SDCard.</p> - -<h3 id="Sortie_NFC_dans_ADB">Sortie NFC dans ADB</h3> - -<p>Activer cette option ajoute des informations à propos du NFC aux log adb (les log d'erreur de la console sont accessibles via la commande <code>adb logcat | grep "Error"</code> dans un Terminal).</p> - -<h3 id="Sortie_RIL_dans_ADB">Sortie RIL dans ADB</h3> - -<p>Activer cette option ajoute des informations à propos du RIL aux log adb (les log d'erreur de la console sont accessibles via la commande <code>adb logcat | grep "Error"</code> dans un Terminal).</p> - -<h3 id="Sortie_réseau_dans_ADB">Sortie réseau dans ADB</h3> - -<p>Activer cette option ajoute des informations à propos du réseau aux log adb (les log d'erreur de la console sont accessibles via la commande <code>adb logcat | grep "Error"</code> dans un Terminal).</p> - -<h3 id="Activer_la_console">Activer la console</h3> - -<p>Activer cette option vous permet d'utiliser la <a href="https://developer.mozilla.org/fr/docs/Mozilla/Firefox_OS/Debugging/Using_the_Remote_Web_Console" title="/fr/docs/Mozilla/Firefox_OS/Debugging/Using_the_Remote_Web_Console">console Web</a> de Firefox pour accéder à distance à la sortie console de l'appareil. Sans cette option activée, la fonction <a href="/fr/docs/Web/API/Console/log" title="Affiche un message dans la Console Web."><code>console.log()</code></a> ne fait rien.</p> - -<h3 id="Trace_de_débogage_de_Gaia">Trace de débogage de Gaia</h3> - -<p>Active les traces DEBUG de Gaia. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=881672" title="FIXED: Enabling a DUMP function for all Gaia apps">bug 881672</a> pour plus de détails.</p> - -<div class="note"> -<p><strong>Note</strong>: Malheureusement, toutes les applications ne supportent pas ce mécanisme pour leur trace de débug. Au lieu de ça, ces dernières gèrent un booléen "DEBUG" qui leur sont propre. Activer cette option n'assure donc PAS que vous aurez l'ensemble des log debug.</p> -</div> - -<h3 id="Paramètres_du_lecteur_d'écran">Paramètres du lecteur d'écran</h3> - -<p>Cette option active les paramètres du <em>Lecteur d'écran</em>, qui se trouve ensuite sous <em>Paramètres > Accessibilité</em>. Activer cette nouvelle option active le lecteur d'écran de Firefox OS. Cette technologie permet à un non voyant d'utiliser un appareil Firefox OS. Actuellement en cours de développement, le lecteur d'écran modifie la façon dont les touches de l'écran fonctionnent. Lorsque le lecteur d'écran est activé, vous devez interagir avec l'écran de la manière suivante:</p> - -<ul> - <li>Toucher quelque part pour sélectionner une application (ou autre) et être prévenu de ce sur quoi vous avez appuyé. Le retour fait par le téléphone est double: il est vocal, d'une part et un rectangle entoure l'objet sélectionné, d'autre part. Une double-touche (deux touches rapidement successives) n'importe où sur l'écran active l'objet qui est entouré par le rectangle.</li> - <li>Un glissement de gauche à droite pour parcourir séquentiellement la liste des objets présents à l'écran. Les objets sont parcouru de gauche à droite, de haut en bas, en incluant le défilement de l'écran s'il y a plus d'objets à afficher. Vous serez prévenu pour chaque objet par une explication orale et un rectangle. Un glissement de droite à gauche parcours les objets dans l'ordre inverse. Une double touche permet toujours d'exécuter l'élément sélectionné.</li> - <li>Un glissement à 2 doigts — à gauche, droite, haut ou bas — pour faire défiler l'écran dans cette direction. Ceci est l'équivalent d'un glissement à 1 doigt avec le lecteur d'écran désactivé. Par exemple un glissement à 2 doigts sur le premier écran d'accueil fera basculer sur le second et un glissement à 2 doigts vers le haut provoquera un défilement vers le bas pour afficher plus de contenu.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Si vous avez activé le lecteur d'écran et que vous souhaitez le désactiver, vous devez revenir jusqu'au panneau de paramétrage à l'aide de ces nouveaux gestes et faire une double-touche sur la case à cocher une fois qu'elle est sélectionnée. Cela restaurera le comportement par défaut.</p> -</div> - -<p>À partir de la version 1.4 de Firefox OS, il y a un moyen plus rapide de changer l'état du lecteur d'écran. Appuyez sur la touche volume plus puis volume moins, et recommencez 3 fois (plus, moins, plus, moins, plus, moins). Le lecteur d'écran vous demandera de refaire cette action (plus, moins, plus, moins, plus, moins) pour l'activer s'il ne l'était pas, ou le désactiver dans l'autre cas. Si vous ne souhaitez pas modifier l'état du lecteur d'écran, faites simplement autre chose. De cette manière, vous pouvez facilement l'activer pour tester l'accessibilité de votre application Web puis le désactiver sans retourner dans le menu à chaque fois.</p> - -<h4 id="Volume_de_lecture">Volume de lecture</h4> - -<p>Un curseur contrôlant le volume de la voix.</p> - -<h4 id="Vitesse_de_lecture">Vitesse de lecture</h4> - -<p>Un curseur contrôlant la vitesse de lecture de la voix.</p> - -<h3 id="Certificats_relecteur_Marketplace">Certificats relecteur Marketplace</h3> - -<p>Les certificats de relecteur Marketplace sont utilisés au cours de processus de revue du <a href="https://marketplace.firefox.com/">Firefox Marketplace</a>, pour permettre aux relecteurs d'installer des applications provenant d'autres sources que le Marketplace (e.g. les pages des relecteurs). Cette option permet à l'appareil d'utiliser ces certificats.</p> - -<h3 id="Secouer_pour_enregistrer_les_journaux_système">Secouer pour enregistrer les journaux système</h3> - -<div class="note"> -<p><strong>Note</strong>: Introduit dans la version 2.2 de Firefox OS</p> -</div> - -<p>Active Logshake, qui attend que l'appareil fasse des mouvements de forte accélération. Lorsqu'un tel mouvement est détecté — c'est à dire lorsque vous secouez votre appareil — il sauvegarde les journaux système présents de log/logcat sur la carte SD, dans un dossier <em>logs/<datetime></em>. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1019816" title="FIXED: Developer option to store logcat to sdcard by shaking the phone">bug 1019816</a> pour plus de détails.</p> - -<h3 id="Permissions_d'applications_détaillées">Permissions d'applications détaillées</h3> - -<div class="note"> -<p><strong>Note</strong>: Introduit dans la version 2.1 de Firefox OS</p> -</div> - -<p>Cette option activée, les développeurs (ainsi que les amateurs de vie privée) peuvent modifier n'importe quelle permission donnée à une application. Le panneau "Permissions applications" dans l'application Paramètres, proposera plus de choix qu'un simple sous-ensemble compréhensible par les non-développeurs (comme géolocalisation). Par exemple, "Schedule Alarms" apparaît avec les choix <em>Demander, Refuser</em> et <em>Autoriser</em>. Notez que certaines applications peuvent ne pas supporter les changements de permissions. Si vous remarquez un comportement anormal veuillez essayer de réinitialiser les permissions, ou réinstaller l'application.</p> - -<h2 id="Tutoriel_de_prise_en_main">Tutoriel de prise en main</h2> - -<p>Ce bouton lance le programme "First-Time Use" (FTU), qui relance la procédure de configuration initiale ainsi que le tutoriel. C'est utile pour déboguer cette procédure, ou si vous souhaitez reconfigurer votre appareil depuis le début.</p> - -<h2 id="Déverrouillage_des_privilèges">Déverrouillage des privilèges</h2> - -<h3 id="Réinitialiser_et_activer_les_outils_de_développement_non_restreints">Réinitialiser et activer les outils de développement non restreints</h3> - -<div class="note"> -<p><strong>Note</strong>: Introduit dans la version 2.2 de Firefox OS</p> -</div> - -<p>Ce bouton vous permet d'activer le <a href="https://developer.mozilla.org/fr/docs/Tools/WebIDE/Running_and_debugging_apps#Unrestricted_app_debugging_%28including_certified_apps.2C_main_process.2C_etc.%29">mode de développement non restreint</a> dans lequel vous pouvez déboguer et surcharger des applications système depuis le <a href="https://developer.mozilla.org/fr/docs/Tools/WebIDE">WebIDE</a>. Pour des raisons de sécurité, activer ce mode supprime les données de l'appareil. Notez qu'une fois ce mode activé, il est hautement suggéré d'ajouter un code PIN pour déverrouiller votre appareil puisque ce mode permet facilement d'accéder aux données internes et aux applications système (informations privées, mots de passe, ...).</p> - -<h2 id="Mises_à_jour_logicielles">Mises à jour logicielles</h2> - -<h3 id="Canal_de_mise_à_jour">Canal de mise à jour</h3> - -<p>Vous permet de définir différents canaux pour recevoir les mises à jour logicielles lors de mises à jour OTA. Les canaux sont <code>nightly</code>, <code>aurora</code>, et <code>others</code>.</p> - -<h3 id="Adresse_de_mise_à_jour">Adresse de mise à jour</h3> - -<p>Vous permet de définir différentes adresses (URL) desquelles recevoir vos mises à jour.</p> - -<h2 id="Options_obsolètes">Options obsolètes</h2> - -<p>Ce chapitre liste les options qui ne sont plus proposées ou qui n'existent plus en l'état, mais qui peuvent être intéressantes pour ceux qui utilisent une ancienne version de Firefox OS.</p> - -<h3 id="Accessibilité">Accessibilité</h3> - -<p>Dans les versions de Firefox OS qui précèdent la 1.4, ceci contrôle les options d'accessibilité, comme expliqué dans la section <a href="#Paramètres_du_lecteur_d'écran">Paramètres_du_lecteur_d'écran</a>.</p> - -<h3 id="Grille">Grille</h3> - -<p>L'option "Grille", une fois activée, ajoute au-dessus de l'affichage de Firefox OS, un motif de grille qui vous aidera à positionner et aligner des éléments. Par exemple, vous pouvez voir ci-dessous l'application navigateur fonctionnant avec l'option Grille d'activée :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5071/Grid.png" style="height: 480px; width: 320px;"></p> - -<p>Les lignes les plus épaisses de la grille sont séparées de 32 pixels, horizontalement et verticalement.</p> - -<h3 id="Images_par_seconde_2">Images par seconde</h3> - -<p>Activer cette option ajoute deux indicateurs en haut de l'affichage de Firefox OS, indiquant la fréquence à laquelle l'écran est redessiné, en images par seconde.</p> - -<h3 id="Show_time_to_load">Show time to load</h3> - -<p>In Firefox OS versions older than newer 1.4, enabling this displays time to load information, as explained in the <a href="#Time_to_load">Time_to_load</a> section above.</p> - -<h3 id="Rocketbar_enabled">Rocketbar enabled</h3> - -<p>In Firefox OS versions older than newer 1.4, this option enables the new <a href="https://groups.google.com/forum/#%21topic/mozilla.dev.gaia/Nlfbrq1KMP0">Firefox Rocketbar</a> on your device, which provides a useful new way to switch between apps, search, and more. When enabled, you'll find a search icon at the top left of the device, and the RocketBar can be brought up by swiping from the top left of the device towards the bottom left.</p> - -<div class="note"> -<p><strong>Note</strong>: In newer versions of Firefox OS, Rocketbar is enabled automatically and cannot be turned off.</p> -</div> - -<h3 id="Contacts_debugging_output_in_adb">Contacts debugging output in adb</h3> - -<p>Enabling this option adds debugging information about contacts to the adb logs (error logs from the console can be accessed using <code>adb logcat | grep "Error"</code> in the Terminal.)</p> - -<h3 id="Progressive_paint_(was_Layers_Progressive_paint)">Progressive paint (was Layers: Progressive paint)</h3> - -<p>This was introduced to help with debugging of the <a href="https://wiki.mozilla.org/Platform/GFX/APZ">Async Panning/Zoom module</a> (APZ) during its implementation. Now APZ implementation is complete, this option is deprecated, and will be removed from future versions (see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1003228" title="FIXED: Remove unnecessary APZ-related settings and menu items">bug 1003228</a>).</p> - -<h3 id="Displayport_Heuristics">Displayport Heuristics</h3> - -<ul> - <li>Default</li> - <li>Center displayport</li> - <li>Assume perfect paints</li> - <li>Taller displayport</li> - <li>Faster paints</li> - <li>No checkerboarding</li> -</ul> - -<p>These options were introduced to help with debugging of the <a href="https://wiki.mozilla.org/Platform/GFX/APZ">Async Panning/Zoom module</a> (APZ) during its implementation, specifically to allow QA to experiment with different repainting heuristics to see which resulted in the least amount of checkboarding. Now APZ implementation is complete, these options are deprecated, and will be removed from future versions (see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1003228" title="FIXED: Remove unnecessary APZ-related settings and menu items">bug 1003228</a>).</p> - -<h3 id="Enable_APZ_for_all_content_(Async_PanZoom)">Enable APZ for all content (Async Pan/Zoom)</h3> - -<p>When enabled, the Async Pan/Zoom module allows panning and zooming to be performed on asynchronously, on another thread, with some noticeable differences to rendering behaviour. To find out more, read the <a href="https://wiki.mozilla.org/Platform/GFX/APZ">MozillaWiki APZ</a> article. Now APZ implementation is complete, this option is deprecated, and will be removed from future versions (see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1003228" title="FIXED: Remove unnecessary APZ-related settings and menu items">bug 1003228</a>).</p> - -<h3 id="Edges_gesture">Edges gesture</h3> - -<p>Enabling this option allows you to swipe left and right from outside the screen towards the center, to navigate to the next and previous sheets (either web pages in the browser, or views inside another app.) This basically works like the browser navigator bar in Firefox, but is enabled by default in Firefox 2.1+.</p> - -<h2 id="Keyboard_layouts">Keyboard layouts</h2> - -<p>In addition to the developer-specific options listed above, Firefox OS < 1.4's developer settings featured keyboard layout options. These let you toggle on and off the then-experimental Chinese input methods:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5079/InputMethods.png"></p> - -<p>As of Firefox 1.4, these options have been removed. This is because the Chinese keyboard layout implementations (zhuyin and pinyin) have now been completed.</p> - -<div class="note"> -<p><strong>Note</strong>: For other keyboard layouts still under development, such as Japanese, we now have a build-time config to opt them in.</p> -</div> diff --git a/files/fr/archive/b2g_os/debugging/personnaliser_b2g.sh/index.html b/files/fr/archive/b2g_os/debugging/personnaliser_b2g.sh/index.html deleted file mode 100644 index f94c6d0a7e..0000000000 --- a/files/fr/archive/b2g_os/debugging/personnaliser_b2g.sh/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Personnaliser le script b2g.sh -slug: Archive/B2G_OS/Debugging/Personnaliser_b2g.sh -tags: - - B2G - - Déboguer - - Firefox OS -translation_of: Archive/B2G_OS/Developing_Firefox_OS/Customizing_the_b2g.sh_script ---- -<p></p><div class="overheadIndicator draft"> - <p><strong>Brouillon</strong><br> - Cette page n'est pas terminée.</p> - -</div><p></p> -<p>Sur téléphone, l'application <code><a href="/en-US/docs/Mozilla/Firefox_OS/Architecture#The_userspace_process_architecture" title="/en-US/docs/Mozilla/Firefox_OS/Architecture#The_userspace_process_architecture">b2g</a></code> (qui fournit entre autres les APIs Firefox OS) est démarré à travers le script <code>/system/bin/b2g.sh</code> script. Vous pouvez personnaliser ce script pour changer le comportement de Firefox OS.</p> -<h2 id="Définir_les_variables_d'environnement">Définir les variables d'environnement</h2> -<p>Si vous voulez juste définir une variable d'environnement pour un seul lancement de B2G, vous pouvez faire ceci :</p> -<pre>adb shell stop b2g -abd shell "export ENV_VAR=value && /system/bin/b2g.sh" -</pre> -<p>Si vous voulez utiliser la même variable d'environnement tout le temps, il vous faut éditer le script <code>b2g.sh</code>, tel que décrit dans la section suivante.</p> -<h2 id="Éditer_b2g.sh">Éditer <code>b2g.sh</code></h2> -<p>Pour déboguer, vous voudrez peut-être définir des variables d'environnement pour journaliser des informations ou modifier la façon dont le programme <code>b2g</code> tourne. Vous pouvez le faire en éditant le script <code>b2g.sh</code>. Il n'y a aucun outil d'inclus sur le téléphone pour modifier ce fichier, il vous faudra d'abord le copier sur votre ordinateur.</p> -<p>Connectez le téléphone à votre ordinateur, ouvrez le Terminal, et éxecutez la commande suivante pour modifier le script :</p> -<pre>adb pull /system/bin/b2g.sh</pre> -<p>Modifier le script pour appliquer les changements souhaités. Par exemple, supposons que vous souhaitez voir la sortie de journalisation (ce qui nécessite une compilation de déboguage), vous pourriez rajouter quelque chose comme ceci :</p> -<pre>export NSPR_LOG_FILE=/data/local/tmp/mylog.txt -export NSPR_LOG_MODULES=Layers:5 -</pre> -<p>Et maintenant pour déposer votre script <code>b2g.sh</code> modifié sur votre téléphone :</p> -<pre>adb shell stop b2g -adb remount -adb push b2g.sh /system/bin -adb shell chmod 0755 /system/bin/b2g.sh -adb shell start b2g -</pre> -<div class="note"> - <p><strong>Note :</strong> <code>/data/local/tmp</code> est le seul endroit dans le système de fichier accessible en écriture aux processus de contenu.</p> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko" title="/en-US/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a></li> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Architecture" title="/en-US/docs/Mozilla/Firefox_OS/Architecture">Vue d'ensemble de l'architecture de Firefox OS</a></li> - <li><a href="/fr/docs/Mozilla/Firefox_OS/deboguer" title="/en-US/docs/Mozilla/Boot_to_Gecko/Debugging_on_Boot_to_Gecko">Déboguer sur Firefox OS</a></li> -</ul> -<p> </p> diff --git a/files/fr/archive/b2g_os/debugging/signaler_une_erreur_firefox_os/index.html b/files/fr/archive/b2g_os/debugging/signaler_une_erreur_firefox_os/index.html deleted file mode 100644 index c1ba3e50bd..0000000000 --- a/files/fr/archive/b2g_os/debugging/signaler_une_erreur_firefox_os/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: Signaler une erreur de Firefox OS -slug: Archive/B2G_OS/Debugging/Signaler_une_erreur_Firefox_OS -tags: - - Firefox OS - - QA - - crash - - débogage - - rapport d'erreur - - test -translation_of: Archive/B2G_OS/Debugging/Firefox_OS_crash_reporting ---- -<div class="summary"> -<p>Cette page détaille comment gérer la remontée d'erreurs sur Firefox OS, y compris la récupération des rapports d'erreurs et les plantages forcés.</p> -</div> - -<div class="note"> -<p>Note : La plupart des contributeurs de Firefox pour ordinateur se servent du tag about:crashes pour retrouver les rapports d'erreurs (lire <a href="/en-US/docs/Crash_reporting">Crash reporting</a> pour plus de détails), mais cette méthode n'est pas supportée par Firefox OS.</p> -</div> - -<h2 id="Avant_de_tenter_de_faire_autre_chose">Avant de tenter de faire autre chose</h2> - -<p>Les instructions suivantes supposent que vous avez déjà suivi ces trois étapes :</p> - -<ol> - <li>Assurez-vous que le <a href="/en-US/Firefox_OS/Debugging/Developer_settings#Debugging_via_USB">débogage à distance</a> est autorisé sur votre appareil et que <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> est installé. Ceci autorise votre ordinateur à communiquer avec votre appareil.</li> - <li>Connectez votre appareil à votre ordinateur via USB.</li> - <li>Installez <a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">ADB Helper Add-on</a> sur le bureau Firefox pour gérer tout transfert de port nécessaire.</li> -</ol> - -<h3 id="Installer_BusyBox">Installer BusyBox</h3> - -<p>Il est également recommandé que vous installiez notre service BusyBox qui ajoute un grand nombre de commandes utiles à ADB pour aider à tester et déboguer Firefox OS.</p> - -<p>Pour l'installer, assurez-vous que l'appareil est en marche puis :</p> - -<ol> - <li><a href="https://wiki.mozilla.org/images/3/32/Busybox-b2g.tar.gz">Téléchargez BusyBox</a> ;</li> - <li>Dézippez l'archive à un endroit précis ;</li> - <li>cd dans le dossier busybox-b2g extrait ;</li> - <li>Exécutez <code>./install.sh</code> pour l'installer.</li> -</ol> - -<p>Tous les services busybox ont des liens symboliques en <code>/system/bin</code>, ce qui fait que vous pouvez exécuter des commandes comme <code>ping</code> directement. Voici quelques exemples de commandes :</p> - -<pre class="brush: bash">adb shell ping 8.8.8.8 => ping command - -adb shell ifconfig wlan0 => check tx/rx bytes - -adb shell cat /proc/net/route => check the default route - -adb shell iptables -t nat -nvL => check if the packets are sent from application to IP layer, check Chain OUTPUT (policy ACCEPT 2 packets, 168 bytes)</pre> - -<h2 id="Obtenir_des_rapports_d'erreurs_depuis_un_appareil_sous_Firefox_OS">Obtenir des rapports d'erreurs depuis un appareil sous Firefox OS</h2> - -<p>Nous avons créé une application Firefox OS pour nous permettre de récupérer des rapports d'erreurs — <a href="http://jds2501.github.io/webapi-permissions-tests/about-crashes.zip">About Crashes</a> — qui fonctionne sur les versions 1.2+.<br> - <br> - Pour l'installer sur votre appareil, suivez les étapes ci-dessous.</p> - -<ol> - <li>About Crashes est une application certifiée, vous devez donc autoriser le débogage des applications certifiées (voir les instructions de <a href="/en-US/Firefox_OS/Using_the_App_Manager#Debugging_Certified_Apps_2">App Manager</a>, et <a href="/en-US/docs/Tools/WebIDE#Debugging_certified_apps">WebIDE</a>).</li> - <li>Téléchargez le fichier zip About Crashes depuis le lien ci-dessus et l'extraire le fichier en local.</li> - <li>Dans le bureau Firefox, ouvrez <a href="/en-US/Firefox_OS/Using_the_App_Manager">App Manager</a> ou <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> (en fonction de la version de Firefox que vous utilisez) sous Outils > Développeur Web.</li> - <li>Dans un des outils, ajoutez l'application About Crashes comme une application packagée (App Manager : cliquez sur le plus à côté de l'option <em>Add Packaged App</em>, WebIDE: ouvrez le menu déroulant de gauche et sélectionnez <em>Add Packaged App...</em>).</li> - <li>Connectez votre appareil à App Manager/WebIDE (App Manager: vous le trouverez listé au bas de l'interface utilisateur, WebIDE: vous le trouverez sous <em>Select Runtime</em>).</li> - <li>Installez et ouvrez l'application sur l'appareil (App Manager: pressez le bouton <em>Update</em>, WebIDE: pressez le bouton "Play" (<em>Install and Run</em>)).</li> - <li>Sur l'appareil, pressez le bouton <em>Update</em> dans About Crashes pour voir vos erreurs les plus récentes.</li> -</ol> - -<h2 id="Obtenir_des_IDs_d'erreurs_depuis_la_ligne_de_commande">Obtenir des IDs d'erreurs depuis la ligne de commande</h2> - -<p>Vous pouvez obtenir une liste d'IDs d'erreurs via la ligne de commande en saisissant la commande suivante dans votre terminal :</p> - -<pre class="brush: bash">adb shell ls -l /data/b2g/mozilla/Crash\ Reports/submitted/</pre> - -<p>Si vous avez une longue liste d'erreurs et que vous voulez les trier par date, utilisez cette commande-ci :</p> - -<pre class="brush: bash">adb shell busybox ls -ltr /data/b2g/mozilla/Crash\ Reports/submitted/</pre> - -<h2 id="ObtenirVérifier_le_rapport_d'erreur">Obtenir/Vérifier le rapport d'erreur</h2> - -<p>Pour vérifier un rapport d'erreur:</p> - -<ol> - <li>Copiez le nom de fichier sans l'extension.</li> - <li>Allez sur <a href="http://crash-stats.mozilla.org">Mozilla Crash Reports</a>.</li> - <li>Collez le nom de fichier sans l'extension dans la barre de recherche dans le coin en haut à droite.</li> -</ol> - -<p>Cela devrait afficher le rapport d'erreurs que vous avez soumis.</p> - -<h2 id="Comment_forcer_un_plantage">Comment forcer un plantage</h2> - -<p>Pour déclencher un plantage du système Firefox OS, saisissez la commande suivante dans votre terminal pour trouver l'ID du processus source :</p> - -<pre class="brush: bash">adb shell ps | grep b2g</pre> - -<p>Vous allez devoir trouver la ligne qui commence par <code>root</code>, et qui finit par <code>/system/b2g/b2g</code>. Elle devrait ressembler à ceci :</p> - -<pre class="brush: bash">root 109 1 191120 66024 ffffffff 400fa330 S /system/b2g/b2g</pre> - -<p>Le nombre au début de la ligne est l'ID du processus kill que vous devrez utiliser pour <em>killer</em> ce processus. Exécutez la commande suivante, en remplaçant l'espace de texte réservé par l'ID :</p> - -<pre class="brush: bash">adb shell kill -11 [ENTER ID HERE]</pre> - -<p>Killer le processus root plantera votre l'appareil.</p> - -<h3 id="Comment_exécuter_le_script_GDB_pour_b2g">Comment exécuter le script GDB pour b2g</h3> - -<ol> - <li>Démarrez l'application Galerie sur le téléphone, puis exécutez la commande suivante dans votre terminal : - <pre class="brush: bash">adb shell b2g-ps</pre> - </li> - <li>Notez le pid de l'application Galerie, puis exécutez la commande suivante : - <pre class="brush: bash">./run-gdb.sh attach <pid></pre> - </li> - <li>Provoquez le plantage.</li> - <li>Exécutez cette commande : - <pre class="brush: bash">(gdb) bt</pre> - </li> -</ol> diff --git a/files/fr/archive/b2g_os/debugging/étapes_préparatoires/index.html b/files/fr/archive/b2g_os/debugging/étapes_préparatoires/index.html deleted file mode 100644 index ac45ab39eb..0000000000 --- a/files/fr/archive/b2g_os/debugging/étapes_préparatoires/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: >- - Préparations pour déboguer sur Firefox OS avec les outils pour Développeur Web - de Firefox -slug: Archive/B2G_OS/Debugging/Étapes_préparatoires -tags: - - B2G - - Déboguer - - Firefox OS -translation_of: Archive/B2G_OS/Debugging/Setting_up ---- -<p class="summary">Firefox OS supporte le même protocole de débogage à distance que Firefox pour Android. Ceci veut dire que vous pouvez utiliser les outils de développement web de Firefox pour déboguer les applications Gaia lancées sur un appareil ou un émulateur Firefox OS. Afin de déboguer Firefox OS, sur votre appareil ou dans le simulateur, vous devez utiliser Firefox 18 ou plus récent. De plus, vous devrez modifier des paramètres du navigateur Firefox de votre ordinateur, ainsi que sur Firefox OS.</p> - -<div class="note"> -<p><strong>Note</strong>: Pour déboguer des applications sur un appareil Firefox OS, si c'est sur la version Firefox OS 1.2 ou postérieur, le meilleur choix est d'utiliser <a href="https://developer.mozilla.org/fr/docs/Tools/WebIDE">WebIDE</a>.</p> -</div> - -<h2 id="Firefox_pour_ordinateur">Firefox pour ordinateur</h2> - -<p>Vous devez être sûr d'utiliser Firefox 18 ou plus récent afin d'avoir le support du débogage distant. Si vous n'avez pas déjà une copie récente de Firefox, <a href="https://www.mozilla.org/fr/firefox/fx/#desktop" title="https://www.mozilla.org/fr/firefox/fx/#desktop">téléchargez la dernière version stable</a>, ou récupérez la version <a href="http://nightly.mozilla.org/" title="http://nightly.mozilla.org/">Nightly</a> encore plus récente.</p> - -<p>Une fois que vous avez la bonne version de Firefox sur votre ordinateur, tapez <code>about:config</code> dans la barre d'URL et changez la valeur de <code>devtools.debugger.remote-enabled </code>à <code>true</code>. Vous devrez redémarrer Firefox pour que le débogage distant soit activé. Vous aurez alors une nouvelle option dans le menu <em>Développement > Se connecter...</em></p> - -<h2 id="Activer_le_débogage">Activer le débogage</h2> - -<p>Si vous utilisez le <a href="/fr/docs/Tools/Firefox_OS_Simulator" title="/en-US/docs/Tools/Firefox_OS_Simulator">simulateur Firefox OS</a>, l'activation du débogage est plutôt facile. Vous n'avez pas besoin de faire de redirection de port comme avec un appareil physique. Ouvrez simplement les <a href="https://developer.mozilla.org/fr/Firefox_OS/D%C3%A9boguer/Les_param%C3%A8tres_d%C3%A9veloppeurs">paramètres pour développeurs</a> et activez l'option <em>Débogage USB</em>.</p> - -<div class="warning"> -<p><strong>Note :</strong> Ceci ne fonctionne plus à la date du 10 janvier 2013, car les builds pour appareils de Firefox OS ont le débogage désactivé. Il y aura éventuellement un moyen de compiler votre propre build avec le débogage réactivé, mais cela n'existe pas encore. Ce document sera mis à jour une fois que ce sera possible. De plus, le paramètre pour désactiver le support out-of-process a été supprimé. Pour l'instant, vous devrez utiliser le simulateur Firefox OS pour déboguer.</p> -</div> - -<p>Sur votre appareil Firefox OS physique, ouvrez les <a href="https://developer.mozilla.org/fr/Firefox_OS/D%C3%A9boguer/Les_param%C3%A8tres_d%C3%A9veloppeurs">paramètres pour développeurs</a>, et :</p> - -<ul> - <li>Activez <em>Débogage distant</em>.</li> - <li>Désactivez le support out-of-process, jusqu'à ce que <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=797627" title="Remote Debugging Protocol needs a way to contact B2G subprocesses">bug 797627</a> soit corrigé. Sans ça, seuls les scripts systèmes pourront être débogués.</li> -</ul> - -<div class="note"> -<p><strong>Rappel :</strong> Si vous flashez votre appareil, vous devrez reproduire ces modifications.</p> -</div> - -<p>Vous pouvez maintenant <a href="/fr/docs/Tools/Debugger" title="/en-US/docs/Tools/Debugger">utiliser le débogueur</a> !</p> - -<h2 id="Activer_la_console_sur_un_appareil_Firefox_OS">Activer la console sur un appareil Firefox OS</h2> - -<p>Les builds de production de Firefox ont la journalisation dans la console (tel que <a href="/fr/docs/Web/API/Console/log" title="Affiche un message dans la Console Web."><code>console.log()</code></a>) désactivée par défaut. Pour la rétablir, ouvrez les <a href="https://developer.mozilla.org/fr/Firefox_OS/D%C3%A9boguer/Les_param%C3%A8tres_d%C3%A9veloppeurs">paramètres pour développeurs</a> et sélectionnez <em>Console activée</em>.</p> - -<div class="note"> -<p>Note: Voir <a href="https://developer.mozilla.org/fr/docs/Mozilla/Firefox_OS/Debugging/On-device_console_logging">Journalisation console sur appareil</a> pour obtenir plus de détails concernant l'utilisation de la journalisation console sur Firefox OS.</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Mozilla/Firefox_OS/deboguer" title="/en-US/docs/Mozilla/Firefox_OS/Debugging">Débogueur sur Firefox OS</a></li> - <li><a href="/en-US/docs/Tools/Debugger" title="/en-US/docs/Tools/Debugger">Débogueur</a></li> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Debugging/Developer_settings" title="/en-US/docs/Mozilla/Firefox_OS/Debugging/Developer_settings">Paramètres pour développeur sur Firefox OS</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/depannage/index.html b/files/fr/archive/b2g_os/depannage/index.html deleted file mode 100644 index 1105fd7fe5..0000000000 --- a/files/fr/archive/b2g_os/depannage/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Dépannage de Firefox OS -slug: Archive/B2G_OS/depannage -tags: - - B2G - - Firefox OS - - Mobile -translation_of: Archive/B2G_OS/Troubleshooting ---- -<div class="summary"> -<p>Cet article offre des astuces pour résoudre des problèmes courants pouvant survenir lors de l'utilisation de Firefox OS. N'hésitez pas à compléter cette page !</p> -</div> - -<h2 id="Problème_de_réseau">Problème de réseau</h2> - -<p>Si vous avez des difficultés à vous connecter aux réseaux Wi-Fi, il peut être utile de supprimer le fichier de configuration Wi-Fi de l'appareil. Vous pouvez le faire de cette façon :</p> - -<pre>adb shell rm /data/misc/wifi/wpa_supplicant.conf -adb reboot -</pre> - -<div class="note"> -<p><strong>Note :</strong> Ces instructions partent du principe que vous avez <a href="/fr/Firefox_OS/Installer_sur_un_telephone_mobile#Configurer_les_r.C3.A8gles_udev_pour_votre_appareil" title="/en-US/docs/Mozilla/Firefox_OS/Installing_on_a_mobile_device#Configuring_the_udev_rule_for_your_device">configuré le paramètre udev</a> pour l'appareil.</p> -</div> - -<h2 id="Téléphone_briqué">Téléphone briqué</h2> - -<p>Si vous avez briqué votre téléphone, par exemple en essayant de le flasher avec de mauvaises images, essayez de redémarrer sur le bootloader (fastboot ou heimdal en fonction de votre téléphone). La séquence exacte dépend du téléphone. Retirez le câble USB. Retirez la batterie. Réinsérez la batterie. Pour Unagi et Otoro, appuyez et maintenez le bouton d'augmentation du volume ainsi que le bouton d'alimentation pendant plusieurs secondes jusqu'à voir l'écran de chargement. Vérifiez que le téléphone est dans le mode bootloader en utilisant <code>fastboot devices</code> (ou <code>heimdall devices</code> sur certains téléphones Samsung). Une fois que vous pouvez voir le téléphone en utilisant <code>fastboot devices</code>, positionnez-vous dans le dossier contenant une image de base, ou les fichiers fournis par le fabriquant du téléphone (pour certains téléphones). </p> - -<p>Vous avez deux options pour flasher :</p> - -<ul> - <li>utiliser <code>./flash.sh </code>(recommandé).</li> - <li>exécuter les commandes suivantes dans un terminal:</li> -</ul> - -<pre class="brush: bash">fastboot flash boot boot.img -fastboot flash userdata userdata.img -fastboot flash system system.img -fastboot flash recovery recovery.img -fastboot erase cache -fastboot reboot</pre> - -<h2 id="LED_rouge_clignotante_(otorounagi)">LED rouge clignotante (otoro/unagi)</h2> - -<p>Ceci veut dire que la batterie est trop faible pour démarrer l'appareil. Vous pouvez la laisser se charger pendant un moment (jusqu'à ce que la LED rouge arrête de clignoter, et un petit peu plus longtemps), ou vous pouvez débrancher le câble USB, retirer la batterie, insérer le câble USB, et réinsérer la batterie.</p> - -<h2 id="Impossibilité_de_recevoir_un_SMS_avec_une_carte_SIM_utilisée_précédemment_dans_un_iPhone">Impossibilité de recevoir un SMS avec une carte SIM utilisée précédemment dans un iPhone</h2> - -<p>Si vous faites passer votre carte SIM d'un iPhone à un téléphone Firefox OS (ou une autre plateforme), il ce peut que vous ne puissiez plus recevoir de SMS d'utilisateurs d'iPhone. La raison est que les SMS entre iPhone sont envoyés en utilisant <a href="https://www.apple.com/ios/messages/">iMessage</a>, qui fait passer les messages par les serveurs d'Apple au lieu de les envoyer comme de véritables SMS, dans le but de faire faire des économies aux utilisateurs. Malheureusement, lorsque vous quitter l'iPhone, iMessage ne peut pas le savoir donc les message en provenance d'autres utilisateurs d'iPhone seront toujours envoyés avec iMessage, ce qui veut dire que vous ne pourrez pas les recevoir.</p> - -<p>Pour rectifier ce comportement, vous devez désactiver iMessage pour votre SIM. Pour savoir comment faire, veuillez lire le guide sur imore.com: <a href="http://www.imore.com/text-issues-switching-iphone-android-heres-fix">Here's how to turn off iMessage</a>.</p> - -<h2 id="Appareil_invisible_pour_ADB_sur_OSX">Appareil invisible pour ADB sur OSX</h2> - -<p>Lorsque vous exécutez <code>adb devices</code> sur OSX, certains appareils peuvent ne pas apparaitre pas dans la liste, pour pleins de bonnes raisons. Ceci peut s'arranger en ajoutant le vendor ID de votre appareil au fichier <code>~/.android/adb_usb.ini</code> , pour aider ADB à le voir.</p> - -<div class="note"> -<p><strong>Note</strong>: Voir <a href="http://stackoverflow.com/a/7136003/1027966">ce post stackoverflow</a> pour obtenir tous les détails, notamment comment trouver le vendor ID de votre appareil, et comment l'ajouter au fichier <code>adb_usb.ini</code>.</p> -</div> diff --git a/files/fr/archive/b2g_os/developer_preview_phone/index.html b/files/fr/archive/b2g_os/developer_preview_phone/index.html deleted file mode 100644 index 83cc058f30..0000000000 --- a/files/fr/archive/b2g_os/developer_preview_phone/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Mise à jour d'un téléphone développeur -slug: Archive/B2G_OS/Developer_preview_phone -translation_of: Archive/B2G_OS/Phone_guide ---- -<div class="note"> -<p><strong>Note</strong>: Un nouveau guide, plus détaillé, pour mettre à jour les téléphones développeurs — dont le Geeksphone — est disponible. Pour le lire allez sur <a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Mise à jour de votre Geeksphone/téléphone développeur Firefox OS</a>.</p> -</div> - -<p>Si vous avez un téléphone développeur de <a href="http://www.geeksphone.com/" title="http://www.geeksphone.com/">Geeksphone</a> et que vous souhaitez le mettre à jour, suivez les étapes suivantes. Ces instructions ne concernent que les modèles Geeksphone Keon et Peak.</p> - -<ol> - <li>Assurez-vous d'avoir au moins 50% de batterie restante. C'est important car si votre téléphone s'éteint pendant la mise à jour, vous pourriez devoir le renvoyer.</li> - <li>Le téléphone n'étant pas connecté en USB, sélectionnez Paramètres, Informations sur l'appareil, Plus d'informations, Développeurs puis cochez <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Debugging/Developer_settings#The_Developer_panel" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Debugging/Developer_settings#The_Developer_panel">Débogage distant</a>.</li> - <li>Téléchargez le <a href="http://downloads.geeksphone.com/drivers/usb_driver.zip" title="http://downloads.geeksphone.com/drivers/usb_driver.zip">pilote USB</a> et décompressez-le. Notez où vous l'avez enregistré car vous en aurez besoin plus tard.</li> - <li>Utilisez un câble USB pour le brancher sur votre ordinateur. Si vous utilisez Windows, le système peut vous demander d'installer des pilotes. Si Windows Update ne les trouve pas, vous pourrez indiquer le dossier que vous avez décompressé à l'étape 3.</li> - <li>Téléchargez le fichier de l'image appropriée à votre téléphone (Keon ou Peak). Toutes les images se trouvent sur la <a href="http://downloads.geeksphone.com/" title="http://downloads.geeksphone.com/">page de téléchargement</a> de Geeksphone.</li> - <li>Décompressez le fichier image dans un dossier, entrez dans ce dossier et exécutez le script. Flash.sh est destiné à Linux, Flash.bat à Windows et flash_mac.sh à Machintosh (le <a href="http://developer.android.com/sdk/index.html" title="http://developer.android.com/sdk/index.html">SDK Android</a> est nécessaire).</li> - <li>Attendez que l'appareil redémarre et affiche l'assistant de premier démarrage.</li> -</ol> - -<p><br> - En cas de problème, vous pouvez obtenir de l'aide en postant sur les <a href="http://forum.geeksphone.com/" title="http://forum.geeksphone.com/">forums Geeksphone</a>.</p> diff --git a/files/fr/archive/b2g_os/developing_firefox_os/index.html b/files/fr/archive/b2g_os/developing_firefox_os/index.html deleted file mode 100644 index df620c1a09..0000000000 --- a/files/fr/archive/b2g_os/developing_firefox_os/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Développer Firefox OS -slug: Archive/B2G_OS/Developing_Firefox_OS -tags: - - B2G - - Développer - - Firefox OS - - TopicStub -translation_of: Archive/B2G_OS/Developing_Firefox_OS ---- -<div class="summary"> - <p>Cette section fournit une documentation utile couvrant différentes façons de modifier/améliorer l'expérience Firefox OS (nom de code Boot2Gecko ou B2G) pendant le processus de build, ainsi que la façon dont vous pouvez aider à développer des parties de la plateforme bas niveau telles que <a href="/fr/docs/Mozilla/Gecko">Gecko</a> et <a href="/fr/Firefox_OS/Platform/Gonk">Gonk</a>.</p> -</div> -<div class="note"> - <p><strong>Note</strong> : Si vous êtes intéressés spécifiquement par le développement de Gaia, l'interface de Firefox OS, vous devriez plutôt consulter nos pages <a href="/fr/Firefox_OS/Developing_Gaia">Développer pour Gaia</a>.</p> -</div> -<h2 id="Notes_de_contribution_générales">Notes de contribution générales</h2> -<p>Gecko étant partie intégrante du navigateur Firefox, contribuer à des parties de Gecko relatives à Firefox OS est similaire à contribuer à Gecko de manière générale ; il en est de même pour Gonk. Pour cela, vous avez besoin de vous familiariser avec la communauté, d'apprendre le fonctionnement de l'arborescence du code, et de trouver des bugs sur lesquels travailler. La page <a href="/fr/docs/Introduction">Contribuer à Mozilla</a> est un bon endroit pour se familiariser avec le processus de contribution.</p> -<p>Vous devriez en apprendre plus sur Gecko, comment il fonctionne et comment il est structuré. La <a href="/fr/docs/Gecko">page MDN sur Gecko</a> y rassemble des notes utiles, de même que la page <a href="https://wiki.mozilla.org/Gecko:Overview">Gecko:Overview</a> sur le Wiki Mozilla. Pour plus d'informations sur les API (spécifiques à Firefox OS), la page <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> du Wiki Mozilla donne un aperçu travail, et la page <a href="/fr/docs/WebAPI">WebAPI</a> du MDN rassemble les documentation de toutes les API.</p> -<p>Ensuite, regardez <a href="/fr/Firefox_OS/Platform/Gonk">Gonk</a>, le kernel sur lequel s'appuie Firefox OS. Pour faire simple, Gonk est une autre cible de portage pour Gecko, comme c'est le cas avec les versions de bureau de Firefox sur Mac OS X, Windows et Linux. Gonk en lui-même n'est qu'une version minimaliste du Android Open Source Project — nous essayons autant que possible de ne pas changer Gonk lui-même puisque nous n'avons pas le contrôle du code source, et que les partenaires avec lesquels nous travaillons pour créer les appareils Firefox OS fournissent générallement un code spéfique à leurs appareils pour faire l'interface entre l'appareil et Gecko/Gonk.</p> -<p>Cependant, il y a encore du travail à réaliser avec les API. La plupart du code Gecko spécifique Gonk utilise <code>#ifdef MOZ_WIDGET_GONK</code> pour ne l'activer que dans Firefox OS, et/ou est contenu dans les sous-répertoires <code>gonk</code> tels que <code>gecko-dev/hal/gonk</code>. Essayez de cloner localement le dépôt <a href="https://github.com/mozilla/gecko-dev">gecko-dev</a> et d'y jeter un œil. Notre article <a href="https://developer.mozilla.org/en-US/docs/Mozilla_Source_Code_Directory_Structure">Mozilla Source Code Directory Structure</a> est aussi très utile.</p> -<p>Ensuite, vous devriez apprendre l'<a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Architecture">Architecture de Firefox OS</a>, comment <a href="https://developer.mozilla.org/fr/Firefox_OS/Compiler">Compiler Firefox OS</a> (commencez avec le <a href="https://developer.mozilla.org/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/R%C3%A9sum%C3%A9_processus_compilation_Firefox_OS">Résumé du processus de compilation de Firefox OS</a>), et comment <a href="https://developer.mozilla.org/fr/Firefox_OS/Portage">Porter Firefox OS</a> sur d'autres appareils.</p> -<p>Firefox OS est développé en une série de Modules séparés : regardez la page <a href="https://wiki.mozilla.org/Modules/FirefoxOS">Firefox OS Modules</a> pour vous donner une idée sur la façon dont le code est regroupé, vérifiez qui est le propriétaire du module pour savoir à qui vous adresser si vous avez besoin d'aide.</p> -<div class="note"> - <p><strong>Note </strong>: Pour trouver de l'aide, les meilleurs endroits pour commencer sont la <a href="https://lists.mozilla.org/listinfo/dev-b2g">mailing list dev-b2g</a> et l'espace de chat #b2g sur l'<a href="https://wiki.mozilla.org/IRC">IRC Mozilla</a>.</p> -</div> -<h2 id="Sujets_spécifiques_de_développement_de_Firefox_OS">Sujets spécifiques de développement de Firefox OS</h2> -<dl> - <dt> - <a href="https://developer.mozilla.org/fr/Firefox_OS/Developing_Firefox_OS/Rapporter_Bug_Firefox_OS">Rapporter de bugs à propos de Firefox OS</a></dt> - <dd> - Cet article fournit un guide permettant de renseigner des bug sur l'ensemble des aspects de Firefox OS.</dd> - <dt> - <a href="https://developer.mozilla.org/fr/docs/Modifier_le_fichier_hosts" title="/en-US/docs/Mozilla/Firefox_OS/Tips_and_tricks/modifying_hosts_file">Modifier le fichier hosts</a></dt> - <dd> - Un guide sur ce qui peut être accompli en modifiant le fichier hosts.</dd> - <dt> - <a href="https://developer.mozilla.org/fr/Firefox_OS/Customisation_avec_le_fichier_.userconfig" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">Customisation avec le fichier .userconfig</a></dt> - <dd> - Comment customiser la construction et l'exécution de Firefox OS en changeant le fichier <code>.userconfig</code>.</dd> - <dt> - <a href="https://developer.mozilla.org/fr/Firefox_OS/deboguer/personnaliser_script_b2g.sh">Personnaliser le script b2g.sh</a></dt> - <dd> - Une explication sur ce qui peut être accompli en personnalisant le script b2g.sh, qui fait fonctionner l'application b2g et contrôle différents aspects du système.</dd> - <dt> - <a href="https://developer.mozilla.org/fr/Firefox_OS/Portage" title="/en-US/docs/Mozilla/Firefox_OS/Porting">Porter Firefox OS</a></dt> - <dd> - Information sur la façon de porter Firefox OS sur de nouveaux appareils.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/developing_firefox_os/personnalisation_des_dns/index.html b/files/fr/archive/b2g_os/developing_firefox_os/personnalisation_des_dns/index.html deleted file mode 100644 index b3cc818730..0000000000 --- a/files/fr/archive/b2g_os/developing_firefox_os/personnalisation_des_dns/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Personnalisation des DNS -slug: Archive/B2G_OS/Developing_Firefox_OS/Personnalisation_des_DNS -tags: - - DNS - - Firefox OS -translation_of: Archive/B2G_OS/Developing_Firefox_OS/Customizing_DNS ---- -<p class="summary">Cet article décrit une brève procédure pour modifier les serveurs DNS de toutes les interfaces (wifi, cellulaire, etc.) d'un appareil Firefox OS.</p> - -<h2 id="Préparation_de_votre_environnement">Préparation de votre environnement</h2> - -<ol> - <li>Sur votre téléphone, allez dans les <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">Paramètres Développeurs</a> et activer les réglages suivants : - - <ul> - <li><em>Débogage distant</em> (dans Firefox OS 1.4 et au-delà, sélectionnez <em>ADB et outils de développement</em> dans le menu déroulant.)</li> - <li><em>Activer la console</em></li> - </ul> - </li> - <li>Assurez-vous d'avoir <a href="/fr/Firefox_OS/Déboguer/Installer_ADB">ADB/Fastboot installés</a> sur votre ordinateur.</li> - <li>Une fois ces étapes terminées, branchez votre téléphone sur votre ordinateur via l'USB.</li> -</ol> - -<h2 id="Étapes_pour_actualiser_les_DNS">Étapes pour actualiser les DNS</h2> - -<ol> - <li>Ouvrez une fenêtre de terminal.</li> - <li>Récupérez le fichier de configuration DNS sur votre ordinateur avec la commande ci-dessous : - <pre class="brush: bash">adb pull /system/etc/dhcpcd/dhcpcd-hooks/20-dns.conf 20-dns.conf</pre> - </li> - <li>Recherchez les lignes 22 à 26 dans le fichier : - <pre class="brush: bash"> count=1 - for dnsaddr in ${new_domain_name_servers}; do - setprop dhcp.${intf}.dns${count} ${dnsaddr} - count=$(($count + 1)) - done</pre> - </li> - <li>Dans cette section, remplacez la ligne <code>setprop</code> par des lignes selon ce modèle (vous pouvez spécifier jusqu'à 4 serveurs DNS) : - <pre class="brush: bash"> setprop dhcp.${intf}.dns1 <adresse ip du serveur DNS 1> - setprop dhcp.${intf}.dns2 <adresse ip du serveur DNS 2> - setprop dhcp.${intf}.dns3 <adresse ip du serveur DNS 3> - setprop dhcp.${intf}.dns4 <adresse ip du serveur DNS 4> -</pre> - </li> - <li>Remontez la partition <code>/system</code> sur l'appareil pour obtenir des permissions en lecture-écriture, de cette manière : - <pre class="brush: bash">adb remount</pre> - </li> - <li>Juste au cas où, faites une sauvegarde du fichier original : - <pre class="brush: bash">adb shell mv /system/etc/dhcpcd/dhcpcd-hooks/20-dns.conf /system/etc/dhcpcd/dhcpcd-hooks/20-dns.bak.conf</pre> - </li> - <li>Envoyez le fichier édité et appliquez-lui les permissions correctes, comme ceci : - <pre class="brush: bash">adb push 20-dns.conf /system/etc/dhcpcd/dhcpcd-hooks/20-dns.conf -adb shell chmod 644 /system/etc/dhcpcd/dhcpcd-hooks/20-dns.conf</pre> - </li> - <li>Redémarrez l'appareil et vos paramètres de serveurs DNS seront actualisés.</li> -</ol> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<div> -<ul> - <li><a href="http://developer.android.com/tools/help/adb.html" title="http://developer.android.com/tools/help/adb.html">Documentation ADB</a></li> -</ul> -</div> diff --git a/files/fr/archive/b2g_os/developing_firefox_os/quickstart_guide_to_b2g_development/index.html b/files/fr/archive/b2g_os/developing_firefox_os/quickstart_guide_to_b2g_development/index.html deleted file mode 100644 index b8ad159b13..0000000000 --- a/files/fr/archive/b2g_os/developing_firefox_os/quickstart_guide_to_b2g_development/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Guide de démarrage rapide pour le développement B2G -slug: Archive/B2G_OS/Developing_Firefox_OS/Quickstart_guide_to_B2G_development -tags: - - NeedsContent - - NeedsMarkupWork -translation_of: Archive/B2G_OS/Developing_Firefox_OS ---- -<p></p><div class="overheadIndicator draft"> - <p><strong>Brouillon</strong><br> - Cette page n'est pas terminée.</p> - -</div><p></p> - -<p>À déterminer</p> - -<p>Éléments à aborder :</p> - -<div id="magicdomid190"><span class="author-g-frc9o9ihh5c9qyd0"> * Travail dans l'espace de travail</span></div> - -<div id="magicdomid191"><span class="author-g-frc9o9ihh5c9qyd0"> * dépôt dans l'espace de travail</span></div> - -<div id="magicdomid192"><span class="author-g-frc9o9ihh5c9qyd0"> * git dans les répertoires de travail</span></div> - -<div id="magicdomid193"><span class="author-g-frc9o9ihh5c9qyd0"> * liens dans des répertoires de travail séparés</span></div> - -<div id="magicdomid197"><span class="author-g-frc9o9ihh5c9qyd0"> * Comment contribuer : Gaia, Gecko/Gonk, Gonk, Docs, liens vers les bogues sur lesquels travailler</span></div> - -<div> </div> - -<div>Liens également souhaités vers</div> - -<div> </div> - -<div>Traitement des bogues (comment les différentes équipes oeuvrent ensemble pour travailler sur Bugzilla)</div> - -<div><a href="/en-US/Firefox_OS/Quickstart_guide_to_B2G_development/Bug_Work_to_Firefox_OS">Travailler sur les bogues de Firefox OS [en-US]</a></div> - -<div><a href="/fr/Firefox_OS/Developing_Firefox_OS/Rapporter_Bug_Firefox_OS">Travailler sur les bogues de Firefox OS [fr]</a></div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/developing_firefox_os/rapporter_bug_firefox_os/index.html b/files/fr/archive/b2g_os/developing_firefox_os/rapporter_bug_firefox_os/index.html deleted file mode 100644 index 35080199fc..0000000000 --- a/files/fr/archive/b2g_os/developing_firefox_os/rapporter_bug_firefox_os/index.html +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: Rapporter des bugs à propos de Firefox OS -slug: Archive/B2G_OS/Developing_Firefox_OS/Rapporter_Bug_Firefox_OS -tags: - - Bugs - - Bugzilla - - Firefox OS - - Guide - - QA - - filing - - test -translation_of: Archive/B2G_OS/Developing_Firefox_OS/Filing_bugs_against_Firefox_OS ---- -<div class="summary"> -<p>Cet article est un guide pour aider à rapporter des bugs à propos du projet Firefox OS, incluant Gaia et B2G.</p> -</div> - -<h2 id="Bugzilla">Bugzilla</h2> - -<p>Comme pour la plupart des projets Mozilla, nous utilisons <a href="/fr/docs/Mozilla/Bugzilla">Bugzilla</a> pour le suivi des bugs et des problèmes. Vous pouvez remplir un bug sur <a href="https://bugzilla.mozilla.org/">Bugzilla</a> quand vous en trouvez un — nous avons un <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20OS">produit distinct pour Firefox OS</a>, qui contient les composants pour tout ce qui concerne <a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Gaia">Gaia</a>, <a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Gonk">Gonk</a> et <a href="https://developer.mozilla.org/fr/docs/Gecko">Gecko</a>. Utilisez ce composant pour remplir les bugs concernant Firefox OS, Gaia, etc.</p> - -<div class="note"> -<p><strong>Note </strong>: La page <a href="https://wiki.mozilla.org/B2G/QA">B2G QA Wiki</a> (ressource anglophone) contient également quelques ressources utiles pour la gestion des bugs Firefox OS ; les pages les plus utiles sont <a href="https://wiki.mozilla.org/B2G/QA/Bugzilla">Bugzilla Usage</a> (EN) et <a href="https://wiki.mozilla.org/Bugmasters/Projects/FirefoxOS">Incoming bug triage for Firefox OS</a> (EN).</p> -</div> - -<h3 id="Remplir_des_bugs">Remplir des bugs</h3> - -<p>Pour remplir un bug valide, vous pouvez suivre les <a href="/fr/docs/Recommandations_pour_l%27%C3%A9criture_d%27un_bug">recommandations pour l'écriture d'un bug</a> (voir aussi <a href="http://tech.mozfr.org/post/2013/04/23/Rapporter-un-bogue-sur-Bugzilla">Rapporter un bug</a> sur le blog technique mozfr).<br> - Vous pouvez également utiliser ce <a href="http://mzl.la/1KL4ktp">modèle sur Bugzilla</a> et vous référer aux instructions ci-dessous pour compléter le bug.</p> - -<h3 id="Champs_obligatoires_et_optionnels">Champs obligatoires et optionnels</h3> - -<p>Quand vous remplissez un nouveau bug, certains champs sont obligatoires :</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col"><strong>Champ</strong></th> - <th scope="col"><strong>Description</strong></th> - </tr> - </thead> - <tbody> - <tr> - <td>Component</td> - <td>Choisissez la catégorie à laquelle le bug devrait être rattaché. Si vous n'avez aucune idée de la catégorie dans laquelle devrait se trouver le problème, vous pouvez mettre "General".</td> - </tr> - <tr> - <td>Summary</td> - <td>Indiquez une brève description du bug.</td> - </tr> - <tr> - <td>Description</td> - <td>Décrivez clairement la situation. Un bon bug doit contenir les étapes de reproduction (STR — Steps to reproduce), le résultat attendu (Expected Result), et le résultat actuel (Actual Result). Mentionnez également la fréquence de reproduction (Reproduction Frequency), c'est-à-dire le nombre de fois que le bug se manifeste si vous répétez les étapes indéfiniment.</td> - </tr> - <tr> - <td>Build Information</td> - <td>Rendez vous dans Paramètres > Informations > Plus d'informations et rajouter les informations suivantes au bug: Version du système, Numéro de compilation, Version de la plate-forme, Identifiant de version, Canal de mise à jour et Informations Git. (Si vous êtes sur un ordinateur de type Mac/Linux, avec adb et git installés, vous pouvez lancer <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/check_versions.py">ce script</a> et coller la sortie écran du script dans le bug.)</td> - </tr> - <tr> - <td>Screenshots</td> - <td>Veuillez attacher une capture d'écran qui pourra aider à analyser le bug. (Sur le téléphone de développement Flame, maintenir appuyés les boutons d'Allumage et de Volume bas simultanément à peu près 2 secondes jusqu’à ce que le téléphone affiche une notification de capture d'écran. Ensuite transférez l'image sur votre ordinateur en utilisant l'USB.)</td> - </tr> - <tr> - <td>Video</td> - <td>Si votre bug contient des changements à l'écran, difficilement captables via une capture d'écran, veuillez filmer une vidéo. Vous pouvez transférer le fichier en attachement du bug. Vous pouvez aussi transférer la vidéo sur YouTube et copier/coller le lien dans le bug.</td> - </tr> - <tr> - <td>ADB logs</td> - <td>Si adb est installé sur votre ordinateur, veuillez le connecter au téléphone et lancer la commande : - <pre class="brush: bash"> -adb logcat</pre> - Veuillez joindre la sortie d'écran de cette commande dans un fichier de type texte et le joindre au bug.</td> - </tr> - </tbody> -</table> - -<p>Les champs suivants sont optionnels :</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col"><strong>Champ</strong></th> - <th scope="col"><strong>Description</strong></th> - </tr> - </thead> - <tbody> - <tr> - <td>Depends/Block</td> - <td>Montre la dépendance entre les bugs.</td> - </tr> - <tr> - <td>Keywords</td> - <td>Mots-clés pour bugzilla. Les groupes spécifiques vont l'utiliser pour le suivi.</td> - </tr> - <tr> - <td>Whiteboard</td> - <td>Contient les tags. Ajoutez n'importe quel tag pour le suivi. Vous ne devriez pas supprimer les tags dans autres sans autorisation.</td> - </tr> - <tr> - <td>See Also</td> - <td>De temps en temps, deux problèmes sont liés et vous pouvez le spécifier ici.</td> - </tr> - <tr> - <td>Flags</td> - <td>Flags pour tracker les statuts ; le flag le plus utilisé dans les bugs Firefox OS est blocking-b2g. Si un bug est flaggé en tant que "blocking-b2g", cela signifie que nous devrions y consacrer plus d'attention car celui-ci menace de bloquer la sortie.</td> - </tr> - <tr> - <td>Security</td> - <td>Si un bug est relatif à la sécurité des données personnelles, à des pertes de profits et d'autres problèmes de ce genre, vous devriez cocher la case. Ainsi, cela ne sera visible que par les employés concernés.</td> - </tr> - </tbody> -</table> - -<p>Pour trouver plus d'informations sur les champs de bugzilla, vous pouvez regarder la page <a href="https://bugzilla.mozilla.org/page.cgi?id=fields.html">Bugzilla Fields</a> (EN) sur Bugzilla.</p> - -<h3 id="Ouvrir_des_bugs_de_traduction">Ouvrir des bugs de traduction</h3> - -<p>Lorsque vous rencontrez une phrase non traduite, cela peut vouloir dire deux choses :</p> - -<ul> - <li>Le traducteur n'a pas traduit la phrase. N'ouvrez pas de bug dans ce cas !</li> - <li>Le traducteur ne peut pas traduire la phrase suite à un problème de traduction automatique (l12y). Veuillez ouvrir un bug dans ce cas.</li> -</ul> - -<h4 id="Comment_déterminer_les_bugs_de_traduction_automatique_(l12y)">Comment déterminer les bugs de traduction automatique (l12y)</h4> - -<ol> - <li>Dans Firefox OS, allez dans Paramètres > Informations > Plus d'informations et activez le Menu développeurs.</li> - <li>Allez dans Paramètres > Développeurs et cochez Pseudo-localization.</li> - <li>Allez dans Paramètres > Langue et défilez vers le bas pour choisir anglais accentué.</li> - <li>Regardez de nouveau la phrase non traduite. Si celle-ci apparaît en anglais normal et non en anglais accentué, il paraît plus probable que cela soit causé par un problème de traduction automatique (l12y).</li> - <li>Dans Bugzilla, ouvrez un bug pour le produit (<em>product</em>) 'Firefox OS'. Choisissez le composant (<em>Component</em>) pour lequel la phrase non traduite apparaît. Ajoutez 'l12y' dans le champ Mots-clés (<em>Keyword</em>).</li> - <li>Veuillez remplir tous les champs obligatoires.</li> -</ol> - -<h3 id="Mots-clés_fréquemment_utilisés">Mots-clés fréquemment utilisés</h3> - -<p>Le tableau qui suit décrit les différents mot-clés que vous pourrez trouver pour les bugs Firefox OS.</p> - -<p>Vous devez toujours indiquer, les Versions/Systèmes/Plate-forme(s) utilisés pour vérifier le bug, dans les commentaires du bug, avant de changer le <em>Status</em> à <em>Verified</em>. Si les bug est ouvert pour plusieurs plate-formes, et que vous n'avez qu'une plate-forme pour le tester, faites le test, nottez dans le bug, mais ne changez surtout pas le <em>Status</em> à <em>Verified</em>. Toutes les plate-formes doivent être testées avant de changer le <em>Status</em> à <em>Verified</em>.</p> - -<p>Enfin, si d'autres bugs sont marqués comme doublon (<em>duplicate</em>) du bug que vous vérifiez, assurez vous de les tester et de le mentionner aussi. Souvent des développeurs signalent comme doublon, des bugs qui sont similaires mais pas identiques, et ceux-ci peuvent être oubliés si non testés.</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col"><strong>Mot-clé</strong></th> - <th scope="col"><strong>Description</strong></th> - </tr> - </thead> - <tbody> - <tr> - <td>meta</td> - <td>Indique que ce bug est un bug de suivi. Mozilla utilise cette étiquette pour suivre plusieurs bugs ou les différentes implémentations nécessaires à un scénario d'utilisation. Les développeurs ne sont pas censés apporter de correctifs pour ce type de bug (mais pour les bugs qui le composent). Il faut garder à l'esprit que ces meta-bugs sont utilisés par les chefs de projets et les équipes de qualité pour le suivi.</td> - </tr> - <tr> - <td>qablocker</td> - <td>Utilisé pour des bugs qui bloquent la possibilité de faire des tests (manuels ou automatiques) et qui doivent être corrigés pour la prochaine Beta ou version.</td> - </tr> - <tr> - <td>qawanted</td> - <td>Utilisé pour des bugs pour lesquels on souhaite avoir plus d'informations, pouvoir les reproduire, identifier le scénario, ou indiquer qu'ils sont dupliqués (au cas où on n'a pas trouvé le bug original). Le champ whiteboard contient une étiquette pour le progrès de l'équipe qualité sur ce point. Le mot-clé qawanted doit être retiré une fois ce travail terminé.</td> - </tr> - <tr> - <td>regression</td> - <td>Indique que le problème avait été réglé précédemment mais est survenu à nouveau (une régression logicielle). Le bug en question étant un nouveau bug permettant d'indiquer qu'il y a eu une régresion. Ce type de bug peut également faire référence aux problèmes non-identifiés dans les vérifications et dans les <a href="http://en.wikipedia.org/wiki/Smoke_testing_%28software%29"><em>smoke tests</em></a>, qui se produisent dans les versions compilées actuelles mais qui ne se produisaient pas avant. Suivre ces bugs permet d'identifier les points qui sont fragiles et dont les tests devraient être améliorés/augmentés.</td> - </tr> - <tr> - <td>regressionwindow-wanted</td> - <td>Indique que le bug est une régression et qu'il serait utile de connaître à partir de quand (et éventuellement jusqu'à quand) le bug s'est produit. Cela permet d'aider à identifier le code qui a pu introduire la régression.</td> - </tr> - <tr> - <td>steps-wanted</td> - <td>Indique un bug pour lequel les étapes de reproduction n'ont pas été suffisamment détaillées ou expliquées. On souhaite que quelqu'un identifie précisément les étapes pour reproduire le bug.</td> - </tr> - <tr> - <td>verifyme</td> - <td>Signifie que ce bug peut être vérifié avec la dernière version de B2G par quelqu'un d'autre que la personne de l'équipe qualité indiquée. Ce bug nécessite une configuration matérielle spécifique, indiquée pour vérifier la correction. Il faut alors tenter de reproduire le bug, si la résolution est effective (<em>Fixed</em> est correct), il faut marquer le <em>Status</em> à <em>Verified</em>.<br> - <br> - Dans les commentaires du bug et avant de changer le statut à <em>Verified</em>, veillez à toujours indiquer la version (build), le système d'exploitation et la plate-forme utilisés pour vérifier le bug. Si le bug est indiqué sur trois plates-formes et qu'il en reste une à vérifier, vous pouvez ajouter un commentaire dans le bug avec ces informations mais pas le marquer comme vérifié. Toutes les plates-formes doivent être testées avant de passer le statut d'un bug à <em>Verified</em>.<br> - <br> - Enfin, si d'autres bugs ont été identifiés comme des duplicata du bug que vous vérifiez, assurez vous également de vérifier ces bugs et de les commenter. Souvent, des développeurs indiquent des bugs liés (mais pas identiques) comme duplicatas, ce qui fait que ces derniers sont parfois sous-estimés pour la vérification.</td> - </tr> - <tr> - <td>crash</td> - <td>Ajouté ce mot-clé si vous rencontrez un crash dans Firefox OS.</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations sur la gestion des bugs lors du développement de Gaia, lire la page <a href="/fr/Firefox_OS/Developing_Gaia/Submitting_a_Gaia_patch">soumettre un correctif (patch) pour Gaia</a>.</p> -</div> - -<h3 id="Voir_aussi">Voir aussi</h3> - -<ul> - <li><a href="http://tech.mozfr.org/post/2013/04/23/Rapporter-un-bogue-sur-Bugzilla">Rapporter un bogue sur Bugzilla</a> (traduction d'un article de Liz Henry)</li> -</ul> diff --git a/files/fr/archive/b2g_os/developing_gaia/apporter_modifications_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/apporter_modifications_gaia/index.html deleted file mode 100644 index a144a068de..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/apporter_modifications_gaia/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: Apporter des modifications au code de Gaia -slug: Archive/B2G_OS/Developing_Gaia/Apporter_modifications_Gaia -tags: - - B2G - - Contributing - - Firefox OS - - Gaia - - GitHub - - Guide - - code changes -translation_of: Archive/B2G_OS/Developing_Gaia/Making_Gaia_code_changes ---- -<div class="summary"> -<p><span class="seoSummary">Maintenant que vous pouvez lancer Gaia dans Firefox et que vous connaissez certains éléments sur le fonctionnement du code, vous devriez pouvoir commencer à contribuer au projet. Cet article décrit comment apporter des modifications et où trouver des bugs sur lesquels travailler.</span></p> -</div> - -<h2 id="Bonnes_pratiques_Git">Bonnes pratiques Git</h2> - -<ol> - <li>Quand vous apportez des modifications au code de Gaia, la première chose à faire est de se mettre à jour par rapport à la branche <code>master</code> du dépôt original (<em>remote</em> <code>upstream</code>) : - - <pre class="brush: bash">cd chemin/dossier/gaia -git checkout master -git pull upstream master</pre> - </li> - <li>Maintenant, allez sur une nouvelle branche en faisant un « <em>checkout</em> », c'est sur cette branche que vous apporterez vos corrections : - <pre class="brush: bash">git checkout -b mon-correctif</pre> - </li> - <li>Enfin, allez dans votre répertoire <code>gaia/apps</code> et éditez les fichiers des applications.</li> -</ol> - -<h2 id="Exemple_de_modification_simple_du_code">Exemple de modification simple du code</h2> - -<p>Pour voir les effets de vos modifications :</p> - -<ol> - <li>Réalisez vos changements souhaités dans le code de Gaia, et sauvegardez les.</li> - <li>Arrêtez Firefox ou le simulateur lancé dans WebIDE.</li> - <li>Reconstruisez le profil Gaia avec la commande <code>make</code>.</li> - <li>Démarrez Firefox ou le simulateur lancé dans WebIDE.</li> -</ol> - -<p>Voyons cela en réalisant un simple changement de couleur de texte, de l'horloge dans l'écran de verrouillage :</p> - -<p><img alt="Gaia lockscreen showing the clock display in white text" src="https://mdn.mozillademos.org/files/7929/gaia-lockscreen-clock.png" style="display: block; height: 623px; margin: 0px auto; width: 369px;"></p> - -<ol> - <li>Une des meilleures méthodes pour trouver comment le style est défini est d'utiliser les outils de développement. Effectuez un « Ctrl droit + clic » sur l'horloge dans Firefox (pour ordinateur) puis sélectionnez <em>Examiner l'élément</em> dans le menu contextuel.</li> - <li>Vous pouvez alors déterminer quel fichier CSS est utilisé et doit être édité. Pour cet exemple, il s'agit de <code>gaia/apps/system/lockscreen/style/lockscreen.css</code>. Il suffit d'éditer les styles CSS dans la partie droite de l'affichage pour obtenir l'effet souhaité.</li> - <li>Une fois que vous êtes satisfait-e du résultat, vous pouvez directement éditer le fichier puis le sauvegarder.</li> - <li>Ensuite, rafraîchissez l'onglet (ou utiliser le bouton de réactualisation), le serveur HTTP servira instantanément les changements :</li> -</ol> - -<p><img alt="Gaia lockscreen showing the clock display modified from white to red text" src="https://mdn.mozillademos.org/files/7931/gaia-lockscreen-clock-modified.png" style="display: block; height: 622px; margin: 0px auto; width: 366px;"><br> - <br> - <br> - Les limitations de la simulation dans Firefox pour lancer Gaia :</p> - -<ul> - <li>Le rendu des applications est très proche du fonctionnement sur un appareil réel, vous pourrez cependant observer quelques différences.</li> - <li>Toutes les API matérielles ne sont pas supportées dans Firefox pour ordinateur. Vous pourrez trouver une liste de celles qui sont activées dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/preferences.js">preferences.js</a>.</li> -</ul> - -<h2 id="Où_trouver_des_bugs_à_corriger">Où trouver des bugs à corriger</h2> - -<p>La meilleure façon de trouver des bugs Firefox OS sur lesquels travailler est de consulter l'application de <a href="http://www.joshmatthews.net/bugsahoy/?b2g=1">Josh Matthews : Bugs Ahoy</a>. Cette application cherche directement parmi les bugs de la plate-forme Bugzilla de Mozilla et les affiche de façon simple et organisée. Une fois que vous avez identifié un bug sur lequel vous voulez travailler, rendez-vous sur la page Bugzilla pour ce bug (créez un compte si ce n'est pas déjà fait) puis assignez-vous pour le bug dans le champ « <em>assigned to</em> ». Une fois que c'est fait, vous pouvez commencer à travailler avec les outils vus ci-avant.</p> - -<h3 id="Aide_et_astuces">Aide et astuces</h3> - -<ul> - <li>Lorsque vous travaillez sur des bugs mentorés, un des membres de l'équipe en charge de Gaia surveillera votre progression et vous fournira l'aide nécessaire sur le code et le processus de correction. Si vous commencez à contribuer pour Firefox OS, ça peut être utile de choisir parmi ces bugs mentorés. Pour les trouver : ce sont les pages de bugs Firefox OS dont le champ « Mentor » est rempli. Buys Ahoy liste ces bugs mentorés.</li> - <li>Si vous êtes un nouvel utilisateur de Bugzilla, vous ne pourrez pas vous affecter vous-même le travail pour un bug. Si vous ne pouvez pas changer le champ « <em>assigned to</em> », demandez au mentor affecté à ce bug de vous l'affecter. Vous pouvez également le demander dans les commentaires du bug.</li> - <li>Une fois que vous avez acquis un peu plus d'expérience avec ce processus, n'hésitez pas à demander à quelqu'un de vous donner le droit de pouvoir vous affecter des bugs à vous-même.</li> - <li>Pour trouver des bugs simples à résoudre et commencer à contribuer, vous pouvez également chercher ceux qui ont une balise <code>[good first bug]</code> dans le champ « <em>whiteboard</em> ». Vous pouvez également lister les bugs simples grâce à Bugs Ahoy : <a href="http://www.joshmatthews.net/bugsahoy/?b2g=1&simple=1">http://www.joshmatthews.net/bugsahoy/?b2g=1&simple=1</a>.</li> - <li>Dans Bugzilla, vous pouvez enregistrer des recherches. Ainsi, si vous voulez suivre les bugs sur l'application Clock (l'horloge) de Gaia, vous pouvez sauvegarder la requête suivante :</li> -</ul> - -<p><a href="https://bugzilla.mozilla.org/buglist.cgi?columnlist=product%2Ccf_blocking_b2g%2Cbug_status%2Cresolution%2Cshort_desc&resolution=---&query_based_on=CLOCK&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Gaia%3A%3AClock&product=Boot2Gecko&known_name=CLOCK&list_id=10497922">https://bugzilla.mozilla.org/buglist.cgi?columnlist=product%2Ccf_blocking_b2g%2Cbug_status%2Cresolution%2Cshort_desc&resolution=---&query_based_on=CLOCK&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Gaia%3A%3AClock&product=Boot2Gecko&known_name=CLOCK&list_id=9776392</a></p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://mozilla.app.box.com/s/wzgsb3lkqglv0dnfdgzs">Les spécifications de Gaia pour les visuels et l'interaction utilisateur</a></li> - <li><a href="https://etherpad.mozilla.org/gaia-meeting-notes">L'Etherpad pour la réunion hebdomadaire sur Gaia</a></li> - <li><a href="https://datazilla.mozilla.org/">Datazilla </a>: L'utilitaire de Mozilla pour les tests de performance</li> -</ul> diff --git a/files/fr/archive/b2g_os/developing_gaia/bases_système_construction_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/bases_système_construction_gaia/index.html deleted file mode 100644 index 259c0a7747..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/bases_système_construction_gaia/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: Éléments de base sur le système de construction de Gaia -slug: Archive/B2G_OS/Developing_Gaia/Bases_système_construction_Gaia -tags: - - Build documentation - - Building - - Firefox OS - - Gaia - - Guide -translation_of: Archive/B2G_OS/Developing_Gaia/Build_System_Primer ---- -<div class="summary"> -<p>Cet article illustre<span class="seoSummary">comment fonctionne le système de construction (ou <em>build</em>) de Gaia. Cela inclue le fichier makefile, le processus de construction, les variables d'environnement et les éventuelles personnalisations</span>.</p> -</div> - -<p>Le travail le plus important durant les étapes de construction est effectué par les scripts contenus dans le sous-répertoire <code>build/</code> de Gaia, qui sont exécutés grâce à make, node.js et <a href="/fr/docs/xpcshell" title="https://developer.mozilla.org/en-US/docs/XPConnect/xpcshell">XPCShell</a> (aussi appelé JS Shell), qui est un environnement d'exécution de <a href="/fr/docs/XULRunner">XULRunner</a>. Le système de construction de Gaia contient plusieurs utilitaires pour aider à installer, tester, localiser et empaqueter les applications web sur un vrai appareil. Il permet également aux développer de personnaliser et d'adapter Gaia (par exemple en changeant le fond d'écran par défaut, les sonneries, les applications et les réglages).</p> - -<div class="note"> -<p><strong>Note </strong>: XPCShell est proche de node.js mais permet de lancer un langage de script de Mozilla proche de JavaScript. Il permet aux scripts de construction de Gaia d'être lancés dans une extension Firefox.</p> -</div> - -<h2 id="Le_fichier_makefile">Le fichier makefile</h2> - -<p>Le fichier makefile est composé de plusieurs buts (<em>goals</em>). Cette section explique les buts les plus utiles.</p> - -<h3 id="install-gaia">install-gaia</h3> - -<p>Ce but enverra toutes les applications Gaia sur votre appareil. Si vous souhaitez n'envoyer qu'une application en particulier, vous devrez utiliser le drapeau (<em>flag</em>) <code>APP</code> comme suit :</p> - -<pre class="brush: bash">APP=calendar make install-gaia</pre> - -<p>Ce répertoire doit être présent au sein d'un des répertoires de Gaia pour les applications (ex : <code>apps</code>).</p> - -<h3 id="reset-gaia">reset-gaia</h3> - -<p>Ce but fonctionne de la même façon que <code>install-gaia</code> mais commence par purger puis remet les permissions par défaut après avoir installé toutes les applications. Les applications seront situées sous <code>/data/local</code> (comme lorsque Gaia est construit en mode <em>engineering</em>). Cela enverra également les tests et les applications de débogage.</p> - -<div class="warning"> -<p><strong>Attention :</strong> Si vous utilisez la variable d'environnement <code>APP</code> avec <code>reset-gaia</code>, cela pourra fonctionner mais rendra l'appareil inutilisable (ce qui peut être résolu en lançant le même but sans la variable <code>APP</code>). À ne pas faire.</p> -</div> - -<h3 id="production">production</h3> - -<p>Ce but correspond à <code>reset-gaia </code>avec une optimisation du source code. Ce but permet généralement d'émuler les versions communiquées aux utilisateurs (<em>user builds</em>). Il enverra les mêmes applications qui sont installées pour les versions communiquées aux utilisateurs.</p> - -<div class="warning"> -<p><strong>Attention :</strong> Si vous utilisez la variable d'environnement <code>APP</code> avec <code>reset-gaia</code>, cela pourra fonctionner mais rendra l'appareil inutilisable (ce qui peut être résolu en lançant le même but sans la variable <code>APP</code>). À ne pas faire.</p> -</div> - -<h3 id="reference-workloads">reference-workloads</h3> - -<p>Ces buts envoient des volumes de données de différentes tailles sur l'appareil, aidant ainsi à déboguer et à corriger les problèmes de montées en charge. Ces buts gèrent la variable d'environnement APP ou une variable d'environnement APPS qui contient les noms d'applications séparées par des espaces :</p> - -<pre class="brush: bash">APP=sms make reference-workload-light -APPS="sms communications/contacts" make reference-workload-heavy -</pre> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations, lire <a href="/fr/Firefox_OS/Developing_Gaia/make_options_reference#Reference_Workloads">Bidouiller Gaia : les charges de données de référence</a>.</p> -</div> - -<h2 id="Les_variables_d'environnement">Les variables d'environnement</h2> - -<p>Certaines variables d'environnement permettent de contrôler certains aspects de la construction et de l'installation sur l'appareil. Par exemple :</p> - -<h4 id="P1">P=1</h4> - -<p>Celà active la compilation en parallèle dans le but de tirer avantage des processeurs multi-coeurs, et d'accélérer le temps nécessaire à une compilation. La valeur par défaut est <strong>0</strong>.</p> - -<div class="warning"> -<p><strong>Attention</strong>: La compilation en parallèle est une fonctionnalité expérimentale qui peut se révéler instable.</p> -</div> - -<h4 id="GAIA_OPTIMIZE1">GAIA_OPTIMIZE=1</h4> - -<p>Cela déclenche une passe d'optimisation des fichiers JavaScript. Cette optimisation a lieu de façon automatique lorsqu'on utilise <code>make production</code>. Cela peut également être utilisé pour <code>install-gaia</code> ou <code>reset-gaia</code>.</p> - -<h4 id="PRODUCTION1">PRODUCTION=1</h4> - -<p>Cette variable est un alias pour <code>make production</code>.</p> - -<h4 id="DEBUG1">DEBUG=1</h4> - -<p>Cette variable vous permet de générer un profil de débogage à utilliser pour les <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Gaia_unit_tests" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Gaia_unit_tests">tests unitaires</a> de Gaia ou lorsque vous développer votre application Firefox OS dans Firefox. Vous devez supprimer le profil existant avant d'essayer d'en générer un nouveau.</p> - -<h4 id="DEVICE_DEBUG1">DEVICE_DEBUG=1</h4> - -<p>Cette variable désactive l'écran de vérouillage de l'appareil.</p> - -<h4 id="GAIA_DEVICE_TYPEphone">GAIA_DEVICE_TYPE=phone</h4> - -<p>Cette variable vous permet de construire différemment en fonction du type d'appareil avec une 'app.list' différente. Tous les fichiers 'app.list' sont situés sous les dossiers /build/config/$(GAIA_DEVICE_TYPE)/ .</p> - -<p>Par défaut, la valeur de GAIA_DEVICE_TYPE est <strong>phone</strong> (pour un téléphone).</p> - -<div class="note"> -<p><strong>Note </strong>: Pour plus de détails et d'options, voir le guide <a href="/fr/Firefox_OS/Developing_Gaia/make_options_reference">Bidouiller Gaia : options de make</a>.</p> -</div> - -<h2 id="Processus_de_construction">Processus de construction</h2> - -<p>Voici un diagramme de séquence de la construction de Gaia :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/8635/gaia-build-system-seq-diagram.png" style="height: 1497px; width: 2222px;"></p> - -<p>pre-app.js, app.js et post-app.js seront exécutés par le Makefile les tâches de constructions ont, pour la plupart, lieu dans des scrips xpchsell, le fichier Makefile est utilisé pour détecter le système d'exploitation et pour télécharger b2g-desktop. Pour la suite, il est prévu qu'il y ait des tâches qui soient exécutées par des scripts xpcshell plutôt que par le Makefile.</p> - -<p>Si vous vous demandez pourquoi il y a les scripts pre-app, app et post-app : c'est parce que nous migrons des dépendances du Makefile vers les scripts xpcshell. C'est pourquoi nous avons créé pre-app.js et post-app.js pour le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1021051" title="FIXED: Merge build script for a faster build system">bug 1021051</a> afin de déplacer la plupart des dépendances sur les scripts xpcshell. Au final, app.js, pre-app.js et post-app.js seront fusionnés avec le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1053703" title="FIXED: Merge pre-app.js, app.js and post-app.js to one javascript file">bug 1053703</a>.</p> - -<p>Il existe trois types de répertoires utilisés pour le système de construction de Gaia :</p> - -<ol> - <li>les répertoires sources : apps, dev_apps qui sont des répertoires partagés</li> - <li>le répertoire d'étape (<em>stage directory</em>) : build_stage</li> - <li>les répertoires de profil : profile, profile-debug ou profile-test</li> -</ol> - -<p>Notre objectif est de ne générer aucun fichier dans les répertoires sources. Malheureusement, certains des modules génèrent des fichiers dans les répertoires sources, ce qu'il est prévu de corriger. Voici un tableau qui illustre quels modules génèrent des fichiers dans les dossiers sources, le dossier d'étape et/ou les dossiers de profil :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/8653/file-accessing.png" style="height: 1250px; width: 1136px;"></p> - -<p>Voici les règles exécutées (et l'ordre dans lequel elles le sont) lorsque la construction est lancée depuis le répertoire de Gaia :</p> - -<ol> - <li><strong>b2g_sdk</strong> : b2g-desktop est utilisé pour lancer les scripts xpcshell contenus dans <code>GAIA_DIR/build/</code>.</li> - <li><strong>svoperapps </strong>: on télécharge les applcations et on génère les fichiers de configuration pour l'installation des applications, par opérateur téléphonie et par pays.</li> - <li><strong>webapp-manifests</strong> : on génère des méta-données sur les applications web pour le processus de construction.</li> - <li><strong>keyboard-layouts</strong> : on génère l'agencement par défaut du clavier.</li> - <li><strong>settings.json (settings.js)</strong>: ce fichier JavaScript génère les paramètres par défaut pour Firefox OS, qui sont lus par Gaia.</li> - <li><strong>webapp-shared</strong> : on copie les fichiers des répertoires partagés qui sont utilisés pour chaque application vers le répertoire d'étape.</li> - <li><strong>preferences</strong> : on génère les réglages utilisateurs par défaut pour Firefox OS ; cela génèrera un fichier <code>user.js</code>, l'enverra sur l'appareil afin qu'il soit lu par Gecko. Les valeurs peuvent être différentes en fonction des variables d'environnement (par exemple avec <code>DEBUG=1</code>).</li> - <li><strong>app.js</strong> : les fichiers de construction du répertoire <code>app</code> sont exécutés s'ils existent. Pour chaque application, s'il n'y a pas de fichier Makefile pour l'application, le fichier Makefile de Gaia copiera le répertoire de l'application dans <code>build_stage</code> puis exécutera <code>[app-directory]/build/build.js</code> s'il existe. Voir<a href="#Script_de_construction_pour_les_applications">Script de construction pour les applications</a> pour plus d'informations.</li> - <li><strong>test-agent-bootstrap & test-agent-config</strong> : la préparation des agents de test est divisée en deux règles <code>test-agent-config</code> et <code>test-agent-bootstrap-apps</code>, ces règles permettent de paramétrer des environnements de test pour chaque application.</li> - <li><strong>webapp-optimize</strong> : Ce script contient diverses procédures d'optimisation comme la minification du JavaScript, la concaténation des fichiers de localisation en fichiers JSON, la génération de fichiers HTML dans la langue par défaut (si nécessaire).</li> - <li><strong>webapp-zip</strong> : On compresse chaque application dans un fichier zip distinct puis on les place dans le répertoire <code>profile/</code>.</li> - <li><strong>optimize-clean </strong>: <code>optimize-clean</code> nettoie les fichiers HTML pour la langue par défaut.</li> - <li><strong>contacts </strong>: Copie le fichier de contacts pré-chargé dans le profil, s'il existe dans <code>GAIA_DISTRIBUTION_DIR</code>.</li> - <li><strong>extensions </strong>: Copie les extensions (contenues dans <code>GAIA_DIR/tools/extensions</code>) dans votre répertoire de profil. Suivant les configurations utilisées, vous pouvez définir quelles extensions sont copiées.</li> - <li><strong>installed-extensions.json (additional-extensions.js)</strong> : Enfin, ce script télécharge certaines extensions supplémentaires dans votre répertoire de profil.</li> -</ol> - -<h2 id="Script_de_construction_pour_les_applications">Script de construction pour les applications</h2> - -<p>Par défaut, le script de construction de l'application <span style="font-family: courier new,andale mono,monospace; line-height: 1.5;">[répertoire app]/build/build.js</span><span style="line-height: 1.5;"> sera exécuté par app.js </span><span style="line-height: 1.5;">si le script de construction existe. Si <code>$APP/build/build.js</code> n'existe pas, app.js copiera l'application dans <code>build_stage</code>.</span></p> - -<p>Les fichiers contenus dans le répertoire de l'application devrait être copiés dans le répertoire d'étape <code>build_stage</code> par le script de construction de l'application s'il existe. En effet, si le script existe, app.js ne copiera pas les fichiers. Par exemple, l'application du calendrier (<em>calendar</em>) possède un script <code>build/build.js</code> et fait appel à <a href="https://github.com/mozilla-b2g/gaia/blob/a0fa29db8e9e15afe3b1787bf494caa86a033f10/apps/calendar/build/build.js#L8">utils.copyToStage()</a>.</p> - -<div class="note"> -<p><strong>A noter</strong>: Pour les sources qui se trouvent en dehors de l'application (comme dans shared/), il faut les mettre dans un noeud commenté dans la section <head> de index.html, afin que ce soit copié de shared/ vers l'application.</p> -</div> - -<p>Les scripts de constructions des applications peuvent requérir n'importe quel module construit dans <code>$GAIA_DIR/build</code>, en particulier le module <code>utils</code> qui est très utile pour la construction des applications. Vous pouvez ainsi utiliser <code>require('utils')</code> pour bénéficier du module.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/8651/flow-diagram.png" style="height: 952px; width: 1004px;"></p> - -<h2 id="Personnaliser_les_réglages_utilisateurs">Personnaliser les réglages utilisateurs</h2> - -<p>Si vous avez un ensemble de préférences utilisateur que vous utilisez à chaque fois que vous chargez (flashez) l'appareil, vous pouvez créer un fichier appelé <code>custom-prefs.js</code> dans le répertoire <code>build/config</code> et les stocker à cet emplacement. Cela évite que les préférences soient écrasées et en dehors du gestionnaire de versions (<em>source control</em>).</p> - -<p>Voici quelques réglages utilisateurs qui peuvent être utiles :</p> - -<pre class="brush: js">// on permet à marionette de lancer les tests de performance -// voir https://developer.mozilla.org/fr/docs/Mozilla/Firefox_OS/Platform/Testing/Gaia_performance_tests -user_pref("marionette.defaultPrefs.enabled", true); - -// on définit le port à utiliser pour déboguer l'application à distance sur l'appareil -user_pref("devtools.debugger.remote-port", 60000); - -// on active le débogueur à distance -user_pref("devtools.debugger.remote-enabled", true); - -// on affiche les informations de debug sur le Radio Interface Layer dans logcat -user_pref("ril.debugging.enabled", true); -</pre> - -<p>Ce fichier est lu à chaque fois que vous générez un profil. La façon la plus certaine d'être sûr que tout soit généré est de commencer par supprimer votre profil :</p> - -<pre class="brush: bash">rm -rf profile && make profile</pre> - -<p>Vous pouvez ensuite utiliser le but <code>install-gaia</code> sans danger.</p> - -<h2 id="FAQ">FAQ</h2> - -<h3 id="L'appareil_reste_avec_l'écran_noir_après_avoir_été_flashé">L'appareil reste avec l'écran noir après avoir été flashé</h3> - -<p>Ceci peut parfois arriver si vous flashez l'appareil lorsqu'il est en veille. Pour régler le problème, il suffit de redémarrrer B2G en utilisant la ligne de commande suivante :</p> - -<pre class="brush: bash">adb shell stop b2g && adb shell start b2g</pre> - -<p><br> - </p> diff --git a/files/fr/archive/b2g_os/developing_gaia/comprendre_les_fondements_de_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/comprendre_les_fondements_de_gaia/index.html deleted file mode 100644 index 96f3026287..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/comprendre_les_fondements_de_gaia/index.html +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: Comprendre la structure du code de Gaia -slug: Archive/B2G_OS/Developing_Gaia/comprendre_les_fondements_de_Gaia -tags: - - Code - - Firefox OS - - Gaia - - Guide - - JavaScript - - contribution -translation_of: Archive/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase ---- -<div class="summary"> -<p><span class="seoSummary">Avant d'apporter vos modifications au <a href="https://github.com/mozilla-b2g/gaia/">code de Gaia</a>, vous devez d'abord comprendre les bases de sa structure et connaître les conventions de codage utilisées. Cet article couvre chacun de ces points.</span></p> -</div> - -<h2 id="Les_branches_de_Gaia">Les branches de Gaia</h2> - -<p>Il y a plusieurs branches différentes qui organisent le code source de Gaia, et en fonction de la tâche que vous cherchez à accomplir (ou de l'appareil que vous avez), vous ne voudrez pas seulement charger, modifier et compiler la branche master. Vous trouverez ici, une rapide explication, des branches les plus couramment utilisées :</p> - -<ul> - <li><strong>master</strong> - La dernière branche de développement. Vous voudrez utiliser cette branche, si vous développez (ou corrigez des bugs) sur des nouvelles fonctionnalités, ou que vous voulez lancer la dernière version de Gaia sur votre téléphone ou votre émulateur.</li> - <li><strong>v2.1</strong>, <strong>v2.0</strong>, <strong>v1.4</strong>, etc ... - Représentent des versions figées de Gaia 2.1, 2.0, 1.4, etc ... Vous voudrez utiliser ces branches si vous corrigez un bug sur une version spécifique de Gaia, ou que vous voulez développer une application et vous assurer que celle-ci supporte bien une version spécifique de Gaia. Par exemple, vous pourriez utiliser Firefox OS Building Blocks pour réaliser des modifications, et vous assurer que votre agencement soit toujours optimal sur les différentes versions de Gaia.</li> - <li><strong>v1.3t</strong> - La version basse consommation en mémoire de Gaia, développée pour fonctionner sur des périphériques ayant peu de mémoire, comme le Tarako ou le Spice Fire One. Si vous désirez développer une application pour un périphérique semblable, c'est la branche sur laquelle vous devrez être.</li> -</ul> - -<h2 id="La_structure_du_code_source_de_Gaia">La structure du code source de Gaia</h2> - -<p>La section qui suit présente les parties les plus importantes du code source de Gaia.</p> - -<h3 id="apps">apps/</h3> - -<p>Ce répertoire contient chacune des applications principales de Gaia, celles affichées sur l'écran d'accueil - comme le calendrier ou l'appareil photo - ainsi que celles sous-jacentes - comme celle du système, celle de l'écran d'accueil, ou celle du clavier.<br> - <br> - Les applications peuvent fonctionner de façon légèrement différente, mais ont toutes un certain nombre de points communs :</p> - -<ul> - <li><code>index.html</code> : le fichier principal de l'application</li> - <li><code>manifest.webapp</code> : le fichier de manifeste définissant l'application</li> - <li><code>locales</code> : les chaines de traduction pour l'application</li> - <li><code>test</code> : les tests unitaires et les tests d'intégration de l'application</li> - <li><code>js</code>, <code>style</code> : les scripts et les styles de l'application</li> - <li><code>resources</code> : les images, sons et autres ressources pour l'application</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: Vous pouvez trouver plus d'informations à propos du fonctionnement des applications dans notre <a style="line-height: 1.5;" href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps">guide</a><a href="/fr/Firefox_OS/Platform/Gaia/Gaia_apps"> des applications Gaia</a><span style="line-height: 1.5;">.</span></p> -</div> - -<h3 id="build">build/</h3> - -<p>Ce répertoire contient les scripts de construction (<em>build</em>).</p> - -<h3 id="dev_apps">dev_apps/</h3> - -<p>Ce répertoire contient les applications à inclure lors d'une construction faite sur mesure. Par exemple, vous pouvez ajouter des applications à cet emplacement pour produire des versions sur mesures qui contiennent ces applications.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations sur la personnalisation de Gaia, lire le <a href="/fr/Firefox_OS/Developing_Gaia/Market_customizations_guide">guide des personnalisations possibles (Market customizations)</a>.</p> -</div> - -<h3 id="keyboard">keyboard/</h3> - -<p>Ce répertoire contient les dictionnaires et agencements des claviers en fonction des différentes langues.</p> - -<h3 id="locales">locales/</h3> - -<p>Ce répertoire contient un fichier JSON, <code>languages_all.json</code>, qui définit les langues supportées dans Gaia. Pour plus d'informations sur la façon dont les applications sont localisées, lire l'article <a href="/fr/Apps/Build/Localization/Getting_started_with_app_localization">Comment localiser une application</a>.</p> - -<h3 id="shared">shared/</h3> - -<p>Ce répertoire contient diverses ressources utilisées par plusieurs applications. Les éléments les plus notables sont :</p> - -<ul> - <li><code>gaia/shared/js</code> : les bibliothèques JavaScript qui contiennent des fonctionnalités communes de base</li> - <li><code>l10n.js</code> : une bibliothèque de localisation qui permet de détecter la langue de l'appareil et de remplacer les chaînes de l'application par les chaînes trouvées dans les répertoires de locales des applications. Les chaînes à traduire doivent être placées dans des éléments HTML qui possèdent l'attribut<code> data-l10n-id</code>.</li> - <li><code>gaia/shared/locales </code>: Les ressources traduites pour les différentes locales.</li> - <li><code>gaia/shared/resources</code> : Les fichiers média communs tels que les icônes, les sonneries, les sons à utiliser pour l'alarme, etc.</li> - <li><code>gaia/shared/style</code> : les feuilles de style et les autres ressources de mise en forme pour les blocs de construction communs comme les boutons, barres de progressions, barres d'outils, onglets, etc.</li> - <li><code>gaia/shared/style_unstable</code> : ressources de mise en forme instables ou expérimentales.</li> - <li><code>gaia/shared/test </code>: le code JavaScript qui définit les tests d'intégration et les tests unitaires.</li> -</ul> - -<h3 id="tools">tools/</h3> - -<p>Ce répertoire contient les utilitaires nécessaires pour les scripts de construction (<em>build</em>) et les tests.</p> - -<h2 id="Les_conventions_de_style_utilisées_pour_le_code_de_Gaia">Les conventions de style utilisées pour le code de Gaia</h2> - -<p>Gaia suit les règles de style de <a href="http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml">Google pour le JavaScript</a> (en anglais).</p> - -<p>Informations générales sur les règles de code :</p> - -<ul> - <li><a href="/en-US/docs/Mozilla/Developer_guide/Coding_Style#General_practices">Pratiques générales</a></li> - <li><a href="/fr/docs/Mozilla/Developer_guide/Coding_Style#JavaScript_practices">Pratiques pour JavaScript</a></li> - <li><a href="/fr/docs/Mozilla/Developer_guide/Coding_Style#Naming_and_Formatting_code">Conventions de nommage et de formattage</a></li> -</ul> - -<h3 id="Règles_spécifiques">Règles spécifiques</h3> - -<ol> - <li>Assurez-vous que vos fichiers HTML soient déclarés avec <code><!DOCTYPE html></code> (autrement dit, qu'ils soient des documents HTML5). Si vous n'utilisez pas cette information, les versions Internet Explorer 9 et supérieures chargeront le site/application en mode de compatibilité.</li> - <li>Incluez l'instruction <code>"use strict";</code> (telle quelle, avec les doubles quotes) dans vos fichiers JavaScript afin qu'ils utilisent le mode strict.</li> - <li>Utilisez deux espaces pour l'indentation et non pas des tabulations.</li> - <li>Veuillez utilisez des sauts de ligne pour séparer les fragments logiques du code !</li> - <li>Les noms de fichiers composés de plusieurs termes doivent utiliser les tirets bas comme ceci <code>mon_fichier_avec_plusieurs_mot.js</code>.</li> - <li>Utilisez des quotes simples pour les chaînes de caractères (plutôt que des doubles quotes).</li> - <li>Utilisez des structures conditionnelles développées : - <pre class="brush: js">Incorrect -if (expression) faireQuelqueChose(); - -Correct -if (expression) { - faireQuelqueChose(); -}</pre> - </li> - <li>Si vous travaillez sur l'application <a href="/fr/Firefox_OS/Platform/Gaia/Gaia_apps/System">System</a>, vérifiez la liste <a href="https://groups.google.com/forum/#!msg/mozilla.dev.gaia/rEhSrw6XmT4/UNvE7qW9pgYJa">de conseils spécifiques</a>.</li> -</ol> - -<h3 id="Vérification_du_style_de_code_à_chaque_commit">Vérification du style de code à chaque commit</h3> - -<p>Gaia utilise <a href="http://www.jshint.com/">JSHint</a> pour vérifier le style de code JavaScript utilisé et ce avant chaque commit (via un « crochet » (<em>hook</em> en anglais) git). Une fois que vous avez soumis votre pull request sur le dépôt de Gaia. Le serveur Travis (l'intégration continue pour Github) lancera ce « <em>linter</em> » pour vérifier à nouveau que le style est correct.</p> - -<p>Le script de pre-commit est présent dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/tools/pre-commit">gaia/tools/pre-commit</a> et devrait être copié dans le répertoire <code>.git/hooks</code> du projet une fois que la commande <code>make</code> a été lancée.</p> - -<div class="note"> -<p><strong>Note</strong> : Auparavant, <a href="https://developers.google.com/closure/utilities/docs/linter_howto">gjslint</a> était utilisé pour cette vérification. Il a cependant été déprécié en faveur de jshint car celui-ci est plus strict et produit de meilleurs résultats. JSHint est utilisé depuis Firefox OS 1.4, et gjslint est uniquement recommandé pour les fichiers historiques qui n'ont pas encore été migrés vers JSHint.</p> -</div> - -<h3 id="Lancer_le_linting_manuellement_avec_Gaia">Lancer le <em>linting</em> manuellement avec Gaia</h3> - -<p>Avant de soumettre un correctif, il est conseillé de lancer JSHint manuellement en local afin de vérifier que vous n'avez pas d'erreurs de style dans votre code.<br> - <br> - Pour plus de détails sur JSHint dans Gaia, vous pouvez regarder le contenu du répertoire <a href="https://github.com/mozilla-b2g/gaia/tree/master/build/jshint">gaia/build/jshint</a>. Gaia fournit un script de construction que vous pouvez utiliser :</p> - -<pre class="brush: bash">$ make lint</pre> - -<p>pour lancer automatiquement les tests de gjslint et de JSHint. Vous pouvez également lancer uniquement :</p> - -<pre class="brush: bash">$ make hint</pre> - -<p>pour ne lancer que les vérifications effectuées par JSHint.</p> - -<pre class="brush: bash">$ make eslint</pre> - -<p>pour lancer uniquement la vérification de style eslint.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour installer JSHint sur votre installation, sans Gaia, vous pouvez utiliser les commandes suivantes :</p> - -<pre class="brush: bash">npm install jshint -g -jshint mon_fichier.js</pre> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/developing_gaia/different_ways_to_run_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/different_ways_to_run_gaia/index.html deleted file mode 100644 index 3f30dd2285..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/different_ways_to_run_gaia/index.html +++ /dev/null @@ -1,230 +0,0 @@ ---- -title: Différentes façons d'exécuter Gaia -slug: Archive/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia -tags: - - ADB - - Appareil - - Firefox - - Firefox OS - - Gaia - - Gaia+Gecko - - Mac OS X - - USB - - WebIDE - - bureau - - contribuer - - débogage - - exécuter Gaia - - nightly - - simulateur - - émulateur(2) -translation_of: Archive/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details open> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p><span class="seoSummary">Vous pouvez exécuter Gaia dans un simulateur via WebIDE, dans Firefox Mulet (une version spéciale de Firefox pour ordinateur destinée au développement Gaia), dans un émulateur ou sur un appareil mobile compatible. Cet article fournit un résumé pour réaliser chacun de ces cas, avec des liens vers des informations complémentaires.</span></p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Pour faire tourner Gaia sur ordinateur, la méthode actuellement recommandée consiste à utiliser Mulet (voir <a href="#Utiliser_Gaia_dans_Firefox_Mulet">Utiliser Gaia dans Firefox Mulet</a>, ci-dessous.)</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Parfois, vous serez confronté à des problèmes dûŝ à certaines de vos modifications qui nécessitent des paramètres de préférences actualisés etc. Si vous rencontrez ce genre de cas, essayez de regénérer votre profil pour voir si cela corrige le problème (lancez de nouveau la commande make).</p> -</div> - -<h2 id="À_quel_point_cela_est-il_proche_de_la_réalité">À quel point cela est-il proche de la réalité ?</h2> - -<p dir="ltr" id="docs-internal-guid-46d8bd5f-ac65-2c23-a6c9-cc3bc3dc3cd5">Certaines des solutions détaillées dans cet article pour exécuter Gaia sont plus proches que d'autres de l'expérience rencontrée avec un appareil réel. Dans l'ordre de facilité d'exécution :</p> - -<ol dir="ltr"> - <li>Gaia dans un Simulateur via WebIDE</li> - <li>Gaia dans Firefox Mulet</li> - <li>Gaia dans un Émulateur</li> - <li>Gaia flashé sur un téléphone</li> - <li>Gaia+Gecko flashés sur un téléphone</li> -</ol> - -<p>L'ordre de “À quel point cela est-il proche du produit commercialisé” est exactement l'opposé de cette liste. Selon la fonctionnalité sur laquelle vous travaillez, vous devrez trouver l'ennvironnement qui répond à la problématique posée.</p> - -<h2 id="Explication_des_options_de_make">Explication des options de make</h2> - -<p>Dans les sections ci-dessous sur WebIDE et Mulet, il vous est demandé de construire votre propre profil Gaia en utilisant la commande suivante :</p> - -<pre class="brush: bash">DEBUG=1 DESKTOP=0 make</pre> - -<ul> - <li>La partie <code>DEBUG=1</code> crée une version debug qui fait tourner Gaia en tant qu'applications hébergées sur un serveur web embarqué plutôt qu'avec les applications par défaut empaquetées qui doivent être ré-empaquetées à chaque modification. Ainsi, pour voir les changements, vous devez juste recharger l'application, ce qui est beaucoup plus efficace pour le débogage.</li> - <li>La partie <code>DESKTOP=0</code> doit être inclue parce que l'option <code>DEBUG=1</code> est accompagnée par défaut de l'option <code>DESKTOP=1</code> qui est cassée et doit donc être supprimée. Vous ne devriez plus avoir besoin de le faire à l'avenir.</li> -</ul> - -<p>Cela va construire votre profil dans un répertoire nommé <code>profile-debug</code>.</p> - -<p>Si vous souhaitez faire un test avec une version de production de Gaia pour davantage de réalisme, lancez seulement <code>make</code> pour construire votre profil. Celui-ci sera créé dans un répertoire nommé <code>profile</code>.</p> - -<div class="note"> -<p><strong>Note</strong> : Il existe tout un tas d'options make disponibles pour Gaia — voir la <a href="/fr/docs/B2G_OS/Developing_Gaia/Référence_options_make">référence des options make de Gaia</a> pour beaucoup plus de détails.</p> -</div> - -<h2 id="Utiliser_Gaia_dans_un_Simulateur_via_WebIDE">Utiliser Gaia dans un Simulateur via WebIDE</h2> - -<p>La méthode la plus rapide pour essayer Gaia est d'utiliser <a href="/fr/docs/Outils/WebIDE">WebIDE</a>, un outil développeur disponible dans Firefox pour ordinateur. Il apporte un certain nombre d'outils utiles pour vous aider à tester, déployer et déboguer des applications web HTML5 sur les téléphones Firefox OS et dans le Simulateur Firefox OS, directement à partir de votre navigateur.<br> - <br> - Dans le navigateur pour ordinateur Firefox 34+, ouvrez WebIDE via le menu <em>Outils > Développement web > WebIDE</em>. Ouvrez le menu Environnement en haut à droite pour installer et démarrer un Simulateur.</p> - -<p>Pour faire tourner votre propre profil Gaia personnalisé, le processus est un petit peu plus complexe, mais cela reste relativement simple :</p> - -<ol> - <li>Avant d'essayer de faire ça, il faut construire vous-même un profil d'appareil Gaia de debug — allez dans votre clone de dépôt Gaia puis lancez <code>DEBUG=1 DESKTOP=0 make</code>. Cela va générer dans votre répertoire <code>gaia</code> un dossier appelé <code>profile-debug</code>, contenant votre profil. Avec ce type de profil, vous serez en mesure de déboguer les applications internes de Gaia dans WebIDE sans avoir à configurer autre chose, et vous n'aurez pas à accepter la boîte de dialogue pour confirmer le débogage distant dans le simulateur à chaque fois que vous le lancerez. Si vous voulez faire des tests avec une version de production plus réaliste, lancez la construction avec uniquement la commande <code>make</code>.</li> - <li>Ouvrez Firefox (<a href="https://nightly.mozilla.org/">Nightly</a> est recommandé.)</li> - <li>Ouvrez WebIDE depuis <em>Outils > Développement web > WebIDE</em>.</li> - <li>Installez un Simulateur Firefox OS en allant dans <em>Choisir un environnement > Installer un Simulateur</em> dans WebIDE et en choisissant une option. Assurez-vous d'utiliser les mêmes versions de simulateur et du Gaia que vous faites tourner (ainsi par exemple, si votre branche Gaia est la 2.1, vous devrez utiliser le Simulateur Firefox OS 2.1.)</li> - <li>Dans le menu de droite, vous pouvez voir votre simulateur dans la liste. Cliquez sur le bouton options (engrenage) qui est juste à côté pour accéder à l' <a href="/en-US/docs/Tools/WebIDE/Setting_up_runtimes#Configuring_Simulators">écran des Options du Simulateur</a>.</li> - <li>Choisissez <em>Profil > Personnaliser profil Gaia...</em>, puis sélectionner le dossier de votre profil Gaia dans le sélecteur de fichiers.</li> - <li>Ouvrez ce simulateur dans WebIDE, et il devrait alors s'ouvrir avec votre profil Gaia en cours d'exécution.</li> -</ol> - -<div class="note"> -<p><strong>Note</strong> : Si la commande ne fonctionne pas (il est possible d'avoir un message affichant <em>"A copy of B2G is already open. Only one copy of B2G can be open at a time."</em> — alors qu'il n'est pas déjà ouvert), vérifiez alors que le répertoire de votre <code>profil dispose bien des permissions de lecture</code>/écriture, par exemple avec <code>chmod</code>.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Si vous souhaitez réinitialiser votre simulateur pour qu'il ne fasse plus tourner de profil Gaia personnalisé, vous aurez besoin d'aller dans Firefox sur <a href="/about:config">about:config</a> ; cherchez la préférence <code>extensions.fxos_2_2_simulator@mozilla.org.gaiaProfile</code> (2_2 peut être différent en fonction de la version du simulateur que vous avez personnalisée), double-cliquez dessus, supprimez la valeur dans la boîte de dialogue qui s'affiche puis cliquez sur OK.</p> -</div> - -<h2 id="Utiliser_Gaia_dans_Firefox_Mulet">Utiliser Gaia dans Firefox Mulet</h2> - -<p>Il est également possible d'exécuter Gaia dans une version spéciale de Firefox appelée Firefox Mulet. Cela donne l'avantage d'avoir un cycle de développement rapide, ainsi que des outils de développement web standards et des débogueurs pour travailler avec.</p> - -<ol> - <li>Tout d'abord, vous devez avoir cloné le dépôt <a href="https://github.com/mozilla-b2g/gaia">Gaia</a> sur votre machine (voir <a href="https://developer.mozilla.org/fr/docs/B2G_OS/Developing_Gaia/Faire_fonctionner_code_Gaia#Lancer_votre_compilation_de_Gaia">Lancer votre compilation de Gaia</a> pour voir la meilleure façon de le faire si vous voulez contribuer au projet.) Mulet ne fonctionnant que sur Gaia 2.2 et au-dessus, il est une bonne idée d'utiliser la branche master.</li> - <li>Ensuite, placez-vous dans le dépôt Gaia avec <code>cd</code> et construisez votre propre profil (voir <a href="/fr/docs/B2G_OS/Developing_Gaia/Référence_options_make">référence des options make</a> pour les différents types disponibles) avec <code>DEBUG=1 DESKTOP=0 make</code>. Si vous voulez faire des tests en utilisant une version de production plus réaliste, utilisez seulement la commande <code>make</code>.</li> - <li>Vous pouvez à présent installer la dernière version de mulet dans <code>gaia/firefox</code> grâce à la commande <code>make mulet</code>. Il s'agit de la méthode la plus rapide pour l'installer. - <ol> - <li>Si vous voulez avoir plus de contrôle sur l'endroit où installer mulet, vous devrez le télécharger vous-même — trouvez les builds Windows et Mac sur <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">Mozilla Central</a>, et <a href="https://tools.taskcluster.net/index/artifacts/#gecko.v1.mozilla-central.latest.linux.mulet/gecko.v1.mozilla-central.latest.linux.mulet.opt">regardez ici pour Linux</a>. Les builds Mulet sont les paquets dont les noms commencent par <code>firefox-*</code>, par exemple <code>firefox-36.0a1.en-US.mac64.dmg. </code>Les builds Linux sont nommés<code> target.linux-x86_64.tar.bz2</code> — choisissez la version appropriée à votre machine de développement.</li> - <li>Une fois le build Mulet téléchargé, installez-le en lieu sûr afin de ne pas écraser votre version de Firefox Nightly normale. Par exemple, sur Mac OS X, créez un nouveau dossier dans Applications appelé "mulet", et faîtes-le glisser dedans.<span id="cke_bm_93E" style="display: none;"> </span></li> - </ol> - </li> - <li>Lancez maintenant le build Mulet à partir de la ligne de commande, en lui passant votre profil Gaia comme profil à utiliser lors de l'ouverture (spécifié par l'option <code>-profile</code>.) Par exemple, vous pouvez lancer quelque chose de ce genre depuis l'intérieur de votre dossier Applications sur Mac OS X si vous l'avez installé là : - <pre class="brush: bash">./firefox/Contents/MacOS/firefox-bin -no-remote -profile /Users/my-home-folder/git/gaia/profile-debug/</pre> - </li> -</ol> - -<p>Le build Mulet résultant devrait apparaître, comme ceci :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/9467/mulet-screenshot.png" style="display: block; height: 491px; margin: 0px auto; width: 800px;"></p> - -<div class="note"> -<p><strong>Note </strong>: Si la commande ne fonctionne pas (il est possible d'obtenir un message disant <em>"A copy of Firefox is already open. Only one copy of Firefox can be open at a time."</em> — alors qu'il n'est pas déjà ouvert), alors vérifiez que vous avez le droit de lancer l'exécutable <code>firefox</code> comme ça — vous pouvez lancer la commande ci-dessus en plaçant <code>sudo</code> devant, bien qu'une meilleure solution, plus sûre,consiste à faire un <code>chmod</code> sur votre dossier d'installation.</p> -</div> - -<div class="note"> -<p><strong>Note :</strong> Les nouvelles versions de Gaia ont parfois besoin d'une version de mulet plus récente ; pour faire la mise à jour vers la dernière version de mulet, vous pouvez lancer la commande <code>rm -rf firefox && make mulet</code> dans le répertoire <code>gaia/</code>.</p> -</div> - -<p>Sur cet affichage, vous avez de disponible la <a href="https://developer.mozilla.org/fr/docs/Outils/Outils_boite_à_outils">boîte à outils</a> standard de Firefox afin de déboguer vos applications Gaia, plus un émulateur Firefox OS fonctionnant dans la partie gauche, ainsi qu'un certain nombre d'autres outils utiles à l'environnement Gaia. Les contrôles au-dessus de l'émulateur vous permettent de :</p> - -<ul> - <li>Choisir différentes tailles d'écran pour l'émulateur (il s'agit en fait d'une <a href="/fr/docs/Outils/Vue_adaptative">vue adaptative</a>).</li> - <li>Faire pivoter l'écran de l'émulateur.</li> - <li>Activer ou désactiver la simulation des évenements tactiles (si désactivée, vous ne pouvez pas utiliser la souris pour faire glisser l'UI et les applications ouvertes.)</li> - <li>Prendre des captures d'écran.</li> -</ul> - -<h2 id="Flasher_Gaia_sur_un_véritable_appareil">Flasher Gaia sur un véritable appareil</h2> - -<div class="warning"> -<p><strong>Important </strong>: Si vous tentez de flasher Gaia sur un appareil doté de peu de mémoire, comme un Tarako ou un Spice Fire One, vous devez le flasher avec une branche de Gaia spéciale optimisée pour les faibles quantités de mémoire, comme la <a href="https://github.com/mozilla-b2g/gaia/tree/v1.3t">branche 1.3t</a>. Essayer de flasher un tel appareil avec la branche principale de Gaia va probablement avoir pour résultat de rendre le téléphone inopérant.</p> -</div> - -<p dir="ltr" id="docs-internal-guid-46d8bd5f-ac6a-0884-5265-76e0fe740fa6">Pour flasher une nouvelle version de Gaia sur un vrai appareil :</p> - -<ol dir="ltr"> - <li>Assurez-vous d'abord d'avoir cloné le dépôt Gaia sur votre ordinateur et d'avoir installé <a href="/fr/docs/B2G_OS/Déboguer/Installer_ADB">ADB</a>.</li> - <li>Vérifiez d'avoir activé le <a href="/fr/docs/B2G_OS/Déboguer/Les_paramètres_développeurs#Débogage_via_USB">Débogage via USB</a>.</li> - <li>Branchez votre appareil sur votre ordinateur en USB.</li> - <li>S'il y a un appareil détecté, vous pouvez procéder aux commandes suivantes. Sinon, vous (utilisateur de Windows ou de distribution Linux) pouvez avoir à vérifier la page des Pilotes OEM USB pour correctement configurer le pilote USB de votre ordinateur.</li> - <li>Pour de véritables appareils, lancez adb en tant qu'utilisateur root en utilisant la commande suivante : - <pre class="brush: bash">$ adb root</pre> - </li> - <li>Lancez la commande suivante à l'intérieur du dépôt Gaia pour réinitialiser votre téléphone et mettre à jour votre code source de Gaia : - <pre class="brush: bash">$ make reset-gaia</pre> - </li> - <li>Pour tester des applications non-systèmes, vous pouvez les installer sans redémarrer l'appareil grâce à la commande suivante : - <pre class="brush: bash" dir="ltr">$ make install-gaia</pre> - </li> - <li>Si vous souhaitez installer une application spécifique unique, vous pouvez la passer via la variable APP comme ceci : - <pre class="brush: bash">$ make install-gaia APP=browser</pre> - </li> -</ol> - -<div class="note"> -<p dir="ltr"><strong>Note </strong>: Envoyer Gaia sur votre appareil en utilisant <code>make install-gaia</code> / <code>make reset-gaia</code> construit Gaia avec une définition de résolution 1x par défaut. Pour spécifier une résolution supérieure, vous devez utiliser les options de make <code>GAIA_DEV_PIXELS_PER_PX</code> ou <code>GAIA_DPPX</code> (voir <a href="/fr/docs/B2G_OS/Developing_Gaia/Référence_options_make#Ressources_images_en_haute_résolution">Ressources images en haute résolution</a> pour davantage d'informations sur ces options.) Lors de l'envoi de Gaia sur votre appareil de cette façon, vous devez indiquer les options de make correspondantes au facteur d'échelle de votre appareil ; donc par exemple <code>make install-gaia GAIA_DEV_PIXELS_PER_PX=1.5</code> pour un appareil Flame (ou 2, ou 2.5, etc ; voir les valeurs de facteur d'échelle du tableau situé dans <a href="/en-US/Apps/Build/Icon_implementation_for_apps#512_icon_for_device_display">512 icônes pour l'affichage</a>.)</p> -</div> - -<p dir="ltr">Pour vérifier que votre appareil est correctement branché en USB, vous pouvez taper :</p> - -<pre class="brush: bash" dir="ltr">$ adb devices</pre> - -<p dir="ltr">Vous devriez obtenir un résultat de ce genre :</p> - -<pre class="brush: bash" dir="ltr">List of devices attached -emulator-5554 device</pre> - -<h2 id="Construire_Gecko_et_Gaia_et_les_utiliser_dans_un_émulateur_ou_sur_un_véritable_appareil">Construire Gecko et Gaia et les utiliser dans un émulateur ou sur un véritable appareil</h2> - -<p>Si vous disposez d'un appareil mobile compatible, vous pouvez <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko" title="Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">construire et installer votre propre version de Firefox OS</a> et ensuite l'exécuter sur un Émulateur ou la placer sur votre appareil.</p> diff --git a/files/fr/archive/b2g_os/developing_gaia/exécuter_des_versions_personnalisées_dans_webide/index.html b/files/fr/archive/b2g_os/developing_gaia/exécuter_des_versions_personnalisées_dans_webide/index.html deleted file mode 100644 index 2203855c7a..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/exécuter_des_versions_personnalisées_dans_webide/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Exécuter des versions personnalisées de Firefox OS/Gaia dans WebIDE -slug: >- - Archive/B2G_OS/Developing_Gaia/Exécuter_des_versions_personnalisées_dans_WebIDE -tags: - - Apps - - B2G Bureau - - Firefox OS - - Gaia - - WebIDE - - débogage -translation_of: Archive/B2G_OS/Developing_Gaia/Running_custom_builds_in_WebIDE ---- -<div class="summary"> -<p><span class="seoSummary">Fin février 2014, le Simulateur Firefox OS a été doté d'une fonctionnalité pour lui permettre d'exécuter un binaire B2G personnalisé et/ou un profil Gaia de votre choix. Cet article montre comment configurer votre jeu d'outils pour faire cela, exécuter le Simulateur via <a href="/fr/docs/Outils/WebIDE">WebIDE</a>.</span></p> -</div> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Tout d'abord, réunissons les outils dont nous avons besoin pour exécuter nos versions personnalisées dans le Simulateur.</p> - -<ol> - <li>Installez Firefox, et vérifiez que <a href="/fr/docs/Outils/WebIDE">WebIDE</a> soit disponible (<em>Outils > Développement web > WebIDE</em>.)</li> - <li>Installez le <a href="http://nightly.mozilla.org/">simulateur B2G Desktop</a> le plus récent, ou <a href="/fr/Firefox_OS/Building_the_Firefox_OS_simulator#Compilation_du_simulateur">construisez le vôtre</a>.</li> - <li>Installez l'extension <a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">Firefox OS Simulator la plus récente</a>, version 7.0pre7.20140113 ou plus.</li> - <li>Construisez un profil Gaia avec le flag <code>SIMULATOR=1</code>. Par exemple, vous pouvez lancer la commande <code>make SIMULATOR=1 PROFILE_FOLDER=profile-b2g profile-b2g</code> depuis votre répertoire Gaia pour réaliser cette opération (voir <a href="/fr/Firefox_OS/Developing_Gaia/Référence_options_make">Développer pour Gaia</a> pour plus de détails.)</li> -</ol> - -<h2 id="Configuration_de_votre_simulateur">Configuration de votre simulateur</h2> - -<p>Vous devez à présent effectuer certains paramétrages afin que le simulateur puisse trouver vos Bureau B2G et Gaia personnalisés.</p> - -<h3 id="Avant_Firefox_42">Avant Firefox 42</h3> - -<ol> - <li>Ouvrez l'onglet de gestion des modules (<em>Outils > Modules complémentaires</em>, ou saisir <code>about:addons</code> dans la barre d'URL.)</li> - <li>Sur la liste d'onglets, cliquez sur <em>Extensions</em> pour lister vos extensions installées.</li> - <li>Cherchez la nouvelle extension Firefox OS simulator dans la liste. Elle devrait s'appeler quelque chose comme <em>Firefox OS 1.3 Simulator 7.0pre.7.20140113</em>.</li> - <li>Cliquez sur le bouton <em>Préférences</em> situé dans l'entrée de la liste correspondant à l'extension du simulateur.<br> - <img alt="the Firefox OS simulator preferences: Preferences, disable and remove." src="https://mdn.mozillademos.org/files/7241/about-addon.png" style="display: block; height: 63px; margin: 0px auto; width: 1247px;"></li> - <li>Vous pourrez décider d'utiliser un exécutable personnalisé — la dernière version de B2G Desktop — pour faire tourner Firefox OS dans WebIDE. Cliquez sur le bouton <em>Parcourir...</em> juste après l'étiquette <em>Select a custom runtime executable</em> puis sélectionner votre exécutable B2G Desktop dans le sélecteur de fichiers. Alors que cela sera évident sous Windows/Linux, sur Mac, il faudra le rechercher dans <code>/Applications/B2G.app/Contents/MacOS/b2g</code>, à condition que vous l'ayez installé dans le répertoire <code>Applications</code>. Reportez-vous à <a href="#custom-b2g">Construire votre binaire b2g personnalisé</a> si vous souhaitez tester des patchs sur mozilla-central.</li> - <li>Vous pouvez également lancer votre profil Gaia personnalisé dans WebIDE : Cliquez sur le bouton <em>Parcourir...</em> après l'étiquette <em>Select a custom Gaia profile directory</em> et sélectionnez le répertoire de votre profil personnalisé (cela devrait être <em>gaia/profile-b2g</em>.)</li> - <li>Si vous avez besoin de revenir au simulateur non personnalisé, vous devrez réinitialiser une valeur de configuration. Le fait de simplement supprimer et réinstaller l'extension du simulateur ne fonctionnera pas. Ouvrez un nouvel onglet et tapez "about:config" dans la barre d'adresse. Dans le champ Rechercher de cette page, entrez "fxos" ou "simulator" et cherchez quelque chose qui ressemble à "extensions.fxos_2_0_simulator@mozilla.org.customRuntime" ou "extensions.fxos_2_0_simulator@mozilla.org.gaiaProfile". Faites un clic droit et choisissez "Réinitialiser". Redémarrer à présent le simulateur et vous devriez avoir récupéré la version non personnalisée.</li> -</ol> - -<h3 id="À_partir_de_Firefox_42">À partir de Firefox 42</h3> - -<p>Depuis Firefox 42, vous pouvez configurer le binaire B2G et le profil avec l'<a href="/en-US/docs/Tools/WebIDE/Setting_up_runtimes#Configuring_Simulators">écran "Options du Simulateur" dans WebIDE</a>.</p> - -<p> </p> - -<h2 id="Utilisation_de_votre_simulateur_configuré">Utilisation de votre simulateur configuré</h2> - -<p>Enfin, allons-y et utilisons notre simulateur personnalisé.</p> - -<ol> - <li>Ouvrez <a href="/fr/docs/Outils/WebIDE">WebIDE</a> (<em>Outils > Développemet web > WebIDE</em>) ; vous pouvez également presser Shift-F8.</li> - <li>Ouvrez le menu Environnement en cliquant sur le bouton en haut à droite.</li> - <li>Cliquez sur le bouton Firefox OS 1.3 (ou toute autre dernière version que vous avez installée). Cela devrait être la bonne option, même si vos versions de B2G desktop/Gaia sont plus récentes.</li> - <li>Le simulateur va maintenant démarrer ; B2G Desktop devrait se charger et exécuter vos versions B2G nocturne et Gaia personnalisées !</li> -</ol> - -<p><img alt="a screenshot of the b2g desktop simulator " src="https://mdn.mozillademos.org/files/7239/b2g-desktop.png" style="display: block; height: 616px; margin: 0px auto; width: 434px;"></p> - -<p> </p> - -<h2 id="Construire_un_binaire_b2g_personnalisé"><a name="custom-b2g">Construire un binaire b2g personnalisé</a></h2> - -<p>Il s'agit d'une étape facultative, utile si vous devez tester un patch à appliquer sur le codebase de <a href="https://developer.mozilla.org/fr/docs/mozilla-central">mozilla-central</a>.</p> - -<div class="note"> -<p><strong>Note</strong> : s'il vous est possible de soumettre des Try builds, elles généreront des extensions simulateur dans les répertoires de compilation de chaque plate-forme de B2G Desktop ; cela peut donc constituer un moyen plus simple de créer un simulateur qui utilise une plate-forme personnalisée ou des modifications de Gaia dans certains cas d'utilisation.</p> -</div> - -<ol> - <li>Faites un checkout de <a href="/fr/docs/mozilla-central">mozilla-central</a>.</li> - <li>Appliquez le(s) patch(s) que vous voulez tester.</li> - <li>Vérifiez la présence des lignes suivantes dans votre mozconfig :<br> - <code>ac_add_options --enable-application=b2g<br> - FXOS_SIMULATOR=1<br> - GAIADIR=/home/alex/gaia # Mandatory to set FXOS_SIMULATOR flag, it will ensure having a working xpi file<br> - MOZTTDIR=/path/to/moztt # Optional, to get the device fonts</code></li> - <li> - <p>Exécutez <code>./mach build && ./mach package</code></p> - </li> - <li> - <p>Si vous avez indiqué GAIADIR, vous obtiendrez une extension xpi du simulateur dans votre obdir, à l'intérieur du dossier <code>dist</code>.</p> - </li> -</ol> diff --git a/files/fr/archive/b2g_os/developing_gaia/faire_fonctionner_code_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/faire_fonctionner_code_gaia/index.html deleted file mode 100644 index e5ca34e6ce..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/faire_fonctionner_code_gaia/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Faire fonctionner le code de Gaia -slug: Archive/B2G_OS/Developing_Gaia/Faire_fonctionner_code_Gaia -tags: - - B2G - - Contributing - - Firefox - - Firefox OS - - Gaia - - running firefox os locally -translation_of: Archive/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase ---- -<div class="summary"> -<p><span class="seoSummary">Cet article décrit les étapes nécessaires au lancement de Gaia en local. Il liste également les outils pouvant être utilisés.</span></p> -</div> - -<p>Pour commencer, il est nécessaire de préciser qu'<strong>il n'est pas nécessaire de construire Gecko ou B2G</strong> pour contribuer à Gaia. Les seuls éléments obligatoires sont d'avoir téléchargé le code source de Gaia, de pouvoir le lancer et de pouvoir l'éditer.<br> - <br> - Voici les différentes façons dont vous pouvez lancer Gaia :</p> - -<ul> - <li>« <em>Flasher</em> » votre téléphone avec une version (<em>build</em>) de Gaia mise à jour.</li> - <li>Lancer Gaia depuis une version (<em>build</em>) de B2G pour ordinateur (<em>B2G Desktop</em>).</li> - <li>Lancer Gaia depuis WebIDE.</li> - <li>Lancer Gaia depuis l'outil Firefox Mulet pour lancer Gaia sur l'ordinateur.</li> -</ul> - -<p>Vous trouverez des informations plus précises sur ces méthodes sur la page concernant <a href="/en-US/Firefox_OS/Developing_Gaia/Different_ways_to_run_Gaia">les différentes façons de lancer Gaia</a>. Sur cette page, vous trouverez également des liens vers plus d'informations. En général, les différentes méthodes sont ordonnées de la plus complexe (mais la plus réaliste) à la plus simple (mais moins réaliste).</p> - -<p>Dans cet article, nous verrons surtout comment lancer Gaia dans Firefox Mulet ou le WebIDE — pour la plupart des changements que vous souhaiterez apporter au code de Gaia, ce sera la méthode la plus rapide. En revanche, certaines fonctionnalités ne seront pas supportées (comme certaines API matérielles ainsi que les interactions avec les composants matériels du téléphone) et pour celles-ci, vous aurez besoin d'un vrai appareil.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour recevoir plus d'aide sur Gaia, n'hésitez pas à vous rendre sur le canal IRC #gaia (voir <a href="https://wiki.mozilla.org/IRC">Mozilla IRC</a> pour plus d'informations) ainsi que sur la liste de diffusion <a href="https://lists.mozilla.org/listinfo/dev-gaia">dev-gaia</a>.</p> -</div> - -<h2 id="Lancer_votre_compilation_de_Gaia">Lancer votre compilation de Gaia</h2> - -<ol> - <li>Tout d'abord, faites un <em>fork</em> du dépôt principal de <a href="https://github.com/mozilla-b2g/gaia">Gaia sur Github</a>.</li> - <li>Ensuite, clônez votre <em>fork</em> en local : - <pre class="brush: bash">git clone https://github.com/your-username/gaia.git</pre> - </li> - <li>Ajoutez une <em>remote</em> <code>upstream</code> comme ceci : - <pre class="brush: bash">cd gaia -git remote add upstream https://github.com/mozilla-b2g/gaia</pre> - </li> - <li>Vous devez maintenant créer un profil de débogage de Gaia. Lancez la commande <code>make</code> dans le répertoire de votre dépôt pour créer un profil dans le dossier <code>profile</code> (qui est réglé pour permettre un meilleur débogage). Il créera des versions hébergées (non empaquetées) des applications Gaia, qui pourront être servies directement via le serveur local HTTPD contenu dans une extension Firefox . Ainsi, quand vous effectuez un changement, il suffit juste de rafraîchir la fenêtre du navigateur pour voir le résultat (plutôt que d'avoir à reconstruire le profil, de l'envoyer à l'appareil, etc...). Cette méthode est vraiment pratique pour bidouiller rapidement du CSS/JS/HTML.</li> - <li>Une fois votre profil de débogage construit, vous pouvez le lancer dans <a href="/en-US/Firefox_OS/Developing_Gaia/Different_ways_to_run_Gaia#Using_Gaia_in_Firefox_Mulet">Mulet</a> ou <a href="/en-US/Firefox_OS/Developing_Gaia/Different_ways_to_run_Gaia#Using_Gaia_inside_WebIDE_with_a_Firefox_OS_Simulator">WebIDE</a>, en suivant les instructions de ces liens.</li> -</ol> - -<h2 id="Dépannage_et_problèmes_connus">Dépannage et problèmes connus</h2> - -<h3 id="Erreur_Python_executable_python3_is_v3.x_which_is_not_supported_by_gyp.">Erreur: Python executable "python3" is v3.x, which is not supported by gyp.</h3> - -<p>Avec certaines distributions Linux (ex : Archlinux), la version de <code>python</code> par défaut est <code>python3</code>. Cela fait planter <code>npm</code> en lançant certaines commandes commands (ex : en lançant les tests). Pour résoudre cela une fois pour toute, vous pouvez lancer la commande suivante :</p> - -<pre>npm config set python python2</pre> - -<p>Vous pouvez jeter un œil à cette <a href="http://stackoverflow.com/questions/20454199/how-to-use-a-different-version-of-python-duing-npm-install">page Stack Overflow</a> pour d'autres solutions.</p> - -<p>Vous pouvez maintenant supprimer votre répertoire <code>node_modules</code> et lancer une nouvelle fois la commande ayant échoué.</p> - -<h3 id="Please_Install_NodeJS_--_(use_aptitude_on_linux_or_homebrew_on_osx)">Please Install NodeJS -- (use aptitude on linux or homebrew on osx)</h3> - -<p>Vous pouvez rencontrer cette erreur, alors que vous êtes certain d'avoir bien installé nodejs. Il est probable que vous utilisiez Debian ou une distribution basée sur Debian comme Ubuntu. Sur ces distributions, NodeJS est contenu dans le package <code>nodejs</code>, et vous devez installer le package <code>nodejs-legacy</code> pour que tout se déroule correctement :</p> - -<pre>sudo aptitude install nodejs-legacy</pre> - -<p>Si vous rencontrer des problèmes pour installer ce package, c'est surement que vous utilisez <a href="http://www.ubuntuupdates.org/ppa/chris_lea_nodejs">Le PPA pour NODE de Chris Lea</a>; veillez à le supprimer avant de continuer.</p> diff --git a/files/fr/archive/b2g_os/developing_gaia/gaia_tools_reference/index.html b/files/fr/archive/b2g_os/developing_gaia/gaia_tools_reference/index.html deleted file mode 100644 index 395f614579..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/gaia_tools_reference/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: Référence des outils pour Gaia -slug: Archive/B2G_OS/Developing_Gaia/Gaia_tools_reference -tags: - - Firefox OS - - Gaia - - Outils - - Reference - - Référence(2) -translation_of: Archive/B2G_OS/Developing_Gaia/Gaia_tools_reference ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details open> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p>Cet article recense quelques outils pratiques pour travailler avec Gaia.</p> -</div> - -<div class="note"> -<p><strong>Remarque</strong> : Des trucs et astuces très utiles pour le débogage de Firefox OS sont disponibles sur la <a href="https://wiki.mozilla.org/B2G/QA/Tips_And_Tricks">page B2G QA Tips and tricks (en anglais)</a>.</p> -</div> - -<h2 id="MozITP">MozITP</h2> - -<p><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Automated_testing/MozITP">MozITP</a> est un paquet tout-en-un regroupant des outils dédiés à Gaia. Il contient un outil de flashage (b2g_util), b2g-installer et un environnement de Test d'Intégration Gaia préconfigurés. Vous pouvez utiliser MozITP pour essayer les Tests d'Intégration Gaia sur Mulet, un émulateur ou sur de véritables appareils. Vous pouvez également flasher des builds à partir de TaskCluster ainsi que des builds sans blobs avec b2g-installer.</p> - -<h2 id="Foxbox">Foxbox</h2> - -<p><a href="https://github.com/gasolin/foxbox">Foxbox</a> est un script automatique de construction qui génère un environnement de développement Gaia complet. Cet environnement comprend une version de Gaia hébergée dans une VM, laquelle est également accessible depuis la machine hôte (ce qui signifie que vous pouvez toujours travailler avec pour utiliser votre éditeur de texte préféré, etc.) Cela fonctionne sur toutes les plates-formes, mais devrait surtout être pratique pour les utilisateurs de Windows car la procédure de compilation de Gaia ne fonctionne pas sur un environnement Windows standard.</p> - -<h2 id="Outils_de_sauvegarderestaurationflashage">Outils de sauvegarde/restauration/flashage</h2> - -<p>Outils pour sauvegarder votre profil, etc.</p> - -<h3 id="b2g_util">b2g_util</h3> - -<p>Le <a href="https://pypi.python.org/pypi/b2g_util">paquet d'outils b2g_util</a> fournit un ensemble d'outils pour vous aider avec le débogage de Firefox OS. Ce paquet permet de :</p> - -<ul> - <li>Vérifier la version de b2g installée</li> - <li>Récupérer le rapport de plantage</li> - <li>Réinitialiser l'appareil</li> - <li>Autoriser/interdire les applications certifiées dans WebIDE</li> - <li>Sauvegarder/restaurer votre profil (incomplet à l'heure actuelle, mais une solution de contournement est proposée pour l'instant.)</li> -</ul> - -<p>Pour l'installer, vous avez besoin au préalable de Python 2.7, <a href="https://pypi.python.org/pypi/pip/">pip</a>, et <a href="https://pypi.python.org/pypi/setuptools">setuptools</a>. Vous pouvez ensuite lancer :</p> - -<pre class="brush: bash">sudo pip install -U b2g_util</pre> - -<p>Une fois l'installation terminée, vous pouvez connecter votre appareil et faire un test en exécutant la commande suivante pour obtenir la version de b2g installée :</p> - -<pre class="brush: bash">b2g_check_versions</pre> - -<h3 id="pc-sync-tool">pc-sync-tool</h3> - -<p><a href="https://marketplace.firefox.com/app/pcsync">pc-sync-tool</a> est une application disponible sur le Marketplace Firefox. Elle permet de sauvegarder vos données/profils. Elle s'utilise conjointement avec l'<a href="http://download.firefox.com.cn/ffosassistant.xpi">extension Firefox OS assistant</a> pour ordinateur.</p> - -<h3 id="Sauvegarde_et_restauration_de_profil">Sauvegarde et restauration de profil</h3> - -<p>Pour sauvegarder et restaurer les données, vous pouvez utiliser notre outil <code>backup_restore_profile.py</code>, présent dans le <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool">dépôt Git B2G-flash-tool</a>.</p> - -<ol> - <li>Cloner le dépôt précité (<code>git clone https://github.com/Mozilla-TWQA/B2G-flash-tool</code>.)</li> - <li>S'assurer que le téléphone est branché à l'ordinateur en USB, et que ADB (voir <a href="#Important_steps_to_follow_first">Important steps to follow first</a> ci-dessus) et Debugging via USB (dans les <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">Paramètres développeurs</a> de votre appareil) sont activés.</li> - <li>cd dans le répertoire cloné</li> -</ol> - -<p>Pour sauvegarder les données :</p> - -<pre class="brush: bash">python backup_restore_profile.py -b</pre> - -<p>Cela devrait enregistrer le profil de votre appareil dans un répertoire appelé <code>mozilla-profile</code>, situé dans le même répertoire que le script. Pour restaurer votre sauvegarde :</p> - -<pre class="brush: bash">python backup_restore_profile.py -r</pre> - -<div class="note"> -<p><strong>Remarqe </strong>: Pour afficher la liste complète des options de l'outil, exécutez-le avec l'argument <code>-h</code> ou <code>--help</code>.</p> -</div> - -<h3 id="B2G-flash-tool">B2G-flash-tool</h3> - -<p>Le dépôt <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool">B2G-flash-tool</a> contient également plusieurs autres outils pour flasher rapidement de nouvelles versions sur les appareils et effectuer d'autres tâches similaires — idéal pour le contrôle qualité. Par exemple :</p> - -<ul> - <li><a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/flash_pvt.py">flash_pvt.py</a> — Le principal outil pour flasher de nouvelles builds.</li> - <li><a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/change_channel.sh">change_channel.sh</a> — Permet de changer rapidemet le canal de mise à jour du téléphone.</li> - <li><a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/check_versions.py">check_versions.py</a> — Retourne la version de B2G installée sur un appareil.</li> - <li><a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/shallow_flash.sh">shallow_flash.sh</a> — Shallow flashe Gaia et/ou Gecko sur un appareil (<a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/shallow_flash.bat">shallow_flash.bat</a> est aussi disponible pour Windows).</li> - <li><a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/update_system_fonts.sh">update_system_fonts.sh</a> — Met à jour les polices de caractères systèmes sur B2G v2.1 (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1032874" title="FIXED: [Flame][2.1] latest nightly update changed fonts to something which looks like Courier New">bug 1032874</a>).</li> -</ul> - -<h2 id="Outils_de_débogage">Outils de débogage</h2> - -<p>Outils pour effectuer des tâches de débogage.</p> - -<h3 id="WebIDE">WebIDE</h3> - -<p>L'outil <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> de Firefox mérite une mention spéciale ici — alors qu'il permet de tester et déboguer des applications, il se révèle également utile pour surveiller les performances, l'utilisation de la mémoire, etc. (voir <a href="/en-US/docs/Tools/WebIDE#Monitoring_performance">Monitoring performance</a>.)</p> - -<h3 id="get_crashreports.sh">get_crashreports.sh</h3> - -<p>Présent dans le dépôt <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool">B2G-flash-tool</a>, <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/get_crashreports.sh">get_crashreports.sh</a> récupère les rapports de plantage de l'appareil (<code>/data/b2g/mozilla/Crash Reports/</code>.)</p> - -<h3 id="Outils_du_répertoire_racine_de_B2G">Outils du répertoire racine de B2G</h3> - -<p>Un certain nombre de scripts présents dans le <a href="https://github.com/mozilla-b2g/B2G">répertoire racine de B2G</a> permettent d'effectuer diverses opérations utiles de débogage, parmi lesquels :</p> - -<ul> - <li><a href="https://github.com/mozilla-b2g/B2G/blob/master/run-gdb.sh">run-gdb.sh</a>: Lance le débogueur en ligne de commande gdb (voir <a href="/en-US/Firefox_OS/Debugging/Debugging_B2G_using_gdb">Debugging B2G using gdb and related tools</a> pour plus de détails.)</li> - <li><a href="https://github.com/mozilla-b2g/B2G/blob/master/run-valgrind.sh">run-valgrind.sh</a>: Lance le débogueur Valgrind (voir <a href="/en-US/Firefox_OS/Debugging/Debugging_B2G_using_valgrind">Debugging B2G using Valgrind</a> pour plus d'informations.)</li> - <li><a href="https://github.com/mozilla-b2g/B2G/blob/master/watch-procrank.sh">watch-procrank.sh</a>: Renvoie des informations sur la consommation mémoire via l'outil procrank.</li> -</ul> - -<h2 id="Outils_divers">Outils divers</h2> - -<p>D'autres outils utiles se trouvent dans le répertoire <a href="https://github.com/mozilla-b2g/gaia/tree/master/tools">gaia/tools/</a> et dans d'autres endroits</p> - -<h3 id="png_recompress.sh">png_recompress.sh</h3> - -<p>Situé dans <a href="https://github.com/mozilla-b2g/gaia/tree/master/tools">gaia/tools/</a>, <a href="https://github.com/mozilla-b2g/gaia/blob/master/tools/png_recompress.sh">png_recompress.sh</a> est un outil de compression d'images PNG. Vous pouvez le lancer avec une commande de la forme suivante :</p> - -<pre class="brush: bash">$ ./tools/png_recompress.sh -v bg.png</pre> - -<p>Cela supprimera les méta-données inutiles et compressera davantage le png ; il peut économiser jusqu'à 99,5% sur la taille du fichier, ce qui aura un impact vraiment significatif sur la taille du ZIP de l'application ainsi que sur l'empreinte mémoire.</p> - -<h3 id="svg_recompress.sh">svg_recompress.sh</h3> - -<p>Situé dans <a href="https://github.com/mozilla-b2g/gaia/tree/master/tools">gaia/tools/</a>, <a href="https://github.com/mozilla-b2g/gaia/blob/master/tools/svg_recompress.sh">svg_recompress.sh</a> est un outil de compression SVG.</p> - -<h3 id="cache_sync.py">cache_sync.py</h3> - -<p>Situé dans <a href="https://github.com/mozilla-b2g/gaia/tree/master/tools">gaia/tools/</a>, <a href="https://github.com/mozilla-b2g/gaia/blob/master/tools/cache_sync.py">cache_sync.py</a> synchronise le cache hors-ligne d'une application externe avec une structure arborescente locale. Il faut le lancer depuis le répertoire de base d'une application située dans gaia/external-apps. Il construit un répertoire pour chaque origine connue du cache hors-ligne.</p> - -<h3 id="edit_prefs.sh">edit_prefs.sh</h3> - -<p>Situé dans le <a href="https://github.com/mozilla-b2g/B2G">répertoire racine de B2G</a>, <a href="https://github.com/mozilla-b2g/B2G/blob/master/edit-prefs.sh">edit_prefs.sh</a> offre une méthode simple pour récupérer les préférences d'un appareil.</p> - -<p> </p> diff --git a/files/fr/archive/b2g_os/developing_gaia/guide_version_personnalisée_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/guide_version_personnalisée_gaia/index.html deleted file mode 100644 index a6e6ad438c..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/guide_version_personnalisée_gaia/index.html +++ /dev/null @@ -1,1311 +0,0 @@ ---- -title: Guide pour créer une version personnalisée de Gaia -slug: Archive/B2G_OS/Developing_Gaia/Guide_version_personnalisée_Gaia -tags: - - Customization - - Firefox OS - - Gaia - - Marketplace - - build -translation_of: Archive/B2G_OS/Developing_Gaia/Market_customizations_guide ---- -<div class="summary"> -<p>Il est possible de créer une version personnalisée (par exemple, choisir les applications intégrées dans la version) sans modifier le cœur du dépôt de Gaia. Vous pouvez ajouter vos éléments de personnalisation dans des dossiers distincts ou bien utiliser les répertoires existants dans le code originale. Les options de construction (<em>build</em>) permettent de spécifier les éléments à personnaliser. Cet article expliquera en détail comment créer et utiliser ces éléments de personnalisation.</p> -</div> - -<h2 id="Aperçu">Aperçu</h2> - -<p>Depuis la version 1.0.1, Firefox OS utilise le même mécanisme pour apporter les personnalisations. Toutes les fonctionnalités illustrées dans cet article fonctionnent pour Firefox OS 1.0.1 sauf mention contraire.<br> - <br> - Une version entièrement personnalisée de <a href="https://github.com/mozilla-b2g/gaia/tree/master/customization">Gaia </a>fait partie du dépôt Gaia : vous pouvez explorer les différents aspects de personnalisation sur cette version et/ou suivre cet article.</p> - -<div class="note"> -<p><strong>Note </strong>: Merci d'envoyer une <em>pull request</em> sur le dépôt Github de Gaia pour toute suggestion permettant d'améliorer cet exemple, ou si vous trouvez des éléments de cet article qui ne sont pas exploités dans ce code.</p> -</div> - -<p>Voici l'arborescence de l'exemple de personnalisation :</p> - -<pre> customize-sample - ├── power - │ ├── carrier_power_on.png - │ └── carrier_power_off.png - ├── ringtones - │ ├── list.json - │ └── ringer_dream_theme.ogg - ├── wallpapers - │ ├── customize.png - │ └── list.json - ├── browser.json - ├── calendar.json - ├── contacts.json - ├── costcontrol.json - ├── device-features.json - ├── eu-roaming.json - ├── homescreens.json - ├── network.json - ├── settings.json - ├── sms-blacklist.json - ├── support.json - ├── wapuaprof.json - └── apps.list</pre> - -<div class="note"> -<p><strong>Note </strong>: Chacun des fichiers est optionnel. Si vous ne fournissez pas un de ces fichiers, le fichier par défaut sera pris en compte.</p> -</div> - -<p>Chacune de ces personnalisations sera discutée dans la suite. Le paragraphe suivant, quant à lui, explique comment appliquer ces éléments de personnalisation à Gaia.</p> - -<h2 id="Les_étapes_pour_appliquer_la_personnalisation">Les étapes pour appliquer la personnalisation</h2> - -<p>Pour appliquer l'exemple de personnalisation à Gaia, il faut :</p> - -<ol> - <li>Clôner le dépôt de Gaia depuis <a href="https://github.com/mozilla-b2g/gaia">https://github.com/mozilla-b2g/gaia</a>.</li> - <li>Copier le répertoire <code>gaia/customization/</code> dans un autre répertoire pour y apporter vos propres adaptations ou bien éditer directement le contenu du répertoire <code>gaia/customization/</code>. Le chemin du répertoire en question sera évoqué par <code><DISTRIBUTION_PATH></code> dans la suite. À chaque exemple, assurez-vous de bien remplacer la variable dans les commandes.</li> - <li>Effectuez les changements que vous souhaitez.</li> - <li>Connectez un appareil Firefox OS à votre ordinateur par USB, vérifiez que celui-ci est bien reconnu par <a href="/Firefox_OS/Debugging/Installing_ADB">ADB</a>.</li> - <li>Construisez Gaia en spécifiant l'emplacement du répertoire de personnalisation en utilisant la variable d'environnement <code>GAIA_DISTRIBUTION_DIR</code> avec : - <pre class="brush: bash">make production GAIA_DISTRIBUTION_DIR=<DISTRIBUTION_PATH></pre> - </li> - <li>Vous devriez désormais disposez d'une version personnalisée de Gaia sur votre appareil Firefox OS.</li> -</ol> - -<p>Si vous copiez le contenu du répertoire de personnalisation dans <code>gaia/distribution/</code>, vous pouvez lancer la commande <code>make</code> sans la variable d'environnement :</p> - -<pre class="brush: bash">make production</pre> - -<div class="note"> -<p><strong>Note </strong>: Certaines personnalisations ont lieu lors de l'exécution des scripts de construction. Voir <a href="/en-US/Firefox_OS/Developing_Gaia/make_options_reference">la référence des options de <code>make</code></a> pour les éléments de personnalisation liés aux scripts de construction.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Les éléments de personnalisation concernant la carte SIM sont inclus lors de la construction. Par contre, ils sont appliqués lors de la phase de première utilisation (FTU pour First Time Usage en anglais).</p> -</div> - -<h2 id="Les_personnalisations_appliquées_lors_de_la_construction">Les personnalisations appliquées lors de la construction</h2> - -<p>Dans la suite du paragraphe, les différentes options de l'exemple seront illustrées.</p> - -<h3 id="power">power/</h3> - -<p>Les animations (ou les images fixes) pour les écrans d'allumage/extinction de l'appareil sont à insérer ici. Les fichiers peuvent être des animations MP4 ou des images PNG.</p> - -<p>Les noms de fichiers acceptés sont :</p> - -<ul> - <li><code>carrier_power_on.png</code></li> - <li><code>carrier_power_on.mp4</code></li> - <li><code>carrier_power_off.png</code></li> - <li><code>carrier_power_off.mp4</code></li> -</ul> - -<p>(<code>carrier_power_on.[png/mp4]</code> sera utilisé lors de l'allumage, <code>carrier_power_off.[png/mp4]</code> sera utilisé lors de l'extinction)</p> - -<h3 id="ringtones">ringtones/</h3> - -<p>Les sonneries personnalisées peuvent être placées ici. Le fichier <code>list.json</code> doit contenir les noms des fichiers des différentes sonneries, dans le format suivant :</p> - -<pre class="brush: js"> { - "ringer_classic_courier.opus": "", - "ringer_dream_theme.ogg": "", - "ringer_loud_windchimes.opus": "", - "ringer_bitbounce.opus": "" - }</pre> - -<p>Les sonneries personnalisées peuvent être choisies dans les réglages de Firefox OS via <em>Son > Sonnerie</em>. La sonnerie par défaut doit être définie dans <code>settings.json</code>, avec une DataURI. Vous pouvez utiliser la commande <strong>datauri</strong> pour créer l'URI qui est disponible via Node.js/npm:</p> - -<ol> - <li>Installer l'utilitaire avec la commande <code><strong>npm install datauri -g</strong></code></li> - <li>Convertir le fichier en DataURI avec <code><strong>datauri <FILE></strong></code>.</li> -</ol> - -<h3 id="wallpapers">wallpapers/</h3> - -<p>Les fonds d'écran par défaut (fichiers PNG) peuvent être placés dans ce dossier et lister dans le fichier <code>list.json</code>. Ils pourront être sélectionné dans les réglages de Firefox OS via <em>Affichage > Fond d'écran</em>.</p> - -<p>Le fond d'écran par défaut peut être défini dans le fichier <code>settings.json</code> grâce à la ligne suivante :</p> - -<pre class="brush: js">"wallpaper.image": "emplacement de l'image"</pre> - -<div class="note"> -<p><strong>Note </strong>: L'image peut être définie grâce à un chemin de fichier ou grâce à une DataURI.</p> -</div> - -<h3 id="browser.json">browser.json</h3> - -<p>Ce fichier permet d'ajouter des éléments personnalisés dans l'application Navigateur (par exemple des marque-pages, des moteurs de recherche par défaut). Voir la section <a href="/en-US/Firefox_OS/Hacking_Firefox_OS/Market_customizations_guide#Browser_bookmarks_.26_default_search_engine">Marque-pages et moteur de recherche par défaut</a> pour plus d'informations sur les informations à placer dans ce fichier.</p> - -<h3 id="calendar.json">calendar.json</h3> - -<p>Ce fichier permet d'ajouter vos propres calendrier à l'application Calendrier de Firefox OS. Pour cela, il sera nécessaire de définir vous identifiants Google OAuth. De plus, vous aurez besoin de configuer un accès à l'API CalDav : pour générer la clé d'API et le secret associé, vous aurez besoin de <a href="https://developers.google.com/google-apps/calendar/caldav/v2/guide#creating_your_client_id">créer votre identifiant client</a> (client au sens informatique). Pour cela, suivez les étapes suivantes :</p> - -<ol> - <li>Ouvrez la <a href="https://code.google.com/apis/console/b/0">console d'API</a>.</li> - <li>Créez un projet puis activez <em>Calendar CalDav API</em> dans <em>APIs & auth > APIs</em> (API et authentification > API)</li> - <li>Cliquez sur <em>Credentials</em> (Identifiants)</li> - <li>Cliquez sur <em>Create new client ID</em> (Créer un nouvel identifiant de client)</li> - <li>Définissez le champ <em>Application type</em> (Type d'application) avec <em>Installed application</em> (application installée) et définir <em>Installed application type</em> avec <em>Other</em> (autre) puis cliquez sur <em>Create Client ID</em> (Créer un identifiant client). Vous devriez obtenir un identifiant et un secret de client.</li> - <li>Ouvrez le fichier <code>calendar.json</code>, modifiez les valeurs <code>client_id</code> et <code>client_secret</code> avec celles que vous avez obtenues à l'étape précédente. Sauvegardez puis fermez le fichier.</li> -</ol> - -<div class="note"> -<p><strong>Note</strong> : L'utilisation de l'API est limitée à 1 000 000 (1 millions) de requêtes par jour.</p> -</div> - -<h3 id="camera-config.json_(Tailles_d'image_pour_la_galerie_et_l'appareil_photo)">camera-config.json (Tailles d'image pour la galerie et l'appareil photo)</h3> - -<pre class="brush: js">{ - "maxImagePixelSize": 6000000, - "maxSnapshotPixelSize": 4000000, - "requiredEXIFPreviewSize": { - "width": 1200, - "height": 1222 - } -} -</pre> - -<p><code>maxImagePixelSize</code> et <code>maxSnapshotPixelSize</code> correspondent aux tailles maximales, exprimées en pixels. Par défaut, ces paramètres sont fixés à 5 mega pixels (5x2<sup>20</sup> pixels 5MP).</p> - -<p>Vous pouvez également définir les variables nécessaires pour définir la taille minimale de l'aperçu EXIF qui sera utilisé lors de la prévisualisation plein écran en ajoutant la propriété <code>requiredEXIFPreviewSize</code>. Si vous ne définissez pas cette propriété, la prévisualisation EXIF ne sera faite que lorsqu'elle sera assez grande pour remplir l'écran (en largeur ou en hauteur) en paysage ou en portrait.</p> - -<h3 id="contacts.json">contacts.json</h3> - -<p>Les contacts listés dans ce fichier seront intégrés à la base de données des contacts du téléphone lors de la construction de Gaia.</p> - -<p>Voici un exemple de fichier <code>contacts.json</code> :</p> - -<pre class="brush: js">[ - { - "name": ["Jean Biche"], - "givenName": ["Jean"], - "familyName": ["Biche"], - "nickname": ["Johnny"], - "category": ["Travail", "Équipe bowling"], - "email": [ - { - "type": ["personal"], - "value": "jean.biche@exemple.org", - "pref": true - }, - { - "type": ["work"], - "value": "jbiche@société.com" - } - ], - "adr": [ - { - "type": ["personal"], - "streetAddress": "123 Foopy St.", - "locality": "San Francisco", - "region": "Downtown", - "postalCode": "94030", - "countryName": "US" - } - ] - }, - { - "name": ["Operateur"], - "email": [ - { - "type": ["work"], - "value": "support@opérateurx.com" - } - ], - "url": [ - { - "type": ["work"], - "value": "https://www.opérateurx.com" - } - ] - } - ]</pre> - -<div class="note"> -<p><strong>Note </strong>: Voir la page sur <a href="/docs/Web/API/Contacts_API">l'API Contacts</a> pour plus d'informations sur la structure des objets contacts.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Pour des personnalisations propres à la carte SIM, lire la section <a href="#Marque-pages_et_moteur_de_recherche_par_défaut_du_navigateur">Marque-pages et moteur de recherche par défaut du navigateur</a>.</p> -</div> - -<h3 id="device-features.json">device-features.json</h3> - -<p>Ce fichier définit les capacités matérielles de l'appareil. Par défaut, le fichier contient :</p> - -<pre class="brush: js">{ - "ambientLight": true, - "vibration": true, - "usbHotProtocolSwitch": false -}</pre> - -<p>Pour le capteur de lumière et le vibreur, vous pouvez changer ces valeurs à <code>false</code> si vous souhaitez désactiver certaines fonctionnalités de l'appareil.</p> - -<h3 id="eu-roaming.json">eu-roaming.json</h3> - -<p>Ce fichier contient la liste des opérateurs qui doivent respecter la législation européenne pour l'itinérance des données, ainsi que les APN (<em>Access Point Name</em>) correspondants. Le fichier est composé de trois partie. La première <code>home</code>, contient les codes des opérateurs qui doivent respecter cette législation. La deuxième partie, <code>foreign</code>, contient les codes des opérateurs étrangers pour lesquels une notification devrait être activée lors de l'itinérance des données est active dans ce pays. Enfin, la dernière partie contient le détail pour les APN par défaut dans l'Union européenne. Par défaut, le contenu du fichier est :</p> - -<pre class="brush: js">{ - "home": null, - "foreign": null, - "defaultApns": [] -} -</pre> - -<p>Si vous souhaitez que le système d'exploitation affiche une notification lors de l'itinérance des données, le fichier ressemblera à celui présenté ci-dessous. Pour cet exemple, l'utilisateur utilisant une carte SIM d'un opérateur "001, 01" recevra une notification concernant l'itinérance des données quand il utilisera le réseau de l'opérateur dont le code est "002, 02" :</p> - -<pre class="brush: js">{ - "home": { - "001": { - "01": true - } - }, - "foreign": { - "002": { - "02": true - } - }, - "defaultApns": [{ - "apn": "eu.apn", - "types": ["default"] - }] -} -</pre> - -<div class="note"> -<p><strong>Note</strong> : Tous les paramètres des APN listés dans <code>defaultApns</code> apparaîtront également via l'application des Paramètres.</p> -</div> - -<h3 id="homescreens.json">homescreens.json</h3> - -<p><a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/homescreens.json">homescreens.json</a> définit les applications à afficher sur la partie principale de l'écran d'accueil et sur les autres pages de l'écran d'accueil, ainsi que l'ordre dans lequel elles sont affichées. Par défaut, le fichier contient :</p> - -<pre class="brush: js">{"homescreens": [ - [ - ["apps", "communications", "dialer"], - ["apps", "sms"], - ["apps", "browser"], - ["apps", "camera"] - ] - ]}</pre> - -<p>Avec ces informations, les quatres applications décrites seront affichées sur l'écran principal de l'écran d'accueil. Si on ajoute un autre tableau, les applications contenues apparaîtront sur la première page de l'écran d'accueil, l'ensemble suivant apparaîtra sur la deuxième page et ainsi de suite.</p> - -<pre class="brush: js">{"homescreens": [ - [ // Écran principal pour l'écran d'accueil - ["apps", "communications", "dialer"], - ["apps", "sms"], - ["apps", "browser"], - ["apps", "camera"] - ], - [ // Page 1 de l'écran d'accueil - ["apps", "email"], - ["apps", "settings"], - ["apps", "clock"], - ["apps", "calendar"] - ], - [ // Page 1 de l'écran d'accueil - ["external-apps", "appPerso1"], - ["external-apps", "appPerso2"], - ["external-apps", "appPerso3"], - ["external-apps", "appPerso4"] - ] - ]}</pre> - -<p>Le premier élément de chaque sous-tableau correspond au nom du répertoire de l'application, le second correspond au nom de l'application et de son répertoire dédié.</p> - -<h4 id="Collections">Collections</h4> - -<div class="note"> -<p><strong>Note</strong> : Avec Firefox 2.0, le répertoire <code>collections</code> a été déplacé de l'application <code>homescreen</code> vers l'application <code>collections</code>. Certains champs du fichier manifeste ont également été modifiés (voir le fichier de manifeste pour la collection <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/collection/collections/funny/manifest.collection">funny</a> par exemple) : <code>provider_id</code> a été modifié en <code>categoryId</code>, et <code>apps</code> a été modifié en <code>pinned</code>.</p> -</div> - -<p>Les collections sont des groupes d'applications avec leur propre icône qui apparaît sur l'écran d'accueil. Lorsque l'utilisateur touche l'icône, un nouvel écran apparaît et présente l'ensemble des icônes pour les applications contenues dans le groupe. Vous pouvez regarder <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/collection/collections">le contenu du répertoire collections</a> pour voir les collections disponibles par défaut :</p> - -<ul> - <li><code>funny </code>: découvrez les dernières applications insolites</li> - <li><code>games</code> : jouez à des jeux en ligne</li> - <li><code>local </code>: ce qui se passe près de vous</li> - <li><code>music</code> : écoutez votre musique préférée avec ces applications</li> - <li><code>news</code> : restez à jour en suivant les actualités</li> - <li><code>shopping</code> : les modes de shopping</li> - <li><code>showbiz</code> : découvrez des applications de divertissement</li> - <li><code>social </code>: gardez à portée vos réseaux sociaux</li> - <li><code>sports</code> : les meilleurs appliactions sur le sport</li> - <li><code>tv</code> : les applications liées aux medias</li> -</ul> - -<p>Dans chacun de ces répertoires, vous trouverez les icônes pour les différentes résolutions ainsi qu'un fichier de manifeste qui définit des méta-données sur la collection comme son nom, son rôle, ainsi que l'emplacement de ces icônes.</p> - -<div class="note"> -<p><strong>Note </strong>: Des collections supplémentaires sont disponibles sur le serveur E.me (19 collections au total, incluant les 10 collections présentées ci-dessus). Vous pouvez voir ces collections en maintenant une pression sur l'écran d'accueil et en choisissant l'option "Ajouter des collections intelligentes".</p> -</div> - -<p>Dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/homescreens.json"><code>homescreens.json</code></a>, vous pouvez choisir les collections que vous souhaitez charger, les pages sur lesquelles elles doivent apparaître ainsi que l'ordre de leur disposition. Par exemple, si on souhaite faire apparaître les collections <code>shopping</code>, <code>social</code>, <code>sports</code> et <code>tv</code>, on pourra avoir le fichier suivant :</p> - -<pre class="brush: js">{"homescreens": [ - [ - ["apps/collection/collections", "shopping"], - ["apps/collection/collections", "social"], - ["apps/collection/collections", "sports"], - ["apps/collection/collections", "tv"] - ], [ - ["apps", "communications", "dialer"], - ["apps", "sms"], - ["apps", "browser"], - ["apps", "camera"] - ] - ]}</pre> - -<p>Chaque tableau de plus haut niveau fait référence à une des pages de l'écran d'accueil. Pour cet exemple, les collections apparaîtront sur la page principale (<em>dock</em>) de l'écran d'accueil et les applications individuelles apparaîtront sur la première page de l'écran d'accueil.</p> - -<div class="note"> -<p><strong>Note </strong>: Par défaut, quatre collections sont utilisées pour la première page de l'écran d'accueil de Gaia : <em>social</em>, <em>games</em>, <em>music</em> et <em>entertainment</em>.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Les noms des collections sont écrits en minuscules.</p> -</div> - -<h5 id="Le_contenu_des_collections">Le contenu des collections</h5> - -<p>Les collections sont composées de deux types d'application.<br> - <br> - <strong>Les applications locales</strong> sont définies lors de la construction grâce à une fichier de manifeste situé sous <code>/apps/collection/collections/<nomDeLaCollection>/manifest.collection</code>. Les applications locales contenues dans chaque collection sont définies dans le fichier de manifeste. La collection social (qui contient les applications pour le téléphone, les sms, les contacts et les e-mails) aura le fichier de manifeste suivant :</p> - -<pre class="brush: js">{ - "name": "Social", - "role": "collection", - "provider_id": "289", // identifiant pour la recherche adaptative - "apps": [ - ["apps", "communications", "dialer"], - ["apps", "sms"], - ["apps", "communications", "contacts"], - ["apps", "email"] - ], - "default_locale": "en-US", - "icons": { - "60": "/collections/social/icon.png", - "90": "/collections/social/icon@1.5x.png", - "120": "/collections/social/icon@2x.png" - } - }</pre> - -<p><strong>Les applications distantes</strong> sont fournies par le moteur de recherche adaptative lors de l'exécution et quand l'appareil est connecté.</p> - -<h5 id="Traduire_les_collections">Traduire les collections</h5> - -<p>Les traductions pour les collections doivent être définies dans les fichiers de locales pour l'application <em>Écran d'accueil</em> dans le répertoire <code>apps/collection/locales/</code>. Chaque fichier de locale devra avoir un nom structurant avec la structure <code>collections.<codeLangue>.properties</code> — avec <code><codeLangue></code> qui vaut, par exemple, <code>fr</code> pour le français. Ce fichier contient des lignes simples qui contiennent les identifiants des chaînes anglaises associées à leur traduction. Voici un exemple pour la locale française :</p> - -<pre># Add bookmark to homescreen -add-to-home-screen=Ajouter à l’écran d’accueil -add-to-home-screen-header=Ajouter un lien -website-name=Nom du site web -address=Adresse -added-to-home-screen=Ajouté à l’écran d’accueil -</pre> - -<h5 id="Collections_personnalisées">Collections personnalisées</h5> - -<p>À partir de Firefox OS 1.3, vous pouvez définir vos propres collections. Pour cela, il suffit de créer la collection dans le répertoire <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/collection/collections">collection</a>, et de les référencer dans le fichier <code>collections.json</code> vu avant.</p> - -<h4 id="Les_propriétés_de_l'écran_d'accueil_vertical">Les propriétés de l'écran d'accueil vertical</h4> - -<p>À partir de Firefox 2.0, il est possible de choisir une disposition verticale (plutôt que des pages horizontales) pour l'écran d'accueil. Les propriétés de l'écran d'accueil sont définies dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/verticalhome/build/default-homescreens.json">default-homescreens.json</a> qui décrit les applications, les collections et les marque-pages à afficher ainsi que le nombre de colonnes pour l'écran d'accueil.</p> - -<h3 id="network.json_(ce_fichier_n'apparait_pas_dans_le_dossier_de_personnalisation)">network.json (ce fichier n'apparait pas dans le dossier de personnalisation)</h3> - -<div class="warning"> -<p><strong>Important</strong> : Cette personnalisation n'est plus supportée depuis Firefox OS 1.4+.</p> -</div> - -<p>Dans les versions de Firefox OS < 1.4, ce fichier peut être créé dans <code>gaia/apps/settings/resources</code>. Il permet de définir les types de réseaux supportés par l'appareil. Firefox OS fonctionne sur les types de réseaux suivants :</p> - -<ul> - <li>'wcdma/gsm' (WCDMA de préférence)</li> - <li>'gsm'</li> - <li>'wcdma'</li> - <li>'wcdma/gsm-auto' (GSM de préférence)</li> - <li>'cdma/evdo' (CDMA de préférence)</li> - <li>'cdma'</li> - <li>'evdo'</li> - <li>'wcdma/gsm/cdma/evdo' (Automatique)</li> -</ul> - -<p>Voici un exemple de fichier :</p> - -<pre class="brush: js">{ - "types": [ - "cdma/evdo", - "cdma", "evdo" - ] -}</pre> - -<h3 id="settings.json">settings.json</h3> - -<ul> - <li>Réglages généraux : 1.0.1</li> - <li>Fournisseur de recherche par défaut pour la Rocketbar : 2.0</li> -</ul> - -<p>Ce fichier permet de définir les valeurs par défaut pour le fond d'écran, les sonneries, l'activation ou non de l'écran de verrouillage, l'activation ou non du bluetooth, etc. Vous pouvez consulter le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/common-settings.json">build/config/common-settings.json</a> pour déterminer les réglages possibles. Par exemple, vous pouvez inclure la ligne <code>"wifi.enabled":false</code> pour désactiver le wifi par défaut.</p> - -<p>Les réglages personnalisés sont à placer dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/settings.json">customization/settings.json</a>.</p> - -<h4 id="Fournisseur_de_recherche_par_défaut_pour_la_Rocketbar">Fournisseur de recherche par défaut pour la Rocketbar</h4> - -<p>Dans Firefox OS 2.0 et les versions supérieures, les paramètres suivants peuvent être ajoutés dans le fichier <code>settings.json</code>, pour définir le fournisseur de recherche par défaut pour la Rocketbar :</p> - -<pre>"search.urlTemplate": "https://www.google.com/search?q={searchTerms}", -"search.suggestionsUrlTemplate": "https://www.google.com/complete/search?client=firefox&q={searchTerms}", -"search.iconUrl": "data:image/x-icon;base64,AAABAAIAEBAAAAAAAAB9AQAAJ [TRONQUÉ POUR L'EXEMPLE] -</pre> - -<h3 id="Personnaliser_le_moteur_de_recherche">Personnaliser le moteur de recherche</h3> - -<p>À partir de Firefox 2.0+, il existe une liste par défaut pour les différents moteurs de recherches et les fichiers d'icônes associés : <a href="/en-US/docs/https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/resources/search/providers.json">apps/settings/resources/search/providers.json</a>. Vous pouvez configurer cette liste lors de la construction en éditant le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/search/providers.json">customization/search/providers.json</a> et en ajoutant les fichiers d'icônes appropriés dans le même répertoire. Le contenu de ce répertoire écrasera <code>app/settings/resources/search</code> s'il existe et si vous avez lancé la construction avec la commande <code>make production GAIA_DISTRIBUTION_DIR=customization</code>.</p> - -<h3 id="Personnaliser_les_applications_par_défaut_de_l'écran_d'accueil">Personnaliser les applications par défaut de l'écran d'accueil</h3> - -<p><code>homescreen.appName</code> vous permet de définr des applications comme applications par défaut pour l'écran d'accueil.</p> - -<pre class="brush: js">{ "homescreen.appName": "homescreen-stingray" } -</pre> - -<h3 id="sms-blacklist.json">sms-blacklist.json</h3> - -<p>Ce fichier contient une liste finie de numéros de téléphone pour lesquels il ne sera pas possible d'envoyer des SMS. Cette liste surchargera le fichier <code>blacklist.json</code> de l'application SMS si elle existe. Les numéros de téléphone sont définis dans un tableau comme suit :</p> - -<pre>["11223344", "55667788"]</pre> - -<h3 id="cellbroadcast">cellbroadcast</h3> - -<p>Canaux d'écoute :</p> - -<ul> - <li>Disponible lors de l'utilisation dans les Réglages <code>ril.cellbroadcast.searchlist</code></li> - <li>type : chaîne de caractères</li> - <li>format valide : <code>\d(-\d)?(,\d(-\d))*</code></li> -</ul> - -<p>Désactiver le rapport d'événement :</p> - -<ul> - <li>Disponible - <ul> - <li>lors de l'utilisation : dans les Réglages — <code>ril.cellbroadcast.disabled</code></li> - <li>lors dans la construction : dans les préférences utilisateurs — <code>ril.cellbroadcast.disabled</code></li> - </ul> - </li> - <li>Type : booléen</li> - <li>Signification : vaut <code>true</code> pour désactiver la diffusion depuis la cellule du téléphone (<em>Cell Broadcast reporting</em>).</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: Les paramètres par défaut sont disponibles dans le fichier <a href="https://mxr.mozilla.org/gaia/source/shared/resources/apn/operator_variant.xml">operator_variant.xml</a>.</p> -</div> - -<h3 id="support.json">support.json</h3> - -<p>Ce fichier contient des contacts pour l'assistance (en ligne ou téléphonique). Lorsque ce fichier est renseigné, il écrasera le fichier <code>support.json</code> contenu dans l'application Paramètres. Pour conserver les contacts par défaut, il faudra les copier du fichier original sur le fichier de personnalisation puis ajouter vos nouveaux contacts.</p> - -<p>Voici un exemple de fichier JSON :</p> - -<pre class="brush: js">{ - "onlinesupport": { - "href": "http://support.mozilla.org/", - "title": "Mozilla Support" - }, - "callsupport": [ - { - "href": "tel:12345678", - "title": "Assistance tél. 1" - }, - { - "href": "tel:87654321", - "title": "Assistance tél. 2" - } - ] - }</pre> - -<h3 id="Profil_pour_l'agent_utilisateur_WAP_(wapuaprof.json)">Profil pour l'agent utilisateur WAP (wapuaprof.json)</h3> - -<p>Le profil d'agent utilisateur WAP peut surcharger l'agent utilisateur lors de l'envoi de paquets WAP. Si vous souhaitez surcharger le profil d'agent utilisateur (<em>user agent profile</em>) par défaut avec des informations MCC/MNC, vous pouvez utiliser ce fichier (voir les explications supplémentaires dans <a href="#runtime_customization">runtime customization</a>).</p> - -<h3 id="apps.list">apps.list</h3> - -<p>Ce fichier vous permet de définir les applications que vous souhaitez charger à l'exécution (de façon semblable à <code>variant.json</code>, comme expliqué ci-après dans le paragraphe <a href="#Applications">Applications</a>). Les applications sont listées de la façon suivante :</p> - -<pre class="brush: bash">apps/* -external-apps/* -outoftree_apps/*</pre> - -<p>Vous pouvez lister des applications spécifiques plutôt que des répertoires entiers :</p> - -<pre class="brush: bash">apps/email -apps/settings</pre> - -<div class="note"> -<p><strong>Note</strong> : Si vous souhaitez ajouter des applications externes dans votre version de Gaia, vous devrez les construire d'une certaine façon et les placer dans le répertoire <code>gaia/external-apps/</code>. Lire le paragraphe <a href="#Building_Prebundled_web_apps">Building Prebundled web apps</a> pour plus d'informations à ce sujet.</p> -</div> - -<div class="warning"> -<p><strong>Important </strong>: Si vous distribuez une version adaptée de Firefox OS avec des applications externes intégrées, vous devez respecter l'accord de distribution avec Mozilla (Mozilla's Distribution Agreement).</p> -</div> - -<h2 id="Les_autres_options_de_personnalisation">Les autres options de personnalisation</h2> - -<p>D'autres aspects de Gaia peuvent être personnalisés. C'est aspects sont décrits ici.</p> - -<div class="note"> -<p><strong>Note </strong>: Le script de construction utilisé pour la plupart des paragraphes suivants est <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/applications-data.js">gaia/build/applications-data.js</a>. Il est copié dans un fichier <code>init.json</code> qui se situe dans le répertoire de l'application du navigateur lors de la construction.</p> -</div> - -<h3 id="Marque-pages_et_moteurs_de_recherche_par_défaut_du_navigateur">Marque-pages et moteurs de recherche par défaut du navigateur</h3> - -<ul> - <li>Marque-pages : 1.0.1</li> - <li>Moteurs de recherche par défaut : 1.2</li> -</ul> - -<p>Les marque-pages et moteurs de recherche par défaut peuvent être personnalisés lors de la construction et on peut avoir différentes variantes pour chacun des pays au sein d'une même version. Les données personnalisées sont insérées dans l'application du navigateur la première fois qu'il est lancé en fonction des codes <a href="http://en.wikipedia.org/wiki/Mobile_country_code">MCC / MNC</a> de la carte SIM de l'appareil à ce moment.</p> - -<div class="note"> -<p><strong>Note</strong> : Les marque-pages peuvent être personnalisés depuis la version 1.0.1 de Firefox OS mais la procédure a été modifiée avec la version 2.1 (ce qui est expliqué dans le paragraphe suivant). Les moteurs de recherches peuvent être personnalisés à partir de Firefox OS 1.2.</p> -</div> - -<p>L'exemple ci-après (<code>browser.json</code>) illustre une configuration pour l'opérateur Vivo au Brésil (724006 avec 724 pour le Brésil et 006 pour Vivo selon la codification MCC / MNC), ainsi que le cas par défaut (000000) présent au cas où la carte SIM ne correspondrait pas à l'opérateur ou au cas où la carte SIM est absente de l'appareil.</p> - -<pre class="brush: js">content = { - '000000': { - 'bookmarks': [ - { 'title': 'Mozilla', - 'uri': 'https://mozilla.org', - 'iconUri': - 'data:image/png;base64,AAABAAIAEBAAAAEAIABo[tronqué]' - }, - { 'title': 'Firefox OS', - 'uri': 'https://mozilla.org/firefoxos', - 'iconUri': - 'data:image/png;base64,AAABAAIAEBAAAAEA[tronqué]' - } - ], - 'searchEngines' : [ - { - 'title': 'Google', - 'uri': 'https://www.google.com/search?q={searchTerms}', - 'iconUri': - 'data:image/png;base64,AAABAAIAEBAAAAEAIABoBAA[tronqué]' - } - ], - 'settings' : { - 'defaultSearchEngine': 'https://www.google.com/search?q={searchTerms}' - } - }, - - '724006': { - "bookmarks": [ - { "title": "Vivo Busca", - "uri": "https://www.google.com.br/m/search", - "iconUri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAC[tronqué]" - }, - { "title": "Serviços e Downloads", - "uri": "http://vds.vivo.com.br", - "iconUri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACA[tronqué]" - }, - { - "title": "Site Vivo", - "uri": "http://www.vivo.com.br/conteudosmartphone", - "iconUri": "data:image/jpg;base64,/9j/4AAQSkZJRg[tronqué]" - } - ], - 'searchEngines' : [ - { - 'title': 'Yahoo', - 'uri': 'https://search.yahoo.com/search?q={searchTerms}', - 'iconUri': - 'data:image/png;base64,AAABAAIAEBAAAAEAIABoBAA[tronqué]' - } - ], - 'settings' : { - 'defaultSearchEngine': 'https://search.yahoo.com/search?q={searchTerms}' - } - } - };</pre> - -<p>Pour cet exemple, si la carte SIM de l'appareil est une carte de l'opérateur Vivo au Brésil, lors de la première utilisation, l'utilisateur verra les marque-pages Vivo et aura Yahoo comme moteur de recherche par défatu. Si une autre carte (ou aucune carte) est présente dans l'appareil lors de la première utilisation, l'utilisateur verra les marque-pages Mozilla ainsi que le moteur de recherche Google. Plusieurs aspects importants sont à noter :</p> - -<ul> - <li>La propriété <code>defaultSearchEngine</code> <em>doit</em> correspondre à la propriété <code>uri</code> du moteur de recherche défini. Cette chaîne de caractères sera utilisée comme modèle pour les différentes requête. <code>{searchTerms}</code> sera remplacé par les termes saisis par l'utilisateur pour la recherche. D'autres chaînes de caractères complétant la recherche peuvent être ajouté après cette variable dans les différentes URL .</li> - <li>Les URL pour les icônes sont des dataURI encodées en base 64 (tronquées pour l'exemple) et non pas des URL HTTP. Cela permet de faire apparaître les icônes lors de la première utilisation et ce même si l'appareil n'est pas connecté à Internet.</li> - <li>Il est donc possible d'avoir un fichier qui contient différents cas pour différents opérateurs dans différents pays. Chaque variant étant représentée par un code à 6 chiffres composé du code MCC suivi du code MNC (les deux codes étant préfixés de '0' si nécessaire afin qu'ils soient chacun sur trois chiffres)</li> - <li>Lorsque la navigateur devra prendre connaissance du réglage (à la première utilisation), il consultera le fichier pour trouver une correspondance avec les codes MCC et MNC, s'il n'en trouve pas, il cherchera une correspondance avec MCC+000, s'il n'y a toujours pas de correspondance, il utilisera le code 000000.</li> - <li>Lors des mises à jour de Gaia, les nouvelles personnalisations ne seront appliquées que pour les nouvelles fonctionnalités. Si la fonctionnalité était déjà présente, l'ancienne adaptation ne sera pas surchargée.</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: L'application du navigateur affichera les marque-pages dans le sens opposé (ex : le premier marque-page du fichier JSON sera affiché en dernier, etc.).</p> -</div> - -<h3 id="Personnalisation_de_la_liste_des_fournisseurs_de_recherche_pour_la_Rocketbar">Personnalisation de la liste des fournisseurs de recherche pour la Rocketbar</h3> - -<ol> - <li>Il est également possible d'adapter le fournisseur de recherche par défaut (et la liste des fournisseurs) pour la Rocketbar. Cette personnalisation se base également sur les codes MCC/MNC. Pour définir les fournisseurs de recherche, il faut modifier deux fichiers JSON : - <ul> - <li>La liste des fournisseurs par MCC/MNC qui est définie dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/mobizilla/mobizilla_search.json">mobizilla_search.json</a> pour notre exemple,</li> - <li>Le fournisseur de recherche par défaut pour la Rocketbar qui est défini dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/mobizilla/mobizilla_default_search.json">mobizilla_default_search.json</a> pour notre exemple.</li> - </ul> - </li> - <li><a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/variant.json">variant.json</a> définit ensuite les fichiers <code>.json</code> à utiliser pour chaque paire MCC/MNC. Ainsi, dans notre exemple, aux <a href="https://github.com/mozilla-b2g/gaia/blob/master/customization/variant.json#L47-L48">lignes 47 et 48</a>, on a : - <pre class="brush: json">"search": "mobizilla/mobizilla_search.json", -"default_search": "mobizilla/mobizilla_default_search.json",</pre> - </li> - <li><code>variant.json</code> doit être placé dans le répertoire racine consacré à la distribution de votre version.</li> - <li>Afin d'appliquer cette configuration, pour la construction de Gaia la variable <code>GAIA_DISTRIBUTION_DIR</code> doit correspondre au chemin de votre répertoire consacré à la distribution de votre version.</li> -</ol> - -<h3 id="Réglages_pour_les_données_et_les_messages">Réglages pour les données et les messages</h3> - -<p>Il est possible d'adapter les réglages pour les données et les messages lors de l'exécution.</p> - -<p>Pour ajouter des réglages spécifiques, il suffit d'éditer <code>gaia/shared/resources/apn/apns_conf_local.xml</code> en ajoutant ou en éditant des bloc pour chaque opérateur téléphonique :</p> - -<pre class="brush: xml"> <apn carrier="Réseau Test" - mcc="001" - mnc="01" - apn="internet" - user="user" - password="password" - proxy="127.0.0.1" - port="8080" - mmsc="http://127.0.0.1" - mmsproxy="127.0.0.1" - mmsport="8080" - authtype="0" - type="default,supl,mms" - /></pre> - -<h3 id="Réglages_concernant_la_messagerie_et_la_diffusion_cellulaire">Réglages concernant la messagerie et la diffusion cellulaire</h3> - -<p>Pour appliquer des changements spécifiques à la boîte vocale et à la diffusion cellulaire, il suffit de modifier le fichier <code>gaia/shared/resources/apn/operator_variant.xml</code> en ajoutant ou en éditant des blocs pour les opérateurs de la forme suivante :</p> - -<pre class="brush: xml"> <operator carrier="Réseau Test avec variante par opérateur" - mcc="001" - mnc="01" - cellBroadcastSearchList="0,1,2,3" - voicemail="999999" - /></pre> - -<h3 id="Profil_de_l'agent_utilisateur_WAP">Profil de l'agent utilisateur WAP</h3> - -<p>Le profil d'agent utilisateur WAP peut également être personnalisé lors de l'exécution et surcharge les informations de l'agent utilisateur lorsque le téléphone envoie des paquets WAP. En fonction des codes MCC/MNC, le profil peut être personnalisé grâce aux propriétés<code> url</code> et <code>tagname</code> . L'implémentation actuelle ne tient compte que de la propriété <code>url</code>.</p> - -<p>Le profil d'agent utilisateur WAP utilise ici le même format que pour l'application Navigateur. "000000" est utilisé comme profil par défaut. Voici un exemple :</p> - -<pre class="brush: js"> { - "000000": { - "url": "http://example.url/default.xml" - }, - "123001": { - "url": "http://example.url/custom123001.xml" - } - }</pre> - -<p>Pour cet exemple, l'URL du profile par défaut est <code>http://example.url/default.xml</code> ; pour les codes MCC = 123 et MNC = 001, l'URL sera <code>http://example.url/custom123001.xml</code>. S'il y avait une autre carte dont les codes seraient MCC = 123 et MNC = 100, l'URL utilisée serait alors <code>http://example.url/default.xml</code>.</p> - -<p>Si jamais l'élément dont le code est 000000 était retiré :</p> - -<pre class="brush: js"> { - "123001": { - "url": "http://example.url/custom123001.xml" - } - }</pre> - -<p>le profil utilisé par la carte dont les codes sont MCC = 123 et MNC = 001 serait désormais basé sur <code>http://example.url/custom123001.xml</code>. Les profils des autres codes ne seraient pas surchargés.</p> - -<p>Si on gardait "000000" et que "123001" ne possèdait pas d'URL :</p> - -<pre class="brush: js"> { - "000000": { - "url": "http://example.url/default.xml" - }, - "123001": {} - }</pre> - -<p>tous les profils seraient surchargés avec l'URL <code>http://example.url/default.xml</code></p> - -<h3 id="Applications">Applications</h3> - -<p>Les applications installées dans Firefox OS peuvent être adaptées lors de l'exécution (voir <a href="/en-US/Firefox_OS/Platform/Gaia/Hacking#Customizing_the_build-time_apps">personnaliser les applications présentes lors de la construction</a>). Pour personnaliser les applications en fonction de l'opérateur, il est possible d'utiliser le fichier <code>variant.json</code> pour déterminer quelles applications installer et comment les placer sur l'écran d'accueil. Les applications tierces seront ajoutées à la liste avec les applications standard.</p> - -<p>La portion intéressante du fichier <code>variant.json</code> ressemblera à cela :</p> - -<pre class="brush: js"> { - "apps": { - "puzzle": - { - "manifestURL": "https://owd.tid.es/store/packages/fe8e4a866c518a42db9d2041568684c1.webapp" - }, - "store": - { - "manifestURL": "https://owd.tid.es/store/manifest.webapp", - "installOrigin": "https://www.openwebdevice.com" - } - }, - "operators": [ - { - "id": "movistar-co", - "mcc-mnc": [ - "214-01", - "214-02" - ], - "apps": [ - { - "id": "store", - "screen": 0, - "location": 2 - } - ] - }, - { - "id": "movistar-mx", - "mcc-mnc": [ - "215-23" - ], - "apps": [ - { - "id": "store", - "screen": 0, - "location": 2 - }, - { - "id": "puzzle" - } - ] - } - ] - }</pre> - -<ul> - <li>Le premier objet de la structure JSON est<code> apps</code>, et permet de définir les applications tierces à copier lors de la construction. Dans cet exemple, on a deux applications : une application hébergée (<code>store</code>) et une application empaquetée (<code>puzzle</code>). Les applications empaquetées auront besoin de <code>manifestURL</code>, les applications hébergées auront, en plus, besoin de <code>installOrigin</code> pour pouvoir être téléchargées.</li> - <li>Le deuxième objet, appelé <code>operators</code>, permet de définir la configuration en fonction du code MCC/MNC. L'objet contient un tableau d'objets pour chaque paire MCC/MNC. Ces objets définissent l'identifiant <code>id</code>, une liste MCC/MNC correspondant à la configuration ainsi qu'une liste d'objets <code>apps</code> qui définit les applications à installer à l'exécution pour chaque cas.</li> - <li>Chaque objet <code>apps</code> possède une propriété <code>id</code> obligatoire ainsi que deux propriétés optionnelles qui permettront de placer l'application visuellement : - <ul> - <li>La propriété <code>screen</code> définit le numéro de l'écran sur lequel placer l'application.</li> - <li>La propriété <code>location</code> définit la position de l'application sur cet écran.</li> - </ul> - </li> -</ul> - -<h3 id="Les_autres_personnalisations_utilisant_un_fichier_de_variante">Les autres personnalisations utilisant un fichier de variante</h3> - -<p>Le fichier <code>variant.json</code> (le même que précedemment) permet également de configurer des ressources spécifiques grâce à des attributs relatifs à chaque opérateurs. Un opérateur pourra avoir les réglages suivants :</p> - -<pre class="brush: js"> { - "apps": { - ... - }, - "operators": [ - { - "id": "movistar-co", - "mcc-mnc": [ - "214-01", - "214-02" - ], - "apps": [ - { - "id": "store", - "screen": 0, - "location": 2 - } - ], - "support_contacts": "resources/support_contacts_movistar.json", - "default_contacts": "resources/contacts_movistar.json", - "ringtone": { - "path": "resources/Movistar_Mid_ABR_128kbps.ogg", - "name": "Tono Movistar" - }, - "wallpaper": "resources/customize.jpg", - "keyboard": "resources/keyboard_movistar.json", - "network_type": "resources/network_type_movistar.json", - "known_networks": "resources/known_networks_movistar.json", - "data_ftu": true, - "sms": "resources/sms_movistar.json", - "topsites": "resources/topsites_movistar.json", - "bookmarks": "resources/bookmarks_movistar.json", - "data_roaming": true, - "power": { - "poweron": { - "video": "app://operatorresources/resources/power/latam_power_on.mp4" - }, - "poweroff": { - "video": "resources/latam_power_off.mp4" - } - }, - "nfc": true - } - ... - ] - } -</pre> - -<p>Les différents réglages présentés dans le fichier sont détaillés ci-après :</p> - -<h4 id="Contacts_d'assistance">Contacts d'assistance</h4> - -<p>La propriété <code>support_contacts</code> correspond à un chemin vers un fichier qui contiendra les contacts affichés sur l'écran d'aide (Paramètres > Aide). Cela permet d'avoir les mêmes fonctionnalités que <a href="#support.json">support.json</a>. Le format du fichier attendu à l'emplacement indiqué est le suivant :</p> - -<pre class="brush: js"> { - "onlinesupport": { - "title": "Assistance Mozilla", - "href": "http://test.mozilla.org/support" - }, - "callsupport1": { - "title": "Assistance téléphonique (1)", - "href": "tel:14155550001" - }, - "callsupport2": { - "title": "Assistance téléphonique (2)", - "href": "tel:14155550002" - } - }</pre> - -<h4 id="Contacts_par_défaut">Contacts par défaut</h4> - -<p>La propriété <code>default_contacts</code> correspond au chemin vers un fichier qui définit les contacts qui seront préchargés dans l'application Contacts en fonction des codes MCC/MNC. Les noms des différentes sections du fichier seront les codes MCC/MNC, chaque section contient un ensemble de contacts (au même format que pour <a href="#contacts.json">contacts.json</a>). Par exemple :</p> - -<pre class="brush: js"> { - "123123": - [ - {name: ["Jean Biche"]}, - // etc - ], - } -</pre> - -<h4 id="Sonnerie">Sonnerie</h4> - -<p>La propriété <code>ringtone</code> permet de définir la sonnerie par défaut. Cet objet contient deux propriétés obligatoires :</p> - -<ul> - <li><code>path</code> : Le chemin vers le fichier audio à utiliser pour la sonnerie.</li> - <li><code>name</code> : Le nom à afficher pour cette sonnerie dans l'écran des réglages.</li> -</ul> - -<h4 id="Fond_d'écran">Fond d'écran</h4> - -<p>La propriété <code>wallpaper</code> contient le chemin vers le fichier image (PNG) qui sera utilisé comme fond d'écran par défaut.</p> - -<h4 id="Paramètres_clavier">Paramètres clavier</h4> - -<p>La propriété <code>keyboard</code> contient le chemin vers un fichier qui contient les informations de configuration pour le clavier. Le format du fichier attendu est le suivant :</p> - -<pre class="brush: js"> { - "keyboard.vibration": true, - "keyboard.autocorrect": false, - "keyboard.clicksound": true, - "keyboard.wordsuggestion": false - }</pre> - -<h4 id="Indicateurs_de_réseau">Indicateurs de réseau</h4> - -<p>La propriété <code>network_type</code> contient le chemin d'un fichier qui contient le texte à utiliser lorsqu'un type de réseau est utilisé par l'appareil. Ce texte apparaîtra dans l'application Réglages, la barre de statut et les réglages rapides.</p> - -<p>La barre de statut et les occurences dans l'application Réglages utiliseront le texte contenu dans le fichier. Pour l'écran des réglages rapides, le fichier devra contenir une clé intitulée <code>data_sprite</code> qui pointe vers un sprite CSS qui contient les icônes pour les différents types de réseaux supportés.</p> - -<p>La propriété <code>data_sprite</code> doit correspondre à une URL qui pointe vers une application de l'appareil. Voici un exemple pour un tel fichier :</p> - -<pre class="brush: js"> { - "lte": "4G", - "ehrpd": "4G", - "hspa+": "H+", - "hsdpa": "H", - "hsupa": "H", - "hspa": "H", - "evdo0": "E", - "evdoa": "E", - "evdob": "E", - "1xrtt": "1x", - "umts": "3G", - "edge": "E", - "is95a": "2G", - "is95b": "2G", - "gprs": "2G", - "wcdma/gsm": "2G/3G GSM auto", - "gsm": "2G GSM", - "wcdma": "3G GSM", - "wcdma/gsm-auto": "2G GSM Preferred", - "cdma/evdo": "2G/3G CDMA auto", - "cdma": "2G CDMA", - "evdo": "3G CDMA", - "wcdma/gsm/cdma/evdo": "2G-3G GSM/CDMA auto", - "data_sprite": "app://operatorresources/resources/quick_settings/images/data-sprite-latam.png" - }</pre> - -<h4 id="SSID_WiFi_pré-paramétrés">SSID WiFi pré-paramétrés</h4> - -<p>La propriété <code>known_networks</code> contient un chemin vers un fichier qui liste différents réseaux WiFi. Voici un exemple de fichier :</p> - -<pre class="brush: js"> { - "OPEN": { - "ssid": "OPEN" - }, - "WEP-WITHOUTKEY": { - "ssid": "wifi-WEP-WITHOUTKEY", - "keyType": "WEP" - }, - "WEP_KEY": { - "ssid": "WEP-KEYOK", - "keyType": "WEP", - "capabilities": "", - "password": "constrasenya1" - }, - "WEP_KEYOK_WPS": { - "ssid": "WEP-KEYOK-WPS", - "keyType": "WEP", - "capabilities":"WPS", - "password": "constrasenya1" - }, - "wpa": { - "ssid": "macaFirefoxHotspot", - "keyType": "WPA-PSK" - }, - "WPA-PSK_KEY": { - "ssid": "WPA-PSK-KEYOK", - "keyType": "WPA-PSK", - "capabilities":"", - "password": "constrasenya1" - }, - "WPA-PSK_KEY_WPS": { - "ssid": "WPA-PSK-KEYOK-WPS", - "keyType": "WPA-PSK", - "capabilities":"WPS", - "password": "constrasenya1" - }, - "WPA-EAP-PSK_WITHOUTEAP": { - "ssid": "WPA-EAP-WITHOUTKEY", - "keyType": "WPA-EAP" - }, - "WPA-EAP_SIM": { - "ssid": "WPA-EAP-SIM", - "keyType": "WPA-EAP", - "eap": "SIM", - "password": "constrasenya1" - }, - "WPA-EAP-KEYOK-WPS": { - "ssid": "WPA-EAP-KEYOK-WPS", - "keyType": "WPA-EAP", - "eap": "PEAP", - "capabilities": "WPS", - "password": "constrasenya1", - "identity": "HI\\usr" - }, - "WPA-EAP-KEYOK-CAPOK-PHASE2-OK": { - "ssid": "WPA-EAP-KEYOK-CAPOK-PHASE2", - "keyType": "WPA-EAP", - "eap": "PEAP", - "capabilities":"WPS", - "phase2": "PAP", - "password": "constrasenya1", - "identity": "HI\\usr" - } - }</pre> - -<h4 id="ActivationDésactivation_des_données_par_défaut_lors_de_l'expérience_de_première_utilisation">Activation/Désactivation des données par défaut lors de l'expérience de première utilisation</h4> - -<p>L'attribut <code>data_ftu</code> définit si oui ou non les données sont activées pendant l'expérience de première utilisation (<em>FTU</em> pour <em>First Time Use</em>). Cette propriété est une valeur booléenne.</p> - -<h4 id="Nombre_maximum_de_SMS_à_convertir_en_MMS">Nombre maximum de SMS à convertir en MMS</h4> - -<p><code>sms</code> contient le chemin vers un fichier permettant de paramétrer les aspects relatifs aux SMS. Actuellement le seul attribut présent correspond au nombre de SMS pouvant être convertis en MMS. Par exemple :</p> - -<pre class="brush: js"> { - "smsMaxConcat": 9 - }</pre> - -<h4 id="Initialiser_les_sites_les_plus_visités_du_navigateur">Initialiser les sites les plus visités du navigateur</h4> - -<p>La propriété <code>topsites</code> contient le chemin vers un fichier qui liste les sites à faire apparaître. Un objet de ce tableau contient la propriété <code>title</code> (chaîne de caractères), <code>uri</code> (l'url) et <code>iconPath</code>. Voici un fichier d'exemple :</p> - -<pre class="brush: js">{ - "topsites": [ - { - "title": "Movistar", - "uri": "http://www.movistar.es", - "iconPath": "resources/movistar.ico" - } - ] -}</pre> - -<h4 id="Marque-pages">Marque-pages</h4> - -<div class="note"> -<p><strong>Note</strong> : Pour plus d'informations sur la personnalisation des marque-pages pour les versions antérieures de Firefox OS, voir le paragraphe <a href="#Browser_bookmarks_and_default_search_engines">Browser bookmarks and default search engines</a>.</p> -</div> - -<p><code>bookmarks</code> contient le chemin d'un fichier listant les objets marque-pages. Un objet correspondant à un marque-page contient trois paramètres : <code>title</code>, pour le titre, <code>uri</code>, pour l'URL du site marqué et <code>iconPath</code> pour l'icône à afficher sur le téléphone. Par exemple :</p> - -<pre class="brush: js">{ - "bookmarks": [ - { - "title": "Google", - "uri": "http://www.google.es", - "iconPath": "resources/google.ico" - } - ] -}</pre> - -<h4 id="ActivationDésactivation_de_l'itinérance_des_données_par_défaut">Activation/Désactivation de l'itinérance des données par défaut</h4> - -<p>L'attribut <code>data_roaming</code> permet de définir si oui ou non l'itinérance des données est activée par défaut. C'est un booléen (sa valeur est <code>true</code> ou <code>false</code>).</p> - -<h4 id="Animation_à_l'allumageextinction">Animation à l'allumage/extinction</h4> - -<p>Les animations d'allumage/extinction sont configurées grâce à un objet qui sera la valeur de la propriété <code>power</code>. Cet objet possède deux propriétés : la première concerne l'animation à utiliser quand le téléphone est démarré (<code>poweron</code>), la seconde correspond à l'animation à utiliser lorsque le téléphone s'éteind. Chacune de ces propriétés contient une clé permettant d'identifier la ressource à utiliser. Cette clé correspond à la propriété <code>video</code> dont la valeur est le chemin vers la ressource à utiliser. Ce chemin peut être local, relativement au système de fichier à utiliser lors de la construction (par exemple : <code>resource/unfichier.png</code>) ou une URI vers un fichier contenu dans une application Gaia qui sera installée sur l'appareil (par exemple : <code>app://nom.domaine/chemin/vers/video.mp4</code>).</p> - -<p>Voici un exemple d'objet <code>power</code> :</p> - -<pre class="brush: js">"power": { - "poweron": { - "video": "app://operatorresources/resources/power/latam_power_on.mp4" - }, - "poweroff": { - "video": "resources/Power_off_test.mp4" - } -}</pre> - -<h4 id="ActivationDésactivation_du_NFC_par_défaut">Activation/Désactivation du NFC par défaut</h4> - -<p>L'attribut <code>nfc</code> booléen définit si oui ou non le NFC (<em>Near Field Communication</em> ou Communication en champ proche) est activé par défaut.</p> - -<h2 id="Construire_des_applications_web_pré-empaquetées">Construire des applications web pré-empaquetées</h2> - -<p>Dans cet article, nous avons vu comment utiliser le fichier <a href="#apps.list">apps.list</a> pour installer des applications intégrées à votre version. Ces applications doivent être construites selon un certain procédé puis ajoutées au répertoire <code>gaia/external-apps</code>.<br> - <br> - Pour construire des applications web pré-empaquetées, vous devrez utiliser le script <a href="https://github.com/mozilla-b2g/preload-app-toolkit">preload-app-toolkit</a> qui permet de construire une application à partir d'une URL<code> .webapp</code>. Ce script peut également accepter les manifestes pour les applications web hébergées et les mini-manifestes pour les applications empaquetées.</p> - -<h3 id="Empaqueter_une_seule_application">Empaqueter une seule application</h3> - -<p>Déterminez l'URL <code>.webapp</code> correspondant à l'application que vous voulez empaqueter puis lancez la commande suivante :</p> - -<pre>python preload.py http://<url de l'application></pre> - -<p>Cela génèrera un répertoire dont le nom sera celui de l'application web (par exemple <code>accuweather</code>).</p> - -<h3 id="Empaqueter_plusieurs_applications_(traitement_en_lots)">Empaqueter plusieurs applications (traitement en lots)</h3> - -<p>Pour traiter plusieurs applications à la suite, vous pouvez créer un fichier <code>list</code>, contenant l'ensemble des noms des applications et des URL <code>.webapp</code> correspondantes et que vous souhaitez empaqueter. Le fichier ressemblera à celui-ci :</p> - -<pre>premiereAppli,https://www.premiereappli.com/manifest.webapp -deuxièmeAppli,https://www.deuxiemeappli.com/manifest.webapp -</pre> - -<p>Ce fichier devra être sauvegardé sous le nom <code>list</code> et faire partie du même répertoire que le script <code>preload.py</code>. Vous pouvez ensuite lancer la commande suivante :</p> - -<pre>$ python preload.py</pre> - -<p>Le script <code>preload.py</code> analysera le fichier fourni et traitera l'ensemble des applications à la suite.</p> - -<h3 id="Le_fichier_metadata.json_pour_les_applications_pré-empaquetées">Le fichier metadata.json pour les applications pré-empaquetées</h3> - -<p>Chaque application web pré-empaquetée devrait contenir un fichier<code> metadata.json</code> au sein de son répertoire racine. Le <a href="https://marketplace.firefox.com/">Marketplace Firefox</a> a besoin de ce fichier <code>metadata.json</code> pour gérer les mises à jour automatiques. Ce fichier est généré automatiquement par le script <code>preload.py</code>.<br> - <br> - Pour une application web hébergée, les propriétés du fichier <code>metadata.json</code> sont :</p> - -<ul> - <li><code>origin </code>: Le nom de dommaine pour l'URL de l'application web.</li> - <li><code>manifestURL</code> : L'emplacement du manifeste de l'application web pour l'application hébergée</li> - <li><code>installOrigin(hosted)</code> : L'emplacement à partir duquel l'application a été installée. Pour les adaptations/personnalisations, cette propriété devrait toujours valoir : <code>https://marketplace.firefox.com</code>.</li> - <li><code>etag</code> : La propriété <code>etag</code> du manifeste de l'application est utilisé pour vérifier les mises à jour. La valeur de la propriété <code>etag</code> est obtenue grâce à l'entête <code>parse</code> <code>html</code> lors du téléchargement du fichier <code>.webapp</code> depuis le serveur.</li> - <li><code>external </code>: Champ requis pour Firefox OS 2.1 et ultérieur. Cette propriété vaut <code>true</code> pour les applications pré-empaquetées et <code>false</code> pour les applications non tierces. Cette valeur est utilisée pour déterminer si certains ajustements sont nécessaires pour l'ordre des fichiers dans le fichier application.zip (les ajustement auront lieu lorsque la propriété sera <code>true</code>).</li> -</ul> - -<p>Pour une application empaquetée, les propriétés de <code>metadata.json</code> seront :</p> - -<ul> - <li><code>manifestURL</code> : L'emplacement du mini-manifeste. Pour les applications personnalisées, <code>manifestURL</code> proviendra toujours de <code>marketplace.firefox.com</code>.</li> - <li><code>installOrigin(hosted)</code>: L'emplacement à partir duquel l'application a été installée pour la personnalisation. Pour les personnalisations, cette propriété devrait toujours valoir : <code>https://marketplace.firefox.com</code>.</li> - <li><code>etag</code> : Cette propriété est utilisée pour les mises à jour. La valeur <code>etag</code> est obtenu à partir de l'en-tête <code>parse html</code> lors de du téléchargement du fichier <code>.webapp</code> depuis le serveur.</li> - <li><code>external</code> : Ce champ est requis pour les versions de Firefox OS 2.1 et ultérieures. Cette valeur vaudra <code>true</code> pour les applications pré-empaquetées et <code>false</code> pour les applications non-tierces. Cette valeur est utilisée pour déterminer si certains ajustements sont nécessaires pour l'ordre des fichiers dans le fichier application.zip (les ajustement auront lieu lorsque la propriété sera <code>true</code>).</li> - <li><code>packageEtag</code> : Cette propriété correspond à <code>etag</code> du paquet de l'application. Elle est obtenue grâce l'en-tête <code>parse html</code> lors du téléchargement du paquet via le serveur, une fois qu'une mise à jour a été détectée.</li> -</ul> - -<h3 id="Mises_à_jour_automatique_des_applications_empaquetées_le_format_update.webapp">Mises à jour automatique des applications empaquetées : le format update.webapp</h3> - -<p>Les applications empaquetées possèdent un fichier <code>update.webapp</code> utilisé pour les mises à jour automatiques. Le format de ce fichier est semblable à celui de <a href="https://developer.mozilla.org/en-US/Apps/Build/Manifest"><code>manifest.webapp</code></a>, mais possède certains attributs supplémentaires :</p> - -<ul> - <li><code>package_path</code> est le chemin vers le fichier du paquet (zip)</li> - <li><code>size</code> est la taille du paquet en octets.</li> -</ul> - -<pre class="brush: js"> { - "name": "Game Pack", - "icons": { - "60": "/icon-60.png", - "128": "/icon-128.png" - }, - "version": "1.1.2", - "package_path": "/application.zip", - "developer": { - "url": "http://abc.com", - "name": "abc Inc." - }, - "release_notes": "2nd release", - "locales": { - "es": { - "launch_path": "/index-es.html", - "description": "show me customization." - } - }, - "size": 5460141 - }</pre> - -<h3 id="Application_pré-empaquetée_au_format_AppCache">Application pré-empaquetée au format AppCache</h3> - -<p>Si le fichier <a href="https://developer.mozilla.org/en-US/Apps/Build/Manifest"><code>manifest.webapp</code></a> possède un attribut <a href="https://developer.mozilla.org/en-US/Apps/Build/Manifest#appcache_path"><code>appcache_path</code></a> inclus, le script <code>preload.py</code> ira chercher le fichier AppCache utilisé et ira « pré-chercher » (<em>prefetch</em>) les ressources décrites dans le fichier AppCache. Les applications pré-empaquetée AppCache sont légèrement différentes et Gecko les reconnaîtra dans un format différent. Cela est géré par le script <code>preload.py</code>.</p> - -<p>La structure des fichiers traduits sera la suivante :</p> - -<pre> <app name> - ├── manifest.webapp - ├── metadata.json - └── cache - ├── manifest.appcache - └── <resources> -</pre> - -<div class="note"> -<p><strong>Note </strong>: Si le fichier AppCache est nommé différemment dans <code>appcache_path</code>, il devra être renommé en <code>manifest.appcache</code> puis enregistré dans le répertoire <code>cache</code>.</p> -</div> - -<h2 id="FAQ">FAQ</h2> - -<p>La liste qui suit regroupe les réponse aux questions fréquemment posées sur la personnalisation de Gaia :</p> - -<h3 id="Qu'est-ce_qui_peut_être_personnalisé">Qu'est-ce qui peut être personnalisé ?</h3> - -<ul> - <li>La marque - <ul> - <li>Les animations d'allumage et d'extinction</li> - <li>Le nom du réseau dans l'écran de verrouillage et la barre utilitaire</li> - <li>Les logos affichés lors de la première utilisation</li> - </ul> - </li> - <li>La localisation - <ul> - <li>Les locales installées (shared/locales)</li> - <li>La locale par défaut (<code>GAIA_DEFAULT_LOCALE</code>)</li> - <li>Les agencements de clavier par défaut (plusieurs claviers peuvent être activés sans être nécessairement liés à la locale)</li> - </ul> - </li> - <li>Les applications - <ul> - <li>Disposer d'applications tierces préinstallées</li> - <li>Placer des applications sur la grille de l'écran d'accueil</li> - <li>Licensing</li> - <li>La configuration des paiements dans les applications pour le fournisseur</li> - </ul> - </li> - <li>Les réglages - <ul> - <li>La luminosité par défaut de l'écran</li> - <li>Information sur l'appareil : le nom ou numéro du modèle</li> - <li>Information sur l'appareil : contenu ou lien sur les termes légaux</li> - <li>Aide : lien vers une assistance en ligne</li> - <li>Aide : lien vers une assistance téléphonique</li> - <li>Aide : lien vers un guide utilisateur</li> - <li>APN</li> - <li>Limitation de la taille des MMS</li> - <li>Mode de réception pour les MMS</li> - </ul> - </li> - <li>Les médias pré-chargés - <ul> - <li>Fond d'écran</li> - <li>Musique</li> - <li>Vidéos</li> - <li>Gallerie d'images</li> - </ul> - </li> - <li>Les sons - <ul> - <li>Démarrage et extinction</li> - <li>Sonnerie d'appel</li> - <li>Sonnerie de message</li> - </ul> - </li> - <li>Everything.me - <ul> - <li>Activer ou désactiver la fonctionnalité</li> - <li>Fournir un ensemble d'applications et/ou de catégories par défaut</li> - </ul> - </li> - <li>Le navigateur - <ul> - <li>Marque-pages par défaut</li> - <li>Moteur de recherche par défaut</li> - </ul> - </li> -</ul> - -<h3 id="Comment_définir_une_disposition_des_applications_personnalisée">Comment définir une disposition des applications personnalisée ?</h3> - -<p>Cette disposition est définie actuellement dans <code>gaia/apps/homescreen/js/init.json</code>. <code>customize.py</code> génèrera la construction au bon format.</p> - -<h3 id="Est-il_possible_de_définir_si_une_application_peut_être_retirée_de_l'écran_d'accueil_avec_la_configuration">Est-il possible de définir si une application peut être retirée de l'écran d'accueil avec la configuration ?</h3> - -<p>Non. Les applications de <code>/system/b2g</code> ne peuvent pas être retirées, celles contenues dans <code>/data</code> peuvent être retirées. Les applications préchargées provenant de <code>/system</code>, elles doivent être déplacées sous <code>/data</code> si on veut les retirer.</p> - -<h3 id="Comment_ajouter_une_application_empaquetée_préchargée_ou_une_application_hébergée_à_la_construction">Comment ajouter une application empaquetée préchargée ou une application hébergée à la construction ?</h3> - -<p>Ces applications doivent être ajoutées à <code>gaia/external-apps</code>. <code>customize.py</code> permetttra de gérer les URL pour les applications empaquetées et hébergées puis téléchargera les fichiers à l'emplacement adéquat puis créera <code>metadata.json</code>. Ce fichier servira lors de la construction.</p> - -<p>Les méta-données permettront de différencier les applications empaquetées des applications hébergées.</p> - -<p>Voir <a href="#Building_Prebundled_web_apps">Building Prebundled web apps</a> pour plus de détails.</p> - -<h3 id="Comment_préparer_une_application_hébergée_préchargée_pour_qu'elle_fonctionne_hors_ligne">Comment préparer une application hébergée préchargée pour qu'elle fonctionne hors ligne ?</h3> - -<p>Pour cela, il faut fournir les fichiers à fournir en cache dans le répertoire <code>external-apps/MON_APPLICATION/cache</code>, avec le manifeste AppCache.</p> - -<p>Voir <a href="#Building_Prebundled_web_apps">Building Prebundled web apps</a> pour plus de détails.</p> - -<h3 id="Quelles_adaptations_peuvent_être_effectuées_pour_le_Marketplace">Quelles adaptations peuvent être effectuées pour le Marketplace ?</h3> - -<ul> - <li>Côté appareil - <ul> - <li>Pour les paiements, la seule personnalisation possible est l'ajout de fournisseurs de paiements sur une liste blanche. Plusieurs réglages sont disponibles et sont documentés sur la page <a href="https://wiki.mozilla.org/WebAPI/WebPayment#Testing">Web Payments</a>.</li> - <li>Par exemple, les téléphones Mozilla B2G seront livrés avec <a href="https://github.com/mozilla/webpay#readme">une certaine implémentation pour les fournisseurs de paiement</a> et une liste blanche accessible au Marketplace et aux applications tierces via <a href="/fr/docs/Web/API/Navigator/mozPay" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.mozPay</code></a> pour les paiements au sein des applications. Plus d'informations sur les fournisseurs de paiement sont disponibles <a href="https://wiki.mozilla.org/WebAPI/WebPaymentProvider">sur cette page</a>.</li> - <li>Tout opérateur peut implémenter son propre processeur de paiement et gérer sa liste blanche. En revanche et à l'heure actuelle, le <a href="https://marketplace.firefox.com/">Marketplace Firefox</a> est le seul configuré pour permettre les achats via le fournisseur de paiement de Mozilla.</li> - </ul> - </li> - <li>Côté serveur - <ul> - <li>Le distributeur de l'application fixe un prix pour le produit et le système de paiement de Mozilla détermine la devise à utiliser en fonction du réseau de l'utilisateur. Aucun des aspects concernant les devises, les taxes régionales ou la localisation ne peuvent être gérées sur l'appareil (pour le moment).</li> - <li>Une catégorie spécifique peut être définie pour l'opérateur avec un logo et un nom sur le Marketplace Firefox.</li> - <li>Diffuser des applications / promotions sur le Marketplace Firefox, définies par l'opérateur.</li> - </ul> - </li> -</ul> - -<p>D'autres problématiques sont à gérer selon les régions ou les opérateurs. Voir la page <a href="https://wiki.mozilla.org/Marketplace/AddingRegionsAndCarriers">Ajouter des régions ou des opérateurs</a> pour plus de détails.</p> - -<h3 id="Comment_enregistrer_les_modifications_apportées">Comment enregistrer les modifications apportées ?</h3> - -<p>Il suffit de sauvegarder uniquement les fichiers modifiés dans les différents emplacements. À l'heure actuelle, plusieurs répertoires sont utilisés au sein du système de fichiers. Pour la version 2 de B2G, ces fichiers pourront être amenés à être stockés dans un seul emplacement (de façon similaire aux répertoires des différentes marques pour Gecko).</p> - -<h3 id="Comment_construire_le_produit_avec_une_configuration_spécifique">Comment construire le produit avec une configuration spécifique ?</h3> - -<p>Copiez les fichiers modifiés dans une branche de Gaia puis lancez la construction. Pour cela, vous pouvez utiliser <code>customize.py</code> qui, via une interface utilisateur, vous aidera à activer ou non les différentes options, à créer les fichiers adéquats aux bons emplacements puis à construire le profil depuis Gaia.</p> - -<h3 id="Comment_personnaliser_l'animation_d'allumageextinction">Comment personnaliser l'animation d'allumage/extinction ?</h3> - -<ul> - <li>Cette animation utilise le format <a href="http://www.droidforums.net/forum/droid-hacks/33932-bootanimation-zip-file-explained.html">Android <code>bootanimation.zip</code>/<code>desc.txt</code></a>.</li> - <li>Cela permet de créer une animation composées de plusieurs séquences pour lesquelles il est possible de spécifier la taille, le framerate, le nombre de fois qu'une séquence est répétée.</li> - <li>Une transition PNG animée fait la liaison entre la séquence de <code>bootanimation.zip</code> et l'écran de verrouillage, effectuée par Gaia.</li> - <li>La taille de l'animation par défaut de l'animation est 8.2Mo (looping) + 3.6Mo (frame 18 transition) soit 11.8Mo au total.</li> - <li>À l'heure actuelle, l'animation d'extinction est une animation CSS basée sur les spécifications du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=809342" title="FIXED: [System] Need a shutdown animation implementation">bug 809342</a>.</li> -</ul> diff --git a/files/fr/archive/b2g_os/developing_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/index.html deleted file mode 100644 index b1d7092f1b..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Développer pour Gaia -slug: Archive/B2G_OS/Developing_Gaia -tags: - - Bugs - - Firefox OS - - Gaia - - Mozilla - - 'l10n:priority' -translation_of: Archive/B2G_OS/Developing_Gaia ---- -<div class="summary"> -<p><span class="seoSummary">Gaia comprend l'interface utilisateur de Firefox OS Gaia ainsi qu'un ensemble d'applications de base comme : l'écran de verrouillage, l'écran d'accueil, le clavier téléphonique, etc. Sur le fond, Gaia est un ensemble complexe d'applications web fonctionnant sur la plate-forme Firefox OS. Cette série d'articles illustre tous les aspects que vous devez connaître pour contribuer au projet Gaia.</span></p> -</div> - -<p>Dans ce guide, nous verrons les étapes pour contribuer à <em>Gaia</em> : apporter de nouvelles fonctionnalités à <em>Gaia</em> et/ou corriger des bugs qui concernent le projet <em>Gaia</em>. Le premier ensemble d'articles peut être lu dans l'ordre pour une introduction complète, ou bien, vous pouvez aller directement à la section qui vous intéresse pour un sujet en particulier.</p> - -<p>Les sections suivantes aborderont des documents de références ainsi que des informations supplémentaires sur des sujets connexes.</p> - -<p><img alt="Écran d'accueil de Gaia en français" src="https://mdn.mozillademos.org/files/10783/gaia.jpg" style="float: right; height: 569px; padding: 0px 0px 30px 30px; width: 320px;"></p> - -<h2 id="Les_bases">Les bases</h2> - -<ol> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Running_the_Gaia_codebase">Faire fonctionner le code de Gaia</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/comprendre_les_fondements_de_Gaia">Comprendre le code de Gaia </a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Making_Gaia_code_changes">Ajouter des modifications au code de Gaia</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Testing_Gaia_code_changes">Tester des modifications du code de Gaia</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Submitting_a_Gaia_patch">Soumettre un correctif pour Gaia</a></li> -</ol> - -<h2 id="Références_des_outils_de_construction_pour_Gaia">Références des outils de construction pour Gaia</h2> - -<ul> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Build_System_Primer">Le système de construction de Gaia</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Customizing_build-time_apps">Personnaliser les applications présentes à la construction</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/make_options_reference">Référence des options Make</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Gaia_tools_reference">Référence des outils pour Gaia</a></li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/Apps/Build/Localization">Localisation d'application</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Localizing_Firefox_OS">Localiser Firefox OS</a></li> - <li><a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour construire Firefox OS</a></li> - <li><a href="/fr/Firefox_OS/Developing_Firefox_OS/Rapporter_Bug_Firefox_OS">Rapporter des bugs sur Firefox OS</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Different_ways_to_run_Gaia">Les différentes façons de lancer Gaia</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Guide_version_personnalisée_Gaia">Guide de personnalisation (hors Gaia) pour la construction</a></li> - <li><a href="/fr/Firefox_OS/Developing_Gaia/Personnaliser_le_clavier">Personnaliser le clavier dans les applications Firefox OS</a></li> -</ul> - -<p> </p> - -<p></p><div class="overheadIndicator communitybox"> - - <div class="column-container"> - <h2 id="Rejoignez_la_communauté_Gaia">Rejoignez la communauté Gaia</h2> - <div class="column-half"> - <div class="communitysubhead">Choisissez votre méthode préférée pour rejoindre la discussion :</div> - <ul class="communitymailinglist"> - <li><a href="https://lists.mozilla.org/listinfo/dev-gaia"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.gaia"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.gaia/feeds"> Flux de syndication</a></li> -</ul> - </div> - <div class="column-half"> - <ul class="communitycontact"><li><strong>IRC: </strong><a href="irc://irc.mozilla.org/gaia">#gaia</a> <span class="smaller">(<a href="https://wiki.mozilla.org/IRC">en apprendre plus</a>)</span></li><li><strong>Autres salons IRC: </strong><a href="irc://irc.mozilla.org/fxos" title="Pour discuter de la plate-forme Firefox OS">#fxos</a>, <a href="irc://irc.mozilla.org/openwebapps" title="Discuter avec des développeurs d">#openwebapps</a>, <a href="irc://irc.mozilla.org/webapi" title="Discuter autour des API Web pour créer des applications web puissantes">#webapi</a></li></ul> - </div> - </div> -</div><p></p> diff --git a/files/fr/archive/b2g_os/developing_gaia/localiser_firefox_os/index.html b/files/fr/archive/b2g_os/developing_gaia/localiser_firefox_os/index.html deleted file mode 100644 index 564b9d653d..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/localiser_firefox_os/index.html +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Localiser Firefox OS -slug: Archive/B2G_OS/Developing_Gaia/Localiser_Firefox_OS -translation_of: Archive/B2G_OS/Developing_Gaia/Localizing_B2G_OS ---- -<div class="summary"> -<p><span class="seoSummary">Dans ce guide, nous vous montrerons qu'il est très facile de localiser Firefox OS et plus spécifiquement l'interface Gaia et les applications. Nous commencerons par vous aider à paramétrer votre ordinateur, puis comment traduire les chaines de Gaia et enfin comment effectuer des tests l10n sur votre travail.</span></p> -</div> - -<div class="note"> - <p><strong>A Noter</strong>: Ceci est un guide pour traducteurs voulant aider à traduire Firefox OS. Les développeurs voulant écrire des application traduisibles doivent débuter avec <a href="/en-US/Apps/Build/Localization/Localizing_Firefox_OS_Apps">Traduire des application Firefox OS</a>(en anglais), et ensuite regarder <a href="/en-US/Firefox_OS/Developing_Gaia/L10n_Best_Practices">Bonnes pratiques L10n</a>(en anglais).</p> -</div> - -<h2 id="Récupérer_les_outils">Récupérer les outils</h2> - -<p>Afin de pouvoir récupérer les fichiers sources de Gaia et tester votre localisation sur votre ordinateur, vous devrez vous assurer d'avoir les outils et langages de programmation installés dessus :</p> - -<dl> - <dt>GNU make</dt> - <dd>make est un petit outil très pratique pour créer des compilations à partir de code source. Il sera pratique quand vous serez prêt à tester votre travail de l10n sur votre ordinateur. Télécharger et installer make est facile et peut se faire <a href="http://www.gnu.org/software/make/" title="http://www.gnu.org/software/make/">directement à partir du site de GNU</a>. Si vous utilisez Mac OS X, vous aurez besoin d'installer XCode et les outils de ligne de commande d'XCode à partir de l'<a href="https://itunes.apple.com/us/app/xcode/id497799835?mt=12" title="https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=7&cad=rja&ved=0CFQQFjAG&url=https%3A%2F%2Fitunes.apple.com%2Fus%2Fapp%2Fxcode%2Fid497799835%3Fmt%3D12&ei=6ZItUeDqDeejiAK90IDYCA&usg=AFQjCNGrxKmVtXUdvUU3MhqZhP4MHT6Gtg&bvm=bv.42965579,d.cGE">App Store</a>.</dd> - <dt>git</dt> - <dd>git est un système de gestion de versions décentralisé utilisé pour stocker le code source de Gaia activement développé. Télécharger et installer git est facile et peut se faire <a href="http://git-scm.com/" title="http://git-scm.com/">directement via leur site web</a>.</dd> - <dt>Python</dt> - <dd>Python est un langage de programmation qui vous aidera aussi à créer des compilations de Firefox OS pour tester la localisation. Télécharger et installer Python est facile et peut se faire <a href="http://www.python.org/getit/" title="http://www.python.org/getit/">directement via leur site web.</a></dd> - <dt>Mercurial (hg)</dt> - <dd>Mercurial (hg) est un autre système de gestion de version qui contient les versions stables de Gaia utilisées pour la l10n, ainsi que les dépôts de locale. Télécharger et installer Mercurial est facile et peut se faire <a href="http://mercurial.selenic.com/downloads/" title="http://mercurial.selenic.com/downloads/">directement via leur site web.</a></dd> - <dt>compare-locales</dt> - <dd>compare-locales est un script Python qui aide les traducteurs à évaluer leur travail et à séparer le nouveau contenu à localiser du contenu déjà localisé (C'est un diff). Télécharger et installer compare-locales est facile et peut se faire<a href="https://developer.mozilla.org/en-US/docs/Compare-locales" title="https://developer.mozilla.org/en-US/docs/Compare-locales"> directement à partir de la page wiki compare-locales</a>. Cela est nécessaire seulement si vous localisez Gaia en utilisant seulement la ligne de commande ou un éditeur de texte. Si vous utilisez un outil comme Pootle, Transifex, ou Pontoon, vous n'avez pas besoin de cet outil.</dd> -</dl> - -<h2 id="Mis_en_place_d'un_dépôt_local">Mis en place d'un dépôt local</h2> - -<p>Après avoir téléchargé et installé les logiciels de la liste ci-dessus, il est temps d'obtenir les sources et les chaines localisées sur votre ordinateur.</p> - -<ol> - <li>Dans votre outil de ligne de commande, naviguez vers l'emplacement où vous stockerez les sources de Gaia et les chaines localisées.</li> - <li>En utilisant hg, clonez le dépôt en-US dans l'emplacement par défaut en entrant la première commande ci-dessous. - <pre>hg clone https://hg.mozilla.org/gaia-l10n/en-US -</pre> - </li> - <li>Ensuite clonez le dépot de votre locale en utilisant une commande avec la structure ci-dessous. Par exemple, la deuxième ligne permet de cloner le dépot de Chinois traditionnel dans un dossier approprié. - <pre>hg clone https://hg.mozilla.org/gaia-l10n/votre-code-de-locale -hg clone https://hg.mozilla.org/gaia-l10n/zh-TW/ B2G/gaia/locales/zh-TW</pre> - </li> - <li>Ensuite tapez la commande suivante : - <pre class="brush: json">LOCALE_BASEDIR=locales/ LOCALES_FILE=locales/languages_mine.json make</pre> - </li> -</ol> - -<p>Les fichiers de locale devraient être listés dans le fichier <code>languages_mine.json</code>, qui aura une structure ressemblant à ça :</p> - -<pre class="brush: json">{ - "en-US" : "English (US)", - "fr" : "Français (fr)" -}</pre> - -<p>Dans ce fichier vous devriez avoir une liste des chaines prête à traduire ! Veuillez noter que si vous commencez une nouvelle localisation de Firefox OS, vous n'avez pas besoin de créer un diff car toutes les chaines sont de nouvelles chaines à traduire.</p> - -<div class="note"> -<p><strong>Note </strong>: Reportez-vous à <a href="https://gist.github.com/timdream/7716684">ce gist</a> pour un script de compilation automatique de locale.</p> -</div> - -<p> </p> - -<h2 id="Traduire_des_chaines_Gaia">Traduire des chaines Gaia</h2> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Le flux de travail</span> <span class="hps">pour traduire</span> <span class="hps">les chaînes</span> <span class="hps">Gaia</span> <span class="hps">dépend en grande partie</span> <span class="hps">des outils</span> <span class="hps">que vous utilisez pour</span> <span class="hps">traduire</span><span>.</span></span> Cette partie du processus est similaire à la phase habituelle de traduction des autres produits Mozilla. La <a href="https://developer.mozilla.org/en-US/docs/Localization_Quick_Start_Guide/Translation_phase" title="https://developer.mozilla.org/en-US/docs/Localization_Quick_Start_Guide/Translation_phase">page de phase de traduction du guide rapide de localisation</a> contient une liste de tous les outils utilisés pour traduire des chaines dans les produits Mozilla ainsi que des tutoriels sur comment traduire avec ces outils. Cette page vous sera utile si vous faites partie d'une équipe l10n. Elle vous aidera à choisir quel outil utiliser pour traduire les chaines de Gaia et vous proposera des tutoriels sur ces outils.</div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<h2 id="Tester_la_localisation_pour_Firefox_OS">Tester la localisation pour Firefox OS</h2> - -<p>Il existe deux méthodes principales pour effectuer des tests L10n sur Firefox OS : les compilations desktop et les compilations mobiles. Actuellement, la méthode desktop est la plus utilisée pour les test L10n.</p> - -<h3 id="Tester_la_l10n_sur_desktop">Tester la l10n sur desktop</h3> - -<ol> - <li>Téléchargez et installez la <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">dernière compilation nocture de boot2gecko pour desktop</a> — téléchargez le package qui correspond à votre système d'exploitation. Recherchez les paquets qui contiennent le mot <em>localizer</em> à l'intérieur. Cela indique que cette compilation possède toutes les locales activées listées dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_all.json" title="https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_all.json"><code>languages-all.json</code></a>.</li> - <li>Clonez la dernière version de Gaia en naviguant dans le dossier sur votre ordinateur où vous souhaiter là télécharger et entrez cette commande dans votre utilitaire de ligne de commande : <code>git clone git://github.com/mozilla-b2g/gaia.git</code></li> - <li>Si votre équipe localise Firefox OS pour la première fois, vous aurez besoin d'activer la locale. Si non prenez un verre, pendant que tout le monde active sa locale. - <ol> - <li>Dans votre terminal, naviguez à l'intérieur de votre clone de Gaia et exécutez cette commande pour cloner le dépôt de votre locale : <code>hg clone ssh://hg.mozilla.org/gaia-l10n/votre-code-de-locale</code></li> - <li>Ouvrez le fichier <code>languages.json</code> situé dans le dossier <code>shared/resources</code> dans le dépôt gaia que vous venez juste de cloner.</li> - <li>Ajoutez l'information de votre locale correspondant à ce format : "en-US" : "English (US)", et enregistrez votre fichier.</li> - <li>Pour finir, exécutez la commande : <code>make multilocale</code>. Cela active votre locale sur votre build desktop.</li> - </ol> - </li> - <li>Create your Gaia profile by running this command: <code>DEBUG=1 make -C gaia profile</code></li> - <li>Finally, you can run Firefox OS with your locale profile and begin testing. Do this by entering this command: <code>b2g/b2g -profile gaia/profile</code>. If you're using OS X, run this command: <code>/Applications/B2G.app/Contents/MacOS/b2g -profile gaia/profile</code></li> - <li>To update your desktop builds, simply navigate to your Gaia repo clone and enter this command: <code>git pull</code></li> -</ol> - -<h3 id="Mobile_l10n_testing">Mobile l10n testing</h3> - -<p><em>This section will grow as more devices that support Firefox OS become available to localizers.</em></p> - -<h3 id="What_to_look_for_when_l10n_testing">What to look for when l10n testing</h3> - -<p>Localization testing for a mobile operating system has some similarites to localization testing for a desktop application. Here are some guidelines on what to look for when performing localization testing on your work:</p> - -<ol> - <li>See if your translations fit inside UI text elements.</li> - <li>Ensure that the tone, style, and terminology are consistant throughout the entire product.</li> - <li>Look for untranslated English strings in the UI. These may be hard-coded into Gaia or they may caused by element ID errors.</li> - <li>Make sure that time and dates display according your regions standards.</li> -</ol> - -<h2 id="Finding_localization-specific_bugs">Finding localization-specific bugs</h2> - -<p>Here are some links to bugzilla in order to give you examples of bugs that have been encountered while using the phones. This will give you an idea of where to look at for bugs as well as an example in filing these kinds of bugs.</p> - -<ul> - <li><a class="moz-txt-link-freetext" href="http://bit.ly/100bcsC">http://bit.ly/100bcsC</a> - this is a general list of l10n B2G bugs</li> - <li><a class="moz-txt-link-freetext" href="https://bugzilla.mozilla.org/show_bug.cgi?id=846060">https://bugzilla.mozilla.org/show_bug.cgi?id=846060</a></li> - <li><a class="moz-txt-link-freetext" href="https://bugzilla.mozilla.org/show_bug.cgi?id=852739">https://bugzilla.mozilla.org/show_bug.cgi?id=852739</a></li> -</ul> - -<p>General rules when filing a Localization bug:</p> - -<ul> - <li>if the bug is specific to the language, then file under the Mozilla Localization (under Other Products) and cc the localizer. Don't forget to flag your bug with the appropriate tracking flag</li> - <li>if it's not specific to the language, file under FirefoxOS Product, and cc the localizer. Don't forget to flag your bug with the appropriate tracking flag</li> - <li>If you are in doubt, file under FirefoxOS Product, and cc the localizer. Don't forget to flag your bug with the appropriate tracking flag</li> -</ul> - -<p>For those of you who use <a href="http://moztrap.mozilla.org/" title="http://moztrap.mozilla.org/">Moztrap</a>, looking at the existing test cases under the FirefoxOS "localization" tags and seeing if you can pass the tests on your device is also a good way to test Firefox OS localizations.</p> - -<h2 id="What's_next">What's next?</h2> - -<p>Now you're ready to start localizing! So open up your favorite l10n tool and go for it! As always, if you have questions that are not covered in this document, please send them to the <a href="http://www.mozilla.org/about/forums/#dev-l10n" title="http://mailto:_dev-l10n@lists.mozilla.org">mozilla.dev.l10n newsgroup</a>.</p> diff --git a/files/fr/archive/b2g_os/developing_gaia/personnalisation_applications_présentes_construction/index.html b/files/fr/archive/b2g_os/developing_gaia/personnalisation_applications_présentes_construction/index.html deleted file mode 100644 index 1c7baba326..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/personnalisation_applications_présentes_construction/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Personnaliser les applications présentes lors de la construction -slug: >- - Archive/B2G_OS/Developing_Gaia/Personnalisation_applications_présentes_construction -tags: - - Apps - - B2G - - Customization - - Firefox OS - - Gaia - - Guide -translation_of: Archive/B2G_OS/Developing_Gaia/Customizing_build-time_apps ---- -<div class="summary"> - <p><span class="seoSummary">Si vous êtes développeur ou vendeur d'appareil, vous voudrez personnaliser et choisir les applications qui seront présentes sur l'appareil quand il sera utilisé pour la première fois. Cet article explique les différents outils pour le faire.</span></p> -</div> -<h2 id="Emplacement_des_applications_dans_Gaia">Emplacement des applications dans Gaia</h2> -<p>Les applications qui fonctionnent sur Firefox OS sont toutes contenues dans les dossiers de Gaia, dans l'un de ces deux répertoires :</p> -<ul> - <li><a href="https://github.com/mozilla-b2g/gaia/tree/master/apps">gaia/apps/</a> : Les applications par défaut du système se trouvent à cet endroit (par exemple : le calendrier, les e-mails, les réglages, etc.).</li> - <li><a href="https://github.com/mozilla-b2g/gaia/tree/master/dev_apps">gaia/dev-apps/</a> : Les autres applications se trouvent ici, notamment celles qui participent à la personnalisation.</li> -</ul> -<p>Si vous souhaitez enlever/ajouter certaines applications pour votre construction (<em>build</em>) de Gaia/B2G, vous disposez de plusieurs outils décrits ci-après.</p> -<h2 id="Méthode_brute">Méthode brute</h2> -<p>La méthode « brute » consiste à supprimer les applications que vous ne souhaitez pas installer lors du <em>build </em>(avant de lancer le processus de construction).</p> -<h2 id="Éditer_les_listes_de_configuration">Éditer les listes de configuration</h2> -<p>Une méthode plus fine consiste à éditer les fichier <code>apps-*.list</code> (qui se trouve dans un répertoire différent en fonction de l'appareil et qui est sous <a href="https://github.com/mozilla-b2g/gaia/tree/master/build/config">gaia/build/config/</a>, comme <code>phone/</code> et <code>tablet/</code>). Dans ces fichiers, il suffit d'ajouter les applications que vous souhaitez intégrer lors de la construction. Par exemple, <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/phone/apps-production.list">gaia/build/config/phone/apps-production.list</a> ressemble à :</p> -<pre class="brush: bash">apps/bluetooth -apps/bookmark -apps/browser -apps/calendar -apps/callscreen -etc.</pre> -<p>Vous pouvez également indiquer d'utiliser toutes les applications d'un répertoire, de la façon suivante :</p> -<pre class="brush: bash">apps/*</pre> -<p>Le mécanisme utilisé pour déterminer quel fichier <code>apps-*.list</code> est utilisé pendant la construction est décrit dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/Makefile">gaia/Makefile</a>, et ressemble à :</p> -<pre class="brush: cpp"><span class="nv">GAIA_DEVICE_TYPE</span><span class="o">?=</span>phone - ... -GAIA_APP_TARGET?=engineering - ... -ifeq ($(MAKECMDGOALS), demo) -GAIA_DOMAIN=thisdomaindoesnotexist.org -GAIA_APP_TARGET=demo -else ifeq ($(MAKECMDGOALS), dogfood) -DOGFOOD=1 -else ifeq ($(MAKECMDGOALS), production) -PRODUCTION=1 -endif - ... -ifeq ($(PRODUCTION), 1) -GAIA_OPTIMIZE=1 -GAIA_APP_TARGET=production -endif - -ifeq ($(DOGFOOD), 1) -GAIA_APP_TARGET=dogfood -endif - ... -ifndef GAIA_APP_CONFIG -GAIA_APP_CONFIG=build$(SEP)config$(SEP)apps-$(GAIA_APP_TARGET).list -endif</pre> -<p>Au départ, la variable <code>GAIA_APP_TARGET</code> vaut <code>engineering</code> et la variable <code><span class="nv">GAIA_DEVICE_TYPE</span></code> vaut <code>phone</code>, par défaut, la construction de Gaia utilisera<a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/phone/apps-engineering.list"> gaia/config/phone/app-engineering.list</a> (qui contient l'ensemble des tests, des démos, etc.)</p> -<p>Pour définir l'utilisation souhaitée, il faut utiliser les différentes options de la commande <code>make</code>. Par exemple, pour construire Gaia avec <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/phone/apps-production.list">gaia/build/config/phone/apps-production.list</a>, il faut utiliser l'option suivante :</p> -<pre class="brush: bash">PRODUCTION=1 make</pre> -<p>Si vous utilisez <code>DEMO=1</code>, le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/phone/apps-demo.list">apps-demo.list</a> sera utilisé. Si vous choisissez le paramètre <code>DOGFOOD=1</code>, la construction utilisera le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/phone/apps-dogfood.list">apps-dogfood.list</a>.</p> -<p>Vous pouvez totalement contrôler le choix en éditant <code>GAIA_APP_CONFIG</code> dans le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/Makefile">gaia/Makefile</a>, et en fournissant votre propre fichier <code>apps-*.list</code>.</p> -<p><a href="https://github.com/mozilla-b2g/gaia/blob/master/Android.mk#L24-L28">gaia/Android.mk</a> contient ces lignes :</p> -<pre class="brush: cpp">ifneq ($(filter user userdebug, $(TARGET_BUILD_VARIANT)),) -GAIA_MAKE_FLAGS += PRODUCTION=1 -B2G_SYSTEM_APPS := 1 -endif</pre> -<p>Lors de la construction, si <code>VARIANT=user</code> ou si <code>VARIANT=userdebug</code> sont choisis (et sont repercutés dans la variable <code>TARGET_BUILD_VARIANT</code>), <code>PRODUCTION=1</code> sera automatiquement défini lors de la construction de Gaia.</p> -<div class="note"> - <p><strong>Note</strong> : Pour trouver plus d'informations sur les options de make, voir la <a href="/fr/Firefox_OS/Developing_Gaia/make_options_reference">référence des options de make</a>.</p> -</div> -<h2 id="Utiliser_le_système_de_personnalisation_(Market_customizations)">Utiliser le système de personnalisation (<em>Market customizations</em>)</h2> -<p>La troisième méthode est la plus fine (et également la plus complexe) et utilise le système de personnalisation. Ce système permet de définir des instructions de personnalisation pour la construction et ce, sans modifier le cœur de Gaia. Vous pouvez inclure les personnalisations de votre choix dans des dossiers distincts ou bien en utilisant les répertoires existants.</p> -<p>Par exemple, en définissant l'emplacement des personnalisations grâce à la variable d'environnement <code>GAIA_DISTRIBUTION_DIR</code> comme ça :</p> -<pre class="brush: bash"><code class="language-html">GAIA_DISTRIBUTION_DIR=<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>DISTRIBUTION_PATH</span><span class="token punctuation">></span></span> make production</code></pre> -<p>Pour plus d'exemples sur le mécanisme de distribution, voir <a href="https://github.com/mozilla-b2g/gaia/tree/master/customization">https://github.com/mozilla-b2g/gaia/tree/master/customization</a></p> -<p>Les personnalisations sont un sujet à part entière, pour plus d'informations sur ce sujet, lire <a href="/en-US/Firefox_OS/Developing_Firefox_OS/Market_customizations_guide">le guide du système de personnalisation (<em>Market customizations</em>)</a>.</p> -<div class="note"> - <p><strong>Note </strong>: Si vous souhaitez inclure des applications externes dans votre build de Gaia, vous devrez les construire d'une certaine façon, puis les placer dans le répertoire <code>gaia/dev-apps/</code>. Lire l'article <a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Firefox_OS/Market_customizations_guide#Building_Prebundled_web_apps">Construire des applications web pré-packagées</a> pour en savoir plus.</p> -</div> -<div class="warning"> - <p><strong>Important</strong> : Si vous êtes distributeur ou fabricant de matériel et que vous souhaitez construire une version spécifique de B2G/Gaia pour la distribuer, vous devez répondre à certains critères pour avoir l'autorisation d'inclure le Marketplace Firefox sur vos téléphones/tablettes. Merci de contacter Mozilla pour plus de détails.</p> -</div> -<p> </p> diff --git a/files/fr/archive/b2g_os/developing_gaia/personnaliser_le_clavier/index.html b/files/fr/archive/b2g_os/developing_gaia/personnaliser_le_clavier/index.html deleted file mode 100644 index 46dd2b2731..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/personnaliser_le_clavier/index.html +++ /dev/null @@ -1,177 +0,0 @@ ---- -title: Personnaliser le clavier dans Firefox OS -slug: Archive/B2G_OS/Developing_Gaia/Personnaliser_le_clavier -tags: - - Firefox OS - - Guide - - keyboard -translation_of: Archive/B2G_OS/Developing_Gaia/Customizing_the_keyboard ---- -<div class="summary"> -<p>Ce document explique comment ajouter des agencements de clavier contenant leur propres langues/scripts à Firefox OS v1.2 et supérieur .</p> -</div> - -<h2 id="Statut_de_l'application_clavier_Gaia_intégrée_architecture_système">Statut de l'application clavier Gaia intégrée & architecture système</h2> - -<p>Deux fonctionnalités majeures du clavier ont été implémentées dans Firefox OS depuis octobre 2013 :</p> - -<ul> - <li>Une option de compilation pour activer ou désactiver l'inclusion du clavier/dictionnaire du vérificateur d'orthographe dans la compilation de l'application clavier Gaia intégrée (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=884752" title="FIXED: keyboard build-time customization">bug 884752</a>).</li> - <li>Une fonctionnalité au niveau du système d'exploitation qui permet à l'utilisateur d'installer une application clavier tierce depuis le Firefox Marketplace. Elle sera disponible à partir de Firefox OS v2.0. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=816869" title="FIXED: [Meta] Enable third-party keyboards">bug 816869</a> et <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=964670" title="FIXED: [Keyboard][User Story] Enable 3rd party keyboard framework with OOP">bug 964670</a> pour plus de détails.</li> -</ul> - -<p>Pour ajouter un nouvel agencement de clavier sur votre téléphone, vous pouvez mettre un fichier d'agencement dans Gaia et compiler l'application clavier en utilisant la configuration de compilation, ou développer votre propre application clavier et l'installer sur le téléphone. Nous allons voir comment réaliser chacune de ces opérations.</p> - -<h2 id="Développer_votre_propre_application_clavier">Développer votre propre application clavier</h2> - -<p>Vous pouvez vous servir de l'application clavier de Gaia comme d'un modèle. Les idées de base sont :</p> - -<ul> - <li>Dans le fichier<em>manifest</em> , déclarez votre application comme ayant le role de <code>input</code> dans la propriété <a href="/fr/Apps/Manifeste#role"><code>role</code></a>.</li> - <li>Assurez-vous d'avoir spécifié la permission <code>input</code> dans la propriété <a href="/fr/Apps/Manifeste#permissions"><code>permissions</code></a></li> -</ul> - -<p>Une fois que c'est fait, vous pouvez installer votre clavier et il sera affiché dans la moitié basse de l'écran à chaque fois que l'utilisateur sera sur un champ de saisie. Pour gérer l'espace pris par le clavier, vous pouvez :</p> - -<ul> - <li>utiliser la méthode classique <code>window.resizeTo</code> pour mettre à jour la surface qui doit être prise par l'application</li> - <li>utiliser la nouvelle <code>navigator.mozInputMethod</code> API pour modifier le contenu en fonction de l'<code>input</code>. Voir la méthode <a href="https://dxr.mozilla.org/mozilla-central/source/dom/webidl/InputMethod.webidl">WebIDL de l'API</a> pour plus de détails. Beaucoup de ces méthodes affichent les mêmes caractères mais génèrent pourtant des évènements différents (<a href="/fr/docs/Web/API/KeyboardEvent">KeyboardEvent</a>, <a href="/fr/docs/Web/API/CompositionEvent">CompositionEvent</a>, etc), alors assurez vous d'utiliser <a href="https://wiki.mozilla.org/WebAPI/KeboardIME">la bonne méthode selon le cas d'utilisation(en anglais)</a>.</li> -</ul> - -<div class="note"> -<p><strong>À noter</strong>: La démonstration du <a href="https://github.com/mozilla-b2g/gaia/tree/master/dev_apps/test-keyboard-app">clavier LOL</a> doit vous aider à mieux comprendre comment les applications clavier sont conçues, et vous servir de modèle pour vos propres applications clavier.</p> -</div> - -<h2 id="Inclure_un_agencement_personnalisé_dans_l'application_clavier_de_Gaia">Inclure un agencement personnalisé dans l'application clavier de Gaia</h2> - -<ol> - <li>Voir le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/keyboard/CONFIGURE">CONFIGURE de l'application clavier</a> pour plus d'informations. Selon les langues à ajouter, vous devrez éventuellement ajouter un dictionnaire ou ajouter un Input Method (IME) interactif (pour les langages asiatiques)</li> - <li>Si vous ajoutez des agencements pour de nouvelles langues, vous pouvez les ajouter comme agencements par défaut dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/build/config/keyboard-layouts.json">build/config/keyboard-layouts.json</a>.</li> -</ol> - -<h3 id="IME_Asiatiques">IME Asiatiques</h3> - -<p>Les langues de l'Asie orientale (<a href="https://fr.wikipedia.org/wiki/Chinois,_japonais_et_cor%C3%A9en">le chinois, le japonais, et le coréen</a>) utilisent une graphie composée de milliers de caractères. Comme il est impossible d'avoir des milliers de touches sur un clavier matériel ou logiciel, les utilisateurs se servent d'un programme d'indexation appelé <a href="https://fr.wikipedia.org/wiki/M%C3%A9thode_d%27entr%C3%A9e">éditeur de méthode de saisie (ou <em>input method editor</em>)</a> (IME) qui permet de convertir une série de symboles en caractères.<br> - <br> - La façon dont les symboles doivent être convertis et l'efficacité de la méthode reposent sur l'implémentation du programme (et repose souvent sur la science du <a href="https://fr.wikipedia.org/wiki/Traitement_automatique_du_langage_naturel">traitement du langage naturel</a> qui ne peut être traitée entièrement ici). Pour économiser de la mémoire, il est conseillé que les données soient compilées dans un blob binaire et interprétées comme un <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer">tableau buffer</a>. Les structures JSON complexes ne fonctionneront pas sur certains appareils.</p> - -<h4 id="L'Interface_du_moteur_IM_dans_l'application_clavier_de_Gaia">L'Interface du moteur IM dans l'application clavier de Gaia</h4> - -<p>Si vous disposez d'une bibliothèque IME pour convertir des symboles en caractères, vous devrez utiliser l'interface définie dans l'application clavier de Gaia pour recevoir des symboles et afficher des caractères. <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/keyboard/js/keyboard/input_method_manager.js">La version de l'API est documentée sur Github</a>.</p> - -<p>Nous encourageons les implémentations d'IME pour affiner cette API de Gaia.</p> - -<h4 id="Faire_fonctionner_le_moteur_IM_avec_l'agencement">Faire fonctionner le moteur IM avec l'agencement</h4> - -<p>Pour faire fonctionner le moteur IM avec votre agencement de clavier :</p> - -<ol> - <li>Ajoutez un agencement dans layout.js comme décrit précédemment.</li> - <li>Utilisez la propriété <code>imEngine</code> pour faire référence au moteur IM. Lorsque l'agencement est activé, l'application de clavier chargera le script situé à <code>keyboard/js/imes/<moteurIM>/<moteurIM>.js</code>.</li> - <li>Paramétrez les API pour recevoir/envoyer des touches/caractères lorsque le script est chargé et initialisé.</li> - <li>Gérez les saisies de l'utilisateur comme vous le souhaitez. Généralement, lorsque l'utilisateur utilise des touches du clavier, cela envoie des données au moteur IM.</li> -</ol> - -<h4 id="Implémentations_connues">Implémentations connues :</h4> - -<ul> - <li><a href="https://github.com/timdream/jszhuyin">JSZhuyin</a> est la première implémentation du clavier Gaia avec un moteur IM asiatique, pour le chinois traditionnel et qui intègre l'IME Zhuyin.</li> - <li><a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/keyboard/js/imes/jskanji">JSKanji</a> est un prototype de moteur IM pour le japonais.</li> - <li><a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/keyboard/js/imes/jspinyin">JSPinyin</a> est écrit pour le chinois simplifié et fonctionne en saisissant des symboles Pinyin.</li> - <li>Pour démonstration, <a href="http://chewing.csie.net/">Chewing</a>, est une version C/C++ open-source de l'IME Zhuyin pour le chinois traditionnel et a été <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=845685">cross-compilé avec emscripten</a> puis lié au clavier Gaia.</li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=835261">JSHangul</a> est un prototype de moteur IM pour le coréen et est en cours de développement.</li> -</ul> - -<h3 id="Les_nouvelles_locales_et_la_localisation">Les nouvelles locales et la localisation</h3> - -<p>Ce qui suit peut s'appliquer aux systèmes d'écriture alphabétiques, ceux qui utilisent un alphasyllabaire (comme la devanagari) ou un système idéographique (comme le chinois) sont plus complexes.</p> - -<p>Généralement, deux éléments sont nécessaires : un <strong>clavier </strong>et un <strong>lexique </strong>(pour la prédiction du texte).</p> - -<h4 id="Créer_un_agencement_clavier">Créer un agencement clavier</h4> - -<p>L'agencement du clavier est contenu dans un fichier JavaScript et définit les touches du clavier et la correspondances entre les touches et les lettres et les symboles, ainsi que les options de clavier utilisées avec les pressions longues. La méthode la plus simple consiste à récupérer un clavier existant sur <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/keyboard/js/layouts">GitHub</a>, de le renommer et de l'ajuster.</p> - -<p>Tout d'abord, il faut changer l'en-tête. Si, par exemple, votre clavier d'origine est proche du clavier anglais (en-US) et que vous voulez en créer un pour la locale gaélique écossaise (gd), vous pouvez éditer le fichier suivant (grâce à un éditeur comme Notepad++) :</p> - -<pre>Keyboards.en = { - label: 'English', - shortLabel: 'En', - imEngine: 'latin', - types: ['text', 'url', 'email', 'number', 'password'], - autoCorrectLanguage: 'en_us', - menuLabel: 'English',</pre> - -<p>en :</p> - -<pre>Keyboards.gd = { - label: 'Scottish Gaelic', - shortLabel: 'gd', - imEngine: 'latin', - types: ['text', 'url', 'email', 'number', 'password'], - autoCorrectLanguage: 'gd_gb', - menuLabel: 'Gàidhlig',</pre> - -<p>Le champ <code>label</code> doit être celui de votre langue en anglais, le champ <code>shortLabel</code> ne doit pas mesurer plus de trois caractères. Il sera utilisé comme abréviation sur le clavier afin que l'utilisateur sache quel langage il utilise. Vous pouvez utiliser le code ISO de la langue ou autre chose si vous pensez que c'est pertinent. Le champ <code>menuLabel</code> est le nom de la langue exprimé dans la langue en question : c'est ce que l'utilisateur verra dans le menu des options.</p> - -<p>Si l'agencement du clavier est proche de celui que vous souhaitez, la seule chose à faire consiste à modifier les caractères alternatifs (auxquels on accède avec une pression longue sur la touche) :</p> - -<pre>alt: { - a: 'áàâäåãāæ', - c: 'çćč', - e: 'éèêëēę€ɛ', - i: 'ïíìîīį', - o: 'öõóòôōœøɵ', - u: 'üúùûū', - s: 'ßśš$', - S: 'ŚŠ$', - n: 'ñń', - l: 'ł£', - y: 'ÿ¥', - z: 'žźż', - '.': ',?!;:' -},</pre> - -<p>Vous pouvez ainsi changer l'ordre des caractères affichés lors de la pression longue. Pour notre exemple, le gaélique utilise plus d'accents graves que d'accents aigus et on peut changer l'ordre en :</p> - -<pre>a: 'àáâäåãāæ',</pre> - -<p>On peut aussi vouloir proposer des consonnes pointées et ajouter de nouvelles lignes comme celle-ci :</p> - -<pre><span class="nx">b</span><span class="o">:</span> <span class="s1">'ḃ'</span><span class="p">,</span></pre> - -<p>On peut également vérifier l'agencement alternatif (celui qui propose les nombres, la ponctuation, etc.) et le symbole monétaire affiché.</p> - -<h4 id="Créer_un_lexique">Créer un lexique</h4> - -<p>Avoir un lexique permet de proposer une prédiction à la saisie (plutôt que les utilisateurs aient à taper chaque lettre de chaque mot). Pour le construire, vous avez (idéalement) besoin d'un corpus de mots classés par fréquence d'utilisation. Par exemple, le mot <em>demain</em> est plus fréquemment utilisé que <em>démiurge </em>et devrait donc être proposé avant lorsque l'utilisateur saisit un texte.</p> - -<p>Pour le faire, on assigne des nombres de 1 (fréquence la plus faible) à 255 (fréquence la plus forte) à chaque mot (c'est-à-dire chaque ligne) du lexique (un fichier XML dont vous pouvez trouver un exemple <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/keyboard/js/imes/latin/dictionaries">ici</a>). Voici ce que vous devrez créer :</p> - -<pre><wordlist locale="gd" description="Gàidhlig" date="1401554807" version="1"> - <w f="255" flags="">a</w> - <w f="254" flags="">an</w> - <w f="247" flags="">agus</w></pre> - -<p>Même si le corpus est construit rapidement à partir d'un texte suffisamment important (et en comptant les fréquences des mots de ce corpus), cela permettra d'assurer la fonctionnalité de prédiction. Si vous ne disposez pas de telles données au format numérique pour votre locale, utilisez votre connaissance du lexique pour trier manuellement les termes les plus communs selon vous.</p> - -<h4 id="Construire_les_fichiers">Construire les fichiers</h4> - -<p>Une fois que vous disposez du fichier javascript et du fichier de lexique, allez dans <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/keyboard/js/imes/latin/dictionaries">ce répertoire gaia</a> puis ouvrez <em>Makefile</em>. Ajoutez le nom du dictionnaire à votre liste (si, pour l'exemple, il est nommé <em>gd_wordlist.xml</em>), cela sera :</p> - -<pre>ga.dict \ -gd.dict \</pre> - -<p>Assurez vous que le fichier <code>gd_worldlist.xml</code> soit dans le répertoire puis lancez <code>$ make gd.dict</code></p> - -<p>Si vous êtes arrivés jusqu'à ce point et que vous n'arrivez pas à passer cette dernière étape de construction, merci de <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20OS">remplir un bug</a> (<strong>Composant : Gaia Keyboard</strong>) et de joindre vos fichiers en expliquant le problème. Quelqu'un devrait pouvoir vous aider.<strong> Assurez-vous de soumettre le correctif comme une pull request, et de le marquer <em>à revoir (review) par quelqu'un</em>, sinon, le bug pourra passer inaperçu.</strong></p> - -<h4 id="Tester_une_nouvelle_locale">Tester une nouvelle locale</h4> - -<p>Une fois que vous avez construit et envoyé les fichiers pour la nouvelle locale, vous pouvez simplement tester votre clavier et lexique sur la page web de démonstration qui utilise l'application clavier. Vous pouvez le clôner et l'essayer localement depuis <a href="https://github.com/timdream/gaia-keyboard-demo">ici</a>. En cliquant sur 'En', vous pouvez parcourir les différentes locales. Si vous ne pouvez pas trouver la vôtre, cliquez sur le bouton situé en haut à droite pour cocher/décocher les claviers que vous souhaitez tester.</p> - -<h2 id="Discussion_et_QA_(qualité)">Discussion et QA (qualité)</h2> - -<p>Rendez-vous sur la liste de diffusion <a href="https://lists.mozilla.org/listinfo/dev-gaia">dev-gaia</a> ou sur le canal #gaia sur irc.mozilla.org (voir <a href="https://wiki.mozilla.org/IRC">Mozilla IRC (en anglais)</a> pour plus de détails. #mozilla-taiwan est le canal chinois pour ce sujet.<br> - <br> - </p> diff --git a/files/fr/archive/b2g_os/developing_gaia/référence_options_make/index.html b/files/fr/archive/b2g_os/developing_gaia/référence_options_make/index.html deleted file mode 100644 index c5670cd54c..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/référence_options_make/index.html +++ /dev/null @@ -1,331 +0,0 @@ ---- -title: Référence des options de make -slug: Archive/B2G_OS/Developing_Gaia/Référence_options_make -tags: - - Apps - - Firefox OS - - Gaia - - Make - - Options - - Reference - - Référence(2) -translation_of: Archive/B2G_OS/Developing_Gaia/make_options_reference ---- -<div class="summary"> -<p><span class="seoSummary">La commande <code>make</code> est utilisée à l'intérieur du dépôt Gaia pour créer un profil qui peut être chargé vers un appareil ou être lancé dans une version de <a href="/fr/Firefox_OS/Using_the_B2G_desktop_client">B2G Desktop</a>. Cet article illustre en détail les différentes options pour <code>make</code>.</span></p> -</div> - -<div class="note"> -<p><strong>Note</strong> : De nombreuses variables d'environnement sont utilisées dans le fichier Makefile. Celles-ci pouvant être supprimées à l'avenir, attention à ne pas construire d'outils qui reposeraient sur ces variables.</p> -</div> - -<p>Les profils créés sont généralement enregistrés à la racine du répertoire de Gaia, par exemple <code>/gaia/profil</code>. Un profil contient généralement les éléments suivants :</p> - -<ul> - <li><code>defaults/</code> : Le répertoire qui contient les paramètres par défaut qui sont utilisés lors que le téléphone est réinitialisé.</li> - <li><code>extensions/</code> : Le répertoire qui contient les extensions.</li> - <li><code>settings.json </code>: Le fichier de paramètres.</li> - <li><code>user.js</code> : Une autre fichier qui contient les paramètres utilisateurs (autrement appelés préférences).</li> - <li><code>webapps/</code> : Le répertoire qui contient l'ensemble des applications web à installer sur le téléphone.</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: Lorsque vous souhaitez construire un nouveau profil après en avoir déjà construit un, vous devez supprimer le profil existant au préalable.</p> -</div> - -<h2 id="Utilisation_par_défaut">Utilisation par défaut</h2> - -<pre class="brush: bash">make</pre> - -<p>Cette commande créera une version neutre de Gaia, qui ne peut pas être utilisée pour le débogage. Pour construire une version avec une certaine marque, vous devrez utiliser <a href="#Official_Mozilla_branding_make">Official Mozilla branding make</a> ; pour construire une version de débogage, vous devrez utiliser <a href="#Debug_make">Debug make</a>.</p> - -<h2 id="Envoyer_vers_l'appareil">Envoyer vers l'appareil</h2> - -<pre class="brush: bash">make install-gaia - -make reset-gaia -</pre> - -<p>Une fois <a href="/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> (Android Debug Bridge) paramétré, ces « <em>cibles</em> » de <code>make</code> enverront Gaia sur l'appareil. <code>install-gaia</code> enverra uniquement les mises à jour depuis le répertoire de travail alors que <code>reset-gaia</code> nettoiera l'ensemble des configurations, profils, applications web et données en base avant d'envoyer Gaia sur l'appareil (cela créera une nouvelle base de données pour les réglages).</p> - -<div class="note"> -<p><strong>Note </strong>: Lorsque les commandes <code>make install-gaia</code> / <code>make reset-gaia</code> sont utilisées, Gaia est envoyée vers le téléphone avec une résolution par défaut qui est celle des ressources utilisées (1x). Pour définir un niveau de définition plus élevé, vous devrez utiliser les options<code> GAIA_DEV_PIXELS_PER_PX</code> ou <code>GAIA_DPPX</code> (voir le paragraphe <a href="/en-US/Firefox_OS/Developing_Gaia/make_options_reference#High_resolution_image_assets">Images en haute résolution</a> pour plus de détails sur ces options.). Lorsque vous envoyez Gaia sur votre appareil de cette façon, il est nécessaire de préciser (en plus des options des autres options de <code>make</code>) le facteur de forme de l'appareil. Ainsi pour un Flame, on aura <code>make install-gaia GAIA_DEV_PIXELS_PER_PX=1.5</code> (ou 2, ou 2.5, etc.). Pour plus d'informations, voir le tableau des facteurs de forme dans l'article <a href="/fr/Apps/Build/Icon_implementation_for_apps#512_icon_for_device_display">icônes de 512 pixels pour l'affichage sur l'appareil</a>.</p> -</div> - -<h2 id="Construire_des_applications_spécifiques">Construire des applications spécifiques</h2> - -<pre class="brush: bash">APP=system make - -APP=system make install-gaia</pre> - -<p>Lorsqu'un profil existe déjà, l'option <code>APP</code> vous permet de spécifier les applications à réempaqueter plutôt que de réempaqueter puis de réenvoyer toutes les applications sur l'appareil. On notera que, bien que cette commande envoie le nouveau paquet de l'application ainsi que le manifeste, les changements du manifeste (ex. : les nouvelles permissions ou les agencements de clavier) ne sont pas détectés par Gecko.</p> - -<h2 id="Définir_un_répertoire_spécifique_pour_le_profil">Définir un répertoire spécifique pour le profil</h2> - -<p>Vous pouvez définir un répertoire spécifique dans lequel construire votre profil en utilisant l'option <code>PROFILE_FOLDER</code>. Par exemple :</p> - -<pre class="brush: bash">PROFILE_FOLDER=profile-b2g-desktop make</pre> - -<h2 id="Construire_pour_les_différents_types_d'appareil">Construire pour les différents types d'appareil</h2> - -<p>Il existe des options pour spécifier le type d'appareil visé.</p> - -<h3 id="Construire_une_version_de_Gaia_pour_téléphone">Construire une version de Gaia pour téléphone</h3> - -<pre class="brush: bash">GAIA_DEVICE_TYPE=phone make</pre> - -<p>Les applications pour cette versions seront celles de la liste<code> /gaia/build/config/phone/apps-engineering.list</code>.</p> - -<h3 id="Construire_une_version_de_Gaia_pour_tablette">Construire une version de Gaia pour tablette</h3> - -<pre class="brush: bash">GAIA_DEVICE_TYPE=tablet make</pre> - -<p>Les applications utilisées pour la construction seront celles de la liste <code>/gaia/build/config/tablet/apps-engineering.list</code>.</p> - -<h3 id="Créer_une_version_spark_de_Gaia">Créer une version spark de Gaia</h3> - -<pre class="brush: bash">GAIA_DISTRIBUTION_DIR=distros/spark make reset-gaia -</pre> - -<p>Installe spark sur votre appareil. L'option du build.sh de B2G est celle-ci :</p> - -<pre class="brush: bash">GAIA_DISTRIBUTION_DIR=distros/spark ./build.sh -</pre> - -<h2 id="Les_différents_types_de_version">Les différents types de version</h2> - -<p><code>make </code>dispose d'options pour préciser le type de version qu'on souhaite construire (chaque type de version ayant un objectif distinct) :</p> - -<h3 id="Version_de_production">Version de production</h3> - -<pre class="brush: bash">PRODUCTION=1 make</pre> - -<p>Cette instruction crée une version de production de Gaia. Cela signifie que :</p> - -<ul> - <li>Les applications de Gaia sont empaquetées, ce qui les rend plus difficile à déboguer mais ce qui permet la meilleure gestion des permissions d'API, etc.</li> - <li>Les applications de test ne sont pas intégrées à cette version</li> - <li>Par défaut, le débogage à distance est désactivé</li> - <li>L'écran de déverrouillage est activé (ce qui entraînera une coupure des connexions USB en cours)</li> - <li><a href="/docs/Mozilla/QA/Marionette">Marionette</a> est désactivé</li> - <li>L'écran de première utilisation est activé</li> - <li>Le cache hors ligne est activé.</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: Pour cette instruction, vous pouvez également utiliser l'alias <code>make production</code>.</p> -</div> - -<h3 id="Version_de_débogage">Version de débogage</h3> - -<pre class="brush: bash">DEBUG=1 make</pre> - -<p>La variable <code>DEBUG</code> permet de lancer Gaia avec des applications hébergées sur un serveur web intégré accessible sur le port <code>GAIA_PORT</code>, plutôt que les applications soient empaquetés et aient besoin d'être réempaquetés à chaque modification. Cela permet de tester plus facilement. Si vous lancez ce profil avec une version de Firefox Nightly, vous pourrez utiliser une version spécifique des outils de développement adaptée à B2G.</p> - -<p>De plus :</p> - -<ul> - <li>Les applications de tests sont inclues dans la version construite</li> - <li>Le débogage à distance est activé par déafut</li> - <li>L'écran de verrouillage est désactivé (les connexions USB ne seront pas interrompues)</li> - <li><a href="/docs/Mozilla/QA/Marionette">Marionette</a> est activé, ce qui permet de lancer les <a href="/Firefox_OS/Platform/Automated_testing/Gaia_unit_tests" title="/Firefox_OS/Platform/Automated_testing/Gaia_unit_tests">tests unitaires</a> de Gaia</li> - <li>L'écran de première utilisation est désactivé</li> - <li>Le cache hors ligne n'est pas activé, même s'il est généré.</li> -</ul> - -<div class="note"> -<p><strong>A noter</strong>: Il y a un bogue ouvert (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180103" title="B2G desktop client get an empty homescreen when run w/ debug profile (gaia/profile-debug)">bug 1180103</a>) lors de l'utilisation de profils debogage Gaia, provoque l'affichage d'un écran d'accueil vide quand il est lancé au travers de Firefox OS Simulator (ou WebIDE, ou autre.) Cela peut être contourné en construisant avec <code>DEBUG=1 DESKTOP=0 make</code> à la place (voir <a href="#Version_de_débogage_pour_l'appareil">Version_de_débogage_pour_l'appareil</a>.)</p> -</div> - - -<h3 id="Version_de_débogage_pour_l'appareil">Version de débogage pour l'appareil</h3> - -<pre class="brush: bash">DEVICE_DEBUG=1 make</pre> - -<p>Cela désactive l'écran de déverrouillage et active le débogage via les outils ADB, ce qui permet de déboguer ce qui se passe sur l'appareil.</p> - -<p>Dans Firefox OS > 1.2, il faut préciser ce paramètre si vous voulez déboguer des applications web dans le <a href="/fr/docs/Outils/WebIDE">WebIDE</a>.</p> - -<h3 id="Version_de_débogage_sur_ordinateur">Version de débogage sur ordinateur</h3> - -<pre class="brush: bash">DEBUG=1 DESKTOP=0 make</pre> - -<p>Cette option permet de créer une version de débug pour ordinateur, à utiliser avec <a href="/Firefox_OS/Building_the_B2G_desktop_client">B2G pour ordinateur (<em>B2G desktop</em>)</a>.</p> - -<h3 id="Version_officielle_de_Mozilla">Version officielle de Mozilla</h3> - -<pre class="brush: bash">MOZILLA_OFFICIAL=1 make</pre> - -<p>Cette option permet de construire une version officielle de Mozilla.</p> - -<h3 id="Version_pour_l'utilisation_en_test(dogfood)">Version pour l'utilisation en test(<em>dogfood</em>)</h3> - -<pre class="brush: bash">DOGFOOD=1 make</pre> - -<p>Les options et utilitaires liés à une utilisation à des fins de tests sont activés. Par exemple, l'application sur les retours/informations d'utilisation (<em>feedback</em>) sera activée.</p> - -<h3 id="Version_pour_les_applications_système">Version pour les applications système</h3> - -<pre class="brush: bash">B2G_SYSTEM_APPS=1 make</pre> - -<p>Cette variable d'environnement vous permet d'envoyer une application sur <code>/system/b2g</code> plutôt que sur <code>/data/local</code>. Vous devriez utiliser cette option lorsque vous travaillez sur une version utilisateur. Cette variable est définie automatiquement lorsque vous utilisez la commande <code>make production</code>. Cette variable peut également être utilisée avec <code>install-gaia</code> ou <code>reset-gaia</code>.</p> - -<h3 id="Personnaliser_et_distribuer_une_version">Personnaliser et distribuer une version</h3> - -<pre class="brush: bash">GAIA_DISTRIBUTION_DIR=./dir</pre> - -<div class="note"> -<p><strong>Note </strong>: Lire l'article <a href="/en-US/Firefox_OS/Hacking_Firefox_OS/Market_customizations_guide">Construire une version de Gaia customisée</a> pour plus d'informations.</p> -</div> - -<h2 id="Les_options_pour_le_débogagedéveloppement">Les options pour le débogage/développement</h2> - -<p>Certaines options de <code>make</code> permettent d'activer/désactiver des fonctionnalités de débogage ou de modifier des réglages utiles pour le développement.</p> - -<h3 id="Activer_le_débogage_à_distance">Activer le débogage à distance</h3> - -<pre class="brush: bash">REMOTE_DEBUGGER=1</pre> - -<p>Cela permet d'utiliser le débogage à distance pour l'appareil. Cela aura le même effet que d'activer l'option dans <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">les options de développement</a>.</p> - -<h3 id="Version_avec_optimisation_du_JavaScript">Version avec optimisation du JavaScript</h3> - -<pre class="brush: bash">GAIA_OPTIMIZE=1 make</pre> - -<p>Cette option déclenche un processus d'optimisation sur le code JavaScript utilisé pour Gaia qui consiste à concaténer/compresser les fichiers. Cette option est automatiquement utilisée avec <code>make production</code>. Cette option peut également être utilisée avec <code>install-gaia</code> ou <code>reset-gaia</code>.</p> - -<h3 id="Ressources_images_en_haute_résolution">Ressources images en haute résolution</h3> - -<pre class="brush: bash">GAIA_DEV_PIXELS_PER_PX=1.5 make</pre> - -<p>Ou, en utilisant l'alias :</p> - -<pre class="brush: bash">GAIA_DPPX=1.5 make</pre> - -<p>Lors de l'empaquetage de l'application, cette option remplacera les images par leurs équivalents <code>*@1.5x.(gif|jpg|png)</code> si ces fichiers existent. Vous aurez besoin d'utiliser l'option ci-dessus au sein d'une commande <code>make</code> standard, par exemple :</p> - -<pre class="brush: bash">GAIA_DEV_PIXELS_PER_PX=1.5 make reset-gaia - -GAIA_DEV_PIXELS_PER_PX=1.5 make install-gaia</pre> - -<p>Pour information, voici la liste des résolutions d'écran actuellement ciblées par Gaia :</p> - -<ul> - <li>qHD: ~540×960; device pixel ratio = 1.6875</li> - <li>WVGA: ~480×800; device pixel ratio = 1.5</li> - <li>HBGA (320x240); device pixel ratio = 1</li> -</ul> - -<p>Utilisez l'option <code>GAIA_DEV_PIXELS_PER_PX</code> pour être sûr que les images s'affichent correctement sur les appareils qHD et WVGA. Voir l'article <a href="/docs/Mozilla/Mobile/Balise_meta_viewport#A_pixel_is_not_a_pixel" title="/docs/Mozilla/Mobile/Balise_meta_viewport#A_pixel_is_not_a_pixel">un pixel n'est pas un pixel</a> pour plus d'informations sur les pixels physiques et les pixels CSS.</p> - -<h3 id="Lancer_les_tests_d'intégration">Lancer les tests d'intégration</h3> - -<p>Vous pouvez lancer les tests d'intégration de Gaia en utilisant make. Voir <a href="/en-US/Firefox_OS/Platform/Automated_testing/Gaia_integration_tests">Gaia integration tests</a> pour plus de détails.</p> - -<h3 id="Lancer_les_tests_de_performance_Raptor">Lancer les tests de performance Raptor</h3> - -<p>Vous devez effectuer une configuration permettant de lancer les tests Raptor sur votre périphérique, avant de lancer les tests. Voir <a href="/en-US/Firefox_OS/Automated_testing/Raptor">Raptor</a> pour plus de détails.</p> - -<pre class="brush: bash">make raptor -</pre> - -<h3 id="Profil_pour_les_appareils_avec_peu_de_mémoire">Profil pour les appareils avec peu de mémoire</h3> - -<pre class="brush: bash">GAIA_MEMORY_PROFILE=low make</pre> - -<p>Cette variable permet de générer un profil de Gaia qui utilise peu de mémoire. Cela permet de construire un profil adapté aux appareils avec peu de mémoire comme le Tarako.</p> - -<h3 id="Désactiver_l'écran_de_première_utilisation_(first_time_use_experience_-_FTU)">Désactiver l'écran de première utilisation (<em>first time use experience - FTU</em>)</h3> - -<pre class="brush: bash">NOFTU=1 -</pre> - -<p>Cette variable d'environnement permet de désactiver l'écran affiché lors de la première utilisation.</p> - -<h3 id="Désactiver_l'écran_de_déverrouillage">Désactiver l'écran de dé/verrouillage</h3> - -<p>Vous pouvez désactiver l'écran qui verrouille l'appareil en utilisant l'option <code>NO_LOCK_SCREEN</code>. Par exemple :</p> - -<pre class="brush: bash">NO_LOCK_SCREEN=1 make</pre> - -<h3 id="La_montée_en_charge_pour_le_volume_de_données">La montée en charge pour le volume de données</h3> - -<p>Plusieurs volumes de données de référence ont été créés pour permettre aux développeurs et aux testeurs d'installer rapidement un grand volume de données utilisées par plusieurs applications (généralement ce chargement a lieu sur un appareil nouvellement flashé).</p> - -<p>Les commandes suivantes permettent de charger différents volumes (à lancer depuis le répertoire de Gaia) :</p> - -<pre class="brush: bash">make reference-workload-light</pre> - -<ul> - <li>200 contacts</li> - <li>200 sms</li> - <li>50 entrées dans l'historique d'appel</li> - <li>20 images dans la galerie</li> - <li>20 chansons</li> - <li>5 vidéos</li> -</ul> - -<pre class="brush: bash">make reference-workload-medium</pre> - -<ul> - <li>500 contacts</li> - <li>500 sms</li> - <li>100 entrées dans l'historique d'appel</li> - <li>50 images dans la galerie</li> - <li>50 chansons</li> - <li>10 vidéos</li> -</ul> - -<pre class="brush: bash">make reference-workload-heavy</pre> - -<ul> - <li>1000 contacts</li> - <li>1000 sms</li> - <li>200 entrées dans l'historique d'appel</li> - <li>100 images dans la galerie</li> - <li>100 chansons</li> - <li>20 vidéos</li> -</ul> - -<pre class="brush: bash">make reference-workload-x-heavy</pre> - -<ul> - <li>2000 contacts</li> - <li>2000 sms</li> - <li>500 entrées dans l'historique d'appel</li> - <li>250 images dans la galerie</li> - <li>250 chansons</li> - <li>50 vidéos</li> -</ul> - -<p>Ces cibles peuvent être utilisées avec la variable d'environnement <code>APP</code> ou avec la variable<code> APPS</code> (contenant des noms d'applications, séparés par des espaces). Par exemple :</p> - -<pre class="brush: bash">APP=sms make reference-workload-light -APPS="sms communications/contacts" make reference-workload-heavy -</pre> - -<p>Les applications utilisables ici sont :</p> - -<pre class="brush: bash">APPS="gallery music video communications/contacts sms communications/dialer"</pre> - -<p>Pour installer des fichiers de musique dans la charge de données, vous devez avoir installé mid3v2. Cet utilitaire peut être installé avec la commande suivante :</p> - -<pre class="brush: bash">sudo apt-get install python-mutagen</pre> - -<p>Si vous utilisez Fedora ou RHEL, vous pouvez utiliser :</p> - -<pre class="brush: bash">sudo yum install python-mutagen</pre> - -<h3 id="Construire_la_documentation">Construire la documentation</h3> - -<p>La documentation relative à Gaia peut être construite grâce à jsdoc3. Pour générer la documentation, vous pouvez utiliser la commande suivante :</p> - -<pre class="brush: bash">make docs</pre> - -<h3 id="Activation_des_agencements_de_claviers_et_des_dictionnaires">Activation des agencements de claviers et des dictionnaires</h3> - -<p>Pour activer les agencements de clavier et les dictionnaires liés au moteur de saisie (<em>IME </em>pour <em>Input Method Editor</em> en anglais), vous pouvez utiliser la commande suivante :</p> - -<pre class="brush: bash">GAIA_KEYBOARD_LAYOUTS=en,zh-Hant-Zhuyin,el,de,fr,zh-Hans-Pinyin make</pre> - -<p>Actuellement, tous les claviers ne sont pas chargés par défaut en raison de problèmes d'espace disque. <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1029951" title="FIXED: Allow built-in keyboard app to download latin-IMEngine dictionary dynamically">bug 1029951</a> est en cours de résolution pour permettre de découpler les agencements et les dictionnaires (pour permettre aux utilisateurs de télécharger le dictionnaire).</p> diff --git a/files/fr/archive/b2g_os/developing_gaia/soumettre_correctif_pour_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/soumettre_correctif_pour_gaia/index.html deleted file mode 100644 index 323ed68cd7..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/soumettre_correctif_pour_gaia/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Soumettre un correctif pour Gaia -slug: Archive/B2G_OS/Developing_Gaia/Soumettre_correctif_pour_Gaia -tags: - - Bugzilla - - Firefox OS - - Gaia - - GitHub - - contribution - - patch - - submitting -translation_of: Archive/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch ---- -<div class="summary"> -<p><span class="seoSummary">À cette étape, vous devriez avoir apporté une modification au code de Gaia et avoir testé que cette modification n'impacte pas Gaia. La prochaine étape consiste à soumettre votre correctif sur le dépôt central. Cet article explique ces étapes.</span></p> -</div> - -<p>Soumettre des correctifs pour Gaia peut paraitre un peu déroutant, jusqu'à ce que vous en ayez pris l'habitude. Cela implique d'utiliser Bugzilla <strong>et</strong> Github, ainsi que l'utilisation de drapeaux spéciaux dans Bugzilla pour que tout se déroule correctement. Vous pouvez aussi voir à quoi ressemble le processus complet, dans la section <a href="#Envoi_manuel_d'un_correctif">Envoi_manuel_d'un_correctif</a>; cependant, nous vous conseillons d'utiliser l'outil Autolander au quotidien, sauf si vous avez une bonne raison de ne pas le faire, voir la section suivante.</p> - -<h2 id="Envoi_de_correctif_de_manière_aisée_avec_Autolander">Envoi de correctif de manière aisée avec Autolander</h2> - -<p><a href="https://github.com/mozilla/autolander">Autolander</a> est un outil qui prend en charge automatiquement, beaucoup d'étapes nécessaires à l'envoi d'un correctif pour Gaia (et d'autres projets qui l'utilisent), réduisant le temps, et les erreurs possibles, tout au long de la procédure. Autolander réalise l'automatisation des processus entre Bugzilla et Github en attachant les pull requests (de Github) aux bugs (de Bugzilla), et en les intégrants une fois que l'attachement à reçu un drapeau r+, et que le mot-clé <code>autoland</code> est ajouté au bug. Pour utiliser Autolander :</p> - -<ol> - <li>Tout d'abord, si le bug correspondant n'existe pas, créez-en un pour le produit <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20OS">Firefox OS</a>, et donnez-lui un titre explicite détaillant le but de votre correctif.</li> - <li>Vous pouvez alors <a href="https://help.github.com/articles/creating-a-pull-request">créer une <em>pull request</em></a> pour votre correctif. Si vous avez suivi ce guide depuis le début, vos changements devraient être présents dans une branche spécifique, unique, de votre fork en local. Pour ajouter vos modifications, faites <code>git add .</code> puis <code>git commit -m 'mon message de commit'</code>.</li> - <li><code>'mon message de commit'</code> devra être modifié afin de contenir le numéro de bug de Bugzilla et le titre du bug afin de donner plus d'informations sur ce que fait le correctif et qui doit l'examiner. Par exemple : - <pre class="brush: bash">Bug 9999999 - Corrige ce bug Toto R=jeanbiche</pre> - </li> - <li>Poussez votre code sur le fork de Gaia présent sur Github puis créez une <em>pull request</em> pour mettre à disposition le code de ce correctif.</li> - <li>Une fois que le <em>pull request</em> est ouvert, celui-ci est automatiquement attaché, au bug trouvé dans le titre du <em>PR</em>.</li> - <li>Prochainement, une fois que cet attachement aura reçu le drapeau r+ par un validateur, vous pourez ajouter le mot-clé <code>autoland</code>, dans le champ mots-clés "keywords" de bugzilla pour intégrer le code dans la branche master de Gaia. Autolander intègrera donc le code au master, mettra votre commit dans le bug, et marquera le bug comme résolu et corrigé "resolved fixed". Cependant, pour l'instant, cette fonctionnalité est toujours en cours de développement, donc pour le moment, vous devez ajouter le mot-clé "keyword" <code>checkin-needed</code>, et attendre qu'une personne intègre le code pour vous.</li> -</ol> - -<div class="note"> -<p><strong>A noter</strong> : Autolander lance des tests d'intégration avant d'intégrer un correctif au master. Si les tests d'intégration échouent, Autolander refusera d'intégrer le code. D'autres validations basiques sont effectuées, comme s'assurer que votre pull request et votre message de commit contiennent bien un numéro de bug.</p> -</div> - -<div class="note"> -<p><strong>A noter</strong> : Les pull request sont intégrés par ordre d'arrivé. Les pull request sont fusionnés à une branche d'intégration, et les tests d'intégration sont lancés en parallèle dans cette branche. Si un PR échoue les tests d'intégration, il est rejeté de la branche d'intégration, et nous reconstruisons la branche d'intégration avec les commits restants. Quand un commit passe, le master progresse de ce commit.</p> -</div> - -<h2 id="Envoi_manuel_d'un_correctif">Envoi manuel d'un correctif</h2> - -<p>Pour soumettre manuellement votre correctif à Gaia, suivez ces étapes :</p> - -<ol> - <li>Tout d'abord, si le bug correspondant n'existe pas, créez-en un pour le produit <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20OS">Firefox OS</a>, et donnez-lui un titre explicite détaillant le but de votre correctif.</li> - <li>Vous pouvez alors <a href="https://help.github.com/articles/creating-a-pull-request">créer une <em>pull request</em></a> pour votre correctif. Si vous avez suivi ce guide depuis le début, vos changements devraient être présents dans une branche spécifique, unique, de votre fork en local. Pour ajouter vos modifications, faites <code>git add .</code> puis <code>git commit -m 'mon message de commit'</code>.</li> - <li><code>'mon message de commit'</code> devra être modifié par une phrase contenant le titre du bug, ainsi que des informations supplémentaire sur ce que fait le correctif et qui doit l'examiner. Par exemple : - <pre class="brush: bash">Corrige ce bug Toto R=jeanbiche</pre> - Il est vraiment préférable d'indiquer un numéro de bug dans le message du commit, mais ne pas le faire est le seul moyen de contourner Autolander. Inutile de vous dire que ce n'est pas recommandé, vous devriez vraiment utiliser Autolander.</li> - <li>Poussez votre code sur le fork de Gaia présent sur Github puis créez une <em>pull request</em> pour mettre à disposition le code de ce correctif.</li> - <li>Ajoutez l'URL de cette <em>pull request</em> comme pièce jointe du bug sur Bugzilla (utilisez le lien « <em>Add an attachment</em> link », choisissez le mode texte pour la pièce jointe puis saisissez l'URL de la <em>pull request</em> comme contenu de la pièce jointe, vous pouvez ensuite saisir une description)</li> - <li>Pour cette pièce jointe sur la fiche Bugzilla, demandez à ce que votre correctif soit passé en revue. Pour le faire, ajoutez l'étiquette (<em>flag</em>) <code>review: ?</code> à la pièce jointe en incluant le nom du responsable du module concerné par votre code (voir la page <a href="https://wiki.mozilla.org/Modules/FirefoxOS">des responsables de module</a> pour plus d'informations (en anglais).)</li> - <li>Attendez qu'une personne soit affectée pour passer en revue votre correctif. À cette étape, généralement, cette personne demandera d'ajouter ou non des modifications à la <em>pull request </em>(PR) sur Github et de lier ces changements sur Bugzilla.</li> - <li>Effectuez les modifications demandées sur la même PR que précédemment puis reliez une pièce jointe avec le <em>flag</em> <code>review: ?</code>.</li> - <li>Une fois que vous avez effectué les modifications demandées et que vous avez obtenu le <em>flag</em> <code>r+</code> (qui signifie que le correctif a été revu/approuvé), vous devriez <a href="https://github.com/ginatrapani/todo.txt-android/wiki/Squash-All-Commits-Related-to-a-Single-Issue-into-a-Single-Commit">aplatir (squash) vos commits en un seul</a> (voir le paragraphe <a href="#Tips_on_Gaia_Rebasing">Tips_on_Gaia_Rebasing</a> ci-après).</li> - <li>Ajoutez un mot-clé <code>checkin-needed</code> dans le champ adéquat (<em>keywords</em>). Pour cette étape, vous devez désormais attendre que quelqu'un intègre (<em>land</em> en anglais) votre correctif au code source de Gaia.</li> - <li>Félicitations, votre code fait maintenant partie de Gaia et vous avez contribué à Firefox OS !</li> -</ol> - -<div class="note"> -<p><strong>Note</strong> : Il est recommandé de n'avoir qu'un seul commit par revue.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations sur la soumission de correctifs, lire le fichier <a href="https://github.com/mozilla-b2g/gaia/blob/master/CONTRIBUTING.md">contributing.md</a> sur le dépôt principal.</p> -</div> - -<h2 id="Conseils_pour_refonder_son_code_de_Gaia">Conseils pour refonder son code de Gaia</h2> - -<p>La branche <code>master</code> de Gaia évolue constamment (plusieurs fois par jour). Si vous avez passé deux heures à construire un correctif, il se peut que la branche ait été modifiée.<br> - <br> - Sur votre branche liée à votre correctif (ex : <code>mon-correctif</code>), vous pourrez refonder (<em>rebase</em> en anglais et pour git) grâce aux commandes suivantes :</p> - -<pre class="brush: bash">git checkout -b mon-correctif-r1 -git pull --rebase upstream master</pre> - -<p>S'il n'y a pas de conflits, vous pouvez continuer avec :</p> - -<pre class="brush: bash">git checkout mon-correctif -git pull --rebase upstream master -git branch -D mon-correctif-r1</pre> - -<p>Si vous avez des conflits, discutez-en avec le développeur qui a apporté les changements conflictuels puis répétez cette procédure une fois les conflits résolus.</p> - -<h2 id="Bugs_de_statut_et_bugs_techniques">Bugs de statut et bugs techniques</h2> - -<p>Certaines personnes chez Mozilla sont des <a href="/fr/docs/Mozilla/Developer_guide/Committing_Rules_and_Responsibilities">sheriffs</a>. Les sheriffs sont responsables de la fusion du code et de la maintenance des statuts des branches. Étant donné qu'il y a un nombre limité de sheriffs pour surveiller les échecs des tests sur Firefox OS, il est relativement difficile pour eux de détecter tous les correctifs défectueux.</p> - -<p>C'est pourquoi, pour Firefox OS, nous préférons ouvrir un nouveau bug pour livrer de nouveaux correctifs sur un problème s'il y a des échecs lorsqu'un correctif est passé en revue. Cela entraîne quelques complications pour le suivi des statuts pour les équipes qualité et gestion de projet.</p> - -<p>Pour cela, les bugs sont séparés entre bugs de statut et bugs techniques :</p> - -<ul> - <li>Les bugs de suivi de statut sont identifiés par le mot-clé "meta". Un bug de statut peut être réouvert s'il ne remplit pas les critères d'acceptation ou s'il a échoué au cours des étapes de reproduction.</li> - <li>Un bug technique ne devrait être réouvert que s'il échoue lors des tests automatisés ou que le correctif ne fonctionne pas entièrement. Si un correctif corrige partiellement le bug technique, vous devriez clôner le bug et utiliser le champ « <em>see also</em> » pour pointer vers le bug initial et décrire l'endroit où le premier correctif échoue.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Si ce bug correspond à un scénario d'utilisation (<em>user story</em> en anglais), le chef de projet en charge devrait compléter le champ correspondant (user story) ainsi que les critères d'acceptation.</p> -</div> - -<h3 id="Réparer_la_situation_si_vous_avez_intégré_un_correctif_sur_un_bug_de_suivi_de_statut">Réparer la situation si vous avez intégré un correctif sur un bug de suivi de statut</h3> - -<p>Si vous avez accidentellement livré un correctif sur un bug de suivi, qui ait été revu et intégré au code commun, voici ce que vous devez faire :</p> - -<ol> - <li>Utilisez le bouton « <em>Clone this bug</em> » situé en bas à droite de Bugzilla pour créer un nouveau bug et reproduire la plupart des champs du bug initial. Vérifiez ques les champs whiteboard, keyword, et STR/user story ont bien été copiés-collés dans le nouveau bug.</li> - <li>Mettez ce nouveau bug comme étant bloqué par l'ancien. Ce nouveau bug sera le nouveau bug de suivi de statut.</li> - <li>Utilisez le <em>flag</em> <em>« needinfo</em> » pour alerte le chef de projet concerné que le bug de statut à changé. Voici la liste <a href="https://wiki.mozilla.org/FirefoxOS/Teams">des adresses e-mail des différents chefs de projets pour Firefox OS</a> sur le wiki (en anglais).</li> - <li>Créez un nouveau bug technique décrivant les étapes pour reproduire et/ou les critères d'acceptations. Utilisez ce bug pour bloquer le nouveau bug de suivi de statut.</li> - <li>Essayez d'apporter un correctif pour ce nouveau bug. Bidouillez-bien :) !!!</li> -</ol> - -<h2 id="Livrer_des_correctifs_sur_d'anciennes_branches">Livrer des correctifs sur d'anciennes branches</h2> - -<p>Sur les bugs, vous pouvez voir les étiquettes concernant les différents versions. Si vous souhaitez soumettre un correctif pour une ancienne version de Firefox OS, vous devez vérifier que celui-ci respecte les règles d'acceptation expliquées sur la page d'<a href="https://wiki.mozilla.org/Release_Management/B2G_Landing">intégration à B2G (en anglais)</a>.</p> diff --git a/files/fr/archive/b2g_os/developing_gaia/tester_modifications_gaia/index.html b/files/fr/archive/b2g_os/developing_gaia/tester_modifications_gaia/index.html deleted file mode 100644 index 29cbfc8296..0000000000 --- a/files/fr/archive/b2g_os/developing_gaia/tester_modifications_gaia/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Tester les modifications du code de Gaia -slug: Archive/B2G_OS/Developing_Gaia/Tester_modifications_Gaia -tags: - - Firefox OS - - Gaia - - Guide - - Integration - - Testing - - UI -translation_of: Archive/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes ---- -<div class="summary"> -<p><span class="seoSummary">Une fois que vous avez apporté vos changements au code de Gaia et que ça semble fonctionner, vous devez effectuer des tests pour vous assurer que vos modifications fonctionnent, y compris avec le reste du code. Une fois que c'est le cas, vous pourrez proposer un correctif pour le projet. Cet article explique cette procédure de test.</span></p> -</div> - -<p>La procédure de test consiste généralement à :</p> - -<ul> - <li>Déboguer avec les outils standards</li> - <li>Lancer des tests automatisés</li> -</ul> - -<p>La suite de l'article explique chacune de ces étapes.</p> - -<h2 id="Déboguer_avec_les_outils_standards">Déboguer avec les outils standards</h2> - -<p>Si vous êtes développeur web, vous serez familier avec le débogage de Gaia. Dans l'article <a href="/en-US/Firefox_OS/Developing_Gaia/Running_the_Gaia_codebase#Running_Gaia_in_Desktop_Firefox">lancer Gaia dans Firefox pour ordinateur</a> et <a href="/en-US/Firefox_OS/Developing_Gaia/Making_Gaia_code_changes#Simple_code_change_example">comment apporter des modifications simples</a>, les outils de développement nécessaires ont déjà été présentés. Pour modifier le code de façon plus complexe, vous devrez tirer pleinement parti des outils de débogage présent dans l'écran de Firefox pour ordinateur.<br> - <br> - <strong>Note</strong> : Pour plus d'instructions sur l'utilisation de ces outils, voir <a href="/fr/docs/Outils">la section de MDN sur les outils de développement</a>.</p> - -<h2 id="Les_tests_automatisés">Les tests automatisés</h2> - -<p>Une fois le code édité, vous devez lancer la suite de tests standards qui accompagnent Gaia avant de soumettre un correctif. Cela doit vous permettre de vous assurer que vos modifications n'affectent pas les fonctionnalités essentielles existantes du téléphone. Les tests que vous pouvez lancer sont :</p> - -<ul> - <li>les tests unitaires</li> - <li>les test d'intégration</li> - <li>les tests de performance</li> - <li>les tests d'interface utilisateur</li> -</ul> - -<p>Généralement, il est demandé que lancer ces tests avant de soumettre un correctif. Si c'est votre première contribution, vous pouvez envoyer votre correctif sans avoir fait les tests. En revanche, vous devez demander de l'aide pour pouvoir lancer les tests à l'avenir. Avant de lancer les tests, veillez à mettre à jour votre dépôt de Gaia afin de disposer de la dernière version des tests.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations, vous pouvez lire la page sur les <a href="/en-US/Firefox_OS/Platform/Automated_testing">tests automatisés de Firefox OS</a>.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Si possible, lancez ces tests sur un vrai appareil si vous en avez un (certaines fonctionnalités ne sont pas supportées dans un émulateur). Si vous ne disposez pas d'un appareil Firefox OS, vous pouvez lancer les tests avec B2G Desktop ou Firefox Nightly.</p> -</div> - -<h3 id="Les_tests_unitaires">Les tests unitaires</h3> - -<p>Les tests unitaires sont des tests effectués sur des fragments (<em>unités</em>) de code, assemblés dans une application plus large. Pour le projet Gaia, ces unités sont les applications individuelles. Gaia utilise :</p> - -<ul> - <li><a href="http://visionmedia.github.io/mocha/">mocha</a> comme <em>framework</em> de test</li> - <li><a href="http://chaijs.com/api/assert/">chai</a> comme bibliothèque d'assertion</li> - <li><a href="http://sinonjs.org/">sinon.js</a> comme bibliothèque de copiage (<em>mock & stub</em>)</li> - <li><a href="http://blanketjs.org/">blanket.js</a> comme outil pour mesurer la couverture des tests</li> -</ul> - -<p>Pour installer et mettre en place un serveur de tests unitaires, vous pouvez lancer les commandes suivantes (cela peut prendre quelques minutes, vous pouvez en profitez pour vous faire une tasse de thé) :</p> - -<pre class="brush: bash">DEBUG=1 make -export FIREFOX=/Applications/FirefoxNightly.app/Contents/MacOS/firefox -bin/gaia-test -</pre> - -<p>Celà ouvrira une page web en local, avec une liste de tests unitaires. Pour les lancer :</p> - -<ul> - <li>Choisissez les tests que vous voulez lancer, à partir de la liste sur la page web précédemment ouverte (un astérisque apparaît auprès de chacun d'eux).</li> - <li>Appuyez sur le bouton exécuter "Execute".</li> - <li>Défilez la page vers le bas pour voir les résultats du test</li> -</ul> - -<p>Tout en maintenant la page web local ouverte, vous pouvez lancer la suite de tests complète, dans une nouvelle fenêtre de terminal, avec la commande suivantes :</p> - -<pre class="brush: bash">make test-agent-test</pre> - -<div class="note"> -<p><strong>Note </strong>: Cela peut prendre beaucoup de temps étant donné la quantité de tests à effectuer (jusqu'à environ une heure). Dans la plupart des cas, il n'est nécessaire que de lancer les tests pour l'application que vous avez modifiée. Vous pouvez restreindre les tests en ajoutant <code>APP=<nom du dossier de l'application></code> à la fin de la commande : par exemple <code>APP=settings</code>.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations sur les tests unitaires, vous pouvez également lire la page sur <a href="/fr/Firefox_OS/Platform/Automated_testing/Gaia_unit_tests">les tests unitaires de Gaia</a>.</p> -</div> - -<h3 id="Les_tests_d'intégration">Les tests d'intégration</h3> - -<p>Tester l'intégration consiste à tester comment les différentes unités de code fonctionnent entre elles. C'est l'étape logique qui intervient après les tests unitaires. Les tests d'intégration de Gaia utilisent Marionnette qui permet de lancer un script en JavaScript avec un serveur basé sur Python. Ce script peut communiquer avec Gecko et peut donc contrôler le navigateur ainsi que l'appareil Firefox OS et les faire interagir.</p> - -<p>Pour lancer les tests d'intégration, vous pouvez lancer la commande suivante :</p> - -<pre class="brush: bash">make test-integration</pre> - -<div class="note"> -<p><strong>Note</strong> : De même qu'avec les tests unitaires, lancer toute la suite de tests pour l'intégration peut prendre beaucoup de temps. Vous pouvez ajouter <code>APP=<dossier de l'application></code> à la fin de la commande pour ne tester qu'une seule application, par exemple <code>APP=calendar</code>.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: Pour lancer les tests d'intégration sur un périphérique différent, il faut ajouter <code>GAIA_DEVICE_TYPE=<device type="" name=""></code> à la commande précédente pour spécifier le type de périphérique, par exemple <code>GAIA_DEVICE_TYPE=tv</code>. Si ce n'est pas fait, les tests peuvent échouer.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Pour plus d'informations sur les tests d'intégration, lire l'article sur <a href="/fr/Firefox_OS/Platform/Automated_testing/Gaia_integration_tests">les tests d'intégration de Gaia</a>.</p> -</div> - -<h3 id="Les_tests_de_performance">Les tests de performance</h3> - -<p>Les tests de performance de Gaia sont lancés avec <a href="/fr/docs/Mozilla/Firefox_OS/Automated_testing/Raptor">l'utilitaire Raptor CLI</a>. Raptor permet d'automatiser le lancement d'une application plusieurs fois et d'afficher des statistiques sur sa durée de démarrage. Après un test, Raptor affiche de plus les informations d'utilisation mémoire de l'application.</p> - -<p>Pour lancer les tests de performance Raptor, voir <a href="/fr/docs/Mozilla/Firefox_OS/Automated_testing/Raptor#Getting_Started">Raptor: Bien commencer.</a></p> - -<h3 id="Les_tests_d'interfaces_utilisateurs">Les tests d'interfaces utilisateurs</h3> - -<p>Voir la page <a href="/Firefox_OS/Platform/Automated_testing/gaia-ui-tests">d'introduction sur les Tests d'interface utilisateur Gaia</a>.</p> diff --git a/files/fr/archive/b2g_os/dual_boot_de_b2g_et_android_sur_sgs2/index.html b/files/fr/archive/b2g_os/dual_boot_de_b2g_et_android_sur_sgs2/index.html deleted file mode 100644 index 3689a5cd26..0000000000 --- a/files/fr/archive/b2g_os/dual_boot_de_b2g_et_android_sur_sgs2/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Dual boot de B2G et Android sur SGS2 -slug: Archive/B2G_OS/Dual_boot_de_B2G_et_Android_sur_SGS2 -tags: - - Archive - - B2G - - Mobile -translation_of: Archive/B2G_OS/Building ---- -<p></p> - -<p></p><div class="warning warningHeader"> - <p><strong>Avertissement :</strong> Cette procédure ne fonctionne plus réellement. Elle fonctionne seulement avec Android 4 (Ice Cream Sandwich) et Siyah Kernel v 5.0.1. Les versions plus récentes ne fonctionnent pas non plus. Considerez ce guide comme archivé, vous l'utilisez à vos risques et périls.</p> -</div><p></p> - -<p>Si vous voulez tester B2G de temps en temps mais continuer à utiliser Android comme OS principal et vous possédez un Samsung Galaxy S2, vous pouvez installer B2G dans une partition séparée (qui est déjà présente dans le téléphone) et choisir qui booter au démarrage du système.</p> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Pour installer le dual boot Android et B2G, vous devez respecter ces prérequis :</p> - -<ul> - <li>Vous devez installer B2G pour Galaxy S2</li> - <li>Vous devez télécharger le <a href="http://d-h.st/AEZ">kernel Siyah</a> v. 5.0.1 pour Galaxy S2</li> - <li>Vous devez avoir l'outil simg2img, que vous optiendrez automatiquement en installant B2G selon le guide de MDN</li> - <li>Vous devez avoir l'outil heimdall, de préférence en version 1.3.1 car vous pourriez rencontrer des problèmes avec la version 1.3.2</li> -</ul> - -<h2 id="Liste_des_opérations">Liste des opérations</h2> - -<p>Il faut effectuer plusieurs opérations dans l'ordre pour obtenir un dual boot opérationel. Les instructions suivantes doivent être effectuées en premier uniquement.</p> - -<p>Pour utiliser heimdall sans accès root, vous devez créer un fichier android.rules (la partie précédent l'extension .rules est arbitraire) et le placer dans /etc/udev/rules.d. Le fichier doit contenir la ligne suivante:</p> - -<pre>SUBSYSTEM=="usb", ATTRS{idVendor}=="04e8", MODE="0666"</pre> - -<p>Pour activer cette règle, vous devez redémarrer udev:</p> - -<pre>sudo service udev restart</pre> - -<p>et débrancher/rebrancher le téléphone. La règle ci-dessus va également autoriser adb à accèder au SGS2 sans droit root.</p> - -<h3 id="Flasher_le_kernel_Siyah">Flasher le kernel Siyah</h3> - -<p>Le kernel Siyah kernel est obligatoire pour le dual boot, car c'est lui qui le gère. Une fois que vous avez téléchargé et décompressé le fichier .tar, vous optiendrez un fichier nommé zImage. Pour le flasher sur votre téléphone, vous devez suivre ces étapes:</p> - -<ol> - <li>Eteignez votre téléphone</li> - <li>Redémarrez en mode Download (appuyez simultanément sur les boutons "<em>volume</em> <em>bas</em>" + "<em>home</em>" + "<em>power</em>" puis quand le téléphone le demandera, "<em>volume haut</em>")</li> - <li>Utilisez heimdall pour flasher le kernel grâce à la commande suivante (le téléphone doit être connecté au PC): - <pre>heimdall flash --kernel /path/to/zImage</pre> - </li> -</ol> - -<p>Une fois le kernel flashé, le téléphone va redémarrer.</p> - -<h3 id="Préparer_l'environnement_de_la_rom_B2G">Préparer l'environnement de la rom B2G</h3> - -<p>Une fois le kernel Siyah installé, il faut utiliser ces fonctions pour préparer l'environnement à l'installation de l'image B2G dans la deuxième partition. Suivez ces étapes :</p> - -<ol> - <li>Eteignez votre téléphone</li> - <li>Redémarrez en mode recovery (Appuyez simultanément sur les boutons "<span style="display: none;" id="cke_bm_81S"> </span><em>volume</em> <em>haut</em><span style="display: none;" id="cke_bm_81E"> </span><span style="display: none;" id="cke_bm_79E"> </span>" + <em>"home"<span style="display: none;" id="cke_bm_82E"> </span> </em>+ <em>"power"</em>)<span style="display: none;" id="cke_bm_83E"> </span><span style="display: none;" id="cke_bm_80E"> </span></li> - <li>Dans l'interface tactile CWMR, allez dans "<em>dual-boot options</em>" -> Wipe 2ndROM data/cache -> Yes - Wipe. Cette opération prendra un certain temps.</li> -</ol> - -<p>Une fois l'opération terminée, sélectionnez Retour puis faites Redémarrer maintenant pour redémarrer votre téléphone. Si vous regardez dans la carte SD de votre téléphone vous verrez qu'il y a désormais un dossier .secondrom contenant 2 fichiers nommés cache.img et data.img.</p> - -<h2 id="Mise_à_jour_de_B2G">Mise à jour de B2G</h2> - -<p>Les opérations suivantes doivent être réalisées à chaque compilation d'une nouvelle version de B2G.</p> - -<p>Afin de simplifier les instructions en ligne de commandes, il est recommandé de copier tous les fichiers nécessaires dans le même dossier (celui de votre choix). Les fichiers suivant sont nécessaires et doivent être copiés à l'intérieur du dossier:</p> - -<ul> - <li>simg2img, trouvable dans B2G/out/target/product/galaxys2/system/bin/</li> - <li>system.img, trouvable dans B2G/out/target/product/galaxys2/</li> - <li>userdata.img, trouvable dans B2G/out/target/product/galaxys2/</li> -</ul> - -<p>Une fois que tout vos fichiers sont réunis au même endroit, effectuez les étapes suivantes:</p> - -<ol> - <li>Créez un fichier data.img file sur le fichier userdata.img. Vous pouvez le faire avec la commande suivante: - <pre>simg2img userdata.img data.img</pre> - </li> - <li>Mettez le fichier data.img file dans le dossier .secondrom de votre téléphone. Vous pouvez le faire soit via le mode de stockage de fichier sur votre téléphone puis en le connectant à votre PC, sinon si USB Debug est activé, vous pouvez utiliser adb: - <pre>adb push /path/to/data.img /sdcard/.secondrom/data.img</pre> - </li> - <li>Eteignez votre téléphone</li> - <li>Redémarrez le en mode téléchargement (pressez en même temps le bouton <em>"volume bas" + home + le bouton power</em> ensuite, lorsque cela sera demandé appuyez sur le bouton <em>"volume haut"</em>)</li> - <li>Utilisez heimdall pour flasher le firmware B2G dans la seconde partition: - <pre>heimdall flash --hidden system.img</pre> - </li> -</ol> - -<p>Une fois cela fait, votre téléphone va redémarrer et au démarrage vous pourrez démarrer sur votre seconde rom (B2G) en appuyant sur le bouton home pendant le décompte. Si tout s'est bien passé, une fois que vous aurez fini de démarrer sur B2G, un écran noir apparaîtra sur votre téléphone. Il vous faut maintenant installer Gaia.</p> - -<div class="note"><strong>Note:</strong> Tout dépend de la façon dont vous voulez tester B2G, mais vous pouvez ne pas avoir envie de mettre un nouveau fichier data.img file sur le téléphone à chaque mise à jour de B2G, sachant qu'il effacera toutes vos préférences, pour les applications installées et en général tout ce que vous aurez fait pendant l'utilisation de B2G.</div> - -<h2 id="Opérations_de_démarrage">Opérations de démarrage</h2> - -<p>Les opérations suivantes doivent être réalisées à chaque démarrage dans B2G.</p> - -<p>Malheureusement, il n'y a pas de technique simple permettant d'ajouter Gaia à l'intérieur de l'image système B2G system.img , de plus il sera perdu dès que vous éteindrez votre téléphone. De ce fait, il vous faudra installer Gaia à chaque démarrage sur B2G. Pour installer Gaia effectuez les commandes suivantes dans une console après avoir démarré sur B2G (vous devez avoir un écran noir) et avoir connecté votre téléphone à votre PC:</p> - -<pre>cd B2G/gaia -GAIA_DOMAIN=foo.org make install-gaia</pre> - -<p>Une fois le téléchargement de Gaia terminé, l'interface B2G apparaitra sur votre écran.</p> diff --git a/files/fr/archive/b2g_os/firefox_os_apps/building_blocks/index.html b/files/fr/archive/b2g_os/firefox_os_apps/building_blocks/index.html deleted file mode 100644 index 05289045d0..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_apps/building_blocks/index.html +++ /dev/null @@ -1,195 +0,0 @@ ---- -title: Firefox OS Building Blocks -slug: Archive/B2G_OS/Firefox_OS_apps/Building_blocks -tags: - - Design - - Design patterns - - Firefox OS - - NeedsTranslation - - TopicStub - - UI - - building blocks -translation_of: Archive/B2G_OS/Firefox_OS_apps/Building_blocks ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<div class="summary"> -<p>The Firefox OS Building Blocks are reusable UI components (also called 'common controls') that reflect OS-wide design patterns. Building Blocks are used to create the interfaces of all <a href="/en-US/Firefox_OS/Platform/Gaia">Gaia</a> default apps. You are free to make use of these components in your own Firefox OS apps, or general Web apps.</p> -</div> - -<h2 id="Using_the_Firefox_OS_Building_Blocks">Using the Firefox OS Building Blocks</h2> - -<p>The code for the Firefox OS Building Blocks can be found in the <a href="https://github.com/mozilla-b2g/gaia">Gaia Github repo</a> under <a href="https://github.com/mozilla-b2g/gaia/tree/master/shared/style">shared/style</a>. Here, you can find a CSS file that contains the CSS for that particular Building Block, and a sub directory containing the HTML fragments and image assets. If you are creating your own standalone Web app, you can simply copy the CSS, HTML and image asset files across into your own project; if your app is intended to be installed on Firefox OS only (or you want to use these features only when the app is being used on Firefox OS), then you can link to the versions available inside Gaia.</p> - -<p>The pages for the individual Building Block implementations can be found under the pages for each building block — see next section. These contain instructions on how to implement each one.</p> - -<div class="note"> -<p><strong>Note</strong>: The version 2.0 building block code is used in Firefox OS releases 2.0 through 2.2. Version 2.3 sees an update, with the building blocks being reimplemented using <a href="/en-US/docs/Web/Web_Components">Web components</a> — these provide the same functionality, but implemented in a much more powerful, flexible way. You'll see 2.3 pages appear underneath the main building block pages covering these Web components as soon as the information is available.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: We also have an old guide covering the <a href="/en-US/Apps/Design/Firefox_OS_building_blocks/1.x">v1.x building blocks</a> used in older versions of Firefox OS. This is mainly for legacy information.</p> -</div> - -<h2 id="Web_components_preliminary_setup">Web components preliminary setup</h2> - -<p>This section details the preliminary setup needed to use Gaia Web components.</p> - -<h3 id="Web_components_browser_support">Web components browser support</h3> - -<p>To use <a href="https://github.com/gaia-components">Gaia Web components</a> at all, you need to run them using a browser that supports Web components. The state of support is as follows:</p> - -<ul> - <li>Firefox: Supported since Firefox 23 (33 on Android), but preffed off. To enable Web components, go to <code>about:config</code> and enable the <code>dom.webcomponents.enabled</code> pref.</li> - <li>Chrome: Supported since Chrome 33 (39 on Android).</li> - <li>Opera: Supported since Opera 20 (24 on Android).</li> - <li>Android browser: Supported since 4.4.4.</li> - <li>Safari/iOS Mobile and IE/IE mobile: Nope.</li> -</ul> - -<p>Web components are supported in Firefox OS from v2.1 onwards, although most of them weren't actually implemented until v2.3. Be aware also that currently Web components won't work for Firefox OS apps below internal (certified) level. This restriction should be lessened in the future.</p> - -<div class="note"> -<p><strong>Note</strong>: If your app is certified, the components will just work. You don't need to set a specific manifest permission.</p> -</div> - -<h3 id="Web_components_installation_notes">Web components installation notes</h3> - -<p>Gaia Web components are installed in your app using the <a href="http://bower.io/">Bower</a> package manager. To install this, you first need <a href="http://nodejs.org/">Node.js/npm</a> and <a href="http://www.git-scm.com/">Git</a> installed. Once they are installed you can install Bower with</p> - -<pre class="brush: bash">npm install -g bower</pre> - -<p>At this point you could also install the Gaia Fira Sans font that Firefox OS uses in your app , with the following command:</p> - -<pre class="brush: bash">bower install gaia-components/gaia-fonts</pre> - -<p>You can then make use of the font by including the following in your head (along with a <code>font-family</code> of <code>FiraSans</code>):</p> - -<pre class="brush: html"><link rel="stylesheet" type="text/css" href="bower_components/gaia-fonts/style.css"></link></pre> - -<h2 id="Firefox_OS_Building_Blocks">Firefox OS Building Blocks</h2> - -<div class="column-container"> -<div class="column-half"> -<dl> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Action_menu">Action menu</a></dt> - <dd>An action menu presents a list of actions, related to the app's content, from which the user may make a selection.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Banners">Banners</a></dt> - <dd>Banners (Status, in older versions of Firefox OS) provide information to the user in a transitory fashion, typically to confirm an action or to alert the user to a system event.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Buttons">Buttons</a></dt> - <dd>Buttons are used to perform explicit actions. Buttons may be text or images.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Context_menu">Context menu</a></dt> - <dd>Accessed via a tap and hold gesture (sometimes called a <em>long press</em>), the Context Menu (called the Object Menu in older versions of Firefox OS) allows users to perform actions on objects without having to leave their current view.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Dialog">Dialog</a></dt> - <dd>A Dialog (Confirm, in older versions of Firefox OS) provides the user with some important information, asks the user to take or confirm an action, or allows the user to make a choice or enter some information.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Drawer">Drawer</a></dt> - <dd>The drawer is a scalable way for users to navigate between views or filter views. The drawer can also include links to app settings or other tools.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Header">Header</a></dt> - <dd>A header is a dedicated space at the top of the screen, most often used to display the view title. It can also include navigation, action buttons and other controls.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Input_area">Input area</a></dt> - <dd>An input area is a data entry field, and can be as simple as a text only entry field, or as complex as a multipart entry field with text entry, value selections, and buttons.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Layout">Layout</a></dt> - <dd>The Layout utility will help you to create common layout structures for your Firefox OS apps. Note that Layout is only available in Firefox OS 2.1 and above.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/List_items">List items</a></dt> - <dd>List items are typically used to navigate to a new screen, or to display information or controls.</dd> -</dl> -</div> - -<div class="column-half"> -<dl> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Picker">Picker</a></dt> - <dd>The Picker is designed to select a group of items as attachments for messaging and email.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Progress_and_activity">Progress and activity</a></dt> - <dd>Progress and activity indicators provide the user with visual feedback that a process (such as a resource loading) is active.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Scrolling">Scrolling</a></dt> - <dd>Scrolling areas allow the user to move text and/or images across the device's display.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Search">Search</a></dt> - <dd>Search is used to filter a list or find context-specific content.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Slider">Slider</a></dt> - <dd>A Slider (which was called Seekbar in older Firefox OS versions) is used to select a value from a continuous or discrete range of values by dragging the handle.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Select_mode">Select mode</a></dt> - <dd>Select Mode (which was called Edit Mode in older Firefox OS versions) is designed to select and perform actions on items.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Subheader">Subheader</a></dt> - <dd>Subheaders are used to describe a subsection of content.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Switches">Switches</a></dt> - <dd>Switches (such as checkboxes, etc.) allow users to activate and deactivate items. Switches are also used to select items within a list.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Tab_Filter">Tab/Filter</a></dt> - <dd>A Tab/Filter gives the user a way to easily switch between views or to filter a set of data.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Toolbars">Toolbars</a></dt> - <dd>Toolbars contain actions, indicators and navigation elements associated with the current view.</dd> - <dt><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/Value_selector">Value selector</a></dt> - <dd>Value Selectors let the user choose from among a list of possible values.</dd> -</dl> -</div> -</div> - -<div class="note"> -<p><strong>Note</strong>: For a detailed guide to the design pattern followed by the building blocks when the Arabic locale (bidirectional) is selected, read <a href="/en-US/Apps/Design/Firefox_OS_in_Arabic">Firefox OS in Arabic</a>.</p> -</div> - -<h2 id="Cross_browser_CSS">Cross browser CSS</h2> - -<p>Arnau March wrote a CSS file called <a href="https://github.com/mdn/gaia-2.0-bb/blob/gh-pages/cross_browser_css/cross_browser.css">cross browser CSS</a>, containing rules to allow Firefox 2.0 building blocks to render properly across different browsers (ie 9, Firefox 18, Chrome 24, Safari 5.1.) If you want to write hosted apps that look ok across different browsers, include this CSS in your project.</p> - -<h2 id="Browse_Firefox_OS_Building_Block_implementations_by_version">Browse Firefox OS Building Block implementations by version</h2> - -<p>The pages below list links to pages covering the Firefox OS Building Block implementations as they appear in different versions of Firefox OS.</p> - -<ul> - <li><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/2.3">Firefox OS 2.3 Web components</a></li> - <li><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/2.0">Firefox OS 2.0 building blocks</a> (covers Firefox OS 2.0–2.2.)</li> - <li><a href="/en-US/Apps/Design/Firefox_OS_building_blocks/1.x">Firefox OS 1.x building blocks</a> (covers older versions of Firefox OS.)</li> -</ul> diff --git a/files/fr/archive/b2g_os/firefox_os_apps/index.html b/files/fr/archive/b2g_os/firefox_os_apps/index.html deleted file mode 100644 index 0fe489e10a..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_apps/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Firefox OS apps -slug: Archive/B2G_OS/Firefox_OS_apps -tags: - - Apps - - Building - - Components - - Firefox OS - - Installing - - TopicStub - - device APIs -translation_of: Archive/B2G_OS/Firefox_OS_apps ---- -<p class="summary">Cette section de la documentation de Firefox OS couvre les techniques spécifiques requises - et les outils disponibles - pour créer des applications Firefox OS. Vous trouverez ci-dessous un certain nombre de détails, des blocs de construction / composants Web de Firefox OS aux API des appareils et à l'installation d'applications.</p> - -<h2 id="Création_dapplications_Firefox_OS">Création d'applications Firefox OS</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Building_apps_for_Firefox_OS">Création d'applications pour Firefox OS</a></dt> - <dd>Spécificités des applications de la plate-forme Firefox OS / Firefox, y compris les API d'installation et de gestion des applications, les fichiers manifestes, les applications packagées et hébergées, la gestion des autorisations d'API.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Localization">Localisation</a></dt> - <dd>Cet ensemble d'articles fournit des informations aux développeurs souhaitant fournir des versions localisées de leurs applications.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Performance">Performance</a></dt> - <dd>Cette page répertorie les sujets liés aux performances spécifiques à Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Firefox_Accounts_on_Firefox_OS">Comptes Firefox sur Firefox OS</a></dt> - <dd>Cet article fournit un aperçu de l'utilisation des <a href="/en-US/docs/Mozilla/Tech/Firefox_Accounts">comptes Firefox</a> dans Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Reference_apps">Applications de référence</a></dt> - <dd>Cette page répertorie un certain nombre d'exemples d'applications que nous avons rassemblées pour que vous puissiez télécharger, installer, jouer avec et apprendre. S'amuser!</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Screencast_series:_App_Basics_for_Firefox_OS">Série Screencast: Principes de base des applications pour Firefox OS</a></dt> - <dd>Dans cette collection de courtes vidéos, les développeurs de Mozilla et Telenor expliquent en quelques étapes comment vous pouvez commencer à créer des applications pour Firefox OS.</dd> -</dl> - -<h2 id="Blocs_de_construction">Blocs de construction</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Building_blocks">Blocs de construction</a></dt> - <dd>Les blocs de construction Firefox OS sont des composants d'interface utilisateur réutilisables (également appelés «contrôles communs») qui reflètent les modèles de conception à l'échelle du système d'exploitation. Les blocs de construction sont utilisés pour créer les interfaces de toutes les applications par défaut de <a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Gaia">Gaia</a>. Vous êtes libre d'utiliser ces composants dans vos propres applications Firefox OS ou dans vos applications Web générales.</dd> -</dl> - -<h2 id="Guides_de_style">Guides de style</h2> - -<dl> - <dt><a href="http://www.mozilla.org/en-US/styleguide/products/firefox-os/">Guide de style visuel de Firefox OS</a></dt> - <dd>Notre guide de style pour la conception visuelle de Firefox OS, couvrant les couleurs, la police, les arrière-plans, les icônes d'application et la conception d'éléments d'interface utilisateur spécifiques.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Copy_styleguide">Guide de style de copie de Firefox OS</a></dt> - <dd>Ce guide décrit les règles que nous suivons pour écrire une copie d'application Firefox OS, mais peut être utilisé comme guide général pour écrire une bonne copie pour toutes les interfaces d'application.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Firefox_OS_in_Arabic">Firefox OS en arabe</a></dt> - <dd>Un guide de l'implémentation de conception UX spécifique que Firefox OS a mis en place pour traiter l'arabe (et d'autres langues RTL.)</dd> -</dl> - -<h2 id="Éléments_de_conception">Éléments de conception</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Design_asset_library">Bibliothèque d'éléments de conception de Firefox OS</a></dt> - <dd>Dans cette section, vous trouverez des éléments de conception, des illustrations, des modèles graphiques, des polices et d'autres matériaux qui vous seront utiles lors de la conception des applications Firefox OS / Gaia.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Icon_font">Police de l'icône Firefox OS</a></dt> - <dd>Firefox OS dispose de son propre jeu de polices d'icônes: cet article explique comment l'utiliser dans vos propres applications.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Transitions">Transitions de Firefox OS</a></dt> - <dd>Une référence à certaines des transitions utilisées dans Firefox OS pour se déplacer entre différents états dans les applications, y compris des GIF animés illustrant les animations utilisées, ainsi que des exemples de code pour afficher le code d'animation CSS nécessaire pour implémenter ces animations.</dd> -</dl> - -<h2 id="Références">Références</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Firefox_OS_device_APIs">API des appareils Firefox OS</a></dt> - <dd>Cet article fournit une liste de pages couvrant ces API, ainsi que les autorisations du <a href="https://developer.mozilla.org/en-US/Apps/Build/Manifest">manifeste d'application</a> pour chacune d'entre elles.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Firefox_OS_app_tools">Outils de l'application Firefox OS</a></dt> - <dd>Cette page fournit une liste d'outils, de bibliothèques, d'exemples, etc. qui sont utiles aux développeurs d'applications Firefox OS, que vous souhaitiez copier un modèle de code ou que vous ayez besoin d'aide pour ajouter une fonctionnalité spécifique à votre application Firefox OS.</dd> -</dl> - -<h2 id="Autres_sujets_dapplication">Autres sujets d'application</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/Porting_Chrome_apps">Portage des applications Chrome vers les applications Firefox OS</a></dt> - <dd>Cet article décrit les différences entre les applications Chrome et les applications Firefox OS, et comment vous pouvez convertir entre les deux.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_apps/App_development_FAQ">FAQ sur le développement d'applications</a></dt> - <dd>Cette FAQ est une compilation de réponses aux questions courantes sur le développement d'applications.</dd> -</dl> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/en-US/docs/Mozilla/Marketplace">Firefox Marketplace</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/how_to_get_started_with_tv_apps_development/index.html b/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/how_to_get_started_with_tv_apps_development/index.html deleted file mode 100644 index 84e03356af..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/how_to_get_started_with_tv_apps_development/index.html +++ /dev/null @@ -1,173 +0,0 @@ ---- -title: Comment débuter avec le développement d'application pour TV -slug: >- - Archive/B2G_OS/Firefox_OS_Connected-Devices_Guide/How_to_get_started_with_TV_apps_development -translation_of: Mozilla/Firefox_OS_for_TV ---- -<h2 id="Introduction">Introduction</h2> - -<p>Ce document est écrit pour les développeurs web qui sont intéressés par le développement d'applications pour TV. Nous allons parler de la façon de compiler et lancer le simulateur Firefox OS avec une application smart-TV, puis nous verrons comme il est facile d'écrire une application et de la déployer sur une TV.</p> - -<p>Fondamentalement, réaliser une application qui fonctionne sur les TV est similaire à faire une application classique Firefox OS, sauf pour les particularité suivantes :</p> - -<ul> - <li>Contrairement à une application Firefox OS classique, il faut évidemment prendre en compte que les applications TV sont majoritairement contrôlées par une télécommande, qui peut être comparé à contrôler l'application avec un clavier.</li> - <li>La résolution sur les smart TV modernes est Full HD (1920x1080) et Ultra HD (4K). Le ratio Device Pixel sur les TV est aussi important que pour la plupart des appareils mobiles.</li> -</ul> - -<p>Vous pouvez vous rendre sur l'App Center pour plus de ressources sur les constructions d'application pour Firefox. Cette article traite spécifiquement de la façon de construire un environnement de développement pour TV en utilisant une simple application Hello-World comme exemple.</p> - -<h3 id="Statut_actuel_et_à_venir">Statut actuel et à venir :</h3> - -<p>Les applications conçues pour les smart TV sont stockées dans Gaia/tv_apps, avec le préfixe “smart-”, aussi connu sous le nom de smart TV apps. Au début du printemps 2015 il y aura des TV sur le marché avec les applications listées ici : <a href="https://github.com/mozilla-b2g/gaia/tree/master/tv_apps">https://github.com/mozilla-b2g/gaia/tree/master/tv_apps</a>.</p> -<p>Smart-home et Smart-deck sont des applications classique pour une TV, et vous pouvez les utiliser comme base pour trouver quelques idées.</p> - -<h3 id="Contribuer_aux_applications_smart_TV">Contribuer aux applications smart TV:</h3> - -<p>Pour contribuer à une applications smart TV, il vous suffit de suivre les mêmes règles que pour contribuer au code de Gaia.</p> - -<p>Introduction à Firefox OS:</p> - -<p><a href="https://developer.mozilla.org/en-US/Firefox_OS/Introduction">https://developer.mozilla.org/en-US/Firefox_OS/Introduction</a></p> - -<p> </p> - -<p>Construire des applications pour Firefox OS :</p> - -<p><a href="https://developer.mozilla.org/en-US/Apps/Build">https://developer.mozilla.org/en-US/Apps/Build</a></p> - -<h2 id="Télécharger_les_outils">Télécharger les outils</h2> - -<p> </p> - -<p>Nous avons besoin de 3 principaux composants pour construire l'environnement de développement : 1) Le simulateur de bureau, pour lancer votre application TV sur PC comme sur une vraie TV, 2) Firefox Nightly/Aurora comme débogueur, et 3) Le dépôt Gaia.</p> - -<p> </p> - -<p>Pour la première étape, le simulateur de bureau, vous pouvez trouver nos builds nightly ou builder vous-même. Plus d'info ci-dessous :</p> - -<p><a href="https://developer.mozilla.org/en-US/Firefox_OS/Building_the_Firefox_OS_simulator">https://developer.mozilla.org/en-US/Firefox_OS/Building_the_Firefox_OS_simulator</a></p> - -<p>Firefox Nightly fonctionne aussi, mais il permet seulement de tester votre app indépendamment sans pouvoir tester tout le système smart-TV. Nous recommandons d'utiliser Firefox OS bureau pour un meilleur environnement de développement. Vous pouvez le télécharger ici : <a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/</a></p> - -<p> </p> - -<p>La seconde étape consiste à récupérer Firefox Nightly/Aurora, naviguer et télécharger depuis la page officielle de release.</p> - -<p><a href="https://nightly.mozilla.org/">https://nightly.mozilla.org/</a></p> - -<p> </p> - -<p>Pour l'étape 3 veuillez forker le dépot Gaia. Référez-vous aux étapes suisvantes : <a href="https://developer.mozilla.org/en-US/Firefox_OS/Developing_Gaia/Running_the_Gaia_codebase#Running_your_own_Gaia_build">https://developer.mozilla.org/en-US/Firefox_OS/Developing_Gaia/Running_the_Gaia_codebase#Running_your_own_Gaia_build</a></p> - -<p> </p> - -<p>Premièrement, faites un fork du <a href="https://github.com/mozilla-b2g/gaia">dépot Gaia principal sur Github</a>.</p> - -<ol style="margin-top: 0pt; margin-bottom: 0pt;"> - <li>Ensuite, clonez votre fork localement:<br> - <code>git clone https://github.com/your-username/gaia.git</code></li> - <li> - <p>Ajoutez un lien upstream comme cela :<br> - <code>cd gaia<br> - git remote add upstream https://github.com/mozilla-b2g/gaia</code></p> - </li> -</ol> - -<h2 id="Mise_en_place_de_votre_environnement">Mise en place de votre environnement</h2> - -<p>Maintenant vous avez besoin de créer votre profil Gaia. Dans le dossier de votre dépôt, lancer la commande ci-dessous :</p> - -<p><code>$ make GAIA_DEVICE_TYPE=tv DEVICE_DEBUG=1</code></p> - -<p>Cela va crée un profil pour un débogage optimal dans votre répertoire. Cela crée des versions non-packagées (versions hébergées) des applications Gaia qui peuvent être servies directement via le serveur local HTTPD qui est contenu dans Firefox pour ordinateur de bureau comme une extension. Lorsque vous faites un changement vous avez besoin de rafraîchir la fenêtre de votre navigateur pour voir le résultat (comme nous allons vous le montrer) plutôt que de re-construire votre profil, re-pousser le profil sur l'appareil etc. C'est un bon et rapide hack CSS/JS/HTML. Donc, lancez le simulateur de bureau avec une taille d'écran précise, un serveur de debug distant, et le lien vers votre profil :</p> - -<p> </p> - -<p><code>$ b2g-bin -screen 1920x1080 -start-debugger-server 6000 -profile /path/to/gaia/profile</code></p> - -<p> </p> - -<p>Notez que si le paramètre de l'écran est plus grand que votre résolution de PC, cela peut casser le sapplications systèmes. Si cela arrive, réduisez la taille de l'écran comme expliqué précedemment.<br> - Si tout fonctionne bien, vous allez voir l'application horloge (en remplacement temporaire de l'application de lancement).</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10472/Screen%20Shot%202015-04-21%20at%205.52.12%20PM.png" style="height: 376px; width: 640px;"></p> - -<p>Appuyer sur la touche accueil au bas de la fenêtre va vous amener sur l'application accueil qui est le point d'entrée pour les applications TV. Vous pouvez naviguer avec les flèches du clavier, et lancer “Apps” pour lancer le gestionnaire d'application, là ou vous lancerez vos propres applications plus tard.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10474/Screen%20Shot%202015-04-21%20at%205.51.49%20PM.png" style="height: 376px; width: 640px;"></p> - -<p>L'écran "Accueil"</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10476/Screen%20Shot%202015-04-21%20at%205.51.19%20PM.png" style="height: 376px; width: 640px;"></p> - -<p>L'écran "gestionnaire d'application"</p> - -<p> </p> - -<h2 id="L'exemple_Hello_World">L'exemple Hello World</h2> - -<p> </p> - -<p><strong>WebIDE dans Firefox Desktop</strong></p> - -<p>En utilisant le WebIDE, on peut facilement bootstraper une application web, faire des modifications HTML/CSS/JS, et déboguer l'application sans avoir un véritable appareil.<br> - Pour ouvrir le WebIDE dans Firefox Desktop, selectionner Outils > Web Developer > WebIDE depuis le menu :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10444/11.09.37.png" style="height: 490px; width: 640px;"></p> - -<p><strong>Créer une application depuis le template</strong></p> - -<p><br> - Cliquez sur “Open App” dans le coin gauche en haut du WebIDE et choisissez “Nouvelle application…” dans le menu. Selectionner “HelloWorld,” donnez un nom de projet, et cliquez sur “OK.” Après avoir décidé du répertoire de sauvegarde de sprojets, WebIDE va générer une application avec un template simple pour vous.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10446/11.14.38.png" style="height: 425px; width: 640px;"></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10448/11.15.06.png" style="height: 425px; width: 640px;"></p> - -<p> </p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/10450/11.15.37.png" style="height: 425px; width: 640px;"></p> - -<p>Maintenant vous pouvez programmer votre application dans WebIDE ou utiliser n'importe quel éditeur que vous préférez.</p> - -<p><br> - </p> - -<p><strong>Lancer votre application sur une TV</strong></p> - -<p> </p> - -<p>Il n'y a pas encore de build TV pour le simulateur, nous avons besoin de lancer b2g-desktop.</p> - -<p> </p> - -<ol> - <li>Suivez les instructions dans la section “Mise en place de votre environnement” pour lancer votre environnement dans b2g-desktop (n'oubliez pas d'ajouter le paramètres“-start-debugger-server 6000”).</li> - <li>Dans le WebIDE, cliquer sur “Select Runtime” dans le coin droit du haut et selectionner “Remote Runtime.”<br> - <img alt="" src="https://mdn.mozillademos.org/files/10452/11.37.40.png" style="height: 425px; width: 640px;"></li> - <li>Remplissez la boite de dialogue avec “localhost:6000” et cliquez sur “OK.”<br> - <img alt="" src="https://mdn.mozillademos.org/files/10454/11.37.47.png" style="height: 425px; width: 640px;"></li> - <li>Cliquer sur l'icone “Install and Run” . Vous verrez votre applications fonctionner dans b2g-desktop.<br> - <img alt="" src="https://mdn.mozillademos.org/files/10466/11.39.40%202.png" style="height: 425px; width: 640px;"></li> - <li>Cliquez sur l'icone “Debug App” et la boite d'outils des DevTools apparait. Vous pouvez vous référer à la section "<a href="/en-US/docs/Tools/WebIDE/Running_and_debugging_apps#Debugging_apps">Debugging apps</a>" pour déboguer votre application.<br> - <img alt="" src="https://mdn.mozillademos.org/files/10468/11.40.10%202.png" style="height: 425px; width: 640px;"></li> -</ol> - -<h2 id="Interagir_avec_une_télécommande_TV">Interagir avec une télécommande TV</h2> - -<p>L'une des différences entre les téléphones et les TV est le dispositif d'entrée d'instructions. En général, les Tv n'ont pas d'écran tactile, donc les applications ne peuvent pas être controlées avec les événements de la souris ou les événement tactiles. En revanche vos applications peuvent être contrôlées par les événements bouton qui sont envoyés à la TV par la télécommande.</p> - -<p> </p> - -<p>La définition des boutons d'une télécommande TV est documentée dans cette spécification W3C :</p> - -<p><a href="http://www.w3.org/TR/DOM-Level-3-Events-key/#keys-media-controller">http://www.w3.org/TR/DOM-Level-3-Events-key/#keys-media-controller</a></p> - -<p> </p> - -<p>Le “focus” est un autre problème qui peut être mentionné sur les TV. Il est important de vous assurer que le focus est toujours sur le bon élément, car on ne peut pas toucher les élément d'une TV directement.</p> - -<p> </p> - -<p> </p> diff --git a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/index.html b/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/index.html deleted file mode 100644 index 6775ef2d76..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Téléviseurs et appareils connectés -slug: Archive/B2G_OS/Firefox_OS_Connected-Devices_Guide -tags: - - TopicStub -translation_of: Mozilla/Firefox_OS_for_TV ---- -<p class="summary">Ce document est écrit pour les développeurs Web qui sont intéressés par Firefox OS pour les téléviseurs, le travail actuel et à venir, ainsi que les applications web pour les téléviseurs. Il est montré comment construire et exécuter le simulateur Firefox OS TV, puis comment commencer à créer des applications pour les TV et les déployer.</p> - -<p>Les principales différences entre l'utilisation de Firefox OS sur un téléviseur et un téléphone (ou un ordinateur) sont :</p> - -<ul> - <li><strong>Moyens de contrôle</strong> : Firefox OS sur la TV doit être contrôlé à distance avec une télécommande, ce qui n'est pas aussi pratique qu'un clavier et qu'une souris.</li> - <li><strong>Résolution</strong> : Les téléviseurs intelligents d'aujourd'hui sont FULL HD (1920x1080) voir même du Ultra HD (4K). Le nombre de pixels sur les téléviseurs est très différent du nombre de pixels utilisé sur la plupart des téléphones mobiles.</li> -</ul> - -<h2 id="Statut_actuelle_et_futurs_projets">Statut actuelle et futurs projets</h2> - -<p>Gaia 2.2 et supérieur contient des fonctionnalités pour fonctionner sur la télévision. Vous pouvez trouver des applications prêtes à l'emploi pour les téléviseurs intelligents dans <a href="https://github.com/mozilla-b2g/gaia/tree/master/tv_apps">gaia/tv_apps</a>; les applications avec le préfixe <code>smart-</code> sont appelées applications de télévision intelligente. <span class="tlid-translation translation" lang="fr"><span title="">À partir du premier semestre 2015, il y aura des appareils TV sur le marché avec des interfaces utilisateur basées sur les applications répertoriées ici.</span></span></p> - -<div class="note"> -<p><strong>Note:</strong> <code>smart-home</code> et <code>smart-deck</code> sont de bonnes applications à prendre comme modèles de départ pour vos propres applications ou pour vous faire des idées et trouver l'inspiration.</p> -</div> - -<h2 id="Développement_des_applications_TV">Développement des applications TV</h2> - -<p>Dans cette partie, vous allez découvrir comment configurer un environement de développement pour exécuter et tester vos propres applications TV et comment assembler une application simple de test.</p> - -<h3 id="Téléchargement_des_outils">Téléchargement des outils</h3> - -<p>Vous aurez besoin de trois composants pour construire votre environnement de développement :</p> - -<ul> - <li><strong>Simulateur sur ordinateur</strong> : vous devez télécharger et installer le dernier <a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">Nightly Desktop Simulator</a> (plus connue sous le nom de B2G Desktop), ou – si vous êtes vraiment courageux – <a href="https://developer.mozilla.org/fr/Firefox_OS/Building_the_Firefox_OS_simulator">le construire vous-même</a>. Vous devez télécharger la version adaptée à votre système d'exploitation et ajouter <code>b2g- </code>au début de votre nom de fichier.</li> -</ul> diff --git a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/interagir_avec_les_télécommandes_tv/index.html b/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/interagir_avec_les_télécommandes_tv/index.html deleted file mode 100644 index cfbac66130..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/interagir_avec_les_télécommandes_tv/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Interagir avec les télécommandes TV -slug: >- - Archive/B2G_OS/Firefox_OS_Connected-Devices_Guide/Interagir_avec_les_télécommandes_TV -tags: - - B2G - - Clavier - - Firefox OS - - NeedsContent - - TV - - touches - - télécommande -translation_of: Mozilla/Firefox_OS_for_TV/Interacting_with_TV_remote_controls ---- -<p></p><div class="overheadIndicator draft"> - <p><strong>Brouillon</strong><br> - Cette page n'est pas terminée.</p> - -</div><p></p> - -<p class="summary" id="Interacting_with_TV_remote_controls">La disponibilité des mécanismes de saisie constitue l'une des principales différences entre les téléphones et les TV. En général, une TV ne dispose pas d'écran tactile et les applications ne peuvent donc pas être contrôlées via des événements souris ou tactiles. Au lieu de ça, vos applications devront sans doute réagir aux événements des boutons envoyés par la TV lors de l'appui sur les boutons de la télécommande. Cet article aborde les bases du développement de mécanismes de contrôle appropriés à votre application TV.</p> - -<p>Le focus est un autre problème à souligner en ce qui concerne les applications TV. Il est important de s'assurer qu'à tout moment le focus est bien mis sur l'élément correct car il n'est pas possible de toucher les éléments directement dans l'application TV.</p> - -<div class="note"> -<p><strong>Note</strong> : les touches des télécommandes TV sont définies dans la spécification W3C <em>DOM Level 3 KeyboardEvent key Values</em> ; voir la section <a href="http://www.w3.org/TR/DOM-Level-3-Events-key/#keys-media-controller">Media Controller Keys</a>.</p> -</div> diff --git a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/simuler_firefox_os_pour_tv/index.html b/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/simuler_firefox_os_pour_tv/index.html deleted file mode 100644 index 9bb1c307a3..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/simuler_firefox_os_pour_tv/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Simuler Firefox OS pour TV sur votre ordinateur -slug: Archive/B2G_OS/Firefox_OS_Connected-Devices_Guide/Simuler_Firefox_OS_pour_TV -translation_of: Mozilla/Firefox_OS_for_TV/Simulating_Firefox_OS_for_TV ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p class="summary" id="Developing_TV_apps">Dans cet article, vous apprendrez comment mettre en place un simulateur pour TV sous Firefox OS sur votre ordinateur afin de lancer et tester vos propres applications TV.</p> - -<h2 id="Utiliser_le_simulateur_via_le_WebIDE">Utiliser le simulateur via le WebIDE</h2> - -<p>Les outils du <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> de Mozilla procurent un moyen simple de créer un simulateur personnalisé pour différentes configurations de téléviseurs.</p> - -<ol> - <li> - <p>Ouvrez le WebIDE dans Firefox Desktop en sélectionnant <em>Outils > Développement Web > WebIDE</em> dans le menu principal. La zone de droite de la fenêtre du WebIDE liste les simulateurs déjà installés ainsi qu'un menu <em>Installer un simulateur</em> pour créer un nouveau simulateur dans le WebIDE.</p> - </li> - <li> - <p>Si vous n'avez pas encore installé de simulateur, faites-le en cliquant sur <em>Installer un Simulateur</em> et installé la version TV de Firefox OS de votre choix.</p> - - <p><img alt="" src="https://mdn.mozillademos.org/files/12095/basic-web-ide.png" style="display: block; height: 1424px; margin: 0px auto; width: 1824px;"></p> - </li> - <li> - <p>Une fois que votre simulateur a été créé et listé sous <em>Simulators</em>, cliquez sur l'îcone de configuration à droite du nom du simulateur. Un écran vous permettant de configurer l'appareil que vous shouaitez simuler apparaitra.</p> - - <p><img alt="" src="https://mdn.mozillademos.org/files/12097/tv-web-ide.png" style="display: block; height: 1424px; margin: 0px auto; width: 1824px;"></p> - </li> - <li> - <p>Un groupe <em>TVs</em> est disponible dans la liste déroulante <em>Appareil</em>, et il contient tous les modèles de TV actuellement supportés:</p> - - <p><img alt="" src="https://mdn.mozillademos.org/files/12099/tv-options.png" style="display: block; height: 612px; margin: 0px auto; width: 442px;"></p> - </li> - <li> - <p>Une fois que vous avez configuré votre TV avec vos spécifications, cliquez sur le nom du simulateur et le simulateur va se lancé! L'écran d'accueil ressemblera à celui-ci dessous:</p> - - <p><img alt="" src="https://mdn.mozillademos.org/files/12101/tv-home-screen.png" style="display: block; height: 484px; margin: 0px auto; width: 800px;"></p> - </li> -</ol> - -<h2 id="Utiliser_Mulet_pour_simuler_Firefox_OS_pour_TV">Utiliser Mulet pour simuler Firefox OS pour TV</h2> - -<p>Si vous préférez compiler votre propre profil TV, peut être pour tester les changements dans Gaia qui n'ont pas encore été intégrés dans le simulateur officiel Firefox OS, vous pouvez lancer votre profil dans un build spécial de Firefox appelé Firefox Mulet. Regardez <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Developing_Gaia/Different_ways_to_run_Gaia#Using_Gaia_in_Firefox_Mulet">Utiliser Gaia dans Firefox Mulet </a>pour apprendre comment mettre en place un environnement.</p> - -<ol> - <li> - <p>Pour créer un profil spécial de Gaia pour TV, lancer la commande make dans votre dossier du dépôt gaia avec les options suivantes:</p> - - <pre class="brush: bash"><code>GAIA_DEVICE_TYPE=tv DEVICE_DEBUG=1 make</code></pre> - - <p>Cela créé un profil TV dans le dossier <code>profile </code>qui est initialisé pour debugger de façon optimale.</p> - </li> - <li> - <p>Lancez Mulet depuis votre ligne de commande, en passant votre profil Gaia comme profil à utiliser pour l'ouverture (défini par l'option <code>-profile</code>), et la configuration de la taille de l'écran (définie par l'option <code>-screen</code>):</p> - - <pre><code>./mulet/FirefoxNightly.app/Contents/MacOS/firefox-bin -no-remote </code><code>-screen 1600x900</code><code> -profile </code><code>/path/to/gaia/profile</code></pre> - - <div class="note"> - <p><strong>Note</strong>: Si l'option <code>-screen</code> spécifie une résolution plus grandeque celle de la taille d'écran de votre PC, l'application système ne va pas fonctionner correctement et vous pourriez avoir une interface cassée. Réduisez la taille d'écran autant que nécessaire pour correspondre à votre système.</p> - </div> - - <div class="note"> - <p><strong>Note</strong>: Le chemin exact passé dans l'option <code>-profile /path/to/gaia/profile</code> dont vous avez besoin, vous est donné quand vous créez votre profil. (en lançant la commande <code>make</code>, comme montrez ci-dessus.)</p> - </div> - </li> - <li> - <p>Si tout va bien, vous verrez s'afficher l'application de l'écran d'accueil — éventuellement affichée incorrectement avec une rotation. C'est un bug connu (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1228899">Bug 1228899</a>):<img alt="TV build runs on Mulet" src="https://mdn.mozillademos.org/files/12131/Screen%20Shot%202015-12-09%20at%2010.23.46.png" style="display: block; height: 486px; margin: 0px auto; width: 800px;"></p> - </li> - <li> - <p>Vous pouvez corriger ce problème en cliquant sur le bouton de rotation la barre d'outil de Mulet et en ajustant la taille de l'écran si nécessaire:</p> - </li> -</ol> - -<p><img alt="TV build runs on Mulet" src="https://mdn.mozillademos.org/files/12135/Screen%20Shot%202015-12-16%20at%203.56.37%20PM.png" style="display: block; height: 486px; margin: 0px auto; width: 800px;"></p> diff --git a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/tv_remote_control_button_mapping_to_keyboard/index.html b/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/tv_remote_control_button_mapping_to_keyboard/index.html deleted file mode 100644 index 71ff7cf960..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_connected-devices_guide/tv_remote_control_button_mapping_to_keyboard/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Correspondance clavier des boutons de télécommande TV -slug: >- - Archive/B2G_OS/Firefox_OS_Connected-Devices_Guide/TV_remote_control_button_mapping_to_keyboard -tags: - - Clavier - - Contrôles - - Distance - - Firefox OS - - Gaia - - TV -translation_of: Mozilla/Firefox_OS_for_TV/TV_remote_control_button_mapping_to_keyboard ---- -<p class="summary">Cet article donne une brève description de l'utilisation du clavier pour simuler les boutons d'une télécommande.</p> - -<p>Le clavier est utilisé pour simuler les boutons d'une télécommande lors du développement d'applications pour Firefox OS sur TV. Les tableaux suivants détaillent les équivalents clavier des boutons de télécommande pour les trois plates-formes différentes : Mac OS X, Windows et Linux.</p> - -<h2 id="Mac_OS_X">Mac OS X</h2> - -<table style="height: 171px; width: 260px;" class="standard-table"> - <tbody> - <tr> - <td><strong>Télécommande</strong></td> - <td><strong>Clavier</strong></td> - </tr> - <tr> - <td><kbd>home</kbd></td> - <td><kbd>fn</kbd> + <kbd>left</kbd></td> - </tr> - <tr> - <td><kbd>back</kbd></td> - <td><kbd>esc</kbd></td> - </tr> - <tr> - <td><kbd>enter</kbd></td> - <td><kbd>return</kbd></td> - </tr> - <tr> - <td><kbd>option</kbd></td> - <td><kbd>fn</kbd> + <kbd>ctrl</kbd> + <kbd>I</kbd></td> - </tr> - </tbody> -</table> - -<h2 id="Windows">Windows</h2> - -<table style="height: 171px; width: 260px;" class="standard-table"> - <tbody> - <tr> - <td><strong>Télécommande</strong></td> - <td><strong>Clavier</strong></td> - </tr> - <tr> - <td><kbd>home</kbd></td> - <td><kbd>home</kbd></td> - </tr> - <tr> - <td><kbd>back</kbd></td> - <td><kbd>esc</kbd></td> - </tr> - <tr> - <td><kbd>enter</kbd></td> - <td><kbd>enter</kbd></td> - </tr> - </tbody> -</table> - -<h2 id="Linux">Linux</h2> - -<table style="height: 171px; width: 270px;" class="standard-table"> - <tbody> - <tr> - <td><strong>Télécommande</strong></td> - <td><strong>Clavier</strong></td> - </tr> - <tr> - <td><kbd>home</kbd></td> - <td><kbd>home</kbd></td> - </tr> - <tr> - <td><kbd>back</kbd></td> - <td><kbd>esc</kbd></td> - </tr> - <tr> - <td><kbd>enter</kbd></td> - <td><kbd>enter</kbd></td> - </tr> - <tr> - <td><kbd>option</kbd></td> - <td><kbd>shift</kbd> + <kbd>F10</kbd></td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/b2g_os/firefox_os_faq/index.html b/files/fr/archive/b2g_os/firefox_os_faq/index.html deleted file mode 100644 index a322bd8aae..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_faq/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Firefox OS FAQ -slug: Archive/B2G_OS/Firefox_OS_FAQ -translation_of: Archive/B2G_OS/Introduction ---- -<dl> - <dt> - Comment obtenir un téléphone de développeur ?</dt> - <dd> - Vous pouvez en acheter un sur le site de <a href="http://www.geeksphone.com/" title="http://www.geeksphone.com/">Geeksphone</a> ou si vous êtes un Mozilla Reps <a href="https://wiki.mozilla.org/ReMo/SOPs/Keon_Request" title="https://wiki.mozilla.org/ReMo/SOPs/Keon_Request">vous pouvez demander un Keon</a>.</dd> - <dt> - Si je ne souhaite pas acheter de téléphone, puis-je tout de même développer une application pour Firefox OS ?</dt> - <dd> - Absolument ! Vous pouvez tester votre application sur Android (en utilisant le <a href="https://hacks.mozilla.org/2012/10/firefox-marketplace-aurora/" title="https://hacks.mozilla.org/2012/10/firefox-marketplace-aurora/">Marketplace de Firefox</a>) ou sur votre ordinateur en utilisant le <a href="https://hacks.mozilla.org/2012/12/firefox-os-simulator-1-0-is-here/" title="https://hacks.mozilla.org/2012/12/firefox-os-simulator-1-0-is-here/">simulateur Firefox OS</a>.</dd> - <dt> - En quoi sera-t-il comparable au téléphone final ?</dt> - <dd> - Nous travaillons avec plusieurs partenaires pour sortir ce téléphone sur le marché grand public. Nous parlerons de ces appareils plus tard.</dd> - <dt> - Où puis-je télécharger Firefox OS et l'essayer sur mon propre téléphone ?</dt> - <dd> - <a class="external free" href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" rel="nofollow">https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS</a></dd> - <dt> - Comment puis-je tester mon application sur Firefox OS ?</dt> - <dd> - Sur un téléphone Android avec Firefox ou en utilisant le simulateur Firefox OS.</dd> - <dt> - Qu'est-ce que Firefox OS ?</dt> - <dd> - C'est un nouveau système d'exploitation mobile développé entièrement en utilisant les standards ouverts du Web. Il permet de développer toutes les fonctionnalités de l'appareil (appels, messagerie, navigation..) dans une application HTML5 qui peut accéder à toutes les fonctionnalités sous-jacentes d'un téléphone (seulement disponibles pour les applications natives dans les autres éco-systèmes).</dd> - <dt> - Quelle est la liste complète des API web ? Allez-vous les standardiser ?</dt> - <dd> - Un grand nombre des API web seront prises en charge dans l'implémentation initiale de Firefox OS. Une liste complète est disponible ici <a class="external free" href="https://wiki.mozilla.org/WebAPI#APIs" rel="nofollow">https://wiki.mozilla.org/WebAPI#APIs</a>. <a href="https://hacks.mozilla.org/2012/01/mozilla-joins-the-w3c-dap-webapi-progress/" title="https://hacks.mozilla.org/2012/01/mozilla-joins-the-w3c-dap-webapi-progress/">La standardisation est en cours</a>.</dd> - <dt> - Est-ce que vos API web seront standardisées pour une utilisation multi plate-forme ?</dt> - <dd> - Oui, les API sont le fruit d'un travail avec plusieurs partenaires et marques et certaines d'entre-elles sont déjà disponibles sur d'autres plate-formes. Permettre aux applications web d'accéder au matériel est un problème pour la plus part des entreprises technologiques, nous offrons un bon point de départ pour que cela se développe sur plus de plate-formes.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/firefox_os_usage_tips/index.html b/files/fr/archive/b2g_os/firefox_os_usage_tips/index.html deleted file mode 100644 index 5c9b850f65..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_usage_tips/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Conseils d'utilisation Firefox OS -slug: Archive/B2G_OS/Firefox_OS_usage_tips -tags: - - Astuces - - Firefox OS -translation_of: Archive/B2G_OS/Firefox_OS_usage_tips ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<dl> - <dd><span class="seoSummary">Explique toutes les fonctionnalités développeur du téléphone et ce qu'elles font (Paramètres > Informations > Plus d'informations > Développeurs)</span></dd> - <dt><a href="https://developer.mozilla.org/fr/Firefox_OS/Firefox_OS_usage_tips/Unlocking_your_phone">Débloquer votre téléphone</a></dt> - <dd>Instructions sommaires pour débloquer votre téléphone.</dd> - <dt><a href="/fr/Firefox_OS/Tips_and_tricks/faire_des_captures_ecran" title="/en-US/docs/Mozilla/Firefox_OS/Tips_and_tricks/taking_screenshots">Faire des captures d'écran</a></dt> - <dd>Comment prendre des captures d'écran sur votre téléphone Firefox OS.</dd> -</dl> - -<p> </p> diff --git a/files/fr/archive/b2g_os/firefox_os_usage_tips/unlocking_your_phone/index.html b/files/fr/archive/b2g_os/firefox_os_usage_tips/unlocking_your_phone/index.html deleted file mode 100644 index 135124a83e..0000000000 --- a/files/fr/archive/b2g_os/firefox_os_usage_tips/unlocking_your_phone/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Débloquer votre téléphone -slug: Archive/B2G_OS/Firefox_OS_usage_tips/Unlocking_your_phone -tags: - - Firefox OS -translation_of: Archive/B2G_OS/Firefox_OS_usage_tips/Unlocking_your_phone ---- -<p>Si votre build de Firefox OS commence par vous demander un mot de passe pour débloquer votre appareil, le code par défaut est 0000. Certaines builds vont faire cela lorsque nous développons et testons le lock screen.</p> diff --git a/files/fr/archive/b2g_os/gaia_hacking_guide/index.html b/files/fr/archive/b2g_os/gaia_hacking_guide/index.html deleted file mode 100644 index 2abb1dd023..0000000000 --- a/files/fr/archive/b2g_os/gaia_hacking_guide/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Guide de développement Gaia -slug: Archive/B2G_OS/Gaia_hacking_guide -tags: - - Gaia - - Guide - - Mobile - - NeedsContent -translation_of: Archive/B2G_OS/Developing_Gaia ---- -<p>Le guide de développement Gaia n'est pas encore rédigé. Cependant, vous pouvez vous <a href="https://wiki.mozilla.org/Gaia/Hacking" title="https://wiki.mozilla.org/Gaia/Hacking">référer à cet article</a> sur le wiki Mozilla en attendant.</p> diff --git a/files/fr/archive/b2g_os/index.html b/files/fr/archive/b2g_os/index.html deleted file mode 100644 index f137db5d1e..0000000000 --- a/files/fr/archive/b2g_os/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: B2G OS -slug: Archive/B2G_OS -tags: - - Aperçu - - B2G - - B2G OS - - Bases - - Débutant - - Démarrer avec b2gos - - Gaia - - Gecko - - Gonk - - Mozilla - - gecko web os - - os de mozilla basé sur le web - - os smartphone b2g -translation_of: Archive/B2G_OS ---- -<div class="summary"><span class="seoSummary">B2G OS est un système d'exploitation autonome et complet pour le web ouvert. Il s'agit d'un projet open source développé par la communauté Mozilla et qui constitue les bases des produits Firefox OS.</span></div> - -<p><strong>B2G OS </strong>est un système d'exploitation open source, maintenu par la communauté, pour les smartphones, tablettes, TVs intelligentes et autres appareils connectés. Le projet a <a href="https://wiki.mozilla.org/Booting_to_the_Web">démarré</a> en 2011 et est basé sur le noyau Linux et le moteur de rendu Gecko. L'interface utilisateur entière est construite avec des technologies web (HTML, CSS et JavaScript) et peut être utilisée pour lancer et utiliser des <a href="/fr/Apps">applications web</a>. Depuis que Mozilla <a href="https://discourse.mozilla-community.org/t/firefox-os-connected-devices-announcement/6864">a abandonné</a> son programme commercial de smartphone Firefox OS, la partie smartphone du projet est intégralement maintenue par la communauté de bénévoles de Mozilla et placée sous la marque B2G OS.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13140/B2g_wordmark.png" style="display: block; margin: 0 auto;"></p> - -<div class="note"> -<p><strong>Note </strong>: Un <a href="https://wiki.mozilla.org/B2G/Transition_Project/Call_For_Contribution#French_Version_.2F_Version_fran.C3.A7aise">appel à contribution</a> et un <a href="https://discourse.mozilla-community.org/t/updated-9th-july-call-for-app-maintainers-adopt-an-app/9300/1">autre pour l'adoption d'applications</a> ont été lancés pour mobiliser davantage de personnes, n'hésitez pas à les relayer !</p> -</div> - -<div class="column-container"> -<div class="column-third"> -<h2 id="Comment_contribuer">Comment contribuer</h2> - -<ul> - <li>Signaler et corriger des bogues (le méta-bogue est le <a class="external text" href="https://bugzilla.mozilla.org/show_bug.cgi?id=1252143" rel="nofollow">bogue 1252143</a>)</li> - <li>Aider à corriger les <a class="external text" href="https://developer.mozilla.org/fr/Firefox_OS/Automated_testing" rel="nofollow">tests</a> qui échouent</li> - <li>Porter une <a href="https://mozilla-b2g.github.io/gaia/">app smartphone</a> gaia : - <ol> - <li>La convertir en webapp (ou)</li> - <li>La convertir vers chrome:// (<a href="https://discourse.mozilla-community.org/t/why-gaia-apps-are-turned-to-chrome/8011">pourquoi ?</a>) et faire un retour<span style="display: none;"> </span><span style="display: none;"> </span><span style="display: none;"> </span></li> - </ol> - </li> - <li><a href="https://developer.mozilla.org/fr/Firefox_OS/Porter_Firefox_OS">Porter B2G OS sur votre téléphone</a> ou nous aider à maintenir un portage</li> - <li>Aider à corriger les bogues de Gecko</li> - <li>Contribuer à améliorer la traduction de cette documentation et du wiki</li> - <li>Proposer et implémenter des nouvelles caractéristiques pour les smartphones</li> -</ul> -</div> - -<div class="column-third"> -<h2 id="S'impliquer">S'impliquer</h2> - -<ul> - <li>Liste de diffusion (<a class="external text" href="https://lists.mozilla.org/listinfo/dev-fxos" rel="nofollow">dev-fxos</a>)</li> - <li><a class="external text" href="https://wiki.mozilla.org/IRC" rel="nofollow">IRC</a> (irc.mozilla.org #b2g)</li> - <li><a href="https://discourse.mozilla-community.org/c/b2g-os-participation">Discourse</a></li> - <li><a class="external text" href="https://telegram.me/B2GOS" rel="nofollow">Groupe Telegram</a></li> - <li>Suivez-nous sur <a href="https://twitter.com/Boot2Gecko">Twitter</a>, ou simplement recherchez <a href="https://twitter.com/hashtag/B2GOS?src=hash">#B2GOS</a></li> - <li><a href="https://wiki.mozilla.org/B2G/Transition_Project/Working_Groups">Groupes de travail</a></li> - <li>Suivi des problèmes de la documentation sur <a href="https://github.com/mozilla-b2g/B2GOS-community/issues">GitHub</a></li> - <li><a class="external text" href="https://wiki.mozilla.org/B2G/Meeting" rel="nofollow">B2G Weekly Meeting</a> pour les avancées de l'état d'ingénierie.</li> -</ul> - -<p>Pour participer aux réunions et aux Groupes de Travail communautaires, s'enregistrer sur ce <a href="https://calendar.google.com/calendar/embed?src=mozilla.com_2d3638353137343333373332@resource.calendar.google.com">Calendrier</a>. Ils sont annoncés sur <a href="https://discourse.mozilla-community.org/c/b2g-os-participation">Discourse</a>, où vous pouvez trouver des informations sur comment participer ainsi que les remarques.</p> -</div> - -<div class="column-third"> -<h2 id="Appareils_compatibles">Appareils compatibles</h2> - -<ul> - <li><a href="https://discourse.mozilla-community.org/t/building-b2g-os-for-aries-z3c/8082">Sony Xperia Z3C</a> (téléphone développeur)</li> - <li><a href="https://discourse.mozilla-community.org/t/flame-builds/8548">Flame </a>(téléphone développeur)</li> - <li><a href="https://discourse.mozilla-community.org/t/zte-open-c/8402">ZTE Open C</a></li> - <li><a href="https://discourse.mozilla-community.org/t/test-b2gos-on-nexus-5/9405/1">Nexus 5</a></li> - <li>WileyFox Swift</li> - <li>Nexus 4 (travail en cours)</li> - <li><a href="https://discourse.mozilla-community.org/t/fairphone-2-support-for-b2g-installer-landed/8334">Fairphone 2 </a> (travail en cours)</li> - <li><a href="https://discourse.mozilla-community.org/t/b2g-os-flamingo-sony-xperia-e3-builds/8361">Sony Xperia E3 </a> (travail en cours)</li> - <li><a href="https://discourse.mozilla-community.org/t/support-for-amami-xperia-z1c-building-debugging-providing-builds/8348">Sony Xperia Z1C</a> (travail en cours)</li> - <li><a href="https://discourse.mozilla-community.org/t/wip-xiaomi-redmi-1s-hongmi-1s/10273">Xiaomi Redmi 1S</a> (travail en cours)</li> -</ul> - -<p>Pour plus d'informations, voir cette <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">page</a>.<br> - Flashez facilement votre appareil avec <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_installer_add-on">B2G Installer</a>.<br> - Votre appareil ne figure pas dans la liste ? Essayez <a href="/fr/docs/B2G_OS/Mulet">Mulet </a>sur ordinateur de bureau</p> -</div> -</div> - -<div class="note"> -<p><strong>Note</strong>: certaines pages ont été déplacées vers l'<a href="/en-US/docs/Archive/Firefox_OS">Archive MDN</a> — informez-nous si vous avez des difficultés à trouver quelque chose ou s'il y a des choses qui devraient selon vous être replacées dans cette section.</p> -</div> - -<p> </p> - -<h2 id="Subnav">Subnav</h2> - -<ol> - <li><a href="/en-US/docs/Mozilla/B2G_OS/B2G_OS_Architecture">Architecture de B2G OS</a> - - <ol> - <li><a href="/fr/docs/B2G_OS/B2G_OS_Architecture">Architecture de B2G OS</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/API">APIs de B2G OS</a></li> - </ol> - </li> - <li><a class="toggler" href="/fr/docs/B2G_OS/Developing_Gaia">Gaia</a> - <ol> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/Developing_Gaia">Vue d'ensemble de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Différentes façons d'exécuter Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Faire_fonctionner_code_Gaia">Faire fonctionner le code de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/comprendre_les_fondements_de_Gaia">Développer pour Gaia</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/comprendre_les_fondements_de_Gaia">Comprendre la structure du code de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Apporter_modifications_Gaia">Apporter des modifications au code de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Tester_modifications_Gaia">Tester les modifications du code de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Soumettre_correctif_pour_Gaia">Soumettre un correctif pour Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Bases_système_construction_Gaia">Éléments de base sur le système de construction de Gaia</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Référence_options_make">Référence des options de Make</a></li> - <li><a href="/fr/docs/B2G_OS/Developing_Gaia/Gaia_tools_reference">Référence des outils pour Gaia</a></li> - </ol> - </li> - </ol> - </li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko">Construire B2G OS</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko">Vue d'ensemble de la construction</a></li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Résumé_processus_compilation_Firefox_OS">Résumé du processus de compilation de B2G OS</a></li> - <li><a href="/fr/docs/B2G_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour la compilation</a></li> - <li><a href="/fr/docs/B2G_OS/Preparing_for_your_first_B2G_build">Se préparer pour la première construction</a></li> - <li><a href="/fr/docs/B2G_OS/Compiler">Compiler B2G OS</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Compiler">Compiler B2G OS</a></li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Compiler_pour_le_Flame_sur_OS_X">Compiler B2G OS pour le Flame sur Mac OS X</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/Compiler/Compiler_pour_le_Fairphone">Compiler pour le Fairphone</a></li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_Build_Variables_Reference_Sheet">Carte de référence des variables de compilation de B2G</a></li> - </ol> - </li> - </ol> - </li> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/Choisir_comment_lancer_Gaia_ou_B2G">Exécuter B2G OS sur le Bureau</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Choisir_comment_lancer_Gaia_ou_B2G">Choisir comment exécuter Gaia ou B2G OS</a></li> - <li><a href="/fr/docs/B2G_OS/Mulet">Exécuter B2G OS sur ordinateur grâce à Mulet</a></li> - </ol> - </li> - <li><a href="/fr/docs/B2G_OS/Installer_sur_un_telephone_mobile">Installer B2G OS sur mobile</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Installer_sur_un_telephone_mobile">Installation de B2G OS sur un appareil mobile</a></li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_installer_add-on">Module B2G installer</a></li> - </ol> - </li> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils compatibles</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_OS_update_packages">Créer des mises à jour pour B2G OS</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/B2G_OS_update_packages">Création et installation de paquets de mise à jour B2G OS</a></li> - <li><a href="/fr/docs/B2G_OS/Compiler/FOTA_community_builds">Construction et installation de build communautaire FOTA</a></li> - </ol> - </li> - <li><a class="toggler" href="/fr/docs/B2G_OS/Porter_Firefox_OS">Portage de B2G OS</a> - <ol> - <li><a href="/fr/docs/B2G_OS/Porter_Firefox_OS">Aperçu du portage</a></li> - <li><a href="/fr/docs/B2G_OS/Portage">Les bases du portage</a></li> - <li><a href="/fr/docs/B2G_OS/Porter_Firefox_OS/Portage_sur_CyanogenMod">Portage sur CyanogenMod</a></li> - </ol> - </li> -</ol> diff --git a/files/fr/archive/b2g_os/installer_sur_un_telephone_mobile/index.html b/files/fr/archive/b2g_os/installer_sur_un_telephone_mobile/index.html deleted file mode 100644 index 04be7c7794..0000000000 --- a/files/fr/archive/b2g_os/installer_sur_un_telephone_mobile/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Installer Firefox OS sur un téléphone mobile -slug: Archive/B2G_OS/Installer_sur_un_telephone_mobile -tags: - - B2G - - Compilation - - Mobile - - Terminal -translation_of: Archive/B2G_OS/Installing_on_a_mobile_device ---- -<p></p> -<div class="summary"> - <p>Une fois que vous avez compilé Boot to Gecko pour un <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites#Have_a_compatible_device_or_use_an_emulator">téléphone mobile supporté</a>, vous pouvez l'installer. Cet article va vous guider dans cette procédure.</p> -</div> -<div class="note"> - <strong>Note :</strong> La première fois que vous flashez votre téléphone, il <strong>doit</strong> posséder la version 4 d'Android (Ice Cream Sandwich). Autrement, le processus ne se déroulera pas correctement. À partir du moment où vous avez effectué votre première installation de B2G, vous pourrez effectuer les mises à jours dessus.</div> -<h2 id="Installer_ADB">Installer ADB</h2> -<p><strong>Sur OSX</strong></p> -<p>Si vous avez homebrew sur OS X, effectuez :</p> -<pre class="language-html">brew install android-platform-tools</pre> -<p>Sinon, téléchargez les Android Developer Tools et ajoutez les binaires à votre PATH.</p> -<p><strong>Sur Ubuntu</strong></p> -<pre class="language-html">sudo apt-get install android-tools-adb</pre> -<h2 id="sect1"> </h2> -<h2 id="Flasher_votre_téléphone">Flasher votre téléphone</h2> -<p>Pour flasher entièrement votre téléphone, connectez-le à votre ordinateur puis entrez simplement :</p> -<pre>./flash.sh -</pre> -<p>C'est tout. Le B2G que vous aviez compilé va alors être flashé sur votre téléphone.</p> -<p>Attention : si vous mettez à jour avec une version comprenant d'importantes modification de Gaia, vous pouvez également avoir besoin de lancer les commandes suivantes:</p> -<pre>cd gaia -make reset-gaia -</pre> -<p>Cela effacera les données enregistrées dans Gaia, mais surtout les configurations et préférences obsolètes - ainsi vous lancerez une Gaia « propre ». En théorie, <code>./flash.sh</code> devrait effectuer ces commandes, mais sur certains terminaux (par exemple Hamachi),<code> ./flash.sh</code> ne met à jour qu'un sous-ensemble des modules (<code>./flash.sh -f</code> forcera alors la mise à jour intégrale).</p> -<h3 id="Configurer_les_règles_udev_pour_votre_appareil">Configurer les règles udev pour votre appareil</h3> -<p>Sous Linux, si vous obtenez ceci :</p> -<pre>< waiting for device ></pre> -<p>Cela signifie probablement que vous n'avez pas entré de règle udev spécifique au montage rapide (fastboot) de votre appareil, qui est différent de celui de adb. Vous pouvez obtenir le USB vendor ID en lançant <code>lsusb</code> , mais il s'agit habituellement de celui de Google : 18d1, aussi ajouter cette ligne dans votre fichier <code>/etc/udev/rules.d/51-android.rules</code> devrait suffire :</p> -<pre>SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"</pre> -<p>De façon plus générale, voir le <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Pour_Linux_.3A_configurer_la_r.C3.A8gle_udev_li.C3.A9e_au_t.C3.A9l.C3.A9phone">paragraphe sur la configuration des règles udev</a> dans l'article sur les prérequis.</p> -<div class="note"> - <strong>Note </strong>: Sous Linux, si vous obtenez une erreur <code>libusb </code>"-3", cela signifie que vous devez être root pour accéder au périphérique USB. Relancez le script à nouveau en utilisant <code>sudo</code>.</div> -<div class="note"> - <strong>Note 2</strong>: Si vous avez un téléphone Unagi ou un Geeksphone Keon; vous aurez besoin de deux lignes - une pour l'ID du vendeur de téléphone, et une pour l'ID de Google.</div> -<h3 id="Notes_destinées_aux_possesseurs_de_terminaux_Hamachi_Heix_et_Leo">Notes destinées aux possesseurs de terminaux Hamachi, Heix et Leo</h3> -<p>Si votre téléphone est un terminal Hamachi, Helix ou Leo, par défaut le script <code>./flash.sh</code> ne copiera que Gecko et Gaia. Il est recommander de flasher tout d'abord l'OEM comme base afin de disposer du firmware et des couches Gonk, puis de flasher Gecko et Gaia par dessus. Si vous désirez flasher en utilisant directement les images, vous pouvez outrepasser le comportement par défaut avec</p> -<div class="geckoVersionNote"> - <p>./flash.sh -f</p> -</div> -<h3 id="sect2"> </h3> -<h3 id="Notes_destinées_aux_possesseurs_de_Samsung_Galaxy_2">Notes destinées aux possesseurs de Samsung Galaxy 2</h3> -<p>Si votre téléphone est un Galaxy S2 et que vous utilisez Heimdall 1.3.2 (la dernière version ; utilisez <code>heimdall version</code> pour connaître la version que vous utilisez), vous pouvez apercevoir une erreur inquiétante "FACTORYFS upload failed!" accompagnée d'informations complémentaires. Il s'agit en fait d'un message indiquant la réussite de l'opération, que vous pouvez ignorer.</p> -<p>Pour vous débarasser de ce comportement étrange, récupérer une <a href="https://github.com/Benjamin-Dobell/Heimdall">copie de la source</a> d'Heimdall, en downgradant vers la version 1.3.1 (<code>git checkout fbbed42c1e5719cc7a4dceeba098981f19f37c06</code> ), puis compilez-la en suivant les informations du fichier <code>README</code>. L'installation de cette version devrait faire disparaître cette erreur. Cette étape, bien qu'utile pour retirer ce message étrange, n'est pas nécessaire.</p> -<p>Aucune version de Heimdall ne peut flasher une image système de plus de 100 Mo. Vous pouvez vérifier si votre image n'est pas trop grosse en utilisant la commande :</p> -<pre>ls -l ./out/target/product/galaxys2/system.img -</pre> -<p>Si elle est trop volumineuse, demandez conseil sur IRC (#b2g) ; il existe des solutions pour effectuer le flashage en deux fois.</p> -<h2 id="Étape_supplémentaire_pour_le_Samsung_Galaxy_S2">Étape supplémentaire pour le Samsung Galaxy S2</h2> -<p>Si vous flashez votre Galaxy S2, il vous faudra suivre cette étape supplémentaire. Gaia n'est pas flashée automatiquement par le script <code>flash.sh</code> ; vous aurez également besoin de lancer la commande</p> -<pre>./flash.sh gaia -</pre> -<h2 id="Flasher_des_partitions_spécifiques_vers_un_téléphone_avec_fastboot">Flasher des partitions spécifiques vers un téléphone avec fastboot</h2> -<p>Vous pouvez flasher des partitions spécifiques vers des téléphone avec fastboot (c'est à dire, autre qu'un Galaxy S 2). Par exemple :</p> -<pre>./flash.sh system -./flash.sh boot -./flash.sh user -</pre> -<div class="warning"> - <p>Attention : Flasher la partition user peut entraîner la pertes des informations spécifiques à l'utilisateur comme les contacts et autres !</p> -</div> -<h2 id="Mettre_à_jour_des_modules_spécifiques">Mettre à jour des modules spécifiques</h2> -<p>Vous pouvez mettre à jour des modules spécifiques en spécifiant leur nom lors de l'opération de flashage. Par exemple :</p> -<pre>./flash.sh gaia -./flash.sh gecko -</pre> -<p>Pour mettre à jour uniquement une application donnée, vous pouvez utiliser la variable d'environnement BUILD_APP_NAME :</p> -<pre>BUILD_APP_NAME=calendar ./flash.sh gaia</pre> -<p>Si vous n'utilisez pas votre téléphone pour développer (vous n'êtes pas intéressé(e) par les applications de tests et les éventuelles optimisations), vous pouvez mettre à jour Gaia grâce à la commande suivante :</p> -<pre class="language-html"><code class="language-html">VARIANT=user ./flash.sh gaia</code></pre> -<h2 id="Étapes_suivantes">Étapes suivantes</h2> -<p>Si vous êtes arrivés jusqu'ici, votre téléphone devrait exécuter Boot to Gecko ! C'est le moment d'expérimenter, d'écrire <a href="/en-US/docs/Mozilla/Firefox_OS/Application_development">un peu de code</a>, des <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing">tests</a>, ou de faire <a href="/en-US/docs/Mozilla/Firefox_OS/Debugging">une bonne session de débogage</a> !</p> -<div class="note"> - <strong>Note :</strong> Un petit conseil : si l'écran de verouillage de votre B2G nouvellement compilé demande un code de déverrouillage, le code par défaut est 0000.</div> -<h2 class="note" id="En_cas_de_problème...">En cas de problème...</h2> -<p>Voici quelques manipulations à effectuer si votre terminal ne fonctionne plus après l'installation de B2G, ou après une mise à jour.</p> -<h3 class="note" id="Si_l'interface_graphique_ne_se_lance_pas">Si l'interface graphique ne se lance pas</h3> -<p>Si vous mettez à jour votre téléphone et que l'interface utilisateur ne se lance pas, vous pouvez effectuer une remise à zéro pour effacer les informations de configurations périmées. Cela peut permettre de corriger le problème (attention : cela peut également supprimer les informations spécifiques à l'utilisateur comme les contacts et autres !)</p> -<p>Voici comment faire :</p> -<pre>cd gaia -make reset-gaia -</pre> -<h3 class="note" id="Si_vous_souhaitez_passer_d'une_version_de_développement_à_une_version_de_production">Si vous souhaitez passer d'une version de développement à une version de production</h3> -<pre class="language-html"><code class="language-html">cd gaia -make reset-gaia PRODUCTION=1</code></pre> -<p><strong>Attention </strong>: reset-gaia peut supprimer des informations spécifiques à l'utilisateur comme les contacts et autres !</p> -<h3 class="note" id="Message_d'erreur_image_is_too_large_au_lancement_de_.flash.sh">Message d'erreur "image is too large" au lancement de ./flash.sh</h3> -<p>Cela peut vouloir dire que vous devez rooter votre téléphone avant de le flasher, car B2G a besoin d'être installé sur la partition root.</p> diff --git a/files/fr/archive/b2g_os/introduction/index.html b/files/fr/archive/b2g_os/introduction/index.html deleted file mode 100644 index 27428cfdf0..0000000000 --- a/files/fr/archive/b2g_os/introduction/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Introduction à Firefox OS -slug: Archive/B2G_OS/Introduction -tags: - - Firefox OS - - Gaia - - Introduction -translation_of: Archive/B2G_OS/Introduction ---- -<div class="summary"> -<p>Firefox OS est là pour agrandir le champ des possibles du Web sur mobile et permettre à de nouveaux pans de la population d'être connectés avec leur premier smartphone. <strong>C'est</strong> un système d'exploitation libre, pour mobile, basé sur Linux, des standards ouverts et la technologie de Mozilla : Gecko. Il s'agit d'une réinvention de ce qu'une plateforme mobile peut être.</p> - -<p>Avec l'arrivée des WebAPIs permettant d'accéder au matériel et en proposant une interface de smartphone intuitive et élégante, Mozilla souhaite offrir aux développeurs web de nouvelles possibilités de créer d'excellents produits pour de nouveaux publics.</p> -</div> - -<h2 id="Public_ciblé">Public ciblé</h2> - -<p>Cet ensemble de documents est principalement à destination des développeurs web, ainsi qu'aux développeurs plate-forme qui veulent comprendre comment fonctionne Firefox OS, comment contribuer au projet et comment compiler et installer leur propre version sur des appareils. Pour ceux qui souhaitent créer et diffuser leurs applications web, l'<a href="/fr/Apps">App Center</a> et <a href="/fr/Marketplace">Marketplace Zone</a> sont conseillés.</p> - -<h2 id="La_pierre_angulaire_de_Firefox_OS">La pierre angulaire de Firefox OS</h2> - -<p>Pour les développeurs web/plate-forme, la chose la plus importante à comprendre est que la totalité de l'interface utilisateur est une application web, qui est capable d'afficher et lancer d'autres applications web. Toutes les modifications que vous pourriez apporter à l'interface utilisateur, ou toute application Firefox OS que vous voudriez créer, impliqueront les technologies web standard, tout en fournissant un accès privilégié au matériel et aux services de l'appareil.</p> - -<p>D'un point de vu produit, Firefox OS est une marque de Mozilla et ajoute une liste de services à Boot to Gecko (B2G), qui est le nom de code du système d'exploitation. L'interface utilisateur de Firefox OS est appelée Gaia, et inclut les applications essentielles ainsi que les fonctions système.</p> - -<p>Pour en apprendre plus sur l'architecture, voir le <a href="/fr/Firefox_OS/Platform">guide de la plateforme</a>.</p> - -<h2 id="Objectifs_présents_et_futurs">Objectifs présents et futurs</h2> - -<p>Plusieurs téléphones sont disponibles, tant pour développeurs que pour le grand public. Pour en savoir plus :</p> - -<ul> - <li><a href="/fr/Firefox_OS/Releases">Notes de version de Firefox OS</a> : nouveautés de chaque version.</li> - <li><a href="/fr/Firefox_OS/Developer_phone_guide">Guide des téléphones</a> : quels téléphones sont disponibles.</li> - <li><a href="https://wiki.mozilla.org/B2G/Roadmap">Feuille de route de B2G</a> : voir ce qui est prévu pour Firefox OS et pour quand.</li> -</ul> - -<h3 id="Cycle_de_développement">Cycle de développement</h3> - -<p>Depuis Firefox OS 1.2, son cycle de développement est aligné, autant que possible, sur celui de Gecko et Firefox Desktop, qui ont des cycles de 6 semaines. Sachant qu'une nouvelle version de Firefox OS sort tout les 3 mois, elle sortira donc toutes les 2 versions de Gecko (cœur du navigateur Firefox).</p> - -<p>Par exemple Gecko 30 est présent dans Firefox OS 1.4, et Gecko 32 dans Firefox OS 2.0 (anciennement 1.5). Les versions 29 et 31 de Gecko n'étant pas utilisées.</p> - -<div class="note"> -<p><strong>Note</strong> : Voir notre <a href="https://wiki.mozilla.org/RapidRelease/Calendar">calendrier des sorties</a> pour vérifier les correspondances de version entre Firefox OS et Gecko / Firefox Desktop et lire <a href="https://wiki.mozilla.org/Release_Management/FirefoxOS/Release_Milestones">Firefox OS Release Milestones</a> pour plus d'informations concernant notre gestion des versions et leur diffusion.</p> -</div> - -<h2 id="La_communauté">La communauté</h2> - -<p>Boot to Gecko et Gaia sont développés par des équipes d'ingénieurs au sein de Mozilla, ainsi que par un certain nombre de contributeurs externes appartenant à la grande communauté open source autour de Mozilla.</p> - -<p>Pour rapporter un bug, utilisez notre Bugzilla, et associez-le à un <a href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Firefox%20OS">composant Firefox OS</a>. Si vous n'êtes pas sûr du composant à sélectionner, n'hésitez pas à demander conseil.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour toute question ou remarque à propos d'une partie spécifique du code source B2G/Gaia (par exemple, une application Gaia particulière), vous pouvez trouver un contact plus spécialisé sur la <a href="https://wiki.mozilla.org/Modules/FirefoxOS">page des modules Firefox</a>.</p> -</div> - -<h2 id="Compiler_le_système_d'exploitation">Compiler le système d'exploitation</h2> - -<p>Le système d'exploitation B2G est basé sur <a href="/fr/docs/Mozilla/Gecko">Gecko</a>, le moteur de rendu de Mozilla, qui se trouve au-dessus d'un noyau Linux et d'une couche d'abstraction matérielle en espace utilisateur (HAL) appelée <a href="/fr/docs/Mozilla/Firefox_OS/Platform/Gonk">Gonk</a>. Le Gecko mentionné ici est essentiellement le même que le Gecko utilisé dans Firefox pour Android, ou Windows, ou Mac OS X, etc. Gonk est simplement une nouvelle cible sur laquelle Gecko doit fonctionner.</p> - -<p>Pour apprendre à compiler et installer Firefox OS, voir <a href="/fr/Firefox_OS/Building_and_installing_Firefox_OS">Compiler et installer Firefox OS</a>. Le code source de B2G est disponible sur <a href="https://github.com/mozilla-b2g/B2G">Github</a>.</p> - -<h2 id="Contribuer_à_Gaia">Contribuer à Gaia</h2> - -<p>Pour contribuer à Gaia, pas besoin de beaucoup plus qu'une bonne connaissance du développement web. Pour apprendre à lancer et faire fonctionner Gaia, voir <a href="/fr/Firefox_OS/Hacking_Firefox_OS/Quickstart_guide_to_Gaia_development">Développer pour Gaia</a>.</p> - -<p>Il existe un certain nombre d'utilitaires pratiques pour déboguer Gaia et d'autres applications web fonctionnant sous Firefox OS. Voir le guide <a href="/fr/Firefox_OS/Platform/Gaia/Hacking">Hacker Gaia</a> pour en savoir plus.</p> - -<h2 id="Développer_des_applications_pour_Firefox_OS">Développer des applications pour Firefox OS</h2> - -<p>Les applications Firefox OS reposent sur les technologies standard du web — HTML, CSS, JavaScript, etc. — donc si vous êtes un développeur web, vous connaissez déjà une grande partie de ce dont vous aurez besoin. Il y a quelques API JavaScript spéciales à connaitre, qui permettent d'accéder au matériel et à des fonctionnalités clefs (telles que l'appareil photo, le gyroscope, le capteur de lumière, les contacts, les alarmes système et les notifications…), mais celles-ci sont bien documentées sur les pages <a href="/fr/Apps">App Center</a> et <a href="/fr/docs/Web">Web Platform</a>.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour votre première application web ou Firefox OS, ou pour obtenir un aperçu des différences entre applications web et pages web traditionnelles, voir <a href="/fr/Apps/Quickstart">Commencer le développement d'applications web</a>.</p> -</div> - -<h3 id="Gérer_plusieurs_versions_de_Firefox_OS">Gérer plusieurs versions de Firefox OS</h3> - -<p>En développant des applications pour Firefox OS, vous devez prendre en compte la version qu'utilisera votre client (voir notre <a href="/fr/Firefox_OS/Developer_phone_guide/Phone_specs#Firefox_OS_phones_available">tableau des téléphones disponibles</a> pour la liste). Rappelez-vous qu'il n'est pas aussi simple de mettre à jour le système d'un téléphone qu'un logiciel d'ordinateur — les utilisateurs sont souvent tributaires de leur opérateur. Vous devez donc développer des applications qui prennent en charge ces versions. Comme exemple, multiline Flexbox ne fonctionne pas sur les versions de Firefox OS antérieures à 1.3, vous pourriez donc devoir utiliser une disposition plus simple ou une alternative pour ces versions.</p> - -<p>Ce problème devrait s'estomper au fur et à mesure que de nouveaux appareils Firefox OS sortent équipés de versions plus récentes.</p> - -<div class="note"> -<p><strong>Note </strong>: <a href="/fr/docs/Web">Ces pages MDN</a> contiennent des informations de compatibilité navigateur/système et vous pourrez trouver des informations de compatibilité concernant des technologies plus spécifiques aux applications sur notre page <a href="/fr/Apps/Reference">Application API Reference</a>.</p> -</div> diff --git a/files/fr/archive/b2g_os/media_support/index.html b/files/fr/archive/b2g_os/media_support/index.html deleted file mode 100644 index c020a9bd96..0000000000 --- a/files/fr/archive/b2g_os/media_support/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Support des médias dans Firefox OS -slug: Archive/B2G_OS/Media_support -tags: - - Firefox OS - - Guide - - HTML5 - - Média(2) -translation_of: Web/Media/Formats ---- -<p></p><div class="overheadIndicator draft"> - <p><strong>Brouillon</strong><br> - Cette page n'est pas terminée.</p> - -</div><p></p> - -<p>Aucun objet connecté moderne n'est complet sans un grand support multimédia, et Firefox OS en dispose assurément, en particulier avec la version 2.0 imminente. Voyez ici quels codecs sont supportés selon les versions de Firefox OS, et quelles sont les fonctionnalités selon les appareils.</p> - -<h2 id="Vidéo_H.264">Vidéo H.264</h2> - -<p>Firefox OS 2.0 introduit le support du codage et du décodage matériel des vidéos H.264 dans les flux médias WebRTC. Cela rend possible de soutenir des vidéoconférences ou des appels face-à-face avec une consommation optimisée de la batterie.</p> - -<h3 id="Activation_du_support_H.264">Activation du support H.264</h3> - -<p>À l'heure actuelle, certains appareils, tel que le téléphone développeur Flame, ne disposent pas d'un support vidéo H.264 activé par défaut. Vous devez définir un paramètre pour l'activer. Pour cela, vous avez besoin de modifier le fichier <code>prefs.js</code> situé dans votre profil sur l'appareil. Commencez par brancher l'appareil sur votre ordinateur sur lequel ont été au préalable <a href="/en-US/Firefox_OS/Firefox_OS_build_prerequisites#Install_adb">configurés les outils adb</a>.</p> - -<p>Tout d'abord, vous devez déterminer le nom du répertoire de votre profil. Vous pouvez le trouver de cette manière :</p> - -<pre>adb shell ls /data/b2g/mozilla</pre> - -<p>Parmi les informations affichées, vous verrez un répertoire dont le nom se compose de lettres et de chiffres aléatoires et qui se termine par ".default". Il s'agit du répertoire de votre profil. Utilisez ce nom lorsque vous verrez "xxxxxxxx" dans les instructions données à partir d'ici.</p> - -<p>Ensuite, récupérez le fichier <code>prefs.js</code> afin de pouvoir l'éditer :</p> - -<pre>adb pull /data/b2g/mozilla/xxxxxxx.default/prefs.js</pre> - -<p>Ouvrez le fichier obtenu dans votre éditeur de texte préféré ; ajoutez la ligne suivante à la fin du fichier et enregistrez vos modifications.</p> - -<pre>user_pref("media.peerconnection.video.h264_enabled", true);</pre> - -<p>À présent, tout ce qu'il vous reste à faire est d'envoyer le fichier modifié vers l'appareil et de redémarrer le processus <code>b2g</code> pour prendre en compte les changements, comme ceci :</p> - -<pre>adb push pref.js /data/b2g/mozilla/xxxxxxxx.default -adb shell stop b2g -adb shell start b2g -</pre> - -<h2 id="Support_des_conteneurs_et_codecs">Support des conteneurs et codecs</h2> - -<p><em>Cette section contiendra (bientôt, espérons) des informations sur les codecs supportés, les conteneurs (formats de fichier) qui peuvent les encapsuler, et pour chacun quels appareils et versions de l'OS les prennent en charge.</em></p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/HTML/Utilisation_d'audio_et_video_en_HTML5">Utilisation d'audio et vidéo en HTML5</a></li> - <li><a href="/fr/docs/Web/HTML/formats_media_support">Formats Media supportés par les éléments HTML audio et vidéo</a></li> - <li><a href="/fr/docs/Web/HTML/Element/video" title="L'élément HTML <video> intègre un contenu vidéo dans un document."><code><video></code></a></li> - <li><a href="/fr/docs/Web/HTML/Element/audio" title="L'élément HTML <audio> est utilisé afin d'intégrer un contenu sonore dans un document. Il peut contenir une ou plusieurs sources audio représentées avec l'attribut src ou l'élément <source>. S'il y a plusieurs sources, l'agent utilisateur choisira celle qui convient le mieux."><code><audio></code></a></li> -</ul> diff --git a/files/fr/archive/b2g_os/mulet/index.html b/files/fr/archive/b2g_os/mulet/index.html deleted file mode 100644 index e2900841af..0000000000 --- a/files/fr/archive/b2g_os/mulet/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Mulet -slug: Archive/B2G_OS/Mulet -tags: - - B2G Mulet - - B2G OS - - Essayez b2g os - - Mulet -translation_of: Archive/B2G_OS/Mulet ---- -<p class="summary">En suivant ce guide, vous pourrez exécuter Gaia dans une version spéciale de Firefox appelée Firefox Mulet. Cela apporte comme avantages le fait d'avoir un cycle de développement rapide, ainsi que des outils de développement web standards et des débogueurs pour travailler avec. Tout d'abord, vous devez avoir cloné le dépôt <a class="external external-icon" href="https://github.com/mozilla-b2g/gaia">Gaia</a> sur votre machine et construit votre propre profil. Ensuite, il vous faut installer mulet et le lancer, en lui précisant votre profil Gaia comme profil à utiliser.</p> - -<blockquote> -<p>Le <strong>mulet</strong> et la <strong>mule</strong> sont des <a href="https://fr.wikipedia.org/wiki/Hybride" title="Hybride">hybrides</a> statistiquement stériles de la famille des <a class="mw-redirect" href="https://fr.wikipedia.org/wiki/%C3%89quid%C3%A9" title="Équidé">équidés</a>, engendrés par un <a href="https://fr.wikipedia.org/wiki/%C3%82ne_commun" title="Âne commun">âne</a> (<em>Equus asinus</em>) et une <a href="https://fr.wikipedia.org/wiki/Jument" title="Jument">jument</a> (<em>Equus caballus</em>) - Wikipedia</p> -</blockquote> - -<div class="note"> -<p>D'après <a href="https://wiki.mozilla.org/Mulet">le wiki</a>, "Mulet" vient du mot français désignant une "mule" et s'écrit avec un seul l !</p> -</div> - -<h2 id="Où_puis-je_l'obtenir">Où puis-je l'obtenir ?</h2> - -<p>Comme tout autre programme, Mulet peut être lancé à partir d'un paquet précompilé : il s'agit de la méthode la plus simple pour les nouveaux utilisateurs. Ceux plus expérimentés, évidemment, peuvent toujours compiler Mulet eux-mêmes pour tester de nouvelles fonctionnalités et corrections de bogues. Quelle que soit la méthode que vous allez suivre, <u><strong>souvenez-vous que vous ne pourrez pas lancer Mulet sans un profil Gaia</strong></u>.</p> - -<h2 id="Exécutable_seul">Exécutable seul</h2> - -<p>À l'origine, ce paquet était distribué via <a href="https://discourse.mozilla-community.org/t/mulet-gaia-for-linux/10375">Discourse</a>. C'est la façon la plus rapide de lancer Mulet pour les personnes qui ne le connaissent pas et/ou qui ne disposent pas d'un accès Internet haut débit pour cloner la totalité du dépôt Gaia. <strong>Le paquet contient Mulet et un profil Gaia précompilé</strong>, les utilisateurs n'ont pas besoin de compiler quoi que ce soit.</p> - -<ol> - <li>Téléchargez l'<a href="https://drive.google.com/file/d/0BwEhwFrol52LQmowQTR1V3gxWFk">Archive (94 Mb)</a></li> - <li>Décompressez l'archive</li> - <li><code>Cd</code> vers le dossier extrait</li> - <li>Attribuez des permissions au fichier <code>start.sh</code> dans un terminal avec <code>chmod +x</code> ou en faisant un clic droit sur le fichier > permissions > cochez Autoriser l'exécution du fichier comme un programme.</li> - <li>Lancez à présent le fichier avec <code>./start.sh</code> ou en double-cliquant dessus</li> -</ol> - -<div class="note"> -<p><strong>Note :</strong> L'exécutable a été testé sur <strong>Ubuntu 16.04 64 bits</strong> et <strong>Arch Linux</strong> mais devrait sans doute tourner sur toutes les distributions linux.</p> -</div> - -<ol> -</ol> - -<div class="warning"> -<p>Si vous utilisez <strong>Gnome 3</strong>, le script ne voudra sans doute pas se lancer depuis Fichiers. Pour résoudre ce problème, ouvrez les Préférences. Sélectionnez l'onglet 'Comportement'. Sous "Fichiers texte exécutables", choisissez "Demander à chaque fois" ou "Lancer les fichiers textes exécutables lorsqu'ils sont ouverts". Fermez la fenêtre.</p> -</div> - -<h2 id="Binaires_précompilés">Binaires précompilés</h2> - -<h3 id="Mulet">Mulet</h3> - -<p>Vous pouvez télécharger des binaires précompilés pour Linux depuis TaskCluster de Mozilla. Pour les récupérer,</p> - -<ol> - <li>Rendez-vous sur <a href="https://tools.taskcluster.net/index/artifacts/#gecko.v1.mozilla-central.latest.linux.mulet/gecko.v1.mozilla-central.latest.linux.mulet.opt">https://tools.taskcluster.net/index/artifacts/#gecko.v1.mozilla-central.latest.linux.mulet/gecko.v1.mozilla-central.latest.linux.mulet.opt</a></li> - <li>Recherchez <span><span>"<code>public/build/target.tar.bz2</code>" dans la liste d'artefacts sur la droite</span></span></li> - <li><span><span>Téléchargez puis décompressez l'archive quelque part</span></span></li> - <li>Le binaire "Firefox" qui se trouve dans ce dossier peut faire tourner mulet. Si vous le souhaitez, vous pouvez ajouter dans votre path un lien symbolique qui pointe dessus.</li> -</ol> - -<h3 id="Gaia">Gaia</h3> - -<p>Pour exécuter Mulet il faut une copie de Gaia. Normalement, elle est récupérée à partir de <a href="https://github.com/mozilla-b2g/gaia/">Github</a> :</p> - -<pre>$ git clone https://github.com/mozilla-b2g/gaia.git</pre> - -<p>Ensuite, vous devez construire un profil Gaia :</p> - -<pre>$ cd ~/gaia -$ make -</pre> - -<h3 id="Exécution">Exécution</h3> - -<p>Enfin, vous pouvez lancer Mulet :</p> - -<pre>$ chemin/vers/mulet/firefox-bin --no-remote --devtools --profile ./profile -</pre> - -<h2 id="sect1"> </h2> - -<h2 id="Windows_et_Mac_OS">Windows et Mac OS</h2> - -<h3 id="Mulet_2">Mulet</h3> - -<p>Les versions Windows et Mac sont disponibles sur <a class="external external-icon" href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/">Mozilla Central</a>. Les builds Mulet sont les paquets dont les noms commencent par <strong><code>firefox-*</code></strong>, par exemple <code>firefox-36.0a1.en-US.mac64.dmg.</code></p> - -<p>Une fois téléchargé, installez le build de Mulet dans un endroit sûr afin de ne pas écraser votre version de Firefox Nightly normale. Par exemple, sur Mac OS X, créez un nouveau dossier dans Applications appelé "mulet" puis faîtes-le glisser dedans.</p> - -<p>À présent, lancez la version de Mulet en ligne de commande, en lui précisant votre profil Gaia comme profil à utiliser lors de l'ouverture (indiqué par l'option <code>-profile</code>.) Par exemple, il est possible de lancer quelque chose de ce genre depuis votre dossier Applications sur Mac OS X si vous l'avez installé à cet endroit :</p> - -<pre class="brush: bash line-numbers language-bash"><code class="language-bash">./firefox/Contents/MacOS/firefox-bin -no-remote -profile /Users/my-home</code></pre> - -<h2 id="sect2"> </h2> - -<h2 id="Utilisation_de_Mulet"><strong>Utilisation de Mulet</strong></h2> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13767/Screenshot%20from%202016-08-19%2020-08-44.png" style="height: 569px; width: 1086px;"></p> - -<p>Sur l'affichage, vous obtenez la <a href="https://developer.mozilla.org/fr/docs/Outils/Outils_boite_à_outils">Boîte à outils</a> standard de Firefox pour le débogage de vos applications, plus un émulateur B2G OS tournant dans la partie gauche ainsi qu'un certain nombre d'autres outils utiles relatifs à Gaia. Les contrôles au-dessus de l'émulateur vous permettent de :</p> - -<ul> - <li>Choisir différentes tailles d'écran pour l'émulateur (à la base, il s'agit d'une <a href="https://developer.mozilla.org/fr/docs/Outils/Vue_adaptative">Vue adaptative</a>).</li> - <li>Faire pivoter l'écran de l'émulateur.</li> - <li>Activer ou désactiver la simulation des événements tactiles (si désactivée, vous ne pouvez pas utiliser la souris pour faire glisser l'interface et les applications ouvertes.)</li> - <li>Prendre des captures d'écran.</li> -</ul> - -<h2 id="Références_supplémentaires">Références supplémentaires</h2> - -<ul> - <li><a href="https://developer.mozilla.org/fr/docs/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia#Utiliser_Gaia_dans_Firefox_Mulet">Utilisation de Gaia dans Firefox Mulet</a></li> - <li><a href="https://wiki.mozilla.org/Mulet">Page Wiki</a></li> - <li>Sujets dédiés sur Discourse (en anglais) : - <ul> - <li><a href="https://discourse.mozilla-community.org/t/what-about-mulet/8384">What about Mulet</a></li> - <li><a href="https://discourse.mozilla-community.org/t/using-mulet-on-linux/9437/">Using Mulet on Linux</a></li> - <li><a href="https://discourse.mozilla-community.org/t/theres-no-win-version-for-mulet-49/9394">There's no Win version of Firefox Mulet</a></li> - <li><a href="https://discourse.mozilla-community.org/t/installation-instructions-for-a-working-development-environment-on-linux/10378/13">Installation instructions for a working development environment on linux</a></li> - </ul> - </li> -</ul> diff --git a/files/fr/archive/b2g_os/pandaboard/index.html b/files/fr/archive/b2g_os/pandaboard/index.html deleted file mode 100644 index 3713db85e3..0000000000 --- a/files/fr/archive/b2g_os/pandaboard/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: Pandaboard -slug: Archive/B2G_OS/Pandaboard -tags: - - Boot2Gecko - - Firefox OS - - Pandaboard -translation_of: Archive/B2G_OS/Pandaboard ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p>C'est un guide pour installer Firefox OS sur une <a href="http://pandaboard.org/" title="http://pandaboard.org/">PandaBoard</a>. La PandaBoard est une tablette à bas prix basée sur une carte-mère OMAP 4 pour développer un système d'exploitation mobile.</p> - -<p>Assurez-vous d'avoir une carte-mémoire SD avec au moins 4 giga disponibles.</p> - -<h2 id="Formater_la_carte_SD">Formater la carte SD</h2> - -<p>Suivez ce <a href="http://omappedia.org/wiki/Minimal-FS_SD_Configuration" title="http://omappedia.org/wiki/Minimal-FS_SD_Configuration">guide</a> pour formater votre carte SD.</p> - -<h2 id="Communication_USB">Communication USB</h2> - -<p>Pour activer la communication usb avec votre pandaboard, suivez ces <a href="http://source.android.com/source/initializing.html#configuring-usb-access">étapes</a>. Pour B2G, il est plus sûr d'utiliser le mode de fichier "0666".</p> - -<p>Vérifiez que la pandaboard est accessible en la branchant en usb à votre ordinateur et en lançant la commande suivante dans votre terminal :</p> - -<pre>lsusb</pre> - -<p>Si vous voyez s'afficher quelque chose avec Texas Instruments, alors votre pandaboard est détectée ! Si ce n'est pas le cas , essayez de débrancher tous les câbles de votre ordinateur et de laisser juste la pandaboard connectée en usb.</p> - -<h2 id="Construire_et_flasher">Construire et flasher</h2> - -<p>Après avoir tout <a href="https://developer.mozilla.org/fr/Firefox_OS/Preparing_for_your_first_B2G_build" title="https://developer-new.mozilla.org/en/Mozilla/Boot_to_Gecko/Preparing_for_your_first_B2G_build">configuré</a> pour la pandaboard, nous allons maintenant nous lancer dans <a href="https://github.com/mozilla/Negatus" title="https://github.com/mozilla/Negatus">Negatus</a>. Il s'agit d'un agent qui tourne sur l'appareil et qui permet de le déboguer/automatiser. Negatus va se construire lui-même automatiquement après que vous ayez lancé ./build.sh ; vous devrez néanmoins installer llibnspr(<code>apt-get install libnspr4-dev). </code>Après la <a href="https://developer.mozilla.org/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko" title="https://developer-new.mozilla.org/en-US/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">construction</a> de l'image, la partie délicate qui suit consiste à la flasher sur votre pandaboard.</p> - -<p>Essayez de suivre les instructions présentes <a href="https://github.com/mozilla-b2g/android-device-panda" title="https://github.com/mozilla-b2g/android-device-panda">ici</a>, jusqu'à 'Initial setup, part 3' inclus. Vous pouvez ignorer 'Initial setup, part 1' qui a déjà été effectuée au cours de l'étape de construction. Revenez ici après avoir terminé 'Initial setup, part 3'.</p> - -<p>Vous pouvez à présent lancer la commande <code>./flash.sh</code> et en principe tout devrait bien se passer. Si le script <code>flash.sh</code> essaye d'effacer la partition userdata, supprimez cette ligne. C'est un problème connu listé dans les <a href="https://github.com/mozilla-b2g/android-device-panda" title="https://github.com/mozilla-b2g/android-device-panda">instructions</a>.</p> - -<p>Après la fin du flashage, vous devez manuellement redémarrer la machine en débranchant les câbles d'alimentation et usb, puis en les rebranchant (le câble d'alimentation doit être branché en premier).</p> - -<p>Voici comment contourner les problèmes connus :</p> - -<h3 id="waiting_for_OMAP4XXX..._en_tentant_d'utiliser_usbboot">"waiting for OMAP4XXX..." en tentant d'utiliser usbboot</h3> - -<p>Si vous voyez ce message, débranchez tous les câbles de la pandaboard. Branchez la pandaboard uniquement via l'USB. Ne branchez pas l'alimentation. Essayez à présent, puis lancez <code>usbboot</code> avec <code>sudo</code>.</p> - -<h3 id="Erreurs_fastboot_lors_du_flashage">Erreurs fastboot lors du flashage</h3> - -<p>Si vous rencontrez des difficultés pour exécuter des commandes dans fastboot, elles peuvent réussir en les lançant avec <code>sudo</code> (c'est-à-dire : <code>sudo <commande fastboot...></code>)</p> - -<p>Par ailleurs, si vous avez des problèmes pour faire entrer votre pandaboard en mode fastboot (c'est-à-dire : aucun périphérique n'est listé si vous faites un appel à <code>fastboot devices</code>), alors vous pouvez :</p> - -<ol> - <li>Débranchez tout ce qui est relié à la pandaboard</li> - <li>Maintenez enfoncé le bouton GPIO</li> - <li>Branchez l'alimentation tout en maintenant toujours le bouton enfoncé</li> - <li>Surveillez le voyant d'état et une fois qu'il commence à clignoter, relâchez le bouton GPIO</li> -</ol> - -<p>Cela va faire entrer la pandaboard en mode fastboot.</p> - -<h3 id="Impossible_de_se_connecter_à_adb">Impossible de se connecter à adb</h3> - -<p>Si vous voyez l'appareil avec lsusb mais pas dans les périphériques adb/fastboot et que les voyants sont éteints, débranchez la source d'alimentation puis rebranchez-la. Si les voyants sont allumés, il faudra peut-être attendre quelques instants (30 secondes maximum) pour que l'appareil soit enregistré sur adb.</p> - -<p>Quelquefois, le flashage sera annoncé comme ayant réussi mais ce ne sera pas le cas. Reflashez la pandaboard (c'est-à-dire : exécutez <code>./flash.sh</code>) et réessayez. Je conseille de brancher l'alimentation d'abord, et de brancher le câble usb ensuite</p> - -<p>Si vous obtenez "??????????? no permision" pour les appareils adb, même en root, vérifiez la section "Configuring USB Access" sur ce <a href="http://source.android.com/source/initializing.html" title="http://source.android.com/source/initializing.html">site</a> et corrigez - ou ajoutez - les bonnes règles udev. N'oubliez pas de redémarrer le service udev après avoir fait les modifications.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire/index.html b/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire/index.html deleted file mode 100644 index 9f8ebb4ecb..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Alcatel One Touch Fire -slug: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire -tags: - - Alcatel One Touch Fire - - Client - - Firefox OS - - Téléphone -translation_of: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="https://mdn.mozillademos.org/files/10285/alcatel-onetouchfire.7e8f7701bbff.png" style="height: 366px; width: 200px;"></div> - -<div class="column-half"> -<p>Le smartphone Alcatel One Touch Fire sous <span>Firefox OS dispose d'un processeur à 1 GHz et d'une caméra 3,2 MP</span>. Il est disponible à différents endroits dans le monde, auprès d'une large variété d'opérateurs.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>L'Alcatel One Touch Fire est disponible via les canaux de distribution classiques.</p> - -<h2 id="Disponibilité">Disponibilité</h2> - -<div class="column-container"> -<div class="column-half"> -<ul> - <li>Allemagne</li> - <li>Brésil</li> - <li>Chili</li> - <li>Colombie</li> - <li>Grèce</li> - <li>Hongrie</li> - <li>Italie</li> -</ul> -</div> - -<div class="column-half"> -<ul> - <li>Mexique</li> - <li>Montenegro</li> - <li>Pérou</li> - <li>Pologne</li> - <li>Serbie</li> - <li>Venezuela</li> -</ul> -</div> -</div> - -<h2 id="Opérateurs">Opérateurs</h2> - -<div class="column-container"> -<div class="column-half"> -<ul class="comma-list"> - <li>Congstar</li> - <li>Cosmote</li> - <li>Movistar</li> - <li>T-Mobile</li> -</ul> -</div> - -<div class="column-half"> -<ul> - <li>Telcel</li> - <li>Telenor</li> - <li>TIM</li> - <li>Vivo</li> -</ul> -</div> -</div> -</div> -</div> - -<h2 id="Mise_à_jour_logicielle">Mise à jour logicielle</h2> - -<p>L'image système de l'appareil est verrouillée, si bien qu'il n'est possible de le mettre à jour que lorsque l'opérateur téléphonique publie une mise à jour OTA.</p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver plus de détails sur les caractéristiques de l'appareil sur le <a href="http://www.alcatelonetouch.com/global-en/products/smartphones/one_touch_fire.html#.VQPk8DWnWPs">site Web d'Alcatel</a> sous l'onglet Spécification</p> - -<ul> - <li><strong>CPU</strong> : CPU Qualcomm Snapdragon MSM7227A, 1 GHz</li> - <li><strong>Caméra</strong> : 3,2 mégapixels</li> - <li><strong>Batterie </strong>: 1400 mAh</li> - <li><strong>Affichage</strong> : affichage 262K couleurs 3,5” HVGA TFT</li> - <li><strong>Résolution </strong>: 320x480 pixels</li> - <li><strong>Mémoire interne </strong>: 512Mo NAND + 256Mo RAM</li> - <li><strong>Stockage externe </strong>: Carte MicroSD : jusqu'à 32Go</li> - <li><strong>Dimensions </strong>: <span>115 x 62,3 x 12,2 mm</span></li> - <li><strong>Poids</strong> : Env. <span>108g</span></li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Mozilla Orange</li> - <li>Blanc pur</li> - <li>Vert pomme</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.alcatelonetouch.com/global-en/products/smartphones/one_touch_fire.html#.VQPk8DWnWPs">Alcatel One Touch Fire</a><a href="http://www.zenmobile.in/category-ultrafone/105-fire"> </a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_c/index.html b/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_c/index.html deleted file mode 100644 index 8cbc4e1d8c..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_c/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Alcatel One Touch Fire C -slug: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire_C -tags: - - Alcatel One Touch Fire - - Client - - Firefox OS - - One Touch Fire C - - Téléphone - - Téléphone Alcatel Firefox -translation_of: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire_C ---- -<div class="column-container"> -<div class="column-half"> <img alt="" src="https://mdn.mozillademos.org/files/10295/fire-c-color-range-308x360-bluish-black-20140911101107.png"></div> - -<div class="column-half"> -<p>Le smartphone Alcatel One Touch Fire C fonctionne sous<span> Firefox OS ; il dispose d'un processeur double-coeur à 1,2 GHz, d'un appareil photo 2 MP et est disponible e</span>n Inde.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<ul> - <li>Actuellement non disponible</li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<ul> - <li>Inde</li> - <li>Uruguay</li> -</ul> -</div> -</div> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil étant verrouillée, vous ne pouvez mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.2.</p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver davantage de spécifications d'appareils listées sur le <a href="http://www.alcatelonetouch.com/global-en/products/smartphones/fire_c.html#2">site Web d'Alcatel</a> dans l'onglet Specification.</p> - -<ul> - <li><strong>CPU</strong> : CPU double-coeur à 1,2 GHz</li> - <li><strong>Caméra </strong>: 2 MP (arrière)</li> - <li><strong>Batterie </strong>: 1300mAh</li> - <li><strong>Affichage </strong>: HVGA 3,5”, affichage TFT 262K couleurs, écran capacitif avec gestes.</li> - <li><strong>Résolution </strong>: 320x480 pixels</li> - <li><strong>Mémoire interne </strong>: ROM 4Go + RAM 512Mo</li> - <li><strong>Mémoire externe </strong>: Carte MicroSD : jusqu'à 32Go</li> - <li><strong>Dimensions </strong>: <span>112,2 x 62 x 11,95mm</span></li> - <li><strong>Poids </strong>: Env.<span>100g</span></li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Bluish Blue</li> - <li>White</li> - <li>Mozilla Orange</li> - <li>Full White</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.alcatelonetouch.com/global-en/products/smartphones/fire_c.html#2">Alcatel One Touch Fire</a><a href="http://www.zenmobile.in/category-ultrafone/105-fire"> </a></li> - <li><a href="http://www.gsmarena.com/alcatel_fire_c-6138.php">Spécifications sur GSM Arena</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_e/index.html b/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_e/index.html deleted file mode 100644 index 9ded561a3e..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_fire_e/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Alcatel One Touch Fire E -slug: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire_E -tags: - - Alcatel One Touch Fire E - - Firefox OS - - Mobiles Alcatel - - Spécifications de l'Alcatel One Touch Fire E -translation_of: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Fire_E ---- -<div class="column-container"> -<div class="column-half"> -<p><img alt="Image of ALCATEL ONETOUCH E " src="https://mdn.mozillademos.org/files/10291/Alcatel%20OneTouch%20E.jpg" style="display: block; height: 367px; margin: 20px auto; width: 275px;"></p> -</div> - -<div class="column-half"> -<p class="summary">Le smartphone Alcatel One Touch Fire <span>E est propulsé par Firefox OS; il dispose d'un processeur double cœur à 1,2 GHz, d'un écran haute résolution et d'un appareil photo 5 MP + caméra frontale VGA ; il est disponible en différents endroits du globe</span>.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>L'Alcatel One Touch Fire E est disponible via les canaux de distribution classiques.</p> - -<h3 id="Disponibilité">Disponibilité</h3> - -<div class="column-container"> -<div class="column-half"> -<ul> - <li>Allemagne</li> - <li>Hongrie</li> - <li>Pologne</li> -</ul> -</div> - -<div class="column-half"> -<ul> - <li>République tchèque</li> - <li>Russie</li> -</ul> -</div> -</div> - -<h3 id="Opérateurs">Opérateurs</h3> - -<div class="column-container"> -<div class="column-half"> -<ul class="comma-list"> - <li>Congstar</li> - <li>MegaFon</li> -</ul> -</div> - -<div class="column-half"> -<ul> - <li>O2</li> - <li>T-Mobile</li> -</ul> -</div> -</div> -</div> -</div> - -<p> </p> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil est verrouillée, il n'est possible de mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA.</p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver plus d'informations sur les spécifications de l'appareil dans la section Specification du <a href="http://www.alcatelonetouch.com/global-en/products/detail?model=FIRE%20E">site Web d'Alcatel</a></p> - -<ul> - <li><strong>CPU</strong> : CPU double cœur à 1,2 GHz</li> - <li><strong>Caméra </strong>: 5 MP, 2592 х 1944 pixels, autofocus, flash LED, caméra frontale VGA</li> - <li><strong>Batterie</strong> : 1700 mAh</li> - <li><strong>Affichage</strong> : Affichage couleurs 16M IPS, 4,5” qHD 960 x 540 pixels</li> - <li><strong>Résolution </strong>: 540x960 pixels</li> - <li><strong>Mémoire interne</strong> : ROM emmc 4Go / RAM 512Mo</li> - <li><strong>Mémoire externe</strong> : Carte microSD : jusqu'à 32Go</li> - <li><strong>Dimensions </strong>: <span>129 x 63,5 x 8,2 mm </span></li> - <li><strong>Poids </strong>: Env. <span>103g</span></li> - <li><strong>SIM : </strong>Carte micro SIM, SIM EAP</li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Mozilla Orange</li> - <li>Chocolat foncé</li> - <li>Ardoise</li> -</ul> - -<h2 id="Voir_également">Voir également</h2> - -<ul> - <li><a href="http://www.alcatelonetouch.com/global-en/products/detail?model=FIRE%20E">Alcatel One Touch Fire E</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_pixi_3_(3.5)/index.html b/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_pixi_3_(3.5)/index.html deleted file mode 100644 index 61a033332c..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/alcatel_one_touch_pixi_3_(3.5)/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Alcatel One Touch Pixi 3 (3.5) -slug: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Pixi_3_(3.5) -tags: - - Firefox OS - - Landing - - Téléphones -translation_of: Archive/B2G_OS/Phone_guide/Alcatel_One_Touch_Pixi_3_(3.5) ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="https://technux0.files.wordpress.com/2015/07/alcatel-p335-ff.jpg" style="height: 350px; width: 210px;"></div> - -<div class="column-half"> -<p><span>L'Alcatel One Touch Pixi 3 (3,5) est un smartphone haut de gamme sous Firefox OS 2.0, avec un appareil photo de 2 mégapixels.</span></p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le téléphone peut être acheté ici :</p> - -<ul> - <li><a href="http://www.ebay.com/itm/121691735698" rel="nofollow">Commander l'Alcatel One Touch Pixi 3 (3,5) sur Ebay </a></li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<ul> - <li>Inde</li> -</ul> - -<p> </p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<ul> - <li><strong>Chipset</strong> : Mediatek MT6572M</li> - <li><strong>CPU</strong> : Cortex-A7 double cœur à 1 GHz</li> - <li><strong>GPU </strong>: Mali-400</li> - <li><strong>Caméra</strong> : 2 MP, 1600 x 1200 pixels/flash LED (optionnel)</li> - <li><strong>Batterie </strong>: batterie Li-Ion 1300 mAh</li> - <li><strong>Écran </strong>: écran tactile TFT 3,5 pouces capacitif</li> - <li><strong>Résolution </strong>: <span id="lblSpec">320 x 480 pixels (</span>densité de pixels ~165 ppp)</li> - <li><strong>Mémoire interne </strong>: 512 Mo, 256/512 Mo RAM</li> - <li><strong>Mémoire externe </strong>: microSD (max. 32 Go)</li> - <li><strong>Dimensions </strong>: 112,2 x 62 x 11,9 mm</li> - <li><strong>Poids </strong>: Env. 98 g</li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Noir</li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/alcatel_onetouch_fire_c_4020d/index.html b/files/fr/archive/b2g_os/phone_guide/alcatel_onetouch_fire_c_4020d/index.html deleted file mode 100644 index 3b97669202..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/alcatel_onetouch_fire_c_4020d/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Alcatel Onetouch Fire C 4020D -slug: Archive/B2G_OS/Phone_guide/Alcatel_Onetouch_Fire_C_4020D -tags: - - Alcatel - - Appareils Tarako - - Client - - Firefox OS - - Onetouch Fire C - - Téléphone -translation_of: Archive/B2G_OS/Phone_guide/Alcatel_Onetouch_Fire_C_4020D ---- -<div class="column-container"> -<div class="column-half"><img alt="Intex Cloud FX image from official website" src="https://mdn.mozillademos.org/files/10093/fire-c-2g-02.png" style="display: block; height: 454px; margin: 0px auto; width: 252px;"></div> - -<div class="column-half"> -<p>L'Alcatel Onetouch Fire C 4020D est un smartphone grand public, basé sur Tarako Firefox OS, et distribué en Inde. Il a été distribué par Alcatel en août 2014.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<ul> - <li>Ce téléphone est abandonné.</li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<p>Inde</p> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil étant bloquée, vous ne pouvez mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.3T.</p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Davantage de spécifications d'appareils sont listées sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page de spécifications de téléphones et appareils</a>.</p> - -<ul> - <li><strong>CPU</strong> : 1GHz</li> - <li><strong>Caméra </strong>: 1,3 mégapixels (arrière)</li> - <li><strong>Batterie</strong> : 1000 mAh</li> - <li><strong>Affichage </strong>: HVGA 3,5"</li> - <li><strong>Résolution </strong>: <span id="lblSpec">320 x 480</span></li> - <li><strong>Mémoire interne </strong>: ROM 256Mo, RAM 128Mo </li> - <li><strong>Mémoire externe </strong>: microSD (32Go max.)</li> - <li><strong>Dimensions</strong> : <span>112,2 x 62 x 11,95mm</span></li> - <li><strong>Poids </strong>: Env. 93g (avec batterie)</li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Bluish Black</li> - <li>Dark Aubergine</li> - <li>Dark Chocolate<span id="cke_bm_95E" style="display: none;"> </span></li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.alcatelonetouch.com/in/products/smartphones/fire_c_2g.html#.VNUS5DVyhWU">Informations officielles sur l'Alcatel OneTouch Fire C 2G</a></li> - <li><a href="http://www.spicesmartphones.com/index.php?route=information/userguide/download&prod_id=249">Guide de l'utilisateur</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/best_practices_open_reference_devices/index.html b/files/fr/archive/b2g_os/phone_guide/best_practices_open_reference_devices/index.html deleted file mode 100644 index 235f2bf40d..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/best_practices_open_reference_devices/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Les bonnes pratiques pour appareils de référence ouverts -slug: Archive/B2G_OS/Phone_guide/Best_practices_open_reference_devices -tags: - - Bonnes pratiques - - Firefox OS - - Périphériques - - Téléphones - - appareil de référence -translation_of: Archive/B2G_OS/Phone_guide/Best_practices_open_reference_devices ---- -<div class="summary"> -<p><span class="seoSummary">Le présent article a pour objectif de fournir un ensemble de bonnes pratiques que nous considérons comme devant être recommandées pour tout appareil de référence ouvert disponible. Tous les appareils Firefox OS récents ont respecté ces pratiques, dont le Flame.</span></p> -</div> - -<p>Les appareils doivent avoir :</p> - -<ul> - <li>Des compilations facilement accessibles et installables</li> - <li>Un système d'exploitation totalement déverrouillé</li> - <li>Une disponibilité mondiale</li> - <li>Un support des fonctionnalités équivalent à celui des téléphones grand public</li> - <li>Des batteries de remplacement disponibles</li> - <li>Des choix de langues faciles à faire</li> -</ul> - -<h2 id="Des_compilations_facilement_accessibles_et_installables">Des compilations facilement accessibles et installables</h2> - -<p>Les appareils de référence sont essentiellement destinés aux développeurs et aux personnes qui ont des connaissances techniques plus importantes que celles de l'utilisateur moyen de téléphone. Malgré cela, nous ne nous attendons pas à ce que les utilisateurs de ces appareils fassent leurs propres compilations s'ils ne le souhaitent pas — pour la plupart d'entre-eux c'est une simple perte de temps.</p> - -<p>Les appareils de référence ouverts doivent disposer d'un ensemble de builds non verrouillées maintenu pour les versions actuelles et futures, simple à obtenir et à installer. Cela signifie avoir plusieurs canaux disponibles, au moins :</p> - -<ul> - <li>Diffusé/Actuel</li> - <li>Stable/Bêta</li> - <li>Nocturne</li> -</ul> - -<p>Il faudrait rendre ces builds disponibles sur une page de téléchargement dédiée, avec des mises à jour fréquentes et régulières. Des mises à jour OTA devraient aussi être mises à disposition des utilisateurs, pour chaque appareil.</p> - -<p>Les OEMs devraient avoir la responsabilité de fournir ces mises à jour car ils sont les seuls à pouvoir légalement distribuer tous les binaires requis, etc.</p> - -<p>Il serait logique de suivre un modèle similaire à celui du navigateur Firefox, où chacun des canaux -release, stable et nocturne- est basé sur sa branche respective du code source.</p> - -<h2 id="Un_système_d'exploitation_totalement_déverrouillé">Un système d'exploitation totalement déverrouillé</h2> - -<p>La plate-forme du système d'exploitation de l'appareil doit être totalement déverrouillée afin que les développeurs du système et des applications aient une liberté de contrôle sur leurs appareils. Ceci leur permet d'effectuer tous les tests souhaités ainsi que les travaux de développement. Cela implique que :</p> - -<ul> - <li>Le téléphone soit désimlocké</li> - <li>Le gestionnaire d'amorçage soit déverrouillé</li> - <li>L'utilisateur ait un accès administrateur (root)</li> -</ul> - -<h2 id="Une_disponibilité_mondiale">Une disponibilité mondiale</h2> - -<p>Pour que les appareils de référence soient une norme universelle, il faut qu'ils soient disponibles dans le monde entier. Dans le cas contraire, les différentes populations devront faire avec des appareils différents, ce qui aboutira à des comportements différents.</p> - -<h2 id="Un_support_des_fonctionnalités_équivalent_à_celui_des_téléphones_grand_public">Un support des fonctionnalités équivalent à celui des téléphones grand public</h2> - -<p>Il serait inutile de créer un périphérique de référence s'il ne supportait pas les mêmes technologies, fonctionnalités et applications web que les appareils grand public que vous voulez voir distribués avec Firefox OS.</p> - -<p>Ces fonctionnalités sont représentées par :</p> - -<ul> - <li>AGPS/autre matériel de géolocalisation associé</li> - <li>Boussole/gyroscope/accéléromètre</li> - <li>Caméra(s), permettant la prise d'images et de vidéos</li> - <li>Vibreur matériel</li> - <li>Stockage sur carte SD</li> - <li>Sonneries</li> - <li>Boutons physiques appropriés</li> - <li>Connectivité 3G ou mieux</li> -</ul> - -<h2 id="Des_batteries_de_remplacement_disponibles">Des batteries de remplacement disponibles</h2> - -<p>Les batteries de remplacement peuvent être très difficiles à trouver en fonction des appareils et peuvent rendre inutiles des appareils qui pourraient encore fonctionner. Il est ainsi souhaitable de rendre disponibles des batteries de remplacement dès que possible.</p> - -<h2 id="Des_choix_de_langues_faciles_à_faire">Des choix de langues faciles à faire</h2> - -<p>Ces appareils étant distribués dans le monde entier, il est important de rendre disponibles des versions traduites pour le plus de langues possible, en prenant en compte la disponibilité des ressources et les marchés locaux les plus populaires.</p> - -<p>La solution préférable est de faire des versions de Gaia localisées ou des packs de langues qui peuvent être flashés sur l'appareil séparément. Mozilla travaille à une solution pour rendre leur création et leur installation le plus simple possible.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/cherry_mobile_ace/index.html b/files/fr/archive/b2g_os/phone_guide/cherry_mobile_ace/index.html deleted file mode 100644 index 5f56a4de26..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/cherry_mobile_ace/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Cherry Mobile Ace -slug: Archive/B2G_OS/Phone_guide/Cherry_Mobile_Ace -tags: - - Ace - - Cherry Mobile - - Firefox OS - - Mozilla - - Téléphone - - tarako - - utilisateur -translation_of: Archive/B2G_OS/Phone_guide/Cherry_Mobile_Ace ---- -<p><img alt="" src="http://www.cherrymobile.com.ph/sites/default/files/imagecache/jcarousel_preview/content/phones/Ace/images/ACE_black_front.png" style="float: right;"></p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<h3 id="Logiciel">Logiciel</h3> - -<ul> - <li><strong>OS :</strong> FirefoxOS 1.3T</li> - <li><strong>Version Gecko :</strong> 28.1</li> - <li><strong>Apps intégrées :</strong> Agenda, Photo, Horloge, Courriel, Gestionnaire de fichiers, FM, Galerie, Marketplace, Musique, Radio, Paramètres, Suivi conso, Vidéo.</li> - <li><strong>Apps du fabricant :</strong> Cherry Fun Club, eWarranty.</li> -</ul> - -<h3 id="Matériel">Matériel</h3> - -<ul> - <li><strong>Chipset :</strong> Spreadtrum SC6821 - - <ul> - <li><strong>CPU :</strong> ARM Cortex-A5 - - <ul> - <li><strong>Coeurs :</strong> 1</li> - <li><strong>Fréquence :</strong> 1Ghz</li> - </ul> - </li> - <li><strong>GPU :</strong> ARM Mali-400</li> - </ul> - </li> - <li><strong>Mémoire :</strong> 128 Mo</li> - <li><strong>Stockage interne :</strong> 256 Mo - <ul> - <li>72,8 Mo disponibles pour les applications</li> - <li>8,9 Mo disponibles pour les données multimédia</li> - </ul> - </li> - <li><strong>Stockage externe :</strong> Carte MicroSD jusqu'à 32 Go</li> - <li><strong>Écran :</strong> - <ul> - <li><strong>Taille :</strong> 3,5 pouces</li> - <li><strong>Technologie :</strong> TFT, Capacitif</li> - <li><strong>Résolution :</strong> 320x480 pixels HVGA</li> - <li><strong>Densité de pixels :</strong> 165 PPP</li> - <li><strong>Couleur :</strong> Oui</li> - </ul> - </li> - <li><strong>Photo :</strong> - <ul> - <li><strong>Arrière :</strong> 2 MP, focale fixe</li> - <li><strong>Frontale :</strong> Aucune</li> - </ul> - </li> - <li><strong>Batterie :</strong> - <ul> - <li><strong>Tension :</strong> 3,7V</li> - <li><strong>Capacité :</strong> 1100mAh/4.,7Wh</li> - <li><strong>Amovible:</strong> Oui</li> - <li><strong>Modèle :</strong> CM-8P</li> - <li><strong>S/N:</strong> CM1410097462</li> - </ul> - </li> - <li><strong>Dimensions :</strong> 115 x 62,3 x 12,2 mm</li> - <li><strong>Poids :</strong> Env. 108g</li> - <li><strong>Audio :</strong> Écouteurs, haut-parleur, jack 3,5mm</li> - <li><strong>USB :</strong> Micro USB, USB 2.0</li> - <li><strong>SIM :</strong> Double SIM</li> - <li><strong>WLAN :</strong> - <ul> - <li><strong>Normes :</strong> 802.11b/g/n</li> - <li><strong>Securité :</strong> WEP, WPA-PSK, WPA-EAP</li> - </ul> - </li> - <li><strong>Bluetooth :</strong>4.0</li> - <li><strong>Réseau :</strong> GPRS, EDGE, WAP, MMS</li> - <li><strong>Radio FM :</strong> Oui</li> - <li><strong>GPS :</strong> Oui</li> - <li><strong>Capteurs :</strong> Accéléromètre</li> -</ul> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le Cherry Mobile Ace est disponible dans les commerces de détail locaux et sur les sites de commerce en ligne.</p> - -<h3 id="Disponibilité">Disponibilité</h3> - -<ul> - <li>Phillippines</li> -</ul> - -<h3 id="Coloris_disponibles">Coloris disponibles</h3> - -<ul> - <li>Noir</li> - <li>Blanc</li> -</ul> - -<h2 id="Mises_à_jour_du_logiciel">Mises à jour du logiciel</h2> - -<p>L'image système de l'appareil est verrouillée et seules les mises à jour OTA permettent donc de l'actualiser.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.cherrymobile.com.ph/products/smart-social/ace">Cherry Mobile Ace</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/fairphone/index.html b/files/fr/archive/b2g_os/phone_guide/fairphone/index.html deleted file mode 100644 index 7d67765df2..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/fairphone/index.html +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Fairphone -slug: Archive/B2G_OS/Phone_guide/Fairphone -tags: - - B2G - - Commerce équitable - - Fairphone - - Firefox OS - - Gaia - - Guide - - Terminaux - - Téléphone -translation_of: Archive/B2G_OS/Phone_guide/Fairphone ---- -<div class="warning"> -<p><strong>Attention</strong>: Cet appareil ne fonctionne PAS encore avec Firefox OS. Cette page a pour but de regrouper les informations pour coordonner le travail de portage.</p> -</div> - -<p class="summary">Le <a class="tgwf_green" href="https://www.fairphone.com/fairphone/">Fairphone</a> est un téléphone équitable visant une création, une production, une distribution, une réparation et un recyclage justes et respectueux de l'homme et de l'environnement. Les appareils ne sont pas complétement libres matériellement, mais ils visent l'idéal de redonner du contrôle sur le matériel à l'utilisateur.</p> - -<h2 id="Informations_sur_les_sorties_des_appareils">Informations sur les sorties des appareils</h2> - -<p><a class="tgwf_green" href="https://www.fairphone.com/fairphone/">Fairphone</a> a mis à disposition deux appareils jusqu'à présent — le Fairphone v1<em> FP1</em> (première édition) est sorti le 30 décembre 2013, et <em> le FP1U</em> (deuxième vague de vente) le 22 Juillet 2014. Les téléphones version 1 ne sont actuellement plus vendus. Le Fairphone v2 est sorti le 16 Juillet 2015 et peut être commandé sur <a class="tgwf_green" href="https://www.fairphone.com/fairphone/">Fairphone</a>.</p> - -<table class="standard-table" style="width: 100%;"> - <thead> - <tr> - <th scope="col">Fairphone v1</th> - <th scope="col">Fairphone v2</th> - </tr> - </thead> - <tbody> - <tr> - <td style="width: 50%;"><img alt="Une image du Fairphone v1, montrant l'écran de verrouillage et le dos du téléphone. Crédit : Fairphone. CC BY-NC-SA." src="https://mdn.mozillademos.org/files/10253/FairPhone-v1-Screen-2.jpg" style="float: left; height: 376px; margin-bottom: 20px; margin-right: 20px; width: 100%;"></td> - <td style="width: 50%;"><img alt="Fairphone 2 Black Matte" id="big-image" src="http://shop.fairphone.com/media/catalog/product/cache/2/image/445x/602f0fa2c1f0d1ba5e241f914e856ff9/f/r/front-and-back.png" style="height: 100px; width: 100%;" title="Fairphone 2 Black Matte"></td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note</strong>: Vous pouvez suivre les nouveautés sur <a class="tgwf_green" href="https://www.fairphone.com/blog">le blog Fairphone</a>, et jeter un œil à <a class="tgwf_green" href="http://www.fairphone.com/2014/11/04/next-chapter-in-fairphones-strategy-outlook-for-2015/">la stratégie</a> et <a class="tgwf_green" href="https://www.fairphone.com/2015/02/12/our-approach-to-developing-the-next-fairphone/">l'approche</a> de Fairphone.</p> -</div> - -<h2 id="Porter_Firefox_OS_sur_les_appareils_Fairphone">Porter Firefox OS sur les appareils Fairphone</h2> - -<p>Ce n'est pas encore achevé mais le travail est en cours.</p> - -<h3 id="Problèmes_actuels">Problèmes actuels</h3> - -<p>L'Android personnalisé utilisé par le <strong>Fairphone v1</strong> <a class="tgwf_green" href="https://www.fairphone.com/2014/12/09/our-approach-to-software-and-ongoing-support-for-the-first-fairphones/">ne peut pas être mis à jour</a> car le fabricant du chipset refuse de mettre à disposition les mises à jour de driver pour le modem ou d'en ouvrir le code source.</p> - -<p>Au Mobile World Congress 2015, Fairphone a fait un appel pour un possible système d'exploitation alternatif disponible pour le Fairphone v2 à venir. En dehors de ces discussions, un travail de portage de Firefox OS a débuté. Un tel portage serait un moyen de permettre d'offrir une plus grande durabilité au Fairphone V1, et montrerait l'exemple pour que cela n'arrive pas aux futures générations de téléphones. Une collaboration de Mozilla avec principaux fabricants de puces permettrait aussi de faire évoluer les mentalités ou d'éviter ce type de problèmes.</p> - -<p>Le <strong>Fairphone v2</strong> est orienté <a class="tgwf_green" href="https://www.fairphone.com/2015/09/23/opening-up-fairphone-to-the-community-open-source-fairphone-2/">open source</a> et les contributions de la communauté au Fairphone OS sont encouragées.</p> - -<h3 id="Évolution_et_solution">Évolution et solution</h3> - -<p>Le projet de port vient juste de commencer (phase de démarrage). Nous espérons pouvoir commencer rapidement — revenez sur cette page pour plus d'informations.</p> - -<h3 id="Contribuer">Contribuer</h3> - -<p>Si vous souhaitez en savoir plus ou contribuer au port, les liens suivants vous mèneront à bon port.</p> - -<h4 id="Outils_du_projet">Outils du projet</h4> - -<ul> - <li><a class="tgwf_grey" href="https://wiki.mozilla.org/FirefoxOS/Fairphone">Porting project management on WikiMo</a>: Ressources essentielles pour suivre l'avancement du port de Firefox OS pour le Fairphone.</li> - <li><a class="tgwf_grey" href="https://bugzilla.mozilla.org/show_bug.cgi?id=1139642">Bug 1139642 sur Bugzilla</a>: Tout bogue directement lié au port de Firefox OS au Fairphone sera marqué comme bloquant ce méta-bogue.</li> - <li><a class="tgwf_grey" href="http://code.fairphone.com/">The complete build environment for Fairphone OS on Fairphone 2</a>: Le code source ouvert entier, y compris tous les outils et fichiers binaires qui permettent aux utilisateurs de compiler leur propre Fairphone OS.</li> - <li><a href="http://forum.xda-developers.com/fairphone/help/porting-firefox-os-to-fp1-t2983959">XDA Firefox OS community porting to the Fairphone</a> page de projet d'appareil: Évolution technique du port.</li> -</ul> - -<h4 id="Firefox_OS">Firefox OS</h4> - -<p>Si vous étes un développeur de ports ou si vous souhaitez en savoir plus à propos de Firefox OS:</p> - -<ul> - <li><a href="https://developer.mozilla.org/fr/Firefox_OS/Platform">Plate-forme</a>: Un aperçu de l'architecture de la plateforme de Firefox OS, y compris les composants <a href="/fr/Firefox_OS/Platform/Gaia">Gaia</a>, <a href="/fr/docs/Mozilla/Gecko">Gecko</a> et <a href="/fr/Firefox_OS/Platform/Gonk">Gonk</a>.</li> - <li><a href="/fr/Firefox_OS/Developing_Firefox_OS/Porting">Porting Basics</a>: Un guide de base à propos du port du système d'exploitation à de nouvaux terminaux.</li> - <li><a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a>: Information à propos de la création de sa propre compilation de Firefox OS et son installation sur un appareil.</li> - <li> - <div class="document-head" id="wiki-document-head"> - <p><a href="/fr/Firefox_OS/Developing_Firefox_OS">Développer Firefox OS</a>: Explique comment vous pouvez développer la plateforme de bas niveau.</p> - </div> - </li> -</ul> - -<h4 id="Communauté_de_port_XDA">Communauté de port XDA</h4> - -<p>Si vous êtes un développeru Firefox OS et souhaitez en savoir plus à propos du portage de Firefox OS:</p> - -<ul> - <li>Pour un résumé rapide, lisez cela <a class="tgwf_grey" href="https://dietrich.makes.org/thimble/LTIxMTM3MzIwOTY=/firefox-os-ports-on-xda-developers">summary of the various Firefox OS forums and ports on XDA Developers</a></li> - <li><a class="tgwf_grey" href="http://forum.xda-developers.com/firefox-os/general">XDA Firefox OS community</a></li> - <li><a class="tgwf_grey" href="http://forum.xda-developers.com/fairphone">XDA Fairphone community forum</a></li> - <li><a class="tgwf_grey" href="http://forum.xda-developers.com/wiki/Fairphone">XDA Fairphone wiki page</a></li> - <li><a class="tgwf_grey" href="http://forum.xda-developers.com/showthread.php?t=2362172">XDA Fairphone thread</a></li> -</ul> - -<h2 id="Spécifications_techniques">Spécifications techniques</h2> - -<h3 id="Fairphone_v1">Fairphone v1</h3> - -<p>Vous pouvez trouver une liste détaillée des spécifications sur <a class="tgwf_grey" href="https://fairphone.zendesk.com/hc/en-us/articles/201064718-What-are-the-technical-specifications-of-the-Fairphone-1-">la page des caractéristiques du téléphone Fairphone</a>.</p> - -<h4 id="Réseau">Réseau</h4> - -<ul> - <li><strong>2G/GSM</strong>: 850/900/1800/1900MHz</li> - <li><strong>3G/WCDMA</strong>: 900/2100MHz</li> - <li><strong>Wifi:</strong> 2.4GHz 802.11b/g/n</li> - <li><strong>Bluetooth:</strong> v2.1 + EDR / v3.0 + HS</li> - <li><strong>DAS</strong>: Tête: 0.329 W/kg; Corp: 0.693 W/kg</li> -</ul> - -<h4 id="Matériel">Matériel</h4> - -<ul> - <li><strong>Mediatek MT6589M (1st edition) / MT6589 @ 1.2 Ghz (second batch) Chipset</strong>: Processeur quatre coeurs avec lecture et enregistrement de vidéos full hd</li> - <li><strong>Caméra avant</strong>: 1.3 MP pour les photos et les appels vidéos</li> - <li><strong>Caméra arrière</strong>: 8MP AF (stabilisation + capteur d'image) pour les photos et appels vidéos</li> - <li><strong>Écran</strong>: 4.3 pouces qHD IPS (960x540 pixels) (256 ppi); Écran tactile capacitif</li> - <li><strong>Mémoire interne:</strong> 16 GO</li> - <li><strong>RAM</strong>: 1GO</li> - <li><strong>MicroSD</strong>: Jusqu'à 64 GO de mémoire supplémentaire</li> - <li><strong>Sortie jack pour casques</strong>: À partir de nombreux formats</li> - <li><strong>Gélocalisation:</strong> A-GPS, et un Boussole électronique and Gyroscope</li> - <li><strong>Double SIM</strong>: Une SIM: 3G; Une SIM: 2G. Cartes miniSIM au format standard</li> - <li><strong>Port de charge et de données</strong>: Port MicroUSB 2.0 standard, Type B; USB 2.0</li> - <li><strong>Batterie:</strong> 2000mAh (remplaçable)</li> -</ul> - -<h4 id="Logiciel">Logiciel</h4> - -<ul> - <li><strong>Système d'exploitation:</strong> Basé sur Android 4.2 (Jelly Bean), avec une interface Fairphone spéciale</li> - <li><strong>Accés administrateur (root)</strong>:accès superutilisateur immédiat</li> -</ul> - -<h3 id="Fairphone_v2">Fairphone v2</h3> - -<p>Vous pouvez trouver une liste détaillée des spécifications sur la <a class="tgwf_grey" href="https://fairphone.zendesk.com/hc/en-us/articles/203478389-What-technical-specifications-does-the-Fairphone-2-have-">page des caractéristiques Fairphone</a>.</p> - -<h4 id="Réseau_2">Réseau</h4> - -<ul> - <li><strong>2G/GSM</strong>: 850/900/1800/1900MHz</li> - <li><strong>3G/WCDMA</strong>: 900/2100MHz</li> - <li><strong>4G LTE: </strong>900/1900/2100MHz Cat. 4 150 Mbps réception — Cat. 4 50 Mbps Émission</li> - <li><strong>Wifi:</strong> 2.4GHz 802.11b/g/n/ac jusqu'à 433 Mbps</li> - <li><strong>Bluetooth:</strong> v4.0 LE</li> - <li><strong>DAS</strong>: Tête: 0.288 W/kg; Corp: 0.426 W/kg</li> -</ul> - -<h4 id="Matériel_2">Matériel</h4> - -<ul> - <li><strong>Qualcomm MSM8974AB</strong> <strong>@ 2.26 Ghz Chipset</strong>: Processeur quatre coeurs Krait 400 avec processeur graphique Qualcomm Adreno 330 et enregistrement et lecture de vidéos full HD</li> - <li><strong>Caméra avant</strong>: 2 MP Omnivision OV2685 pour les photos et appels vidéos</li> - <li><strong>Caméra arrière</strong>: 8MP AF Omnivision OV8865 (stabilisation + capteur d'image) pour les photos et appels vidéos</li> - <li><strong>Écran</strong>: 5 pouces Full HD (Verre Gorille 3 — épais de 0.7mm) avec affichage à cristaux liquides (LCD) TFT/IPS (446 ppi); Écran tactile capacitif</li> - <li><strong>Stockage interne:</strong> 32 GO eMMC5</li> - <li><strong>RAM: </strong>2GO LPDDR3</li> - <li><strong>MicroSD</strong>: SDHC, SDXC, UHS jusqu'à 64 GB de mémoire supplémentaire</li> - <li><strong>Sortie jack pour casques</strong>: À partir de nombreux formats; standard CTIA</li> - <li><strong>Gélocalisation:</strong> A-GPS, boussole électronique and Gyroscope</li> - <li><strong>Double SIM</strong>: Double SIM Micro-SIM (3FF), Double-Veille (DSDS)</li> - <li><strong>Port de charge et de données</strong>: MicroUSB 2.0 standard avec OTG supporté</li> - <li><strong>Batterie:</strong> 2420mAh (remplaçable)</li> -</ul> - -<h4 id="Logiciel_2">Logiciel</h4> - -<ul> - <li><strong>Système d'exploitation: </strong>Basé sur Android 5.1 (Lollipop), avec une interface Fairphone spéciale</li> - <li><strong>Accés administrateur</strong>: Non</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a class="tgwf_green" href="https://www.fairphone.com/roadmap/">Fairphone roadmap</a></li> - <li>Guides de réparation sur <a class="tgwf_grey" href="https://www.ifixit.com/Device/Fairphone">iFixit</a> et le site internet de <a class="tgwf_green" href="https://www.fairphone.com/support">support Fairphone</a></li> - <li><a class="tgwf_grey" href="https://autonome.wordpress.com/2013/01/15/firefox-os-devices-and-dark-matter/">Firefox OS porting list to other devices</a> — inspiration potentielle pour transposer</li> - <li><a href="/en-US/docs/Mozilla/Firefox_OS/Phone_guide/Orange_Klif">Page MDN du Orange Klif</a> — Premier téléphone Firefox OS qui à la même puce MediaTech que le Fairphone v1</li> - <li><a class="tgwf_grey" href="https://github.com/Kwamecorp/Fairphone">Fairphone v1 OS</a> code source sur la page Github du <a class="tgwf_grey" href="http://www.kwamecorp.com/">kwamecorp</a></li> - <li> - <p><a class="tgwf_grey" href="https://fairphone.zendesk.com/hc/en-us/articles/201576803-Fairphone-FP1-Source-Code-Packages">Paquets de code source du Fairphone</a> on the Fairphone website</p> - </li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/firefox_os_device_features/index.html b/files/fr/archive/b2g_os/phone_guide/firefox_os_device_features/index.html deleted file mode 100644 index 0b15441a7e..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/firefox_os_device_features/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Caractéristiques des appareils Firefox OS -slug: Archive/B2G_OS/Phone_guide/Firefox_OS_device_features -tags: - - Boutons et contrôles - - Conditions requises - - Firefox OS - - Hardware -translation_of: Archive/B2G_OS/Phone_guide/Firefox_OS_device_features ---- -<h2 id="Boutons_et_commandes">Boutons et commandes</h2> - -<p>Un appareil Firefox OS classique possède un certain nombre de boutons physiques:</p> - -<dl> - <dt>Bouton Home</dt> - <dd>Ce bouton est généralement centré sous l'écran. Appuyer dessus permet de revenir au lanceur d'applications. En restant appuyé dessus on ouvre la vue des différentes applications en cours. Un geste vers le haut permet de fermer l'application.</dd> - <dt>La barre de contrôle du volume</dt> - <dd>La barre de contrôle du volume est située sur le côté gauche; appuyer sur la moitié haute augmente le volume; appuyer sur la partie basse diminue le volume.</dd> - <dt>Bouton power</dt> - <dd>Le bouton power est situé en haut à droite de l'appareil.</dd> -</dl> - -<h2 id="Caractéristiques_matérielles_minimales_requises">Caractéristiques matérielles minimales requises</h2> - -<p>En général, les appareils mobiles basés sur ARM sont assez puissants pour supporter Firefox OS. Cette section présente les caractéristiques minimales requises ainsi que les caractéristiques minimales recommandées des smartphones fonctionnant sous Firefox OS.</p> - -<table> - <thead> - <tr> - <th scope="col">Composant</th> - <th scope="col">Minimum</th> - <th scope="col">Recommandé</th> - </tr> - </thead> - <tbody> - <tr> - <th scope="row">CPU</th> - <td>ARMv6</td> - <td>Cortex classe A5 ou mieux<br> - ARMv7a avec NEON</td> - </tr> - <tr> - <th scope="row">GPU</th> - <td>—</td> - <td>Adreno classe 200 ou mieux</td> - </tr> - <tr> - <th scope="row">RAM</th> - <td>128 MB</td> - <td>512 MB</td> - </tr> - <tr> - <th scope="row">Connectivité</th> - <td>—</td> - <td>Wi-Fi<br> - 3G</td> - </tr> - <tr> - <th scope="row">Capteurs</th> - <td>—</td> - <td>Accéléromètre<br> - De proximité<br> - De luminosité<br> - A-GPS</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note</strong>: Pour une bonne expérience utilisateur, il est recommandé de choisir un appareil offrant des couleurs<span class="short_text" id="result_box" lang="fr"> uniformes (implémentées par le pilote graphique) et intégrant le support des écouteurs pour activer/désactiver le mode silencieux ou encore pour lancer/stopper les médias. Ces fonctionnalités sont classiques sur les smartphones modernes.</span></p> -</div> - -<dl> - <dt> </dt> -</dl> diff --git a/files/fr/archive/b2g_os/phone_guide/flame/configuration/index.html b/files/fr/archive/b2g_os/phone_guide/flame/configuration/index.html deleted file mode 100644 index f0dd4ef786..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/flame/configuration/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: Configuration initiale -slug: Archive/B2G_OS/Phone_guide/Flame/configuration -tags: - - B2G - - Firefox OS - - Flame - - Téléphone Développeur - - Téléphone Référence -translation_of: Archive/B2G_OS/Phone_guide/Flame/Initial_setup ---- -<div class="summary"> -<p>Après vous être procuré un téléphone Flame, vous devez suivre des étapes de configuration afin qu'il puisse communiquer correctement avec votre ordinateur et votre système d'exploitation. Ces étapes sont nécessaires pour pouvoir mettre à jour votre téléphone, le déboguer ou pousser des applications en cours de développement avec nos outils.</p> -</div> - -<h2 id="Pour_tous_systèmes_d'exploitation">Pour tous systèmes d'exploitation</h2> - -<p>Vous devez installer les outils ADB et Fastboot sur votre ordinateur. Ces applications permettent notamment d'interagir avec votre téléphone lorsque ceux-ci sont connectés par USB. Ce sont elles qui vous permettront de "flasher" votre téléphone dans une version de Firefox OS, le rétablir si il est "briqué", pousser des applications, etc...</p> - -<div class="note"> -<p><strong>Note </strong>: Si vous êtes sous ubuntu ou debian, vous pouvez installer simplement ces applications avec la commande <code>sudo apt-get install android-tools-adb android-tools-fastboot</code>.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Si vous êtes sous Mac OS, vous pouvez installer ADB et Fastboot en utilisant Homebrew sur la ligne de commande. Voir <a href="/fr/Firefox_OS/deboguer/Installing_ADB">Installer et utiliser ADB</a>.</p> -</div> - -<p>ADB et Fastboot sont disponibles sur <a class="external external-icon" href="http://developer.android.com/sdk/index.html" title="Android Developer Tookit">Android Developer Toolkit</a>:</p> - -<ol> - <li>Rendez-vous sur le site</li> - <li>Cliquez sur <em>Download Eclipse ADT</em> button.</li> - <li>Acceptez le contrat d'utilisation après l'avoir lu.</li> - <li>Sélectionnez la version 32-bits ou 64-bit suivant votre système d'exploitation courant (si vous ne savez pas laquelle prendre, utilisez la version 32-bit).</li> - <li>Cliquez sur le bouton <em>Download Eclipse ADT with the Android SDK...</em>.</li> - <li>Après téléchargement du fichier dézippez le dans le répertoire de votre choix.</li> - <li>Le nom du dossier étant assez compliqué, vous pouvez le renommer le dossier en <em>adt </em>si vous le souhaitez.</li> -</ol> - -<p>ADB est un outil qui fonctione uniquement en ligne de commande. Ouvrez une invite de ligne de commande ou un terminal de votre système et rendez-vous dans le dossier que vous venez de dézipper puis dans <code>adt/sdk/platform-tools</code> et lancez la commande <code>adb</code>. Vous devriez voir apparaitre une liste d'informations en réponse. Exécuter la commande <code>adb devices</code> devrait retourner la liste des appareils reliés à votre ordinateur (la liste sera vide si votre téléphone n'est pas connecté.</p> - -<p>Afin que l'ensemble des outils fonctionnent, vous devez ajouter les outils ADB à la variable système <em>PATH</em>. Gràce à ça, la commande <code>adb </code>sera exécutable depuis n'importe quel dossier.</p> - -<p>Pour faire cela sous Windows 8 (pour Windows 7, ce sera identique mais le nom des menus peut différer) :</p> - -<ul> - <li>Effectuez un clic droit sur le bouton Windows qui est en bas à gauche de votre écran et sélectionnez button in the bottom left and select <em>Panneau de configuration</em> > <em>Système et sécurité</em> > <em>Système</em> > <em>Paramètres système avancés</em> > <em>Variables d'environnement</em>.</li> - <li>Dans les <em>variables système</em>, trouvez la variable appelée <em>Path</em>, sélectionnez là et cliquez sur <em>Editer...</em></li> - <li>Dans le champ texte <em>Valeur</em>, assurez-vous de vous positionner à la fin du texte (il peut être particulièrement long) et tapez un point-virgule (;) suivi par le chemin du dossier des outils ADB. Cela devrait ressembler à ça si vous avez laissé le dossier <em>adt</em> sur le bureau : <em>C:\Users\[votre nom d'utilisateur]\Desktop\adt\sdk\platform-tools</em>.<br> - <br> - Si votre nom d'utilisateur est <em>pierredupond</em> vous ajouterez à la fin ;<em>C:\Users\pierredupond\Desktop\adt\sdk\platform-tools</em>, ou pour ceux qui auraient une version datant d'aout 2016 du SDK sous windows 8.1, devraient le trouver à C:\Users\<em>[YOUR USER NAME]</em>\AppData\Local\Android\sdk\platform-tools (si ce n'est pas le cas faire la mise à jour depuis le SDK et retourner voir).</li> - <li>Appuyez sur <em>OK</em> sur l'ensemble des fenêtres ouvertes pour valider les modifications.</li> - <li>Fermez la ligne de commande précédemment ouverte et ouvrez en une nouvelle. Tapez ensuite directement <code>adb devices</code>. Si la réponse est <code>List of devices attached</code>, cela signifie que vous avez bien configuré les outils ADB. Rendez-vous maintenant à la section <a href="#extra_steps_windows">étapes supplémentaires pour windows</a>.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Pour ouvrir une ligne de commande, effectuez un clic droit sur le bouton windows en bas à gauche de votre écran et sélectionner Ligne de commande.</p> -</div> - -<p>Sous Mac/Linux:</p> - -<ul> - <li>Ouvrez votre répertoire personnel et éditez le fichier nommé<code> .bash_profile</code> <code>ou .bashrc</code> file avec un éditeur de texte simple comme VIM, Text Wrangler ou Sublime Text (n'utilisez pas d'éditeur de texte avancé comme Word ou Writer).</li> - <li>Ajoutez une nouvelle ligne à la fin du fichier qui précisera le chemin du dossier adt : - <ul> - <li>Mac : <code>PATH=/Users/<em>[votre nom d'utilisateur]</em>/Desktop/adt/sdk/platform-tools:$PATH</code></li> - <li>Linux : <code>PATH=/home/<em>[votre nom d'utilisateur]</em>/Desktop/adt/sdk/platform-tools:$PATH</code></li> - </ul> - </li> - <li>Sauvegardez et fermez le fichier.</li> - <li>Redémarrez un nouveau terminal et testez la configuration en tapant la commande <code>adb devices</code>. Si la commande répond <code>List of devices attached</code>, vous avez correctement configuré les outils ADB.</li> -</ul> - -<div class="note"> -<p>Note : sous Mac OS, si vous ne voyez pas les fichiers cachés, ouvrez un terminal et exécutez la commande suivante : <code>defaults write com.apple.finder AppleShowAllFiles YES</code></p> -</div> - -<h2 id="Enable_remote_debugging">Enable remote debugging</h2> - -<p>Assurez-vous que le débogage est activé sur votre Flame, en utilisant l'option <em>Débogage distant/Dégogage USB</em> de l'appareil <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">Paramètres développeurs</a> (L'option est nommée différemment, selon que vous ayez Firefox 1.3 et inférieur, ou Firefox 1.4+ installé).</p> - -<h2 id="Étapes_supplémentaires_pour_Linux">Étapes supplémentaires pour Linux</h2> - -<p>Suivant la distribution que vous utilisez, vous devrez peut-être ajouter une nouvelle règle <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Pour_Linux_.3A_configurer_la_r.C3.A8gle_udev_li.C3.A9e_au_t.C3.A9l.C3.A9phone">udev</a> pour votre téléphone.</p> - -<p>Afin de déterminer le <em>vendor ID</em> de votre téléphone, connectez-le via USB et exécutez la commande <code>lsusb</code> qui listera l'ensemble de vos périphériques USB. Trouvez votre téléphone dans la liste et notez les quatre derniers chiffres qui suivent le préfixe "ID". Un identifiant de Flame est habituellement <code>05c6</code>, donc la règle UDEV à ajouter serait :</p> - -<pre>SUBSYSTEM=="usb", ATTRS{idVendor}=="05c6", MODE="0666" -</pre> - -<p>Si votre téléphone est listé avec un autre identifiant, utilisez le à la place. Par exemple :</p> - -<pre>SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", MODE="0666" -</pre> - -<p>Après modification, exécutez la commande <code>udevadm control --reload-rules</code> pour recharger la configuration, débranchez puis rebranchez votre téléphone avant de continuer.</p> - -<h2 id="Étapes_supplémentaires_pour_Windows">Étapes supplémentaires pour Windows</h2> - -<p>Pour accéder à un téléphone Flame avec les outils <a href="/fr/Firefox_OS/deboguer/Installing_ADB">ADB</a> ainsi qu'avec les outils de développement de Mozilla comme <a href="/fr/Firefox_OS/Using_the_App_Manager">App Manager</a>/<a href="/fr/docs/Outils/WebIDE">WebIDE </a>, un driver USB est demandé. La suite de ce paragraphe va vous détailler les étapes d'installation de celui-ci.</p> - -<h3 id="Télécharger_le_driver">Télécharger le driver</h3> - -<p><a href="http://cds.w5v8t3u9.hwcdn.net/Alcatel_USB_Driver_Q_4.0.0_2013_11_11_noinstall.zip">Téléchargez le driver Windows</a>. Extrayez le fichier ZIP sur dans un répertoire.</p> - -<div class="note"> -<p><strong>Note</strong>: L'outils <a href="/fr/Firefox_OS/deboguer/Installing_ADB">ADB</a> doit être installé avant le driver : veuillez suivre les instructions fournies plus haut si vous ne l'avez pas encore fait.</p> -</div> - -<h3 id="Installer_le_driver_USB">Installer le driver USB</h3> - -<p>Connectez votre téléphone Flame à votre ordinateur avec un câble USB.</p> - -<p>Pour installer le driver, ouvrer le répertoire <code>Alcatel_USB_Driver_Q_4.0.0_2013_11_11_noinstall</code> créé après extraction et exécutez le fichier <code>DriverInstaller.exe</code>. Vous pouvez recevoir un message d'avertissement de la part de Windows indiquant qu'il ne connait pas l'éditeur de l'application. Si c'est le cas, cliquez sur <em>oui</em> pour continuer.</p> - -<p><img alt="Simple dialog box showing a picture of a phone along with install and uninstall buttons." src="https://mdn.mozillademos.org/files/8079/driver-install.png" style="display: block; height: 523px; margin: 0px auto; width: 358px;"></p> - -<p>Cliquez sur le bouton <em>Install</em> pour installer le driver.</p> - -<p>Après installation, vous pouvez contrôler que tout fonctionne correctement en ouvrant un terminal et en exécutant la commande <code>adb devices</code>.</p> - -<p>Assurez-vous que le débogage à distance est activé sur votre téléphone en activant l'option <em>Remote debugging/Debugging via USB</em> dans les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeur </a>(suivant la version que vous utilisez le nom de l'option et sa localisation dans les menus peut légèrement différer).</p> - -<p>Le résultat de la commande doit ressembler à ça :</p> - -<pre>List of devices attached -3561d02a device</pre> - -<p>Si votre téléphone n'apparait pas, contrôler le gestionnaire de périphériques de Windows. Le Flame devrait apparaitre sous le nom "ACER ADB Interface". Vous pouvez confirmer sa présence en débranchant le câble USB : il devrait alors disparaitre de liste des périphériques. Désinstallez le driver en effectuant un clic droit sur "ACER ADB Interface" et cliquez sur <em>désinstaller</em>. Assurez-vous de bien cocher la case pour désinstaller le driver. Relancez l'installation. Il peut être utile de désactiver la mise en veille de votre téléphone durant l'installation : Windows peut vouloir utiliser un driver par défaut quand l'écran est éteint.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/flame/index.html b/files/fr/archive/b2g_os/phone_guide/flame/index.html deleted file mode 100644 index 5fb73d826f..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/flame/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Flame -slug: Archive/B2G_OS/Phone_guide/Flame -tags: - - B2G - - Firefox OS - - Flame - - Téléphone Développeur - - appareil de référence -translation_of: Archive/B2G_OS/Phone_guide/Flame ---- -<div class="note"> -<p><strong>Informations sur les mises à jour </strong>: Nous vous recommandons vivement de rejoindre la liste de diffusion suivante pour vous tenir au courant de toutes les nouvautés sur les mises à jour et de toutes les informations concernant le Flame : <a href="https://mail.mozilla.org/listinfo/flamenews">https://mail.mozilla.org/listinfo/flamenews</a></p> -</div> - -<div> -<p><img alt="Une image du Flame, présentant l’écran d’accueil de Firefox OS avec divers icônes d'applications." src="https://mdn.mozillademos.org/files/8373/flame-dev-hud.png" style="float: left; margin-bottom: 20px; margin-right: 50px; width: 25%;"></p> - -<h2 id="Disponible_sur_commande" style="text-indent: 100%; white-space: nowrap; overflow: hidden; margin: 0; height: 0;">Disponible sur commande</h2> - -<p><span class="seoSummary">Le téléphone de référence pour les développeurs Flame est une étape importante dans la sortie des appareils Firefox OS. Les caractéristiques matérielles du Flame proposent un ensemble représentatif des spécifications – dont un écran FWVGA et un processeur double coeur – pour aider les développeurs à construire du contenu et des expériences de qualité. Une plateforme matérielle unique est également un atout pour les testeurs, facilitant les tests et permettant de résoudre les problèmes spécifiques aux logiciels sans avoir à se soucier de bogues spécifiques aux modèles d'appareils, etc.</span></p> -</div> - -<p>Si vous avez votre téléphone en main et que vous voulez commencer à vous amuser avec, développer et distribuer des applications, ou contribuer à la plateforme Firefox, les liens suivants vous amèneront là où vous avez besoin d'aller :</p> - -<ul> - <li><a href="/en-US/Firefox_OS">Zone Firefox OS</a> : Pour créer vos propres compilations de Firefox OS et contribuer aux projets B2G et Gaia.</li> - <li><a href="/en-US/Apps">Zone Centre d'Applications </a>: Pour construire des applications web ouvertes (<em>open web apps</em>) compatibles avec Firefox OS.</li> - <li><a href="/en-US/Marketplace">Zone Boutique Marketplace</a> : Pour de l'information sur la publication et la distribution des applications.</li> - <li><a href="https://marketplace.firefox.com/">Boutique Firefox Marketplace</a> : La meilleure source pour trouver et publier de nouvelles applications Firefox OS.</li> -</ul> - -<p>Si vous souhaitez en savoir plus sur la mise à jour du système d'exploitation, sa récupération, l'envoi d'applications ou les caractéristiques du téléphone, vous trouverez les informations dont vous avez besoin ci-dessous.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le Flame n'est malheureusement plus disponible à la vente. Il existe toujours d'autres opportunités pour les développeurs d'obtenir un appareil gratuitement, y compris lors d'une prochaine session du programme Foxtrot. Si vous avez des questions sur les manières d'obtenir un appareil, vous pouvez contacter Asa Dotzler ou Marcia Knous sur IRC.</p> - -<h2 id="Caractéristiques_réseau_et_matérielles">Caractéristiques réseau et matérielles</h2> - -<p>Vous pouvez trouver plus de fonctionnalités matérielles listées sur notre <a href="/en-US/Firefox_OS/Developer_phone_guide/Phone_specs">Page de caractéristiques des téléphones et appareils</a>.</p> - -<h3 id="Réseau">Réseau</h3> - -<ul> - <li>Wifi 802.11b/g/n</li> - <li>GSM 850/900/1800/1900MHz</li> - <li>UMTS 850/900/1900/2100MHz</li> -</ul> - -<h3 id="Matériel">Matériel</h3> - -<ul> - <li>NFC</li> - <li>Bluetooth 3.0</li> - <li>Accéléromètre</li> - <li>Radio FM</li> - <li>Capteur de proximité</li> - <li>GPS W / A-GPS</li> - <li>Capteur de lumière ambiante</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Flame/configuration">Configuration initiale </a>: Étapes à suivre pour configurer votre ordinateur afin qu'il puisse communiquer avec votre Flame.</li> - <li><a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Flame/mettre_a_jour_Flame">Mettre à jour votre Flame</a> : Comment mettre à jour ou changer la version de Firefox OS sur votre Flame, installer des applilcations, résoudre les problèmes et le tester.</li> - <li><a href="https://hacks.mozilla.org/2014/08/videos-getting-started-with-your-flame-device/">Premiers pas avec votre Flame</a> : <em>HowTos</em> vidéos par Chris Heilmann.</li> - <li><a href="http://mozilla.github.io/flame-on/">Flame On</a> : Page regroupant l'ensemble des propriétaires d'un Flame créée lors du Mozilla Festival 2014.</li> - <li><a href="https://blog.mozilla.org/press/2014/02/developer-momentum-2/">Original annoncement</a> : Communiqué de presse du 23 février 2014.</li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/flame/mettre_a_jour_flame/index.html b/files/fr/archive/b2g_os/phone_guide/flame/mettre_a_jour_flame/index.html deleted file mode 100644 index e3825ba9f9..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/flame/mettre_a_jour_flame/index.html +++ /dev/null @@ -1,353 +0,0 @@ ---- -title: Mettre à jour votre Flame -slug: Archive/B2G_OS/Phone_guide/Flame/mettre_a_jour_Flame -tags: - - Firefox OS - - Flame - - Smartphone développeur - - Téléphone Développeur -translation_of: Archive/B2G_OS/Phone_guide/Flame/Updating_your_Flame ---- -<div class="summary"> -<p>Cet article explique comment mettre à jour la partie logicielle de votre Flame — y compris la mise à jour de Firefox OS et l'ajout de nouvelles applications sur votre téléphone — comment conserver vos données, et d'autres informations utiles. Avant toute chose, vous devriez vous assurer que vous avez suivi les <a href="/fr-FR/Firefox_OS/Phone_guide/Flame/Initial_setup">étapes d'initialisation</a> nécessaires</p> -</div> - -<h2 id="Guide_rapide_pour_mettre_à_jour_Firefox_OS_sur_le_Flame">Guide rapide pour mettre à jour Firefox OS sur le Flame</h2> - -<p>Il y a beaucoup d'informations dans cet article, alors nous avons décidé de vous fournir un guide qui vous permet de maintenir votre Flame à jour. Vous trouverez ci-dessous les informations nécessaires.</p> - -<h3 id="Flashage_vers_la_dernière_image_(2.5)">Flashage vers la dernière image (2.5)</h3> - -<p>Les étapes suivantes doivent être validées avant toute autre chose.</p> - -<div id="magicdomid12"><span class="author-p-18262"><strong>Prérequis</strong>: Assurez vous d'avoir adb et fastboot installés et fonctionnels sur votre système (voir <a href="https://developer.mozilla.org/fr-FR/docs/Mozilla/Firefox_OS/Debugging/Installing_ADB">Installer ADB et Fastboot</a>).</span><br> - </div> - -<ol> - <li id="magicdomid14"><span class="author-p-18262">Télécharger la dernière image —</span><a class="external external-icon" href="http://cds.w5v8t3u9.hwcdn.net/v18D_nightly_v4.zip">Base image v18D_nightly_v4</a> — <span class="author-p-18262">sur votre PC ou Mac.</span></li> - <li id="magicdomid18"><span class="author-p-18262">Sur votre Flame, activer le "remote debugging" dans le menu <em>Settings > Developer</em> et activer le </span><a href="https://developer.mozilla.org/fr-FR/Firefox_OS/Debugging/Developer_settings#Debugging_via_USB">Debugging via USB</a><span class="author-p-18262"> dans le menu Developer.</span></li> - <li id="magicdomid20"><span class="author-p-18262">Connecter votre Flame à votre PC / Mac via un cable USB.</span></li> - <li id="magicdomid22"><span class="author-p-18262">Vérifier la bonne connexion en tapant la commande :</span> - <pre class="brush: bash line-numbers language-bash"><code class="language-bash"><span class="author-p-18262 i">adb devices</span><span class="author-p-18262"> </span><span class="author-p-18262"> </span></code></pre> - </li> -</ol> - -<p>Vous devriez avoir une réponse comme celle-ci:</p> - -<pre class="brush: bash line-numbers language-bash"><code class="language-bash">List of devices attached -94f7ce4c device</code></pre> - -<ul> - <li id="magicdomid22">Si vous ne voyez pas votre Flame (si la ligne n°2 n'apparaît pas), alors débranchez et rebranchez le câble USB et vérifiez que l'option <em>Debugging via USB</em> soit bien activée comme expliqué ci-dessus. Si vous avez un message qui dit que adb n'est pas disponible, alors revenez au prérequis ci-dessus et assurez-vous de bien installer adb et fastboot.</li> - <li id="magicdomid28"><span class="author-p-18262">Extraire l'image zippée et aller dans le répertoire où elle se trouve en tapant par exemple :</span> - <pre class="brush: bash line-numbers language-bash" id="magicdomid31"><code class="language-bash"><span class="author-p-18262 i"><em>cd </em></span><span class="author-p-18262 i url">v18D_nightly_v4</span></code></pre> - </li> - <li id="magicdomid33"><span class="author-p-18262">Lancer le script qui permet de flasher votre Flame en entrant la commande qui correspond à votre système d'exploitation :</span> - <pre class="brush: bash line-numbers language-bash"><code class="language-bash"><span class="author-p-18262"># Windows</span> -<span class="author-p-18262 i"><em>flash.bat</em></span> - -<span class="author-p-18262"># Linux / OSX</span> -<span class="author-p-18262 i"><em>./flash.sh</em></span></code></pre> - </li> -</ul> - -<ol> - <li id="magicdomid33"><strong>Notes :</strong> Si le script ne parvient pas à voir votre Flame, vérifiez que vous avez correctement configuré les <a href="/fr-FR/Firefox_OS/Firefox_OS_build_prerequisites#For_Linux.3A_configure_the_udev_rule_for_your_phone">règles udev</a>. Si le script<code> flash.sh </code>n'existe pas, vous pouvez renommer le fichier <code>flash.bat</code> en <code>flash.sh</code> et l'exécuter.</li> -</ol> - -<div class="note"> -<p>Nota: Vous pouvez vérifier la qualité de l'image téléchargée en tapant la commande ci-dessous :</p> - -<pre class="line-numbers language-html"><code class="language-html">Checksum: SHA512(v18D_nightly_v4.zip)= 9105e29fd39da1ae487b01da4431a803d619d31482147b4383002b8a10268905fd444b108a438395a78d289cfe4e8fba10c3fb6b0d187f3535f027bf90c2391a Build id: 20150527010201</code></pre> -</div> - -<div class="note"> </div> - -<p>A cet instant, vous devez être en présence d'un Flame avec la version 2.5 de Firefox OS et recevoir les mises à jour OTA (Over The Air).</p> - -<div class="note"> -<p><span class="author-p-18262"><strong>Nota</strong>: si vous voulez avoir la dernière version instable pour Flame (qui n'a pas été pleinement testée), aller dans settings -> developer, descendre vers le bas et changer le channel pour nightly-latest. Rebooter le Flame, retourner dans settings -> device info et vérifier s'il y a des MAJ. Vous pouvez obtenir ainsi la dernière version sans "shallow flash". Pour le "shallow flashing" voir plus bas dans cet article.</span></p> -</div> - -<h4 id="Bug_de_reset_de_l'Update_channel">Bug de reset de l'Update channel</h4> - -<p>Comme notifié dans le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1217490" title="FIXED: [Aries] The dogfood/dogfood-latest channel are reset to nightly after latest OTA">bug 1217490</a>, plusieurs testeurs de Firefox OS essayant Firefox OS 2.5 latest OTA updates (sur Flame, mais aussi sur d'autres smartphones) ont constaté que quand ils font une MAJ OTA, leur update channel est réinitialisé à <code>nightly</code>, ce qui implique qu'ils ne vont plus recevoir des MAJ OTA par la suite. Pour éviter le problème, il est conseillé de mettre votre update channel à <code>nightly-latest</code> en utilisant WebIDE. Pour cela :</p> - -<ol> - <li>Brancher votre Flame au PC/Mac via USB (assurez-vous que <em>Debugging via USB</em> est réglé sur <em>ADB and DevTools</em> dans le <a href="https://developer.mozilla.org/fr-FR/docs/Mozilla/Firefox_OS/Debugging/Developer_settings">Developer Settings</a>)</li> - <li>Ouvrir le navigateur Firefox sur votre PC/mac et lancer <a href="https://developer.mozilla.org/fr-FR/docs/Tools/WebIDE">WebIDE</a>.</li> - <li>Connecter WebIDE à votre Flame en le sélectionnant dans le menu <em>USB Devices</em>. Accepter la connexion sur le Flame pour l'activer.</li> - <li>Dans le Menu <em>Sélection de l'environnement en haut à droite de </em>WebIDE UI, sélectionner <em>Paramètres de l'appareil</em>.</li> - <li>Chercher <code>app.update.channel</code> dans la liste et changer la valeur dans la textbox pour <code>nightly-latest</code>.</li> - <li>Chercher <code>app.update.channel.backup</code> et changer la valeur pour <code>nightly-latest</code> si vous voulez restez en Nightly après les MAJ.</li> -</ol> - -<h3 id="Mettre_à_jour_la_partie_logicielle_du_Flame_(Firefox_OS_2.0_pour_plus_récent_voir_plus_haut)">Mettre à jour la partie logicielle du Flame (Firefox OS 2.0, pour plus récent voir plus haut)</h3> - -<p>Il existe deux canaux de diffusion pour les mises à jour de Firefox OS pour le Flame:</p> - -<ul> - <li>Le premier diffuse les versions officielles. Le Flame est livré avec ce système et reçoit des notifications à chaque mise à jour majeure. Par exemple, le Flame sera mis à jour de la version 1.3 à la version 2.0, de celle-ci à la version 2.1, etc.</li> - <li>Le second canal est celui que l'on appelle <em>nightly</em>. Le Flame peut être installé avec une version depuis ce canal et, après installation initiale, recevra quotidiennement des mises à jours en OTA (<em>over the air</em>). Ce canal est plutôt destiné aux développeurs du fait de l'instabilité de cette version.</li> -</ul> - -<h3 id="Images_d'installation">Images d'installation</h3> - -<p>Vous trouverez les images et outils d'installation aux adresses suivantes :</p> - -<h4 id="Dernières_versions">Dernières versions :</h4> - -<ul> - <li>Stable et production : <a href="http://cds.w5v8t3u9.hwcdn.net/v18D.zip">Image v18D.zip</a> : la plus récente archive stable contenant l'image de base de Firefox OS 2.0.</li> - <li>Nightly et développement : <a href="http://cds.w5v8t3u9.hwcdn.net/v18D_nightly_v4.zip">Image v18D_nightly</a> : la plus récente image du canal <em>nightly</em> contenant l'image de base de Firefox OS 2.5.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Vous pouvez connaître l'image utilisée par votre périphérique en utilisant la commande: <code>adb shell getprop ro.bootloader</code></p> -</div> - -<div class="warning"> -<div class="warning"> -<p><strong>Important</strong>: Attention, lorsque vous effectuez une installation complète ou partielle (shallow) à partir de ces images, vous perdez les informations contenues dans votre téléphone. Avant d'effectuer le "flash", vous devriez faire une sauvegarde de vos données personnelles. Vous pourrez ainsi les restaurer après. Rendez-vous à la section "<a id="Sauvegarder et restaurer les données de votre Flame" name="Sauvegarder et restaurer les données de votre Flame">sauvegarder et restaurer les données de votre Flame</a>".</p> -</div> -</div> - -<h4 id="Versions_précédentes">Versions précédentes :</h4> - -<p>Ces versions sont listées ici seulement pour information, vous ne devriez pas les utiliser.</p> - -<ul> - <li><a href="http://cds.w5v8t3u9.hwcdn.net/v188.zip">Image v188.zip</a>: Une ancienne archive contenant l'image de base de Firefox OS 2.0 pour le Flame.</li> - <li><a href="http://cds.w5v8t3u9.hwcdn.net/Flame_2.0_v180_1.zip">Image v180.zip</a>: Une ancienne archive contenant également l'image de base de Firefox OS 2.0.</li> - <li><a href="http://cds.w5v8t3u9.hwcdn.net/v123.zip">Image v123.zip</a>: Une image obsolète basée sur Jellybean d'Android; vous ne devriez pas utiliser celle-ci.</li> -</ul> - -<div class="note"><strong>Note</strong>: Les images de Firefox OS v180 et suivantes sont basées sur Android KK (Kitkat, 4.4); les images basées sur JB (Jellybean, 4.1-4.3) ne sont plus supportées et sont obsolètes. N'utilisez pas de version inférieure à v180.</div> - -<h3 id="Installation_d'une_image_de_base">Installation d'une image de base</h3> - -<p>Pour installer une image de base sur votre périphérique:</p> - -<ol> - <li>Assurez-vous que le débogage à distance soit activé en utilisant la fonction <em>Remote debugging/Debugging via USB</em> dans les menus de <a href="/fr-FR/Firefox_OS/Debugging/Developer_settings">développement</a> (cette option peut avoir un nom différent suivant la version de Firefox OS que vous utilisez actuellement).</li> - <li>Connectez votre téléphone via un câble USB à votre ordinateur. Vérifiez que votre téléphone est reconnu correctement en exécutant la commande <code>adb devices</code> depuis un terminal.</li> - <li>Téléchargez une archive zip référencée ci-dessus et dézippez-la dans un répertoire.</li> - <li>Allez dans le répertoire où vous avez extrait les fichiers et exécutez les commandes suivantes : - <ul> - <li>Sous Windows, placez-vous dans le répertoire depuis la ligne de commande et exécutez le script <code>flash.bat</code> (vous pouvez aussi double-cliquer sur le fichier depuis l'explorateur Windows).<br> - <strong>Notes </strong>: Si le script<code> flash.bat </code>n'existe pas, vous pouvez renommer le fichier <code>flash.sh</code> en <code>flash.bat</code> et l'exécuter. Vérifiez bien que les outils <code>adb</code> et <code>fastboot</code> sont installés et ajoutés à votre variable d'environnement <code>PATH</code>.</li> - <li>Sous Linux / OSX, placez-vous dans le répertoire depuis la ligne de commande et exécutez le script <code>flash.sh</code>.<br> - Attention : il est déconseillé d'exécuter la commande avec <code>sudo</code> car cela est très dangereux de l'utiliser avec des exécutables téléchargés depuis internet.<br> - <strong>Notes :</strong> Si le script ne parvient pas à voir votre Flame, vérifiez que vous avez correctement configuré les <a href="/en-US/Firefox_OS/Firefox_OS_build_prerequisites#For_Linux.3A_configure_the_udev_rule_for_your_phone">règles udev</a>. Si le script<code> flash.sh </code>n'existe pas, vous pouvez renommer le fichier <code>flash.bat</code> en <code>flash.sh</code> et l'exécuter</li> - </ul> - </li> -</ol> - -<div class="note"> -<p><strong>Note</strong>: Si vous rencontrez une erreur "permission denied" ou un erreur "Waiting for device" lorsque vous exécutez, il s'agit probablement d'une erreur provoquée par des droits système manquant. Vous pouvez résoudre ce problème en exécutant la commande suivante <code>chmod +x flash.sh</code> depuis le bon répertoire.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Vous pouvez aussi essayer d'installer vos propres versions de Firefox OS sur votre Flame. Pour cela, rendez vous ici: <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a>.</p> -</div> - -<h3 id="Régler_les_problèmes_de_font">Régler les problèmes de <em>font</em></h3> - -<div class="warning"> -<p><strong>Attention :</strong> cette étape est spécifique à l'image v180</p> -</div> - -<p>Après avoir mis à jour Gecko et Gaia vers le canal <em>nightly </em>avec l'image v180, vous rencontrerez des problèmes car Gecko et Gaïa attendront des <em>fonts</em> qui ne sont pas dans l'image (ce bug a été corrigé avec la version v188). Pour résoudre ce problème, téléchargez notre <a href="https://people.mozilla.org/~mwu/fira-font-update.zip">outil de mise à jour des fonts</a>, dézippez-le et exécutez le script <code>flash.sh</code> fourni.</p> - -<div class="note"> -<p><strong>Note </strong>: Vous pouvez aussi utiliser le script <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/update_system_fonts.sh"><code>update_system_fonts.sh</code></a> qui téléchargera et installera automatiquement les fonts manquantes.</p> -</div> - -<h3 id="Mettre_à_jour_votre_Flame_avec_une_image_du_canal_nightly">Mettre à jour votre Flame avec une image du canal <em>nightly</em></h3> - -<div class="note"> -<p><strong>Note</strong>: Actuellement, les versions Nightly de Firefox OS ne proposent pas de support pour A-GPS ce qui peut poser des soucis de performance avec la fonctionnalité GPS de votre téléphone. Il est prévu que cela soit résolu dans une future version publiée sur ce canal.</p> -</div> - -<div class="warning"> -<p><strong>Important</strong>: Attention, lorsque vous effectuez une installation complète ou partielle (shallow) à partir de ces images, vous perdez les informations contenues dans votre téléphone. Avant d'effectuer le "flash", vous devriez faire une sauvegarde de vos données personnelles. Vous pourrez ainsi les restaurer après. Rendez-vous à la section "<a id="Sauvegarder et restaurer les données de votre Flame" name="Sauvegarder et restaurer les données de votre Flame">sauvegarder et restaurer les données de votre Flame</a>".</p> -</div> - -<ol> - <li>Avant de penser à installer une version <em>Nightly</em>, vous devriez installer la dernière image du canal stable sur votre téléphone afin d'être sûr que tous les prérequis systèmes soient remplis.</li> - <li>Parce que vous allez installer une image complète du système, vous devez activer le débogage à distance depuis votre Flame depuis les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeurs sur Firefox OS</a>.</li> - <li>Sélectionnez l'image que vous voulez installer (en la sélectionnant depuis <a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/">http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/</a>). Vous pouvez aussi utiliser une des images suivantes : - <ul style="margin-left: 40px;"> - <li>Images de « production » (comprenant l'ensemble des langues) - <ul> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central-flame-kk/">Dernière image<em> </em>de la version <em>master</em></a> (2.5)</li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g37_v2_2-flame-kk/">Dernière image de la version 2.2</a></li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g34_v2_1-flame-kk/">Dernière image de la version 2.1</a></li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g32_v2_0-flame-kk/">Dernière image de la version 2.0</a></li> - </ul> - </li> - <li>Versions de développement (comprenant des applications de test et seulement un jeu de pseudo-langues) - <ul> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central-flame-kk-eng/">Dernière image de la version <em>master</em></a> (2.5)</li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g37_v2_2-flame-kk-eng/">Dernière image de la version 2.2</a></li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g34_v2_1-flame-kk-eng/">Dernière image de la version 2.1</a></li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g32_v2_0-flame-kk-eng/">Dernière image de la version 2.0</a></li> - </ul> - </li> - </ul> - </li> - <li>Sélectionnez une version et téléchargez les deux fichiers suivant <code>b2g-XX.XX.en-US.android-arm.tar.gz</code> <code>et gaia.zip</code>. Sauvegardez-les dans un dossier nommé, par exemple, <code>fxos</code>.</li> - <li>Téléchargez le script d'installation <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/shallow_flash.sh">shallow flash</a> et sauvegardez-le dans le même dossier que les deux fichiers précédents. Pour cela, suivez le lien <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/shallow_flash.sh">shallow flash</a>, cliquez sur le bouton <em>Raw</em> et utilisez la fonctionnalité "<em>enregistrer sous</em>" de votre navigateur pour sauvegarder le fichier en le nommant <code>shallow_flash.sh</code>.</li> - <li><strong>Pour les utilisateur Windows:</strong> Téléchargez le script <a href="https://raw.githubusercontent.com/Mozilla-TWQA/B2G-flash-tool/master/shallow_flash.bat">shallow_flash.bat</a> et installez l'outil <a href="https://cygwin.com">Cygwin</a> qui fournit une ligne de commande typée Linux sur votre environnement Windows. Pour cela, téléchargez le fichier d'installation setup*.exe et déposez-le dans le même répertoire que le script shallow_flash.bat . Celui-ci se chargera d'installer correctement Cygwin pour vous.</li> - <li> - <p>Depuis le Terminal, placez-vous dans le répertoire où vous avez sauvegardé vos fichiers et exécutez les commandes suivantes :</p> - - <p><strong>Linux</strong>:</p> - - <pre class="brush: bash">./shallow_flash.sh --gaia=gaia.zip --gecko=b2g-XX.XX.en-US.android-arm.tar.gz -</pre> - - <p><strong>Mac</strong>:</p> - - <pre class="brush: bash">./shallow_flash.sh --gaia gaia.zip --gecko b2g-XX.XX.en-US.android-arm.tar.gz</pre> - - <p><strong>Windows</strong>:</p> - - <p>Double-cliquez sur <code>shallow_flash.bat</code> ou exécutez-le depuis la ligne de commande Windows. Cela aura pour effet de flasher votre téléphone avec <code>gaia.zip</code> et un fichier <code>b2g-XX.XX.en-US.android-arm.tar.gz</code> .</p> - </li> -</ol> - -<div class="note"> -<p><strong>Note</strong>: Si vous rencontrez une erreur "permission denied" ou une erreur "Waiting for device" lorsque vous exécutez l'étape ci-dessus, il s'agit probablement d'une erreur provoquée par des droits système manquants. Vous pouvez résoudre ce problème en exécutant la commande suivante: <code>chmod +x flash.sh</code> depuis le bon répertoire.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: Une installation "shallow flash" met à jour <a href="/en-US/docs/Mozilla/Gecko">Gecko</a>, <a href="/en-US/Firefox_OS/Platform/Gaia">Gaia</a> et seulement quelques données systèmes en opposition à une installation complète qui met à jour Gecko/Gaia mais aussi <a href="/en-US/Firefox_OS/Platform/Gonk">Gonk</a> avec l'ensemble des paramétrages spécifiques à votre téléphone. C'est pour cette raison qu'il est conseillé d'installer une image complète à jour avant d'effectuer une installation "shallow" : de cette manière vous êtes assuré d'avoir une version à jour de Gonk et ses paramètres.</p> -</div> - -<p>Après installation, votre téléphone devrait redémarrer et vous proposer les étapes de paramétrage spécifiques à une nouvelle installation.</p> - -<h4 id="Passer_sur_le_canal_d'installation_nightly">Passer sur le canal d'installation <em>nightly</em></h4> - -<p>Depuis la version 2.2, vous pouvez directement sélectionner le canal de mise à jour depuis les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeurs sur Firefox OS</a>.</p> - -<p>Si ce paramétrage n'est pas disponible, vous pouvez utiliser la "vieille" méthode.</p> - -<ol> - <li>Assurez-vous que le débogage distant par USB soit activé depuis les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeurs sur Firefox OS</a>.</li> - <li>Téléchargez le script <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/change_channel.sh">suivant</a>. Pour cela, suivez le lien, cliquez sur le boutton <em>Raw</em> et utilisez la fonctionnalité "<em>enregistrer sous</em>" de votre navigateur pour sauvegarder le fichier en le nommant <code>change_channel.sh</code>.</li> - <li>Depuis la ligne de commande et le répertoire où vous avez enregistré le script, vous pouvez changer le canal de mise à jour en exécutant la commande suivante :<br> - - <pre class="brush: bash">./change_channel.sh -v nightly</pre> - </li> - <li>Après redémarrage du téléphone, vous pouvez contrôler la présence d'une mise à jour OTA en vous rendant dans les menus <em>Paramètres > Informations > Mises à jour logicielles > check for updates.</em></li> -</ol> - -<div class="note"> -<p><strong>Note:</strong> Vous avez le choix entre de nombreux canaux de mise à jour . Exécutez la commande "<code>./change_channel.sh -h</code>" pour les lister.</p> -</div> - -<h3 id="Mode_Fastboot">Mode Fastboot</h3> - -<p>Si l'installation d'une image échoue sur votre téléphone, votre téléphone peut ne plus fonctionner correctement et démarrer seulement en mode Fastboot. Ce mode de récupération propose peu d'options (<em>Reboot</em>, <em>Update from adb</em>, <em>Wipe data</em>, <em>Wipe cache</em>, and <em>Update from sdcard</em>). Malheureusement, sélectionner l'option <em>Update from adb</em> charge un mode spécifique de l'outil ADB (<code>adb sideload</code>) ne permettant pas d'exécuter les scripts nécessaires à l'installation d'une image correcte.</p> - -<p>Pour forcer un démarrage en mode fastboot utilisable, vous pouvez exécuter les commandes suivantes :</p> - -<ol> - <li> - <p style="margin-bottom: 0cm;">Éteignez votre téléphone (si vous ne pouvez pas l'éteindre, retirez la batterie et remettez-la en place).</p> - </li> - <li>Branchez le téléphone à votre ordinateur via un câble USB.</li> - <li>Démarrez votre téléphone en maintenant les boutons d'allumage et "descendre le volume".</li> -</ol> - -<p>Votre téléphone devrait s'allumer et afficher le texte "FASTBOOT" : cela signifie qu'il attend d'être connecté par USB. Si vous exécutez la commande <code>fastboot devices</code> vous devriez voir votre téléphone. Remarquez que la commande habituelle <code>adb </code>ne verra pas votre téléphone. Depuis ce mode, vous pouvez utiliser les scripts pour installer une image de base comme expliqué plus haut. Comme les scripts utilisent des commandes adb et fastboot, vous devriez voir des messages d'erreur et / ou d'avertissement apparaître mais cela n'empêchera pas l'installation de se dérouler complètement.</p> - -<h3 id="Outil_de_récupération_d'urgence">Outil de récupération d'urgence</h3> - -<p>Si la mise à jour échoue, que votre téléphone est inutilisable et que vous ne pouvez entrer en mode fastboot, vous pouvez utiliser l'outil de récupération d'urgence. Le câble fourni avec le téléphone qui comporte une étiquette rouge “Recovery Cable” et l'outil de récupération "<a href="http://cds.w5v8t3u9.hwcdn.net/Flame%20Rescue%20Tool.zip">Emergency Download Tool</a>", sont nécessaires à cette opération. Contactez le fabriquant (flameservice [at] thundersoft.com) pour tout support technique.</p> - -<p><img alt="Emergency download tool dialog box as it is when it start." src="https://mdn.mozillademos.org/files/9787/EmergencyDownloadTool.jpg" style="height: 363px; width: 497px;"></p> - -<div class="note"> -<p><strong>Note</strong> : L'outil n'est compatible qu'avec Windows.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : L'outil de récupération est fourni dans l'état, sans instructions supplémentaires ou documentation (tout du moins pas encore).</p> -</div> - -<h3 id="Mode_Recovery">Mode Recovery</h3> - -<p>Vous pouvez entrer dans le mode <em>recovery</em> pour effacer les données de votre téléphone ou installer manuellement un nouveau firmware. Pour rentrer dans ce mode, vous avez deux solutions :</p> - -<ul> - <li>Si l'outil <a href="/fr/Firefox_OS/deboguer/Installing_ADB">ADB</a> est disponible, assurez-vous d'avoir activé le débogage distant depuis les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeurs sur Firefox OS</a>, connectez votre téléphone à votre ordinateur et entrez la commande suivante dans un terminal <code>adb reboot recovery</code>.</li> - <li>Si votre téléphone est éteint, allumez-le en maintenant les boutons d'allumage et <em>monter le volume</em>.</li> -</ul> - -<p>Depuis le mode <em>recovery</em>, vous pouvez naviguer dans les menus via les boutons monter / baisser le volume et sélectionner les options via le bouton d'allumage. Assurez vous d'avoir sauvegardé votre profil avec vos données personnelles avant d'effacer les données ou d'effectuer une mise à jour.</p> - -<h2 id="Sauvegarder_et_restaurer_les_données_de_votre_Flame">Sauvegarder et restaurer les données de votre Flame</h2> - -<p>Lorsque vous utilisez votre téléphone Flame couramment, vous ne voulez peut-être pas perdre vos données personnelles comme vos contacts, vos paramétrages ou vos applications en mettant à jour votre téléphone avec les images listés ci-dessus. Pour sauvegarder et restaurer votre profil, vous pouvez utiliser notre outil livré dans le dépôt Git <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool">B2G-flash-tool</a>.</p> - -<ol> - <li>Ouvrez votre ligne de commande.</li> - <li>Clonez le dépôt suivant (vous devez avoir <a href="http://www.git-scm.com/downloads">Git</a> installé sur votre système). (Si vous ne possédez pas Git ou ne pouvez l'installer, un bouton "download as Zip" vous permet de télécharger le dépôt complet). - <pre class="brush: bash language-html"><code class="language-bash">git clone https://github.com/Mozilla-TWQA/B2G-flash-tool</code></pre> - </li> - <li>L'outil se présente sous la forme d'un script python : <code>backup_restore_profile.py</code>. Pour l'utiliser, vous devez avoir l'outil <a href="https://www.python.org/downloads/">Python</a> d'installé sur votre ordinateur (la version 2.7.x devrait suffire). Les systèmes Linux et Mac les installent habituellement par défaut.</li> - <li>Rendez-vous dans le dossier où vous avez cloné le dépôt avec un terminal de ligne de commande <code>cd B2G-flash-tool</code>.</li> -</ol> - -<div class="note"> -<p><strong>Note</strong>: Lorsque vous utilisez cet outil, assurez-vous d'avoir activé le mode debogage distant via USB depuis les <a href="/fr/Firefox_OS/deboguer/parametres_developpeurs">paramètres pour développeurs sur Firefox OS</a> et que l'outil ADB est installé sur votre ordinateur.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: Si vous avez un message d'erreur à propos d'autorisations manquantes pour exécuter le script, exécutez la commande suivante :</p> - -<pre class="brush: bash language-html"><code class="language-bash">chmod +x backup_restore_profile.py</code></pre> -</div> - -<h3 id="Sauvegarder_les_données_de_votre_téléphone">Sauvegarder les données de votre téléphone</h3> - -<p>Depuis le répertoire où vous avez sauvegardé le dépôt exécutez la commande suivante :</p> - -<pre class="brush: bash language-html"><code class="language-bash">python backup_restore_profile.py -b</code></pre> - -<p>Cela devrait sauvegarder votre profil dans un répertoire <code>mozilla-profile</code> situé dans le même répertoire que le script.</p> - -<h3 id="Restaurer_les_données_sur_votre_téléphone">Restaurer les données sur votre téléphone</h3> - -<p>Depuis le répertoire où est situé <code>mozilla-profile</code>, exécutez la commande suivante :</p> - -<pre class="brush: bash language-html"><code class="language-bash">python backup_restore_profile.py -r</code></pre> - -<div class="note"> -<p><strong>Note</strong>: Vous pouvez lister l'ensemble des options disponibles en exécutant la commande <code>python backup_restore_profile.py -h</code>.</p> -</div> - -<h2 id="Installer_des_application_sur_votre_Flame">Installer des application sur votre Flame</h2> - -<p>Les outils <a href="/fr/Firefox_OS/Using_the_App_Manager">App Manager</a> et <a href="/fr/docs/Outils/WebIDE">WebIDE</a> rendent facile l'installation et le débogage des applications sur votre téléphone.</p> - -<h2 id="Ajuster_la_taille_de_la_RAM">Ajuster la taille de la RAM</h2> - -<p>Vous pouvez modifier la taille de la RAM de votre téléphone pour tester le comportement du système ou des applications sur des téléphones qui auraient moins de RAM que le Flame.</p> - -<p>Cela est géré depuis le mode fastboot (installez d'abord fastboot et <a href="/fr/Firefox_OS/deboguer/Installing_ADB">ADB</a>) et exécutez les commandes suivantes :</p> - -<pre class="brush: bash language-html"><code class="language-bash">adb reboot bootloader -fastboot oem mem [0|256-1024]</code></pre> - -<p>“0” indique que la quantité de RAM sera détectée automatiquement, “256-1024” correspond à un nombre de <em>megabytes</em>. Par exemple, si vous voulez que votre système n'utilise que 512Mo entrez la commande <code>fastboot oem mem 512</code>.</p> - -<p>Pour que les modifications soient prises en compte, vous devrez redémarrer votre téléphone en utilisant la commande suivante :</p> - -<pre class="brush: bash language-html"><code class="language-bash">fastboot reboot</code></pre> - -<p>La quantité de mémoire actuellement utilisée / paramétrée peut être récupérée avec la commande suivante :</p> - -<pre class="brush: bash language-html"><code class="language-bash">fastboot getvar mem</code></pre> diff --git a/files/fr/archive/b2g_os/phone_guide/fx0/index.html b/files/fr/archive/b2g_os/phone_guide/fx0/index.html deleted file mode 100644 index a203e30eb5..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/fx0/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Fx0 -slug: Archive/B2G_OS/Phone_guide/Fx0 -tags: - - Firefox OS - - Fx0 - - KDDI - - Téléphone - - consommateur -translation_of: Archive/B2G_OS/Phone_guide/Fx0 ---- -<div class="column-container"> -<div class="column-half"> -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> -<img alt="" src="https://mdn.mozillademos.org/files/9835/fx0.png" style="display: block; height: 439px; margin-bottom: 20px; margin-right: 50px; margin: 0 auto; width: 200px;"></div> - -<div class="column-half"> -<p>Le Fx0 est un smartphone Firefox OS haut de gamme et constitue le tout premier téléphone sous Firefox OS distribué au Japon. Il a été commercialisé par KDDI en décembre 2014.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le Fx0 est disponible à l'achat via les canaux de distribution japonais classiques. C'est un périphérique SIM-locké, il ne peut donc être utilisé qu'au Japon.</p> - -<p>Désormais, il y a quelques téléphones SIM débloqués qui sont vendus dans des sites marchands.</p> - -<h2 id="Mise_à_jour_logicielle">Mise à jour logicielle</h2> - -<p>L'image système de l'appareil étant verrouillée, il n'est possible de mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 2.0.</p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver davantage d'informations sur les spécifications de l'appareil sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page de specs des téléphones et appareils</a>.</p> - -<h3 id="Matériel">Matériel</h3> - -<ul> - <li><strong>CPU</strong> : Qualcomm Snapdragon S4 MSM8926 1,2 GHz quad-core</li> - <li><strong>Photo </strong>: 8 mégapixels (avant), 2,1 mégapixels (arrière)</li> - <li><strong>Batterie </strong>: 2370 mAh</li> - <li><strong>Affichage </strong>: 4,7"/IPS</li> - <li><strong>Résolution </strong>: 1280 x 720</li> - <li><strong>Stockage interne </strong>: ROM 16 Go, RAM 1,5 Go </li> - <li><strong>Stockage externe </strong>: microSDXC (64 Go max.)</li> - <li><strong>Dimensions </strong>: 70x139x10,5 mm</li> - <li><strong>Poids </strong>: Env. 148g</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://au-fx.kddi.com/eng/">Portail d'information officiel du KDDI Fx0</a></li> - <li><a href="https://blog.mozilla.org/blog/2014/12/22/mozilla-and-kddi-launch-first-firefox-os-smartphone-in-japan/">Annonce officielle sur le blog de Mozilla</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/huawei_y300_ii/index.html b/files/fr/archive/b2g_os/phone_guide/huawei_y300_ii/index.html deleted file mode 100644 index def7cc5976..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/huawei_y300_ii/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Huawei Y300 II -slug: Archive/B2G_OS/Phone_guide/Huawei_Y300_II -tags: - - Firefox OS - - Huawei Y300II - - Téléphone - - utilisateur -translation_of: Archive/B2G_OS/Phone_guide/Huawei_Y300_II ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="https://mozorg.cdn.mozilla.net/media/img/firefox/os/devices/smartphones/huawei-y300.34f0164903aa.png" style="height: 366px; width: 200px;"></div> - -<div class="column-half"> -<p>Le Huawei Ascend Y300 II est très semblable au Ascend Y300 basé sur Android, à l'exception qu'il fait tourner Firefox OS 1.1 et non Android, de Google.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le Huawei Ascend Y300 II est disponible via les canaux de distribution classiques.</p> - -<h3 id="Disponibilité">Disponibilité</h3> - -<ul> - <li>Philippines</li> - <li>Mexique</li> -</ul> - -<h3 id="Opérateurs">Opérateurs</h3> - -<ul class="comma-list"> - <li>Movistar</li> -</ul> -</div> -</div> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil est verrouillée, il n'est donc possible de mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.1.</p> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<ul> - <li><strong>CPU</strong> : Qualcomm Snapdragon MSM8225 S4 Play, double cœur 1 GHz, ARMv7 Cortex A5</li> - <li><strong>GPU</strong> : Qualcomm Adreno 203</li> - <li><strong>Caméra</strong>: 5 mégapixels avec flash LED, frontale VGA 0,3 mégapixels, Geotagging</li> - <li><strong>Batterie </strong>: 1730 mAh</li> - <li><strong>Affichage </strong>: affichage 16 M couleurs 4,0”, Multitouch</li> - <li><strong>Résolution </strong>: WVGA 480 x 800 pixels, 233 ppp</li> - <li><strong>Mémoire interne </strong>: RAM 512 Mo, 4 Go stockage interne</li> - <li><strong>Mémoire externe </strong>: microSD, microSDHC jusqu'à 32 Go</li> - <li><strong>Dimensions </strong>: <span>124,5 x 63,8 x 11,2 mm</span></li> - <li><strong>Poids </strong>: Env. <span>130 g</span></li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Noir anthracite</li> - <li>Blanc nacré</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.gsmarena.com/huawei_ascend_y300-5386.php">gsmArena</a></li> - <li><a href="http://www.phonearena.com/phones/Huawei-Ascend-Y300II_id8462">Phone Arena</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/index.html b/files/fr/archive/b2g_os/phone_guide/index.html deleted file mode 100644 index 6e20502d45..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Guide du téléphone pour développeur Firefox OS -slug: Archive/B2G_OS/Phone_guide -tags: - - B2G - - Bonnes pratiques de développement mobile - - Firefox OS - - Téléphone - - distribution - - liste smartphones Firefox OS -translation_of: Archive/B2G_OS/Phone_guide ---- -<div class="summary"> -<p><span class="seoSummary">Cette section contient des informations relatives aux téléphones spécifiques qui tournent sous Firefox OS – que ce soit des appareils pour les développeurs ou pour l'utilisateur final.</span></p> - -<p>Les informations générales sont disponibles via les pages : comment <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">compiler et installer Firefox OS</a> et <a href="/fr/Firefox_OS/Developing_Firefox_OS">développer Firefox OS</a> ; consultez-les pour créer et installer la plate-forme à partir de zéro.</p> - -<p>Pour les développeurs qui possèdent des téléphones sous Firefox OS, les articles suivants peuvent néanmoins se révéler utiles.</p> -</div> - -<h2 id="A_l'attention_du_développeur">A l'attention du développeur</h2> - -<p>Les téléphones listés ici sont spécifiquement dédiés aux développeurs désirant expérimenter Firefox OS, que ce soit pour développer des applications ou contribuer au système d'exploitation lui-même. À ce titre, ils ont des cartes SIM déverouillées , des fichiers système accessibles, etc.</p> - -<dl> - <dt><a href="/fr/Firefox_OS/Phone_guide/Flame">Flame</a></dt> - <dd>Le dispositif Flame, réalisé en partenariat avec T<sup>2</sup>Mobile, est la référence officielle pour développer, tester et déboguer Firefox OS ainsi que les applications web ouvertes.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Geeksphone">Geeksphone</a></dt> - <dd>Dans cet article, nous donnons quelques conseils de base sur la façon de garder votre Geeksphone à jour et comment modifier les applications système de <a href="/fr/Firefox_OS/Platform/Gaia">Gaia</a>.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/ZTE_OPEN">ZTE OPEN</a></dt> - <dd>Cet article contient des informations sur le téléphone ZTE OPEN sous Firefox OS.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/ZTE_OPEN_C">ZTE OPEN C</a></dt> - <dd>Le ZTE Open C est une version du téléphone sous Firefox OS produit par ZTE, avec des composants matériels haut de gamme et les plus récents logiciels .</dd> -</dl> - -<h2 id="A_l'attention_de_l'utilisateur">A l'attention de l'utilisateur</h2> - -<p>Les téléphones répertoriés ci-dessous sont des modèles "utilisateurs", donc pas spécialement adaptés pour les "hackers". Cependant, les informations qui suivent sont utiles pour ceux souhaitant localiser des applications ou voulant s'assurer que leurs applications fonctionnent sur un périphérique spécifique.</p> - -<p>Pour une liste plus complète des périphériques, consultez notre page <a href="https://www.mozilla.org/fr/firefox/os/devices/">Firefox OS - Appareils et disponibilité</a>.</p> - -<dl> - <dt><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Alcatel_One_Touch_Fire">Alcatel One Touch Fire</a></dt> - <dd>Disponible dans plus de cinq pays, l'Alcatel One Touch Fire est un smartphone sous Firefox OS 1.3.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Phone_guide/Alcatel_One_Touch_Pixi_3_%283.5%29">Alcatel One Touch Pixi 3 (3.5)</a></dt> - <dd><span>Smartphone propulsé par Firefox OS 2.0, avec une caméra de 2 méga-pixels.</span></dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Alcatel_Onetouch_Fire_C_4020D">Alcatel Onetouch Fire 2C 4020D</a></dt> - <dd>L'Alcatel Onetouch Fire C est un smartphone sous Firefox OS Tarako (1.3T), lui aussi distribué en Inde.</dd> - <dt><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Alcatel_One_Touch_Fire_C">Alcatel Onetouch Fire C</a></dt> - <dd>L'Alcatel One touch Fire C est un smartphone sous Firefox OS Tarako, distribué en Inde.</dd> - <dt><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Alcatel_One_Touch_Fire_E">Alcatel Onetouch Fire E</a></dt> - <dd>L'Alcatel Onetouch Fire E est un smartphone sous Firefox OS, disponible dans plus de cinq pays.</dd> - <dt><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Cherry_Mobile_Ace">Cherry Mobile Ace</a></dt> - <dd>Le Cherry Mobile Ace est un smartphone sous Firefox OS 1.3T, disponible aux Philippines.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Fx0">Fx0</a></dt> - <dd>Le Fx0 est le premier appareil Firefox OS spécifique utilisateur, sorti au Japon. Il est distribué par KDDI.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/LG_fireweb"> </a><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/Huawei_Y300_II">Huawei Y300 II</a></dt> - <dd>Le smartphone Huawei Y300 II, basé sous la version Firefox OS 1.1, est disponible aux Philippines et au Mexique.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Intex_Cloud_FX">Intex Cloud FX</a></dt> - <dd>L'Intex Cloud FX est le smartphone qui propose la toute première version de Firefox OS Tarako en Inde (basée sur Firefox OS 1.3T).</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/LG_fireweb">LG Fireweb</a></dt> - <dd>Le LG Fireweb est un smartphone sous Firefox OS 1.1, distribué en Uruguay et au Brésil.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Spice_Fire_One_MI_FX1">Spice Firefox MI FX1</a></dt> - <dd>Le Spice Fire One MI FX1 est un smartphone sous Firefox OS Tarako (1.3T), qui est distribué en Inde.</dd> - <dt><a href="/en-US/Firefox_OS/Phone_guide/Spice_Fire_One_MI_FX2">Spice Firefox MI FX2</a></dt> - <dd><span>Le Spice Fire One MI FX2 est un smartphone utilisateur 3G haut de gamme propulsé par FirefoxOS 1.4 avec une caméra de 2 megapixel, distribué en Inde.</span></dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Symphony_GoFox_F15">Symphony GoFox F15</a></dt> - <dd>Le Symphony GoFox F15 est le premier appareil Firefox OS avec la capacité d'appels vidéo 3G. Il a été lancé au Bangladesh.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Zen_U105_Fire">Zen U105 Fire</a></dt> - <dd>Dans cet article, vous trouverez des informations sur le smartphone "budget Zen" U105 Fire, disponible en Inde.</dd> - <dt style="font-size: 13.63636302948px; line-height: 19.0909080505371px;"><a href="https://developer.mozilla.org/fr/Firefox_OS/Phone_guide/ZTE_Open_II">ZTE Open II</a></dt> - <dd style="font-size: 13.63636302948px; line-height: 19.0909080505371px;">Le ZTE Open II est un smartphone sous Firefox OS disponible dans 7 pays, ayant un processeur double-cœur de 1.2 GHz et une double caméra de 2.0 MP.</dd> - <dt style="font-size: 13.63636302948px; line-height: 19.0909080505371px;"><a href="/en-US/docs/Mozilla/Firefox_OS/Phone_guide/Orange_Klif">Orange Klif</a></dt> - <dd style="font-size: 13.63636302948px; line-height: 19.0909080505371px;"><span>L'Orange Klif est un smartphone 3G, propulsé par Firefox OS 2.0, avec une caméra de 2 méga-pixels. Il est disponible dans un certain nombre de pays africains.</span></dd> -</dl> - -<h2 id="Informations_générales_Firefox_OS">Informations générales Firefox OS</h2> - -<dl> - <dt><a href="/fr/Firefox_OS/Phone_guide/Phone_specs">Spécifications des téléphones Firefox OS</a></dt> - <dd>Cet article donne la liste des différents téléphones Firefox OS disponibles ainsi que leurs spécifications telles que : noms de code, disponibilité, caractéristiques matérielles.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Firefox_OS_device_features">Caractéristiques </a><a href="/fr/Firefox_OS/Phone_guide/Firefox_OS_device_features">générales </a><a href="/fr/Firefox_OS/Phone_guide/Firefox_OS_device_features">des appareils</a></dt> - <dd>Cette page répertorie les caractéristiques spécifiques de Firefox OS et la configuration matérielle minimale requise.</dd> - <dt><a href="/fr/Firefox_OS/Troubleshooting">Dépannage</a></dt> - <dd>Cet article fournit des conseils pour résoudre les problèmes courants que vous pouvez rencontrer quand vous utilisez Firefox OS.</dd> - <dt><a href="/fr/Firefox_OS/Phone_guide/Best_practices_open_reference_devices">Bonnes pratiques pour les appareils de référence ouverte</a></dt> - <dd>Un ensemble de bonnes pratiques fortement recommandées pour tout téléphone largement distribué, ayant une référence ouverte.</dd> - <dd>Le développement de tous les périphériques Firefox OS récents, a été effectué selon ces pratiques.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/phone_guide/intex_cloud_fx/index.html b/files/fr/archive/b2g_os/phone_guide/intex_cloud_fx/index.html deleted file mode 100644 index 4a6df1d2d2..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/intex_cloud_fx/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Intex Cloud FX -slug: Archive/B2G_OS/Phone_guide/Intex_Cloud_FX -tags: - - Appareils Tarako - - Firefox OS - - Intex - - Téléphone - - utilisateur -translation_of: Archive/B2G_OS/Phone_guide/Intex_Cloud_FX ---- -<div class="column-container"> -<div class="column-half"><img alt="Intex Cloud FX image from official website" src="https://mdn.mozillademos.org/files/10089/245cloud-FX-big1.png" style="display: block; height: 454px; margin: 0px auto; width: 252px;"></div> - -<div class="column-half"> -<p>L'Intex Cloud FX est un smartphone utilisateur sous Firefox OS. Il est le tout premier téléphone Firefox OS Tarako distribué en Inde. Il a été commercialisé par Intex en août 2014.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<ul> - <li> Actuellement non disponible</li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<p>Inde</p> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil est verrouilée, le logiciel ne peut donc être actualisé que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.3T.</p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver plus d'informations sur les spécifications des appareils sur notre <a href="/en-US/Firefox_OS/Phone_guide/Phone_specs">page des spécifications des téléphones et appareils</a>.</p> - -<ul> - <li><strong>CPU </strong>: 1 GHz</li> - <li><strong>Photo </strong>: 2 mégapixels</li> - <li><strong>Batterie </strong>: 1,250mAh</li> - <li><strong>Écran </strong>: Écran capacitif 3,5 pouces</li> - <li><strong>Résolution </strong>: <span id="lblSpec">320 x 480</span></li> - <li><strong>Mémoire interne </strong>: ROM 256Mo, RAM 128Mo </li> - <li><strong>Mémoire externe </strong>: microSD (max. 4 Go)</li> - <li><strong>Dimensions </strong>: <span id="lblSpec">115,9 x 62 x 11,8</span> mm</li> - <li><strong>Poids </strong>: Env. 104g (avec batterie)</li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Noir</li> - <li>Blanc</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.intexmobile.in/product_detail.aspx?PID=191&PCatID=3">Informations officielles sur l'Intex Cloud FX</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/lg_fireweb/index.html b/files/fr/archive/b2g_os/phone_guide/lg_fireweb/index.html deleted file mode 100644 index 315ac8d9c8..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/lg_fireweb/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: LG fireweb -slug: Archive/B2G_OS/Phone_guide/LG_fireweb -tags: - - Firefox OS - - Fireweb - - Téléphone - - consommateur - - lg -translation_of: Archive/B2G_OS/Phone_guide/LG_fireweb ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="https://mdn.mozillademos.org/files/10113/fireweb.jpg" style="height: 350px; width: 210px;"></div> - -<div class="column-half"> -<p><span>Le LG Fireweb est un smartphone haut de gamme sous Firefox 1.1 avec un appareil photo de 5 mégapixels.</span></p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le téléphone peut être acheté ici :</p> - -<ul> - <li><a href="http://www.movistar.com.uy/Particulares/Equipos.aspx?IdPlan=PLC251&IdEquipo=249" rel="nofollow">Commander le LG Fireweb sur Movistar Uruguay </a></li> - <li><a href="http://lojaonline.vivo.com.br/lojaonline/appmanager/env/web?_nfls=false&_nfpb=true&_pageLabel=vecoVcDetalhesDeAparelhosPage&codSap=TGLG24962000&_nfls=false#" rel="nofollow">Commander le LG Fireweb sur Vivo Brésil </a></li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<ul> - <li>Brésil</li> - <li>Uruguay</li> -</ul> - -<p> </p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Davantage de caractéristiques sont listées sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page de spécifications des téléphones et appareils</a>.</p> - -<ul> - <li><strong>Chipset</strong> : Qualcomm Snapdragon MSM7227A</li> - <li><strong>CPU :</strong> processeur Cortex A5 à 1 GHz</li> - <li><strong>GPU</strong> : Adreno 200</li> - <li><strong>Photo </strong>: 5 MP, 2592 х 1944 pixels, flash LED</li> - <li><strong>Batterie </strong>: batterie Li-Ion 1540 mAh</li> - <li><strong>Affichage </strong>: écran tactile capacitif TFT 4,0 pouces</li> - <li><strong>Résolution</strong>: <span id="lblSpec">320 x 480 (densité de pixels </span>~144 ppp)</li> - <li><strong>Stockage interne </strong>: ROM 2 Go</li> - <li><strong>Stockage externe </strong>: microSD (max. 32 Go)</li> - <li><strong>Dimensions </strong>: 113,8 x 66,5 x 9 mm</li> - <li><strong>Poids </strong>: Env. 122 g</li> -</ul> - -<h2 id="Coloris_disponible">Coloris disponible</h2> - -<ul> - <li>Noir</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://www.youtube.com/watch?v=t_7sTP7IRn4">Vidéo officielle du LG FireWeb</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/nexus_4/index.html b/files/fr/archive/b2g_os/phone_guide/nexus_4/index.html deleted file mode 100644 index dcf29d6338..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/nexus_4/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Nexus 4 -slug: Archive/B2G_OS/Phone_guide/Nexus_4 -tags: - - B2G - - Firefox OS - - Installation - - Nexus 4 - - flashage -translation_of: Archive/B2G_OS/Phone_guide/Nexus_4 ---- -<p class="summary">Cet article fournit des informations sur l'utilisation de Firefox OS sur un Nexus 4, parmi lesquelles le flashage de Firefox OS sur votre appareil.</p> - -<h2 id="Installation_de_Firefox_OS_sur_votre_Nexus_4">Installation de Firefox OS sur votre Nexus 4</h2> - -<p>Cette section fournit les instructions pour flasher Firefox OS sur votre appareil Nexus 4.</p> - -<h3 id="Général">Général</h3> - -<p>Tous les utilisateurs doivent avoir <a href="/fr/Firefox_OS/Déboguer/Installer_ADB">adb et fastboot</a> fonctionnels. Si vous n'avez pas adb ni fastboot, vous pouvez les télécharger depuis le <a href="http://developer.android.com/sdk/index.html">SDK d'Android</a> dont ils font partie.</p> - -<p>Les utilisateurs de Windows doivent également installer les pilotes USB de Google. <a href="http://developer.android.com/sdk/win-usb.html">Téléchargez les pilotes USB</a>, et <a href="http://developer.android.com/tools/extras/oem-usb.html#InstallingDriver">suivez les instructions d'installation</a>.</p> - -<h3 id="Flashage_de_Firefox_OS_sous_Windows">Flashage de Firefox OS sous Windows</h3> - -<ol> - <li><a href="https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-4-kk-user.opt/artifacts/public/build/nexus-4-kk.zip">Téléchargez la version nexus-4-kk.zip</a>.</li> - <li>Décompressez le fichier, et vérifiez que <code>flash.bat</code> est présent dans le dossier <code>b2g-distro</code>.</li> - <li>Éteignez votre Nexus 4 s'il était allumé.</li> - <li>Branchez votre Nexus 4 sur votre ordinateur avec un câble USB.</li> - <li>Allumez le nexus 4 en appuyant sur le bouton power, et juste après maintenez enfoncé le bouton volume bas jusqu'à ce que le message "Restart bootloader" soit affiché sur l'écran.</li> - <li>Double-cliquez sur le fichier <code>flash.bat</code>.</li> -</ol> - -<h3 id="Flashage_de_Firefox_OS_sous_MacLinux">Flashage de Firefox OS sous Mac/Linux</h3> - -<ol> - <li><a href="https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-4-kk-user.opt/artifacts/public/build/nexus-4-kk.zip">Téléchargez la version nexus-4-kk.zip</a>.</li> - <li>Décompressez le fichier, et vérifier que <code>flash.sh</code> est présent dans le dossier <code>b2g-distro</code>.</li> - <li>Branchez votre Nexus 4 sur votre ordinateur avec un câble USB.</li> - <li>Ouvrez votre terminal et entrez dans le répertoire où se trouve <code>flash.sh</code> — e.g : <code>cd nexus-4-kk/b2g-distro</code>.</li> - <li>Entrez la commande <code>adb devices</code> pour vérifier que l'appareil est détecté. (Voir l'aide et les informations de dépannage sur la <a href="http://developer.android.com/tools/help/adb.html">configuration de la commande adb</a>.)</li> - <li>Entrez la commande <code>chmod +x ./flash.sh</code> pour rendre le script de flashage exécutable.</li> - <li>Entrez la commande <code>./flash.sh</code> pour procéder à l'installation.</li> -</ol> - -<p>Une fois le processus terminé, votre téléphone redémarrera sur Firefox OS.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/nexus_5/index.html b/files/fr/archive/b2g_os/phone_guide/nexus_5/index.html deleted file mode 100644 index 9eb57299b2..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/nexus_5/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Nexus 5 -slug: Archive/B2G_OS/Phone_guide/Nexus_5 -tags: - - B2G - - Firefox OS - - Installation - - Nexus 5 - - flashage -translation_of: Archive/B2G_OS/Phone_guide/Nexus_5 ---- -<p class="summary">Cet article fournit des informations sur l'utilisation de Firefox OS sur un Nexus 5, parmi lesquelles le flashage de Firefox OS sur votre appareil.</p> - -<h2 id="Installation_de_Firefox_OS_sur_votre_Nexus_5">Installation de Firefox OS sur votre Nexus 5</h2> - -<p>Cette section fournit les instructions pour flasher Firefox OS sur votre appareil Nexus 5.</p> - -<h3 id="Généralités">Généralités</h3> - -<p>Tous les utilisateurs doivent avoir <a href="/fr/Firefox_OS/Déboguer/Installer_ADB">adb et fastboot</a> fonctionnels. Si vous n'avez pas adb ni fastboot, vous pouvez les télécharger depuis le <a href="http://developer.android.com/sdk/index.html">SDK d'Android</a> dont ils font partie.</p> - -<p>Les utilisateurs de Windows doivent également installer les pilotes USB de Google. <a href="http://developer.android.com/sdk/win-usb.html">Téléchargez les pilotes USB</a>, et <a href="http://developer.android.com/tools/extras/oem-usb.html#InstallingDriver">suivez les instructions d'installation</a>.</p> - -<h3 id="Flashage_de_Firefox_OS_sous_Windows">Flashage de Firefox OS sous Windows</h3> - -<ol> - <li><a href="https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-5-user.opt/artifacts/public/build/nexus-5-l.zip">Téléchargez la version nexus-5-l.zip</a>.</li> - <li>Décompressez le fichier, et vérifiez que <code>flash.bat</code> est présent dans le dossier <code>b2g-distro</code>.</li> - <li>Branchez votre Nexus 5 sur votre ordinateur avec un câble USB.</li> - <li>Vérifiez que l'appareil est allumé, et que le mode adb est activé (<strong>Firefox OS </strong>: <em>Paramètres > Développeurs > ADB et outils de développement </em>; <strong>Android</strong>: <em>Settings > Developer options > USB debugging</em>.)</li> - <li>Double-cliquez sur le fichier <code>flash.bat</code>.</li> -</ol> - -<h3 id="Flashage_de_Firefox_OS_sous_MacLinux">Flashage de Firefox OS sous Mac/Linux</h3> - -<ol> - <li><a href="https://index.taskcluster.net/v1/task/gecko.v1.mozilla-central.latest.linux.nexus-5-user.opt/artifacts/public/build/nexus-5-l.zip">Téléchargez la version nexus-5-l.zip</a>.</li> - <li>Décompressez le fichier, et vérifiez que <code>flash.sh</code> est présent dans le dossier <code>b2g-distro</code>.</li> - <li>Branchez votre Nexus 5 sur votre ordinateur avec un câble USB.</li> - <li>Ouvrez votre terminal et entrez dans le répertoire où se trouve <code>flash.sh</code> — e.g : <code>cd nexus-5-l/b2g-distro</code>.</li> - <li>Entrez la commande <code>adb devices</code> pour vérifier que l'appareil est détecté. (Voir l'aide et les informations de dépannage sur la <a href="http://developer.android.com/tools/help/adb.html">configuration de la commande adb</a>.)</li> - <li>Entrez la commande <code>chmod +x ./flash.sh</code> pour rendre le script de flashage exécutable.</li> - <li>Entrez la commande <code>./flash.sh</code> pour procéder à l'installation.</li> -</ol> - -<p>Une fois le processus terminé, votre téléphone redémarrera sous Firefox OS.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/phone_specs/index.html b/files/fr/archive/b2g_os/phone_guide/phone_specs/index.html deleted file mode 100644 index 9a9761313d..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/phone_specs/index.html +++ /dev/null @@ -1,549 +0,0 @@ ---- -title: Phone and device specs -slug: Archive/B2G_OS/Phone_guide/Phone_specs -translation_of: Archive/B2G_OS/Phone_guide/Phone_specs ---- -<div class="summary"> -<p><span class="seoSummary">Cet article fourni des informations sur les appareils sous Firefox OS et leurs caractéristiques techniques, noms de code, versions Firefox OS de base, et autres.</span></p> -</div> - -<h2 id="Téléphones_Firefox_OS_disponible">Téléphones Firefox OS disponible</h2> - -<p>Durant la période de développement à chaque différent stade nous avions différent téléphones. Maintenant que nous avons déployé la version commercial, nous avons différent modèles provenant de différent constructeurs partenaires. <em><span style="background-color: #ffffe0;">[</span><span style="background-color: #ffffe0;">we</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">should</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">develope</span><span style="background-color: #ffffe0;"> or </span><span style="background-color: #ffffe0;">completely</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">deleting</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">this</span><span style="background-color: #ffffe0;"> part </span><span style="background-color: #ffffe0;">because</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">it's</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">not</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">really</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">useful</span><span style="background-color: #ffffe0;"> in </span><span style="background-color: #ffffe0;">this</span><span style="background-color: #ffffe0;"> </span><span style="background-color: #ffffe0;">state</span><span style="background-color: #ffffe0;">]</span></em></p> - -<div class="note"> -<p><strong>Note</strong>: Pour consulter les informations sur les disponibilité des téléphones dans votre pays et chez quels opérateurs consultez la page <a href="https://www.mozilla.org/fr/firefox/os/devices/">Firefox OS près de chez vous</a>.</p> -</div> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col"> - <p>Name / Codename</p> - </th> - <th scope="col">Release date</th> - <th scope="col">Initial FxOS<br> - version</th> - <th scope="col">Disponibilité</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <p>Alcatel One Touch Fire</p> - - <p><em>hamachi, buri</em></p> - </td> - <td>12 Juillet 2013</td> - <td>1.0.1</td> - <td>Actuellement disponible</td> - <td>Disponible publiquement au Brésil, Uruguay, Italie, Allemagne, Grèce, Serbie, Hongrie et Pologne.<br> - Disponible avec des revendeurs sur eBay.</td> - </tr> - <tr> - <td><em>otoro, unagi, inari</em></td> - <td> </td> - <td> </td> - <td> </td> - <td>off the shelf ZTE phone used for development prior to the ZTE Open.</td> - </tr> - <tr> - <td> - <p><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/ZTE_OPEN">ZTE Open</a></p> - - <p><em>ikura</em></p> - </td> - <td>2 Juillet 2013</td> - <td>1.0.1</td> - <td>Actuellement disponible</td> - <td>similar to inari; publicly available on eBay.</td> - </tr> - <tr> - <td> - <p>LG Fireweb</p> - - <p><em>leo</em></p> - </td> - <td>24 Octobre 2013</td> - <td>1.1</td> - <td>Actuellement disponible</td> - <td>Disponible publiquement au Brésil.</td> - </tr> - <tr> - <td> - <p><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone Keon</a></p> - - <p><em>keon</em></p> - </td> - <td>24 Avril 2013</td> - <td>1.0.1</td> - <td>Actuellement en rupture de stock</td> - <td>Developer-only devices</td> - </tr> - <tr> - <td> - <p><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone Peak</a></p> - - <p><em>peak</em></p> - </td> - <td>24 Avril 2013</td> - <td>1.0.1</td> - <td>Actuellement en rupture de stock</td> - <td>Was codenamed "twist" for a while; developer-only devices</td> - </tr> - <tr> - <td><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone Peak+</a></td> - <td>-</td> - <td>-</td> - <td>-</td> - <td><a href="http://www.geeksphone.com/?wysija-page=1&controller=email&action=view&email_id=15">Annulé</a></td> - </tr> - <tr> - <td>Geeksphone Revolution</td> - <td>4 Mars 2014</td> - <td>1.3pre</td> - <td>Actuellement disponible</td> - <td><a href="http://shop.geeksphone.com/moviles/9-revolution.html">Disponible en ligne</a></td> - </tr> - <tr> - <td> - <p>LG Google Nexus 4</p> - - <p><em>nexus-4</em></p> - </td> - <td> </td> - <td> </td> - <td> </td> - <td>Experimental. Not supported by either LG or Google. Discontinued hardware.</td> - </tr> - <tr> - <td> - <p><a href="/en-US/Firefox_OS/Developer_phone_guide/Flame">Flame</a></p> - - <p><em>"the reference device"</em></p> - </td> - <td>Fin Avril 2014</td> - <td>1.3</td> - <td> </td> - <td><a href="http://www.everbuying.com/product549652.html">Available to pre-order</a></td> - </tr> - <tr> - <td> - <p>Spreadtrum</p> - - <p><em>tarako</em></p> - </td> - <td>Fin du Q2 2014 ?</td> - <td> </td> - <td>Bientôt disponible</td> - <td> </td> - </tr> - <tr> - <td><a href="https://developer.mozilla.org/fr/Firefox_OS/Developer_phone_guide/ZTE_OPEN_C">ZTE Open C</a></td> - <td>13 mai 2014</td> - <td>1.3</td> - <td>Actuellement disponible</td> - <td> - <p><a href="http://www.leclercmobile.fr/telephones-mobiles/notre-gamme/mobiles/Zte_Open-C.aspx">Disponible en ligne et en boutique</a> (Leclerc)</p> - - <p><a href="http://www.ldlc.com/fiche/PB00171571.html">Disponible en ligne</a> (LDLC.com)</p> - - <p><a href="http://www.materiel.net/smartphone/zte-open-c-bleu-107188.html/fr/docs/">Disponible en ligne</a> (Materiel.net)</p> - </td> - </tr> - </tbody> -</table> - -<h2 id="Firefox_OS_by_version">Firefox OS by version</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Version</th> - <th scope="col">Feature Complete (FC) date</th> - <th scope="col">Release To Partner<br> - (RTP) date</th> - <th scope="col">Nom de Code</th> - <th scope="col">Version Gecko</th> - <th scope="col">Included security fixes</th> - <th scope="col">Release notes</th> - </tr> - </thead> - <tbody> - <tr> - <td>1.0</td> - <td>22 Décembre 2012</td> - <td>21 Février 2013</td> - <td>TEF</td> - <td>Gecko 18</td> - <td>Gecko 18</td> - <td> </td> - </tr> - <tr> - <td>1.0.1</td> - <td>15 Janvier 2013</td> - <td>6 Septembre 2013</td> - <td>Shira</td> - <td>Gecko 18</td> - <td>Gecko 20</td> - <td><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases/1.0.1">Developer</a><br> - <a href="https://support.mozilla.org/en-US/kb/whats-new-firefox-os-v11">Consumer</a></td> - </tr> - <tr> - <td>1.1</td> - <td>29 Mars 2013</td> - <td>9 Octobre 2013</td> - <td>Leo</td> - <td>Gecko 18+ (new <a href="http://en.wikipedia.org/wiki/Application_programming_interface" title="Application programming interface">APIs</a>)</td> - <td>Gecko 23</td> - <td><a href="https://developer.mozilla.org/en-US/Firefox_OS/Releases/1.1">Developer</a><br> - <a href="http://www.mozilla.org/en-US/firefox/os/notes/1.1/">Consumer</a></td> - </tr> - <tr> - <td>1.1.1</td> - <td> </td> - <td>TBD</td> - <td>HD</td> - <td>Same as 1.1.0 with WVGA</td> - <td>Gecko 23</td> - <td> </td> - </tr> - <tr> - <td>1.2</td> - <td>15 Septembre 2013</td> - <td>9 Décembre 2013</td> - <td>Koi</td> - <td>Gecko 26<sup><a href="http://en.wikipedia.org/wiki/Firefox_OS#cite_note-39"><span>[</span>39<span>]</span></a></sup></td> - <td>Gecko 26</td> - <td><a href="/en-US/Firefox_OS/Releases/1.2">Developer</a><br> - <a href="http://www.mozilla.org/en-US/firefox/os/notes/1.2/">Consumer</a></td> - </tr> - <tr> - <td>1.3</td> - <td>9 Décembre 2013</td> - <td>TBD</td> - <td> </td> - <td>Gecko 28</td> - <td>Gecko 28</td> - <td><a href="/en-US/Firefox_OS/Releases/1.3">Developer</a><br> - <a href="http://www.mozilla.org/en-US/firefox/os/notes/1.3/">Consumer</a></td> - </tr> - <tr> - <td>1.4</td> - <td>17 Mars 2014</td> - <td>TBD</td> - <td> </td> - <td>Gecko 30</td> - <td>Gecko 30</td> - <td><a href="/en-US/Firefox_OS/Releases/1.4">Developer</a><br> - Consumer (TBD)</td> - </tr> - <tr> - <td>2.0</td> - <td>TBD</td> - <td>TBD</td> - <td> </td> - <td>Gecko 32</td> - <td>Gecko 32</td> - <td><a href="/en-US/Firefox_OS/Releases/2.0">Developer</a><br> - Consumer (TBD)</td> - </tr> - </tbody> -</table> - -<h2 id="Device_specifications">Device specifications</h2> - -<p>Note that there are some cases where there is an upcoming device that has not been announced but where we are able to share the code-name of the device and (some of) the capabilities of the device. DO NOT put extra info down for these devices unless Andreas Gal or someone else equally able to bless the public disclosure of the information has disclosed it.</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Nom</th> - <th scope="col">Versions</th> - <th scope="col">Resolution</th> - <th scope="col">Affichage (inches)</th> - <th scope="col">CPU</th> - <th scope="col">Camera(s), Mpx</th> - <th scope="col">RAM</th> - <th scope="col">ROM</th> - <th scope="col">Storage</th> - <th scope="col">Battery (mAh)</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <p>Alcatel One Touch Fire</p> - - <p><em>hamachi, buri</em></p> - </td> - <td>v1.0.1/v1.1</td> - <td> - <p>320 x 480<br> - PX=1</p> - </td> - <td>3.5</td> - <td>Qualcomm Snapdragon S1 MSM7227A 1 GHz</td> - <td>Rear: 3.2</td> - <td>256MB</td> - <td>512MB</td> - <td>/data: probably the same as inari; <a href="http://www.alcatelonetouch.com/global-en/products/smartphones/one_touch_fire.html#.Unyg5UOVt1M">specs say</a> 160MB "end user memory"<br> - Probably no built-in DeviceStorage, MicroSD card (up to 32GB) required<br> - </td> - <td>1400</td> - </tr> - <tr> - <td> - <p>ZTE Open / variants</p> - - <p><em>ikura</em></p> - </td> - <td>v1.0.1 (as shipped)</td> - <td>320 x 480<br> - PX=1</td> - <td>3.5</td> - <td>Qualcomm Snapdragon S1 MSM7225A 800 MHz</td> - <td>Rear: 3.2</td> - <td>256MB</td> - <td>512MB</td> - <td> - <p>/data: 152M<br> - No built-in DeviceStorage, MicroSD card required</p> - </td> - <td>1200</td> - </tr> - <tr> - <td> - <p>LG Fireweb</p> - - <p><em>leo</em></p> - </td> - <td>v1.1</td> - <td>320 x 480<br> - PX=1</td> - <td>4</td> - <td>Qualcomm Snapdragon S1 MSM7227A 1 GHz</td> - <td>Rear: 5</td> - <td>512MB</td> - <td>4GB</td> - <td> - <p>/data: 1007.90M<br> - built-in DeviceStorage: yes, size unsure. possibly 3.7G, but that might be bad math. (On an unhapy device /sys/devices/platform/msm_sdcc.3/mmc_host/mmc0/mmc0:0001/block/mmcblk0/block is 7733248, and then assuming a 512 byte block size, we get 3.7G)</p> - </td> - <td>1540</td> - </tr> - <tr> - <td> - <p><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone Keon</a></p> - - <p><em>keon</em></p> - </td> - <td> - <p>v1.0.1 - nightly<br> - <a href="/en-US/docs/">downloads here</a></p> - </td> - <td>320 x 480<br> - PX=1</td> - <td>3.5</td> - <td>Qualcomm Snapdragon S1 7225AB 1 GHz</td> - <td>Rear: 3</td> - <td>512MB</td> - <td>4GB</td> - <td> - <p>/data: 1.5G<br> - built-in DeviceStorage: 1023.4M</p> - </td> - <td>1580</td> - </tr> - <tr> - <td> - <p><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone Peak</a></p> - - <p><em>peak</em></p> - </td> - <td>v1.0.1 - nightly<br> - <a href="/en-US/docs/">downloads here</a></td> - <td>540 x 960<br> - PX=1.5</td> - <td>4.3</td> - <td>Qualcomm Snapdragon S4 8225 1.2 GHz dual-core</td> - <td> - <p>Front: 2<br> - Rear: 8</p> - </td> - <td>512MB</td> - <td>4GB</td> - <td>/data: 1.5G<br> - built-in DeviceStorage: 1023.4M</td> - <td>1800</td> - </tr> - <tr> - <td>Geeksphone Revolution</td> - <td>v1.3pre (as shipped)</td> - <td>540 x 960 PX=1.5</td> - <td>4.7</td> - <td><span class="mini-text">Dual-core Intel® Atom™ processor Z2560<span class="mini-text"> with up to 1.6GHz</span></span></td> - <td> - <p>Front: 1.3 Rear: 8</p> - </td> - <td>1GB</td> - <td>4GB</td> - <td> - <p>/data: 2G<br> - built-in DeviceStorage: 2.5GB</p> - </td> - <td>2000</td> - </tr> - <tr> - <td> - <p>Nexus 4</p> - - <p><em>nexus-4</em></p> - </td> - <td>v1.3 - nightly</td> - <td>768 x 1280<br> - 720p</td> - <td>4.7</td> - <td> - <p>Qualcomm<br> - <span class="mw-redirect">Snapdragon S4 Pro</span><br> - 1.5 GHz quad-core</p> - </td> - <td>Rear: 8</td> - <td>2GB</td> - <td>8 or 16GB</td> - <td>everything exists in one big soup, there is no external (MicroSD) storage. The size of the soup varies based on what model Nexus 4 you got.</td> - <td>2100</td> - </tr> - <tr> - <td> - <p><a href="https://wiki.mozilla.org/FirefoxOS/TCP">Foxconn InFocus</a></p> - - <p><em>flatfish</em></p> - </td> - <td> </td> - <td>1280 x 800</td> - <td>10</td> - <td>Allwinner A31, Cortex A7 Quad-Core 1.0 GHz</td> - <td> - <p>Front: 2<br> - Rear: 5</p> - </td> - <td>2GB</td> - <td>16GB</td> - <td> </td> - <td>7000</td> - </tr> - <tr> - <td> - <p><a href="https://wiki.mozilla.org/Platform/2013-11-05">some phone thing</a></p> - - <p><em>fugu</em></p> - </td> - <td>v1.2f (branch) <a href="https://groups.google.com/d/msg/mozilla.dev.b2g/JKAu9UNjBf8/9zj5Y3m6518J">per</a></td> - <td>320 x 480</td> - <td> </td> - <td> </td> - <td> </td> - <td>256MB</td> - <td> </td> - <td> </td> - <td> </td> - </tr> - <tr> - <td> - <p><a href="https://wiki.mozilla.org/FirefoxOS/Tarako">Spreadtrum SC6821</a></p> - - <p><em>tarako</em></p> - </td> - <td>v1.3 <a href="https://wiki.mozilla.org/FirefoxOS/Tarako">per</a></td> - <td>HVGA<br> - 320 x 480</td> - <td>3.5</td> - <td>Spreadtrum SC6821, Cortex A5 1GHz</td> - <td>0.3 (rear only?)</td> - <td>128MB (zram)</td> - <td>2GB NAND flash (external) + 1GB LPDDR1 (embedded)</td> - <td>32GB micro SD card</td> - <td>1100</td> - </tr> - <tr> - <td> - <p><a href="https://hacks.mozilla.org/2014/02/open-applications-tcp/">VIA Vixen</a></p> - - <p><em><a href="https://wiki.mozilla.org/Platform/2014-03-18">community-driven customization of flatfish</a>?</em></p> - </td> - <td> </td> - <td>1024 x 600</td> - <td>7</td> - <td>Cortex-A9 Dual Core 1.2 GHz</td> - <td> - <p>Front: 0.3 Rear: 2<br> - </p> - </td> - <td>1GB</td> - <td>8GB</td> - <td> </td> - <td> </td> - </tr> - <tr> - <td> - <p><a href="https://blog.mozilla.org/press/2014/02/developer-momentum-2/">Flame</a></p> - - <p><em>"the reference device"</em></p> - </td> - <td>v1.3</td> - <td> - <p>FWVGA<br> - 854 × 480<br> - PX=1.5<br> - </p> - </td> - <td>4.5 capacitive touch</td> - <td> - <p>Qualcomm Snapdragon 200 MSM8210, 1.2GHZ Dual core processor</p> - </td> - <td>Front: 2<br> - Rear: 5 auto focus with flash</td> - <td>256MB–1GB (adjustable by developer)</td> - <td>8GB</td> - <td>32GB micro SD card (USB 2.0)</td> - <td>1800</td> - </tr> - <tr> - <td><a href="https://developer.mozilla.org/en-US/Firefox_OS/Developer_phone_guide/ZTE_OPEN_C">ZTE Open C</a></td> - <td>v1.3</td> - <td> - <p>800 x 480 PX=1.5</p> - </td> - <td>4</td> - <td>Qualcomm Snapdragon 200 MSM8210, 1.2GHZ Dual core processor</td> - <td>arrière: 3</td> - <td>512MB</td> - <td>4GB</td> - <td> - <p>/data: 1G</p> - </td> - <td>1400</td> - </tr> - </tbody> -</table> - -<p>Column explanations:</p> - -<ul> - <li>Resolution: - <ul> - <li>horizontal x vertical</li> - <li>PX=1, PX=1.5, or PX=2 is the GAIA_DEV_PIXELS_PER_PX setting that should be used for the device</li> - </ul> - </li> - <li>Storage: - <ul> - <li>"/data" is the internal storage. This is where IndexedDB and other stuff lives. Storage is segregated on a per-app basis and is not USB storage accessible. Data is potentially accessible via adb depending on privileges.</li> - <li>DeviceStorage are the places where the <a href="/en-US/docs/WebAPI/Device_Storage">DeviceStorage API</a> can store things. Some devices may have internal storage (ex: leo), some devices may have external storage on MicroSD cards, some devices may support both (ex: leo). This storage is potentially accessible by all apps as well as the user via USB.</li> - <li>Values that don't look nice and round are as reported by "adb shell df" in the "size" column.</li> - </ul> - </li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx1/index.html b/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx1/index.html deleted file mode 100644 index 1891a02956..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx1/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Spice Fire One MI FX1 -slug: Archive/B2G_OS/Phone_guide/Spice_Fire_One_MI_FX1 -tags: - - Appareils Tarako - - Firefox OS - - Spice - - Téléphone -translation_of: Archive/B2G_OS/Phone_guide/Spice_Fire_One_MI_FX1 ---- -<div class="column-container"> -<div class="column-half"><img alt="Intex Cloud FX image from official website" src="https://mdn.mozillademos.org/files/10091/Spice%20MI%20FX%201.png" style="display: block; height: 454px; margin: 0px auto; width: 252px;"></div> - -<div class="column-half"> -<p>Le Spice Fire One MI FX1 est un smartphone Firefox OS, basé sur Firefox OS Tarako qui est distribué en Inde. Il a été commercialisé par Spice Smartphones en août 2014.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le téléphone n'est plus disponible actuellement.</p> - -<h3 id="Disponibilité">Disponibilité</h3> - -<p>Inde</p> - -<h2 id="Mise_à_jour_du_logiciel">Mise à jour du logiciel</h2> - -<p>L'image système de l'appareil est verrouillée. Il n'est possible de mettre à jour le logiciel que lorsque l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.3T.</p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver plus de détails sur les spécifications des appareils sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page des spécifications des téléphones et appareils</a>.</p> - -<ul> - <li><strong>CPU</strong> : 1 GHz</li> - <li><strong>Caméra </strong>: 1,3 mégapixels + caméra frontale VGA</li> - <li><strong>Batterie </strong>: 1400 mAh</li> - <li><strong>Affichage </strong>: 8,89 HVGA</li> - <li><strong>Résolution </strong>: <span id="lblSpec">320 x 480</span></li> - <li><strong>Mémoire interne </strong>: 256 Mo ROM, 128 Mo RAM </li> - <li><strong>Mémoire externe </strong>: microSD (4 Go max.)</li> - <li><strong>Dimensions </strong>: 115,6 x 62 x 11,2 mm</li> - <li><strong>Poids </strong>: Env. 104 g (avec la batterie)</li> -</ul> - -<h2 id="Coloris_disponibles">Coloris disponibles</h2> - -<ul> - <li>Noir</li> - <li>Blanc</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.spicesmartphones.com/spice-fire-one-Mi-FX1#tab-1">Informations officielles sur le Spice Fire MI FX1</a></li> - <li><a href="http://www.spicesmartphones.com/index.php?route=information/userguide/download&prod_id=249">Guide de l'utilisateur</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx2/index.html b/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx2/index.html deleted file mode 100644 index 06e9548148..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/spice_fire_one_mi_fx2/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Spice Fire One MI FX2 -slug: Archive/B2G_OS/Phone_guide/Spice_Fire_One_MI_FX2 -tags: - - B2G - - Firefox OS - - Téléphones -translation_of: Archive/B2G_OS/Phone_guide/Spice_Fire_One_MI_FX2 ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="https://adamlaskas24.files.wordpress.com/2015/06/spice-fire-one-mi-fx2-a68425a217d0.png" style="height: 350px; width: 210px;"></div> - -<div class="column-half"> -<p>Le Spice Fire One MI FX2 est un smartphone 3G haut de gamme, qui tourne sur FirefoxOS 1.4 avec appareil photo 2 mégapixels, mis en vente en Inde.</p> - -<h2 id="Obtenez_un_appareil">Obtenez un appareil</h2> - -<p>Vous pouvez l'acheter ici :</p> - -<ul> - <li><a href="http://www.ebay.in/itm/201363573431" rel="nofollow">Commander le Spice Fire One Mi-FX2 sur Ebay </a></li> - <li><a href="http://www.saholic.com/mobile-phones/spice-fire-one-mi-fx2-1012486" rel="nofollow">Commander le Spice Fire One Mi-FX2 sur Saholic </a></li> -</ul> - -<h3 id="Pays_où_il_est_disponible">Pays où il est disponible</h3> - -<ul> - <li>Inde</li> -</ul> - -<p> </p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">S<span id="result_box" lang="fr"><span class="hps">pécifications</span> <span class="hps">de l'appareil</span></span></h2> - -<p>Vous pouvez trouver plus de spécifications de l'appareil sur notre <a href="https://www.mozilla.org/en-US/firefox/os/devices/#spice_fireonemifx2">page de fonctionnalités et de caractéristiques.</a></p> - -<ul> - <li><strong>CPU </strong>: <span id="result_box" lang="fr"><span class="hps">processeur</span> <span class="hps">1Ghz</span></span></li> - <li><strong>Photo</strong> : 2.0 MP à l'arrière, 1.3 MP à l'avant</li> - <li><strong>Batterie </strong>: Li-Ion 1100 mAh</li> - <li><strong>Affichage </strong>: <span id="result_box" lang="fr"><span class="hps">3,5 Pouces</span> <span class="hps">HVGA</span> <span class="hps">Écran tactile</span></span></li> - <li><strong>Résolution de l'ecran </strong>: 3.5" HVGA 320 x 480 pixels</li> - <li><strong>Mémoire interne </strong>: 512MB ROM 256MB RAM</li> - <li><strong>Mémoire externe</strong> : <span id="result_box" lang="fr"><span class="hps">MicroSD</span> <span class="hps">jusqu'à 32 Go</span></span></li> - <li><strong>Dimension </strong>: 115.6x62x11.2 mm</li> - <li><strong>Réseaux </strong>: 3G/GPRS/EDGE GSM 900/1800 MHz</li> - <li><strong>Connectivité :</strong> Bluetooth v3.0 Wi-Fi</li> - <li><strong>Ports</strong> : <span id="result_box" lang="fr"><span class="hps">Micro</span> <span class="hps">USB 2.0 haute vitesse</span>, <span class="hps">jack</span> <span class="hps">de 3,5 mm, </span></span><span lang="fr"><span class="hps">casque stéréo</span></span></li> - <li><strong>Radio </strong>: <span id="result_box" lang="fr"><span class="hps">FM Stéréo</span></span></li> -</ul> - -<h2 id="Couleurs_Disponibles">Couleurs Disponibles</h2> - -<ul> - <li>Noir</li> - <li>Orange</li> - <li>Argent</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://www.youtube.com/watch?v=YCcH4BQEHPg">La vidéo officielle du Spice Fire One MI FX2</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/zen_u105_fire/index.html b/files/fr/archive/b2g_os/phone_guide/zen_u105_fire/index.html deleted file mode 100644 index 903b2775c0..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/zen_u105_fire/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Zen U105 Fire -slug: Archive/B2G_OS/Phone_guide/Zen_U105_Fire -tags: - - Client - - Firefox OS - - Téléphone - - Zen - - Zen u105 - - tarako -translation_of: Archive/B2G_OS/Phone_guide/Zen_U105_Fire ---- -<div class="column-container"> -<div class="column-half"><img alt="" src="http://www.zenmobile.in/uploaded_files/products-slider/1422960485_35.png"></div> - -<div class="column-half"> -<p><span>Le Zen U105 Fire est un smartphone premier prix sous Firefox OS Tarako avec un processeur cadencé à 1 GHz et un appareil photo de 2 MP</span>, disponible en Inde.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le téléphone est disponible ici au prix de 1999 INR :</p> - -<ul> - <li><a href="http://www.homeshop18.com/zen-firefox-os-phone-u105-fire/mobiles/mobile-phones/product:32873765/cid:3027/">Homeshop18</a></li> -</ul> - -<h3 id="Disponibilité">Disponibilité</h3> - -<p>Inde</p> -</div> -</div> - -<h2 id="Spécifications_de_l'appareil">Spécifications de l'appareil</h2> - -<p>Vous pouvez trouver davantage d'informations sur les spécifications de l'appareil sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page des spécifications des téléphones et appareils</a>.</p> - -<ul> - <li><strong>CPU </strong>: processeur Qualcomm Snapdragon 1 GHz</li> - <li><strong>Caméra </strong>: 2 mégapixels avec flash. Caméra frontale 0,3 mégapixels</li> - <li><strong>SIM</strong> : Dual-Sim</li> - <li><strong>Batterie </strong>: 1200 mAh</li> - <li><strong>Affichage </strong>: affichage TFT tactile HVGA 3,5 pouces</li> - <li><strong>Résolution </strong>: 320 x 480 pixels</li> - <li><strong>Mémoire interne </strong>: 256 Mo ROM, 128 Mo RAM</li> - <li><strong>Mémoire externe </strong>: microSDXC (16 Go max.)</li> - <li><strong>Dimensions </strong>: 117 x 62 x 10,7 mm</li> - <li><strong>Poids </strong>: Env. 320 g</li> -</ul> - -<h2 id="Coloris_disponible">Coloris disponible</h2> - -<ul> - <li>Noir</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.zenmobile.in/category-ultrafone/105-fire">Portail officiel d'informations sur le Zen U105 Fire</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/zte_open/index.html b/files/fr/archive/b2g_os/phone_guide/zte_open/index.html deleted file mode 100644 index 3670caaf7d..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/zte_open/index.html +++ /dev/null @@ -1,305 +0,0 @@ ---- -title: ZTE OPEN -slug: Archive/B2G_OS/Phone_guide/ZTE_OPEN -tags: - - Firefox OS - - Gaia - - Gecko - - Téléphone - - zte -translation_of: Archive/B2G_OS/Phone_guide/ZTE_OPEN ---- -<div class="summary"> -<p>Mozilla et ZTE sont partenaires. Ce partenariat a permis la création du ZTE OPEN, un puissant appareil basé sur Firefox OS, destiné aux développeurs et aux clients intéressés partout dans le monde. Ils ne sont pas verrouillés mais sont ouverts pour toute forme de tests et expérimentations.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Ces instructions <strong>ne</strong> sont <strong>pas </strong>valables pour l'appareil ZTE Open C. Si vous avez un ZTE Open C, vous devez vous rendre sur notre page consacrée au <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/ZTE_OPEN_C">ZTE Open C</a> à la place.</p> -</div> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Les ventes du ZTE Open sont arrivées à leur terme et il n'est donc plus disponible. Voir <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/ZTE_OPEN_C" style="font-style: italic;">ZTE Open C</a>.</p> - -<h2 id="Mise_à_jour_logicielle">Mise à jour logicielle</h2> - -<p>Cette section fournit les instructions pour mettre à jour Firefox OS sur votre appareil ZTE OPEN.</p> - -<h3 id="Généralités">Généralités</h3> - -<p>En général, les compilations Firefox OS, mises à jour et tests sont effectués en branchant le téléphone sur un ordinateur grâce à un câble USB et en utilisant ADB (Android Debugging Bridge) et Fastboot pour relier ensemble les périphériques et envoyer des commandes. Il faut donc installer ADB et fastboot sur votre ordinateur de bureau à partir du <a href="http://developer.android.com/sdk/index.html" title="Android Developer Tookit">kit de développement d'Android</a>. Il n'est pas nécessaire d'installer tout le kit. adb and fastboot se trouvent dans le dossier <code>/platform-tools/</code>.</p> - -<p>Ensuite, prenez votre téléphone et <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs#Débogage_via_USB">activer le débogage distant</a>.</p> - -<h3 id="Firefox_OS_1.1">Firefox OS 1.1</h3> - -<p>Le 10 décembre 2013 : ZTE a publié une mise à jour Firefox OS 1.1 pour le ZTE OPEN. <strong>Celle-ci dispose à présent de fastboot activé</strong>, ce qui a provoqué des problèmes avec les builds publiées auparavant.</p> - -<p>À ce stade, la meilleure chose à faire consiste à faire d'abord la mise à jour de votre téléphone en version 1.1, même si vous souhaitez avoir une version 1.2. Pour cela, téléchargez le paquet 1.1 qui correspond à votre téléphone (<a href="http://www.ztedevices.com/support/smart_phone/b5a2981a-1714-4ac7-89e1-630e93e220f8.html">OPEN (Norme américaine)</a> ou <a href="http://www.ztedevices.com/support/smart_phone/cba40ed6-d3ab-44c0-bdee-3a15803dc187.html">OPEN (Norme européenne)</a>). Notez que vous devez télécharger la version dont le numéro contient la révision de votre OS (autrement dit, téléchargez "V1.1.0B02(for V1.0)" si vous effectuez la mise à jour <em>à partir</em> d'une V1.0). Le fichier zip que vous obtiendrez contiendra aussi de la documentation concernant la mise à niveau. Décompressez-le et copiez le ZIP du firmware (intégré au zip téléchargé) comme décrit plus bas.</p> - -<div class="note"> -<p><strong>Note</strong> : Les données de l'utilisateur seront supprimées par l'installation du paquet de la carte SD. Il est conseillé de <a href="https://developer.mozilla.org/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Sauvegarde_de_la_partition_système_du_téléphone">sauvegarder vos données</a> avant de commencer.</p> -</div> - -<p>À présent, suivez ces étapes :</p> - -<ol> - <li>Éteignez votre téléphone, enlevez la batterie pour accéder à la carte microSD puis enlevez-la de son emplacement.</li> - <li>Insérez la carte microSD dans votre ordinateur de bureau.</li> - <li>Déplacez <strong>US_DEV_FFOS_V1.1.0B04_UNFUS_SD.zip</strong> ou <strong>EU_DEV_FFOS_V1.1.0B04_UNFUS_SD.zip</strong> (en fonction de la version que vous avez téléchargée) vers la racine de votre carte microSD. NE décompressez PAS le fichier.</li> - <li>Retirez la carte microSD de votre ordinateur de bureau et replacez-la dans votre téléphone.</li> - <li>Appuyez en même temps sur les boutons volume haut et power et maintenez-les enfoncés. Volume haut est activé en appuyant sur la partie supérieure du long bouton situé du côté gauche du téléphone. Si l'opération est correctement effectuée, vous entrerez dans le mode recovery de Firefox OS. (Note : le logo Firefox OS peut s'afficher brièvement avant d'entrer en mode recovery ; parfois, cela peut prendre un peu de temps.)</li> - <li>Utilisez les boutons volume haut/bas pour vous déplacer dans les options du menu, et choisissez “<strong>apply update from external storage</strong>.”</li> - <li>Appuyez sur le bouton power pour valider la sélection. Vous verrez apparaître un nouvel écran listant les fichiers présents sur la carte microSD.</li> - <li>De nouveau, utilisez les boutons volume haut/bas pour sélectionner le firmware : soit <strong>US_DEV_FFOS_V1.1.0B04_UNFUS_SD.zip</strong>, soit <strong>EU_DEV_FFOS_V1.1.0B04_UNFUS_SD.zip</strong> (selon la version téléchargée), puis pressez le bouton power pour confirmer.</li> -</ol> - -<p>Si tout se passe bien, des messages d'état vont s'afficher jusqu'à ce que l'un d'eux indique <em>“<strong>Install from sdcard complete</strong>.”</em>. Vous devez sélectionner “reboot system now” une fois l'installation terminée. Votre téléphone va ensuite redémarrer puis afficher l'écran de configuration que vous avez vu la première fois que vous avez allumé votre téléphone.</p> - -<h3 id="Firefox_OS_1.2">Firefox OS 1.2</h3> - -<p>En janvier 2014, ZTE a publié une version bêta de Firefox OS 1.2 (fastboot activé, avec accès root). Il s'agit globalement d'une version de base 1.1 + Gecko et Gaia en version 1.2, et ne nécessite pas de placer la version sur la carte SD du téléphone.</p> - -<p>Avec la version 1.1 installée comme décrit plus haut, ouvrez un terminal et vérifiez avec la commande suivante que la connexion est bien faite :</p> - -<pre class="brush: bash">adb devices -l -</pre> - -<p>En réponse, vous devriez voir votre appareil indiqué sous une forme ressemblant à ceci : "roamer2 device usb:2-1.2",.</p> - -<p>Téléchargez la version appropriée du build à partir du compte Dropbox que ZTE a mis en place : <a href="https://www.dropbox.com/sh/rnj3rja7gd54s98/32KXfFmedN/P752D04_DEV_US_20131212_v1.2.7z" title="Firefox OS 1.2 build for ZTE Open US">version US</a> ou <a href="https://www.dropbox.com/sh/rnj3rja7gd54s98/_twgXEkMFH/P752D04_DEV_EU_20131212_v1.2.7z" title="Firefox OS 1.2 build for ZTE Open UK">version UK</a>. Pour les utilisateurs de Windows, il est aussi possible de <a href="https://www.dropbox.com/sh/rnj3rja7gd54s98/6ZoJwmlRjn/Installation%20Instruction.docx" title="Special upgrade instructions for Windows users">télécharger des instructions particulières</a>, ainsi qu'<a href="https://www.dropbox.com/sh/rnj3rja7gd54s98/-fyi2XHFPG/upgrade_tool" title="Upgrade tool">un outil de mise à jour</a> pour vous faciliter l'installation de la nouvelle version. Néanmoins, les étapes ci-dessous fonctionneront sur <strong>tous les systèmes d'exploitation</strong> – Linux, OS X et Windows – sans s'appuyer sur cet outil spécifique.</p> - -<p>Une fois en possession du fichier, décompressez-le et ouvrez une console. Remarquez que ces étapes vont effacer vos données personnelles, assurez-vous d'en faire une (<a href="https://developer.mozilla.org/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS#Sauvegarde_de_la_partition_système_du_téléphone">sauvegarde</a>) avant. Placez-vous ensuite dans le dossier où se trouvent les fichiers. Toujours dans la console, tapez cette commande :</p> - -<pre class="brush: bash">adb reboot bootloader</pre> - -<p>Pendant que le téléphone redémarre, exécutez la commande suivante. (Fastboot ne fonctionne qu'en cours de redémarrage) :</p> - -<pre class="brush: bash">sudo fastboot devices -</pre> - -<p>Si vous voyez : "< waiting for device >", faîtes Ctrl-C et réessayez la commande jusqu'à voir apparaître en réponse quelque chose dans le genre : "ROAMER2 fastboot".</p> - -<p>Ensuite, toujours pendant qu'il est en train de redémarrer, exécutez rapidement les commandes suivantes :</p> - -<pre class="brush: bash">fastboot flash boot boot.img -fastboot flash userdata userdata.img -fastboot flash system system.img -fastboot flash recovery recovery.img -fastboot erase cache -fastboot reboot</pre> - -<div class="note"> -<p><strong>Note</strong> : Si vous rencontrez à chaque fois le message "waiting device". Essayez d'ajouter <strong>sudo</strong> devant les commandes, comme "sudo fastboot flash boot boot.img".</p> -</div> - -<p>(Ayant été distrait, le redémarrage s'est achevé avant que je n'ai pu saisir toutes les commandes. J'ai simplement recommencé à partir de: "adb reboot bootloader".)</p> - -<p>Si tout s'est bien passé, votre téléphone doit redémarrer en ce moment. Vous constaterez que cette version 1.2 de ZTE contient de nombreuses applications de test ; si vous le souhaitez, vous pouvez les enlever.</p> - -<div class="note"> -<p><strong>Note </strong>: <a href="https://hacks.mozilla.org/2014/01/upgrading-your-zte-open-to-firefox-1-1-or-1-2-fastboot-enabled/">Upgrading your ZTE Open to Firefox 1.1 or 1.2 (fastboot enabled)</a> de <span class="url">Frédéric Harper</span> fournit également des explications utiles sur le processus d'installation.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Le build 1.2 de ZTE pour l'Open comporte un bogue qui empêche de faire descendre/ouvrir la zone de notification. Cela peut être corrigé en flashant votre téléphone avec la dernière version engineering de Firefox OS 1.2. Vérifiez que <a href="/fr/Firefox_OS/Déboguer/Installer_ADB">ADB est installé</a> et que le <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs#Débogage_via_USB">débogage distant</a> est activé, lancez ensuite les commandes suivantes dans votre terminal :<br> - <br> - <code>git clone -b v1.2 <a href="https://github.com/mozilla-b2g/gaia.git" rel="nofollow">https://github.com/mozilla-b2g/gaia.git</a> gaia_v1.2<br> - cd gaia_v1.2<br> - make reset-gaia</code></p> -</div> - -<h3 id="Firefox_OS_1.3_et_suivants">Firefox OS 1.3 et suivants</h3> - -<p>À l'heure actuelle, ZTE n'a publié Firefox OS 1.3 que pour le ZTE Open commercialisé par Movistar (TME) ; ce sont les ZTE Open bleus. Le paquet se trouve sur leur <a href="http://www.ztedevice.com/support/selectproduct.html">site de support</a> ou peut être <a href="http://download.ztedevice.com/UpLoadFiles/product/550/3363/soft/2015030408423528.zip">téléchargé ici directement</a>.</p> - -<p> </p> - -<div class="note"> -<p><strong>Note</strong> : Les builds communautaires sont fournies <a href="http://forum.xda-developers.com/firefox-os/general/firefox-os-2-1-zte-1st-gen-modui-t2855235">ici </a>et <a href="http://unofficialopenrom.free.fr/">ici</a>.</p> -</div> - -<p>En ce qui concerne le ZTE Open d'ebay, ZTE n'a pas publié de builds pour Firefox OS 1.3 et suivants. Pour les obtenir sur votre ZTE open, vous aurez besoin de <a href="https://developer.mozilla.org/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">compiler et installer un nouveau build de Firefox OS/B2G</a> dessus manuellement (commencez par les instructions sur les <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">prérequis pour construire Firefox OS</a>, et traitez le ZTE comme s'il s'agissait d'un appareil Inari dans le but de le configurer). Vous pouvez restaurer votre téléphone si nécessaire en suivant la procédure décrite dans la section <a href="#J'ai_brické_mon_téléphone">J'ai brické mon téléphone</a>.</p> - -<h2 id="Caractéristiques_matérielles">Caractéristiques matérielles</h2> - -<p>Vous pouvez trouver une liste plus complète des caractéristiques matérielles sur notre <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/Phone_specs">page de spécifications des téléphones et appareils</a>.</p> - -<h3 id="Réseau">Réseau</h3> - -<ul> - <li>UMTS 850/1900 ou UMTS900/2100</li> - <li>GSM 850/900/1800/1900 (2G EDGE)</li> - <li>Wifi b/g/n</li> - <li>Bluetooth 2.1 EDR</li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: les téléphones de Hong Kong supportent aussi les réseaux 3G tri-bandes — HSDPA 850/1900/2100 (850/1900 pour les USA, Canada, 850/1900/2100 pour l'Asie, Australie et 900/2100 pour l'Europe.)</p> -</div> - -<h3 id="Matériel">Matériel</h3> - -<ul> - <li>CPU Qualcomm MSM7225A 1,0Ghz</li> - <li>Écran 3,5" HVGA</li> - <li>Caméra 2 MP (arrière)</li> - <li>256 Mo (RAM)</li> - <li>MicroSD (jusqu'à 32Go)</li> - <li>Batterie 1200 mAh</li> - <li>Capteurs de luminosité et de proximité, accéléromètre</li> - <li>Radio FM, GPS</li> - <li>MicroUSB</li> -</ul> - -<h2 id="Opérateurs_de_téléphonie">Opérateurs de téléphonie</h2> - -<div class="warning"> -<p>Les informations de tarifs sont données pour référence uniquement et peuvent ne pas être précises. Suivez le lien associé pour les informations officielles.</p> -</div> - -<h3 id="Opérateurs_US">Opérateurs US</h3> - -<h4 id="ATT">AT&T</h4> - -<ul> - <li><a href="http://www.att.com/shop/wireless.html">Site web</a></li> - <li>Couverture nationale en 2G EDGE et 3G</li> -</ul> - -<h5 id="Exemples_de_formules_prépayées_chez_ATT">Exemples de formules prépayées chez AT&T</h5> - -<p><a href="http://www.att.com/shop/wireless/gophone.html">GoPhone® prépayé</a>, offres smartphone</p> - -<ul> - <li>25$/mois, 5$/50Mo données 3G</li> - <li>60$/mois avec 2Go de données, 10$/Go supplémentaire de données 3G</li> -</ul> - -<h4 id="Aio">Aio</h4> - -<ul> - <li><a href="http://www.aiowireless.com/home.html">Site web</a></li> - <li>MVNO d'<a href="#AT&T">AT&T</a></li> -</ul> - -<h5 id="Exemples_de_formules_prépayées_chez_Aio">Exemples de formules prépayées chez Aio</h5> - -<ul> - <li>Aio Smart - 55$/mois avec 2Go de données 3G, 10$/Go supplémentaire de données 3G</li> - <li>Aio Pro - 70$/mois avec 7Go de données 3G, 10$/Go supplémentaire de données 3G</li> -</ul> - -<h4 id="Good2GO">Good2GO</h4> - -<ul> - <li><a href="https://us.good2gomobile.com/">Site web</a></li> - <li>MVNO d'<a href="#AT&T">AT&T</a></li> -</ul> - -<h5 id="Exemples_de_formules_prépayées_chez_Good2GO">Exemples de formules prépayées chez Good2GO</h5> - -<ul> - <li>50$/mois avec 1Go de données 3G, 20$/Go supplémentaire de données 3G</li> -</ul> - -<h4 id="Autres_MVNO_d'ATT">Autres MVNO d'<a href="#AT&T">AT&T</a></h4> - -<p>Ces opérateurs n'offrent pas de données 3G supplémentaires.</p> - -<ul> - <li><a href="http://goredpocket.com/">RedPocket</a></li> - <li><a href="http://www.net10wireless.com/">Net10</a></li> - <li><a href="http://www.straighttalk.com/">Straight Talk</a></li> - <li><a href="https://www.airvoicewireless.com/">Airvoice</a></li> -</ul> - -<h4 id="T-Mobile">T-Mobile</h4> - -<ul> - <li><a href="http://www.t-mobile.com/">Site web</a></li> - <li>Couverture nationale en 2G EDGE, couverture 3G limitée aux métropoles</li> -</ul> - -<h3 id="Opérateurs_canadiens">Opérateurs canadiens</h3> - -<p>La version US du ZTE Open fonctionne également au Canada avec les opérateurs qui utilisent les réseaux Bell/Telus ou Rogers. Certains opérateurs régionaux comme Sasktel ou MTS qui utilisent UMTS devraient fonctionner eux aussi.</p> - -<p>Il ne fonctionnera pas avec les opérateurs qui n'utilisent pas UMTS ou GSM, comme Public Mobile, ni avec ceux qui utilisent la bande de fréquences AWS comme WIND Mobile, Mobilicity, Videotron ou Eastlink.</p> - -<h2 id="Carte_mémoire">Carte mémoire</h2> - -<h3 id="Système_de_fichiers">Système de fichiers</h3> - -<p>Afin d'être reconnue par le téléphone, la carte MicroSD doit être formatée avec le système de fichiers FAT32. Si la carte est neuve ou n'a jamais été reformatée, elle devrait fonctionner telle quelle.</p> - -<h2 id="Révisions_matérielles">Révisions matérielles</h2> - -<h3 id="Révision_01">Révision 01</h3> - -<p>Les téléphones produits avant le 27/09/2013 ne disposent pas de fastboot et doivent être mis à jour. Normalement, cela devrait se faire via les Mises à jour logicielles mais certains utilisateurs ont signalé avoir eu des problèmes avec cette méthode. C'est pourquoi ZTE a mis à disposition des paquets pour carte SD permettant d'activer fastboot sur ces premières versions d'appareils. Images à flasher sur :</p> - -<ul> - <li><a href="http://www.ztedevices.com/support/smart_phone/b5a2981a-1714-4ac7-89e1-630e93e220f8.html">Téléphones achetés dans les boutiques eBay US/Hong Kong de ZTE</a></li> - <li><a href="http://www.ztedevices.com/support/smart_phone/cba40ed6-d3ab-44c0-bdee-3a15803dc187.html">Téléphones achetés dans la boutique eBay UK de ZTE</a></li> -</ul> - -<p>Le lien vers le fichier zip se trouve sous Downloads. Notez qu'il faut télécharger la version contenant votre révision d'OS (autrement dit, téléchargez "V1.1.0B02(for V1.0)" si vous faîtes la mise à jour <em>depuis</em> la V1.0). Une fois le fichier téléchargé et décompressé, suivez les instructions du PDF qu'il contient pour flasher le paquet sur votre téléphone.</p> - -<p>Questions relatives sur le Forum de Support :</p> - -<ul> - <li><a href="https://support.mozilla.org/en-US/questions/971252">La mise à jour du ZTE Open plante</a></li> - <li><a href="https://support.mozilla.org/en-US/questions/967817">Pourquoi n'est-il pas possible de mettre Firefox OS à jour sur mon ZTE Open ?</a></li> - <li><a href="https://support.mozilla.org/en-US/questions/976414?page=3">Comment puis-je débricker mon ZTE Open avec le débogage adb désactivé ?</a></li> -</ul> - -<h3 id="Révision_02">Révision 02</h3> - -<p>Fastboot est activé par défaut sur les téléphones produits à partir du 27/09/2013. <strong>Cela inclut les téléphones de Hong Kong.</strong></p> - -<div class="note"> -<p><strong>Note</strong> : Si vous n'êtes pas sûr de la révision de votre téléphone, vérifiez-la dans <strong>Paramètres > Information > Logiciel</strong>. Si elle est plus ancienne que celles dont les numéros de versions suivent, il vous faudra mettre à jour votre téléphone avec les paquets SD précités pour activer fastboot.</p> - -<ul> - <li>Téléphones de la boutique UK：OPEN_EU_DEV_FFOS_V1.0.0B02</li> - <li>Téléphones de la boutique US：OPEN_US_DEV_FFOS_V1.0.0B02 <em>(Certains téléphones peuvent afficher cette version par erreur, voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=916098#c39">bogue 916098</a>.)</em></li> -</ul> -</div> - -<h2 id="Support_pour_l'appareil">Support pour l'appareil</h2> - -<p>Une fois que votre téléphone dispose de <a href="#Révisions_matérielles">fastboot activé</a>, vous serez alors en mesure de <a href="https://developer.mozilla.org/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">compiler et installer de nouveaux builds Firefox OS/B2G</a> dessus (commencez par les instructions sur les <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">prérequis pour la construction</a> et traitez le ZTE comme un appareil Inari dans le but de le configurer), et restaurez votre téléphone si nécessaire en utilisant la procédure citée dans la section <a href="#J'ai_brické_mon_téléphone">J'ai brické mon téléphone</a>.</p> - -<p>Si vous rencontrez des erreurs concernant le réglage de l'heure système lors du flashage d'un build personnalisé, vous devrez peut-être télécharger une <a href="http://sl.edujose.org/2013/10/adapted-boot-image-for-use-with-b2g.html">image de démarrage modifiée</a>.</p> - -<h3 id="J'ai_brické_mon_téléphone">J'ai brické mon téléphone</h3> - -<p>Si vous êtes dans un processus de modification de votre téléphone et que celui-ci se retrouve “sans réaction”, vous devriez être en mesure de le restaurer grâce à fastboot en suivant cette procédure simple.</p> - -<p>Tout d'abord, débranchez le câble USB puis enlevez la batterie du téléphone l'espace de 30 secondes. Ensuite, replacez la batterie et appuyez sur le bouton volume haut tout en maintenant enfoncé le bouton power pendant quelques secondes. Rebranchez alors le câble USB et exécutez les commandes suivantes dans une fenêtre de terminal après vous être placé dans le répertoire qui contient les fichiers des paquets SD décrits plus haut (il est toujours utile de vérifier au préalable s'il existe une mise à jour de ces fichiers) :</p> - -<pre class="brush: bash" lang="bash">fastboot flash recovery recovery.img -fastboot flash boot boot.img -fastboot flash userdata userdata.img -fastboot flash system system.img -fastboot reboot -</pre> - -<p>Ce processus devrait restaurer votre téléphone. Si cela semble ne pas fonctionner, il faudra essayer une seconde fois.</p> - -<h3 id="Les_écouteurs_ne_fonctionnent_pas">Les écouteurs ne fonctionnent pas ?</h3> - -<p>Nous avons découvert que la prise jack des écouteurs est conçue par un fabricant chinois qui a des problèmes de compatibilité avec d'autres marques d'écouteurs intégrant des microphones. Il peut y avoir des problèmes d'absence de son lorsque vous essayez d'utiliser des écouteurs de marques Apple, Samsung, HTC et autres. Vous pouvez acheter un adaptateur pour écouteurs de 3,5 mm qui inverse les broches du microphone et de masse pour éviter ce problème. Pour plus d'informations, voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=812607" title="[Unagi] No microphone output through headphones when connected to a call">bug 812607</a>.</p> - -<h3 id="Autres_notes_concernant_le_support">Autres notes concernant le support</h3> - -<p>Certains clients ont signalé avoir rencontré un problème avec des mises à jour FOTA qui ne parviennent pas à activer fastboot ; des recherches sont toujours et nous accompagnons ZTE pour analyser tout scénario. Nous posterons plus d'informations dès qu'il y en aura.</p> - -<p>Si votre téléphone a malencontreusement été endommagé au cours de la mise à jour FOTA parce que ZTE a fourni des fichiers de mise à jour incorrects ou avec des erreurs, vous pouvez essayer de le restaurer à sa configuration d'usine avec l'image SD appropriée et les instructions indiquées dans <a href="#Révision_01">Révision 01</a>. Sinon, retournez votre téléphone à la boutique eBay où vous l'avez acheté pour en obtenir un nouveau en échange. Vous pouvez contacter le propriétaire de la boutique directement via un message eBay.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://marketplace.firefox.com/developers/dev_phone">Page officielle du téléphone développeur sur le Firefox Marketplace</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/phone_guide/zte_open_c/index.html b/files/fr/archive/b2g_os/phone_guide/zte_open_c/index.html deleted file mode 100644 index 142d406b51..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/zte_open_c/index.html +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: ZTE OPEN C -slug: Archive/B2G_OS/Phone_guide/ZTE_OPEN_C -tags: - - Appareil - - Firefox OS - - Gaia - - Guide - - Open C - - Smartphone - - Téléphone - - zte -translation_of: Archive/B2G_OS/Phone_guide/ZTE_OPEN_C ---- -<div class="summary"> -<p>Le ZTE Open C est un smartphone de la marque ZTE fonctionnant sous Firefox OS. Il intègre un appareil photo de 2 Mpx et un écran 4 pouces de 480 x 800 pixels, offrant une densité de pixels de 233ppp. Il est fourni avec Firefox OS 1.3 préinstallé. Cet article fournit des informations concernant ce smartphone, ses mises à jour et les détails pour le dépannage. </p> -</div> - -<div class="note"> -<p><strong>Note</strong>: Cet article <strong>n'est</strong> <strong>pas</strong> applicable au téléphone ZTE Open. Vous devriez plutôt consulter notre page dédiée au <a href="/en-US/Firefox_OS/Developer_phone_guide/ZTE_OPEN">ZTE Open</a> si vous possédez ce modèle.</p> -</div> - -<p><a href="https://commons.wikimedia.org/wiki/File:Open_C_night_blue_multiview01.jpg"><img alt="Open C blue nuit" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Open_C_night_blue_multiview01.jpg" style="float: left; height: 720px; width: 1280px;"></a></p> - -<p> </p> - -<p>Le ZTE Open C est le premier téléphone grand public vendu avec Firefox OS 1.3, <a href="https://blog.mozilla.org/press-fr/2014/05/08/firefox-os-senrichit-pour-prendre-en-charge-le-dual-sim-optimiser-lexperience-musicale-et-ameliorer-la-qualite-des-jeux-video/">la dernière version de Firefox OS</a>. Celle-ci présente de nombreuses nouvelles caractéristiques comme le contrôle du lecteur de musique directement depuis l'écran de verrouillage ou la barre de notifications, mais aussi le partage Bluetooth avancé, permettant de transférer plusieurs fichiers simultanément. L'utilisateur peut à présent naviguer plus rapidement dans l'interface grâce aux "smart folders" (dossiers intelligents) qui classent automatiquement les applications et les sites de recherche en catégories. La fluidité de défilement et la vitesse de lancement des applications du système ont également été améliorées (ex. calendrier, contacts, appareil photo).</p> - -<h2 id="Acheter_l'appareil">Acheter l'appareil</h2> - -<p>Ce téléphone est actuellement proposé en France par <a href="http://www.auchan.fr/zte-smartphone-open-c-bleu/p-c860284">Auchan</a> (pour un achat en ligne uniquement) au prix soldé de 29,90€ (au lieu de 59,99€).<span class="diff_sub"> </span></p> - -<ul> - <li>Les sites commerciaux qui le vendaient en ligne sont <a href="https://www.mozilla.org/fr/firefox/os/devices/">répertoriés sur le site de Mozilla</a> pour la France.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Les téléphones sont livrés sans aucune application ou service de connectivité d'opérateur téléphonique spécifique et sont déverrouillés pour tout opérateur en sortie de boîte.</p> -</div> - -<h2 id="sect1"> </h2> - -<h2 id="Caractéristiques">Caractéristiques</h2> - -<p>Voir <a href="https://developer.mozilla.org/fr-fr/Firefox_OS/Developer_phone_guide/Phone_specs">Caractéristiques des téléphones et appareils</a>.</p> - -<p> </p> - -<h2 id="Mise_à_jour_officielle">Mise à jour officielle</h2> - -<p>Pour mettre à jour le système de l'Open C avec une version officielle, la façon la plus simple est de vous référer à la notice que vous trouverez sur le <a href="http://www.ztefrance.com/assistance/">site d'assistance de ZTE France</a>. Pour ce faire, sélectionnez <strong>Open C</strong> dans la section "1 - MON PRODUIT", ensuite choisissez <strong>Notices</strong> en "2 - JE CHERCHE" et enfin vous trouverez la notice de mise à jour en "3 - RÉPONSES".</p> - -<p> </p> - -<h2 id="Mise_à_jour_communautaire">Mise à jour communautaire</h2> - -<p>Il est également possible de mettre à jour l'Open C en passant par une version communautaire. La communauté Mozilla Francophone publie ses propres builds, mettant à jour Gecko et Gaia. Pour se les procurer, il faut aller à <a href="http://builds.firefoxos.mozfr.org/doc/fr/devices/zte-open-c">cette adresse</a>.</p> - -<div class="note"> -<p>Il faudra au préalable rooter le téléphone, afin de bénéficier des mises à jour communautaires.</p> -</div> - -<h2 id="sect2"> </h2> - -<h2 id="Mise_à_jour_manuelle">Mise à jour "manuelle"</h2> - -<p>Si vous désirez mettre à jour Gecko et/ou Gaia vous-même, <span class="short_text" id="result_box" lang="fr"><span class="hps">le processus</span> <span class="hps">est</span> <span class="hps">un peu plus délicat</span></span>, car le téléphone est verrouillé par défaut (aucun privilège administrateur, "root" en anglais). Pour déverrouiller les privilèges d'administrateur sur votre téléphone (c'est à dire "rooter" l'appareil), vous devez suivre les instructions pour utiliser l'outil de mise à niveau que vous pouvez récupérer sur le <a href="http://www.ztefrance.com/assistance/">site d'assistance de ZTE France</a>.</p> - -<h3 id="Mettre_à_niveau_Gecko_et_Gaia">Mettre à niveau Gecko et Gaia</h3> - -<p>Une fois que votre téléphone permet le mode fastboot, vous allez pouvoir <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">compiler et installer Firefox OS/B2G</a>, les composants Gecko et Gaia sur celui-ci.</p> - -<div class="warning"> -<p><strong>ATTENTION</strong> : Avant toute manipulation de votre système, réalisez une <strong>sauvegarde de votre téléphone</strong> comme indique la dernière section, "Backup the phone system partition" de la page "Prérequis pour construire Firefox OS", en lien ci-dessous.</p> -</div> - -<ol> - <li>Commencez par les <a href="https://developer.mozilla.org/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">prérequis pour construire Firefox OS</a>, et faites comme si votre Open C était un téléphone Flame pour les configurations du <span id="result_box">système de construction</span> B2G. Il faut procéder ainsi car le Open C et le Flame sont tous les deux sur la même base système, un Android <a href="http://fr.wikipedia.org/wiki/Android_Jelly_Bean">Jelly Bean</a>, mais qu'il n'existe pas encore de dépôt/branche pour le Open C.</li> - <li>Pendant les étapes de configuration, vous allez devoir pointer vers un fichier de manifeste personnalisé (custom manifest file) .XML dédié au Open C. <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1016867">Lisez ce bug et/ou téléchargez la pièce jointe</a> et enregistrez-la sous le nom "openc.xml" dans un dossier facile à pointer (dans le dossier Téléchargements ou B2G par exemple).</li> - <li>Nettoyez le dossier B2G en supprimant les dossiers non désirés spécifiques au Flame : - <pre class="brush: bash" id="comment_text_2">rm -rf objdir-gecko/ out/ backup-flame/</pre> - </li> - <li><u>Facultatif :</u> Avant de poursuivre, vous pouvez, si vous le souhaitez, spécifier la version à compiler. Pour ce faire, éditez le fichier "openc.xml", et modifiez-y les révisions (revision) des projets <em>gecko.git, rilproxy, librecovery, fake-libdvm, gaia, gonk-misc</em>, et <em>moztt</em>. Par exemple, si vous souhaitez compiler la version 2.2, vous mettrez : - <pre class="brush: xml line-numbers language-xml"><code class="language-xml"><span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gecko.git<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gecko<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>mozillaorg<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>rilproxy<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>rilproxy<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>b2g<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>librecovery<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>librecovery<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>b2g<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>fake-libdvm<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>dalvik<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>b2g<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gaia<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gaia<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>mozillaorg<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gonk-misc<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>gonk-misc<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>b2g<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>project</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>moztt<span class="punctuation token">"</span></span> <span class="attr-name token">path</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>external/moztt<span class="punctuation token">"</span></span> <span class="attr-name token">remote</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>b2g<span class="punctuation token">"</span></span> <span class="attr-name token">revision</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>v2.2<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span></code></pre> - - <div class="warning"> - <p><strong>ATTENTION :</strong> Actuellement, le fait de compiler les versions 2.5 et supérieures <strong>empêche </strong>le fonctionnement du bluetooth.</p> - </div> - </li> - <li>Maintenant, configurez B2G en pointant vers le fichier "openc.xml" avec cette commande : - <pre class="brush: bash language-html">./config.sh flame /MON/DOSSIER/VERS/openc.xml</pre> - </li> - <li>Sur votre téléphone, vérifiez que <a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Developer_settings#Debugging_via_USB">Remote Debugging</a> soit activé (choisissez ADB dans Firefox OS 1.3 ou ADB et Devtools dans les versions ultérieures).</li> - <li>Connectez votre téléphone par USB à votre ordinateur et vérifiez qu'il soit reconnu par ADB : - <pre class="brush: bash language-html">adb devices</pre> - </li> - <li>Une fois le téléphone reconnu, vous pouvez construire le composant Gecko et l'installer sur votre téléphone en exécutant les commandes suivantes : - <pre class="brush: bash language-html">./build.sh gecko -./flash.sh gecko</pre> - </li> - <li>Maintenant, vous devriez mettre à niveau Gaia<em> </em>pour que sa version corresponde à la version de Gecko que vous venez d'installer sur votre téléphone : - <pre class="brush: bash language-html">cd gaia -make reset-gaia</pre> - </li> - <li>Pour terminer, il vous faut <a href="/fr/Firefox_OS/Guide_Telephone_Developpeur/ZTE_OPEN_C#Probl.C3.A8me_de_polices_(font)">ajouter les polices (fonts) manquantes</a>, afin d'obtenir un affichage correct sur votre téléphone.</li> -</ol> - -<div class="warning"> -<p><strong>ATTENTION :</strong> A partir de la version 2.2, un bug rend indisponible le stockage interne. Pour résoudre le problème, vous pouvez d'abord installer une <a href="http://builds.firefoxos.mozfr.org/doc/fr/devices/zte-open-c?redirect=1">version analogue des builds communautaires</a> ou vous référer à la démarche du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1105200">rapport de bug</a>.</p> -</div> - -<div class="warning"> -<p><strong>ATTENTION</strong> : Essayer d'installer une image système du Flame directement -sans suivre les dispositions précédentes- sur votre téléphone Open C, bloquera votre téléphone. Si vous n’êtes pas sûr de ce que vous faites, abstenez-vous.</p> -</div> - -<h3 id="Installer_votre_propre_version_de_Gaia">Installer votre propre version de Gaia</h3> - -<p>Pour mettre à niveau votre version modifiée de Gaia, en laissant de coté Gecko, vous aurez besoin de créer votre branche ("Fork") <em><span style="background-color: #ffffe0;">[ facultatif ? ]</span></em>, cloner le dépot Github de Gaia, pour ensuite le modifier et l'installer sur votre Open C.</p> - -<ol dir="ltr"> - <li>Vérifiez que vous avez <a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Installing_ADB">ADB</a> d'installé sur votre machine.</li> - <li>Allez sur <a href="https://github.com/mozilla-b2g/gaia">https://github.com/mozilla-b2g/gaia</a> et cliquez sur le bouton "Fork" en haut à droite pour créer une branche dans votre propre dépôt.</li> - <li>Clonez le code de votre branche depuis votre dépôt sur votre machine avec cette commande : - <pre class="brush: bash language-html">git clone https://github.com/VOTRE-PSEUDO-GITHUB/gaia.git</pre> - </li> - <li>Modifiez Gaia à votre convenance.</li> - <li>Ensuite, sur votre téléphone, vérifiez que <a href="https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Developer_settings#Debugging_via_USB">Remote Debugging</a> soit activé (cochez ADB pour Firefox OS 1.3 ou choisissez ADB et Devtools sur les versions ultérieures).</li> - <li>Connectez votre téléphone par USB à votre ordinateur et vérifiez qu'il soit reconnu par ADB : - <pre class="brush: bash language-html">adb devices -</pre> - </li> - <li>Enfin installez Gaia en lançant les commandes suivantes depuis le dossier B2G : - <pre class="brush: bash language-html">cd gaia -make reset-gaia</pre> - </li> -</ol> - -<h3 id="Problème_de_polices_(font)">Problème de polices (font)</h3> - -<p>Après avoir mis à jour Gecko/Gaia, il se peut que vous constatiez une incohérence entre les polices attendues par Gecko et Gaia, et celles fournies lors du flash. Pour corriger cela, téléchargez notre <a href="https://people.mozilla.org/%7Emwu/fira-font-update.zip">archive de mise à jour des polices (font)</a>, extrayez-la, placez-vous dans le répertoire créé par l'extraction et exécutez le script <code>flash.sh</code>.<br> - <br> - Vous pouvez également utiliser le script <a href="https://github.com/Mozilla-TWQA/B2G-flash-tool/blob/master/update_system_fonts.sh"><code>update_system_fonts.sh</code></a>, qui se chargera de télécharger et d'envoyer automatiquement les polices sur le téléphone.</p> - -<p> </p> - -<h2 id="J'ai_brické_mon_téléphone">J'ai "brické" mon téléphone</h2> - -<p>Si votre téléphone ne réagit plus, qu’il démarre en boucle ("bootloop" en anglais), ou qu’il bloque sur le logo Firefox OS ou l'animation du renard, votre téléphone est brické. Vous devriez être en mesure de le "débricker" en utilisant une archive de mise à jour officielle (voir la partie "Mettre à jour Firefox OS" plus haut) en la flashant via une carte SD, sur le site web ZTE:</p> - -<ul> - <li><a href="http://www.ztedevices.com/support/smart_phone/65229ec9-3165-424e-a7dd-3759356325fd.html?type=software">ZTE Open C (Ebay) - Spain</a></li> - <li><a href="http://www.ztedevices.com/support/smart_phone/92f36c98-9cc0-42d6-8f23-8834b4a6849c.html?type=software">ZTE Open C (Ebay) - UK American Standard</a></li> - <li><a href="http://www.ztedevices.com/support/smart_phone/46d40c52-bed4-4cdc-9df9-01719cdf0a70.html?type=software">ZTE Open C (Ebay) - UK European Standard</a></li> - <li><a href="http://www.ztefrance.com/assistance/">ZTE French Website - French</a></li> -</ul> - -<p>Vous pourrez aussi trouver des informations complémentaires en lisant <a href="https://support.mozilla.org/en-US/questions/1003136">ce sujet du site de support de Mozilla </a><a href="https://support.mozilla.org/en-US/questions/1003136">(en)</a>.</p> - -<p>Cependant, si votre partition système est défectueuse, il vous faudra réparer le téléphone en utilisant l'accès direct au fastboot. En supposant que vous utilisez Ubuntu GNU/Linux il vous faudra suivre les étapes suivantes :</p> - -<ol> - <li>Téléchargez <a href="http://download.ztedevice.com/UpLoadFiles/product/550/4443/soft/2014061214153128.zip">l'image de récupération système</a> à partir de la page support du site ZTE. Extrayez ensuite le fichier <code>update.zip</code> sur votre bureau (<code>~/Desktop/</code>).</li> - <li>Extrayez l'image de récupération <code>recovery.img</code> à partir de l'archive de mise à jour <code>update.zip</code> sur votre bureau.</li> - <li>Créez un dossier <code>small-system/ </code>sur le bureau et copiez-le dans le fichier <strong><code>build.prop</code></strong> ainsi que dans le répertoire <strong><code>bin/</code></strong>. Vous trouverez le dossier <code>system</code>. dans l'archive <code>update.zip</code>.</li> - <li>Installez le package <code>android-tools-fsutils</code> (ou installez <code><a href="http://forum.xda-developers.com/attachment.php?attachmentid=2431494&d=1386115975">ext4_utils</a></code> à partir des sources en suivant ce lien <a href="http://forum.xda-developers.com/galaxy-s2/general/ref-unpacking-repacking-stock-rom-img-t1081239">XDAdevelopers page</a>).</li> - <li>Créez votre <code>small-system.img</code>: - <pre class="brush: bash language-html"><code class="language-bash">./make_ext4fs -l 40M small-system.img ~/Desktop/small-system/</code></pre> - </li> - <li>Déplacez votre <code>small-system.img</code> sur le bureau et démarrez votre appareil en mode <em>fastboot</em> en pressant simultanément <em>bouton démarrer</em> + <em>bouton volume bas</em>.</li> - <li>Connectez l'appareil à votre ordinateur (<code>fastboot devices</code> cette commande devrait afficher l'appareil) et flash <code>small-system.img</code>: - <pre class="brush: bash language-html"><code class="language-bash">fastboot flash system small-system.img</code></pre> - </li> - <li>Démarrez ensuite en mode <em>récupération</em> en utilisant <code>recovery.img</code>: - <pre class="brush: bash language-html"><code class="language-bash">fastboot boot recovery.img</code></pre> - </li> - <li>Dans le menu de démarrage, sélectionnez <em>appliquer la mise à jour à partir des entrées ADB</em> (utilisez les boutons de réglages du volume pour naviguer, ainsi que le bouton démarrer pour sélectionner <em>select</em>), ensuite faites: - <pre class="brush: bash language-html"><code class="language-bash">adb sideload update.zip</code></pre> - </li> - <li> - <p class="brush: bash language-html">Une fois cela fait, redémarrez votre téléphone.</p> - </li> -</ol> - -<p class="brush: bash language-html"><strong>Note</strong>: Vous pouvez <a href="https://support.mozilla.org/en-US/questions/1003136">cliquer ici </a>pour plus d'informations.</p> diff --git a/files/fr/archive/b2g_os/phone_guide/zte_open_ii/index.html b/files/fr/archive/b2g_os/phone_guide/zte_open_ii/index.html deleted file mode 100644 index e6f9e35503..0000000000 --- a/files/fr/archive/b2g_os/phone_guide/zte_open_ii/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: ZTE Open II -slug: Archive/B2G_OS/Phone_guide/ZTE_Open_II -tags: - - Firefox OS - - Téléphone - - ZTE Open 2 - - ZTE Open II - - consommateur -translation_of: Archive/B2G_OS/Phone_guide/ZTE_Open_II ---- -<div class="column-container"> -<div class="column-half"><img alt="ZTE_Open_II_Device_Image" src="https://mdn.mozillademos.org/files/10293/zte-open2_a0ed84140bdf.png" style="height: 399px; width: 221px;"></div> - -<div class="column-half"> -<p>Le ZTE Open II <span>est un smartphone sous Firefox OS ; il dispose d'un processeur double-coeur à </span>1,2 GHz et d'une caméra 2,0 MP.</p> - -<h2 id="Acheter_un_appareil">Acheter un appareil</h2> - -<p>Le ZTE Open II est disponible via les canaux de distribution classiques ; voir par exemple <a href="http://catalogo.movistar.com.pe/zte-open-2">la page de Movistar</a>.</p> - -<h3 id="Disponibilité_par_pays">Disponibilité par pays</h3> - -<ul> - <li>Argentine</li> - <li>Colombie</li> - <li>Guatemala</li> - <li>Nicaragua</li> - <li>Panama</li> - <li>Pérou</li> - <li>Salvador</li> - <li>Uruguay</li> -</ul> - -<h3 id="Opérateurs">Opérateurs</h3> - -<ul class="comma-list"> - <li>Movistar</li> -</ul> -</div> -</div> - -<h2 id="Mise_à_jour_logicielle">Mise à jour logicielle</h2> - -<p>L'image système de l'appareil est verrouillée, si bien qu'il n'est possible de le mettre à jour que si l'opérateur téléphonique publie une mise à jour OTA. L'image système de l'appareil est basée sur Firefox OS 1.2.</p> - -<h2 id="Caractéristiques_matérielles">Caractéristiques matérielles</h2> - -<ul> - <li><strong>CPU</strong> : Qualcomm Snapdragon 200 MSM8210 double-coeur à 1,2 GHz</li> - <li><strong>GPU :</strong> Adreno 302</li> - <li><strong>Caméra</strong> : 2 mégapixels</li> - <li><strong>Batterie </strong>: 1150 mAh</li> - <li><strong>Affichage </strong>: HVGA 320 x 480 pixels 3,5"</li> - <li><strong>Résolution</strong> : 320 x 480 pixels</li> - <li><strong>Mémoire interne </strong>: 256 Mo, 2 Go de stockage interne</li> - <li><strong>Stockage externe :</strong> microSD, jusqu'à 32 Go</li> - <li><strong>Dimensions </strong>: 118 x 61 x 10,5 mm</li> - <li><strong>Poids :</strong> Env. 120 gr.</li> -</ul> - -<h2 id="Coloris_disponible">Coloris disponible</h2> - -<ul> - <li>Noir</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://catalogo.movistar.com.pe/zte-open-2">Page du ZTE Open II sur Movistar</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/platform/apps_architecture/index.html b/files/fr/archive/b2g_os/platform/apps_architecture/index.html deleted file mode 100644 index cb040b8422..0000000000 --- a/files/fr/archive/b2g_os/platform/apps_architecture/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Architecture des applications Firefox OS -slug: Archive/B2G_OS/Platform/Apps_architecture -tags: - - Applications - - Firefox OS - - Guide -translation_of: Archive/B2G_OS/Platform/Apps_architecture ---- -<div class="summary"> -<p>Cet article explique les fonctionnements internes du démarrage et de la gestion des applications dans Firefox OS. Ces informations seront utiles aux développeurs de la plate-forme Firefox OS, aussi bien qu'aux équipes portant le système d'exploitation sur un nouveau matériel. Ce n'est pas indispensable si vous êtes un développeur d'applications, mais cela pourrait quand même vous intéresser.</p> -</div> - -<h2 id="Processus_de_démarrage_d'une_application">Processus de démarrage d'une application</h2> - -<p>Quand l'utilisateur sélectionne une application qu'il aimerait lancer, ou qu'une application doit être lancée d'une autre manière, l'application écran d'accueil commence par récupérer une référence d'application depuis l'API <a href="/fr/docs/Web/API/App" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>App</code></a>, puis appelle la méthode <a href="/fr/docs/Web/API/App/launch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>App.launch()</code></a> pour lancer l'application.</p> - -<p>Gecko reçoit cette requête et envoie le <a href="/fr/docs/Web/API/MozChromeEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozChromeEvent</code></a> à l'application System avec les détails de l'application. L'application System traite cet événement en insérant un nouvel <a href="/fr/docs/Web/HTML/Element/iframe" title="Cet élément prend en charge les attributs universels."><code><iframe></code></a> dans son arborescence DOM et en chargeant l'application dans le nouvel <a href="/fr/docs/Web/HTML/Element/iframe" title="Cet élément prend en charge les attributs universels."><code><iframe></code></a>. Ce conteneur sera l'hébergeur de l'application jusqu'à ce qu'elle se termine.</p> - -<p>Chaque application a besoin d'un manifeste qui la décrit et possède une hiérarchie de fichiers spécifique au sein de son package. Pour plus de détails, voir l'article <a href="/en-US/docs/Web/Apps/App_Manifest">Manifeste d'application</a>.</p> - -<h2 id="Communication_avec_Gecko">Communication avec Gecko</h2> - -<p>La communication entre Gecko et l'application System Gaia est faite via <a href="/fr/docs/Web/API/MozChromeEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozChromeEvent</code></a> et <a href="/fr/docs/Web/API/MozContentEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozContentEvent</code></a>. Les événements <code>mozChromeEvent</code> sont diffusés depuis Chrome jusqu'au contenu et les événements<code> mozContentEvent</code> sont diffusés depuis le contenu jusqu'à Chrome. Cette communication est utilisée pour contrôler la création et la fermeture de l'interface de confiance et pour injecter les fonctions requises pour les notifications et autres tâches, incluant l'ordre pour l'application System, de démarrer une application.</p> - -<div class="note"> -<p><strong>Note:</strong> Vous trouverez plus d'informations sur le fonctionnement de ces événements en lisant notre <a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/System">documentation de l'application System</a>. Vous pouvez aussi en découvrir beaucoup plus en regardant le code de <code><a href="https://dxr.mozilla.org/mozilla-central/source/b2g/chrome/content/shell.js" rel="custom">b2g/chrome/content/shell.js</a></code>.</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/en-US/docs/Web/Apps">Applications</a></li> - <li><a href="/fr/docs/Web/API/App" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>App</code></a></li> - <li><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/System">Application System</a></li> - <li><a href="/en-US/Firefox_OS/Platform/Architecture">Architecture de Firefox OS</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/platform/architecture/index.html b/files/fr/archive/b2g_os/platform/architecture/index.html deleted file mode 100644 index c23c7bb25e..0000000000 --- a/files/fr/archive/b2g_os/platform/architecture/index.html +++ /dev/null @@ -1,722 +0,0 @@ ---- -title: Architecture de Firefox OS -slug: Archive/B2G_OS/Platform/Architecture -tags: - - Architecture - - Firefox OS - - Guide -translation_of: Archive/B2G_OS/Architecture ---- -<div class="summary"> -<p><span class="seoSummary">Cet article est une vue d'ensemble de l'architecture de la plate-forme Firefox OS, présentant les concepts clés et expliquant sommairement comment les composants interagissent.</span></p> -</div> - -<div class="note"> -<p><strong>Note:</strong> Gardez à l'esprit que Firefox OS est toujours un produit non finalisé ("Pre-release"). L'architecture décrite ici n'est pas forcément finalisée, et des changements peuvent survenir.</p> -</div> - -<h2 id="Terminologie_Firefox_OS">Terminologie Firefox OS</h2> - -<p>Voici quelques termes à connaître avant de lire la suite de notre documentation de Firefox OS.</p> - -<dl> - <dt>B2G</dt> - <dd>Acronyme de Boot to Gecko.</dd> - <dt>Boot to Gecko</dt> - <dd>Le nom de code du système d'exploitation Firefox OS lors de sa conception. Vous trouverez souvent ce terme en référence à Firefox OS, car il a été longtemps utilisé avant que le projet ait un nom officiel.</dd> - <dt>Firefox OS</dt> - <dd>Firefox OS correspond aux services de support et de branding de Mozilla (et ceux de ses partenaires OEM) ajoutés au-dessus de <strong>Boot to Gecko</strong>, pour créer un produit fini.</dd> - <dt><a href="/fr/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Gaia">Gaia</a></dt> - <dd>L'interface utilisateur de la plate-forme Firefox OS. Tout ce qui est affiché à l'écran une fois que Firefox OS est lancé, est produit par la couche Gaia. Gaia implémente l'écran de verrouillage, l'écran d'accueil et toutes les applications standards que vous attendez sur un smartphone moderne. Gaia est implémenté entièrement à l'aide de HTML, CSS et Javascript. Les seules interfaces avec le système d'exploitation sous-jacent se font au travers d'API Web libres, elles-mêmes implémentées par la couche Gecko. Les applications tierces peuvent être installées en parallèle de la couche Gaia.</dd> - <dt><a href="/fr/docs/Gecko" title="/en-US/docs/Accessibility/AT-APIs/Gecko">Gecko</a></dt> - <dd>C'est l'application permettant d'exécuter Firefox OS ; c'est-à-dire, la couche permettant le support des trois standards : HTML, CSS et Javascript. Il assure que chacune de ces technologies fonctionnent sur tous les systèmes d'exploitation supportés par Gecko. Cela signifie que Gecko inclut, entre autres, une pile réseau, une pile graphique, un<em> </em>moteur de présentation, une machine virtuelle JavaScript et des couches de portage.</dd> - <dt><a href="/fr/Firefox_OS/Platform/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Gonk">Gonk</a></dt> - <dd>Gonk représente la couche la plus basse du système d'exploitation de la plate-forme Firefox OS. Elle est composée d'un noyau Linux (basé sur l'<a href="http://source.android.com/">Android Open Source Project</a> (AOSP)) et une couche d'abstraction matérielle de l'espace utilisateur (HAL userspace). Le noyau et plusieurs bibliothèques en espace utilisateur font partie de projets open-source communs : Linux, libusb, bluez, et bien d'autres. D'autres parties de la HAL sont partagées avec l'AOSP : GPS, caméra et d'autres. Vous pouvez considérer Gonk comme une distribution Linux basique. Gonk est une <strong>cible de portage</strong> de Gecko, il y a un port de Gecko vers Gonk, tout comme il y a un port de Gecko vers OS X, Windows et Android. Vu que le projet Firefox OS a un contrôle total sur Gonk, nous pouvons exposer des objets à Gecko, qui ne peuvent être exposés sur d'autres systèmes d'exploitation. Par exemple, Gecko a un accès direct à la pile téléphonique complète et à l'affichage frame buffer sur Gonk, mais n'a pas ce type d'accès sur les autres systèmes d'exploitation.</dd> - <dt><a name="Jank">Jank</a></dt> - <dd>Ce terme est souvent utilisé dans l'univers du mobile, pour désigner une opération qui crée un effet de latence dans une application, qui bloque le rafraîchissement de l'interface, la fait laguer ou la rend inutilisable. Nos ingénieurs Gaia utilisent des techniques d'optimisation variées pour essayer d'éradiquer cette sensation à tout prix.</dd> -</dl> - -<h2 id="Architecture_générale">Architecture générale</h2> - -<p>Le schéma suivant compare les architectures de plate-formes propriétaires et de Firefox OS.</p> - -<p><img alt="on the left is a native mobile architecture stack, on the right is the Firefox OS architecture. they are similarm except that the native stack is all proprietary device functionality, and the Firefox OS stack is all done with open source and web technologies." src="https://mdn.mozillademos.org/files/9487/general-architecture.png" style="display: block; height: 488px; margin: 0px auto; width: 997px;"></p> - -<p>Firefox OS élimine la couche native de l'API entre le système d'exploitation et les couches applicatives. Ce design intégré réduit les couches au-dessus de la plate-forme et simplifie la sécurité sans sacrifier les performances ni l'expérience utilisateur.</p> - -<ol> - <li><a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Gaia">Gaia</a> est le noyau d'application web de l'appareil et la couche de l'interface utilisateur, en HMTL5, CSS et JavaScript, a<span id="result_box" lang="fr"><span class="hps">vec un certain nombre d'API</span> <span class="hps">exposées</span> <span class="hps">pour permettre</span> <span class="hps">le code</span> <span class="hps">de l'interface utilisateur</span> <span class="hps">d'interagir avec le</span> <span class="hps">matériel du téléphone</span> <span class="hps">et de fonctionnalité</span> de <span class="hps">Gecko</span><span>.</span></span></li> - <li><a href="https://developer.mozilla.org/fr/docs/Gecko">Gecko</a> <span id="result_box" lang="fr"><span class="hps">est le</span> <span class="hps">moteur Web</span> <span class="hps">et la couche</span> <span class="hps">de présentation</span> <span class="hps">dans Firefox</span> <span class="hps">OS</span> <span class="hps">qui relie</span> le <span class="hps">matériel avec le</span> <span class="hps">HTML,</span> <span class="hps">en se servant de</span> <span class="hps">l'interface</span> <span class="hps">entre le contenu</span> <span class="hps">Web et le</span> <span class="hps">périphérique sous-jacent</span><span>.</span> <span class="hps">Gecko</span> <span class="hps">fournit une</span> <span class="hps">analyse</span> <span class="hps">HTML5 et</span> <span class="hps">un moteur de rendu</span><span>,</span> <span class="hps">l'accès</span> <span class="hps">programmatique</span> <span class="hps">à la fonctionnalité</span> <span class="hps">du matériel</span> <span class="hps">via des APIs</span> <span class="hps">Web</span> <span class="hps">sécurisés</span><span>,</span> <span class="hps">une infrastructure de sécurité intelligente</span><span>, la gestion</span> <span class="hps">de mise à jour</span><span>,</span> <span class="hps">et d'autres</span> <span class="hps">services de base</span><span>.</span></span></li> - <li><a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Gonk">Gonk</a> <span id="result_box" lang="fr"><span class="hps">est</span> <span class="hps">la composante au</span> <span class="hps">niveau du noyau</span> <span class="hps">dans la pile</span> <span class="hps">de Firefox</span> <span class="hps">OS qui</span> <span class="hps">sert d'interface</span> <span class="hps">entre</span> <span class="hps">Gecko et le</span> <span class="hps">matériel </span></span><span lang="fr"><span class="hps">sous-jacent.</span> <span class="hps">Gonk</span> <span class="hps">contrôle le matériel</span> <span class="hps">sous-jacent et</span> <span class="hps">expose</span> les <span class="hps">capacités matérielles</span> <span class="hps">aux API</span> <span class="hps">Web</span> <span class="hps">mis en œuvre dans</span> <span class="hps">Gecko</span><span>.</span> <span class="hps">Gonk</span> <span class="hps">peut</span> <span class="hps">être considéré comme la</span> <span class="hps">«boîte noire»</span> <span class="hps">qui fait tout le</span> <span class="hps">travail complexe et</span> <span class="hps">détaillé</span> <span class="hps">dans les coulisses pour</span> <span class="hps">contrôler</span> <span class="hps">l'appareil mobile</span> <span class="hps">en adoptant</span> <span class="hps">la demande au</span> <span class="hps">niveau du matériel.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Le dispositif</span> <span class="hps">mobile est le</span> <span class="hps">matériel du téléphone</span> <span class="hps">fonctionnant</span> avec <span class="hps">Firefox</span> <span class="hps">OS</span><span>.</span> <span class="atn hps">L'</span><span>OEM</span> <span class="hps">est responsable de fournir</span> <span class="hps">l'appareil mobile</span><span>.</span></span></li> -</ol> - -<p> </p> - -<h2 id="L'architecture_spécifique_de_Firefox_OS">L'architecture spécifique de Firefox OS</h2> - -<p><img alt="Firefox OS Architecture" src="/files/4605/FirefoxOS.png" style="display: block; height: 915px; margin: 0px auto; width: 754px;"></p> - -<h2 id="Déroulement_du_chargement_de_Firefox_OS">Déroulement du chargement de Firefox OS</h2> - -<p>Cette section décrit le processus suivi lors de l'amorçage d'un matériel sous Firefox OS, quelles parties sont impliquées et où. Pour visualiser rapidement, le schéma d'amorçage général du système passe par le chargeur de boot dans l'espace noyau, à l'init du code natif, au B2G puis au tour de Gecko dans l'espace utilisateur, pour terminer par le système d'applications, le gestionnaire de fenêtres et enfin l'application d'accueil de Gecko. Toutes les autres applications vont venir s'appuyer là-dessus.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7491/bootup.png" style="display: block; height: 1979px; margin: 0px auto; width: 2112px;"></p> - -<h3 id="Le_processus_d'amorçage">Le processus d'amorçage</h3> - -<p>Quand un appareil Firefox OS est allumé, l'exécution commence dans le premier chargeur d'amorçage. A partir de là, le processus de chargement du système d'exploitation principal se déroule d'une manière commune : une succession de chargeurs d'amorçage de niveaux de plus en plus hauts amorcent le chargeur suivant de la chaîne. A la fin du processus, l'exécution est transférée au noyau Linux.</p> - -<p>Il y a plusieurs points à souligner à propos du processus d'amorçage :</p> - -<ul> - <li>Les chargeurs d'amorçage affichent souvent le premier écran d'accueil visualisé par l'utilisateur pendant le démarrage de l'appareil : habituellement c'est un logo marchand.</li> - <li>Les chargeurs d'amorçage implémentent la projection d'une image sur l'appareil. Des appareils différents utilisent des protocoles différents ; la plupart des téléphones utilisent le <a href="http://android-dls.com/wiki/index.php?title=Fastboot" title="http://android-dls.com/wiki/index.php?title=Fastboot">protocole fastboot</a>, mais le Samsung Galaxy S II utilise le protocole odin.</li> - <li>Vers la fin du processus d'amorçage, l'image du modem est la plupart du temps chargée et s'exécute sur le processeur du modem. La façon dont cela se produit est très spécifique à l'appareil et peut être propriétaire.</li> -</ul> - -<h3 id="Le_noyau_Linux">Le noyau Linux</h3> - -<p>Le noyau Linux utilisé par Gonk est très similaire au <u><strong>upstream </strong></u>Linux duquel il dérive (basé sur un <a href="http://source.android.com/" title="http://source.android.com/">projet Android Open Source</a>). Il y a quelques changements réalisés par l'AOSP qui n'ont pas encore été <u><strong>upstreamed</strong></u>. De plus, les marchands modifient parfois le noyau et upstream ces changements dans leur propre programme. En général, cependant, le noyau Linux et proche du <u><strong>stock.</strong></u></p> - -<p>Le <a href="http://en.wikipedia.org/wiki/Linux_startup_process" title="http://en.wikipedia.org/wiki/Linux_startup_process">processus de démarrage pour Linux</a> est bien documenté ailleurs sur Internet et cet article ne couvrira donc pas ce point.</p> - -<p>Le noyau Linux (ou kernel) va soulever des appareils et exécuter des processus essentiels. Il va exécuter des processus définis dans <code>init.rc</code> et le successeur <a href="https://github.com/mozilla-b2g/gonk-misc/blob/master/init.b2g.rc">init.b2g.rc</a> pour amorcer les processus essentiels comme <code>b2g</code> (le processus de base de FirefoxOS, qui contient Gecko) et <code>rild</code> (les processus relatifs à la téléphonie qui peuvent être propriétaires par différents jeux de puces) — voir ci-dessous pour plus de détails. A la fin du processus, un processus d'espace utilisateur <code>init</code> est lancé, comme dans la plupart des systèmes d'exploitation similaires à UNIX.</p> - -<p>Dès que le processus <code>init</code> est lancé, le noyau Linux gère les appels système de l'espace utilisateur, et interrompt, et ainsi de suite les dispositifs matériels. Beaucoup de fonctions matérielles sont exposées à l'espace utilisateur au travers de <a href="http://en.wikipedia.org/wiki/Sysfs" title="http://en.wikipedia.org/wiki/Sysfs"><code>sysfs</code></a>. Par exemple, voici un <a href="https://github.com/cgjones/mozilla-central/blob/master/hal/gonk/GonkHal.cpp#L277" title="https://github.com/cgjones/mozilla-central/blob/master/hal/gonk/GonkHal.cpp#L277">bout de code</a> qui lit l'état de la batterie dans Gecko:</p> - -<pre class="brush:cpp;"><code class="language-cpp">FILE <span class="operator token">*</span>capacityFile <span class="operator token">=</span> <span class="function token">fopen<span class="punctuation token">(</span></span><span class="string token">"/sys/class/power_supply/battery/capacity"</span><span class="punctuation token">,</span> <span class="string token">"r"</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -double capacity <span class="operator token">=</span> dom<span class="punctuation token">:</span><span class="punctuation token">:</span>battery<span class="punctuation token">:</span><span class="punctuation token">:</span>kDefaultLevel <span class="operator token">*</span> <span class="number token">100</span><span class="punctuation token">;</span> -<span class="keyword token">if</span> <span class="punctuation token">(</span>capacityFile<span class="punctuation token">)</span> <span class="punctuation token">{</span> - <span class="function token">fscanf<span class="punctuation token">(</span></span>capacityFile<span class="punctuation token">,</span> <span class="string token">"%lf"</span><span class="punctuation token">,</span> <span class="operator token">&</span>capacity<span class="punctuation token">)</span><span class="punctuation token">;</span> - <span class="function token">fclose<span class="punctuation token">(</span></span>capacityFile<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="punctuation token">}</span></code></pre> - -<h3 id="En_savoir_plus_sur_le_processus_init">En savoir plus sur le processus init</h3> - -<p>Le processus <code>init</code> dans Gonk gère le montage des fichiers système requis et engendre les services système. Après, il reste autour pour servir de gestionnaire de processus. Ceci est assez similaire au init des autres systèmes d'exploitation ressemblant à UNIX. Il interprète des scripts (c'est-à-dire, les fichiers <code>init*.rc</code>) qui consistent en des commandes décrivant ce qui devrait être réalisé pour démarrer des services. Le <code>init.rc</code> de Firefox OS est habituellement le <u><strong>stock </strong></u><code>init.rc</code> d'Android pour l'appareil patché pour inclure les éléments nécessaires à la relance de Firefox OS. Il varie toutefois selon les appareils.</p> - -<p>Une tâche clé que gère le processus <code>init</code> est le démarrage du processus <code>b2g</code> ; c'est le c<span style="background: transparent;">œ</span>ur du système d'exploitation Firefox OS.</p> - -<p>Le code de <code>init.rc</code> qui démarre ceci ressemble à :</p> - -<pre>service b2g /system/bin/b2g.sh - class main - onrestart restart media</pre> - -<div class="note"> -<p><strong>Note :</strong> Savoir exactement à quel point <code>init.rc</code> diffère de la version Android varie selon les appareils ; parfois, <code>init.b2g.rc</code> est simplement ajouté; parfois les patchs sont plus significatifs.</p> -</div> - -<h2 id="L'architecture_des_processus_de_l'espace_utilisateur">L'architecture des processus de l'espace utilisateur</h2> - -<p>A présent, il est utile d'avoir un regard de plus haut niveau sur la manière dont les composants multiples de Firefox OS s'imbriquent et interagissent entre eux. Le diagramme ci-dessous montre le principal processus de l'espace utilisateur de Firefox OS.</p> - -<p><a href="/files/3849/B2G userspace architecture.svg"><img alt="Userspace diagram" src="/files/3849/B2G%20userspace%20architecture.svg" style="float: right; height: 491px; position: relative; width: 520px;"></a></p> - -<div class="note"> -<p><strong>Note :</strong> Gardez à l'esprit que depuis que Firefox OS est développé activement, le diagramme est susceptible de changer et pourrait ne pas être complètement exact.</p> -</div> - -<p>Le processus <code>b2g</code> est le principal processus système. Il s'exécute avec de hauts privilèges ; il a accès à la plupart des matériels de l'appareil. <code>b2g</code> communique avec le modem, dessine le <strong><u>framebuffer </u></strong>affiché et échange avec les GPS, l'appareil photo et d'autres fonctions matérielles. De manière interne, <code>b2g</code> exécute la couche Gecko (implémentée par <code>libxul.so</code>). Voir <a href="#Gecko">Gecko</a> pour plus de détails sur la manière dont fonctionne la couche Gecko et comment <code>b2g</code> communique avec elle.</p> - -<h3 id="b2g">b2g</h3> - -<p>Le processus <code>b2g</code> peut à son tour déclencher un certain nombre de <strong>processus content </strong>à faibles privilèges. Ces processus sont l'endroit où les applications web et autres contenus web sont chargés. Ces processus communiquent avec le processus serveur principal Gecko avec le protocole <a href="/en-US/docs/IPDL" title="/en-US/docs/IPDL">IPDL</a>, un système de transmission de messages.</p> - -<p>Le processus <code>b2g</code> exécute libxul, qui référence <code>b2g/app/b2g.js</code> pour obtenir les préférences par défaut. Avec ces préférences, il va ouvrir le ficher HTML <code>b2g/chrome/content/shell.html</code>, qui est compilé dans le fichier <code>omni.ja</code>.. <code>shell.html</code> inclut le fichier <code>b2g/chrome/content/shell.js</code>, qui déclenche l'application <code>system</code> de Gaia.</p> - -<h3 id="rild">rild</h3> - -<p>Le processus <code>rild</code> est l'interface du processeur du modem. <code>rild</code> est le démon qui implémente la couche de l'interface radio (<strong>Radio Interface Layer</strong> ou RIL). C'est un morceau de code propriétaire qui est implémenté par le fournisseur de matériel pour échanger avec le modem matériel. <code>rild</code> permet au code client de se connecter avec un socket UNIX auquel il se lie. Il commence par le code suivant dans le script d'<code>init</code> :</p> - -<pre>service ril-daemon /system/bin/rild - socket rild stream 660 root radio</pre> - -<h3 id="rilproxy">rilproxy</h3> - -<p>Dans Firefox OS, le client <code>rild</code> est le processus <code>rilproxy</code>. Il agit comme un simple proxy de transfert d'information entre <code>rild</code> et <code>b2g</code>. Ce proxy est nécessaire comme un détail d'implémentation ; il suffit de dire qu'il est en effet nécessaire. Le <a href="https://github.com/mozilla-b2g/rilproxy" title="https://github.com/mozilla-b2g/rilproxy">code<code> rilproxy</code> </a>est accessible sur GitHub.</p> - -<h3 id="mediaserver">mediaserver</h3> - -<p>Le processus <a href="https://github.com/android/platform_frameworks_base/tree/ics-mr0-release/media/libmediaplayerservice" title="https://github.com/android/platform_frameworks_base/tree/ics-mr0-release/media/libmediaplayerservice"><code>mediaserver</code></a> contrôle la lecture de l'audio et de la vidéo. Gecko échange avec lui à travers un mécanisme Android de Remote Procedure Call (RPC). Une partie des médias que Gecko peut lire (OGG Vorbis audio, OGG Theora video, et <a href="http://www.webmproject.org/about/" title="http://www.webmproject.org/about/">WebM</a> video) est décodée par Gecko et envoyée directement au processus <code>mediaserver</code>. Les autres fichiers média sont décodés par <code>libstagefright</code>, qui est capable d'accéder aux codecs propriétaires et aux encodeurs matériels.</p> - -<div class="note"> -<p><strong>Note :</strong> Le processus <code>mediaserver</code> est un composant "temporaire" de Firefox OS ; il est là pour nous aider dans notre travail initial de développement. Cependant, il est prévu qu'il disparaisse éventuellement. Toutefois, cela ne devrait pas se produire avant au moins la version 2.0 de Firefox OS.</p> -</div> - -<h3 id="netd">netd</h3> - -<p>Le processus <code>netd</code> est utilisé pour configurer les interfaces réseau.</p> - -<h3 id="wpa_supplicant">wpa_supplicant</h3> - -<p>Le processus <code>wpa_supplicant</code> est le démon UNIX-style standard qui gère la connectivité avec les points d'accès Wi-Fi.</p> - -<h3 id="dbus-daemon">dbus-daemon</h3> - -<p>Le processus dbus-daemon implémente <a href="http://www.freedesktop.org/wiki/Software/dbus" title="http://www.freedesktop.org/wiki/Software/dbus">D-Bus</a>, un système de bus de messages que Firefox OS utilise pour la communication Bluetooth.</p> - -<h2 id="Gecko">Gecko</h2> - -<p><a href="https://developer.mozilla.org/en-US/docs/Gecko" title="/en-US/docs/Gecko">Gecko</a>, comme mentionné précédemment, est une exécution de standards web (<a href="https://developer.mozilla.org/en-US/docs/HTML" title="/en-US/docs/HTML">HTML</a>, <a href="https://developer.mozilla.org/en-US/docs/CSS" title="/en-US/docs/CSS">CSS</a>, et <a href="https://developer.mozilla.org/en-US/docs/JavaScript" title="/en-US/docs/JavaScript">JavaScript</a>). Il est utilisé pour implémenter tout ce que voit l'utilisateur dans Firefox OS et pour contrôler les interactions avec le matériel du téléphone. Les applications Web connectent le HTML5 au matériel via des APIs Web contrôlées et sécurisées, implémentées dans Gecko. L'API Web fournit un accès informatisé aux fonctionnalités présentes dans le matériel sous-jacent de l'appareil mobile (comme la batterie ou la vibration), ainsi que les données stockées sur, ou disponibles pour, un périphérique (comme le calendrier ou les contacts). Le contenu Web appelle l'API Web accessible depuis HTML5.</p> - -<p>Une application consiste en une collection de contenus web connexes HTML5. Pour construire des applications web qui s'exécutent sur des périphériques mobiles Firefox OS, les développeurs assemblent, emballent et distribuent simplement ce contenu web. Lors de l'exécution, ce contenu web est interprété, compilé et rendu dans un navigateur web. Pour plus d'informations sur les applications, voir le <a href="https://developer.mozilla.org/en-US/Apps">App Center</a>.</p> - -<div class="note"> -<p><strong>Note</strong> : Pour rechercher la base de code Gecko, vous pouvez utiliser <a href="http://dxr.mozilla.org">http://dxr.mozilla.org</a>. C'est plus "fancy" et cela fournit de bonnes fonctionnalités de référence, mais avec des répertoires limités. Ou vous pouvez essayer le traditionnel <a href="http://mxr.mozilla.org">http://mxr.mozilla.org</a>, qui regroupe plus de projets de Mozilla.</p> -</div> - -<h3 id="Diagramme_d'architecture_Gecko">Diagramme d'architecture Gecko</h3> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5027/securityframework.png" style="height: 591px; width: 979px;"></p> - -<ul> - <li><strong>Framework de sécurité,</strong> contient - - <ul> - <li><strong>Permission manager </strong>: porte d'entrée pour accéder à la fonctionnalité de l'API Web.</li> - <li><strong>Access control list </strong>: matrice des rôles et des permissions requises pour accéder à la fonctionnalité de l'API Web.</li> - <li><strong>Credential validation </strong>: authentification des applications/utilisateurs.</li> - <li><strong>Permissions Store</strong> : ensemble des privilèges requis pour accéder à la fonctionnalité de l'APIWeb.</li> - </ul> - </li> - <li><strong>Web API </strong>: ensemble d'APIs standards qui exposent les fonctionnalités matérielles au contenu web. Fournit des applications web avec des accès sécurisés aux fonctions contenues dans le matériel de l'appareil mobile sous-jacent, avec les données stockées sur - ou disponibles pour - l'appareil.</li> - <li><strong>I/O </strong>: interface vers le matériel et le(s) magasin(s) de données.</li> - <li><strong>Software Updates </strong>: obtiennent et installent les mises à jour sur le logiciel système et les applications tierces.</li> - <li><strong>Content Layout & Rendering</strong> : moteur qui passe, interprète et exécute le contenu web et, avec de l'information formatée, affiche le contenu formaté à l'utilisateur.</li> - <li><strong>b2g process </strong>: (Gecko) exécute un processus système à hauts privilèges qui a accès aux fonctions matérielles du téléphone. Les applications en cours d'exécution sont des processus fils de b2g.</li> -</ul> - -<h3 id="Fichiers_Gecko_en_rapport_avec_Firefox_OS">Fichiers Gecko en rapport avec Firefox OS</h3> - -<h4 id="b2g_2">b2g/</h4> - -<p>Le dossier b2g contient la plupart des fonctions en lien avec Firefox OS.</p> - -<h5 id="b2gchromecontent">b2g/chrome/content</h5> - -<p>Contient les fichiers JavaScript exécutés sur l'application système.</p> - -<h5 id="b2gchromecontentshell.html">b2g/chrome/content/shell.html</h5> - -<p>Le point d'entrée dans Gaia — le HTML pour l'application système <code>shell.html</code> arrive dans <code>settings.js</code> et <code>shell.js</code>:</p> - -<pre class="brush: html"><script type="application/javascript;version=1.8" src="chrome://browser/content/settings.js"> </script> -<script type="application/javascript;version=1.8" src="chrome://browser/content/shell.js"> </script></pre> - -<p><code>settings.js</code> contient les paramètres par défaut de réglages du système.</p> - -<h5 id="b2gchromecontentshell.js">b2g/chrome/content/shell.js</h5> - -<p><code>shell.js</code> est le premier script à charger dans l'application <code>system</code> de Gaia.</p> - -<p><code>shell.js</code> importe tous les modules requis, enregistre les écouteurs de touches, définit <code>sendCustomEvent</code> et <code>sendChromeEvent</code> pour communiquer avec Gaia et fournit des aides d'installation des webapps : quota indexedDB, RemoteDebugger, clavier auxiliaire et outil d'impression écran.</p> - -<p>Mais la fonction la plus importante de <code>shell.js</code> est de lancer l'application <code>system</code> de Gaia, puis remettre l'ensemble du travail de gestion des systèmes à l'application <code>system</code> de Gaia.</p> - -<pre class="brush: js">let systemAppFrame = - document.createElementNS('http://www.w3.org/1999/xhtml', 'html:iframe'); - ... - container.appendChild(systemAppFrame);</pre> - -<h5 id="b2gappb2g.js">b2g/app/b2g.js</h5> - -<p>Le script contient des paramètres prédéfinis -comme about:config dans un navigateur- et identique à pref.js de Gaia. Ces paramètres peuvent être modifiés depuis l'application Paramètres et peuvent être écrasés avec user.js dans le script de compilation de Gaia.</p> - -<h4 id="domAPI">dom/{API}</h4> - -<p>Des nouvelles implémentations de l'API (post-b2g) seront placées dans <code>dom/</code>. Des API plus vieilles seront placées dans <code>dom/base</code>, par exemple <code>Navigator.cpp</code>.</p> - -<h5 id="domapps">dom/apps</h5> - -<p><code>.jsm</code> sera chargé — les implementations de l'API <code>.js</code> comme <code>webapp.js </code> install, <code>getSelf</code>, etc.</p> - -<h5 id="domappssrc">dom/apps/src/</h5> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Toutes les autorisations</span> <span class="hps">sont définies</span></span> dans <a href="http://mxr.mozilla.org/mozilla-central/source/dom/apps/src/PermissionsTable.jsm">PermissionsTable.jsm</a></p> - -<h4 id="domwebidl">dom/webidl</h4> - -<p>WebIDL est le langage utilisé pour définir les APIs web. Pour les attributs supportés, lisez <a href="https://developer.mozilla.org/en-US/docs/Mozilla/WebIDL_bindings">WebIDL_bindings</a>.</p> - -<h4 id="halgonk">hal/gonk</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Ce répertoire contient</span> <span class="hps">les fichiers liés à</span> <span class="hps">la couche</span> <span class="hps">de</span> <span class="hps">port</span> <span class="hps">gonk</span></span>.</p> - -<h4 id="Les_fichiers_Générés"><span class="short_text" id="result_box" lang="fr"><span class="hps">Les fichiers Générés</span></span></h4> - -<h5 id="modulelibprefsrcinitall.js">module/libpref/src/init/all.js</h5> - -<p>Contient tous les fichiers de configuration.</p> - -<h5 id="systemb2g_omni.ja_and_omni.js">/system/b2g/ omni.ja and omni.js</h5> - -<p><span id="result_box" lang="fr"><span class="hps">Contient le</span> <span class="hps">pack de</span> <span class="hps">styles</span> <span class="hps">pour les ressources</span> <span class="hps">de l'appareil.</span></span></p> - -<h3 id="Traitement_des_Événements_d'entrée"><span class="short_text" id="result_box" lang="fr"><span class="hps">Traitement des </span></span>É<span class="short_text" lang="fr"><span class="hps">vénements d'entrée</span><span class="hps"> </span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">La plupart des actions</span> <span class="hps">à l'intérieur de</span> <span class="hps">Gecko</span> sont <span class="hps">déclenchées par</span> <span class="hps">les actions de l'utilisateur</span><span>.</span> <span class="hps">Ces actions</span> <span class="hps">sont représentées par des</span> <span class="hps">événements d'entrée</span> <span class="atn hps">(</span><span>tels que les</span> <span class="hps">pressions de bouton</span><span>, touch</span><span class="hps">es</span></span><span lang="fr"> <span class="hps">à un</span> <span class="hps">appareil à écran tactile</span><span>,</span> <span class="hps">et ainsi de suite</span><span>)</span><span>.</span></span> Ces événements entrent dans le Gecko par la source <a href="https://dxr.mozilla.org/mozilla-central/source/widget/gonk/nsAppShell.cpp" rel="custom">Implementation de</a> de l'interface <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIAppShell" title="">nsIAppShell</a></code>, une interface de Gecko qui est utilisée pour représenter les points principaux d'entrée pour une application de Gecko; c'est-à-dire le pilote du dispositif d'entrée appelle des méthodes sur l'objet <code>nsAppShell</code> qui représente le sous-système de Gecko pour envoyer des événements à l'interface utilisateur.</p> - -<p>Par exemple :</p> - -<pre class="brush:cpp;">void GeckoInputDispatcher::notifyKey(nsecs_t eventTime, - int32_t deviceId, - int32_t source, - uint32_t policyFlags, - int32_t action, - int32_t flags, - int32_t keyCode, - int32_t scanCode, - int32_t metaState, - nsecs_t downTime) { - UserInputData data; - data.timeMs = nanosecsToMillisecs(eventTime); - data.type = UserInputData::KEY_DATA; - data.action = action; - data.flags = flags; - data.metaState = metaState; - data.key.keyCode = keyCode; - data.key.scanCode = scanCode; - { - MutexAutoLock lock(mQueueLock); - mEventQueue.push(data); - } - gAppShell->NotifyNativeEvent(); -}</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Ces événements</span> <span class="hps">viennent du</span> <span class="hps">système standard</span></span> <code>input_event</code> de Linux. <span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">utilise une</span></span> <a href="https://dxr.mozilla.org/mozilla-central/source/widget/gonk/libui/InputReader.cpp" rel="custom">couche d'abstraction légère</a>, <span id="result_box" lang="fr"><span class="hps">celle-ci</span> <span class="hps">offre</span> <span class="hps">quelques fonctionnalités intéressantes comme</span> <span class="hps">le filtrage des événements</span><span>.</span> <span class="hps">Vous pouvez voir</span> <span class="hps">le code qui crée</span> <span class="hps">des événements d'entrée</span> <span class="hps">dans la méthode</span></span> <code>EventHub::getEvents()</code> dans <a href="https://dxr.mozilla.org/mozilla-central/source/widget/gonk/libui/EventHub.cpp" rel="custom">widget/gonk/libui/EventHub.cpp</a>.</p> - -<p><span id="result_box" lang="fr"><span class="hps">Une fois que</span> <span class="hps">les événements</span> <span class="hps">sont reçus par</span> <span class="hps">Gecko</span><span>,</span> <span class="hps">ils sont</span> <span class="hps">expédiés</span> <span class="hps">dans</span> <span class="hps">le DOM</span> <span class="hps">par </span></span><code><a href="https://dxr.mozilla.org/mozilla-central/source/widget/gonk/nsAppShell.cpp" rel="custom">nsAppShell</a></code>:</p> - -<pre class="brush:cpp;">static nsEventStatus sendKeyEventWithMsg(uint32_t keyCode, - uint32_t msg, - uint64_t timeMs, - uint32_t flags) { - nsKeyEvent event(true, msg, NULL); - event.keyCode = keyCode; - event.location = nsIDOMKeyEvent::DOM_KEY_LOCATION_MOBILE; - event.time = timeMs; - event.flags |= flags; - return nsWindow::DispatchInputEvent(event); -} -</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Après cela</span><span>,</span> <span class="hps">les événements</span> <span class="hps">sont soit</span> <span class="hps">consommés par</span> <span class="hps">Gecko</span> <span class="hps">lui-même ou</span> <span class="hps">sont expédiés</span> <span class="hps">à des applications Web</span> en tant qu'<a href="/US/docs/DOM_Client_Object_Cross-Reference/DOM_Events"> </a><a href="https://developer.mozilla.org/en-US/docs/DOM_Client_Object_Cross-Reference/DOM_Events">événements DOM</a> <span class="hps">pour un traitement ultérieur</span><span>.</span></span></p> - -<h3 id="Graphisme">Graphisme</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Au</span> <span class="hps">niveau le plus bas</span><span>,</span> <span class="hps">Gecko</span> <span class="hps">utilise <a href="http://www.khronos.org/opengles/2_X/">OpenGL ES 2.0</a></span> </span>pour dessiner<span lang="fr"> <span class="hps">un contexte</span> <span class="hps">GL</span> <span class="hps">qui enveloppe</span> <span class="hps">les</span> </span>tampons de trame<span lang="fr"> <span class="hps">de</span> <span class="hps">matériel.</span> <span class="hps">Cela se fait</span> <span class="hps">dans</span> <span class="hps">l'implémentation</span> <span class="hps">Gonk de</span></span><code> <a href="https://dxr.mozilla.org/mozilla-central/source/widget/gonk/nsWindow.cpp" rel="custom">nsWindow</a></code> <span class="short_text" id="result_box" lang="fr"><span class="hps">par</span> <span class="hps">un code similaire</span> <span class="hps">à ceci </span></span>:</p> - -<pre class="brush:cpp;">gNativeWindow = new android::FramebufferNativeWindow(); -sGLContext = GLContextProvider::CreateForWindow(this);</pre> - -<p>La class <code>FramebufferNativeWindow</code> est apportée directement d'Android; voir <a href="https://github.com/android/platform_frameworks_base/blob/ics-mr1-release/libs/ui/FramebufferNativeWindow.cpp" title="https://github.com/android/platform_frameworks_base/blob/ics-mr1-release/libs/ui/FramebufferNativeWindow.cpp"><code>FramebufferNativeWindow.cpp</code></a>. Cette derni<span id="result_box" lang="fr"><span class="hps">è</span></span>re utilise l'API <strong>gralloc</strong> API <span id="result_box" lang="fr"><span class="hps">pour accéder au</span> <span class="hps">pilote graphique</span> dans l'optique de <span class="hps">repr</span></span>ésenter<span lang="fr"><span class="hps"> les tampons</span> <span class="hps">du dispositif de</span> <span class="hps">framebuffer</span> <span class="hps">dans la mémoire</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Gecko</span> <span class="hps">utilise</span> <span class="hps">son système de</span> <a href="https://developer.mozilla.org/en-US/docs/Gecko/Layers">Couches</a> <span class="hps">au contenu</span> <span class="hps">composite </span></span><span lang="fr"><span class="hps">élaboré</span> <span class="hps">à l'écran</span><span>.</span> <span class="hps">En résumé</span><span>,</span> <span class="hps">voici ce qui se passe</span> <span class="hps">: </span></span></p> - -<ol> - <li>Gecko <span id="result_box" lang="fr"><span class="hps">dessine des régions distinctes</span> <span class="hps">de pages</span> <span class="hps">dans des tampons</span> de <span class="hps">mémoire</span></span>. <span id="result_box" lang="fr"><span class="hps">Parfois, ces</span> <span class="hps">tampons</span> <span class="hps">sont</span> <span class="hps">dans la mémoire système</span><span>;</span> <span class="hps">d'autres fois</span><span>, elles sont</span> <span class="hps">des textures</span> <span class="hps">mappées</span> <span class="hps">dans l'espace</span> <span class="hps">d'adresse de</span> <span class="hps">Gecko</span></span>,<span id="result_box" lang="fr"><span class="hps"> ce qui signifie que</span> <span class="hps">Gecko</span> dessine <span class="hps">directement dans la mémoire</span> <span class="hps">vidéo</span><span>.</span> <span class="hps">Cela se fait habituellement</span> <span class="hps">dans la m</span></span><span id="result_box" lang="fr"><span class="hps">éthode </span></span><a href="http://mxr.mozilla.org/mozilla-central/source/gfx/layers/basic/BasicThebesLayer.cpp#83" title="http://mxr.mozilla.org/mozilla-central/source/gfx/layers/basic/BasicThebesLayer.cpp#201"><code>BasicThebesLayer::PaintThebes()</code></a>.</li> - <li>Gecko regroupe alors toutes ces textures à l'écran utilisant<span id="result_box" lang="fr"><span class="hps"> des commandes</span> <span class="hps">OpenGL</span></span>. <span id="result_box" lang="fr"><span class="hps">Cette composition</span> <span class="hps">se produit dans</span></span> <a href="http://mxr.mozilla.org/mozilla-central/source/gfx/layers/opengl/ThebesLayerOGL.cpp#124" title="http://mxr.mozilla.org/mozilla-central/source/gfx/layers/basic/BasicThebesLayer.cpp#201"><code>ThebesLayerOGL::RenderTo()</code></a>.</li> -</ol> - -<p><span id="result_box" lang="fr"><span class="hps">Les</span> <span class="hps">détails sur</span> <span class="hps">la façon dont</span> <span class="hps">Gecko</span> <span class="hps">gère le</span> <span class="hps">rendu du contenu</span> <span class="hps">web sortent du cadre de</span><span class="hps"> ce document</span><span>.</span></span></p> - -<h3 id="Couche_d'Abstraction_Matérielle_(HAL_)"><span class="short_text" id="result_box" lang="fr"><span class="hps">Couche d'Abstraction</span> M<span class="hps">atérielle</span></span> (HAL )</h3> - -<p><span id="result_box" lang="fr"><span class="hps">La couche</span> <span class="hps">d'abstraction matérielle</span> <span class="hps">Gecko</span> <span class="hps">est</span> <span class="hps">l'une des couches</span> <span class="hps">de portage</span> <span class="hps">de</span> <span class="hps">Gecko</span><span>.</span> <span class="hps">Il gère</span> <span class="hps">l'accès</span> <span class="hps">de bas niveau</span> <span class="hps">aux interfaces</span> <span class="hps">du système</span> <span class="hps">à travers de multiples</span> <span class="hps">plate-formes utilisant</span> <span class="hps">une API</span> <span class="hps">C</span><span class="hps">++</span> <span class="hps">qui est accessible</span> <span class="hps">aux</span> plus hauts <span class="hps">niveaux de</span> <span class="hps">Gecko</span><span>.</span> <span class="hps">Ces API</span> <span class="hps">sont mises en œuvre</span> </span>selon la plate-forme à l'intérieur du Gecko HAL (Hardware Abstraction Layer) lui-même<span lang="fr"><span class="hps">.</span></span> Cette couche d'abstraction de matériel n'est pas exposée directement au code JavaScript dans Gecko --- <span id="result_box" lang="fr"><span class="hps">cette partie</span> <span class="hps">de l'interaction</span> <span class="hps">est assurée par</span> <span class="hps">les</span> <span class="hps">API Web</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Regardons</span> <span class="hps">le processus</span> au haut<span class="hps"> niveau</span><span>.</span> <span class="hps">Quand un</span> <span class="hps">utilisateur effectue une demande</span> <span class="hps">pour utiliser une fonction</span> <span class="hps">du téléphone</span> <span class="hps">(comme</span> <span class="hps">composer un numéro</span><span>,</span> <span class="hps">accéder à un</span> <span class="hps">réseau Wi-Fi</span> <span class="hps">local,</span> <span class="hps">ou se connecter</span> <span class="hps">via Bluetooth</span><span>)</span><span>,</span> <span class="hps">toutes les couches</span> <span class="hps">de la pile</span> <span class="hps">de technologie</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">sont impliquées</span> <span class="hps">dans la réalisation de</span> <span class="hps">la demande</span><span>.</span> <span class="hps">Les applications</span> <span class="hps">et</span> <span class="hps">le contenu</span> <span class="hps">web</span> <span class="hps">dans la couche</span> <span class="hps">Gaia</span> <span class="hps">soumettent des demandes</span> <span class="atn hps">d'accès à l'</span><span>appareil</span> <span class="hps">sous-jacent</span> <span class="hps">via des appels</span> <span class="hps">d'API</span> <span class="hps">Web</span> <span class="atn hps">(</span><span>appelées à partir de</span> <span class="hps">l'intérieur de</span> <span class="hps">fonctions</span> <span class="hps">HTML5</span><span>)</span><span>,</span> <span class="hps">qui sont</span> <span class="hps">mis en œuvre dans</span> <span class="hps">Gecko</span><span>.</span> <span class="hps">Gecko,</span> <span class="hps">à son tour,</span> <span class="hps">soumet la demande</span> <span class="hps">à Link</span><span>.</span> <span class="hps">Une seule demande</span> <span class="hps">de</span> <span class="hps">Gecko</span> <span class="hps">peut déclencher</span> <span class="hps">une série</span> <span class="hps">complexe d'opérations</span><span>,</span> <span class="hps">lancées et gérées par</span> <span class="hps">Gonk</span><span>,</span> <span class="hps">dans le téléphone mobile</span><span>.</span></span></p> - -<h4 id="Comment_fonctionne_le_HAL"><span class="short_text" id="result_box" lang="fr"><span class="hps">Comment</span> <span class="hps">fonctionne</span> <span class="hps">le</span> <span class="hps">HAL</span></span></h4> - -<p><span id="result_box" lang="fr"><span class="atn hps">Prenons l'</span><span class="hps">API</span></span> <a href="/fr/docs/Web/API/Window/navigator/vibrate" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Vibration</code></a><span lang="fr"> <span class="hps">comme exemple</span><span>.</span> <span class="hps">Le</span> <span class="hps">Gecko</span> <span class="hps">HAL</span> <span class="hps">pour cette</span> <span class="hps">API</span> <span class="hps">est défini dans</span> </span><a href="https://dxr.mozilla.org/mozilla-central/source/hal/Hal.h" rel="custom">hal/Hal.h</a><span lang="fr"><span>.</span> <span class="hps">En substance</span> <span class="atn hps">(</span><span>simplification de la</span> <span class="hps">signature de la méthode</span> <span class="hps">pour</span> <span class="hps">des raisons de clarté</span><span>)</span><span>,</span> <span class="hps">vous avez</span> <span class="hps">cette fonction</span><span> :</span></span></p> - -<pre>void Vibrate(const nsTArray<uint32> &pattern);</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Ceci est la</span> <span class="hps">fonction appelée</span> <span class="hps">par le code</span> <span class="hps">Gecko</span> <span class="hps">pour activer</span> <span class="hps">le</span> <span class="hps">dispositif</span> <span class="hps">de</span> <span class="hps">vibration</span> <span class="hps">en fonction de la</span> <span class="hps">configuration spécifiée</span><span>;</span> <span class="hps">une fonction correspondante</span> <span class="hps">existe</span> <span class="hps">pour annuler</span> <span class="hps">toute vibration</span> <span class="hps">continue</span><span>.</span> <span class="hps">La mise en </span></span>œ<span lang="fr"><span class="hps">uvre</span> <span class="hps">de ce procédé</span> <span class="hps">Gonk</span> <span class="hps">se trouve dans</span></span> <a href="https://dxr.mozilla.org/mozilla-central/source/hal/gonk/GonkHal.cpp" rel="custom">hal/gonk/GonkHal.cpp</a>:</p> - -<pre class="brush:cpp;">void Vibrate(const nsTArray<uint32_t> &pattern) { - EnsureVibratorThreadInitialized(); - sVibratorRunnable->Vibrate(pattern); -} -</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Ce code</span> <span class="hps">envoie la demande pour</span><span class="hps"> faire vibrer le</span> <span class="hps">dispositif</span> <span class="hps">à un autre fil d'exécution</span><span>,</span> <span class="hps">qui est</span> <span class="hps">mis en œuvre dans </span></span> <code>VibratorRunnable::Run()</code>. <span id="result_box" lang="fr"><span class="hps">La boucle principale de</span> <span class="hps">ce fil</span> <span class="hps">ressemble à ceci :</span></span></p> - -<pre class="brush:cpp;">while (!mShuttingDown) { - if (mIndex < mPattern.Length()) { - uint32_t duration = mPattern[mIndex]; - if (mIndex % 2 == 0) { - vibrator_on(duration); - } - mIndex++; - mMonitor.Wait(PR_MillisecondsToInterval(duration)); - } - else { - mMonitor.Wait(); - } -} -</pre> - -<p><code>vibrator_on()</code> <span id="result_box" lang="fr"><span class="hps">est</span> <span class="hps">l'API</span> <span class="hps">Gonk</span> <span class="hps">HAL</span> (<span class="hps">couche</span> <span class="hps">d'abstraction matérielle</span></span><span lang="fr">) <span class="hps">qui tourne sur</span> <span class="hps">le moteur vibrant</span><span>.</span> <span class="hps">En interne,</span> <span class="hps">cette méthode</span> <span class="hps">envoie un message</span> <span class="hps">au pilote </span><span class="hps">du noyau</span> <span class="hps">en écrivant une valeur</span> <span class="hps">à un objet</span> <span class="hps">de</span> <span class="hps">noyau utilisant </span></span> <code>sysfs</code>.</p> - -<h4 id="Alternatives_aux_implémentations_de_l'API_HAL">Alternatives aux impl<span class="short_text" id="result_box" lang="fr"><span class="hps">é</span></span>mentations de l'API HAL</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Les</span> <span class="hps">APIs </span></span><span lang="fr"><span class="hps">HAL Gecko</span> <span class="hps">sont prises en charge</span> <span class="hps">sur toutes les plate-formes</span><span>.</span> <span class="hps">Quand</span> <span class="hps">Gecko</span> <span class="hps">est compil</span></span><span class="short_text" id="result_box" lang="fr"><span class="hps">é</span></span><span lang="fr"><span class="hps"> pour</span> <span class="hps">une</span> <span class="hps">plate-forme</span> <span class="hps">qui ne</span> <span class="hps">dispose pas</span> d'<span class="hps">une interface</span> <span class="hps">de</span> <span class="hps">moteurs vibrants</span> <span class="hps">(comme</span> <span class="hps">un ordinateur de bureau</span><span>), alors une</span> alternative <span class="hps">à l'impl</span></span><span class="short_text" id="result_box" lang="fr"><span class="hps">é</span></span><span lang="fr"><span class="hps">mentation</span> <span class="hps">de</span> <span class="hps">l'API</span> <span class="hps">HAL</span> <span class="hps">est utilisée.</span> <span class="hps">Pour les vibrations</span><span>,</span> <span class="hps">cela est</span> <span class="hps">mis en œuvre dans</span></span> <a href="https://dxr.mozilla.org/mozilla-central/source/hal/fallback/FallbackVibration.cpp" rel="custom">hal/fallback/FallbackVibration.cpp</a>.</p> - -<pre class="brush:cpp;">void Vibrate(const nsTArray<uint32_t> &pattern) { -}</pre> - -<h4 id="Implémentations_Sandbox">Impl<span class="short_text" id="result_box" lang="fr"><span class="hps">é</span></span>mentations Sandbox</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Parce que</span> <span class="hps">la plupart des contenus</span> <span class="hps">web fonctionne</span> <span class="hps">dans les processus</span> <span class="hps">de contenu</span> <span class="hps">avec</span> <span class="hps">des privilèges faibles</span><span>,</span> <span class="hps">nous ne pouvons pas</span> <span class="hps">assumer que ces</span> <span class="hps">processus</span> <span class="hps">ont les</span> <span class="hps">privilèges nécessaires pour</span> <span class="hps">être en mesure, </span><span>par exemple</span><span>,</span> d'<span class="hps">allumer et éteindre</span> <span class="hps">le moteur</span> <span class="hps">de vibration</span><span>.</span> <span class="hps">De plus,</span> <span class="hps">nous voulons avoir</span> <span class="hps">un emplacement central</span> <span class="hps">pour le traitement des</span> <span class="hps">conditions de course</span> <span class="hps">potentielles</span><span>.</span> <span class="hps">Dans le</span> <span class="hps">Gecko</span> <span class="hps">HAL</span><span>, cela se fait</span> <span class="hps">à travers une</span> <span class="hps">mise en œuvre</span> <span class="atn hps">«</span><span>sandbox</span><span>» de la</span> <span class="hps">HAL</span><span>.</span> <span class="hps">Cette mise en œuvre</span> <span class="hps">sandbox</span> <span class="hps">proxie</span> <span class="hps">simplement</span> <span class="hps">des demandes formulées</span> <span class="hps">par des procédés</span> <span class="hps">de contenu</span> <span class="hps">et les transmet</span> <span class="hps">au processus</span> <span class="hps">du "serveur</span> <span class="hps">Gecko</span><span>"</span><span>.</span> <span class="hps">Les</span> <span class="hps">demandes de proxy</span> <span class="hps">sont envoyés en utilisant</span> </span>IPDL<span lang="fr"><span>.</span></span></p> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Pour les vibrations</span><span>,</span> <span class="hps">cela est géré</span> <span class="hps">par la fonction</span></span> <code>Vibrate()</code> implément<span id="result_box" lang="fr"><span class="hps">é dans </span></span> <a href="https://dxr.mozilla.org/mozilla-central/source/hal/sandbox/SandboxHal.cpp" rel="custom">hal/sandbox/SandboxHal.cpp</a>:</p> - -<pre class="brush:cpp;">void Vibrate(const nsTArray<uint32_t>& pattern, const WindowIdentifier &id) { - AutoInfallibleTArray<uint32_t, 8> p(pattern); - - WindowIdentifier newID(id); - newID.AppendProcessID(); - Hal()->SendVibrate(p, newID.AsArray(), GetTabChildFrom(newID.GetWindow())); -}</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Cela envoie</span> <span class="hps">un message défini</span> <span class="hps">par</span> <span class="hps">l'interface</span></span> <code>PHal</code>,<span class="short_text" id="result_box" lang="fr"><span class="hps"><code> </code>décrit par </span></span>IPDL dans <a href="https://dxr.mozilla.org/mozilla-central/source/hal/sandbox/PHal.ipdl" rel="custom">hal/sandbox/PHal.ipdl</a>. <span class="short_text" id="result_box" lang="fr"><span class="hps">Cette méthode est décrite</span> <span class="hps">plus ou moins</span> <span class="hps">comme suit </span></span>:</p> - -<pre>Vibrate(uint32_t[] pattern);</pre> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Le</span> <span class="hps">destinataire de ce message</span> <span class="hps">est la m</span></span><span id="result_box" lang="fr"><span class="hps">é</span></span><span class="short_text" lang="fr"><span class="hps">thode </span></span><code>HalParent::RecvVibrate()</code> dans <a href="https://dxr.mozilla.org/mozilla-central/source/hal/sandbox/SandboxHal.cpp" rel="custom">hal/sandbox/SandboxHal.cpp</a>, <span class="short_text" id="result_box" lang="fr"><span class="hps">qui</span> <span class="hps">ressemble à ceci </span></span>:</p> - -<pre class="brush:cpp;">virtual bool RecvVibrate(const InfallibleTArray<unsigned int>& pattern, - const InfallibleTArray<uint64_t> &id, - PBrowserParent *browserParent) MOZ_OVERRIDE { - - hal::Vibrate(pattern, newID); - return true; -}</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Ceci</span> <span class="hps">omet</span> <span class="hps">certains détails</span> <span class="hps">qui ne sont pas</span> <span class="hps">appropriés à cette</span> documentation<span>;</span> <span class="hps">Cependant</span><span>, il montre comment</span> <span class="hps">le message</span> <span class="hps">progresse</span> <span class="hps">d'un contenu</span></span><span lang="fr"><span class="hps"> de processus</span> <span class="hps">de</span> <span class="hps">Gecko</span> <span class="hps">à</span> <span class="hps">Gonk</span><span>, puis à</span> <span class="hps">la mise en œuvre</span> <span class="hps">du</span> <span class="hps">HAL</span> de <span class="hps">Gonk</span> </span> <code>Vibrate()</code><span lang="fr"> <span class="hps">et finalement</span> <span class="hps">au pilote </span><span class="hps">de vibration</span><span>.</span></span></p> - -<h3 id="Les_API_DOM"><span class="short_text" id="result_box" lang="fr"><span class="hps">Les API DOM</span></span></h3> - -<p>Les interfaces du DOM sont, en substance, comment le contenu Web communique avec Gecko. Ils sont plus impliqués que cela et si vous êtes intéressés par des détails supplémentaires, vous pouvez lire <a href="https://developer.mozilla.org/fr/docs/Web/Guide/DOM">la documentation sur le DOM</a>. Les interfaces du DOM sont définies en utilisant <a href="https://developer.mozilla.org/fr/docs/XPIDL">IDL</a>, qui comprend aussi bien l'interface de fonction étrangère (FFI) que le modèle d'objet (OM) entre le JavaScript et C++.</p> - -<p><span id="result_box" lang="fr"><span class="hps">L'API de</span> <span class="hps">vibration</span> <span class="hps">est exposée</span> <span class="hps">au contenu web</span><span class="hps"> à travers</span> <span class="hps">une interface</span> <span class="hps">IDL</span><span>,</span> <span class="hps">qui est prévue dans</span></span><code> <a href="https://dxr.mozilla.org/mozilla-central/source/dom/interfaces/base/nsIDOMNavigator.idl" rel="custom">nsIDOMNavigator.idl</a>:</code></p> - -<pre>[implicit_jscontext] void mozVibrate(in jsval aPattern);</pre> - -<p>L'argument <a href="/en-US/docs/SpiderMonkey/JSAPI_Reference/Jsval" title="/en-US/docs/SpiderMonkey/JSAPI_Reference/JSVAL_IS_OBJECT"><code>jsval</code></a> indique que <code>mozVibrate()</code> (<span id="result_box" lang="fr"><span class="hps">qui est</span> <span class="hps">notre implémentation</span> <span class="hps">du</span> <span class="hps">fournisseur</span> <span class="hps">préfixée</span> <span class="hps">de cette spécification</span> <span class="hps">de</span> <span class="hps">vibrations</span> <span class="hps">non</span><span class="atn">-</span><span>finalisé</span></span>) <span class="short_text" id="result_box" lang="fr"><span class="hps">accepte</span> <span class="hps">en entrée</span> <span class="hps">toute</span> <span class="hps">valeur</span> <span class="hps">JavaScript</span></span>. Le compilateur IDL, <a href="/en-US/docs/XPIDL/xpidl" title="/en-US/docs/XPIDL/xpidl"><code>xpidl</code></a>, <span id="result_box" lang="fr"><span class="hps">génère</span> <span class="hps">une interface</span> <span class="hps">C</span><span class="hps">++</span> <span class="hps">qui est</span> <span class="hps">ensuite mise en œuvre</span> <span class="hps">par la classe</span> </span> <code>Navigator </code><span lang="fr"> <span class="hps">dans </span></span><code><a href="https://dxr.mozilla.org/mozilla-central/source/dom/base/Navigator.cpp" rel="custom">Navigator.cpp</a></code>.</p> - -<pre class="brush:cpp;">NS_IMETHODIMP Navigator::MozVibrate(const jsval& aPattern, JSContext* cx) { - // ... - hal::Vibrate(pattern); - return NS_OK; -}</pre> - -<p>Il y a beaucoup plus de code dans cette méthode que ce que vous voyez ici, mais ce n'est pas important pour le but de cette documentation. Le fait est que l'appel à hal::Vibrate() le contrôle de transferts du DOM au HAL de Gecko. De là, nous entrons dans la mise en œuvre du HAL discutée dans la section précédente et nous frayons un chemin vers le pilote graphique. Par-dessus tout, la mise en œuvre du DOM ne se soucie pas du tout sur quelle plate-forme il est exécuté (Gonk, Windows, OS X, ou autre chose). Il ne se soucie pas non-plus si le code fonctionne dans un processus de contenu ou dans le processus serveur de Gecko. Ces détails sont tous laissés à des niveaux inférieurs du système à traiter.</p> - -<p><span lang="fr"><span class="hps">L'API de vibration est une API très simple, ce qui en fait un bon exemple. L'<a href="/fr/docs/WebAPI/WebSMS">API </a></span><a href="/fr/docs/WebAPI/WebSMS"><span class="hps">SMS</span></a> <span class="hps">est un exemple d'une API plus complexe qui utilise sa propre couche "d'accès distant" reliant les processus de contenu au serveur.</span></span></p> - -<h2 id="Couche_d'Interface_Radio_(RIL)"><span class="short_text" id="result_box" lang="fr"><span class="hps">Couche</span> <span class="hps">d'Interface Radio</span></span> (RIL)</h2> - -<p>La Couche d'Interface Radio, ou RIL pour Radio Interface Layer en Anglais a été mentionnée dans la section <a href="#L'architecture_des_processus_de_l'espace_utilisateur_">L'architecture des processus de l'espace utilisateur </a>. Cette section examinera un peu plus de détail la manière dont les différents éléments de cette couche interagissent.</p> - -<p><span lang="fr"><span class="hps">Les principaux composants impliqués dans la RIL sont :</span></span></p> - -<dl> - <dt><code>rild</code></dt> - <dd><span lang="fr"><span class="hps">Chargé de communiquer avec le firmware modem propriétaire.</span></span></dd> - <dt><code>rilproxy</code></dt> - <dd><span lang="fr"><span class="hps">Qui proxie les messages entre rild et Gecko (lequel est mis en œuvre dans le processus de b2g). Ceci résout le problème d'autorisation qui se pose lorsque vous essayez de parler à rild directement, lorsque rild ne peut être communiquée à l'intérieur du groupe de radio.</span></span></dd> - <dt><code>b2g</code></dt> -</dl> - -<p><span lang="fr"><span class="hps">Ce processus, également connu comme le procédé chrome, implémente Gecko. Les parties de celui-ci qui se rapportent à la couche d'interface radio sont <a href="https://dxr.mozilla.org/mozilla-central/source/dom/system/gonk/ril_worker.js" rel="custom">dom/system/gonk/ril_worker.js</a> qui mettent en œuvre un thread (fil) de travail qui communique avec rild par le biais de rilproxy et implémentent la machine d'état de la radio; et l' <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIRadioInterfaceLayer" title="">nsIRadioInterfaceLayer</a></code> interface, qui est le service principal </span><a href="/fr/docs/XPCOM">XPCOM</a> <span class="hps">du thread qui agit principalement comme un échange de messages entre le thread ril_worker.js et divers autres composants Gecko, y compris le processus contenu Gecko.</span></span></p> - -<dl> - <dt><span class="short_text" id="result_box" lang="fr"><span class="hps">Processus</span> <span class="hps">du contenu</span> <span class="hps">de</span> <span class="hps">Gecko</span></span></dt> -</dl> - -<p><span lang="fr"><span class="hps">Au sein du processus du contenu de Gecko, l' <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIRILContentHelper" title="">nsIRILContentHelper</a></code> interface fournit un service de XPCOM qui laisse le code mettant en œuvre les parties de DOM, comme la</span></span> <a href="/fr/docs/Web/Guide/Telephony">Téléphonie</a> et les APIs de <a href="/fr/docs/WebAPI/WebSMS">SMS</a>, communiquer avec l'interface de la radio, qui est dans le processus chrome., communiquer avec l'interface de la radio, qui est dans le processus chrome.</p> - -<h3 id="Exemple_Communication_du_rild_au_DOM"><span class="short_text" id="result_box" lang="fr"><span class="hps">Exemple:</span> <span class="hps">Communication</span> <span class="hps">du</span> <span class="hps">rild</span> <span class="hps">au DOM</span></span></h3> - -<p><span lang="fr"><span class="hps">Jetons un </span></span>œ<span lang="fr"><span class="hps">il à un exemple de la façon dont les parties de niveau inférieur du système communiquent avec le code DOM. Lorsque le modem reçoit un appel entrant, il notifie au rild en utilisant un mécanisme propriétaire. rild prépare alors un message pour son client selon le protocole «ouvert», qui est décrit dans</span></span><span class="short_text" id="result_box" lang="fr"> </span><a href="https://github.com/mozilla-b2g/android-hardware-ril/blob/master/include/telephony/ril.h">ril.h. </a><span lang="fr"><span class="hps">Dans le cas d'un appel entrant, un message</span> </span><code>RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED</code> est généré et envoyé par<span lang="fr"> </span><code>rild</code><span lang="fr"> <span class="hps">à</span> </span><code>rilproxy</code>.</p> - -<p>rilproxy, implémenté dans le <a href="https://github.com/mozilla-b2g/rilproxy/blob/master/src/rilproxy.c">rilproxy.c</a>, reçoit ce message dans sa boucle principale, qui sonde sa connexion à<span id="result_box" lang="fr"> </span><code>rild</code><span lang="fr"> <span class="hps">en utilisant le code suivant :</span></span></p> - -<pre class="brush:cpp;">ret = read(rilproxy_rw, data, 1024); - -if(ret > 0) { - writeToSocket(rild_rw, data, ret); -}</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Une fois le message</span> <span class="hps">reçu de</span> </span><code>rild</code><span lang="fr"><span>,</span> <span class="hps">il est</span> <span class="hps">ensuite </span></span>expédié<span lang="fr"><span class="hps"> le long</span> <span class="hps">de</span> <span class="hps">Gecko</span> <span class="hps">sur la</span> <span class="hps">prise</span> <span class="hps">qui relie</span> </span><code>rilproxy </code><span lang="fr"><span class="hps">Gecko</span><span>.</span> <span class="hps">Gecko</span> <span class="hps">reçoit le message</span> <span class="hps">transmis</span> <span class="hps">sur son </span></span><a href="https://dxr.mozilla.org/mozilla-central/source/ipc/ril/Ril.cpp" rel="custom">IPC thread</a>:</p> - -<pre class="brush:cpp;">int ret = read(fd, mIncoming->Data, 1024); -// ... <span class="short_text" id="result_box" lang="fr"><span class="alt-edited hps">gestion des erreurs</span></span> ... -mIncoming->mSize = ret; -sConsumer->MessageReceived(mIncoming.forget()); -</pre> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Le consommateur</span> <span class="hps">de ces messages</span> <span class="hps">est </span></span><a href="https://dxr.mozilla.org/mozilla-central/source/dom/system/gonk/SystemWorkerManager.cpp" rel="custom">SystemWorkerManager</a>, <span class="short_text" id="result_box" lang="fr"><span class="hps">qui</span> <span class="hps">reconditionne</span> <span class="hps">les</span> <span class="hps">messages</span> <span class="hps">et</span> <span class="hps">les envoie</span> <span class="hps">au </span></span><code><a href="https://dxr.mozilla.org/mozilla-central/source/dom/system/gonk/ril_worker.js" rel="custom">ril_worker.js</a> </code>thread <span id="result_box" lang="fr"><span class="hps">qui implémente </span><span class="hps">la machine d'état</span> <span class="hps">RIL</span><span>;</span> <span class="hps">ceci est fait</span> <span class="hps">dans la méthode </span></span><span lang="fr"> </span><code>RILReceiver::MessageReceived()</code><span lang="fr"> <span class="hps">:</span></span></p> - -<pre class="brush:cpp;">virtual void MessageReceived(RilRawData *aMessage) { - nsRefPtr<DispatchRILEvent> dre(new DispatchRILEvent(aMessage)); - mDispatcher->PostTask(dre); -}</pre> - -<p><span id="result_box" lang="fr"><span class="hps">La tâche</span> <span class="hps">postée</span> <span class="hps">à</span> <span class="hps">ce thread</span> <span class="hps">appelle à son tour</span> <span class="hps">la fonction</span> </span><code>onRILMessage()</code><span lang="fr"><span>,</span> <span class="hps">qui est</span> <span class="hps">impl</span></span><span id="result_box" lang="fr"><span class="hps">é</span></span><span lang="fr"><span class="hps">ment</span></span><span id="result_box" lang="fr"><span class="hps">é</span></span><span lang="fr"><span class="hps">e en</span> <span class="hps">JavaScript</span><span>.</span> <span class="hps">Ceci est fait</span> <span class="hps">en utilisant</span> <span class="hps">la fonction API</span> <span class="hps">JavaScript</span></span> <a href="/fr/docs/Référence_de_JSAPI/JS_CallFunction">JS_CallFunctionName()</a>:</p> - -<pre>return JS_CallFunctionName(aCx, obj, "onRILMessage", NS_ARRAY_LENGTH(argv), - argv, argv);</pre> - -<p><code>onRILMessage()</code> <span class="short_text" id="result_box" lang="fr"><span class="hps">est mis en </span></span>œ<span class="short_text" lang="fr"><span class="hps">uvre</span> <span class="hps">dans</span></span> <a href="https://dxr.mozilla.org/mozilla-central/source/dom/system/gonk/ril_worker.js" rel="custom">dom/system/gonk/ril_worker.js</a>, <span id="result_box" lang="fr"><span class="hps">qui</span> <span class="hps">traite le message</span> <span class="hps">octets</span> <span class="hps">et</span> <span class="hps">les</span> d<span class="hps">é</span></span><span lang="fr">coupe <span class="hps">en parcelles</span><span>.</span> <span class="hps">Chaque colis</span> <span class="hps">complet est ensuite</span> <span class="hps">envoyé à</span> <span class="hps">des méthodes de gestionnaire</span> <span class="hps">individuelles</span><span>, le cas échéant</span><span>:</span></span></p> - -<pre class="brush:js;">handleParcel: function handleParcel(request_type, length) { - let method = this[request_type]; - if (typeof method == "function") { - if (DEBUG) debug("Handling parcel as " + method.name); - method.call(this, length); - } -} -</pre> - -<p><span id="result_box" lang="fr"><span class="hps">Ce code</span> <span class="hps">fonctionne en récupérant</span> <span class="hps">le type</span> <span class="hps">de demande </span></span><span lang="fr"><span class="hps">de l'objet</span><span>,</span> <span class="hps">en s'assurant qu'il</span> soit<span class="hps"> défini comme</span> <span class="hps">une fonction</span> <span class="hps">dans le code</span> <span class="hps">JavaScript, </span></span>appelant ensuite la méthode. <span id="result_box" lang="fr"><span class="hps">Depuis</span> </span>ril_worker.js<span lang="fr"> <span class="hps">met en œuvre</span> <span class="hps">chaque type</span> <span class="hps">de demande</span> <span class="hps">dans une</span> <span class="hps">méthode donnée, le</span> <span class="hps">même nom que le</span> <span class="hps">type de demande</span><span>,</span> <span class="hps">ce qui est très</span> <span class="hps">simple.</span></span></p> - -<p>Dans notre exemple, <code>RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED</code>, le code suivant est appelé:</p> - -<pre class="brush:js;">RIL[UNSOLICITED_RESPONSE_CALL_STATE_CHANGED] = function UNSOLICITED_RESPONSE_CALL_STATE_CHANGED() { - this.getCurrentCalls(); -};</pre> - -<p>Comme vous pouvez le voir dans le code ci-dessus, quand une notification est reçue indiquant que le call state a changé, la state machine récupère le call state courant en appelant la méthode <code>getCurrentCall()</code>:</p> - -<pre class="brush:js;">getCurrentCalls: function getCurrentCalls() { - Buf.simpleRequest(REQUEST_GET_CURRENT_CALLS); -}</pre> - -<p>Cela envoie une request back à <code>rild</code> pour demander l'état de tous les appels actifs à l'instant. The request flows back along a similar path the <code>RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED</code> message followed, but in the opposite direction (that is, from <code>ril_worker.js</code> to <code>SystemWorkerManager</code> to <code>Ril.cpp</code>, then <code>rilproxy</code> and finally to the <code>rild</code> socket). <code>rild</code> then responds in kind, back along the same path, eventually arriving in <code>ril_worker.js</code>'s handler for the <code>REQUEST_GET_CURRENT_CALLS</code> message. Et la communication ainsi bidirectionnelle arrive.</p> - -<p>Le call state est alors traité et comparé au précédent état; S'il y a un changement d'état, ril_worker.js notifie le service <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIRadioInterfaceLayer" title="">nsIRadioInterfaceLayer</a></code> sur le thread principal:</p> - -<pre class="brush:js;">_handleChangedCallState: function _handleChangedCallState(changedCall) { - let message = {type: "callStateChange", - call: changedCall}; - this.sendDOMMessage(message); -}</pre> - -<p><code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIRadioInterfaceLayer" title="">nsIRadioInterfaceLayer</a></code> est implémenté dans <a href="https://dxr.mozilla.org/mozilla-central/source/dom/system/gonk/RadioInterfaceLayer.js" rel="custom">dom/system/gonk/RadioInterfaceLayer.js</a>; le message est reçu par la méthode <code>onmessage()</code>:</p> - -<pre class="brush:js;"> onmessage: function onmessage(event) { - let message = event.data; - debug("Received message from worker: " + JSON.stringify(message)); - switch (message.type) { - case "callStateChange": - // This one will handle its own notifications. - this.handleCallStateChange(message.call); - break; - ... -</pre> - -<p>Tout ce qu'il fait est d'expédier le message pour le processus de contenu en utilisant le Parent Process Message Manager (PPMM):</p> - -<pre class="brush:js;">handleCallStateChange: function handleCallStateChange(call) { - [some internal state updating] - ppmm.sendAsyncMessage("RIL:CallStateChanged", call); -}</pre> - -<p>Dans le processus de contenu, le message est reçu par la méthode <code>receiveMessage()</code> dans le service <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIRILContentHelper" title="">nsIRILContentHelper</a></code> , depuis le Child Process Message Manager (CPMM):</p> - -<pre class="brush:js;">receiveMessage: function receiveMessage(msg) { - let request; - debug("Received message '" + msg.name + "': " + JSON.stringify(msg.json)); - switch (msg.name) { - case "RIL:CallStateChanged": - this._deliverTelephonyCallback("callStateChanged", - [msg.json.callIndex, msg.json.state, - msg.json.number, msg.json.isActive]); - break;</pre> - -<p>Ce dernier, à son tour, appelle les méthodes <code><a href="https://developer.mozilla.org/fr/docs/XPCOM_Interface_Reference/nsIRILTelephonyCallback#callStateChanged()">nsIRILTelephonyCallback.callStateChanged()</a></code> sur chaque objet telephony callback enregistré. Chaque application web qui accède à l'API <a href="/fr/docs/Web/API/Window/navigator/mozTelephony" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.navigator.mozTelephony</code></a> a enregistré un tel objet callback que propage les événements au code JavaScript dans l'application web, either as un changement d'état d'un objet appel existant ou un nouvel événement appel <code>entrant</code>.</p> - -<pre class="brush:cpp;">NS_IMETHODIMP Telephony::CallStateChanged(PRUint32 aCallIndex, PRUint16 aCallState, - const nsAString& aNumber, bool aIsActive) { - [...] - - if (modifiedCall) { - // Change state. - modifiedCall->ChangeState(aCallState); - - // See if this should replace our current active call. - if (aIsActive) { - mActiveCall = modifiedCall; - } - - return NS_OK; - } - - nsRefPtr<TelephonyCall> call = - TelephonyCall::Create(this, aNumber, aCallState, aCallIndex); - nsRefPtr<CallEvent> event = CallEvent::Create(call); - nsresult rv = event->Dispatch(ToIDOMEventTarget(), NS_LITERAL_STRING("incoming")); - NS_ENSURE_SUCCESS(rv, rv); - return NS_OK; -}</pre> - -<p>Les applications peuvent recevoir ces évenements et mettre à jour leur interface utilisateur etc:</p> - -<pre class="brush:js;">handleEvent: function fm_handleEvent(evt) { - switch (evt.call.state) { - case 'connected': - this.connected(); - break; - case 'disconnected': - this.disconnected(); - break; - default: - break; - } -}</pre> - -<p>Jetez un coup d'œil à la mise en œuvre de <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/communications/dialer/js/dialer.js" title="https://github.com/mozilla-b2g/gaia/blob/master/apps/communications/dialer/js/dialer.js"><code>handleEvent()</code>, dans l'application de demande de de composeur de numéro comme exemple étendu</a></p> - -<h3 id="3G_data">3G data</h3> - -<p>Il y a un message RIL qui amorce(introduit) "un appel de données" au service cellulaire; ceci permet le mode de transfert de données dans le modem. Cet appel de données finit par créer et activer un <a href="https://fr.wikipedia.org/wiki/Point-to-Point Protocol" title="Point-to-Point Protocol">Point-to-Point Protocol</a> (PPP) le dispositif d'interface dans le noyau Linux qui peut être configuré utilisant les interfaces habituelles.</p> - -<div class="note"> -<p><strong>Note:</strong> Cette section doit être écrite.</p> -</div> - -<h3 id="API_de_DOM_liées">API de DOM liées</h3> - -<p>Cette section inscrit les API de DOM qui sont relatées(liées) aux communications RIL :</p> - -<ul> - <li>API de téléphonie</li> - <li><a href="/en-US/docs/API/WebSMS/Introduction_to_WebSMS" title="/en-US/docs/API/WebSMS/Introduction_to_WebSMS">API de SMS</a></li> - <li>API de connexion mobile</li> -</ul> - -<h2 id="Wi-Fi">Wi-Fi</h2> - -<p>L'arrière-plan Wi-Fi pour Firefox OS utilise simplement wpa_supplicant pour faire la plupart du travail. Cela signifie que le travail principal de l'arrière-plan doit simplement gérer le suppliant et faire quelques tâches auxiliaires comme le chargement du conducteur Wi-Fi et de la permission ou la mise hors de service de l'interface de réseau. En substance, cela signifie que l'arrière-plan est une machine d'état, avec les états après l'état du suppliant.</p> - -<div class="note"> -<p><strong>Note:</strong> Une grande partie du truc(de la substance) intéressant qui arrive dans le Wi-Fi dépend profondément de changements possibles d'état du processus de wpa_supplicant.</p> -</div> - -<p>La mise en œuvre du composant Wi-Fi est cassée dans deux fichiers:</p> - -<dl> - <dt><a href="https://dxr.mozilla.org/mozilla-central/source/dom/wifi/DOMWifiManager.js" rel="custom">dom/wifi/DOMWifiManager.js</a></dt> - <dd>Met en œuvre l'API qui s'est exposée au contenu Web, comme défini dans <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWifi.idl" title="">nsIWifi.idl</a></code>.</dd> - <dt><a href="https://dxr.mozilla.org/mozilla-central/source/dom/wifi/WifiWorker.js" rel="custom">dom/wifi/WifiWorker.js</a></dt> - <dd>Met en œuvre la machine d'état et le code qui conduit le suppliant.</dd> -</dl> - -<p>Ces deux fichiers(dossiers) communiquent entre eux par l'utilisation du manager de message. L'arrière-plan écoute pour des messages demandant certaines actions, comme "l'associé" et répond par un message quand l'action demandée a été achevée.</p> - -<p>Le côté de DOM écoute pour les méthodes de réponse aussi bien que plusieurs messages d'événement qui indiquent des changements d'état et des mises à jour de l'information.</p> - -<div class="note"> -<p><strong>Note:</strong> N'importe quelle API de DOM synchrones est mise en œuvre par des données mises en antémémoire sur ce côté de la conduite. Des messages synchrones sont évités quand c'est possible.</p> -</div> - -<h3 id="WifiWorker.js">WifiWorker.js</h3> - -<p>Ce fichier met en œuvre la logique principale derrière l'interface Wi-Fi. Il fonctionne dans le processus chromé (dans le multi-processus construit) et est instancié par le SystemWorkerManager. <span class="transpan"><span id="tran0">Le fichier est généralement cassé dans deux sections : une fonction anonyme géante et WifiWorker (et son prototype). La fonction anonyme finit étant le WifiManager en fournissant une API locale, y compris des notifications pour des événements comme la connexion au suppliant et les résultats de feuilletage étant disponibles. En général, il contient peu de logique et laisse son consommateur unique contrôler ses actions tandis qu'il répond simplement par les informations demandées et contrôle les détails du rapport(de la connexion) avec le suppliant.</span></span></p> - -<p>L'objet de WifiWorker est assis entre le WifiManager et le DOM. Il réagit aux événements et les transfert à DOM; à son tour, il reçoit des requêtes de DOM et exécute les actions appropriées sur le suppliant. Il maintient aussi des informations d'état sur le suppliant et ce qu'il doit faire ensuite.</p> - -<h3 id="DOMWifiManager.js">DOMWifiManager.js</h3> - -<p>Cela met en œuvre l'API de DOM, transmettant des messages dans les deux sens entre des interlocuteurs et le travailleur Wi-Fi réel. Il y a très peu de logique impliquée.</p> - -<div class="note"> -<p><strong>Note:</strong> Pour éviter des messages synchrones au processus chromé, le Manager Wi-Fi a vraiment besoin du cache de l'état basé sur l'événement reçu.</p> -</div> - -<p>Il y a un message synchrone seul, qui est envoyé à temps à l'API DOM est instanciée, pour obtenir l'état actuel du suppliant.</p> - -<h3 id="DHCP">DHCP</h3> - -<p>DHCP et DNS <span class="transpan"><span id="tran0">sont traités par dhcpcd, la norme Linux DHCP le client. Cependant, il ne peut pas réagir quand la connexion de réseau est perdue. À cause de ceci, Firefox OS tue et reprend dhcpcd chaque fois il connecte à un réseau sans fil donné.</span></span></p> - -<p>Dhcpcd est aussi responsable de mettre le parcours par défaut; nous appelons dans le gestionnaire de réseau pour parler au noyau de serveurs DNS.</p> - -<h2 id="Gestionnaire_de_réseau">Gestionnaire de réseau</h2> - -<p>Le Gestionnaire de réseau configure des interfaces de réseau ouvertes par le 3G des données et des composants Wi-Fi.</p> - -<div class="note"> -<p><strong>Note:</strong> Cela doit être écrit.</p> -</div> - -<h2 id="Processus_et_threads">Processus et threads</h2> - -<p><span class="transpan"><span id="tran0">Firefox OS utilise des threads POSIX pour mettre en œuvre tous les threads d'application, ceci inclut le fil conducteur de chaque travailleur d'application aussi bien que Web et des threads d'aide. Des valeurs agréables sont utilisées priorisent au processus et l'exécution de thread comptant ainsi sur le planificateur de noyau Linux standard. Selon le statut d'un processus nous l'assignons un niveau agréable et différent. Nous avons actuellement 7 niveaux :</span></span></p> - -<table class="standard-table"> - <caption>Traitez des niveaux prioritaires</caption> - <thead> - <tr> - <th scope="col">Priorité</th> - <th scope="col">Nice</th> - <th scope="col">Utilité</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>MASTER</code></td> - <td>0</td> - <td>Processus de b2g principal</td> - </tr> - <tr> - <td><code>FOREGROUND_HIGH</code></td> - <td>0</td> - <td>Applications tenant une UC wakelock</td> - </tr> - <tr> - </tr> - <tr> - <td><code>FOREGROUND</code></td> - <td>1</td> - <td>Applications de premier plan</td> - </tr> - <tr> - <td><code>FOREGROUND_KEYBOARD</code></td> - <td>1</td> - <td>Application de clavier</td> - </tr> - <tr> - <td><code>BACKGROUND_PERCEIVABLE</code></td> - <td>7</td> - <td>Applications de fond jouant audio</td> - </tr> - <tr> - <td><code>BACKGROUND_HOMESCREEN</code></td> - <td>18</td> - <td>Application d'écran d'accueil</td> - </tr> - <tr> - <td><code>BACKGROUND</code></td> - <td>18</td> - <td>Toutes les autres applications fonctionnant en arrière-plan</td> - </tr> - </tbody> -</table> - -<p><span class="transpan"><span id="tran0">Quelques niveaux partagent les mêmes valeurs agréables, c'est que ces niveaux diffèrent actuellement dans la façon qu'ils sont traités par le tueur de mémoire insuffisante. Toutes les priorités peuvent être ajustées à construisent le temps via des préférences; les entrées pertinentes peuvent être trouvées dans le fichier de b2g/app/b2g.js.</span></span></p> - -<div class="note"> -<p><strong>Note</strong>: Pour plus d'informations sur le tueur de mémoire insuffisante et comment Firefox OS gère des situations de mémoire basses, lire Mémoire insuffisante la gestion sur Firefox OS.</p> -</div> - -<p>Dans un processus le thread conducteur hérite la valeur agréable du processus tandis que l'on donne aux fils de travailleur Web une valeur agréable qui est un point plus haut que le thread conducteur fonctionnant ainsi à la priorité inférieure. <span class="transpan"><span id="tran0">Ceci est fait pour empêcher des travailleurs intensifs de l'UC d'excessivement ralentir le thread conducteur. Les priorités de processus sont changées quand un événement majeur arrive comme une demande est envoyée dans le contexte ou le premier plan, une nouvelle demande est mise en marche ou une application existante saisit une UC wakelock. Quand une priorité de processus est ajustée, les priorités de tous ses fils seront aussi ajustées en conséquence.</span></span></p> - -<div class="note"> -<p><strong>Note:</strong> Ces groupes ne sont pas actuellement utilisés pour la gestion de ressource comme ils ont prouvé incertains sur certains dispositifs et des noyaux.</p> -</div> diff --git a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/browser/index.html b/files/fr/archive/b2g_os/platform/gaia/gaia_apps/browser/index.html deleted file mode 100644 index 2d8ff1001d..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/browser/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Navigateur -slug: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Browser -tags: - - Apps - - Firefox OS - - Gaia - - Guide - - Navigateur -translation_of: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Browser ---- -<div class="summary"> -<p><span class="seoSummary">L'<a href="https://github.com/mozilla-b2g/gaia/tree/v1.4/apps/browser">application Navigateur</a> (qui fait maintenant partie de System) offre des fonctionnalités de navigation lorsque cela est nécessaire — cela comprend la navigation sur des pages, la recherche et les marque-pages. Cet article explique comment les fonctionnalités de base de l'application Navigateur fonctionnent, et comment elle s'intègre dans un système plus vaste.</span></p> -</div> - -<p>Comme Gaia est construit pour s'exécuter au-dessus de Gecko, il a été possible de concevoir un Navigateur Système/application Navigateur pour naviguer sur des pages web classiques, basé sur cette instance Gecko. Cela est accessible par l'intermédiaire de l'<a href="https://developer.mozilla.org/en-US/docs/DOM/Using_the_Browser_API">API mozBrowser</a>.</p> - -<div class="note"> -<p><strong>Note </strong>: Depuis Firefox OS 2.1, l'application Navigateur fait partie de System. Cela signifie que la navigation web peut se faire soit en cliquant sur l'icône Navigateur pour ouvrir l'application, soit en utilisant la fonctionnalité de navigation et de recherche universelle. Grâce à l'<a href="https://wiki.mozilla.org/FirefoxOS/Haida">expérience utilisateur Haida</a>, l'application et les onglets de navigation sont alors unifiés pour une expérience commune et sont présents dans le gestionnaire de tâches ainsi que dans la vue des miniatures (pour la navigation latérale).</p> -</div> - -<h2 id="Navigateur_Système_(Navigateur_Chrome)">Navigateur Système (Navigateur Chrome)</h2> - -<p>Quand un utilisateur Firefox OS marque une page web pour qu'elle apparaisse sur l'écran d'accueil, cette page web s'ouvrira dans le Navigateur Système et non dans l'application Navigateur. Il comporte dans la partie inférieure une barre d'outils contenant les fonctions génériques reculer/avancer/actualiser. Dans Gaia, cela est appelé le Navigateur Chrome ou wrapper. Vous pouvez le voir en action du côté droit de l'image suivante.</p> - -<p><img alt="A diagram showing that when a web page is opened in the system browser, it is given a toolbar." src="https://mdn.mozillademos.org/files/7869/browser-app.png" style="display: block; height: 500px; margin: 0px auto; width: 738px;"></p> - -<p>Si vous souhaitez que votre page web dispose toujours des fonctions reculer/avancer/actualiser, vous pouvez ajouter la ligne suivante dans le manifeste de l'application pour activer le Navigateur Chrome.</p> - -<pre class="brush: json">declare { chrome: { navigation: true } }</pre> - -<div class="note"> -<p><strong>Note </strong>: La barre d'outils du Navigateur Chrome a une incidence sur la hauteur du contenu, il est donc nécessaire de la prendre en compte pour la mise en page de vos pages web.</p> -</div> - -<h3 id="Le_flux_de_code">Le flux de code</h3> - -<p>Lors de l'ouverture d'une nouvelle page web dans Firefox OS, la séquence des appels est</p> - -<pre>Gecko > WrapperFactory > Window Manager > AppWindow > BrowserFrame</pre> - -<p>Les wrappers héritant de <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/system/js/wrapper_factory.js">system/js/wrapper_factory</a> recevront l'événement <code>mozbrowseropenwindow</code> dans le cas d'une page web en marque-page.</p> - -<p>Dans la section <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/system/js/wrapper_factory.js#L15">handleEvent</a>, le gestionnaire va vérifier l'événement pour déterminer si la page web doit être ouverte en tant qu'application ou dans le navigateur chrome.</p> - -<p>Enfin, <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/system/js/wrapper_factory.js#L115">launchWrapper</a> est appelée pour lancer la fenêtre correspondante.</p> - -<h2 id="Navigation_et_recherche_universelle">Navigation et recherche universelle</h2> - -<p>Avec la nouvelle barre de navigation et de recherche, les utilisateurs peuvent accéder à leurs favoris, saisir une URL, ou découvrir de nouvelles applications depuis n'importe où dans Firefox OS. La barre de recherche se trouve en haut de l'écran et les utilisateurs peuvent juste toucher l'écran ou faire glisser le doigt dessus pour l'ouvrir.</p> - -<p>Voyez cela comme une combinaison de l'<a href="https://support.mozilla.org/en-US/kb/awesome-bar-find-your-bookmarks-history-and-tabs">Awesome Bar</a> du navigateur et de la <a href="https://support.mozilla.org/en-US/kb/use-adaptive-search-discover-personalized-apps">recherche adaptative d'applications</a> de l'écran d'accueil. Comme Firefox OS utilise des applications web, lorsque vous trouvez ce que vous voulez, même s'il s'agit d'une nouvelle application, il l'ouvre directement. Vous n'avez pas besoin d'installer quoi que ce soit, parce que tout est de type web et instantané.</p> - -<h2 id="Application_Navigateur">Application Navigateur</h2> - -<p>Le Navigateur est une application web certifiée qui procure une expérience de navigation web générale. La fonction principale se trouve dans <a href="https://github.com/mozilla-b2g/gaia/tree/v1.4/apps/browser/js/browser.js">apps/browser/js/browser.js</a> :</p> - -<pre class="brush: js">var Browser = { - init: function browser_init() { - this.getAllElements(); - ... - BrowserDB.init((function() { - ... - } - } -}; - -window.addEventListener('load', function browserOnLoad(evt) { - window.removeEventListener('load', browserOnLoad); - Browser.init(); -});</pre> - -<p>Le Navigateur appellera sa fonction <code>init()</code> pendant le chargement du DOM.</p> - -<pre class="brush: js">getAllElements: function browser_getAllElements() { - var elementIDs = [ - 'toolbar—start', ... 'danger—dialog']; - - // Loop and add element with camel style name to Modal Dialog attribute. - elementIDs.forEach(function createElementRef(name) { - this[this.toCamelCase(name)] = document.getElementById(name); - }, this); -},</pre> - -<p>La fonction <code>getAllElements</code> est utilisée pour obtenir tous les gestionnaires d'élément camelCase, après quoi <a href="https://github.com/mozilla-b2g/gaia/tree/v1.4/apps/browser/js/browser_db.js">apps/browser/js/browser_db.js</a> est appelée pour se préparer à l'ajout du moteur de recherche par défaut et des marque-pages.</p> - -<h2 id="Marque-pages">Marque-pages</h2> - -<p>À partir de Firefox OS 2.0, <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/bookmark">apps/bookmark</a> est utilisé pour gérer les activités d'enregistrement/suppression de marque-pages.</p> - -<p>La partie la plus intéressante, <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/bookmark/manifest.webapp">apps/bookmark/webapp.manifest</a>, ressemble à ceci :</p> - -<pre class="brush: json">"activities": { - "save—bookmark": { - "filters": { - "type": "url", - "url": { "required":true, "pattern":"https?:.{1,16384}" } - }, - "disposition": "inline", - "href": "/save.html", - "returnValue": true - }, - "remove—bookmark": { - "filters": { - "type": "url", - "url": { "required":true, "pattern":"https?:.{1,16384}" } - }, - "disposition": "inline", - "href": "/remove.html", - "returnValue": true - } -},</pre> - -<p>Comme indiqué plus haut, l'activité est gérée par save.html et remove.html. Les deux opérations sont prises en charge par <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/bookmark/js/activity_handler.js">apps/bookmark/js/activity_handler.js</a>:</p> - -<pre class="brush: js">var ActivityHandler = { - 'save—bookmark': function ah_save(activity) { - }, - - 'remove—bookmark': function ah_remove(activity) { - } -}; - -navigator.mozSetMessageHandler('activity', function onActivity(activity) { - var name = activity.source.name; - switch (name) { - case 'save—bookmark': - case 'remove—bookmark': - if (activity.source.data.type === 'url') { - ActivityHandler[name](activity); - } - ... - } -}</pre> - -<p>Quand le gestionnaire de message en écoute <code>navigator.mozSetMessageHandler('activity')</code> réceptionne les activités save-bookmark ou remove-bookmark, la fonction <code>ActivityHandler</code> est appelée pour gérer les opérations correspondantes.</p> diff --git a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/index.html b/files/fr/archive/b2g_os/platform/gaia/gaia_apps/index.html deleted file mode 100644 index 6ac3ce3e51..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Applications Gaia -slug: Archive/B2G_OS/Platform/Gaia/Gaia_apps -tags: - - Applications - - Architecture - - Firefox - - Gaia - - OS -translation_of: Archive/B2G_OS/Platform/Gaia/Gaia_apps ---- -<div class="summary"> -<p><span class="seoSummary">Gaia est l'interface utilisateur de Firefox OS, elle contient la fonction d'administration du système et la suite d'applications par défaut embarquée avec les appareils Firefox OS. La totalité du code source de Gaia — même le système et les claviers IMEs (</span><em>Input Method Editors</em>) <span class="seoSummary">— est entièrement implémentée avec HTML5 (HTML + CSS + Javascript) & Open WebAPIs. Cette série de documents contient les informations sur comment chacune des applications disponibles par défaut dans Gaia fonctionne.</span></p> -</div> - -<h2 id="Catégories_des_fonctionnalités_Gaia">Catégories des fonctionnalités Gaia</h2> - -<p> Les différentes applications à l'intérieur de Gaia peuvent être grossièrement classées dans les groupes listés ci-dessous.</p> - -<div class="note"> -<p><strong>Note</strong>: de nombreuses pages référencées afin d'apporter plus d'informations sur le fonctionnement des applications sont des pages README venant du <a href="https://github.com/mozilla-b2g/gaia/">dépôt Github Gaia</a>. Ceci s'explique par le fait que de nombreuses applications ont des cycles de développement rapides et sont donc sujettes à de fréquentes (souvent journalières) modifications. Il serait alors peu censé d'essayer de garder les pages MDN à jour avec ces changements fréquents. Les pages README sont actuellement les sources d'informations les plus précises et les plus fiables.</p> -</div> - -<h3 id="Plate-forme">Plate-forme</h3> - -<p>Inclut les applications Système (system), Paramètres (settings), <span style="background: transparent;">É</span>cran de verrouillage (lockscreen), scripts de construction (build script) et Bluetooth.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7503/platform_team.png" style="display: block; height: 269px; margin: 0px auto; width: 355px;"></p> - -<h4 id="Applications_de_la_plate-forme_explication_détaillée">Applications de la plate-forme: explication détaillée</h4> - -<dl> - <dt><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/System">Système</a></dt> - <dd>L'application Système est la première application web chargée par Gecko lors de la <a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Architecture">procédure de démarrage de Firefox OS</a>. Elle assume de nombreuses responsabilités qui sont généralement nécessaires pour utiliser le système et n'est donc pas prise en charge, elle-même, par d'autres applications web.</dd> - <dt><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/Browser">Navigateur</a></dt> - <dd>L'application Navigateur (qui fait maintenant partie de l'application Système) fournit des fonctionnalités semblables à un navigateur lorsque cela est nécessaire — cela inclut la navigation entre les pages, la recherche et les marque-pages.</dd> - <dt><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/Window_Management">Gestion des fenêtres</a></dt> - <dd>La fonctionnalité de gestion des fenêtres de Firefox OS — incluant le cycle de vie et l'interaction d'une application, les notifications, les animations et beaucoup plus — est gérée par une partie spécifique de l'application Système. Cet article étudie la Gestion des Fenêtres de Firefox OS en détails.</dd> - <dt><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps/Settings">Paramètres</a></dt> - <dd>L'application Paramètres permet aux utilisateurs de Firefox OS de configurer les paramètres de leur appareil. Elle permet également de répondre aux appels d'activités (<a href="/en-US/docs/WebAPI/Web_Activities">Web activités </a>avec le nom <code>configure</code>), ce qui permet à d'autres applications d'être renvoyées vers différents panneaux à l'intérieur de l'application Paramètres, afin d'enrichir les possibilités de paramétrage (par exemple en montrant le panneau des paramètres du Wi-Fi si une connexion Internet est disponible).</dd> -</dl> - -<h3 id="Communication">Communication</h3> - -<p>Inclut les applications Téléphone (dialer), Contacts (contact), Messages (sms) et FTU (First Time Use).</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7499/comms_team.png" style="display: block; height: 246px; margin: 0px auto; width: 317px;"></p> - -<h4 id="Applications_de_communication_explication_détaillée">Applications de communication: explication détaillée</h4> - -<p>TBD</p> - -<h3 id="Productivité">Productivité</h3> - -<p>Inclut les applications Courriel (email), Agenda (calendar) et Horloge (clock).</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7505/productivity_team.png" style="display: block; height: 178px; margin: 0px auto; width: 303px;"></p> - -<h4 id="Applications_de_productivité_explication_détaillée">Applications de productivité: explication détaillée</h4> - -<dl> - <dt><a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/calendar/README.md">Agenda</a></dt> - <dd>L'application Agenda est incluse par défaut dans Firefox OS.</dd> - <dt><a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/clock/README.md">Horloge</a></dt> - <dd>L'application Horloge, présente par défaut dans Firefox OS, inclut les fonctionnalités d'alarme, de minuteur et de chronomètre.</dd> - <dt><a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/email/README.md">Courriel</a></dt> - <dd>L'application de Gaia permettant d'envoyer et de recevoir des courriels.</dd> -</dl> - -<h3 id="Média">Média</h3> - -<p>Inclut les applications Photo (camera), Galerie (gallery), Musique (music) et Vidéo (video) et quelques fonctions liées aux médias telles que les DRM et fonds d'écran (wallpaper).</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7501/media_team.png" style="display: block; height: 250px; margin: 0px auto; width: 386px;"></p> - -<h4 id="Applications_média_explication_détaillée">Applications média: explication détaillée</h4> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Gaia_apps/Video">Vidéo</a></dt> - <dd>L'application Vidéo est une simple application de lecture de vidéos qui jouera les vidéos présentes sur l'espace de stockage des médias de votre appareil Firefox OS.</dd> - <dt><a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/camera/README.md">Photo</a></dt> - <dd>L'application Photo permet aux utilisateurs de Firefox OS d'enregistrer et de gérer les vidéos et photos venant de l'appareil photo. Elle permet également de gérer les vidéos et photos qui répondent aux <a href="https://developer.mozilla.org/en-US/docs/WebAPI/Web_Activities">Web activités</a> du type <code>pick</code>, c'est à dire venant des autres applications voulant obtenir un média utilisant la fonctionnalité de Caméra.</dd> -</dl> - -<h3 id="Autres_fonctionnalités_Gaia">Autres fonctionnalités Gaia</h3> - -<p> En plus de ces fonctions, il y a plusieurs autres fonctionnalités majeures telles que le navigateur, l'écran d'accueil, le Marketplace, le framework de test, le lecteur de PDF et le gestionnaire d'applications qui sont développées en parallèle de Gaia.</p> - -<dl> - <dt><a href="https://github.com/mozilla/pdf.js/blob/master/README.md">pdf.js</a></dt> - <dd>pdf.js est un lecteur PDF basé sur HTML5 utilisé par Gaia. Notez que le code pour pdf.js est maintenu dans un dépôt séparé, en dehors de Gaia.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/paramètres/index.html b/files/fr/archive/b2g_os/platform/gaia/gaia_apps/paramètres/index.html deleted file mode 100644 index 250917fdfe..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/paramètres/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: Paramètres -slug: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Paramètres -tags: - - Applications - - B2G - - Firefox OS - - Gaia - - JavaScript - - Paramètres -translation_of: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Settings ---- -<div class="summary"> -<p><span class="seoSummary">L'application Paramètres permet aux utilisateurs de configurer les paramètres de leur appareil et répond aux activités entrantes qui autorisent les développeurs à afficher des vues spécifiques de paramètres (par exemple afficher le panneau des paramètres wifi si aucune connexion réseau n'est disponible). Cet article explique comment cela fonctionne.</span></p> -</div> - -<h2 id="mozSettings_API_et_association_de_données">mozSettings API et association de données</h2> - -<p>Techniquement, l'application Paramètres est l'interface utilisateur qui leur fournit l'accès certifié à <a href="/en-US/docs/Web/API/Navigator.mozSettings">l'API window.navigator.mozSettings</a>.</p> - -<p>L'application Paramètres gère automatiquement les opérations de paramétrage basique comme les champs d'association de données et les valeurs mozSettings — toutes les opérations basiques comme basculer un paramètre ou changer une valeur d'entrée vont aussi modifier la valeur mozSettings associée.</p> - -<p>L'API <code>window.navigator.mozSettings</code> accède depuis Gecko aux données paramètres. L'utilisation ressemble à ceci pour mettre à jour les données :</p> - -<pre class="brush: js">navigator.mozSettings.createLock().set(values);</pre> - -<div class="note"> -<p><strong>Note</strong>: Il faut utiliser <code>createLock()</code> pour verrouiller les paramètres avant de lire ou écrire des valeurs <code>mozSettings</code>.</p> -</div> - -<p>Pour récupérer les données, il est possible d'utiliser un appel de fonction get et set pour effectuer des opérations sur les données :</p> - -<pre class="brush: js">var reqTimerGoBack = -window.navigator.mozSettings.createLock().get('icc.goBackTimeout'); -reqTimerGoBack.onsuccess = function icc_getTimerGoBackSuccess() { - goBackTimer.timeout = reqTimerGoBack.result['icc.goBackTimeout']; - ... -};</pre> - -<p>La donnée est stockée dans un emplacement <code>instance.result</code>.</p> - -<p>Depuis Firefox OS 2.0, une seule instance <code>mozSettings</code> peut être réutilisée via <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/modules/settings_cache.js">js/modules/settings_cache.js </a>:</p> - -<pre class="brush: js">var SettingsCache = require('modules/settings_cache'); - -SettingsCache.getSettings(function(result){ - var onlineSupportTitle = result['support.onlinesupport.title']; - ... -});</pre> - -<h2 id="Navigation">Navigation</h2> - -<p>Quand les utilisateurs ouvrent l'application Paramètres, ils voient plusieurs panneaux sur la page de vue d'ensemble, qui sont des pages indépendantes fonctionnellement. <code>SettingsService.navigate</code> (<a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/modules/settings_service.js">js/module/settings_service.js</a>) contrôle la navigation entre ces pages.</p> - -<div class="note"> -<p><strong>Note</strong>: Pour les panneaux légaux (qui ne sont pas portés par la nouvelle structure), settings.currentPanel est utilisé à la place de SettingsService.navigate pour naviguer entre les panneaux.</p> -</div> - -<p>Puisque Firefox OS sera supporté sur les tablettes et appareils mobiles, l'application Paramètres possède deux types d'implémentation de modèle de navigation :</p> - -<ul> - <li>Une colonne (pour les mobiles)</li> - <li>Deux colonnes (pour les tablettes)</li> -</ul> - -<p>Tant qu'il est appelé, <code>SettingsService.navigate</code> détermine quel modèle de navigation utiliser grâce au code suivant :</p> - -<pre class="brush: js">if (_isTabletAndLandscape()) { - PageTransitions.twoColumn(oldPanel, newPanel, callback); -} else { - PageTransitions.oneColumn(oldPanel, newPanel, callback); -}</pre> - -<h2 id="Panneaux">Panneaux</h2> - -<p>Depuis bien avant Firefox OS 2.0, la structure basique d'un panneau est définie dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/modules/panel.js">js/modules/panel.js</a>. Il définit six statistiques de cycle de vie :</p> - -<ul> - <li><code>init</code></li> - <li><code>beforeShow</code></li> - <li><code>show</code></li> - <li><code>hide</code></li> - <li><code>beforeHide</code></li> - <li><code>uninit</code></li> -</ul> - -<p>Tous les nouveaux panneaux de paramètres héritent de <code>SettingsPanel</code>, qui étend les fonctionnalités de <code>Panel</code>. Le code est contenu dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/modules/settings_panel.js">js/modules/settings_panel.js</a>:</p> - -<pre class="brush: js">onInit: function(panel, initOptions) { - ... - - PanelUtils.activate(panel); -}, - -onBeforeShow: function(panel, beforeShowOptions) { - // Preset the panel every time when it is presented. - PanelUtils.preset(panel); - _addListeners(panel); - ... -},</pre> - -<p><code>PanelUtils.activate</code> — défini dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/modules/panel_utils.js">js/modules/panel_utils.js</a> — est utilisé pour parser tous les liens dans le panneau et ajoute les handlers corresponsants dans la statistique <code>onInit</code>, et <code>PanelUtils.preset</code> est utilisé pour prérégler les éléments avec les valeurs de paramétrage dans la statistique <code>onBeforeShow</code>.</p> - -<p>Tous les nouveaux paramètres sont définis dans le dossier <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/settings/js/panels">js/panels</a>.</p> - -<h2 id="Module_AMD_et_optimisation_du_temps_de_compilation">Module AMD et optimisation du temps de compilation</h2> - -<p>Depuis bien avant Firefox OS 2.0, l'application Paramètres utilise le <a href="http://en.wikipedia.org/wiki/Asynchronous_module_definition">AMD modules pattern</a> pour implémenter chaque panneau. Les modules AMD modules sont chargés via <a href="https://github.com/requirejs/alameda">Alemeda</a> (une version plus légère de <a href="http://requirejs.org/">RequireJS</a>) et compilés/optimisés avec <code>r.js</code> (l'optimiseur RequireJS). L'application Paramètres a toujours des dépendances sur des fichiers (<a href="https://github.com/mozilla-b2g/gaia/tree/master/shared/js">shared/js</a>) qui ne sont pas des modules AMD. Pour ces derniers, il faut utiliser les options <code>shim</code> définies dans <a href="https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/js/config/require.js">settings/js/config/require.js</a>.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<p>Le <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/settings">README Settings app has a build-in</a> qui est utile pour aller plus loin sur les Paramètres (principalement écrit par Arthur Chen et Fred Lin).</p> diff --git a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/système/index.html b/files/fr/archive/b2g_os/platform/gaia/gaia_apps/système/index.html deleted file mode 100644 index 9e8749702e..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/système/index.html +++ /dev/null @@ -1,303 +0,0 @@ ---- -title: Système -slug: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Système -tags: - - Apps - - FTU - - Firefox OS - - Gaia - - JavaScript - - UI - - système - - écran de verrouillage -translation_of: Archive/B2G_OS/Platform/Gaia/Gaia_apps/System ---- -<div class="summary"> -<p><span class="seoSummary">L'application Système est la première application web chargée par Gecko lors de la <a href="https://developer.mozilla.org/fr/Firefox_OS/Platform/Architecture#D%C3%A9roulement_du_chargement_de_Firefox_OS">procédure de chargement de Firefox OS</a> ; elle gère un grand nombre de fonctionnalités qui sont requises pour le fonctionnement du système en général et ne font donc pas l'objet d'applications web individuelles. Cet article explique en détails comment Système fonctionne.</span></p> -</div> - -<blockquote> -<p>Any application that can be written in JavaScript, will eventually be written in JavaScript. -- Atwood's Law</p> -</blockquote> - -<div class="note"> -<p><strong>Note</strong> : Le <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/system">code source de l'application Système</a> se trouve dans le dépôt Github de Gaia.</p> -</div> - -<h2 id="Comment_est_chargée_l'application_système">Comment est chargée l'application système</h2> - -<p>Quand Gecko essaye de démarrer l'application Système, il référence le manifest.webapp de Système et charge le fichier index.html référencé par le paramètre <code>launch_path</code> (<code>launch_path</code> vaut toujours /index.html pour les applications Gaia.) <code>index.html</code> contient les liens vers tous les styles et JavaScript du système dans sa globalité. Pour gérer un système mobile complet, l'application Système doit charger un grand nombre de ressources.</p> - -<p>Le processus de démarrage est lancé à partir de <code>bootstrap.js</code>, avec le code suivant :</p> - -<pre class="brush: js">window.addEventListener('load', function startup() { -// define safelyLaunchFTU -function safelyLaunchFTU() { - ... -} - -if (Applications.ready) { - safelyLaunchFTU(); -} else { - ... -} - -window.addEventListener('ftudone', function doneWithFTU() { - window.removeEventListener('ftudone', doneWithFTU); - - var lock = window.navigator.mozSettings.createLock(); - lock.set({ - 'gaia.system.checkForUpdates': true - }); -} - - ... - -// With all important event handlers in place, we can now notify -// Gecko that we're ready for certain system services to send us -// messages (e.g. the radio). -var evt = new CustomEvent('mozContentEvent', -{ bubbles: true, cancelable: false, - detail: { type: 'system-message-listener-ready' } }); - window.dispatchEvent(evt); -}</pre> - -<p>Le code fonctionne comme ceci :</p> - -<ol> - <li>Système est une véritable application web exécutée dans un moteur de navigateur, toutes les ressources dont elle dépend doivent être chargées — y compris les styles et les images. Nous lançons donc tout au déclenchement de l'événement <a href="/fr/docs/Web/API/Window/onload" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.onload</code></a>.</li> - <li>Tout d'abord, nous préparons le lancement de l'expérience de première utilisation FTU (First Time Use) et de l'écran d'accueil avec la fonction <code>safelyLaunchFTU()</code>. Comme son nom l'indique, FTU n'est affichée que si l'utilisateur démarre Firefox OS pour la première fois.</li> - <li>Quand l'utilisateur appuie sur TERMINÉ dans le FTU, l'événement personnalisé <code>ftudone</code> est activé puis <code>bootstrap.js</code> se met en écoute sur cet événement dans l'attente de le traiter.</li> - <li>Ensuite, nous utilisons <a href="/fr/docs/Web/API/Settings_API" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Settings API</code></a> (<code>navigator.mozSettings</code>) pour définir le réglage <code>gaia.system.checkForUpdates</code> sur <code>vrai</code>, ce qui indique que le système va rechercher les mises à jour.</li> - <li>Enfin, nous lançons l'événement personnalisé <code>window.dispatchEvent</code>, via <code>CustomEvent</code>. C'est un modèle très important utilisé par Gaia pour les notifications systèmes et la communication avec Gecko. Dans le cas présent, l'application Gaia Système notifie à Gecko qu'elle est prête à se mettre en écoute et à gérer les événements.</li> -</ol> - -<h2 id="Modularisation_instanciable">Modularisation instanciable</h2> - -<p>Le système lui-même évolue constamment vers plus de modularité et de flexibilité. Depuis la version 1.4, une initiative est en cours pour <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=912952">faire évoluer le module système vers un objet instanciable</a>.</p> - -<p>Une fois tout le code au-dessus exécuté, les références vers chaque composant système dans <code>bootstrap.js</code> seront de la forme suivante :</p> - -<pre class="brush: js">window.telephonySettings = new TelephonySettings(); -window.telephonySettings.start();</pre> - -<p>Le squelette du code source de <code>TelephonySettings()</code> serait :</p> - -<pre class="brush: js">(function(exports) { - 'use strict'; - function TelephonySettings() { - this.init_param = false; - } - - TelephonySettings.prototype = { - // Initialzes all settings. - start: function() { - ... - }, - - // Clean all settings. - stop: function() { - ... - }, - - 1st_method: function ts_1st_method() { - ... - }, - - 2nd_method: function ts_2nd_method() { - ... - } - }; - - exports.TelephonySettings = TelephonySettings; - -}(window));</pre> - -<p>Ce modèle contribue à la modularisation des composants systèmes et rend ces derniers davantage testables.</p> - -<h2 id="Animations_de_démarrage_et_d'extinction">Animations de démarrage et d'extinction</h2> - -<p>Cette section explique comment l'application Système contrôle les animations de démarrage et d'extinction. <code>init_logo_handler.js</code> et <code>sleep_menu.js</code> gèrent ces animations de démarrage et d'arrêt du système.</p> - -<h3 id="Animations_de_démarrage">Animations de démarrage</h3> - -<p>L'action de l'animation de démarrage n'est en fait pas contenue dans la procédure principale de démarrage, mais il s'agit au contraire d'un hook installé par <code>EventListeners</code>.</p> - -<p>Le code de l'animation de démarrage dans <code>init_logo_handler.js</code> se déroule ainsi :</p> - -<p>Pour dessiner le logo ou l'animation une fois Gecko prêt à afficher quelque chose à l'écran, nous lançons le gestionnaire système approprié après le chargement du DOM, puis le logo est caché après le lancement d'un événement <code>ftudone</code> ou <code>ftuskip</code>. La méthode <code>_appendCarrierPowerOn</code>, contenue dans <code>init_logo_handler.js</code>, montre comment Gaia se prépare à lancer l'animation ou le logo de démarrage en attendant l'événement <code>DOMContentLoaded</code>. Le <code>logoLoader</code> est défini dans <code>logo_loader.js</code>.</p> - -<pre class="brush: js">var self = this; -document.addEventListener('DOMContentLoaded', function() { - self.carrierLogo.appendChild(self.logoLoader.element); - self._setReady(); -});</pre> - -<p>Une fois le logo préparé, le système appelle la méthode <code>_setReady()</code> qui met en place un écouteur en attente de l'événement spécial <code>mozChromeEvent</code> avec le type <code>system-first-paint</code> pour indiquer que le système est prêt à dessiner sur l'écran.</p> - -<pre class="brush: js">var elem = this.logoLoader.element; - ... -window.addEventListener('mozChromeEvent', function startVideo(e) { - if (e.detail.type == 'system-first-paint') { - window.removeEventListener('mozChromeEvent', startVideo); - if (elem &amp;&amp; elem.ended === false) { - elem.play(); - } - } -});</pre> - -<p>À ce stade, l'élément graphique est animé. Après déclenchement d'un événement <code>ftuopen</code> ou <code>ftuskip</code>, <code>init_logo_handler.js</code> invoque la méthode par défaut <code>handleEvent()</code> qui appelle à son tour la méthode <code>animate()</code> pour faire disparaître l'animation avec comme transition un effet de fondu.</p> - -<pre class="brush: js">init: function ilh_init(logoLoader) { - window.addEventListener('ftuopen', this); - window.addEventListener('ftuskip', this); - ... -}, - -handleEvent: function ilh_handleEvent() { - this.animate(); -},</pre> - -<h3 id="Animations_d'extinction">Animations d'extinction</h3> - -<p>Une fois le système prêt, un appui long sur le bouton marche/arrêt déclenche un événement <code>holdsleep</code>, tel que défini dans <code>hardware_button.js</code>. Ce script gère tous les événements "bouton physique pressé", dont marche/arrêt (veille), accueil, volume haut/bas et ainsi de suite.</p> - -<pre class="brush: js">HardwareButtonsSleepState.prototype.enter = function() { - this.timer = setTimeout(function() { - / * When the user holds Sleep button more than HOLD_INTERVAL. */ - this.hardwareButtons.publish('holdsleep'); - this.hardwareButtons.setState('base'); - }.bind(this), this.hardwareButtons.HOLD_INTERVAL); -};</pre> - -<p>L'animation d'extinction est traitée par <code>sleep_menu.js</code> ; ce script se met en écoute de l'événement <code>holdsleep</code> et affiche le dialogue du menu lorsqu'il est déclenché.</p> - -<pre class="brush: js">init: function sm_init() { - ... - window.addEventListener('holdsleep', this.show.bind(this)); - ... -}</pre> - -<p>Si l'utilisateur choisit d'éteindre l'appareil via les options de menu redémarrer ou éteindre, la fonction <code>startPowerOff()</code> est déclenchée, puis celle-ci appelle à son tour la fonction <code>LogoLoader()</code> qui a la charge de gérer l'affichage de l'animation d'arrêt.</p> - -<pre class="brush: js">handleEvent: function sm_handleEvent(evt) { - switch (evt.type) { - case 'click': - ... - this.handler(action); - break; - ... - } -} - -handler: function sm_handler(action) { - switch (action) { - ... - case 'restart': - this.startPowerOff(true); - break; - - case 'power': - this.startPowerOff(false); - break; - ... - } -}</pre> - -<h2 id="Fonctions_systèmes">Fonctions systèmes</h2> - -<p>L'application Système gère de nombreuses fonctions et responsabilités, le fait que certaines d'entre-elles soient de son ressort pourrait vous surprendre. L'application Système s'occupe de la gestion de la barre d'état et de la zone de notifications, du verrouillage SIM, du gestionnaire de mises à jour, du lanceur de l'écran d'accueil, de la gestion des fenêtres des applis web, et d'autres choses encore. Cette section aborde quelques-unes des fonctions desservies les plus importantes.</p> - -<h3 id="Barre_d'état_et_zone_de_notifications">Barre d'état et zone de notifications</h3> - -<p>La barre d'état et le menu déroulant de Système (Gaia l'appelle la <em>zone de notification </em>; Android emploie le terme de<em> barre de notification</em>) sont gérés par <code>statusbar.js</code> et <code>utility_tray.js</code>. À l'intérieur du fichier <code>index.html</code> de l'application, les éléments de la barre d'état sont définis dans <code><div id="statusbar" data-z-index-level="statusbar"></code> tandis que ceux de la zone de notification résident dans la structure suivante :</p> - -<pre class="brush: html"><div id="utility-tray" data-z-index-level="utility-tray"> - <div id="notifications-container"> - ... - </div> -</div></pre> - -<p>Il existe certains panneaux spéciaux dans la zone de notification, tels que le gestionnaire de mises à jour, le gestionnaire des appels d'urgence, la notification de surveillance du stockage, les contrôles et notification de lecture de médias, l'état des transferts Bluetooth et l'outil pour changer de méthode de saisie clavier (IME). Les gestionnaires et styles correspondants sont situés dans les répertoires <code>js</code>/ et <code>style/</code>.</p> - -<h3 id="Lanceurs_d'applications_spéciaux">Lanceurs d'applications spéciaux</h3> - -<p>L'application Système dispose de trois lanceurs spéciaux qui appellent des applications web séparées lorsque c'est nécessaire :</p> - -<ul> - <li>Le lanceur de l'écran d'accueil : Lance l'application Écran d'accueil (Homescreen), qui affiche l'écran d'accueil lorsque l'utilisateur appuie sur le bouton <em>Accueil</em>, ou si une application web plante ou est quittée d'une autre manière.</li> - <li>Le lanceur de l'écran de verrouillage : Lance l'application Écran de verrouillage (Lockscreen), qui affiche l'écran de verrouillage à chaque fois qu'un utilisateur active l'écran.</li> - <li>Le lanceur FTU : Lance l'application d'expérience FTU. Ceci n'arrive qu'une fois car les utilisateurs verront l'expérience FTU uniquement la première fois qu'ils démarreront un nouvel appareil FirefoxOS (ou qu'ils réinitialiseront leur appareil à son réglage d'usine). De plus, l'application web FTU ne permet pas à l'utilisateur de sortir de l'application en se servant du bouton Accueil.</li> -</ul> - -<h3 id="Écran_de_verrouillage">Écran de verrouillage</h3> - -<p>Le principal point d'entrée de l'application Lockscreen est <code>system/js/lockscreen.js</code>. Sur cet écran, l'utilisateur peut procéder au déverrouillage, déclencher l'appareil photo sécurisé et contrôler le lecteur de musiques.</p> - -<h3 id="Appels_d'urgence">Appels d'urgence</h3> - -<p>Le code du téléphone d'urgence est contenu dans le répertoire <code>gaia/apps/system/emergency-call/</code>. Il s'agit d'une version simplifiée de l'application Téléphone (Dialer) qui permet à l'utilisateur d'y accéder depuis le <a href="#Dialogue_de_déverrouillage_PIN_de_la_carte_SIM">Dialogue de déverrouillage PIN de la carte SIM</a> pour composer des appels d'urgence vers des services comme la police.</p> - -<h2 id="Interface_utilisateur_du_système">Interface utilisateur du système</h2> - -<p>L'application Système assure la gestion de quasiment toute l'interface utilisateur du système, celle-ci étant constituée essentiellement de dialogues comme ceux de l'avertissement de volume, du déverrouillage PIN SIM, de la diffusion cellulaire et d'éléments d'interface utilisateur affectant le comportement des fenêtres, comme le bouton d'accueil logiciel.</p> - -<h3 id="Niveau_z-index">Niveau z-index</h3> - -<p>Avec le fichier <code>index.html</code> de l'application Système, l'attribut <code>data-z-index-level</code> est intégré à de nombreux composants, par exemple :</p> - -<pre class="brush: html"><div id="sleep-menu" data-z-index-level="sleep-menu"> - ... -</div></pre> - -<p>Les z-index-levels correspondants sont définis dans <code>system/style/zindex.css</code>, par exemple :</p> - -<pre class="brush: css">#screen > [data-z-index-level="sleep-menu"] { - z-index: 65536; -} - -... - -#screen > [data-z-index-level="app"] > .appWindow { - z-index: 3; -}</pre> - -<p>Les paramètres z-index sont organisés en fonction de l'ordre dans lequel les éléments sont affichés à l'écran — les éléments qui doivent apparaître au-dessus dans la hiérarchie visuelle se voient attribués un nombre plus élevé. C'est de cette manière que l'application Système traite à un niveau basique la gestion des fenêtres.</p> - -<h3 id="Le_bouton_d'accueil_logiciel">Le bouton d'accueil logiciel</h3> - -<p>Le bouton d'accueil logiciel est une alternative au bouton d'accueil, automatiquement activé sur les appareils dépourvus de bouton d'accueil matériel, e.g. Nexus 4. Pour contrôler son apparence, Gecko fournit une caractéristique média propriétaire appelée <code>-moz-physical-home-button</code> qui peut être utilisée dans une requête média afin d'appliquer des styles basés sur la présence d'un bouton d'accueil matériel. Le gestionnaire de fenêtres alloue si nécessaire un certain espace d'écran pour le bouton d'accueil logiciel.</p> - -<p>Vous verrez ceci dans <code>system/style/window.css</code> (et dans beaucoup d'autres fichiers de styles systèmes) :</p> - -<pre class="brush: css">@media not all and (-moz-physical-home-button) { - #screen:not(.software-button-disabled) > #windows > .appWindow { - bottom: 5rem; - } - }</pre> - -<h3 id="Geste_de_retour_à_l'accueil_(mouvement_du_bas_vers_le_haut_de_l'écran)">Geste de retour à l'accueil (mouvement du bas vers le haut de l'écran)</h3> - -<p>Le geste tactile de retour à l'accueil est une autre alternative au bouton d'accueil matériel ; il peut être activé dans les <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">Paramètres développeurs</a>, et le code qui le contrôle se trouve dans <code>system/js/home_gesture.js</code>. Le geste consiste en un glissement à partir du bas de l'écran, et peut être utilisé pour fermer des applications, par exemple.</p> - -<p>Ce geste est automatiquement activé sur les tablettes Firefox OS. Le seuil défini dans <code>gaia/shared/js/screen_layout.js</code> est utilisé pour détecter si l'appareil est une tablette ou non.</p> - -<h3 id="Dialogue_d'avertissement_du_volume">Dialogue d'avertissement du volume</h3> - -<p>Le code qui contrôle le dialogue d'avertissement de volume se situe dans <code>system/js/sound_manager.js</code>. Ce dialogue apparaîtra quand toutes les conditions suivantes seront remplies :</p> - -<ul> - <li>Les écouteurs sont branchés.</li> - <li>Un niveau sonore de 85dB est dépassé.</li> - <li>La lecture est en cours sur le canal audio.</li> -</ul> - -<h3 id="Dialogue_de_déverrouillage_PIN_de_la_carte_SIM">Dialogue de déverrouillage PIN de la carte SIM</h3> - -<p>Le code qui contrôle le dialogue de déverrouillage PIN de la carte SIM est situé dans <code>system/js/simcard_dialog.js</code> — cette boîte de dialogue s'affiche quand l'option de verrouillage par code est activée, l'écran de verrouillage étant affiché. L'application ouvrante doit également avoir les permissions de téléphonie précisées dans son fichier <code>manifest.webapp</code> (ce qui est le cas de l'application Système).</p> - -<div class="note"> -<p><strong>Note</strong> : la boîte de dialogue de déverrouillage PIN de la carte SIM n'est pas affichée tant que le téléphone est en mode Avion.</p> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/video/index.html b/files/fr/archive/b2g_os/platform/gaia/gaia_apps/video/index.html deleted file mode 100644 index 5d05ecdbcb..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/gaia_apps/video/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Application Gaia Vidéo -slug: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Video -tags: - - Apps - - Gaia - - Vidéo(3) -translation_of: Archive/B2G_OS/Platform/Gaia/Gaia_apps/Video ---- -<div class="summary"> -<p><span class="seoSummary">L'application Vidéo est un lecteur de vidéos simple qui vous permet de lire les vidéos enregistrées dans l'espace de stockage des médias de votre appareil Firefox OS.</span></p> -</div> - -<p><img alt="video app screenshot with single video shown called ha ha size 13mb, 4 minutes long, mp4" src="https://mdn.mozillademos.org/files/6415/video-app.png" style="float: left; height: 480px; padding: 0 10px 10px 0; width: 320px;"></p> - -<h2 id="Utilisation_basique">Utilisation basique</h2> - -<p>Par défaut, lorsque vous ouvrez l'application Vidéo, vous obtenez un message vous informant qu'il n'y a aucune vidéo à lire et que vous devez donc en charger. Cela peut être fait soit en enregistrant une vidéo avec l'application Photo, soit en connectant le stockage de l'appareil en tant que lecteur sur un ordinateur et en copiant des fichiers dessus. Deux boutons sont présents en bas de l'application : celui de gauche permet d'enregistrer de nouvelles vidéos ou de prendre des photos, et celui de droite vous envoie vers la galerie où vous pouvez les visualiser.<br> - <br> - Pour copier les fichiers dessus en utilisant un ordinateur, assurez-vous d'avoir activé “Stockage USB” (Paramètres > Stockage des médias > Stockage USB). S'il n'existe encore aucun répertoire “Videos”, créez-le avec ce nom exact.<br> - <br> - Vous pouvez changer l'endroit où sont stockées les vidéos en modifiant l'emplacement par défaut des médias (dans Paramètres > Stockage des médias) : soit “Carte SD”, soit "Interne".</p> - -<div class="note"> -<p>Remarque : Si vous rencontrez des problèmes pour lire des vidéos sur Firefox OS, il faut que vous sachiez deux choses. Tout d'abord, certaines versions de Firefox OS ignorent les fichiers vidéos s'ils sont trop lourds - cela devrait être corrigé dans une prochaine version. Deuxième point, Firefox OS peut lire la plupart des formats vidéos existants les plus répandus, mais pas tous. Vous pouvez vérifiez lesquels dans notre article sur les <a href="/en-US/docs/HTML/Supported_media_formats#Browser_compatibility">formats de médias pris en charge</a>.</p> -</div> - -<h2 id="Modification_de_l'application_Vidéo">Modification de l'application Vidéo</h2> - -<p>TBD</p> diff --git a/files/fr/archive/b2g_os/platform/gaia/hacking/index.html b/files/fr/archive/b2g_os/platform/gaia/hacking/index.html deleted file mode 100644 index 3dc1de05bf..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/hacking/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Hacking Gaia -slug: Archive/B2G_OS/Platform/Gaia/Hacking -translation_of: Firefox_OS/Developing_Gaia ---- -<div class="warning"> - <p>This page is targeted at Gaia developers. If you're looking for information about how to build and run Firefox OS, you should consult the <a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS page</a> instead.</p> -</div> -<p>Gaia est une collection d' <a href="https://developer.mozilla.org/apps" rel="nofollow">applications Web</a> qui constituent le front end de <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a>. <span id="result_box" lang="fr"><span class="hps">Tout ce que vous</span> <span class="hps">voyez à l'écran</span> <span class="hps">dans Firefox</span> <span class="hps">OS</span> <span class="hps">est construit en utilisant</span> <span class="hps">les technologies Web</span> <span class="hps">ouvertes</span><span>.</span> <span class="hps">Cela comprend</span> <span class="hps">l'écran d'accueil</span> <span class="hps">et</span> <span class="hps">toutes les applications</span> <span class="hps">par défaut</span><span>.</span></span></p> -<h2 id="Obtenir_les_sources">Obtenir les sources</h2> -<p>Pour obtenir les sources de Gaia, <a href="https://github.com/mozilla-b2g/gaia" title="https://github.com/mozilla-b2g/gaia">fork us on GitHub</a> puis clonez votre fork en utilisant <a href="http://git-scm.com/" title="http://git-scm.com/">git</a>.</p> -<pre>$ git clone https://github.com/mozilla-b2g/gaia.git</pre> -<h2 id="Lancer_Gaia">Lancer Gaia</h2> -<p>Vous pouvez lancer Gaia sur votre ordinateur, dans Firefox, ou sur un téléphone compatible.</p> -<h3 id="Le_bureau_B2G">Le bureau B2G</h3> -<p>B2G Desktop <span id="result_box" lang="fr"><span class="hps">est</span> <span class="hps">une version</span> <span class="hps atn">bureau </span><span>exécutable</span> <span class="hps">de</span> <span class="hps">l'application</span> <span class="hps">utilisée</span> <span class="hps">sur les appareils</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">que vous</span> <span class="hps">pouvez utiliser pour exécuter</span> <span class="hps">Gaia</span> <span class="hps">sur</span> <span class="hps">votre ordinateur de bureau</span><span>.</span></span></p> -<p>Vous pouvez télécharger une version expérimentale de B2G à partir d'<a href="http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/">ici</a>. En fonction de la version que vous voulez, vous pourriez vouloir une version différente de test-mozilla-b2g18. Il y a des versions pour Linux (32 bit et 64 bit), Mac OS X et Windows.</p> -<p>Les versions expérimentales sont fournies avec une version récente de Gaia. Quand vous avez téléchargé l'archive, vous avez juste à l'extraire dans un dossier et à lancer le programme b2g depuis l'archive.</p> -<pre>$ cd b2g -$ ./b2g</pre> -<p>To run B2G with your own version of Gaia for development purposes you first need to build a profile from your clone:</p> -<pre>$ cd /path/to/gaia -$ DEBUG=1 DESKTOP=0 make</pre> -<p>This will generate a directory in your <code>gaia</code> directory called <code>profile</code>. The <code>DEBUG</code> part runs Gaia as hosted apps on a built-in web server, rather than the default packaged apps which have to be re-packaged after every change. You can find the path to the profile directory by taking a look at last line of output after running the above command, which should look like:</p> -<pre>Profile Ready: please run [b2g|firefox] -profile /path/to/gaia/profile</pre> -<p>You can then run B2G Desktop with your generated profile like so:</p> -<pre>$ ./b2g /path/to/gaia/profile</pre> -<p>If you want to you can build your own B2G desktop from source.</p> -<h3 id="Using_Gaia_in_Firefox">Using Gaia in Firefox</h3> -<p>It's also possible to run Gaia inside of Firefox. This gives you the advantages of having a rapid development cycle, as well as standard web development tools and debuggers. See <a href="/en-US/docs/Mozilla/Firefox_OS/Using_Gaia_in_Firefox" title="/en-US/docs/Mozilla/Firefox_OS/Using_Gaia_in_Firefox">Using Gaia in Firefox</a> for details on how to do this.</p> -<h3 id="Using_Gaia_on_a_device">Using Gaia on a device</h3> -<p>If you have a compatible mobile device you can also run Gaia by flashing it with Firefox OS. See <a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" title="Mozilla/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS</a> for details on how to do this. We also have documentation for <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform/Testing">how to test Firefox OS</a>.</p> -<h2 id="Unit_tests">Unit tests</h2> -<p>See <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing/Gaia_unit_tests" title="Mozilla/Firefox_OS/Platform/Testing/Gaia_unit_tests">Gaia unit tests</a> for documentation about how to create and run unit tests for Gaia.</p> -<h2 id="Filing_bugs">Filing bugs</h2> -<p>Bugs are filed on Bugzilla under <a href="https://bugzilla.mozilla.org/buglist.cgi?product=Boot2Gecko&component=Gaia&resolution=---" rel="nofollow">Boot2Gecko > Gaia</a>. File a new bug <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Boot2Gecko" title="https://bugzilla.mozilla.org/enter_bug.cgi?product=Boot2Gecko">under the Gaia component</a> (or one of the sub-components).</p> -<h2 id="Contributing_to_Gaia">Contributing to Gaia</h2> -<p>Mozilla depends on contributions from the open source community to help develop Gaia apps and we'd love you to get involved.</p> -<p>Some great places to find some bugs to start hacking on:</p> -<ul> - <li><a href="https://bugzilla.mozilla.org/buglist.cgi?quicksearch=component:gaia%20sw:polish%20@nobody;list_id=4566236" rel="nofollow">Unowned Gaia polish bugs on Bugzilla</a></li> - <li><a href="http://www.joshmatthews.net/bugsahoy/?b2g=1" rel="nofollow">Mentored bugs</a></li> -</ul> -<h3 id="Coding_style_basics">Coding style basics</h3> -<ul> - <li>Background: - <ul> - <li><a href="/en-US/docs/Developer_Guide/Coding_Style#General_practices" title="Developer_Guide/Coding_Style#General_practices">Coding Style: General practices</a></li> - <li><a href="/en-US/docs/Developer_Guide/Coding_Style#JavaScript_practices" title="Developer_Guide/Coding_Style#JavaScript_practices">Coding Style: JavaScript practices</a></li> - <li><a href="/en-US/docs/Developer_Guide/Coding_Style#Naming_and_formatting_guide" title="Developer_Guide/Coding_Style#Naming_and_formatting_guide">Coding Style: Naming and formatting guide</a></li> - </ul> - </li> - <li>Make sure HTML files are declared <code><!DOCTYPE html></code> (that is, as HTML5 documents). If you don't, Internet Explorer 9 and later will load them in compatibility mode.</li> - <li>Include the <code>"use strict";</code> statement (just like that, including the quotes) to the top of your JavaScript files to put them into strict mode.</li> - <li>Always use two spaces for indentation, rather than tabs.</li> - <li>Please use line breaks to separate logical bits of code!</li> - <li>Multi-word file names should use the "underscore" character to separate words, <code>like_this.js</code>.</li> - <li>Use single quotes instead of double quotes for strings.</li> -</ul> -<h4 id="Additional_rules">Additional rules</h4> -<p>Bad:</p> -<pre>if (expression) doSomething(); -</pre> -<p>Correct:</p> -<pre>if (expression) { - doSomething(); -} -</pre> -<p>If you're working on the system app, check out the guidance listed <a href="https://groups.google.com/d/msg/mozilla.dev.gaia/rEhSrw6XmT4/UNvE7qW9pgYJ" title="See_here_for_some_rules._https://groups.google.com/d/msg/mozilla.dev.gaia/rEhSrw6XmT4/UNvE7qW9pgYJ">here</a>.</p> -<p>Before submitting a patch we recommend you run <a href="http://closure-linter.googlecode.com/svn/trunk/closure_linter/gjslint.py" title="http://closure-linter.googlecode.com/svn/trunk/closure_linter/gjslint.py">gjslint</a> on it to check for any style errors:</p> -<pre>gjslint --nojsdoc my_file.js</pre> -<h3 id="Submitting_a_patch">Submitting a patch</h3> -<p>First file or assign a bug to yourself on <a href="https://bugzilla.mozilla.org/buglist.cgi?product=Boot2Gecko&component=Gaia&resolution=---" title="https://bugzilla.mozilla.org/buglist.cgi?product=Boot2Gecko&component=Gaia&resolution=---">Bugzilla</a>, you'll need a Bugzilla account.</p> -<p>Then create a branch on your fork of Gaia:</p> -<pre>$ git branch branchname -$ git checkout branchname</pre> -<p>Commit your changes:</p> -<pre>$ git add /file/to/add -$ git commit -m "Bug XXXXX - Fix the broken Gaia and save the world"</pre> -<p>Push your branch:</p> -<pre>$ git push origin branchname</pre> -<p>Send a pull request by navigating to the branch in your fork on GitHub and finding the pull request button.</p> -<p>To request a review of your patch, <a href="http://globau.wordpress.com/2013/10/21/github-pull-requests-and-bugzilla/">attach the pull request</a> to the bug in Bugzilla by referencing the URL of the pull request, and set the review ("r") flag to "?" and enter the bugzilla ID of one of the <a href="https://wiki.mozilla.org/Modules/FirefoxOS" title="https://wiki.mozilla.org/Modules/FirefoxOS">module owners and peers</a> (very important - otherwise your bug will not likely be seem by anyone). The <a href="https://addons.mozilla.org/en-US/firefox/addon/github-tweaks-for-bugzilla/" title="https://addons.mozilla.org/en-US/firefox/addon/github-tweaks-for-bugzilla/">Github tweaks for bugzilla extension on AMO</a> can help automate this process by automatically creating the attachment and adding it to the bug; you will still need to set the review flag on Bugzilla.</p> -<p>The reviewer may ask you to make some changes; you may need to amend the original commit and force push it to the original branch/pull request. Once they're is happy with your patch, they will merge it into the master branch for you. Before they do this they would prefer it if you could squash all your changes into a single commit, so your contribution can be tracked easily.</p> -<p>The person who merge the commit (usually the reviewer) would add a <code>r=</code> flag in the comment of the merge commit.</p> -<h2 id="Make_options">Make options</h2> -<p>There are many undocumented nor unsupported environment variable presists in the Makefile. Do not depend on them as they may be removed in the future.</p> -<h3 id="Default">Default</h3> -<pre>make</pre> -<p>Make a profile with packaged apps, lunachable by B2G Desktop and can be pushed to device.</p> -<h3 id="Debug_make">Debug make</h3> -<pre>DEBUG=1 make</pre> -<p>The <code>DEBUG</code> part runs Gaia as hosted apps on a built-in web server, rather than the default packaged apps which have to be re-packaged after every change. Launch the profile with the latest Firefox Nightly will also give you nice B2G specific panels on the Firefox Developer Tools.</p> -<h3 id="Push_to_device">Push to device</h3> -<pre>make install-gaia - -make reset-gaia</pre> -<p>With <code>adb</code> (Android Debug Bridge) setup, these make targets will push Gaia to the device. <code>reset-gaia</code> will purge the profile and all other webapps before pushing the new Gaia copy.</p> -<h3 id="Selective_build">Selective build</h3> -<pre>APP=system make - -APP=system make install-gaia</pre> -<p>With a profile already exists, <code>APP</code> allow you to specify which app to re-package, instead of re-pack and re-push all the Gaia apps.</p> -<h3 id="High_resolution_image_assets">High resolution image assets</h3> -<pre>GAIA_DEV_PIXELS_PER_PX=1.5 make</pre> -<p>When packaging the app, replace images with their <code>*@1.5x.(gif|jpg|png)</code> ones if such image exists.</p> -<p>Gaia is currently targetting HBGA (320x240), qHD (540×960) and WVGA (480×800) only; use GAIA_DEV_PIXELS_PER_PX to make sure the images looks sharp on qHD and WVGA devices. see <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag#A_pixel_is_not_a_pixel" title="https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag#A_pixel_is_not_a_pixel">A pixel is not a pixel</a> for more information about device pixels per css pixels.</p> -<h3 id="Script_compression_and_optimization">Script compression and optimization</h3> -<pre>GAIA_OPTIMIZE=1 make</pre> -<p>Concate and optimize build-in app's javascript to improve load time.</p> -<h3 id="Preference_shortcuts">Preference shortcuts</h3> -<pre>NOFTU=1 -</pre> -<p>Disable First time user guide.</p> -<pre>REMOTE_DEBUGGER=1</pre> -<p>Enable debug with adb tool</p> -<pre>DEVICE_DEBUG=1</pre> -<p>While in OS version > 1.2, specify this param when you want debug FirefoxOS webapp with App Manager</p> -<h3 id="Distribution_and_market_customization_build">Distribution and market customization build</h3> -<pre>GAIA_DISTRIBUTION_DIR=./dir</pre> -<p>Read <a href="https://wiki.mozilla.org/B2G/MarketCustomizations" title="https://wiki.mozilla.org/B2G/MarketCustomizations">Customization Overview</a> for detail.</p> -<h2 id="Contacting_the_Team">Contacting the Team</h2> -<ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-gaia" rel="nofollow">Gaia Mailing List</a></li> - <li>#gaia IRC channel on irc.mozilla.org</li> -</ul> diff --git a/files/fr/archive/b2g_os/platform/gaia/index.html b/files/fr/archive/b2g_os/platform/gaia/index.html deleted file mode 100644 index 3bf84e87f4..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Gaia -slug: Archive/B2G_OS/Platform/Gaia -tags: - - Gaia - - Mobile - - TopicStub -translation_of: Archive/B2G_OS/Platform/Gaia ---- -<p>Gaia est l'interface utilisateur de <a href="/fr/Firefox_OS" title="Mozilla/Firefox_OS">Firefox OS</a>. Tout ce qui est affiché à l'écran une fois que Firefox OS est lancé est produit par la couche Gaia : l'écran de verrouillage, l'écran d'accueil, l'écran du clavier téléphonique, etc. Gaia est entièrement écrit en <a href="/fr/docs/Web/HTML">HTML</a>, <a href="/fr/docs/Web/CSS">CSS</a> et <a href="/fr/docs/Web/JavaScript">Javascript</a>. Les seules interfaces avec le système d'exploitation sous-jacent et le matériel, se font au travers d'API Web standards, elles-même implémentées par la couche <a href="/fr/docs/Gecko">Gecko</a>.</p> - -<p>Grâce à ce design, il est non seulement possible d'utiliser Gaia sur les appareils Firefox OS, mais aussi sur d'autres systèmes d'exploitation et dans d'autres navigateurs web (éventuellement avec des fonctionnalités dégradées en fonction des capacités du navigateur).</p> - -<p>Les applications tierces installées en parallèle de la couche Gaia peuvent être exécutées par Gaia.</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation" name="Documentation">Documentation sur Gaia</h2> - - <dl> - <dt><a href="/fr/Firefox_OS/Platform/Gaia/Introduction_a_Gaia" title="Mozilla/Boot_to_Gecko/Introduction to Gaia">Introduction à Gaia</a></dt> - <dd>Gaia est l'interface utilisateur des appareils Firefox OS ; c'est simplement une application Web qui fonctionne sur la pile logicielle Firefox OS. Ce guide est une introduction de haut niveau à Gaia.</dd> - <dt><a href="/fr/Firefox_OS/Platform/Gaia/Gaia_apps">Applications Gaia</a></dt> - <dd>Information sur toutes les applications par défaut disponibles dans la famille Gaia, incluant des conseils sur la façon de les utiliser et de les modifier.</dd> - <dt><a href="/fr/Firefox_OS/Developing_Gaia" title="Mozilla/Boot_to_Gecko/Gaia hacking guide">Développer Gaia</a></dt> - <dd>Un guide complet pour contribuer à Gaia : corriger des bugs ou ajouter de nouvelles fonctionnalités.</dd> - </dl> - - <p><span class="alllinks"><a href="/fr/docs/tag/Gaia" title="tag/B2G">Voir tous les articles...</a></span></p> - </td> - <td> - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Sujets connexes</h2> - - <ul> - <li><a href="/fr/docs/Mozilla/Mobile" title="Mobile">Mobile</a></li> - <li><a href="/fr/docs/Web" title="/en-US/docs/Web">Technologies Web pour développeurs</a> - <ul> - <li><a href="/fr/docs/HTML" title="HTML">HTML</a></li> - <li><a href="/fr/docs/CSS" title="CSS">CSS</a></li> - <li><a href="/fr/docs/JavaScript" title="JavaScript">JavaScript</a></li> - </ul> - </li> - <li><a href="/fr/docs/WebAPI" title="/en-US/docs/WebAPI">WebAPI</a></li> - </ul> - - <h2 class="Tools" id="Resources" name="Resources">Ressources</h2> - - <ul> - <li><a href="/fr/Firefox_OS/Platform/Architecture" title="Mozilla/Firefox_OS/Architecture">Architecture de Firefox OS</a></li> - </ul> - </td> - </tr> - </tbody> -</table> - -<div class="overheadIndicator communitybox" dir="ltr"> -<div class="column-container"> -<h2 id="Rejoignez_la_communauté_Gaia">Rejoignez la communauté Gaia</h2> - -<div class="column-half"> -<div class="communitysubhead">Choisissez votre méthode préférée pour rejoindre la discussion :</div> - -<ul class="communitymailinglist"> - <li><a class="external external-icon" href="https://lists.mozilla.org/listinfo/dev-gaia">Mailing list</a></li> - <li><a class="external external-icon" href="https://twitter.com/Boot2Gecko">Twitter</a></li> - <li><a class="external external-icon" href="http://stackoverflow.com/questions/tagged/firefox-os">Stack Overflow</a></li> - <li><a class="external external-icon" href="http://groups.google.com/group/mozilla.dev.gaia">Google Group</a></li> - <li><a class="external external-icon" href="http://groups.google.com/group/mozilla.dev.gaia/feeds">RSS feed</a></li> -</ul> -</div> - -<div class="column-half"> -<ul class="communitycontact"> - <li><strong>IRC: </strong><a href="irc://irc.mozilla.org/gaia">#gaia</a> <span class="smaller">(<a class="external external-icon" href="https://wiki.mozilla.org/IRC">en savoir +</a>)</span></li> - <li><strong>GitHub: </strong><a class="external external-icon" href="https://github.com/mozilla-b2g/gaia" title="The Gaia GitHub page">La page GitHub sur Gaia</a></li> -</ul> -</div> -</div> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/platform/gaia/introduction_a_gaia/index.html b/files/fr/archive/b2g_os/platform/gaia/introduction_a_gaia/index.html deleted file mode 100644 index 19372bab66..0000000000 --- a/files/fr/archive/b2g_os/platform/gaia/introduction_a_gaia/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Introduction à Gaia -slug: Archive/B2G_OS/Platform/Gaia/Introduction_a_Gaia -translation_of: Archive/B2G_OS/Platform/Gaia/Introduction_to_Gaia ---- -<div class="summary"> -<p><span id="result_box" lang="fr"><span class="hps">Gaia</span> <span class="hps">est</span> <span class="hps">l'interface utilisateur</span> <span class="hps">pour</span> "<span class="hps">Boot to</span> <span class="hps">Gecko</span>" <span class="atn hps">(</span><span>B2G</span><span>)</span><span>;</span> <span class="hps">c'est</span> <span class="hps">un ensemble d'applications</span> <span class="hps">Web</span> <span class="hps">qui s'exécute localement sur</span> <span class="hps">un appareil</span> <span class="hps">B2G</span><span>,</span> <span class="hps">un émulateur</span><span>,</span> "desktop build"<span>,</span> <span class="hps">ou</span> "<span class="hps">Firefox</span> build"<span>.</span> <span class="hps">Tout ce que vous</span> <span class="hps">devez savoir</span> <span class="hps">afin d'ajouter</span> <span class="hps">des applications</span> <span class="hps">ou</span> <span class="hps">apporter des modifications à</span> <span class="hps">Gaia</span> <span class="hps">sont des technologies</span> <span class="hps">Web telles que</span> <a href="/en/JavaScript" title="en/JavaScript">JavaScript</a>, <a href="/en/HTML" title="en/HTML">HTML</a>, and <a href="/en/CSS" title="en/CSS">CSS</a>.</span></p> -</div> - -<h2 id="L'écran_de_verrouillage_Gaia"><span class="short_text" id="result_box" lang="fr"><span class="hps">L'écran</span> <span class="hps">de verrouillage</span> <span class="hps">Gaia</span></span></h2> - -<p><span id="result_box" lang="fr"><span class="hps">L'écran</span> <span class="hps">de verrouillage montre </span></span>le réseau de l'opérateur, l'heure et la date, <span id="result_box" lang="fr"><span class="hps">et</span> <span class="hps">une</span> <span class="hps">barre de défilement</span> <span class="hps">qui permet</span> <span class="hps">à l'utilisateur de</span> <span class="hps">déverrouiller le téléphone</span> <span class="hps">ou</span> <span class="hps">aller directement à</span> <span class="hps">la caméra</span> <span class="hps">pour prendre une photo</span><span>.</span> <span class="hps">Si l'utilisateur</span> <span class="hps">a un</span> <span class="hps">code de verrouillage</span><span>,</span> <span class="hps">l'écran </span><span class="hps">affiche également</span> <span class="hps">une interface</span> <span class="hps">de saisie de</span> <span class="hps">mot de passe.</span></span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7611/gaia-lockscreen.png" style="display: block; height: 480px; margin: 0px auto; width: 320px;"></p> - -<p><span id="result_box" lang="fr"><span class="hps">Notez que sur certains</span> <span class="hps">appareils</span> <span class="hps">le mot de passe</span> <span class="hps">est</span> <span class="hps">activée par défaut</span><span>;</span> <span class="hps">dans ce</span> <span class="hps">cas, le</span> <span class="hps">code PIN par défaut</span> <span class="hps">pour déverrouiller l'appareil</span> <span class="hps">est "0000"</span><span>.</span> <span id="result_box" lang="fr"><span class="hps">Cette fonction sera</span> <span class="hps"><span id="result_box" lang="fr"><span class="hps">probablement</span> <span class="hps">modifiée au fil du temps et </span></span>étoffé</span></span><span>.</span></span></p> - -<h2 id="L'interface_par_défaut_Gaia"><span class="short_text" id="result_box" lang="fr"><span class="hps">L'interface</span> <span class="hps">par défaut</span> <span class="hps">Gaia</span></span></h2> - -<p><span id="result_box" lang="fr"><span class="hps">L'interface par défaut</span> <span class="hps">de</span> <span class="hps">Gaia</span><span>,</span> <span class="hps">comme on le voit</span> <span class="hps">ici</span><span>,</span> <span class="hps">est similaire à</span> <span class="hps">ce que vous voyez</span> <span class="hps">sur</span> <span class="hps">la plupart des smartphones</span> du marché<span>.</span></span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7613/device-2013-01-24-163623.png" style="display: block; height: 480px; margin: 0px auto; width: 320px;"></p> - -<p><span id="result_box" lang="fr"><span class="hps">Cette copie d'écran </span><span class="hps">est évidemment</span> <span class="hps">une</span> <span class="hps">version préliminaire</span> <span class="hps">du</span> <span class="hps">système d'exploitation</span><span>,</span> <span class="hps">avec des icône placés dans un </span><span class="hps">espace réservé</span> <span class="hps">(et quelques</span> <span class="hps">applications de test</span><span>)</span><span>.</span> <span class="hps">La barre d'état</span> <span class="hps">en haut</span> <span class="hps">indique</span> <span class="hps">le réseau sur lequel</span> <span class="hps">le téléphone</span> <span class="hps">est connecté</span> <span class="atn hps">(</span><span>ou</span> <span class="atn hps">"</span><span>Pas de carte SIM</span><span>"</span> <span class="hps">pour</span> <span class="hps">un dispositif</span> <span class="hps">sans</span> <span class="hps">réseau)</span><span>,</span> <span class="hps">la</span> <span class="hps">force du signal réseau</span><span>, la force du</span> signal <span class="hps">WiFi</span><span class="hps">, le niveau</span> <span class="hps">de la batterie</span> <span class="hps">et l'heure.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">La zone centrale</span> <span class="hps">de l'écran affiche</span> <span class="hps">les icônes des</span> <span class="hps">applications</span><span>;</span> <span class="hps">on peux glisser</span> <span class="hps">les pages de gauche</span> <span class="hps">et de droite</span><span>.</span> <span class="hps">Vous pouvez</span> <span class="hps">en savoir plus sur</span> <span class="hps">la</span> <span class="hps">suite d'applications</span> <span id="result_box" lang="fr"><span class="hps">fournis </span></span><span class="hps">par défaut</span> <span class="hps">avec</span> <span class="hps">Gaia</span> <span class="hps">sur notre page</span> <a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Gaia/Gaia_apps">Gaia apps</a><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Au bas de</span> <span class="hps">l'écran</span> ce trouve un<span class="hps"> dock</span> <span class="hps">pouvant accueillir jusqu'à</span> <span class="hps">sept de vos</span> <span class="hps">applications les plus</span> <span class="hps">couramment utilisées</span><span>.</span> <span class="hps">Vous pouvez</span> <span class="hps">glisser et déposer des</span> <span class="hps">applications</span> <span class="hps">sur le dock</span> <span class="hps">de</span> <span class="hps">la zone centrale</span><span>.</span></span></p> - -<h2 id="Voir_aussi" style=""><span class="short_text" id="result_box" lang="fr"><span class="hps">Voir aussi</span></span></h2> - -<ul> - <li><a href="/en-US/Firefox_OS/Platform/Gaia/Gaia_apps">Gaia apps</a>: <span id="result_box" lang="fr"><span class="hps">Cette page comprend</span> les informations <span class="hps">pour</span> <span class="hps">chaques applications</span><span>,</span> <span class="hps">comment</span> <span class="hps">les utiliser</span> <span class="hps">et comment les</span> <span class="hps">modifier</span><span>.</span></span></li> - <li><a href="/en-US/Firefox_OS/Debugging/Developer_settings">Developer settings</a>: <span id="result_box" lang="fr"><span class="hps">Une explication des</span> <span class="hps">différents</span> <span class="hps">paramètres</span> <span class="hps">de développement</span> <span class="hps">que vous pouvez activer</span> <span class="hps">via le "Gaia Settings app</span><span>".</span></span></li> -</ul> diff --git a/files/fr/archive/b2g_os/platform/gestion_de_la_mémoire_dans_firefox_os/index.html b/files/fr/archive/b2g_os/platform/gestion_de_la_mémoire_dans_firefox_os/index.html deleted file mode 100644 index b7cf7222bc..0000000000 --- a/files/fr/archive/b2g_os/platform/gestion_de_la_mémoire_dans_firefox_os/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Gestion de la mémoire dans Firefox OS -slug: Archive/B2G_OS/Platform/Gestion_de_la_mémoire_dans_Firefox_OS -translation_of: Archive/B2G_OS/Platform/Out_of_memory_management_on_Firefox_OS ---- -<div class="summary"> -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS fonctionne</span> <span class="hps">sur certains appareils</span> <span class="hps">sévèrement</span> <span class="hps">limités en mémoire</span><span>,</span> <span class="hps">et il est facile</span> <span class="hps">pour les applications</span> <span class="hps">d'épuiser</span> <span class="hps">la mémoire disponible</span> <span class="hps">sur de tels systèmes</span><span>.</span> <span class="hps">Quand un processus</span> <span class="hps">épuise</span> <span class="hps">la mémoire disponible sur</span> <span class="hps">le système</span><span>,</span> <span class="hps">le noyau</span> <span class="hps">doit "tuer"</span> <span class="hps">d'autres</span> <span class="hps">processus afin de</span> <span class="hps">libérer de la mémoire</span><span>.</span> <span class="hps">Cet article explique comment</span> </span>low memory killer and low memory notifications<span lang="fr"> <span class="hps">travaillent</span> <span class="hps">-</span> <span class="hps">les</span> <span class="hps">deux</span> <span class="hps">systèmes</span> <span class="hps">sur</span> <span class="hps">le dispositif</span> <span class="hps">qui contrôlent</span> <span class="hps">ce</span> <span class="hps">processus</span> <span class="hps">sont tués</span> <span class="hps">pour maintenir le système</span> <span class="hps">principale en cours d'exécution</span> <span class="hps">quand il</span> <span class="hps">est à court de</span> <span class="hps">mémoire.</span></span></p> -</div> - -<p><span id="result_box" lang="fr"><span class="hps">Une opération Firefox</span> <span class="hps">OS</span> <span class="hps">implique</span> <span class="hps">plusieurs processus</span> <span class="hps">-</span> <span class="hps">un</span> <span class="atn hps">"</span><span>processus principal</span><span>"</span> <span class="hps">exécutant des services</span> <span class="hps">de base du système</span><span>,</span> <span class="hps">et potentiellement</span> <span class="hps">de nombreux</span> <span class="atn hps">"</span><span>processus</span> <span class="hps">enfants"</span><span>.</span> <span class="hps">En général</span> <span class="hps">chaque</span> <span class="hps">application</span> <span class="hps">fonctionne</span> <span class="hps">dans son propre processus</span> <span class="hps">enfant</span><span>.</span> <span class="hps">Parce que</span> <span class="hps">dans les</span> <span class="hps">applications de l'environnement</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">sont rarement</span> <span class="hps">fermée par</span> <span class="hps">l'utilisateur</span>, <span class="hps">le système</span> <span class="hps">gère automatiquement</span> <span class="hps">leur durée de vie</span> <span class="hps">pour faire place à</span> <span class="hps">de nouvelles applications</span> <span class="hps">ou des</span> <span class="hps">applications</span> <span class="hps">existantes</span> <span class="hps">nécessitant</span> <span class="hps">de la mémoire supplémentaire</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Deux</span> <span class="hps">sous-systèmes</span> <span class="hps">sont utilisés pour gérer</span> <span class="hps">ceci</span></span>: le <strong>Low memory killer (LMK)</strong> et le<strong> Low memory notifications</strong>.</p> - -<h2 id="Low_memory_killer">Low memory killer</h2> - -<p><span id="result_box" lang="fr"><span class="hps">Le</span> <span class="hps">LMK</span> <span class="hps">est</span> <span class="hps">un sous-système</span> <span class="hps">du noyau</span> <span class="hps">Android</span> <span class="hps">qui tue</span> <span class="hps">automatiquement les processus</span> <span class="hps">pour faire place à</span> <span class="hps">des demandes de mémoire</span><span>.</span> <span class="hps">Afin de choisir</span> <span class="hps">quel processus est</span> <span class="hps">tué</span> <span class="hps">d'abord pour</span> <span class="hps">libérer de la mémoire</span><span>,</span> <span class="hps">chaque processus</span> <span class="hps">est assignée</span> <span class="hps">une priorité</span> <span class="hps">par l'intermédiaire des </span></span><a href="https://www.kernel.org/doc/Documentation/filesystems/proc.txt">fichiers /proc/<pid>/oom_adj ou /proc/<pid>/oom_score_adj</a>. <span id="result_box" lang="fr"><span class="hps">La priorité d'un</span> <span class="hps">processus est connu comme</span> <span class="hps">son score</span> <span class="hps">d'ajustement </span></span>, ou <code>oom_adj</code>. Les plus petites valeurs de <code>oom_adj</code> correspondent <span class="short_text" id="result_box" lang="fr"><span class="hps">à des processus</span> <span class="hps">de priorité supérieure.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">En</span> <span class="hps">général, plus</span> <span class="hps">le score</span> <span class="hps">d'ajustement </span></span><span lang="fr"><span class="hps"> est</span><span> élévé,</span> <span class="hps">plus le</span> <span class="hps">processus</span> <span class="hps">est</span> <span class="hps">susceptible</span> <span class="hps">d'être tué</span><span>.</span> <span class="hps">Le</span> <span class="hps">LMK</span> <span class="hps">offre de multiples</span> <span class="hps">niveaux, chacun</span> <span class="hps">correspondant à une certaine</span> <span class="hps">quantité de mémoire libre</span> <span class="hps">et un score</span> <span class="hps">d'ajustement </span> <span class="hps">minimum.</span> <span class="hps">Chaque fois que</span> <span class="hps">la quantité de mémoire</span> <span class="hps">libre dans le système</span> <span class="hps">tombe en dessous</span> <span class="hps">d'un</span> <span class="hps">certain seuil</span><span>,</span> <span class="hps">tous les processus</span> <span class="hps">avec</span> <span class="hps">un score d'ajustement </span><span class="hps">plus élevées</span> <span class="hps">que le minimum</span> <span class="hps">spécifié pour</span> <span class="hps">ce niveau</span> <span class="hps">sont admissibles à</span> <span class="hps">être tué</span><span>.</span> <span class="hps">Le</span> <span class="hps">LMK</span> <span class="hps">commencera à tuer</span> <span class="hps">ces processus</span><span>,</span> <span class="hps">les plus grandes</span> <span class="hps">d'abord,</span> <span class="hps">et continuera</span> <span class="hps">jusqu'à ce qu'il</span> <span class="hps">a libéré</span> <span class="hps">suffisamment de mémoire pour</span> <span class="hps">aller au-dessus</span> <span class="hps">de ce seuil</span><span>.</span></span></p> - -<div class="note"> -<p><span id="result_box" lang="fr"><span class="hps"><strong>Remarque</strong>:</span> <span class="hps">Quand une</span> <span class="hps">application</span> <span class="hps">de fond</span> <span class="hps">est tué</span> <span class="hps">par le</span> <span class="hps">LMK</span><span>,</span> <span class="hps">elle est mise</span> <span class="hps">dans le</span> <span class="hps">gestionnaire de tâches</span> <span class="hps">/</span> <span class="hps">à travers</span> <span class="hps">des balayages</span> <span class="hps">de bord</span> <span class="hps">comme un</span>e <span class="hps">"app</span> <span class="hps">zombie"</span><span>:</span> <span class="hps">la prochaine fois que</span> <span class="hps">vous accédez à</span> <span class="hps">cette application</span><span>,</span> <span class="hps">elle sera</span> <span class="hps">relancé</span><span>.</span> <span class="atn hps">Le nombre maximal d'</span><span>applications qui peuvent être</span> <span class="hps">maintenu dans cet état</span> <span class="hps">est actuellement de 10</span><span>.</span></span></p> -</div> - -<div class="note"> -<p><span id="result_box" lang="fr"><span class="hps"><strong>Remarque</strong>: Le processus</span> <span class="hps">tué</span> <span class="hps">lorsque l'appareil</span> <span class="hps">manque de mémoire</span> <span class="hps">est</span> <span class="hps">pas nécessairement</span> <span class="hps">celui qui</span> <span class="atn hps">"</span><span>a causé</span><span>"</span> <span class="hps">la condition</span> <span class="atn hps">out-of-</span><span>memory.</span></span></p> -</div> - -<h3 id="Les_priorités_d'un_processus"><span class="short_text" id="result_box" lang="fr"><span class="hps">Les priorités d'un</span> <span class="hps">processus</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Dans Firefox</span> <span class="hps">OS les applications</span> <span class="hps">sont tués</span> <span class="atn hps">dans la politique d'</span><span>ordre de priorité suivant</span><span>,</span> <span class="hps">qui est</span> <span class="hps">appliquée</span> <span class="hps">en donnant à chaque</span> <span class="hps">demande</span> <span class="hps">un niveau de priorité</span> <span class="hps">et en associant</span> <span class="hps">un score</span> <span class="hps">d'ajustement </span><span class="hps">OOM</span> <span class="hps">à ces</span> <span class="atn hps">niveaux (</span><span>les valeurs actuelles</span> <span class="hps">sont définies dans</span> <span class="hps">prefs</span><span>)</span><span>:</span></span></p> - -<ol> - <li><span id="result_box" lang="fr"><span class="hps">Les premières</span> <span class="hps">applications</span> <span class="hps">à</span> <span class="hps">être tués</span> <span class="hps">seront les</span> <span class="hps">applications</span> <span class="hps">d'arrière-plan</span><span>,</span> <span class="hps">en commençant par le</span> <span class="hps">moins récemment utilisé</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Les applications de fond</span> <span class="hps">qui sont</span> <span class="hps">perceptibles par</span> <span class="hps">l'utilisateur</span> <span class="hps">sont tués</span> ensuite<span class="hps"> (par exemple</span><span>,</span> <span class="hps">un lecteur de musique</span> <span class="hps">lecture audio</span> <span class="hps">en arrière-plan</span> <span class="hps">ou</span> <span class="hps">une application</span> <span class="hps">tenant une</span> <span class="hps">haute</span> <span class="hps">priorité ou</span> <span class="hps">cpu</span> <span class="hps">wakelock</span> <span class="hps">et ayant un</span> <span class="hps">gestionnaire enregistré pour</span> <span class="hps">les messages du système</span><span>.</span><span>)</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Si</span> <span class="hps">l'application du clavier</span> <span class="hps">est en marche</span><span>, elle</span> <span class="hps">sera tué</span> <span class="hps">ensuite</span><span>.</span></span></li> - <li><span class="short_text" id="result_box" lang="fr"><span class="hps">Les applications de premier plan</span> <span class="hps">seront tués</span> <span class="hps">ensuite</span></span>.</li> - <li><span id="result_box" lang="fr"><span class="hps">Enfin, les applications</span> <span class="hps">de premier plan</span> <span class="hps">qui ont demandé</span> <span class="hps">à haute priorité</span> <span class="hps">ou</span> <span class="hps">cpu</span> <span class="hps">wakelocks</span> <span class="hps">sont les derniers à</span> <span class="hps">se faire tuer</span><span>.</span></span></li> -</ol> - -<div class="note"> -<p><span id="result_box" lang="fr"><span class="hps"><strong>Remarque</strong>:</span> <span class="hps">La plupart des</span> <span class="hps">processus</span> enfants s'exécutent<span class="hps"> avec</span> <span class="hps">oom_adj</span> <span class="hps">égale à 2</span> <span class="hps">pendant qu'ils sont</span> <span class="hps">au premier plan</span><span>.</span> <span class="hps">Les processus enfants</span> <span class="hps">à</span> <span class="hps">l'arrière-plan</span> s'exécutent<span class="hps"> </span></span><span lang="fr"><span class="hps"> avec</span> <span class="hps">oom_adj</span> <span class="hps">entre 3 et 6</span> <span class="atn hps">(</span><span>inclus)</span><span>.</span> <span class="hps">Exactement la valeur de</span> <span class="hps">oom_adj</span> <span class="hps">qu'un processus enfant</span> <span class="hps">a</span> <span class="hps">alors</span> <span class="hps">en arrière-plan</span> <span class="hps">dépend d'un</span> <span class="hps">certain nombre de facteurs</span><span>, à savoir</span> <span class="hps">que ce soit le lecteur de musique</span><span>, que ce soit</span> <span class="hps">l'application du clavier</span><span>, etc.</span></span></p> -</div> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Il ya</span> <span class="hps">quelques</span> <span class="hps">exceptions à ces règles</span><span>:</span></span></p> - -<ul> - <li><span id="result_box" lang="fr"><span class="hps">Le processus principal</span> <span class="hps">n'est</span> <span class="hps">jamais</span> <span class="hps">tué</span> <span class="hps">par le</span> <span class="hps">LMK</span> <span class="hps">car cela</span> <span class="hps">tuerait</span> <span class="hps">tous les processus</span> <span class="hps">de l'enfant</span> <span class="hps">et </span><span class="hps">redémarrera</span> <span class="hps">le système d'exploitation</span><span>.</span> <span class="hps">Le processus principal</span> <span class="hps">fonctionne avec</span></span> <code>oom_adj 0</code>.</li> - <li> - <div class="almost_half_cell" id="gt-res-content"> - <div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Nous gardons</span> <span class="hps">un processus</span> <span class="hps">autour</span> <span class="hps">pour accélérer</span> <span class="hps">le démarrage de nouvelles</span> <span class="hps">applications appelées</span> <span class="hps">le processus</span> <span class="hps">préallouée</span><span>.</span> <span class="hps">Ce processus est</span> <span class="hps">généralement toujours</span> <span class="hps">maintenu en vie</span> <span class="hps">car il consomme</span> <span class="hps">très peu de mémoire</span> <span class="hps">et accélère</span> <span class="hps">considérablement</span> <span class="hps">démarrage de l'application</span><span>.</span> <span class="hps">Le seul cas</span> <span class="hps">dans lequel il peut</span> <span class="hps">être</span> <span class="hps">tué</span> <span class="hps">est</span> <span class="hps">si</span> <span class="hps">il n'y a pas</span> <span class="hps">assez de mémoire</span> <span class="hps">disponible pour</span> <span class="hps">le processus principal</span> <span class="hps">pour continuer à fonctionner</span> <span class="hps">après avoir tué</span> <span class="hps">tous les autres processus</span><span>.</span></span></div> - </div> - </li> -</ul> - -<h2 id="Low_memory_notifications">Low memory notifications</h2> - -<p><span id="result_box" lang="fr"><span class="hps">Le second mécanisme</span> <span class="hps">que nous utilisons pour</span> <span class="hps">libérer de la mémoire</span> <span class="hps">est</span> </span><em>low memory notifications</em><span lang="fr"><span>.</span> <span class="hps">Le</span> <span class="hps">LMK</span> <span class="hps">fournit</span> <span class="hps">un seuil</span> <span class="hps">spécial qui</span><span>,</span> <span class="hps">lorsqu'on les croise</span><span>,</span> <span class="hps">peut envoyer des</span> <span class="atn hps">notifications à l'</span><span>espace utilisateur</span> <span class="hps">qui exécute</span> <span class="hps">faible sur la mémoire</span><span>.</span> <span class="hps">La fois l'application</span> <span class="hps">du système et</span> <span class="hps">des applications</span> <span class="hps">régulières</span> <span class="hps">d'utilisateurs</span> <span class="hps">attendent</span> <span class="hps">en permanence</span> <span class="hps">pour cette condition</span> <span class="hps">et</span> <span class="hps">vont réagir</span> <span class="hps">sur elle</span> <span class="atn hps">par l'envoi d'</span><span>un événement</span> <span class="hps">mémoire</span> <span class="hps">pression par l'intermédiaire</span> <span class="hps">du service</span> <span class="hps">d'observateur</span><span>.</span> <span class="hps">Cet événement</span> <span class="hps">est visible uniquement</span> <span class="hps">à</span> <span class="hps">code C ++ et</span> <span class="hps">JS</span> <span class="hps">chrome</span> <span class="hps">et non pas directement</span> <span class="hps">par une application.</span> <span class="hps">Grâce à</span> <span class="hps">la base de code</span> <span class="hps">Gecko</span> <span class="hps">nous utilisons</span> <span class="hps">cet événement</span> <span class="hps">pour libérer</span> <span class="hps">autant de mémoire que</span> <span class="hps">nous pouvons -</span> <span class="hps">normalement</span> <span class="hps">en purgeant</span> <span class="hps">les caches internes</span> <span class="atn hps">(</span><span>images</span><span>,</span> <span class="hps">DNS</span><span>,</span> <span class="hps">sqlite</span><span>,</span> <span class="hps">etc.)</span><span>,</span> <span class="hps">l'abandon</span> <span class="hps">des actifs qui</span> <span class="hps">peuvent être recréées</span> <span class="atn hps">(</span><span>contexts</span> <span class="hps">WebGL</span> <span class="hps">par exemple</span><span>)</span> <span class="hps">et l'exécution du</span> <span class="hps">garbage collector</span> <span class="hps">et</span> <span class="hps">collecteur de cycles</span><span>.</span></span><br> - <br> - <span id="result_box" lang="fr"><span class="hps">Lorsqu'il rencontre</span> <span class="hps">une condition</span> <span class="hps">de mémoire</span> <span class="hps">faible</span></span> the premier <span class="short_text" id="result_box" lang="fr"><span class="hps">événement </span></span><code>memory-pressure</code> <span class="short_text" id="result_box" lang="fr"><span class="hps"> qui sera</span> <span class="hps">envoyé</span> <span class="hps">aura</span></span> the <code>low-memory</code> payload. <span id="result_box" lang="fr"><span class="hps">Si</span> <span class="hps">après un temps</span> <span class="hps">prédéfini</span> <span class="atn hps">(</span><span>5s</span><span>)</span> <span class="hps">nous sommes toujours</span> <span class="hps">dans une</span> <span class="hps">condition de mémoire</span> <span class="hps">faible un autre</span></span> <code>événement memory-pressure </code><span class="short_text" id="result_box" lang="fr"><span class="hps">sera</span> <span class="hps">tiré,</span> <span class="hps">mais cette fois avec</span> <span class="hps">le</span></span> <code>low-memory-ongoing</code> payload. <span id="result_box" lang="fr"><span class="hps">Ce</span> <span class="hps">payload est</span> <span class="hps">utilisé lorsque</span> <span class="hps">nous continuons à</span> <span class="hps">connaître des conditions</span> <span class="hps">de mémoire faible</span> <span class="hps">et nous voulons</span> <span class="hps">vider</span> <span class="hps">les caches</span> <span class="hps">et faire d'autres</span> <span class="hps">formes</span> <span class="hps">bon marché</span> <span class="hps">de la mémoire</span> <span class="hps">minimisation</span><span>,</span> <span class="hps">mais nous savons</span> <span class="hps">que les approches</span> <span class="hps">main lourde</span> <span class="hps">comme</span> <span class="hps">un</span> <span class="hps">GC</span> <span class="hps">est peu probable</span> <span class="hps">de réussir</span><span>.</span></span></p> - -<h2 id="Comment_le_LMK_et_le_low_memory_notifications_travaillent_ensemble">Comment le LMK et le low memory notifications travaillent ensemble</h2> - -<p><span id="result_box" lang="fr"><span class="hps">Actuellement, le</span></span> <a href="http://hg.mozilla.org/mozilla-central/file/545c35907eff/b2g/app/b2g.js#l722">seuil de memoire faible est réglé au dessus du niveau de LMK pour les applications en arrière</a>. <span id="result_box" lang="fr"><span class="hps">Donc</span> <span class="hps">l'action</span> <span class="hps">agrégée de la</span> <span class="hps">LMK</span> <span class="hps">et du low</span> <span class="hps">memory notifications </span><span class="hps">est la suivante</span> <span class="hps">lorsqu'un périphérique</span> <span class="hps">est à court de</span> <span class="hps">mémoire</span><span>:</span></span></p> - -<ol> - <li><span id="result_box" lang="fr"><span class="hps">Tuer des</span> <span class="hps">applications</span> <span class="hps">d'arrière-plan</span> <span class="hps">dans l'ordre</span> </span>least-recently-used<span lang="fr"><span>.</span></span></li> - <li><span class="short_text" id="result_box" lang="fr"><span class="hps">Si nous ne</span> <span class="hps">libérons</span> <span class="hps">assez de mémoire</span><span>, envoyez des événements</span></span> <code>memory-pressure</code> <span class="short_text" id="result_box" lang="fr"><span class="hps">à toutes les applications</span> <span class="hps">restantes</span></span>.</li> - <li>Si la condition persiste, renvoyer un événement <code>memory-pressure</code> chaque 5 secondes, <span id="result_box" lang="fr"><span class="hps">mais</span> <span class="hps">les marquer comme</span> <span class="hps">en cours</span> <span class="hps">de sorte que le</span> <span class="hps">GC</span> <span class="hps">/</span> <span class="hps">CC</span> <span class="hps">ne réagit</span> <span class="hps">pas à eux.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Tuer des</span> <span class="hps">applications de fond</span> <span class="hps">perceptibles</span> <span class="hps">ou</span> <span class="hps">hautement prioritaires</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Tuez</span> <span class="hps">l'application du clavier</span><span>,</span> <span class="hps">si elle est</span> <span class="hps">en cours d'exécution</span><span>.</span></span></li> - <li><span class="short_text" id="result_box" lang="fr"><span class="hps">Tuer des</span> <span class="hps">applications de premier plan</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Tuer des</span> <span class="hps">applications de premier plan</span> <span class="hps">de haute priorité</span><span>.</span></span></li> - <li><span class="short_text" id="result_box" lang="fr"><span class="hps">Tuer</span> <span class="hps">le processus</span> <span class="hps">préallouée</span><span>.</span></span></li> -</ol> diff --git a/files/fr/archive/b2g_os/platform/gonk/index.html b/files/fr/archive/b2g_os/platform/gonk/index.html deleted file mode 100644 index 1e983c5d12..0000000000 --- a/files/fr/archive/b2g_os/platform/gonk/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Gonk -slug: Archive/B2G_OS/Platform/Gonk -tags: - - Firefox OS - - Gonk -translation_of: Archive/B2G_OS/Platform/Gonk ---- -<div class="summary"> -<p>Gonk est le système d'exploitation bas niveau de la plate-forme <a href="/fr/docs/Mozilla/Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS">Firefox OS</a>, comprenant un noyau Linux basé sur l'<a class="external" href="http://source.android.com/">Android Open Source Project</a> (AOSP) et la couche d'abstraction matérielle (HAL) userspace. Cet article a pour but d'expliquer de quoi est fait Gonk ; pour plus d'informations sur l'ensemble de l'architecture Firefox OS et comment Gonk s'y intègre, lisez notre guide <a href="/fr/Firefox_OS/Platform/Architecture">l'architecture Firefox OS</a>.</p> -</div> - -<h2 id="Vue_d'ensemble_de_Gonk">Vue d'ensemble de Gonk</h2> - -<p>Gonk constitue le noyau de Firefox OS, qui sert d'interface entre Gecko et la couche matérielle. Gonk contrôle le matériel et expose ses fonctionnalités aux WebAPI implémentées dans Gecko. Gonk peut être vu comme la « boîte noire » qui fait le travail complexe et minutieux de contrôler l'appareil en exécutant les requêtes sur la couche matérielle.</p> - -<p>Gonk est tout simplement une distribution Linux incluant des composants d'Android (comme le GPS ou l'appareil photo) ainsi que des projets libres communs ajoutés par Mozilla (comme libusb ou bluez) afin de pouvoir l'intégrer facilement à toutes les couches de l'architecture de Firefox OS. Cette conception facilite, pour les OEM, le portage d'éléments logiciels développés pour Android (pilote, firmware, service daemon, etc.), dans le but de les déployer sur des smartphones Firefox OS.</p> - -<p>Dans les sources de Gecko, il y a un dossier <code>b2g/</code> qui contient le Gonk Port, qui déverrouille les capacités matérielles mobiles pour le Web. Cela consiste en un noyau Linux, HAL, et d'autres bibliothèques spécifiques aux OEM. Plusieurs des bibliothèques Gonk sont des projets open-source communs : libusb, bluez, et ainsi de suite. Certaines autres parties de la HAL sont partagées avec le projet Android : GPS, appareil photo et autres.</p> - -<p>Gonk est une couche de portage de l'appareil : un adaptateur entre le matériel et Gecko. Gonk est une distribution Linux relativement simple qui peut être considérée comme une association de Gecko Port et des couches de portage Gecko. Gonk est ainsi une <strong>cible de portage</strong> de <a href="/fr/docs/Gecko" title="/en-US/docs/Gecko">Gecko</a>, tout comme il y a un portage de Gecko pour OS X, Windows et Android.</p> - -<div class="note"> -<p><strong>Note </strong>: Comme les différents matériels mobiles peuvent avoir différents chipsets et autres spécifications matérielles, les appareils peuvent contenir différentes distributions de Gonk.</p> -</div> - -<p>Comme le projet Firefox OS a le contrôle total sur Gonk, nous pouvons exposer des interfaces à Gecko qui ne pourraient pas être exposées à d'autres systèmes d'exploitation. Par exemple, Gecko a un accès direct à la couche de téléphonie complète et au buffer de trame d'affichage sur Gonk.</p> - -<h2 id="Architecture_de_Gonk">Architecture de Gonk</h2> - -<p>Chaque modèle de téléphone possède son propre ensemble de composants Gonk, parmi les bibliothèques du système, pilotes matériels et firmwares nécessaires pour le faire fonctionner. Ces composants sont déterminés par l'OEM en collaboration avec le fabricant du chipset et l'ODM. Le schéma suivant représente un exemple d'implémentation de Gonk :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/9489/gonk-architecture.png" style="display: block; height: 329px; margin: 0px auto; width: 987px;"></p> - -<p>Cet exemple montre les composants principaux suivants (ce qui représente uniquement un sous-ensemble des composants que l'on peut retrouver dans n'importe quelle implémentation de Gonk).</p> - -<ul> - <li><strong>Linux Kernel</strong> : le noyau Linux qui utilise des bibliothèques d'Android (GPS, appareil photo etc.) et d'autres projets open source (Linux, libusb, bluez, etc.).</li> - <li><strong>Radio Interface Layer (RIL) </strong>: interagit avec le modem matériel du téléphone (téléphonie). Constitué de 2 éléments : - <ul> - <li><strong>rild daemon </strong>: communique avec le firmware du modem.</li> - <li><strong>rilProxy </strong>: transfert les messages entre rild et le processus b2g.</li> - </ul> - </li> - <li><strong>mediaserver</strong> : contrôle la lecture audio et vidéo. Gecko communique avec le serveur de média à l'aide d'Android RPC.</li> - <li><strong>netd</strong> : daemon réseau qui interagit directement avec les interfaces réseau (Wi-Fi) du matériel.</li> - <li><strong>Bluetooth, etc.</strong> : Bluetooth et d'autres services daemon qui permettent l'accès aux fonctionnalités matérielles.</li> -</ul> - -<p>Gonk s'occupe aussi de démarrer, gérer et arrêter le processus b2g, autrement dit Gecko, dans Firefox OS. Le processus b2g agit comme un client des services daemons de Gonk qui communiquent directement avec le matériel et exposent à Gecko les fonctionnalités matérielles du téléphone. Gecko communique avec ces daemons via une communication inter-process (IPC). Ces composants s'échangent des commandes et des protocoles pour demander et proposer leurs services.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations concernant l'architecture de Gonk, voir le <a href="/fr/Firefox_OS/Platform/Architecture">guide sur l'architecture de Firefox OS</a>.</p> -</div> - -<h2 id="Portage_de_Gonk">Portage de Gonk</h2> - -<p>Parce que Firefox OS est basé sur le noyau Android, le portage sous Firefox OS de pilotes matériels, de firmwares, de services daemons, ou d'autres composants Android ne nécessite habituellement qu'un minimum d'efforts. Si un composant spécifique (par exemple un RIL particulier ou un nouveau daemon) est nécessaire, ou si une modification doit être apportée à la conception d'un ODM, alors un supplément de travail d'intégration et de test peut être requis.</p> - -<p>Dans b2g, les clients communiquent avec les services daemons via une communication inter-process (IPC). Le client instancie une socket de connexion vers le service daemon, y envoie sa requête (en respectant le protocole du serveur de requête), reçoit la réponse et ferme la connexion. Les OEM sont responsables de la conception et de l'implémentation de ces communications inter-processus entre clients et serveurs.</p> - -<div class="note"> -<p><strong>Note </strong>: Pour plus d'informations concernant le fonctionnement du processus de portage, voir <a href="/fr/Firefox_OS/Developing_Firefox_OS/Porting">Porter Firefox OS</a>.</p> -</div> - -<h3 id="Comment_Mozilla_participe_au_portage_de_Gonk_avec_les_OEM_et_fabricants_de_téléphones">Comment Mozilla participe au portage de Gonk avec les OEM et fabricants de téléphones</h3> - -<p>Chaque implémentation de Gonk est le résultat d'une collaboration entre Mozilla, les OEM, et les fabricants associés (ODM, fabricant chipset).</p> - -<p>Mozilla fournit les dépôts des sources et les fichiers nécessaires pour la prise en charge de Gonk dans ses distributions Firefox OS. Les dépôts des sources contiennent le noyau Linux de base (avec uniquement de légères modifications) et les personnalisations de Gecko (« hooks »).</p> - -<p>Les OEM sont responsables de la compilation, du test, de la certification ainsi que de la distribution de l'image système Firefox OS pour un modèle d'appareil donné. Pour la partie Gonk de l'image système, les OEM sont responsables de la bonne intégration entre les appels aux API Web et les fonctionnalités matérielles. Le type et l'ampleur des efforts requis est hautement dépendant des choix des composants matériels du téléphone.</p> - -<h3 id="Composants_d'un_appareil">Composants d'un appareil</h3> - -<p>Les OEM collaborent avec les fabricants de chipset et les ODM pour fournir tous les composants spécifiques à l'appareil qui sont nécessaires à son bon fonctionnement. Par exemple, un fabricant du composant Wi-Fi doit fournir le chipset et le logiciel associé. Les composants peuvent inclure :</p> - -<ul> - <li>Pilotes — Pour les fonctionnalités prises en charge par le téléphone, comme le modem (données et voix), Wi-Fi, Bluetooth, affichage, appareil photo, audio, etc.</li> - <li>Firmware — Certains matériels (la carte d'interface réseau par exemple) peuvent charger un firmware depuis le lecteur flash.</li> - <li>Services daemons — Pour appeler et gérer les opérations de divers composants matériels. Ceci peut inclure des bibliothèques de prise en charge et des scripts de démarrage.</li> -</ul> - -<h3 id="Intégration_de_Gonk_et_Gecko">Intégration de Gonk et Gecko</h3> - -<p>Les OEM doivent s'assurer que les fonctionnalités matérielles de l'appareil sont correctement et complètement exposées aux API Web implémentées dans Gecko. Ceci nécessite de :</p> - -<ul> - <li>Construire ou adapter (dans Gonk) les services daemons correspondant, ainsi que les éventuels pilotes ou firmware nécessaires à la gestion de la fonctionnalité matérielle.</li> - <li>Définir (dans b2g) toutes les méthodes nécessaires à la communication avec les services daemons.</li> -</ul> - -<h2 id="Code_source_de_Gonk">Code source de Gonk</h2> - -<p>Le principal <a href="https://github.com/mozilla-b2g/B2G">dépôt B2G sur Github</a> contient les portages officiels prenant en charge Gonk pour divers appareils, vous pouvez donc le considérer comme le dépôt de Gonk. La liste des appareils pris en charge est disponible dans <code>B2G/config.sh</code>.</p> - -<p>La plupart du travail quotidien effectué sur Gonk implique de porter le système sur différentes cartes et de s'assurer que Gecko fonctionne correctement sur différents appareils.</p> - -<dl> -</dl> - -<p> </p> diff --git a/files/fr/archive/b2g_os/platform/index.html b/files/fr/archive/b2g_os/platform/index.html deleted file mode 100644 index 5af7b36d25..0000000000 --- a/files/fr/archive/b2g_os/platform/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: La plate-forme Firefox OS -slug: Archive/B2G_OS/Platform -translation_of: Archive/B2G_OS/Platform ---- -<p>La plate-forme Firefox OS regroupe de nombreux composants. Même si vous n'avez pas besoin de comprendre son architecture pour développer des applications Firefox OS, la documentation suivante pourra vous intéresser, que vous travailliez au développement ou au portage de la plate-forme — ou que vous soyez simplement curieux.</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation" name="Documentation">Documentation à propos de la plate-forme Firefox OS</h2> - - <dl> - <dt><a href="https://developer.mozilla.org/fr/docs/Mozilla/Boot_to_Gecko/Introduction" title="fr/docs/Mozilla/Boot_to_Gecko/Introduction">Introduction à Firefox OS</a></dt> - <dd>Introduction à la nature et au fonctionnement de Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" title="en-US/docs/Mozilla/Firefox_OS/Building and installing Boot to Gecko">Compiler et installer Firefox OS</a></dt> - <dd>Un guide pour compiler Firefox OS et l'installer sur votre appareil compatible. Ce guide couvre également la compilation de l'émulateur Firefox OS, pour faire fonctionner Firefox OS sur un ordinateur.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Gaia" title="/en-US/docs/Mozilla/Gaia">Gaia</a></dt> - <dd>Documentation à propos de Gaia, l'interface utilisateur des appareils Firefox OS ;<span> c'est </span><span id="Dst[0][8:8:10:14]">une</span><span> </span><span id="Dst[0][14:24:16:26]">application</span><span> </span><span id="Dst[0][10:12:28:30]">web</span><span> </span><span id="Dst[0][26:32:32:51]">fonctionnant</span><span> </span><span id="Dst[0][34:37:53:61]">au dessus </span><span>de </span><span id="Dst[0][39:41:66:67]">la</span><span> </span><span id="Dst[0][63:67:69:72]">couche</span><span> </span><span id="Dst[0][54:61:77:84]">logicielle</span><span> </span><span id="Dst[0][43:49:86:92]">de Firefox</span><span> </span><span id="Dst[0][51:52:94:95]">OS</span>.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Gonk">Gonk</a></dt> - <dd>Documentation à propos de Gonk, - <div class="mttextarea" dir="ltr" id="TranslationOutput"> - <div><span id="Dst[0][0:2:0:1]">la</span><span> </span><span id="Dst[0][21:25:3:8]">couche</span><span> de </span><span id="Dst[0][14:19:13:19]">système</span><span> </span><span id="Dst[0][4:12:21:34]">d'exploitation</span><span> </span><span id="Dst[0][27:36:36:39]">sous</span><span> </span><span id="Dst[0][38:41:41:44]">Gaia</span>. Il s'agit d'un noyau Linux <span id="Dst[0][32:34:27:28]">et</span><span> </span><span id="Dst[0][36:36:30:34]">d'une</span><span> </span><span id="Dst[0][59:63:36:41]">couche</span><span> </span><span id="Dst[0][47:57:43:55]">d'abstraction</span><span> </span><span id="Dst[0][38:45:57:66]">matérielle</span><span> </span><span id="Dst[0][65:66:68:68]">avec</span><span> </span><span id="Dst[0][68:72:70:77]">laquelle</span><span> </span><span id="Dst[0][74:78:79:83]">Gecko</span><span> </span><span id="Dst[0][80:91:85:94]">communique</span><span>.</span></div> - </div> - </dd> - <dt><a href="/en-US/docs/Gecko" title="/en-US/docs/Gecko">Gecko</a></dt> - <dd> - <div class="mttextarea" dir="ltr" id="TranslationOutput"> - <div><span id="Dst[0][0:4:0:4]">Gecko</span><span> </span><span id="Dst[0][6:7:6:8]">est</span><span> </span><span id="Dst[0][9:11:10:11]">la</span><span> </span><span id="Dst[0][13:17:13:18]">couche</span> <span>de </span><span id="Dst[0][22:28:28:34]">Firefox</span><span> OS </span><span id="Dst[0][33:36:36:38]">qui</span><span> </span><span id="Dst[0][38:45:40:46]">fournit</span><span> </span><span id="Dst[0][47:49:48:53]">les</span><span> </span><span id="Dst[0][51:54:55:58]">mêmes standards d'applications web ouverts</span><span> </span><span id="Dst[0][90:93:94:101]">utilisés</span><span> </span><span id="Dst[0][95:96:103:105]">par</span><span> </span><span id="Dst[0][98:104:107:113]">Firefox Desktop</span><span> </span><span id="Dst[0][106:108:115:116]">et</span><span> </span><span id="Dst[0][110:120:118:128]">Thunderbird</span><span>,</span><span> </span><span id="Dst[0][126:129:131:135]">ainsi</span><span> </span><span id="Dst[0][131:132:137:139]">que</span><span> par de </span><span id="Dst[0][134:137:144:153]">nombreuses</span><span> </span><span id="Dst[0][139:143:155:160]">autres</span><span> </span><span id="Dst[0][145:156:162:173]">applications</span>.</div> - </div> - </dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Feature_support_chart" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Feature_support_chart">Graphique des fonctionnalités</a></dt> - <dd> - <div class="mttextarea" dir="ltr" id="TranslationOutput"> - <div><span id="Dst[0][0:0:0:1]">Un</span><span> </span><span id="Dst[0][2:6:3:11]">graphique</span><span> </span><span id="Dst[0][11:15:13:16]">d</span><span>es </span><span id="Dst[0][17:24:22:36]">fonctionnalités</span><span> </span><span id="Dst[0][30:38:43:53]">disponibles</span><span> </span><span id="Dst[0][40:41:55:58]">dans</span><span> les différents </span><span id="Dst[0][49:53:64:68]">types</span><span> </span><span>de builds de </span><span id="Dst[0][58:64:78:84]">Firefox</span><span> </span><span id="Dst[0][43:47:86:88]">OS</span><span>.</span></div> - </div> - </dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Architecture" title="/en-US/docs/Mozilla/Firefox_OS/Architecture">Vue d'ensemble de l'architecture de Firefox OS</a></dt> - <dd>Une vue d'ensemble de la structure interne de Firefox OS ;<span id="Dst[0][0:3:0:1]"> ceci est </span><span id="Dst[0][8:16:10:23]">principalement</span><span> orienté</span><span> </span><span id="Dst[0][30:31:35:38]">pour</span><span> les </span><span id="Dst[0][42:51:44:55]">développeurs</span><span> de la </span><span id="Dst[0][33:40:63:72]">plate-forme</span><span> </span><span id="Dst[0][53:55:74:75]">et</span><span> les </span><span id="Dst[0][57:62:81:84]">gens</span><span> </span><span id="Dst[0][78:81:98:104]">qui travaillent</span><span> sur le p</span><span id="Dst[0][70:76:109:115]">ortage</span><span> de Firefox OS.</span></dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Apps_architecture" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Apps_architecture">Firefox OS apps architecture</a></dt> - <dd>Une vue d'ensemble du modèle d'application sur Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Testing_Firefox_OS" title="en-US/docs/Mozilla/Firefox_OS/Testing Boot to Gecko">Tester Firefox OS</a></dt> - <dd>Un guide pour tester Firefox OS, incluant des informations sur la création de tests automatisés.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Porting" title="/en-US/docs/Mozilla/Firefox_OS/Porting">Portage de Firefox OS</a></dt> - <dd>Informations à propos du portage de Firefox OS sur de nouveaux appareils.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">Personnalisation avec le fichier .userconfig</a></dt> - <dd><span class="long_text" id="result_box" lang="fr"><span title="How to customize the build and execution of Firefox OS by changing the .userconfig file.">Comment personnaliser la compilation et l'exécution de Firefox OS en modifiant le fichier .userconfig.</span></span></dd> - </dl> - - <p><span class="alllinks"><a href="/en-US/docs/tag/B2G" title="/en-US/docs/tag/B2G">Tous les guides...</a></span></p> - </td> - <td> - <h2 class="Community" id="Community" name="Community">Obtenir de l'aide de la communauté</h2> - - <p>Si vous travaillez avec Firefox OS ou développez des applications que vous aimeriez voir fonctionner sur des appareils Firefox OS, des ressources communautaires sont à votre disposition !</p> - - <ul> - <li>Consultez le forum Boot to Gecko : <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-b2g"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.b2g"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.b2g/feeds"> Flux de syndication</a></li> -</ul></li> - <li>Posez votre question sur le canal IRC de Mozilla : <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a></li> - </ul> - - <p><span class="alllinks"><a class="external" href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.gnurou.org/writing/smartquestionsfr">N'oubliez pas la <em>netiquette</em></a> pour poser vos questions…</span></p> - - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">ARTICLES SIMILAIRES</h2> - - <ul> - <li><a href="/fr/docs/Mobile" title="en-US/docs/Mobile">Mobile</a></li> - <li><a href="/fr/docs/HTML" title="en-US/docs/HTML">HTML</a></li> - <li><a href="/fr/docs/CSS" title="en-US/docs/CSS">CSS</a></li> - <li><a href="/fr/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a></li> - </ul> - - <h2 class="Tools" id="Ressources">Ressources</h2> - - <ul> - <li><a class="link-https" href="https://wiki.mozilla.org/B2G/FAQ" title="B2G/FAQ">FAQ Mozilla</a></li> - <li><a class="link-https" href="https://wiki.mozilla.org/B2G/Schedule_Roadmap" title="https://wiki.mozilla.org/B2G/Schedule_Roadmap">Roadmap</a></li> - <li>Feature support chart</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/fr/archive/b2g_os/platform/settings_list/index.html b/files/fr/archive/b2g_os/platform/settings_list/index.html deleted file mode 100644 index e20105cd79..0000000000 --- a/files/fr/archive/b2g_os/platform/settings_list/index.html +++ /dev/null @@ -1,717 +0,0 @@ ---- -title: Firefox OS settings list -slug: Archive/B2G_OS/Platform/Settings_list -tags: - - API - - B2G - - Firefox OS - - Paramètres - - Reference - - Référence(2) - - WebAPI -translation_of: Archive/B2G_OS/Platform/Settings_list ---- -<div class="summary"> - <p><span class="seoSummary">Firefox OS offre un certain nombre de paramètres pour configurer l'appareil et ses fonctionnalités intégrées. Ces paramètres sont accessibles par les applications certifiées à l'aide de l'<a href="/en-US/docs/WebAPI/Settings" title="/en-US/docs/WebAPI/Settings">API Settings</a>.</span></p> -</div> -<div class="note"> - <p><strong>Note:</strong> A cause des différentes fonctionnalités fournies par les différents appareils et les différentes versions de Firefox OS, cette liste peut être exactement conforme ou non à ce qui est disponible sur chaque appareil.</p> -</div> -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Nom du paramètre</th> - <th scope="col">Type</th> - <th scope="col">Valeur par défaut</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>accessibility.invert</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>accessibility.screenreader</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>alarm.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>app.reportCrashes</code></td> - <td>Chaîne</td> - <td><code>ask</code></td> - </tr> - <tr> - <td><code>app.update.interval</code></td> - <td>Nombre</td> - <td>86400</td> - </tr> - <tr> - <td><code>audio.volume.alarm</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.bt_sco</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.dtmf</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.content</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.notification</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.tts</code></td> - <td>Nombre</td> - <td>15</td> - </tr> - <tr> - <td><code>audio.volume.telephony</code></td> - <td>Nombre</td> - <td>5</td> - </tr> - <tr> - <td><code>bluetooth.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>bluetooth.debugging.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>camera.shutter.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>clear.remote-windows.data</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.grid.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.oop.disabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.fps.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.ttl.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.log-animations.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.paint-flashing.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>debug.peformancedata.shared</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>deviceinfo.firmware_revision</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.hardware</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.os</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.platform_build_id</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.platform_version</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.software</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>deviceinfo.update_channel</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>gaia.system.checkForUpdates</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>general.useragent.updates.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>geolocation.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.english</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.dvorak</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.otherlatins</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.cyrillic</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.arabic</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.hebrew</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.zhuyin</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.pinyin</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.greek</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.japanese</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.polish</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.portuguese</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.layouts.spanish</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.vibration</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.clicksound</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>keyboard.autocorrect</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>keyboard.wordsuggestion</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>keyboard.current</code></td> - <td>Chaîne</td> - <td><code>en</code></td> - </tr> - <tr> - <td><code>language.current</code></td> - <td>Chaîne</td> - <td><code>en-US</code></td> - </tr> - <tr> - <td><code>lockscreen.passcode-lock.code</code></td> - <td>Chaîne</td> - <td><code>0000</code></td> - </tr> - <tr> - <td><code>lockscreen.passcode-lock.timeout</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>lockscreen.passcode-lock.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>lockscreen.notifications-preview.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>lockscreen.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>lockscreen.locked</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>lockscreen.unlock-sound.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>mail.sent-sound.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>message.sent-sound.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>operatorvariant.mcc</code></td> - <td>Chaîne</td> - <td><code>0</code></td> - </tr> - <tr> - <td><code>operatorvariant.mnc</code></td> - <td>Chaîne</td> - <td><code>0</code></td> - </tr> - <tr> - <td><code>ril.iccInfo.mbdn</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.sms.strict7BitEncoding.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.cellbroadcast.searchlist</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>debug.console.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>phone.ring.keypad</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>powersave.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>powersave.threshold</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>privacy.donottrackheader.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.callwaiting.enabled</code></td> - <td> </td> - <td> </td> - </tr> - <tr> - <td><code>ril.cf.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.data.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.data.apn</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.carrier</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.defaultServiceId</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>ril.data.passwd</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.httpProxyHost</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.httpProxyPort</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>ril.data.mmsc</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.mmsproxy</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.data.mmsport</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>ril.data.roaming_enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.data.user</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.apn</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.carrier</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.httpProxyHost</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.httpProxyPort</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.mmsc</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.mmsport</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.mmsproxy</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.passwd</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.mms.user</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.radio.preferredNetworkType</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.radio.disabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.supl.apn</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.supl.carrier</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.supl.httpProxyHost</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.supl.httpProxyPort</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.supl.passwd</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.supl.user</code></td> - <td>Chaîne</td> - <td> </td> - </tr> - <tr> - <td><code>ril.sms.strict7BitEncoding.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ril.sms.</code>defaultServiceId</td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>ril.telephony.</code>defaultServiceId</td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>ring.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>screen.automatic-brightness</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>screen.brightness</code></td> - <td>Nombre</td> - <td>1</td> - </tr> - <tr> - <td><code>screen.timeout</code></td> - <td>Nombre</td> - <td>60</td> - </tr> - <tr> - <td><code>tethering.usb.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>tethering.usb.ip</code></td> - <td>Chaîne</td> - <td><code>192.168.0.1</code></td> - </tr> - <tr> - <td><code>tethering.usb.prefix</code></td> - <td>Chaîne</td> - <td><code>24</code></td> - </tr> - <tr> - <td><code>tethering.usb.dhcpserver.startip</code></td> - <td>Chaîne</td> - <td><code>192.168.0.10</code></td> - </tr> - <tr> - <td><code>tethering.usb.dhcpserver.endip</code></td> - <td>Chaîne</td> - <td><code>192.168.0.30</code></td> - </tr> - <tr> - <td><code>tethering.wifi.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>tethering.wifi.ip</code></td> - <td>Chaîne</td> - <td><code>192.168.1.1</code></td> - </tr> - <tr> - <td><code>tethering.wifi.prefix</code></td> - <td>Chaîne</td> - <td><code>24</code></td> - </tr> - <tr> - <td><code>tethering.wifi.dhcpserver.startip</code></td> - <td>Chaîne</td> - <td><code>192.168.1.10</code></td> - </tr> - <tr> - <td><code>tethering.wifi.dhcpserver.endip</code></td> - <td>Chaîne</td> - <td><code>192.168.1.30</code></td> - </tr> - <tr> - <td><code>tethering.wifi.ssid</code></td> - <td>Chaîne</td> - <td><code>FirefoxHotspot</code></td> - </tr> - <tr> - <td><code>tethering.wifi.security.type</code></td> - <td>Chaîne</td> - <td><code>open</code></td> - </tr> - <tr> - <td><code>tethering.wifi.security.password</code></td> - <td>Chaîne</td> - <td><code>1234567890</code></td> - </tr> - <tr> - <td><code>tethering.wifi.connectedClients</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>tethering.usb.connectedClients</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>time.nitz.automatic-update.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>time.timezone</code></td> - <td> </td> - <td> </td> - </tr> - <tr> - <td><code>ums.enabled</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>ums.mode</code></td> - <td>Nombre</td> - <td>0</td> - </tr> - <tr> - <td><code>vibration.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>wifi.enabled</code></td> - <td>Booléen</td> - <td><code>true</code></td> - </tr> - <tr> - <td><code>wifi.screen_off_timeout</code></td> - <td>Nombre</td> - <td>600000</td> - </tr> - <tr> - <td><code>wifi.disabled_by_wakelock</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>wifi.notification</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>wifi.connect_via_settings</code></td> - <td>Booléen</td> - <td><code>false</code></td> - </tr> - <tr> - <td><code>icc.displayTextTimeout</code></td> - <td>Nombre</td> - <td>40000</td> - </tr> - <tr> - <td><code>icc.inputTextTimeout</code></td> - <td>Nombre</td> - <td>40000</td> - </tr> - </tbody> -</table> -<h2 id="Voir_aussi">Voir aussi</h2> -<ul> - <li><a href="/en-US/docs/WebAPI/Settings" title="/en-US/docs/WebAPI/Settings">API Settings</a></li> - <li><a href="/fr/docs/Web/API/SettingsManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>SettingsManager</code></a></li> - <li><a href="/fr/docs/Web/API/Window/navigator/mozSettings" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.mozSettings</code></a></li> - <li><a href="https://github.com/mozilla-b2g/gaia/tree/master/build/config">fichiers de configuration dans le dépot gaia</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/platform/support_fonctionnalites/index.html b/files/fr/archive/b2g_os/platform/support_fonctionnalites/index.html deleted file mode 100644 index 8b08ea075e..0000000000 --- a/files/fr/archive/b2g_os/platform/support_fonctionnalites/index.html +++ /dev/null @@ -1,160 +0,0 @@ ---- -title: Support des fonctionnalités -slug: Archive/B2G_OS/Platform/support_fonctionnalites -tags: - - AQ - - B2G - - Firefox OS - - Mobile -translation_of: Archive/B2G_OS/Platform/Feature_support_chart ---- -<p></p> - -<p class="summary"><span class="seoSummary">Il existe différents builds de Firefox OS que vous pouvez télécharger ou compiler vous même. Il y a quelques différences entre les fonctionnalités accessibles sur chaque appareil. Le tableau ci-dessous devrait vous aider à comprendre ce qui fonctionne, ou ne fonctionne pas, en fonction des différents builds.</span></p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="row">Fonction</th> - <th scope="col">Appareil</th> - <th scope="col">Émulateur</th> - <th scope="col">Ordinateur</th> - </tr> - </thead> - <tbody> - <tr> - <th scope="row">Téléphone</th> - <td>Tout</td> - <td>Seulement l'interface, pas de réseau</td> - <td>Seulement l'interface, pas de réseau</td> - </tr> - <tr> - <th scope="row">Contacts</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">SMS</th> - <td>Tout</td> - <td>Seulement l'interface, pas de réseau</td> - <td>Seulement l'interface, pas de réseau</td> - </tr> - <tr> - <th scope="row">Camera</th> - <td>Tout</td> - <td>Seulement l'interface, pas de support de la camera</td> - <td>Seulement l'interface, incertain sur le support de la webcam pour le moment</td> - </tr> - <tr> - <th scope="row">Gallerie</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Vidéo</th> - <td>Tout</td> - <td>Seulement l'interface</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Musique</th> - <td>Tout</td> - <td> </td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Radio FM</th> - <td>Tout</td> - <td>Tout</td> - <td>Seulement l'interface</td> - </tr> - <tr> - <th scope="row">E-mail</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Calculette</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Navigateur</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Marketplace</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Horloge</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Calendrier</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Écran d'accueil</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Écran verouillé</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Clavier</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Gestionnaire de tâche</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Premier lancement</th> - <td>Tout</td> - <td>?</td> - <td>?</td> - </tr> - <tr> - <th scope="row">Notification</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - <tr> - <th scope="row">Barre d'état</th> - <td>Tout</td> - <td>Certains états réseaux ne peuvent être testés</td> - <td>Certains états réseaux ne peuvent être testés</td> - </tr> - <tr> - <th scope="row">Paramètres</th> - <td>Tout</td> - <td>Tout</td> - <td>Tout</td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/fr/archive/b2g_os/portage/index.html b/files/fr/archive/b2g_os/portage/index.html deleted file mode 100644 index e463846081..0000000000 --- a/files/fr/archive/b2g_os/portage/index.html +++ /dev/null @@ -1,244 +0,0 @@ ---- -title: Porter Boot to Gecko -slug: Archive/B2G_OS/Portage -tags: - - B2G - - B2GOS - - Mobile -translation_of: Archive/B2G_OS/Porting_B2G_OS/basics ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p class="summary">B2G OS utilise un noyau dérivé d'<a href="http://www.android.com/" title="http://www.android.com/">Android</a>, avec par dessus une interface utilisateur basée sur <a href="/en-US/docs/Gecko" title="Gecko">Gecko</a>. Cet article fournit un guide de base sur la façon de porter le système d'exploitation sur de nouveaux appareils.</p> - -<p>Ce guide suppose que vous faite un portage sur un nouvel appareil qui exécute déjà Android; si vous faites un portage vers un autre type d'appareil, le travail va nécessiter davantage d'investissement.</p> - -<div class="note"> -<p><strong>Note </strong>: Vous pouvez trouver de l'aide concernant le portage sur le canal IRC #fxos et sur <a href="https://discourse.mozilla-community.org/c/firefox-os-participation/porting">Mozilla Discourse.</a></p> -</div> - -<h2 id="Configurer_votre_système_de_build">Configurer votre système de build</h2> - -<p>La première étape consiste à configurer votre système de buid; vous pouvez suivre le guide <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites">pré-requis pour compiler B2G OS</a>.</p> - -<h2 id="Créer_une_sauvegarde_locale_du_système_Android_d'origine">Créer une sauvegarde locale du système Android d'origine</h2> - -<p>Ensuite, vous devez faire une sauvegarde de votre appareil Android avant de commencer à l'atomiser avec vos builds de test de B2G. De plus, certaines parties seront nécessaires pour le processus de build et d'installation. Pour le nom de l'appareil, nous recommandons l'utilisation de "_" au lieu de "-". Voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1243349" title="FIXED: Firefox fails to link against nspr libraries">bug 1243349</a> pour les raisons de ce choix. </p> - -<pre class="brush: bash">mkdir sauvegarde_de_mon_appareil -cd sauvegarde_de_mon_appareil -adb pull /system system</pre> - -<h2 id="Cloner_les_répertoires_B2G">Cloner les répertoires B2G</h2> - -<p>La première étape consiste à cloner le dépôt B2G ainsi que le dépôt contenant les manifestes.</p> - -<pre class="brush: bash">git clone https://github.com/mozilla-b2g/B2G.git -git clone https://github.com/mozilla-b2g/b2g-manifest.git</pre> - -<h2 id="Ajouter_un_nouvel_appareil_à_config.sh">Ajouter un nouvel appareil à config.sh</h2> - -<p>L'étape suivante consiste à ajouter un nouvel appareil à <a href="https://github.com/mozilla-b2g/B2G/blob/master/config.sh" title="https://github.com/mozilla-b2g/B2G/blob/master/config.sh"><code>config.sh</code></a> dans le dépôt B2G; vous pouvez utiliser un de ceux qui existent comme modèle. Ceci implique simplement de fournir les instructions permettant de récupérer les bons fichiers pour faire le build.</p> - -<h2 id="Créer_un_manifeste_pour_le_nouvel_appareil">Créer un manifeste pour le nouvel appareil</h2> - -<p>Mainenant, vous devez ajouter un fichier manifeste pour le nouvel appareil. Utilisez l'un des manifestes existant comme modèle. Vous pouvez utiliser le manifeste <a href="https://github.com/mozilla-b2g/b2g-manifest/blob/master/hamachi.xml" title="https://github.com/mozilla-b2g/b2g-manifest/blob/master/hamachi.xml">hamachi</a> comme référence. Une fois que c'est fait, vous pouvez ajouter et livrer votre nouveau manifeste dans votre dépôt local b2g-manifest :</p> - -<pre class="brush: bash">git add mon-nouvel-appareil.xml -git commit -</pre> - -<p>Ensuite, il faudra indiquer au fichier <a href="https://github.com/mozilla-b2g/B2G/blob/master/config.sh" title="https://github.com/mozilla-b2g/B2G/blob/master/config.sh"><code>config.sh</code></a> d'utiliser votre dépôt local b2g-manifest à la place du dépôt officiel. Pour réaliser cela, modifiez la valeur des variables GITREPO et BRANCH dans le fichier <a href="https://github.com/mozilla-b2g/B2G/blob/master/config.sh" title="https://github.com/mozilla-b2g/B2G/blob/master/config.sh"><code>config.sh</code></a> pour qu'elles pointent vers l'emplacement de votre dépôt local et de la branche souhaitée, par exemple :</p> - -<pre class="brush: bash"><span class="nv">GITREPO</span><span class="o">=</span><span class="k">${</span><span class="nv">GITREPO</span><span class="k">:-</span><span class="s2">"file:///home/votrenom/b2g-manifest"</span><span class="k">}</span> -<span class="nv">BRANCH</span><span class="o">=</span><span class="k">${</span><span class="nv">BRANCH</span><span class="k">:-master</span><span class="k">}</span></pre> - -<h2 id="Créer_une_arborescence_de_configuration_pour_le_nouvel_appareil">Créer une arborescence de configuration pour le nouvel appareil</h2> - -<p>Créer une nouvelle arborescence pour le nouvel appareil. Elle doit se trouver dans <code>device/<em><manufacturer></em>/<em><device_id></em></code>. Cette arborescence doit inclure au moins :</p> - -<ul> - <li><code>AndroidBoard.mk</code></li> - <li><code>AndroidProducts.mk</code></li> - <li><code>BoardConfig.mk</code></li> - <li><code>extract-files.sh</code></li> - <li><code>full_<device_id>.mk</code></li> - <li>fichiers idc pour l'écran tactile</li> - <li>fichiers init (<code>init.rc</code>, <code>init.<target>.rc</code>, <code>uevent.rc</code>, ...)</li> -</ul> - -<p>Ici, le contenu peut grandement différer d'un appareil à l'autre. En particulier, les fichiers BoardConfig.mk et extract-files.sh peuvent différer significativement. Cette partie nécessite pas mal de modifications, de test et de débogage pour déterminer quels blobs binaires doivent être extraits. Pour avoir une meilleure idée de qu'on est supposé trouver ici, jetez un oeil à <a href="https://github.com/mozilla-b2g/android-device-hamachi" title="https://github.com/mozilla-b2g/android-device-hamachi">configuration pour l'appareil hamachi</a>. Rappelez-vous de référencer correctement votre propre arborescence de configuration dans le manifeste aue vous avez créé pour votre nouvel appareil.</p> - -<div class="note"> -<p><strong>Note:</strong> Si vous pouvez trouver une référence existante sur <a href="http://www.cyanogenmod.com/" title="http://www.cyanogenmod.com/">CyanogenMod</a> pour votre appareil, ces informations accélèreront le processus de portage. Le forum <a href="http://forum.xda-developers.com/" title="http://forum.xda-developers.com/">XDA</a> est un autre bon endroit pour discuter et vérifier des informations.</p> -</div> - -<h2 id="Reconstruire_boot.img">Reconstruire boot.img</h2> - -<p>Une fois que tout cà est fait, vous devez reconstruire l'image de boot. Ce n'est habituellement pas nécessaire pour le noyau lui-même mais pour récupérer les modifications dans <code>init.rc</code>.</p> - -<h3 id="Modifications_dans_init.rc">Modifications dans init.rc</h3> - -<p>Le init.rc que vous utilisez n'est <strong>pas</strong> celui fourni par B2G; à la place, vous devez le récupérer depuis votre appareil.</p> - -<p>Les principales choses que vous aurez besoin de modifier sont :</p> - -<h4 id="Importer_init.b2g.rc">Importer init.b2g.rc</h4> - -<p>Ajouter les lignes suivantes pour importer <code>init.b2g.rc</code>:</p> - -<pre class="brush: bash">on early-init - start ueventd - import /init.b2g.rc</pre> - -<h4 id="Corriger_les_permissions">Corriger les permissions</h4> - -<p>Corrigez les permissions des fichiers <code>/system/b2g/b2g</code>, <code>/system/b2g/updater et /system/b2g/plugin-container</code>; ceci doit être fait après les lignes qui montent le système de fichier en lecture/écriture:</p> - -<pre class="brush: bash">chmod 0755 /system/b2g/b2g -chmod 0755 /system/b2g/updater -chmod 0755 /system/b2g/plugin-container</pre> - -<p>Vous pourriez vouloir commencer en modifiant <code>init.rc</code> provenent du nouvel appareil au lieu d'utiliser le <code>init.rc</code> fourni par le système de build; dans ce cas, vous devez vous rappeler de renseigner <code>TARGET_PROVIDES_INIT_RC</code> dans <code>BoardConfig.mk</code>.</p> - -<h3 id="Noyau_pré-compilé_vs._compiler_le_noyau_depuis_le_code_source">Noyau pré-compilé vs. compiler le noyau depuis le code source</h3> - -<p>Vous pouvez utiliser un noyau pré-compilé ou vous pouvez compiler le noyau à partir du code source. Pour compiler le noyau à partir du code source, ajoutez AndroidKernel.mk et la configuration du noyau dans l'arborescence de configuration de l'appareil.</p> - -<p>Le <a href="https://github.com/andreasgal/B2G/tree/master/glue/gonk/device/toro/maguro" title="https://github.com/andreasgal/B2G/tree/master/glue/gonk/device/toro/maguro">maguro</a> sur l'ancien système de build est un exemple qui compile le noyau à partir du code source.</p> - -<h3 id="Extraire_et_modifier_une_image_de_boot_existante">Extraire et modifier une image de boot existante</h3> - -<p>Il est possible de récupérer l'image de boot d'un téléphone en extrayant le contenu des devices <code>/dev/mtd/mtd1</code> ou <code>/dev/mtd/mtd2</code>, le fichier image résultat peut ensuite être facilement récupéré :</p> - -<pre class="brush: bash">adb shell 'cat /dev/mtd/mtd1 > /sdcard/boot.img' -adb pull /sdcard/boot.img -</pre> - -<p>Une fois que le fichier de l'image de boot a été obtenu, il peut être décompressé à l'aide d'un utilitaire tel que <a href="http://whiteboard.ping.se/Android/Unmkbootimg" title="Unmkbootimg">unmkbootimg</a>. L'outil va extraire à la fois l'image du noyau (zimage) et le disque mémoire (ramdisk initramfs.cpio.gz) et également afficher une commande permettant de re-compiler l'image avec les mêmes paramètres que ceux utilisés pour l'image d'origine, par exemple :</p> - -<pre class="brush: bash">$ unmkbootimg boot.img -Kernel size 3872576 -Kernel address 0x208000 -Ramdisk size 265102 -Ramdisk address 0x1500000 -Secondary size 0 -Secondary address 0x1100000 -Kernel tags address 0x200100 -Flash page size 2048 -Board name is "" -Command line "androidboot.hardware=aphone" -Extracting kernel to file zImage ... -Extracting root filesystem to file initramfs.cpio.gz ... -All done. ---------------- -To recompile this image, use: - mkbootimg --kernel zImage --ramdisk initramfs.cpio.gz --base 0x200000 --cmdline 'androidboot.hardware=aphone' -o new_boot.img ---------------- -</pre> - -<p>Pour modifier le fichier ramdisk, créez un répertoire destination et extrayez-le dedans:</p> - -<pre class="brush: bash">mkdir initramfs_dir -cd initramfs_dir -gunzip -c ../initramfs.cpio.gz | cpio -i -</pre> - -<p>Faîtes toutes les modifications nécessaires (telles que la modification de init.rc) puis recompressez le ramdisk en utilisant <code>mkbootfs</code> et assurez-vous que la version a été compilée avec les outils B2G de l'hôte :</p> - -<pre class="brush: bash">/path/vers/votre/B2G/out/host/linux-x86/bin/mkbootfs . | gzip > ../newinitramfs.cpio.gz -</pre> - -<p>Enfin, retournez au répertoire de premier niveau et re-compressez l'image de boot en utilisant <code>mkbootimg</code>; assurez-vous également que vous utilisez la version compilée avec loutils de l'autre hôte B2G:</p> - -<pre class="brush: bash">/path/vers/votre/B2G/out/host/linux-x86/bin/mkbootimg --kernel zImage --ramdisk newinitramfs.cpio.gz --base 0x200000 --cmdline 'androidboot.hardware=aphone' -o newboot.img -</pre> - -<p>Si vous copiez maintenant votre nouvelle image de boot dans <code>out/target/product/$DEVICE/boot.img</code> (où $DEVICE est le nom de votre device), elle sera automatiquement flashée quand <code>flash.sh</code> est appelé. Alternativement, vous pouvez la flasher à la main avec les commandes suivantes :</p> - -<pre class="brush: bash">adb reboot bootloader -fastboot flash boot newboot.img -fastboot reboot -</pre> - -<h2 id="Ajouter_le_nouvel_appareil_à_flash.sh">Ajouter le nouvel appareil à flash.sh</h2> - -<p>Ajoutez le nouvel appareil à <code>flash.sh</code>; les spécificités sur la façon de faire cela dépendront des outils qui seront utilisés pour flasher le nouvel appareil.</p> - -<h2 id="Configurer_compiler_et_flasher_le_nouvel_appareil">Configurer, compiler et flasher le nouvel appareil</h2> - -<p>Maintenant, vous pouvez essayer de compiler et de flasher votre nouvel appareil:</p> - -<pre class="brush: bash">ANDROIDFS_DIR=sauvegarde_de_mon_appareil ./config.sh <device_id> '../b2g-manifest/default.xml' -./build.sh -./flash.sh</pre> - -<h2 id="Test_et_débogage">Test et débogage</h2> - -<p>Nous avons besoin d'ajouter certains détails ici; en fait, c'est tout l'article qui pourrait nécessiter de l'aide.</p> - -<h2 id="FAQ">FAQ</h2> - -<p>À venir.</p> - -<h2 id="Voir_également">Voir également</h2> - -<ul> - <li><a href="/en-US/docs/Mozilla/Firefox_OS" title="en-US/docs/Mozilla/Firefox_OS">B2G OS</a></li> - <li><a href="https://github.com/mozilla-b2g/B2G" title="https://github.com/mozilla-b2g/B2G">code source de B2G sur Github</a></li> - <li><a href="http://www.android.com/" title="http://www.android.com/">Site web Android</a></li> - <li><a href="https://autonome.wordpress.com/2013/01/15/firefox-os-devices-and-dark-matter/" title="https://autonome.wordpress.com/2013/01/15/firefox-os-devices-and-dark-matter/">Une liste de projets existant sur le blog de Dietrich Ayala</a> pour porter B2G OS sur certains appareils</li> -</ul> diff --git a/files/fr/archive/b2g_os/porter_firefox_os/b2g_nexus_player/index.html b/files/fr/archive/b2g_os/porter_firefox_os/b2g_nexus_player/index.html deleted file mode 100644 index 9cfa7b3962..0000000000 --- a/files/fr/archive/b2g_os/porter_firefox_os/b2g_nexus_player/index.html +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Porter B2G sur le Nexus Player (Lollipop) -slug: Archive/B2G_OS/Porter_Firefox_OS/B2G_Nexus_Player -tags: - - B2G - - B2G OS - - Firefox OS - - Guide - - Nexus - - Nexus Player - - TV - - portage -translation_of: Archive/B2G_OS/Porting_B2G_OS/B2G_Nexus_Player ---- -<p></p><section class="Quick_links" id="Quick_Links"> - -<ol> - <li class="toggle"> - <details> - <summary>Build and install</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS">Build and install overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_build_process_summary">B2G OS build process summary</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/B2G_OS_build_prerequisites">Build prerequisites</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Preparing_for_your_first_B2G_build">Preparing for your first build</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building">Building B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_installer_add-on">B2G installer add-on</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Building_for_Flame_on_OS_X">Building B2G OS for Flame on Mac OS X</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Choosing_how_to_run_Gaia_or_B2G">Choosing how to run Gaia or B2G OS</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/Compatible_Devices">Compatible Devices</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Installing_on_a_mobile_device">Installing B2G OS on a mobile device</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_OS_update_packages">Creating and applying B2G OS update packages</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building/FOTA_community_builds">Building and installing FOTA community builds</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Building_and_installing_B2G_OS/B2G_Build_Variables_Reference_Sheet">B2G build variables reference sheet</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Porting B2G OS</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS">Porting overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/basics">Porting basics</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod">Porting on CyanogenMod</a></li> - </ol> - </details> - </li> - <li class="toggle"> - <details> - <summary>Developing Gaia</summary> - <ol> - <li><strong><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia">Developing Gaia overview</a></strong></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Running_the_Gaia_codebase">Running the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Mulet">Run Gaia on desktop using Mulet</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Understanding_the_Gaia_codebase">Understanding the Gaia codebase</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Making_Gaia_code_changes">Making Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Testing_Gaia_code_changes">Testing Gaia code changes</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Submitting_a_Gaia_patch">Submitting a Gaia patch</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Build_System_Primer">Gaia build system primer</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia">Different ways to run Gaia</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/make_options_reference">Make options reference</a></li> - <li><a href="/fr/docs/Mozilla/B2G_OS/Developing_Gaia/Gaia_tools_reference">Gaia tools reference</a></li> - </ol> - </details> - </li> - <li><a href="/fr/docs/Mozilla/B2G_OS/API">B2G OS APIs</a></li> -</ol> -</section><p></p> - -<p class="summary">Cet article donne une vue d'ensemble du processus permettant à B2G OS (la version TV — sur laquelle <a href="/en-US/docs/Mozilla/Firefox_OS/TV">Firefox OS pour TV</a> est basée) d'être porté sur le Nexus Player (versions faisant touner Lollipop.)</p> - -<div class="warning"> -<p><strong>Important</strong> : Le public visé par ces instructions est essentiellement les développeurs expérimentés qui sont déjà familiarisés avec la compilation de Firefox OS ou d'AOSP.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Nous ne pouvons garantir la fiabilité des appareils portés. Cependant, les développeurs intéressés par le processus de portage et disposés à contribuer au programme sont encouragés à hacker leurs propres appareils. Les questions et les retours constructifs sont toujours les bienvenus : adressez-nous vos courriels à <a href="mailto:smarttv@mozilla.com">smarttv@mozilla.com</a>.</p> -</div> - -<div class="note"> -<p><font size="2"><strong>Note :</strong> Cet article, estimant que votre Nexus Player est déverrouillé, ne vous apprendra pas comment le rooter et/ou déverrouiller.</font></p> -</div> - -<h2 id="Préparer_l'environnement_de_compilation">Préparer l'environnement de compilation</h2> - -<p>Actuellement, la construction de B2G OS pour Nexus Player nécessite un PC sous Ubuntu 14.04 LTS x64 ou compatible.</p> - -<p>Vous devez commencer par lancer les commandes suivantes :</p> - -<pre class="brush: bash">sudo dpkg --add-architecture i386 -sudo dpkg --add-architecture amd64 -sudo apt-get update -sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip lzop libxml2-utils openjdk-7-jdk nodejs unzip python</pre> - -<h2 id="Configurer_l'USB">Configurer l'USB</h2> - -<p>Par défaut, sur les systèmes Linux, un utilisateur normal ne peut pas accéder directement aux périphériques USB. Vous devez configurer des règles udev.</p> - -<p>Créez un fichier <code>/etc/udev/rules.d/51-android.rules</code> contenant la commande suivante, puis enregistrez-le :</p> - -<pre class="brush: bash">wget -S -O - https://raw.githubusercontent.com/cm-b2g/B2G/1230463/tools/51-android.rules | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules</pre> - -<p>Les nouvelles règles prendront effet la prochaine fois qu'un appareil sera branché.</p> - -<div class="note"> -<p><strong>Note</strong> : Pour plus d'informations sur les environnement de compilation appropriés, veuillez vous référer aux <a href="/fr/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour construire Firefox OS</a>.</p> -</div> - -<h2 id="Télécharger_le_code_source">Télécharger le code source</h2> - -<p>Pour télécharger le code source pour le Nexus Player, assurez-vous au préalable d'avoir <a href="https://git-scm.com/">Github</a> installé, puis exécutez les commandes suivantes:</p> - -<pre>git clone git://github.com/mozilla-b2g/B2G.git nexusplayer -cd nexusplayer -BRANCH=v2.6 ./config.sh nexusplayer-l</pre> - -<p>Pour télécharger manuellement le code source Gecko correspondant, exécutez la commande suivante :</p> - -<pre>git clone https://github.com/mozilla-b2g/gecko-b2g</pre> - -<p>Et suivez les instructions de <a href="/fr/Firefox_OS/Customisation_avec_le_fichier_.userconfig#Changer_l'arbre_source_de_Gecko">Changer l'arbre source de Gecko</a> pour en construire une version personnalisée.</p> - -<h2 id="Compiler">Compiler</h2> - -<p>Une fois l'environnement mis en place et le code source téléchargé, sa construction se résume à exécuter la commande suivante :</p> - -<pre class="brush: bash">./build.sh</pre> - -<h2 id="Flasher_B2G_sur_le_Nexus_Player">Flasher B2G sur le Nexus Player</h2> - -<p>Flashez B2G OS sur le Nexus Player avec la commande suivante :</p> - -<pre class="brush: bash">./flash.sh</pre> - -<p>Le flashage terminé, l'appareil devrait redémarrer et charger B2G OS. Sauf si quelque chose n'allait pas, vous devriez voir peu de temps après l'écran d'accueil TV de B2G OS.</p> - -<h2 id="Dépannage">Dépannage</h2> - -<p>Quelquefois, les choses peuvent mal se passer. Ce qui suit est une liste des problèmes connus, avec des suggestions de solutions.</p> - -<h3 id="Fastboot_ne_trouve_pas_le_Nexus_Player">Fastboot ne trouve pas le Nexus Player</h3> - -<p>Il est possible que <code>./flash.sh</code> redémarre avec succès le Nexus Player en mode bootloader mais que ça se bloque indéfiniment sur le message <code>< waiting for device ></code>. Cela peut être résolu en remplaçant le <code>fastboot</code> de votre système par celui situé dans le répertoire <code><b2g>/</code><span class="im"><code>out/host/linux-x86/bin/</code>.</span></p> - -<h3 id="La_fonctionnalité_Bluetooth_est_absente">La fonctionnalité Bluetooth est absente</h3> - -<p>Nous ne pouvons pas construire automatiquement <code>bluetooth.default.so</code> ni <code>libbt-vendor.so</code> sur <code>nexusplayer-l</code>, c'est pourquoi le Bluetooth ne fonctionne pas par défaut. Une solution de contournement consiste actuellement à construire les fichiers manquants à la main et à les flasher sur <code>nexusplayer-l</code>, après quoi vous serez en mesure d'activer le bluetooth dans l'application <em>Paramètres</em>.</p> - -<p>Les étapes de construction figurent ci-dessous :</p> - -<h4 id="Étapes_pour_construire_bluetooth.default.so">Étapes pour construire bluetooth.default.so</h4> - -<ol> - <li>Aller sur <code>dir nexusplayer</code> puis tapez <code>source setup.sh</code>.</li> - <li>Aller sur <code>dir nexusplayer/external/tinyxml2</code> puis tapez <code>mm</code>.</li> - <li>Aller sur <code>dir nexusplayer/external/bluetooth/bluedroid</code> puis tapez<strong> </strong><code>mm</code><strong>.</strong></li> - <li>Aller sur <code>dir nexusplayer/</code> puis tapez la commande suivante :</li> -</ol> - -<pre class="brush: bash">adb push out/target/product/fugu/system/lib/hw/bluetooth.default.so -/system/lib/hw</pre> - -<h4 id="Étapes_pour_construire_libbt-vendor.so">Étapes pour construire libbt-vendor.so</h4> - -<ol> - <li>Aller sur <code>dir nexusplayer</code> puis tapez <code>source setup.sh</code>.</li> - <li>Aller sur <code>dir nexusplayer/hardware/broadcom/libbt</code> puis tapez <code>mm</code><strong>.</strong></li> - <li>Aller sur <code>dir nexusplayer</code> puis tapez la commande suivante :</li> -</ol> - -<pre class="brush: bash">adb push out/target/product/fugu/system/vendor/lib/libbt-vendor.so -/system/vendor/lib</pre> - -<h3 id="L'écran_d'accueil_TV_ne_gère_pas_les_événements_de_la_souris">L'écran d'accueil TV ne gère pas les événements de la souris</h3> - -<p>Par défaut, l'application écran d'accueil TV ne gère pas les événements de la souris (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1260083" title="[nexusplayer] TV home doesn't handle mouse event.">bug 1260083</a>). Pour le moment, la recommandation est de se passer de l'usage de la souris et d'utiliser la télécommande à la place.</p> - -<p>Suivez ces étapes pour que les choses fonctionnent :</p> - -<ol> - <li>Utilisez le clavier physique pour démarrer le Nexus Player.</li> - <li>Utilisez les touches fléchées pour naviguer sur l'écran d'accueil et aller dans l'application <em>Paramètres</em>.</li> - <li>Utilisez les touches fléchées pour aller sur le panneau de configuration du Bluetooth et associez l'appareil avec la télécommande.</li> -</ol> - -<p>Vous pouvez alors utiliser la télécommande à la place. Branchez la souris lorsque vous souhaitez naviguer dans l'application <em>Navigateur</em>.</p> diff --git a/files/fr/archive/b2g_os/porter_firefox_os/index.html b/files/fr/archive/b2g_os/porter_firefox_os/index.html deleted file mode 100644 index 2b771ff313..0000000000 --- a/files/fr/archive/b2g_os/porter_firefox_os/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Porter B2G OS -slug: Archive/B2G_OS/Porter_Firefox_OS -tags: - - Firefox OS - - portage -translation_of: Archive/B2G_OS/Porting_B2G_OS ---- -<p class="summary">Cette page liste les ressources disponibles concernant le portage de B2GOS.</p> - -<dl> - <dt><a href="/fr/Firefox_OS/Portage">Bases du portage</a></dt> - <dd>Informations de base sur comment porter B2G OS pour de nouveaux appareils.</dd> - <dt><a href="/fr/Firefox_OS/Porter_Firefox_OS/Portage_sur_CyanogenMod">Porter sur CyanogenMod</a></dt> - <dd>Cet article explique comment porter B2G en utilisant CyanogenMod.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/porter_firefox_os/portage_sur_cyanogenmod/index.html b/files/fr/archive/b2g_os/porter_firefox_os/portage_sur_cyanogenmod/index.html deleted file mode 100644 index cc1038b093..0000000000 --- a/files/fr/archive/b2g_os/porter_firefox_os/portage_sur_cyanogenmod/index.html +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: Portage sur CyanogenMod -slug: Archive/B2G_OS/Porter_Firefox_OS/Portage_sur_CyanogenMod -tags: - - B2G - - cm-b2g - - cyanogenmod - - portage b2g cyanogenmod -translation_of: Archive/B2G_OS/Porting_B2G_OS/Porting_on_CyanogenMod ---- -<p class="summary">B2G OS est traditionnellement construit sur une base <a href="https://android.googlesource.com/">AOSP</a>. Cependant, cela ne signifie pas que nous devons utiliser uniquement AOSP. Il en existe plusieurs forks qui ont pour objectif de supporter une gamme de matériel plus large. <a href="http://www.cyanogenmod.org/">CyanogenMod</a>, le plus populaire des forks d'AOSP, comporte des milliers d'ajouts, modifications, et bidouilles pour prendre en charge des <a href="http://get.cm/">centaines d'appareils Android du commerce</a>. <span class="seoSummary">Cet article explique comment porter Firefox en utilisant CyanogenMod.</span></p> - -<p>En construisant B2G OS sur une base CyanogenMod, il devient potentiellement possible de supporter autant d'appareils que le fait ce système. En raison de la multiplicité des appareils supportés par CyanogenMod, il est hautement probable que vous en ayez déjà un sur lequel il peut être compilé !</p> - -<div class="warning"><strong>Important</strong> : Ce guide s'adresse seulement aux utilisateurs expérimentés ; vous devez savoir au préalable comment construire CyanogenMod ou AOSP.</div> - -<p>Si vous n'avez jamais construit CyanogenMod pour votre appareil, nous vous conseillons fortement d'<a href="https://wiki.cyanogenmod.org/w/Build_Guides">apprendre comment le faire</a> avant de porter B2G OS. Cela pour deux raisons : vous apprendrez à utiliser les outils nécessaires au portage de B2G OS, et vous vérifierez la qualité du portage de CyanogenMod.</p> - -<p>Pour être plus clair : ce guide part du principe que votre appareil est déverrouillé et que CyanogenMod est installé dessus. Ce guide <em>ne va pas</em> vous apprendre à rooter et/ou déverrouiller votre appareil, ni à mettre en place votre machine de compilation ou utiliser git pour résoudre des échecs de fusion.</p> - -<p>Voici un résumé des étapes :</p> - -<ol> - <li>Télécharger le code source</li> - <li>Modifier les dépôts de l'appareil</li> - <li>Modifier le noyau</li> - <li>Compiler et installer</li> -</ol> - -<h2 id="Télécharger_le_code_source">Télécharger le code source</h2> - -<div class="warning"><strong>À FAIRE :</strong> Fusionner le manifeste requis avec mozilla-b2g : <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1211870">Bugzilla: 1211870</a>.</div> - -<p>Nous disposons de plusieurs outils utiles pour compiler B2G OS, tous contenus dans un unique dépôt. Téléchargez ces outils via <strong><code>git</code></strong> pour créer votre répertoire de travail.</p> - -<pre><code>git clone https://github.com/cm-b2g/B2G.git && cd B2G</code> -</pre> - -<p>À présent, nous devons télécharger le code source.</p> - -<pre><code>./config.sh cm-porting</code> -</pre> - -<p>Le script <strong><code>config.sh</code></strong> initialise l'outil <code>repo</code> en utilisant le manifeste <strong><code>base-l-cm.xml</code></strong> situé dans le dépôt <strong><code>b2g-manifest</code></strong>. Ce fichier XML est une liste de dépôts spécifiques à l'OS nécessaires à la compilation de B2G OS. Il fait ensuite appel à l'outil <strong><code>repo</code></strong> pour télécharger la totalité du code source.</p> - -<p>Le téléchargement de tous ces dépôts, dont certains font plusieurs giga-octets, va prendre un certain temps, il est donc recommandé de le faire pendant la nuit si la connexion est lente, ou juste avant manger si la connexion est plus rapide.</p> - -<p>Cette étape va également créer un fichier <strong><code>.config</code></strong> qui devra être éditer plus tard.</p> - -<h2 id="Manifeste_local_pour_votre_appareil">Manifeste local pour votre appareil</h2> - -<p>Le manifeste susmentionné ne contient aucun dépôt spécifique pour les appareils, ce qui diffère d'un manifeste classique. Nous avons besoin de créer un fichier <strong><code>local_manifest.xml</code></strong> avec tous les dépôts pour votre appareil. La manière la plus rapide de le faire consiste à utiliser <strong><code>breakfast</code></strong>, un outil automatisé écrit par CyanogenMod pour créer un manifeste local et télécharger les dépôts supplémentaires directement depuis le compte GitHub de CyanogenMod.</p> - -<pre><code>. build/envsetup.sh && breakfast 123</code> -</pre> - -<p>Remplacez <strong><code>123</code></strong> par le nom de code de votre appareil.</p> - -<p>Si votre appareil n'est pas officiellement supporté par CyanogenMod mais qu'il existe un portage non officiel, vous pouvez créer manuellement le fichier <strong><code>local_manifest.xml</code></strong> dans le dossier <strong><code>.repo/local_manifests</code></strong>. Un exemple est donné plus bas.</p> - -<pre><code><?xml version="1.0" encoding="UTF-8"?> -<manifest> - <remote name="xyz" fetch="git://github.com/xyz/" revision="cm-12.1" /> - <project name="device_oem_123" path="device/oem/123" remote="xyz" /> - <project name="device_oem_1xx-common" path="device/oem/1xx-common" remote="xyz" /> - <project name="kernel_oem_1xx" path="kernel/oem/1xx" remote="xyz" /> - <project name="vendor_oem" path="vendor/oem" remote="xyz" /> -</manifest></code> -</pre> - -<p>Rappelez-vous d'exécuter <strong><code>repo sync</code></strong> après avoir créé votre manifeste !</p> - -<h2 id="Modifier_les_dépôts_de_l'appareil">Modifier les dépôts de l'appareil</h2> - -<p>Une partie de la configuration des appareils se trouve dans des fichiers overlay XML utilisés par le système de compilation d'AOSP pour définir les options par défaut des applications Android. Comme B2G OS ne les utilise pas, il faut donc réimplémenter certaines de ces options, comme le bouton d'accueil, le stockage émulé etc.</p> - -<p>Il est possible de définir les options par défaut les plus raisonnables en incluant deux fichiers issus de <strong><code>vendor/cm</code></strong>. La première ligne doit être ajoutée au <em>début</em> de <strong><code>device.mk</code></strong> et la seconde à la <em>fin</em> de <strong><code>BoardConfig.mk</code></strong>:</p> - -<pre><code># Extra mk import at the top of device.mk -$(call inherit-product, vendor/cm/config/common_full.mk) - -# Extra mk import at the bottom of BoardConfig.mk -include vendor/cm/BoardConfig.mk</code> -</pre> - -<p>D'autres options sont encore nécessaires car beaucoup sont très spécifiques au matériel. Voici ci-dessous une liste des ajouts et suppressions habituels spécifiques aux appareils. Cette liste n'est pas exhaustive, mais l'ajout des deux lignes citées plus haut et définir tout ce qui suit vous donnera un système fonctionnel.</p> - -<pre><code># for Gecko to use the correct resolution assets -# Valid options are: 1.5 | 2 | 2.25 -GAIA_DEV_PIXELS_PER_PX := 2.25</code> -</pre> - -<pre><code># for Gecko to use the correct boot animation -# Valid options are: hvga | fwvga | qHD | 720p | 1080p -BOOTANIMATION_ASSET_SIZE := 1080p</code> -</pre> - -<pre><code># for Gecko to support separate internal storage partition -# This is for legacy devices only. You must prvide your own volume.cfg file -GECKO_BOARD_SEPARATE_STORAGE_PARTITON := true</code> -</pre> - -<pre><code># for Gecko to support virtual home button -PRODUCT_PROPERTY_OVERRIDES += \ - ro.moz.has_home_button=0</code> -</pre> - -<pre><code># for Gecko to support usb mass storage -# You may need to add mass_storage to init.oem.usb.rc -PRODUCT_DEFAULT_PROPERTY_OVERRIDES += \ -- persist.sys.usb.config=mtp -+ persist.sys.usb.config=mass_storage</code> -</pre> - -<pre><code># for Gecko to support NFC -PRODUCT_PROPERTY_OVERRIDES += \ - ro.moz.nfc.enabled=true - -PRODUCT_PACKAGES += \ - nfcd</code> -</pre> - -<pre><code># Changes in init.device.rc --on property:init.svc.bootanim=running --on property:init.svc.bootanim=stopped --on property:service.bootanim.exit=1 -+on property:sys.boot_completed=1</code> -</pre> - -<h2 id="Modifier_le_noyau">Modifier le noyau</h2> - -<p>B2G OS a besoin d'avoir certaines fonctionnalités de sécurité supplémentaires activées dans le noyau. Jusqu'à Marshmallow, ces fonctionnalités étaient absentes des noyaux Android, quelques patches supplémentaires devront donc être rétroportés sur le noyau pour de nombreux appareils. Pour référence, consultez <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=790923">Bugzilla: 790923</a>.</p> - -<p>Il suffit de faire le tri dans les patches pour votre noyau ; le système de construction va automatiquement activer les nouvelles fonctionnalités. Pour un exemple fonctionnel, voir le <a href="https://github.com/cm-b2g/android_kernel_lge_msm8974/commits/b2g/cm-12.1-YOG7D">noyau LGE MSM8994</a>.</p> - -<div class="warning"><strong>Important</strong> : Cette étape est obligatoire ! B2G OS ne démarrera pas sans ces fonctionnalités de sécurité !.</div> - -<h2 id="Compiler_et_installer">Compiler et installer</h2> - -<p>Vous vous souvenez du fichier <strong><code>.config</code></strong> créé précédemment ? Il faut maintenant remplacer <strong><code>cm-porting</code></strong> par le nom de code de votre appareil.</p> - -<pre><code>$ grep -r PRODUCT_NAME device/oem/123</code> -</pre> - -<p>Note : n'utilisez pas la valeur dans <code>cm.mk</code>, utilisez celle de <strong><code>device.mk</code></strong>, elle devrait ressembler à quelque chose du genre <strong><code>full_123</code></strong>. Vous pouvez effectuer le remplacement à la main, ou le faire simplement avec <strong><code>sed</code></strong> :</p> - -<pre><code>$ sed -i "s/cm-porting/full_123/g" .config</code> -</pre> - -<p>À présent, il est temps de lancer la compilation !</p> - -<pre><code>$ ./bldcm.sh</code> -</pre> - -<p>Cela va prendre dans tous les cas de 30 minutes à deux ou trois heures, en fonction de votre PC, ça peut donc être le bon moment pour aller faire les magasins ou acheter un peu de popcorn.</p> - -<h3 id="Installation_de_B2G_OS_via_fastboot">Installation de B2G OS via fastboot</h3> - -<p>Dans le cas où votre appareil supporte <strong><code>fastboot</code></strong>, il est possible de flasher directement les images de partition :</p> - -<pre><code>cd out/target/product/123/ -fastboot flash boot boot.img -fastboot flash recovery recovery.img -fastboot flash system system.img -fastboot flash userdata userdata.img</code> -</pre> - -<h3 id="Installation_de_B2G_OS_via_recovery">Installation de B2G OS via recovery</h3> - -<p>Si votre appareil ne supporte pas fastboot, vous pouvez alors utiliser <strong><code>update.zip</code></strong> ià la place. Celui-ci peut être installé sur l'appareil en copiant le zip sur une carte SD ou via <strong><code>adb sideload</code></strong>. Entrez en mode recovery selon la méthode spécifique à votre appareil puis tapez :</p> - -<pre><code>adb sideload out/target/product/123/fota/fullimg/update.zip</code> -</pre> - -<h2 id="Dépannage">Dépannage</h2> - -<p>Quelque chose ne fonctionne pas ? Il est temps de retrousser ses manches !</p> - -<p>Essayez tout d'abord de déterminer si la fonctionnalité est disponible dans CyanogenMod. Il pourrait s'agir simplement d'une configuration manquante dans B2G OS.</p> - -<p>Si ça <em>ne</em> fonctionne <em>pas</em> sur CyanogenMod, cela signifie alors que vous devez l'implémenter dans votre portage. Cela serait utile de soumettre votre correctif en amont également !</p> - -<h3 id="Appareils_64bits">Appareils 64bits</h3> - -<p>La plupart des appareils fabriqués depuis mi-2015 intègrent un SoC 64 bits. B2G ne peut pas être construit sous la forme d'un exécutable 64 bits mais heureusement les exécutables 32 bits fonctionnent. Nous pouvons forcer la construction de B2G en 32 bits avec deux correctifs situés dans le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1245088">bogue #1245088</a>.</p> - -<p>Après cela, il suffit de définir :</p> - -<pre class="line-numbers language-html"><code class="language-html">BUILD_MULTILIB_GECKO_AS_2ND_ARCH := true</code></pre> - -<h3 id="Appareil_photo">Appareil photo</h3> - -<p>Certaines parties d'Android ont été retirées du processus de construction car elles ne sont pas nécessaires. Si le blob de l'appareil photo signale des fonctions manquantes, vérifiez frameworks/base pour voir si celles-ci ont été supprimées. Il peut être possible de les réintégrer.</p> - -<h3 id="WiFi">WiFi</h3> - -<p>L'appareil peut ne pas voir certains points d'accès s'ils utilisent des canaux non officiels. Il semble que cela soit un problème de CyanogenMod ou même d'AOSP car différents matériels et fabricants sont concernés.</p> diff --git a/files/fr/archive/b2g_os/preparing_for_your_first_b2g_build/index.html b/files/fr/archive/b2g_os/preparing_for_your_first_b2g_build/index.html deleted file mode 100644 index c4006b4445..0000000000 --- a/files/fr/archive/b2g_os/preparing_for_your_first_b2g_build/index.html +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: Se préparer pour la première construction de B2G -slug: Archive/B2G_OS/Preparing_for_your_first_B2G_build -tags: - - B2G OS - - Build documentation - - compiler b2g os -translation_of: Archive/B2G_OS/Preparing_for_your_first_B2G_build ---- -<div class="summary"> -<p>Avant de pouvoir construire B2G, vous devez cloner le dépôt et configurer votre arborescence. Cet article explique comment faire.</p> -</div> - -<p>En fonction de votre connexion internet, l'étape de configuration prend un certain nombre d'heures pour télécharger les fichiers nécessaires à la construction de B2G OS. L'attente n'est pas aussi amusante que l'action, donc après avoir lu cette page et une fois lancé le script de configuration, pensez à utiliser ce temps pour mettre en place et tester le <a class="vt-p" href="/fr/docs/Outils/Simulateur_Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS/Using_Firefox_OS_Simulator">simulateur B2G OS</a>, commencez à vous familiariser avec la <a href="/fr/Apps">documentation pour les développeurs d'applications</a>, y compris la conception et la construction d'une application, et à vous familiariser avec les informations sur les étapes à venir.</p> - -<div class="note"> -<p><strong>Note</strong> : Si vous utilisez OS X pour compiler B2G OS pour un Flame, rendez-vous sur la page <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Compiler_pour_le_Flame_sur_OS_X">Compiler B2G OS pour un Flame sur OS X</a>.</p> -</div> - -<div class="warning"> -<p>Si vous êtes sur <strong>Archlinux,</strong> veuillez également consulter ce <a href="https://discourse.mozilla-community.org/t/building-b2g-os-on-arch-linux/9791">sujet sur Discourse</a>.</p> -</div> - -<h2 id="Cloner_le_dépot_B2G">Cloner le dépot B2G</h2> - -<p>Nous disposons de plusieurs utilitaires pour construire B2G OS, tous inclus dans un unique dépôt. La première étape consiste à télécharger ces outils avec git pour créer notre répertoire de travail :</p> - -<pre>git clone git://github.com/mozilla-b2g/B2G.git && cd B2G</pre> - -<p>Si vous rencontrez une erreur UnicodeEncodeError: ascii codec error ici, essayez de spécifier votre utilisateur git avec</p> - -<pre>vim ~/.gitconfig -</pre> - -<p>(tapez "i" pour passer en mode insertion) puis ces lignes :</p> - -<pre><code>[user] - name = votrenom - email = votre adressemail@url.tld</code> -[color] - ui = auto</pre> - -<p>Pressez la touche "échap" et quittez avec ":wq"</p> - -<ul> - <li>Configurez B2G pour l'appareil :</li> -</ul> - -<pre class="line-numbers language-html"><code class="language-html">$ ./config.sh <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>appareil</span><span class="punctuation token">></span></span></code></pre> - -<p>où appareil = flame-kk ou aries</p> - -<ul> - <li>Compilez et flashez B2G</li> - <li>branchez votre appareil qui possède une version de base android ou firefox os</li> -</ul> - -<pre class="line-numbers language-html"><code class="language-html">$ ./build.sh -$ ./flash.sh</code></pre> - -<p><strong>Notes :</strong></p> - -<ul> - <li>Si vous obtenez une erreur selon laquelle la version de base ne correspond pas au moment de la compilation, cela signifie que vous n'avez pas la version requise d'Android/B2G présente sur votre appareil. Vous devrez flasher la version d'Android spécifiée par le script de compilation ou mettre la main sur un dossier de sauvegardes.</li> -</ul> - -<div class="note"><strong>Note :</strong> Il ne s'agit pas de la liste complète des cibles de compilation, voyez <code>config.sh</code> ou vous référer à la page des <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils compatibles</a>.</div> - -<p>Si votre cible de compilation ne figure pas dans la liste, vous devriez vous arrêter tout de suite et aider à <a href="/fr/docs/B2G_OS/Porter_Firefox_OS">porter B2G OS !</a></p> - -<h3 id="Configurer_une_version_pour_un_appareil_mobile">Configurer une version pour un appareil mobile</h3> - -<div class="warning"><strong>Important</strong> : <span id="result_box" lang="fr"><span class="hps">Rappelez-vous</span> <span class="hps">que seuls les</span> <span class="hps">appareils fonctionnant au moins sous <strong>Android</strong></span><strong> <span class="hps">4.3</span></strong> <span class="hps">(</span><strong><span class="hps">Jellybean, Kitkat et Lollipop</span></strong><span>) </span><span class="hps">sont pris en charge</span><span>.</span> <span class="hps">Veuillez vérifier que votre</span> <span class="hps">téléphone</span> <span class="hps">fonctionne avec la dernière version compatible</span><span>, sinon</span> <span class="hps">ces prochaines étapes</span> <span class="hps"><em>vont</em> échouer</span><span class="hps">.</span></span> Référez-vous à la page <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils compatibles</a> pour plus de détails.</div> - -<h3 id="Blobs_propriétaires">Blobs propriétaires</h3> - -<p>Lorsque vous installez B2G OS sur un appareil, vous avez besoin d'inclure un ensemble de blobs propriétaires. Ceux-ci sont extraits de l'appareil lorsque vous lancez votre première compilation, mais nous vous conseillons de faire également une sauvegarde complète dans un endroit sûr pour référence ultérieure. Une fois B2G OS installé, il n'y a plus aucun moyen de récupérer ces fichiers !</p> - -<p>Assurez-vous d'avoir le <a href="/fr/docs/B2G_OS/Déboguer/Les_paramètres_développeurs#Débogage_via_USB">débogage distant</a> activé dans les <a href="/fr/docs/B2G_OS/Déboguer/Les_paramètres_développeurs">paramètres développeurs</a> de votre appareil. Vérifiez que ce dernier est visible avec la commande <code>adb devices</code> ; vous devriez voir quelque chose de similaire à ceci :</p> - -<pre style="font-size: 14px;"><code>$ adb devices -List of devices attached -ABCXXXXXXX device</code></pre> - -<p>Si aucun appareil n'est listé, vérifiez vos règles UDEV.</p> - -<div class="note"><strong>Note :</strong> Si vous avez des problèmes de permissions, vérifiez que votre écran est déverrouillé et que vous avez autorisé l'accès à votre téléphone. Un message s'affiche sur votre appareil dans ce but. Si le problème persiste, utilisez <code>adb root </code>et <code>adb remount</code><span lang="fr">.</span></div> - -<p>Sauvegardez les partitions du téléphone avec la commande <code>adb pull</code> :</p> - -<pre><code>adb pull /system <répertoire cible de la sauvegarde>/system -</code></pre> - -<p>En fonction du téléphone, vous devrez peut-être récupérer également les répertoires <code>/data</code> et <code>/vendor</code> :</p> - -<pre><code>adb pull /data <répertoire cible de la sauvegarde>/data -adb pull /vendor <répertoire cible de la sauvegarde>/vendor</code> -</pre> - -<p>Si les commandes pull échouent avec un message "insufficient permission", essayez ce qui suit :</p> - -<ul> - <li>Vérifiez que vous avez accordé les permissions root dans votre ROM personnalisée (e.g. sous CyanogenMod, modifiez <em>Paramètres > Système > Options pour les développeurs > Accès root</em> en <em>Applications et ADB</em> ou <em>ADB uniquement</em>).</li> - <li>Vérifiez que vous avez correctement configuré les règles udev (voir <a href="#Pour_Linux_:_configurez_les_règles_udev_de_votre_téléphone">Pour Linux : configurez les règles udev de votre téléphone</a>).</li> -</ul> - -<h2 id="Prochaine_étape">Prochaine étape</h2> - -<p>À ce stade, vous devriez être prêt à <a href="/fr/docs/B2G_OS/Compiler">Compiler B2G OS</a>.</p> - -<h2 id="Options_de_configuration_avancées">Options de configuration avancées</h2> - -<h3 id="Configurer_la_compilation_en_utilisant_une_sauvegarde_système">Configurer la compilation en utilisant une sauvegarde système</h3> - -<p>Si votre téléphone n'a plus Android installé et que votre arborescence B2G ne contient pas les blobs binaires, mais que vous avez une sauvegarde des partitions systèmes, vous pourrez construire une version à partir de celle-ci de cette manière :</p> - -<pre><code>ANDROIDFS_DIR=<chemin absolu vers le répertoire parent du répertoire système> ./config.sh <cible> -</code></pre> - -<p>Le système de compilation recherchera une sauvegarde existante dans un dossier <code>backup-<cible>/system</code>, il ne vous sera pas nécessaire de spécifier le répertoire si les fichiers sont placés à cet endroit.</p> - -<h3 id="Compiler_en_utilisant_une_version_personnalisée_de_Gecko">Compiler en utilisant une version personnalisée de Gecko</h3> - -<p>Il peut arriver que vous souhaitez, ou avez besoin, de compiler une version de Boot to Gecko basée sur une version de Gecko différente de celle utilisée par défaut (définie dans le manifeste). Vous pouvez faire cela en éditant le fichier <code>.userconfig</code>. Par exemple, si vous souhaitez compiler une version utilisant mozilla-central :</p> - -<pre><code>export GECKO_PATH=/chemin/vers/mozilla-central -export GECKO_OBJDIR=/chemin/vers/mozilla-central/objdir-gonk</code> -</pre> - -<div class="note"> -<p><strong>Note</strong> : Sous Mac OS X, le répertoire mozilla-central doit se situer dans un système de fichiers sensible à la casse.</p> -</div> - -<p id="Building_a_branch">Notez que cette étape peut être faite avant ou après avoir récupéré le dépôt (i.e. avant l'étape <code>config.sh</code> ci-dessus) ou plus tard. Vous pouvez également conserver plusieurs versions (avec débogage activé ou non, etc) en ayant plusieurs fichiers userconfig (avec des paramètres différents--chacun nécessitant évidemment un OBJDIR différent) et en faisant un lien symbolique .userconfig qui pointe sur la configuration que vous voulez compiler à ce moment.</p> - -<p>Pour plus d'informations, lisez <a class="vt-p" href="/fr/docs/B2G_OS/Customisation_avec_le_fichier_.userconfig#Changer_l'arbre_source_de_Gecko" title="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file#Changing_the_Gecko_source_tree">Changer l'arborescence source de Gecko</a>.</p> - -<h3 id="Construction_d'une_branche">Construction d'une branche</h3> - -<p>Si vous souhaitez compiler une branche autre que celle par défaut (<strong>remarque : la branche par défaut n'est pas forcément "master" !</strong>), vous devrez préfixer l'appel à config.sh avec le nom de la branche, comme ceci :</p> - -<pre><code>BRANCH=nom-branche ./config.sh <appareil></code></pre> - -<p>Les noms de branches sont relativement logiques et suivent en général les noms de produits/versions, donc <code>v1-train</code>, <code>v1.0.0</code>, <code>v1.0.1</code>, <code>v1.1</code>, <code>v1.1.0hd</code>, <code>v1.2, v1.3, v1.4, v2.0</code> et ainsi de suite au fur et à mesure. Comme exemple, pour compiler B2G OS 1.2, pour l'émulateur Arm, vous devez saisir</p> - -<pre><code>BRANCH=v1.2 ./config.sh emulator</code></pre> - -<p>Si vous avez déjà lancé config.sh, vous pouvez voir les noms des branches, en allant dans <code>B2G/.repo/manifests</code> et en faisant "<code>git branch -a</code>" (ce n'est pas renseigné temps que ce n'est pas encore fait.) <strong>Le nom de la branche est indiqué comme mot-clé final sur la ligne, e.g. "<code>v1-train</code>" ou "<code>master</code>"</strong>:</p> - -<pre><code> remotes/origin/master - remotes/origin/v1-train - remotes/origin/v1.0.0 - remotes/origin/v1.0.1</code></pre> - -<p>Voir <a class="vt-p" href="/fr/docs/B2G_OS/Customisation_avec_le_fichier_.userconfig" title="Mozilla/Firefox_OS/Customization_with_the_.userconfig_file">Personnalisation avec le fichier .userconfig</a> pour des possibilités supplémentaires de personnalisation.</p> - -<h3 id="Copier_votre_arborescence_B2G_vers_une_nouvelle_machine">Copier votre arborescence B2G vers une nouvelle machine</h3> - -<p>Si vous avez déjà préparé une arborescence complète pour B2G et que vous devez changer de machine (chanceux !), vous vous simplifierez la vie en migrant simplement toute l'arborescence B2G de votre ancien ordinateur vers le nouveau, plutôt que de tout reconfigurer. Pour cela, montez le système de fichier de votre ancienne machine sur la nouvelle, puis faîtes ceci :</p> - -<pre><code>rsync -a <em>source</em>/ <em>dest</em>/ -</code></pre> - -<p>Où <code>source</code> correspond au chemin complet de l'arborescence source (avec la barre oblique / à la fin), <code>dest</code> correspond au chemin de destination de la copie (le / à la fin est également important !).</p> - -<div class="note"><strong>Note :</strong> Si vous copiez les fichiers à partir d'une machine avec une architecture différente n'oubliez pas d'éxécuter '<em>./build.sh clean'</em> avant de démarrer la compilation. SInon, vous risquez de rencontrer des problèmes de compilation.</div> - -<p>Si vous suivez ces étapes, vous pouvez sauter tout le reste de cet article et passer directement à la <a class="vt-p" href="/fr/docs/B2G_OS/Compiler" title="Mozilla/Firefox_OS/Building">compilation</a>.</p> - -<h3 id="Mettre_à_jour_votre_arborescence_B2G">Mettre à jour votre arborescence B2G</h3> - -<p>Quand le répertoire est mis à jour vers une nouvelle version de B2G, vous pourrez mettre à jour votre arborescence. Pour ce faire, utilisez les commandes suivantes :</p> - -<pre><code>git fetch origin -git checkout origin/master</code></pre> - -<p>Vous pouvez vérifier que les commandes ont réussi avec :</p> - -<pre><code>git show HEAD</code></pre> - -<p>Puis en vérifiant que la modification indiquée par la commande correspond à celle donnée par : <a class="vt-p" href="https://github.com/mozilla-b2g/B2G/commits/master" title="https://github.com/mozilla-b2g/B2G/commits/master">https://github.com/mozilla-b2g/B2G/commits/master</a></p> diff --git a/files/fr/archive/b2g_os/prerequis_pour_construire_firefox_os/index.html b/files/fr/archive/b2g_os/prerequis_pour_construire_firefox_os/index.html deleted file mode 100644 index 08892dcdc3..0000000000 --- a/files/fr/archive/b2g_os/prerequis_pour_construire_firefox_os/index.html +++ /dev/null @@ -1,421 +0,0 @@ ---- -title: Prérequis pour construire B2G OS -slug: Archive/B2G_OS/Prerequis_pour_construire_Firefox_OS -tags: - - Build Firefox OS - - Build documentation - - Build prerequisite - - Firefox OS - - Mobile - - Mobile OS -translation_of: Archive/B2G_OS/B2G_OS_build_prerequisites ---- -<div class="summary"> -<p><span class="seoSummary">Avant d'obtenir le code source pour compiler B2G OS, même si c'est juste pour essayer de construire Gaia, vous aurez besoin d'un <a href="https://developer.mozilla.org/fr/docs/Documentation_sur_la_compilation" title="https://developer.mozilla.org/en-US/docs/Developer_Guide/Build_Instructions">système de compilation</a> correctement configuré — cette page vous montre comment faire. Pour l'instant, vous pouvez compiler sur des distributions Linux 64 bits et sous OS X.</span></p> -</div> - -<h2 id="Cibles_de_compilation_compatibles">Cibles de compilation compatibles</h2> - -<p>Vous avez besoin d'un appareil compatible pour lequel effectuer la compilation, ou alors vous pouvez utiliser un émulateur.</p> - -<div class="note"> -<p><strong>Note</strong> : Le <a href="https://github.com/mozilla-b2g/B2G">code source de B2G</a> de Mozilla constitue l'implémentation de référence de B2G OS, bien que les vendeurs de téléphones effectuent souvent des modifications. Lorsque vous achetez un appareil dans le commerce, il intègre la version spécifique au fabricant. Cela n'affecte pas les applications installées, mais cela peut différer au niveau de la plate-forme. Le portage pour Nexus 5 est maintenu directement par Mozilla ; il possède une meilleure compatibilité avec notre version de Gecko comparé à d'autres appareils.</p> -</div> - -<h3 id="Émulateur"><a href="/fr/docs/B2G_OS/Using_the_B2G_emulators" title="en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators">Émulateur</a></h3> - -<p>Deux émulateurs sont disponibles : l'un émule du code ARM tandis que l'autre exécute tout en code x86. <a href="/fr/docs/B2G_OS/Using_the_B2G_emulators" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators">Apprenez comment les installer et les utiliser</a>. <strong>N'utilisez pas l'émulateur x86 — il est difficile à installer et n'est pas si compatible.</strong></p> - -<h3 id="Bureau"><a href="/fr/docs/B2G_OS/Building_the_Firefox_OS_simulator" title="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">Bureau</a></h3> - -<p>Vous pouvez construire une version de B2G OS pour ordinateur de bureau ; elle fait fonctionner <a href="/fr/docs/Gecko" title="/en-US/docs/Mozilla/Gecko">Gecko</a> au sein d'une application <a href="/fr/docs/XULRunner" title="/en-US/docs/XULRunner">XULRunner</a>, et vous utilisez ensuite l'interface utilisateur <a href="/fr/docs/B2G_OS/Platform/Gaia/Introduction_a_Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia/Introduction_to_Gaia">Gaia</a> à l'intérieur de celle-ci.</p> - -<h3 id="Appareils"><a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">Appareils</a></h3> - -<p>Plusieurs appareils sont compatibles avec B2G OS, mais certains sont plus compatibles que d'autres, et la compatibilité d'un appareil peut se restreindre à des variantes spécifiques. Vérifiez la page des <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Appareils_compatibles">appareils compatibles</a> pour plus de détails.</p> - -<div class="warning"><strong>Important</strong> : Seuls les appareils qui font fonctionner au minimum <strong>Android 4.3</strong> (c'est-à-dire <strong>Jellybean, Kitkat ou Lollipop</strong>) sont compatibles. Si votre appareil est listé ci-dessus mais fonctionne avec une version d'Android plus ancienne, mettez-le à jour.</div> - -<h2 id="Prérequis_pour_GNULinux">Prérequis pour GNU/Linux</h2> - -<p>Pour compiler sur Linux, vous aurez besoin de :</p> - -<ul> - <li>Une distribution <strong>GNU/Linux 64 bits</strong> (Ubuntu 14.04 LTS est conseillée).</li> - <li>Au moins <strong>4 Go</strong> de RAM.</li> - <li>Au moins <strong>40 Go</strong> d'espace disque disponible.</li> -</ul> - -<p>Vous aurez aussi besoin de la présence des outils suivants :</p> - -<table class="standard-table"> - <tbody> - <tr> - <td> - <ul> - <li><strong>autoconf 2.13</strong></li> - <li><strong>bison</strong></li> - <li><strong>bzip2</strong></li> - <li><strong>ccache</strong></li> - <li><strong>curl</strong></li> - <li><strong>flex</strong></li> - <li><strong>gawk</strong></li> - <li><strong>git</strong></li> - <li><strong>gcc</strong></li> - <li><strong>nodejs</strong></li> - <li><strong>python</strong></li> - </ul> - </td> - <td> - <ul> - <li><strong>g++ / g++-multilib</strong></li> - <li><strong>java sdk (jdk)</strong></li> - <li><strong>lzop</strong></li> - <li><strong>make</strong></li> - <li><strong>OpenGL shared libraries</strong></li> - <li><strong>patch</strong></li> - <li><strong>X11 headers</strong></li> - <li><strong>32-bit ncurses</strong></li> - <li><strong>32-bit zlib</strong></li> - <li><strong>unzip</strong></li> - </ul> - </td> - </tr> - </tbody> -</table> - -<h3 id="Ubuntu_12.04_LTS_Debian_6_Linux_Mint_13">Ubuntu 12.04 LTS / Debian 6 / Linux Mint 13</h3> - -<p>Exécutez la commande suivante dans un Terminal :</p> - -<pre><code>sudo apt-get install autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git ia32-libs lib32ncurses5-dev lib32z1-dev libasound-dev libgconf2-dev libgl1-mesa-dev libx11-dev lzop make zip libxml2-utils nodejs unzip python</code></pre> - -<p>vous pouvez installer le jdk via <a href="http://www.webupd8.org/2012/01/install-oracle-java-jdk-7-in-ubuntu-via.html">ce ppa</a>.</p> - -<h3 id="Ubuntu_14.04_LTS_Debian_7">Ubuntu 14.04 LTS / Debian 7</h3> - -<p>Tout d'abord, lancez les commandes suivantes pour définir les architectures requises :</p> - -<pre><code>sudo dpkg --add-architecture i386</code> -sudo dpkg --add-architecture amd64 -</pre> - -<p>Ensuite, exécutez la commande suivante dans un Terminal :</p> - -<pre><code>sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip lzop libxml2-utils openjdk-7-jdk nodejs unzip python</code> -</pre> - -<h3 id="Ubuntu_16.04">Ubuntu 16.04</h3> - -<div class="note"> -<p>Ubuntu 16.04, juin 2016, la version de <strong>make</strong> est <strong>4.1</strong>, ce qui empêche la construction d'android ; si vous rencontrez ce cas, vous devrez ajouter le dépôt trusty (14.04) et revenir à la <strong>version 3.81</strong> en exécutant cette commande :</p> - -<pre><code>sudo apt-get install make=3.81-8.2ubuntu3</code></pre> - -<p>ensuite, pour éviter toute mise à jour automatique, vous pouvez marquer le paquet <strong>make</strong> avec <em>hold</em> pour le conserver</p> - -<pre><code>sudo apt-mark hold make </code></pre> -</div> - -<p>Premièrement, lancez les commandes suivantes pour définir les architectures requises :</p> - -<pre><code>sudo dpkg --add-architecture i386</code> -sudo dpkg --add-architecture amd64 -</pre> - -<p>Ensuite, exécutez la commande suivanre dans un Terminal :</p> - -<pre><code>sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip lzop libxml2-utils openjdk-8-jdk nodejs unzip python</code> -</pre> - -<h3 id="Ubuntu_16.10">Ubuntu 16.10</h3> - -<p>Sur ubuntu 16.10, la version par défaut de make est la 4.1 ce qui empêche la compilation d'android ; pour résoudre ce problème, entrez les commandes suivantes dans la console :</p> - -<pre>wget http://ftp.us.debian.org/debian/pool/main/m/make-dfsg/make_3.81-8.2_amd64.deb - -sudo dpkg -i make_3.81-8.2_amd64.deb</pre> - -<p>Ensuite, pour éviter les mises à jour automatiques, vous pouvez marquer le paquet make comme étant à conserver :</p> - -<pre>sudo apt-mark hold make</pre> - -<p>Vous devez ansuite ajouter les architectures requises :</p> - -<pre>sudo dpkg --add-architecture i386 - -sudo dpkg --add-architecture amd64 </pre> - -<p>Puis, lancez la commande suivante dans un Terminal :</p> - -<pre><code>sudo apt-get install --no-install-recommends autoconf2.13 bison bzip2 ccache curl flex gawk gcc g++ g++-multilib git lib32ncurses5-dev lib32z1-dev libgconf2-dev zlib1g:amd64 zlib1g-dev:amd64 zlib1g:i386 zlib1g-dev:i386 libgl1-mesa-dev libx11-dev make zip lzop libxml2-utils openjdk-8-jdk nodejs unzip python</code> </pre> - -<p> </p> - -<h3 id="Configurer_l'accès_USB">Configurer l'accès USB</h3> - -<p>Sur les systèmes Linux, par défaut, les utilisateurs classiques ne peuvent pas accéder directement aux périphériques USB. Il faut configurer des règles udev. Créez un fichier appelé <code>/etc/udev/rules.d/51-android.rules</code> avec la commande suivante :</p> - -<p><strong>À FAIRE : Fusionner avec le bogue 1230463</strong></p> - -<pre><code>wget -S -O - https://raw.githubusercontent.com/cm-b2g/B2G/1230463/tools/51-android.rules | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules - -<s>wget -S -O - https://raw.githubusercontent.com/mozilla-b2g/B2G/master/tools/51-android.rules | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules</s></code></pre> - -<p>Les nouvelles règles prendront effet au prochain branchement d'un périphérique.</p> - -<h3 id="Configurer_ccache">Configurer ccache</h3> - -<p>Une tonne de code est compilée mais une grande quantité ne change pas d'une version à l'autre. Nous pouvons considérablement accélérer la construction avec l'outil de compilation ccache. Attribuez-lui un cache de 50 Go avec la commande suivante :</p> - -<pre><code>ccache -M 50G</code></pre> - -<div class="note"> -<p><strong>Note</strong> : Si vous avez peu d'espace disque, vous pouvez néanmoins définir un cache inférieur à 50 Go.</p> -</div> - -<h3 id="Distributions_alternatives">Distributions alternatives</h3> - -<h4 id="Fedora_22">Fedora 22</h4> - -<p>Lancez la commande suivante dans un Terminal :</p> - -<pre><code>sudo yum install autoconf213 bison bzip2 ccache curl flex gawk gcc-c++ git glibc-devel glibc-static libstdc++-static libX11-devel make mesa-libGL-devel ncurses-devel patch zlib-devel ncurses-devel.i686 readline-devel.i686 zlib-devel.i686 libX11-devel.i686 mesa-libGL-devel.i686 glibc-devel.i686 libstdc++.i686 libXrandr.i686 zip perl-Digest-SHA wget lzop libxml2-utils</code></pre> - -<h4 id="Arch_Linux">Arch Linux</h4> - -<p>Lancez la commande suivante dans un Terminal :</p> - -<pre><code>sudo pacman -S --needed alsa-lib autoconf2.13 bison ccache curl firefox flex gcc-multilib git gperf libnotify libxt libx11 mesa multilib-devel wget wireless_tools yasm zip lib32-mesa lib32-mesa-libgl lib32-ncurses lib32-readline lib32-zlib lzop</code></pre> - -<p>Pour installer les paquets lib32-*, vous devrez activer le dépôt multilib.</p> - -<p>Par défaut, Arch Linux utilise Python 3. Vous allez devoir le forcer à utiliser l'ancien Python 2. C'est possible en faisant un lien depuis l'exécutable python2 vers python mais cela est déconseillé et considéré comme source d'erreurs. Cela va également casser Python 3 s'il est installlé sur votre système. Une meilleure méthode consiste à utiliser <code>virtualenv</code>/<code>virtualenvwrapper</code> :</p> - -<pre><code><span><span>sudo pacman -S python-virtualenvwrapper -</span></span>source /usr/bin/virtualenvwrapper.sh -mkvirtualenv -p `which python2` firefoxos -workon firefoxos</code> -</pre> - -<p>Ainsi, l'exécution de</p> - -<pre><code>python --version</code></pre> - -<p>Donne comme résultat "Python 2.7.12".</p> - -<h4 id="Gentoo_Linux">Gentoo Linux</h4> - -<h5 id="Installation_de_ccache">Installation de ccache</h5> - -<p>Vous aurez besoin d'installer <strong><a href="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=3#doc_chap3">ccache</a></strong>, un outil pour mettre en cache des constructions partielles.</p> - -<pre><code><span><span># emerge -av ccache</span></span> -</code></pre> - -<p>Comme ccache est connu pour souvent provoquer des problèmes, Gentoo encourage les personnes à l'utiliser de manière <em>explicite</em> et avec <em>parcimonie</em>.</p> - -<p>Pour activer l'utilisation nécessaire de ccache, lors de l'<em>étape suivante</em> de ce guide où le script <code>./build.sh</code> script est appelé, les utilisateurs de Gentoo doivent à la place lancer la commande avec un chemin explicite étendu, c'est-à-dire :</p> - -<pre><code><span><span><strong>PATH=/usr/lib64/ccache/bin:$PATH</strong> ./build.sh</span></span> -</code></pre> - -<p id="Generating_Partition_Images"><strong>Génération des images de partitions</strong></p> - -<p>Si vous compilez B2G pour un véritable appareil physique, alors vous serez amené à un certain moment à générer certaines images de partitions pour les envoyer sur votre appareil. (Par exemple, pour restaurer des fichiers sauvegardés vers l'appareil via l'utilitaire <strong><em>fastboot</em></strong>)</p> - -<p>Le format utilisé pour l'image du système de fichiers dans ce cas est YAFFS2 (Yet Another Filesystem 2). Gentoo intègre le support de la toute dernière version (ie. git HEAD) du paquet <code>yaffs2-utils</code> en espace utilisateur dans le portage. (Note : Vous aurez aussi besoin de correctifs noyau si vous souhaitez monter des images YAFFS2, mais ce n'est pas vraiment obligatoire car à la place vous pouvez les déconstruire puis les reconstruire.)</p> - -<pre><code># emerge --autounmask-write yaffs2-utils; etc-update; emerge -av yaffs2-utils</code></pre> - -<p>Afin de générer une telle image, placez-vous simplement dans le répertoire parent de l'arborescence du système de fichiers de la partition que vous voulez empaqueter, puis envoyez une commande comme ceci :</p> - -<pre><code>mkyaffs2image system/ system.img</code></pre> - -<h3 id="Branches_anciennes">Branches anciennes</h3> - -<p>Si vous souhaitez compiler une ancienne branche de B2G OS, des erreurs de compilation peuvent survenir. Voir la page <a href="/fr/docs/B2G_OS/Building_and_installing_Boot_to_Gecko/Construire_anciennes_branches">Construire d'anciennes branches</a>.</p> - -<h2 id="Prérequis_pour_OS_X">Prérequis pour OS X</h2> - -<div class="note"> -<p><strong>Note : La configuration et la compilation de B2G pour Keon <u>ne fonctionne pas</u> sur Mac</strong>. Il vous faut utiliser Linux pour construire B2G pour cet appareil.</p> -</div> - -<div class="note"> -<p><strong>Note : La compilation de B2G pour Fairphone2 <u>ne fonctionne pas</u> sur Mac</strong>. Il vous faudra utiliser Linux pour construire B2G pour cet appareil. La cause est l'échec de la vérification MD5 des blobs ; pour plus d'informations, voir : <a href="https://forum.fairphone.com/t/blobs-md5-checksum-doenst-match/18107">Lien</a></p> -</div> - -<p>La construction de B2G OS sur OS X est possible, mais elle n'est ni facile ni très bien supportée. Il sera nécessaire d'installer une ancienne version de Xcode qui pourrait interférer avec la version actuelle si vous l'utilisez déjà. Pour une meilleure expérience, vous devriez compiler sur Ubuntu 14.04 LTS. Cependant, si vous <em>insistez</em>, essayez ces étapes :</p> - -<h3 id="OS_X_10.11_El_Capitan_et_OS_X_10.10_Yosemite">OS X 10.11 El Capitan et OS X 10.10 Yosemite</h3> - -<div class="warning"> -<p><strong>Important </strong>: La construction sur OS X 10.11 El Capitan est expérimentale et peut ne pas se terminer ! Restez sur OS X 10.10 Yosemite jusqu'à ce que les instructions ci-dessous soient améliorées et que cet avertissement soit supprimé.</p> -</div> - -<h4 id="Système_de_fichiers_sensible_à_la_casse">Système de fichiers sensible à la casse</h4> - -<p>L'installation par défaut d'OS X ne convient pas pour la compilation de B2G OS. Il vous faut réinstaller OS X sur un système de fichiers sensible à la casse.</p> - -<h4 id="Xcode_7.2">Xcode 7.2</h4> - -<ol> - <li>Installez la dernière version de Xcode à partir de l'Apple Store.</li> - <li>Acceptez la licence avec la commande suivante :</li> -</ol> - -<pre><code>sudo xcodebuild -license</code></pre> - -<h4 id="Xcode_Command_Line_Tools">Xcode Command Line Tools</h4> - -<p>Installez Xcode Command Line Tools avec la commande suivante :</p> - -<pre><code>xcode-select --install</code></pre> - -<h4 id="Xcode_5.1.1">Xcode 5.1.1</h4> - -<div class="warning"> -<p><strong>Important </strong>: Veuillez installer Homebrew et ses outils (voir la section ci-dessous) avant de passer à celle du SDK de Xcode 5.1.1 - l'installation d'Homebrew sur le SDK Xcode 5.1.1 <em>va</em> échouer !</p> -</div> - -<p>AOSP, et par conséquent B2G OS, n'est pas compatible avec la dernière version du SDK d'Xcode. Nous avons besoin d'installer une version plus ancienne à côté de la plus récente.</p> - -<ol> - <li>Téléchargez Xcode 5.1.1 depuis <a href="https://developer.apple.com/downloads/">developer.apple.com</a> et installez-le dans /Applications/Xcode-5.1.1</li> - <li>Basculez vers l'utilisation du SDK Xcode 5.1.1 avec la commande suivante :</li> -</ol> - -<pre><code>sudo xcode-select --switch "/Applications/Xcode-5.1.1/Xcode.app/Contents/Developer"</code></pre> - -<h4 id="Java_SE_Development_Kit_7">Java SE Development Kit 7</h4> - -<p>AOSP, et par conséquent B2G OS, n'est pas compatible avec le JDK Java <strong>v8</strong>, il est donc nécessaire d'installer le JDK Java <strong>v7</strong>. Vous pouvez le télécharger depuis <a href="http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html">http://www.oracle.com/</a>.</p> - -<h4 id="Profil_Bash">Profil Bash</h4> - -<p>Ajouter les lignes suivantes à votre fichier <code>~/.bash_profile</code> :</p> - -<pre><code>export PATH=~/bin:$PATH -export PATH=/usr/local/bin:$PATH -export BUILD_MAC_SDK_EXPERIMENTAL=1 -export LC_CTYPE=C -export LANG=C -export USE_CCACHE=1</code></pre> - -<h3 id="Homebrew">Homebrew</h3> - -<p>Nous devons installer certains outils en ligne de commande <em>en plus</em> car ils ne sont pas fournis par Apple. Installez Homebrew :</p> - -<pre><code id="selectable">ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"</code></pre> - -<p>Ensuite, installez les outils avec la commande suivante :</p> - -<pre><code>brew install ccache coreutils cmake findutils git gnu-tar gnu-sed gpg lzop yasm</code></pre> - -<p>Il faut une version spécifique d'autoconf, la version 2.13 :</p> - -<pre><code>brew install homebrew/versions/autoconf213 -</code></pre> - -<h3 id="Configurer_ccache_2">Configurer ccache</h3> - -<p>Beaucoup de code est compilé mais une grande partie de change pas selon les versions. La vitesse de compilation peut être considérablement accélérée avec l'outil de compilation ccache. Attribuez-lui un cache de 50 Go avec la commande suivante :</p> - -<pre><code>prebuilts/misc/darwin-x86/ccache/ccache -M 50G</code></pre> - -<h3 id="Anciennes_instructions_pour_OS_X">Anciennes instructions pour OS X</h3> - -<h4 id="Exécutez_B2G_OS_Mac_Bootstrap">Exécutez B2G OS Mac Bootstrap</h4> - -<p>Ensuite, ouvrez un terminal et lancez la commande suivante :</p> - -<pre class="brush: bash"><code>curl -fsSL https://raw.github.com/mozilla-b2g/B2G/master/scripts/bootstrap-mac.sh | bash</code></pre> - -<p>Cela va récupérer et lancer un script de bootstrap qui va s'assurer que vous disposez de tous les éléments requis pour construire l'émulateur. Il vous demandera aussi la permission d'installer ce qui pourrait manquer et fournir des avertissements et des suggestions de correction en cas de problème.</p> - -<p>Pour développer avec B2G, vous allez avoir besoin de récupérer une branche particulière. Cette dernière est à télécharger depuis Mercurial. <a href="http://mozilla-version-control-tools.readthedocs.io/en/latest/hgmozilla/installing.html">(en apprendre plus)</a> Comme OSX ne dispose pas de Mercurial par défaut, vous devez l'installer avec ce code :</p> - -<pre>$ brew install mercurial</pre> - -<h4 id="Tenez_compte_de_la_sensibilité_à_la_casse_du_système_de_fichiers_Mac">Tenez compte de la sensibilité à la casse du système de fichiers Mac</h4> - -<p>Par défaut, OS X est installé sur un système de fichiers insensible à la casse. Cela pose problème car le noyau Linux contient un certain nombre de fichiers avec des noms identiques, mais avec des casses différentes. Par exemple, les fichiers d'en-tête <code>xt_CONNMARK.h</code> et <code>xt_connmark.h</code> Cela a pour conséquence de faire paraître un certain nombre de fichiers comme ayant été modifiés dans <code>/kernel</code> après un tout récent <code>./config.sh</code>.</p> - -<p>Dans de nombreux cas, vous pouvez lancer la compilation sans problème ; sur certaines plateformes par contre, vous pouvez rencontrer l'erreur suivante :</p> - -<pre><code><span class="quote">ERROR: You have uncommited changes in kernel -You may force overwriting these changes -with |source build/envsetup.sh force| - -ERROR: Patching of kernel/ failed.</span></code></pre> - -<p><span class="quote">Veuillez vous référer au <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=867259" title="https://bugzilla.mozilla.org/show_bug.cgi?id=867259">bogue 867259</a></span> pour plus de détails et des correctifs éventuels pour ce problème.</p> - -<p>Sinon, ce sera toujours plus sûr de compiler sur un système de fichiers sensible à la casse. La méthode la plus simple pour cela consiste à créer une image disque montable, distincte, avec la sensibilité à la casse activée. Faîtes attention à ne pas utiliser de lettres en capitale si vous changez le nom spécifié par -volname. L'image peut être créée avec l'application d'Apple Disk Utility ou en ligne de commande :</p> - -<pre><code>hdiutil create -volname 'firefoxos' -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 80g ~/firefoxos.sparseimage</code></pre> - -<p>Montez le lecteur avec :</p> - -<pre><code>open ~/firefoxos.sparseimage</code></pre> - -<p>Changez de répertoire vers le lecteur monté avec :</p> - -<pre><code>cd /Volumes/firefoxos/</code></pre> - -<p>Vous pouvez ensuite récupérer le code et le compiler depuis cet emplacement sans vous préoccuper des problèmes de sensibilité à la casse.</p> - -<h3 id="Optionnel_Installer_HAX">Optionnel : Installer HAX</h3> - -<p>Intel fournit un pilote spécial qui permet à l'émulateur B2G d'exécuter son code en natif sur votre Mac au lieu de l'émuler lorsque vous utilisez l'émulateur x86. Si vous souhaitez l'utiliser, vous pouvez le <a class="external" href="http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager/" title="http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager/">télécharger et l'installer</a>. Ce n'est pas obligatoire, mais cela peut améliorer les performances et la stabilité de l'émulation.</p> - -<p>Avant que vous ne puissiez installer HAX, vous devez installer le <a href="http://developer.android.com/sdk/index.html" title="http://developer.android.com/sdk/index.html">SDK d'Android</a>.</p> - -<h3 id="Installer_adb">Installer adb</h3> - -<p>Le processus de construction a besoin d'extraire les blobs binaires de l'installation d'Android présente sur le téléphone avant de compiler B2G (sauf si vous construisez l'émulateur bien sûr). Dans ce but, il sera nécessaire d'avoir <code>adb</code> (Android Debug Bridge). Notre article <a href="/fr/docs/B2G_OS/Déboguer/Installer_ADB">Installer ADB</a> explique comment faire.</p> - -<div class="warning"> -<p>Note pour plus tard lorsque vous commencerez à utiliser adb : l'écran de verrouillage du téléphone doit être déverrouillé pour qu'adb puisse voir votre téléphone (au moins dans les dernières versions de B2G OS). Vous préférerez sans doute désactiver l'écran de verrouillage (nous verrons comment plus loin dans les instructions de compilation).</p> -</div> - -<h3 id="Étapes_additionnelles_pour_le_Samsung_Galaxy_S2">Étapes additionnelles pour le Samsung Galaxy S2</h3> - -<p>Si vous envisagez de compiler pour le Samsung Galaxy S2, il vous sera aussi nécessaire d'avoir installé heimdall. Voir <a href="#Installer_heimdall">Installer heimdall</a> pour les détails. Le script de bootstrap <strong>ne</strong> le fera <strong>pas</strong> à votre place !</p> - -<p>De plus, vous devez garder à l'esprit les points suivants :</p> - -<ol> - <li>Lorsqu'éventuellement vous êtes sur le point d'<a href="/fr/docs/B2G_OS/Installer_sur_un_telephone_mobile">installer votre build</a> sur un appareil S2, avant de lancer le script <code>flash.sh</code>, vous devez remplacer toutes les occurences de <code>factoryfs</code> par <code>FACTORYFS</code>, ainsi que <code>kernel</code> par <code>KERNEL</code> (vérifiez la sortie de <code>pit</code> pour confirmation), sinon cela ne fonctionnera pas.</li> - <li>La ROM de Recovery <a href="http://www.gokhanmoral.com/2013/02/17/siyahkernel-s2-v6-0beta5/">Siyah-s2</a> est celle qui fonctionne le mieux. <a href="http://forum.xda-developers.com/wiki/ClockworkMod_Recovery">CWM</a> fonctionne bien aussi, mais présente quelques soucis.</li> - <li>Flasher votre S2 avec <code>flash.sh</code> va permettre de faire fonctionner l'OS de base mais la version de Gaia incluse peut avoir des problèmes. La rafraîchir avec <code>make reset-gaia PRODUCTION=1</code> devrait les résoudre.</li> -</ol> - -<div class="note"><strong>Note :</strong> Si vous avez installé l'outil <a class="external" href="http://www.samsung.com/us/kies/" title="http://www.samsung.com/us/kies/">Samsung Kies</a>, lequel est utilisé pour gérer le contenu de nombreux téléphones Samsung, vous aller devoir le supprimer avant de pouvoir flasher B2G OS sur votre appareil. Vous pouvez employer le procédé classique de Windows pour désinstaller l'application ; sur Mac, le disque d'installation de Kies contient un utilitaire pour complétement supprimer Kies du système. Le flashage <strong>ne fonctionnera pas</strong> si Kies est installé. Si vous oubliez de le supprimer, le système de compilation va le détecter et vous rappeler de le désinstaller. Remarquez aussi que l'outil de désinstallation ne supprime pas correctement le dossier <code>~/Library/Application Support/.FUS</code>, et y laisse une référence à un utilitaire dans votre liste d'éléments de démarrage utilisateur. Vous pourrez les supprimer manuellement.</div> - -<h3 id="Installer_heimdall">Installer heimdall</h3> - -<p>Heimdall est un utilitaire pour flasher le Samsung Galaxy S2. Il est utilisé par l'utilitaire de flashage de Boot to Gecko aussi bien pour remplacer le contenu du téléphone par B2G OS que pour flasher des versions mises à jour de B2G et de Gaia sur l'appareil. Vous en aurez besoin si vous voulez installer B2G OS sur un Galaxy S2 ; il <strong>n'est pas</strong> nécessaire pour les autres appareils. Pour ces derniers, nous construisons et utilisons l'utilitaire fastboot à la place.</p> - -<div class="note"><strong>Note :</strong> Encore une fois, il est important de noter que cela est <strong>nécessaire uniquement pour installer B2G OS sur le Samsung Galaxy S2</strong>.</div> - -<p>Il y a deux méthodes pour installer heimdall :</p> - -<ul> - <li>Vous pouvez <a class="link-https" href="https://github.com/Benjamin-Dobell/Heimdall" title="https://github.com/Benjamin-Dobell/Heimdall">télécharger le code</a> GitHub et le compiler vous-même.</li> - <li>Utiliser un gestionnaire de paquets pour l'installer. - <ul> - <li>Sur Linux: <code>sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev</code></li> - <li>Sur Mac, vous pouvez <a class="link-https" href="https://github.com/downloads/Benjamin-Dobell/Heimdall/heimdall-suite-1.3.2-mac.dmg" title="https://github.com/downloads/Benjamin-Dobell/Heimdall/heimdall-suite-1.3.2-mac.dmg">télécharger un installeur</a> et l'utiliser.</li> - </ul> - </li> -</ul> - -<div class="note"> -<p><strong>Note </strong>: À l'heure actuelle, compiler la dernière version d'Heimdall à partir des sources génère des erreurs. Il vaut mieux à la place utiliser la version sous forme de paquet 64 bits des dépôts Ubuntu 14.04. i.e. n'utilisez pas heimdall-flash:i386 si vous pouvez l'éviter.</p> -</div> - -<h2 id="Prochaine_étape">Prochaine étape</h2> - -<p>À ce stade, vous êtes prêt pour <a href="/fr/docs/B2G_OS/Preparing_for_your_first_B2G_build" title="en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build">récupérer le code source de B2G OS </a>!</p> diff --git a/files/fr/archive/b2g_os/quickstart/index.html b/files/fr/archive/b2g_os/quickstart/index.html deleted file mode 100644 index 197236620c..0000000000 --- a/files/fr/archive/b2g_os/quickstart/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Build -slug: Archive/B2G_OS/Quickstart -tags: - - Apps - - TopicStub -translation_of: Archive/B2G_OS/Quickstart ---- -<div class="summary"> -<p>Informations de démarrage rapide sur le codage des applications Web ouvertes.</p> -</div> - -<dl> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_open_web_apps">Introduction aux applications Web ouvertes</a></dt> - <dd>Que sont les applications Web ouvertes? En quoi diffèrent-elles des pages Web régulières? Pourquoi est-ce important? Cet article vise à répondre à ces questions et plus encore.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Your_first_app">Votre première application</a></dt> - <dd>Cet article vous guide à travers les étapes de base et les connaissances supplémentaires en plus du développement Web régulier requis pour créer des applications Web ouvertes installables.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_Firefox_OS">Introduction à Firefox OS</a></dt> - <dd>Une introduction à Firefox OS, la nouvelle plate-forme mobile ouverte basée sur les applications Web de Mozilla</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Intro_to_manifests">Introduction aux manifestes</a></dt> - <dd>Une FAQ conçue pour répondre à toutes vos questions sur les manifestes, l'hébergement d'applications, les origines et d'autres sujets similaires.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/For_Web_developers">Développement d'applications pour les développeurs Web</a></dt> - <dd>Si vous êtes un développeur Web, en quoi les applications Web ouvertes diffèrent-elles de ce à quoi vous êtes habitué? Cet article explique tout.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/For_mobile_developers">Développement d'applications pour les développeurs mobiles</a></dt> - <dd>Si vous êtes un développeur d'applications mobiles natives, quels avantages les applications Web ouvertes peuvent-elles vous apporter et en quoi diffèrent-elles de ce à quoi vous êtes habitué? Voici quelques idées.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Developing_app_functionality">Développer la fonctionnalité de l'application</a></dt> - <dd>Cette page décrit les types de fonctionnalités différentes que vous pourriez souhaiter intégrer à vos applications, avec des liens vers des informations supplémentaires.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/Payments">Paiements</a></dt> - <dd>Comment créez-vous des fonctionnalités pour faire payer les gens pour l'installation de vos applications Web ouvertes? Voici la vérité.</dd> - <dt><a href="/en-US/docs/Web/Apps/Quickstart/Build/App_tools">Outils d'application</a></dt> - <dd>Enfin pour cette section, nous fournissons des liens vers plus d'informations sur les outils disponibles pour vous aider à développer d'excellentes applications Web ouvertes.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/quickstart/votre_premier_application/index.html b/files/fr/archive/b2g_os/quickstart/votre_premier_application/index.html deleted file mode 100644 index fb7aee2781..0000000000 --- a/files/fr/archive/b2g_os/quickstart/votre_premier_application/index.html +++ /dev/null @@ -1,261 +0,0 @@ ---- -title: Votre première application -slug: Archive/B2G_OS/Quickstart/Votre_premier_application -tags: - - Applications - - Débutant - - Guide -translation_of: Archive/B2G_OS/Quickstart/Your_first_app ---- -<article class="brush: js"> -<div class="summary"> -<p><span id="result_box" lang="fr">Les Open Web apps <span class="hps">donnent aux développeurs</span> <span class="hps">web</span> <span class="hps">ce qu'ils ont</span> attendu <span class="hps">pendant des années</span><span>:</span> </span><span lang="fr"><span class="hps">un environnement</span> <span class="hps">multi-plateforme</span> <span class="hps">dédié</span> <span class="hps">aux applications</span> <span class="hps">installables</span> <span class="hps">créées</span> avec <span class="hps">HTML</span><span>,</span> <span class="hps">CSS et JavaScript</span> <span class="hps">-</span> <span class="hps">avec Firefox</span> <span class="hps">OS</span> <span class="hps">qui est</span> <span class="hps">la première</span> <span class="hps">plate-forme ouverte</span> <span class="hps">dédiée</span> <span class="hps">aux</span> <span class="hps">applications web</span><span>.</span> <span class="hps">Ce guide</span> <span class="hps">vous</span> <span class="hps">permet de démarrer</span> <span class="hps">rapidement avec</span> <span class="hps">une</span> <span class="hps">architecture de base</span> <span class="hps">ainsi que les premières instructions</span>. Vous pourrez ainsi <span class="hps">créer la prochaine</span> <span class="hps">application</span><span> révolutionnaire!</span></span></p> -</div> - -<p><span id="result_box" lang="fr"><span class="hps">Si vous</span> <span class="hps">souhaitez</span> <span class="hps">suivre ce</span> <span class="hps">guide,</span> <span class="hps">vous pouvez télécharger nos</span> <span class="hps">modèle</span>s <span class="hps">d'applications</span> <span class="hps">de <a href="https://github.com/chrisdavidmills/mdn-app-template">démarrage rapide</a></span><span>.</span> <span class="hps">Vous trouverez plus d'informations à propos de ce dernier</span> <span class="hps">en lisant notre</span> <span class="hps">guide sur les <a href="/fr/docs/Project:MDN/Style_guide/Sample_app_coding_guidelines#Apps_template">modèle</a></span><a href="/fr/docs/Project:MDN/Style_guide/Sample_app_coding_guidelines#Apps_template">s</a> <span class="hps">d'applications.</span></span></p> - -<h2 id="Structure_de_l'application">Structure de l'application</h2> - -<h3 id="Packaged_vs._Hosted_Apps">Packaged vs. Hosted Apps</h3> - -<p>Il y a deux types d'applications web : <code>packaged(empaquetées)</code> et <code>hosted(hébergées)</code> . Les applications empaquetées sont essentiellement des fichiers <code>zip</code> contenant toutes les ressources de l'application : HTML, CSS, JavaScript, images, manifeste, etc. Les applications hébergées sont exécutées à partir d'un serveur avec un domaine donné, comme les sites web standards. Les deux types d'application nécessitent un manifeste valide. Quand vous êtes prêt à soumettre votre application au Firefox Marketplace, vous devrez soit uploader votre application sous forme de zip, soit fournir l'URL où votre application est hébergée.</p> - -<div><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/Q7x-B13y33Q?rel=0&html5=1"></iframe></div></div> -<div class="video-caption"> -<p>Réalisé en partenariat avec Treehouse: <a class="button" href="http://teamtreehouse.com/?cid=1154">PASSEZ CHEZ EUX !</a></p> -</div> -</div> - -<p>Pour les besoins de ce tutoriel, vous allez créer une application qui sera hébergée sur votre adresse <code>localhost</code>. Une fois votre application prête à être postée dans le Firefox Marketplace, vous pourrez choisir la forme que prendra votre application : packaged app ou hosted app.</p> - -<h3 id="App_Manifests">App Manifests</h3> - -<p>Chaque application Firefox requiert un fichier manifest.webapp dans l'application racine. Le fichier <a href="/en-US/docs/Web/Apps/Manifest"><code>manifest.webapp</code></a> produit d'importantes informations sur l'application, comme la version, le nom, la description, les logos, les chaines locales, les domaines auquels l'application peut être installé, et beaucoup d'autres. Seulement le nom et la description sont requis. Le simple manifest inclus dans les modèles d'application est similaire à celui ci-dessous:</p> - -<pre class="brush: js">{ - "version": "0.1", - "name": "Open Web App", - "description": "Your new awesome Open Web App", - "launch_path": "/app-template/index.html", - "icons": { - "16": "/app-template/app-icons/icon-16.png", - "48": "/app-template/app-icons/icon-48.png", - "128": "/app-template/app-icons/icon-128.png" - }, - "developer": { - "name": "Your Name", - "url": "http://yourawesomeapp.com" - }, - "locales": { - "es": { - "description": "Su nueva aplicación impresionante Open Web", - "developer": { - "url": "http://yourawesomeapp.com" - } - }, - "it": { - "description": "Il vostro nuovo fantastico Open Web App", - "developer": { - "url": "http://yourawesomeapp.com" - } - } - }, - "default_locale": "en" -}</pre> - -<div><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/dgAUgHQOm8M#t?rel=0&html5=1"></iframe></div></div> -<div class="video-caption"> -<p>Fait en partenariat avec Treehouse: <a class="button" href="http://teamtreehouse.com/?cid=1154">PASSER CHEZ EUX</a></p> -</div> -</div> - -<p> </p> - -<p>Un manifest basique est tout ce dont vous avez besoin pour commencer. Pour plus de détails a propos des manifests, lire <a href="/en-US/docs/Web/Apps/Manifest">App Manifest</a>.</p> - -<h2 id="Disposition_et_Design_de_l'application">Disposition et Design de l'application</h2> - -<p>Le Responsive design est devenu de plus en plus important comme plusieurs résolutions d'écrans deviennent des standards sur différents appareils. Même si le principal objectif de votre application sont les plateformes mobiles comme Firefox OS, d'autres appareils y auront aussi probablement accès. <a href="//developer.mozilla.org/docs/CSS/Media_queries">CSS media queries</a> vous autorise à l'adapter selon la disposition de votre appareil, comme le montre ce petit exemple CSS:</p> - -<pre class="brush: css">/* The following are examples of different CSS media queries */ - -/* Basic desktop/screen width sniff */ -@media only screen and (min-width : 1224px) { - /* styles */ -} - -/* Traditional iPhone width */ -@media - only screen and (-webkit-min-device-pixel-ratio : 1.5), - only screen and (min-device-pixel-ratio : 1.5) { - /* styles */ -} - -/* Device settings at different orientations */ -@media screen and (orientation:portrait) { - /* styles */ -} -@media screen and (orientation:landscape) { - /* styles */ -}</pre> - -<p>Il ya beaucoup de Frameworks JavaScript et CSS frameworks disponibles pour aider dans le responsive design et dans le développement d'application mobile (<a href="http://twitter.github.com/bootstrap">Bootstrap</a>, etc.) Choisissez le/les framework(s) qui est(sont) le(s) mieux adapté(s) à votre application et votre style de développement.</p> - -<h2 id="APIs_du_Web">APIs du Web</h2> - -<p>Des APIs JavaScript ont été créés et augmentés rapidement comme les appareils. L'effort <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> de Mozilla <span id="result_box" lang="fr"><span>apporte des dizaines de fonctionnalités mobiles standard aux APIs JavaScript</span></span> . Une liste des supports et status de périphérique est disponible sur la page <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a>. La détection de fonctionnalités JavaScript est encore aujourd'hui un bon usage, comme montré dans l'exemple suivant :</p> - -<pre class="brush: js">// If this device supports the vibrate API... -if('vibrate' in navigator) { - // ... vibrate for a second - navigator.vibrate(1000); -}</pre> - -<p>Dans l'exemple suivant, la méthode d'affichage d'un <code><div></code> est modifiée en fonction de l'état de la batterie du périphérique :</p> - -<pre class="brush: java">// Create the battery indicator listeners -(function() { - var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery, - indicator, indicatorPercentage; - - if(battery) { - indicator = document.getElementById('indicator'), - indicatorPercentage = document.getElementById('indicator-percentage'); - - // Set listeners for changes - battery.addEventListener('chargingchange', updateBattery); - battery.addEventListener('levelchange', updateBattery); - - // Update immediately - updateBattery(); - } - - function updateBattery() { - // Update percentage width and text - var level = (battery.level * 100) + '%'; - indicatorPercentage.style.width = level; - indicatorPercentage.innerHTML = 'Battery: ' + level; - // Update charging status - indicator.className = battery.charging ? 'charging' : ''; - } -})();</pre> - -<p>Dans le code ci-dessus, une fois qu'il est confirmé que l'<a href="https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery">API Battery</a> est supporté, vous pouvez ajoutez des event listeners pour <code>chargingchange</code> et <code>levelchange</code> afin d'actualiser l'affichage de l'élément. Essayez d'ajouter ce qui suit au modèle de démarrage rapide, et voyez si vous pouvez le faire fonctionner.</p> - -<p>Référez-vous fréquemment à la page <a href="https://wiki.mozilla.org/WebAPI">WebAPI</a> pour vous mettre à jour avec les états d'API du périphérique.</p> - -<h3 id="Installer_la_fonctionnalité_API">Installer la fonctionnalité API</h3> - -<p>In our sample quickstart app template, we've implemented an install button that you can click when viewing the app as a standard Web page, to install that site on Firefox OS as an app. The button markup is nothing special:</p> - -<pre class="brush: html"><button id="install-btn">Install app</button></pre> - -<p>This button's functionality is implemented using the Install API (see install.js):</p> - -<pre class="brush: js">var manifest_url = location.href + 'manifest.webapp'; - -function install(ev) { - ev.preventDefault(); - // define the manifest URL - // install the app - var installLocFind = navigator.mozApps.install(manifest_url); - installLocFind.onsuccess = function(data) { - // App is installed, do something - }; - installLocFind.onerror = function() { - // App wasn't installed, info is in - // installapp.error.name - alert(installLocFind.error.name); - }; -}; - -// get a reference to the button and call install() on click if the app isn't already installed. If it is, hide the button. -var button = document.getElementById('install-btn'); - -var installCheck = navigator.mozApps.checkInstalled(manifest_url); - -installCheck.onsuccess = function() { - if(installCheck.result) { - button.style.display = "none"; - } else { - button.addEventListener('click', install, false); - }; -}; -</pre> - -<p>Let's run through briefly what is going on:</p> - -<ol> - <li>We get a reference to the install button and store it in the variable <code>button</code>.</li> - <li>We use <code>navigator.mozApps.checkInstalled</code> to check whether the app defined by the manifest at <code>http://people.mozilla.com/~cmills/location-finder/manifest.webapp</code> is already installed on the device. This test is stored in the variable <code>installCheck</code>.</li> - <li>When the test is successfully carried out, its success event is fired, therefore <code>installCheck.onsuccess = function() { ... }</code> is run.</li> - <li>We then test for the existence of <code>installCheck.result</code> using an <code>if</code> statement. If it does exist, meaning that the app is installed, we hide the button. An install button isn't needed if it is already installed.</li> - <li>If the app isn't installed, we add a click event listener to the button, so the <code>install()</code> function is run when the button is clicked.</li> - <li>When the button is clicked and the <code>install()</code> function is run, we store the manifest file location in a variable called <code>manifest_url</code>, and then install the app using <code>navigator.mozApps.install(manifest_url)</code>, storing a reference to that installation in the <code>installLocFind</code> variable. You'll notice that this installation also fires success and error events, so you can run actions dependent on whether the install happened successfully or not.</li> -</ol> - -<p>You may want to verify the <a href="/en-US/docs/Web/Apps/JavaScript_API">implementation state of the API</a> when first coming to Installable web apps.</p> - -<div class="note"> -<p>Note: Installable open web apps have a "single app per origin" security policy; basically, you can't host more than one installable app per origin. This makes testing a bit more tricky, but there are still ways around this, such as creating different sub-domains for apps, testing them using the Firefox OS Simulator, or testing the install functionality on Firefox Aurora/Nightly, which allows you to install installable web apps on the desktop. See <a href="/en-US/docs/Web/Apps/FAQs/About_app_manifests">FAQs about apps manifests</a> for more information on origins.</p> -</div> - -<h2 id="WebRT_APIs_(Permissions-based_APIs)">WebRT APIs (Permissions-based APIs)</h2> - -<p>There are a number of WebAPIs that are available but require permissions for that specific feature to be enabled. Apps may register permission requests within the <code>manifest.webapp</code> file like so:</p> - -<pre class="brush: js">// New key in the manifest: "permissions" -// Request access to any number of APIs -// Here we request permissions to the systemXHR API -"permissions": { - "systemXHR": {} -}</pre> - -<p>The three levels of permission are as follows:</p> - -<ul> - <li>Normal — APIs that don't need any kind of special access permissions.</li> - <li>Privileged — APIs available to developers to use in their applications, as long as they set access permissions in the app manifest files, and distribute them through a trusted source.</li> - <li>Certified — APIs that control critical functions on a device, such as the call dialer and messaging services. These are generally not available for third party developers to use.</li> -</ul> - -<p>For more information on app permission levels, read <a href="https://developer.mozilla.org/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps" title="/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps">Types of packaged apps</a>. You can find out more information about what APIs require permissions, and what permissions are required, at <a href="/en-US/docs/Web/Apps/App_permissions">App permissions</a>.</p> - -<div class="note"> -<p>It's important to note that not all Web APIs have been implemented within the Firefox OS Simulator.</p> -</div> - -<h2 id="Tools_Testing">Tools & Testing</h2> - -<p>Testing is incredibly important when supporting mobile devices. There are many options for testing installable open web apps.</p> - -<h3 id="Firefox_OS_Simulator">Firefox OS Simulator</h3> - -<p>Installing and using the <a href="https://marketplace.firefox.com/developers/docs/firefox_os_simulator">Firefox OS Simulator</a> is the easiest way to get up and running with your app. After you install the simulator, it is accessible from the Tools -> Web Developer -> Firefox OS Simulator menu. The simulator launches with a JavaScript console so you can debug your application from within the simulator.</p> - -<h3 id="App_Manager">App Manager</h3> - -<p>The new kid on the block with regards to testing tools is called the <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_App_Manager">App Manager</a>. This tool allows you to connect desktop Firefox to a compatible device via USB (or a Firefox OS simulator), push apps straight to the device, validate apps, and debug them as they run on the device.</p> - -<h3 id="Unit_Testing">Unit Testing</h3> - -<p>Unit tests are extremely valuable when testing on different devices and builds. jQuery's <a href="http://qunitjs.com">QUnit</a> is a popular client-side testing utility, but you can use any set of testing tools you'd like.</p> - -<h3 id="Installing_Firefox_OS_on_a_Device">Installing Firefox OS on a Device</h3> - -<p>Since Firefox OS is an open source platform, code and tools are available to build and install Firefox OS on your own device. Build and installation instructions, as well as notes on what devices it can be installed on, can be found on <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Platform">MDN</a>.</p> - -<p>Dedicated Firefox OS developer preview devices are also available: read our <a href="https://marketplace.firefox.com/developers/dev_phone">Developer preview phone page</a> for more information.</p> - -<h2 id="App_Submission_and_Distribution">App Submission and Distribution</h2> - -<p>Once your app is complete, you can host it yourself like a standard web site or app (read <a href="/en-US/docs/Web/Apps/Publishing/Self-publishing_Apps">Self-publishing apps</a> for more information), or it can be <a href="https://marketplace.firefox.com/developers/submit/app/manifest">submitted</a> to the <a href="https://marketplace.firefox.com">Firefox Marketplace</a>. Your app's manifest will be validated and you may choose which devices your app will support (e.g. Firefox OS, Desktop Firefox, Firefox Mobile, Firefox Tablet). Once validated, you can add additional details about your app (screenshots, descriptions, price, etc.) and officially submit the app for listing within the Marketplace. Once approved, your app is available to the world for purchase and installation.</p> - -<h3 id="More_Marketplace_Listing_Information">More Marketplace & Listing Information</h3> - -<ol> - <li><a href="/en-US/docs/Web/Apps/Publishing/Submitting_an_app">Submitting an App to the Firefox OS Marketplace </a></li> - <li><a href="/en-US/docs/Web/Apps/Publishing/Marketplace_review_criteria">Marketplace Review Criteria </a></li> - <li><a href="http://s.vid.ly/embeded.html?link=8k2n4w&autoplay=false">App Submission Video Walkthrough </a></li> -</ol> -</article> diff --git a/files/fr/archive/b2g_os/releases/1.0.1/index.html b/files/fr/archive/b2g_os/releases/1.0.1/index.html deleted file mode 100644 index 2ed41f7a99..0000000000 --- a/files/fr/archive/b2g_os/releases/1.0.1/index.html +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Firefox OS 1.0.1 pour les développeurs -slug: Archive/B2G_OS/Releases/1.0.1 -tags: - - Firefox OS - - Notes de version -translation_of: Archive/B2G_OS/Releases/1.0.1 ---- -<div class="summary"> -<p><span class="seoSummary">Firefox OS 1.0.1 a tout d'abord été proposé aux partenaires pour une distribution le 2 juillet 2013 ; ce fut la première version officielle de Firefox OS. Son composant Gecko est basé sur Firefox 18 (voir <a href="/fr/Firefox/Versions/18" title="/en-US/docs/Mozilla/Firefox/Releases/18">Firefox 18 pour les développeurs</a>), publié le 18 janvier 2013. Pour les versions plus anciennes, consultez les notes de version des anciens Firefox pour ordinateur de bureau, en commençant par <a href="/fr/Firefox/Versions/17">Firefox 17 pour les développeurs</a>. Cette page détaille les fonctionnalités développeur nouvellement implémentées dans Firefox OS 1.0.1.</span></p> -</div> - -<h2 id="HTML">HTML</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li><code><input type="file"></code> a été désactivé en raison de ses conséquences sur la consommation mémoire (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=832923" title="FIXED: Implement <input type='file'> on B2G">bug 832923</a>).</li> -</ul> - -<p>Commun à Gecko :</p> - -<ul> - <li>L'attribut <code><a href="/fr/docs/Web/HTML/Element/ol#attr-reversed">reversed</a></code> de l'élément <a href="/fr/docs/Web/HTML/Element/ol" title="L'élément HTML <ol> représente une liste ordonnée. Les éléments d'une telle liste sont généralement affichés avec un indicateur ordinal pouvant prendre la forme de nombres, de lettres, de chiffres romains ou de points. La mise en forme de la numérotation n'est pas utilisée dans la description HTML mais dans la feuille de style CSS associée grâce à la propriété list-style-type."><code><ol></code></a> est maintenant supporté (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=601912" title="FIXED: HTML 5's <ol> reversed attribute not supported">bug 601912</a>).</li> - <li>L'attribut <code><a href="/fr/docs/Web/HTML/Element/link#attr-crossorigin">crossorigin</a></code> de l'élément <a href="/fr/docs/Web/HTML/Element/link" title="L'élément HTML <link> définit la relation entre le document courant et une ressource externe. Cet élément peut être utilisé pour définir un lien vers une feuille de style ou un cadre de navigation (accéder à la même page dans une langue différente par exemple)."><code><link></code></a> est maintenant supporté (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=786564" title="FIXED: Need a crossOrigin idl attribute on <link>s too">bug 786564</a>).</li> - <li>L'attribut <code><a href="/fr/docs/Web/HTML/Element/iframe#attr-allowfullscreen">allowfullscreen</a></code> de l'élément <a href="/fr/docs/Web/HTML/Element/iframe" title="Cet élément prend en charge les attributs universels."><code><iframe></code></a> a été implementé et sa version précédente préfixée <code><a href="/fr/docs/Web/HTML/Element/iframe#attr-mozallowfullscreen">mozallowfullscreen</a></code> est désormais obsolète.</li> -</ul> - -<h2 id="CSS">CSS</h2> - -<p>Commun à Gecko :</p> - -<ul> - <li><a href="/fr/docs/Web/CSS/min-width" title="La propriété min-width est utilisée pour définir la largeur minimale d'un élément donné. Elle empêche la valeur de la propriété width de devenir inférieure à la valeur spécifiée par min-width (autrement dit, min-width est une borne inférieure pour width)."><code>min-width</code></a> et <a href="/fr/docs/Web/CSS/min-height" title="La propriété min-height est utilisée afin de définir la hauteur minimale d'un élément. Elle empêche ainsi que la valeur de la propriété height devienne inférieure à min-height."><code>min-height</code></a> utilisent maintenant le mot-clé <code>auto</code> comme <em>valeur initiale </em>(cela n'a d'effet que sur les éléments flexibles car ils sont transformés en <code>0</code>, ce qui est l'ancienne valeur initiale des autres éléments). (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=763689" title='FIXED: New initial value for "min-width" &amp;amp;amp;amp; "min-height": auto'>bug 763689</a>)</li> - <li>La cascade a été mise à jour : à présent, les règles <code>!important</code> de la feuille de style auteur ont la priorité sur les <a href="/fr/docs/Web/CSS/CSS_Animations/Utiliser_les_animations_CSS" title="CSS/Using_CSS_animations">animations CSS</a>. (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=783714" title="FIXED: author !important rules should override CSS animations">bug 783714</a>)</li> - <li>La propriété raccourcie <a href="/fr/docs/Web/CSS/background" title="La propriété background est une propriété raccourcie qui permet de définir les différentes valeurs des propriétés liées à la gestion des arrière-plans d'un élément. Elle permet de définir une ou plusieurs valeurs pour : background-clip, background-color, background-image, background-origin, background-position, background-repeat, background-size, et background-attachment."><code>background</code></a> reconnait maintenant la propriété CSS3 <a href="/fr/docs/Web/CSS/background-size" title="La propriété CSS background-size définit la taille des images d'arrière-plan pour l'élément. La taille de l'image peut être contrainte, complètement ou partiellement afin de conserver ses proportions."><code>background-size</code></a> quand elle est spécifiée à l'intérieur. (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=570326" title="FIXED: add support for background-size in background shorthand property (css3-background)">bug 570326</a>)</li> - <li>Le support initial du Module CSS Flexbox est arrivé. Il est désactivé par défaut mais son activation est possible en définissant <code>layout.css.flexbox.enabled</code> à true. (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=666041" title="FIXED: CSS Flexbox Layout Level 3 (disabled at build-time, enabled in a subsequent bug)">bug 666041</a>)</li> -</ul> - -<h2 id="JavaScript">JavaScript</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li>Lors de la détection du support des différents formats de <code><video></code>, <code>HTMLMediaElement.prototype.canPlayType</code> retourne par erreur <code>true</code> pour les vidéos h.264, alors qu'en réalité le h.264 n'est pas pris en charge.</li> -</ul> - -<p>Commun à Gecko :</p> - -<ul> - <li>Les <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Proxy">proxys directs</a> (ECMAScript 6) d'Harmony sont arrivés (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=703537" title="FIXED: Implement Harmony direct proxies">bug 703537</a>). Avertissement : l'implémentation comporte deux ou trois bogues connus, des fonctionnalités manquantes et des écarts par rapport à l'état actuel de la spécification. Ne vous basez pas dessus pour faire du code à mettre en production.</li> - <li>L'implémentation de la méthode ECMAScript 6 <code>contains()</code> fonctionne maintenant avec les chaînes de caractères. Malheureusement, elle n'est pas compatible avec Mootools 1.2 qui s'attend à un comportement différent de <code>contains()</code> avec les chaînes sans que cela ne soit garantit. Les nouvelles versions de Mootools corrigent ce problème ; les sites devraient effectuer une mise à jour de Mootools vers une version supérieure à la 1.2.</li> -</ul> - -<h2 id="DOMAPI">DOM/API</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li><span id="summary_alias_container"><span id="short_desc_nonedit_display">API Device Storage : Lors de l'obtention d'un curseur à partir de <code>navigator.getDeviceStorage("sdcard").enumerate</code>, <code><span id="summary_alias_container"><span id="short_desc_nonedit_display">this.done</span></span></code> est indéfini (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=902565" title='this.done in cursor callback of naviagtor.getDeviceStorage("sdcard").enumerate is undefined'>bug 902565</a>). Cela est corrigé dans Firefox 1.2. Le bogue référencé aborde de possibles vérifications de compatibilité/contournements pour ce problème. </span></span></li> - <li><a href="/fr/docs/Web/Guide/Telephony" rel="external">Arrivée de l'API Telephony</a></li> - <li><a href="/fr/docs/WebAPI/Contacts" rel="external">Arrivée de l'API Contacts</a></li> - <li><a href="/fr/docs/WebAPI/Settings" rel="external">Arrivée de l'API Settings</a></li> - <li><a href="/fr/docs/Using_geolocation" rel="external">Arrivée de l'API Geolocation</a></li> - <li><a href="/fr/docs/WebAPI/Web_Activities" rel="external">Arrivée des Web Activities</a></li> - <li><a href="/fr/docs/Web/API/TCP_Socket_API" rel="external">Arrivée de TCP Socket</a></li> - <li><a href="/fr/docs/WebAPI/Utiliser_les_événéments_de_luminosité" rel="external">Arrivée de l'API Sensor</a></li> - <li><a href="/fr/docs/WebAPI/Permissions" rel="external">Arrivée de Permissions et Security Model</a></li> -</ul> - -<p>Commun à Gecko :</p> - -<ul> - <li><code>navigator.mozPay</code> est arrivé (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=767818" title="FIXED: Implement navigator.mozPay">bug 767818</a>).</li> - <li><code>window.devicePixelRatio</code> est arrivé (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=564815" title="FIXED: implement window.devicePixelRatio">bug 564815</a>).</li> - <li>Le backend MacOS X de <code>window.navigator.battery</code> a été implémenté (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=696045" title="FIXED: Battery API: MacOS X backend">bug 696045</a>).</li> - <li><a href="/fr/docs/Web/API/BlobBuilder" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozBlobBuilder</code></a> a été supprimé. Les développeurs doivent utiliser le constructeur <a href="/fr/docs/Web/API/Blob" title="Un objet Blob représente un objet, semblable à un fichier, qui est immuable et qui contient des données brutes. Les blobs (pour Binary Large Objects) représentent des données qui ne sont pas dans un format JavaScript natif. L'interface File est basée sur l'interface Blob et hérite des fonctionnalités de cette dernière tout en ajoutant des fonctionnalités pour gérer les fichiers sur le système de l'utilisateur."><code>Blob</code></a> pour créer un objet <code>Blob</code> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=744907" title="FIXED: Remove BlobBuilder">bug 744907</a>).</li> - <li>Les préfixes de l'événement <code><a href="/fr/docs/Web/Reference/Events/visibilitychange" title="/fr/docs/Web/Reference/Events/visibilitychange">visibilitychange</a></code> et de l'<a href="/fr/docs/DOM/Using_the_Page_Visibility_API" title="DOM/Using_the_Page_Visibility_API">API Page Visibility</a> ont été supprimés (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=812086" title="FIXED: Unprefix Page Visibility API">bug 812086</a>).</li> - <li><a href="/fr/docs/Web/API/TextDecoder" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>TextDecoder</code></a> et <a href="/fr/docs/Web/API/TextEncoder" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>TextEncoder</code></a> ont été ajoutés. Notez que leur implémentation et les spécifications correspondantes ont évolué et ont été modifiées dans Firefox 19 (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=764234" title="FIXED: String Encoding Decoding API">bug 764234</a>).</li> - <li><code>HTMLMediaElement</code><code>.src</code> a été scindé en deux propriétés : la propriété <code>src</code> standard, qui traite des <a href="/fr/docs/Web/API/DOMString" title="Une chaîne de caractères UTF-16. Comme JavaScript utilise déjà ce type de chaîne de caractères, DOMString est directement associé à String."><code>DOMString</code></a>, et la propriété préfixée <code>mozSrcObject</code>, qui traite des <a href="/fr/docs/WebRTC/MediaStream_API" title="WebRTC/MediaStream_API">flux médias</a> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=792665" title="FIXED: Separate HTMLMediaElement.src from HTMLMediaElement.srcObject">bug 792665</a>).</li> - <li>Support des <a href="/en-US/docs/DOM/Using_web_workers#Passing_data_by_transferring_.C2.A0ownership_%28transferable_objects%29" title="DOM/Using_web_workers#Passing_data_by_transferring_.C2.A0ownership_%28transferable_objects%29">objets transférables.</a></li> - <li>La méthode <a href="/fr/docs/Web/API/Screen/lockOrientation" title="La méthode lockOrientation vérouille l'affichage dans une orientation définie."><code>Screen.lockOrientation()</code></a> supporte maintenant un tableau de <a href="/fr/docs/Web/API/DOMString" title="Une chaîne de caractères UTF-16. Comme JavaScript utilise déjà ce type de chaîne de caractères, DOMString est directement associé à String."><code>DOMString</code></a> comme argument (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=784549" title="FIXED: Screen Orientation API: lockOrientation() should accept an Array in addition of a DOMString">bug 784549</a>).</li> -</ul> - -<h2 id="Réseau">Réseau</h2> - -<p>Commun à Gecko :</p> - -<ul> - <li>Les facteurs de qualité ("valeurs q") sont maintenant restreints à 2 chiffres dans l'en-tête HTTP <code>Accept-Language</code> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=672448" title="FIXED: Clamp quality factor ('q') values to 2 decimal places">bug 672448</a>).</li> - <li>La syntaxe <code>ALLOW-FROM</code> de l'en-tête de réponse HTTP <a href="/fr/docs/The_X-FRAME-OPTIONS_response_header" title="The_X-FRAME-OPTIONS_response_header"><code>X-FRAME-OPTIONS</code></a> est maintenant supportée (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=690168" title="FIXED: Implement Allow-From syntax for X-Frame-Options">bug 690168</a>).</li> -</ul> - -<h2 id="Fonctionnalités_notables_de_la_version_1.0.1">Fonctionnalités notables de la version 1.0.1</h2> - -<ul> - <li><a href="/fr/docs/WebAPI/WebSMS" rel="external">SMS</a></li> - <li>3G/Data</li> - <li>WiFi</li> - <li><a href="/fr/Apps" rel="external">Applications Web Ouvertes</a></li> - <li>Messagerie vocale</li> - <li>Support MozApp</li> - <li><a href="/fr/Persona" rel="external">Persona / ID</a></li> - <li>Paiement via l'opérateur</li> - <li>Bluetooth</li> - <li>Gestionnaire de réseau</li> - <li><a href="/fr/docs/WebAPI/Device_Storage_API" rel="external">Stockage USB</a></li> - <li>Support multi-processus</li> - <li>Défilement/agrandissement asynchrone (APZ)</li> - <li>SIM Toolkit</li> - <li>Support de plusieurs appareils photo</li> - <li>Plein écran</li> - <li>Hotspot WiFi</li> - <li>Mises à jour logicielles</li> - <li>Diffusion cellulaire</li> - <li>Réglages des notifications</li> - <li>Animations/transitions graphiques</li> - <li>Support de la localisation</li> - <li>First Run Experience</li> - <li>Mise en attente des appels</li> - <li>Transfert d'appels</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.mozilla.org/fr/firefox/os/notes/1.0.1//fr/Firefox_OS/Releases/1.0.1" title="http://www.mozilla.org/en-US/firefox/os/notes/1.0.1/">Notes sur Firefox OS 1.0.1</a></li> -</ul> diff --git a/files/fr/archive/b2g_os/releases/1.1/index.html b/files/fr/archive/b2g_os/releases/1.1/index.html deleted file mode 100644 index 14de4a6b76..0000000000 --- a/files/fr/archive/b2g_os/releases/1.1/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: Firefox OS 1.1 pour les développeurs -slug: Archive/B2G_OS/Releases/1.1 -tags: - - Firefox OS - - Notes de version -translation_of: Archive/B2G_OS/Releases/1.1 ---- -<div class="summary"> -<p><span class="seoSummary">Firefox OS 1.1 est une pré-version de Firefox OS, initialement distribuée auprès des partenaires pour être publiée le 21 octobre 2013. Son composant Gecko est basé sur Firefox 18 (voir <a href="/fr/docs/Mozilla/Firefox/Versions/18" title="/en-US/docs/Mozilla/Firefox/Releases/24">Firefox 18 pour les développeurs</a>) tout comme pour <a href="/en-US/Firefox_OS/Releases/1.0.1">Firefox OS 1.0.1</a>, mais avec certaines corrections de bogues supplémentaires et l'ajout d'APIs. Cette page détaille les fonctionnalités pour développeur nouvellement implémentées dans Firefox OS 1.1.</span></p> -</div> - -<h2 id="HTML">HTML</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li><code><input type="file"></code> activé (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=832923" title="FIXED: Implement <input type='file'> on B2G">bug 832923</a> pour les détails).</li> -</ul> - -<h2 id="JavaScript">JavaScript</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li>Lors de la détection du support <code><video></code> pour différents formats, <code>HTMLMediaElement.prototype.canPlayType</code> retourne à présent de manière correcte <code>false</code> pour les vidéos h.264.</li> -</ul> - -<h2 id="DOMAPI">DOM/API</h2> - -<p>Spécifique à Firefox OS :</p> - -<ul> - <li><span id="summary_alias_container"><span id="short_desc_nonedit_display">API Device Storage : Lors de l'obtention d'un curseur à partir de <code>navigator.getDeviceStorage("sdcard").enumerate</code>, <code><span id="summary_alias_container"><span id="short_desc_nonedit_display">this.done</span></span></code> est indéfini (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=902565" title='this.done in cursor callback of naviagtor.getDeviceStorage("sdcard").enumerate is undefined'>bug 902565</a>). Cela est corrigé dans Firefox 1.2. Le bogue référencé aborde de possibles vérifications de compatibilité/contournements pour ce problème. </span></span></li> - <li>Les APIs relatives aux SMS, MMS et MobileMessage sont arrivées - <ul> - <li><a href="/fr/docs/Web/API/Window/navigator/mozMobileMessage" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.navigator.mozMobileMessage</code></a></li> - <li><a href="/fr/docs/Web/API/Window/navigator/mozSms" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.navigator.mozSms</code></a></li> - <li><a href="/fr/docs/Web/API/MozMmsEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMmsEvent</code></a></li> - <li><a href="/fr/docs/Web/API/MozMmsMessage" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMmsMessage</code></a></li> - <li><a href="/fr/docs/Web/API/MozMobileMessageManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileMessageManager</code></a></li> - <li><a href="/fr/docs/Web/API/MozMobileMessageThread" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileMessageThread</code></a></li> - <li><a href="/fr/docs/Web/API/MozSmsEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozSmsEvent</code></a></li> - <li><a href="/fr/docs/Web/API/MozSmsFilter" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozSmsFilter</code></a></li> - <li><a href="/fr/docs/Web/API/MozSmsManager" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozSmsManager</code></a></li> - <li><a href="/fr/docs/Web/API/MozSmsMessage" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozSmsMessage</code></a></li> - <li><a href="/fr/docs/Web/API/MozSmsSegmentInfo" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozSmsSegmentInfo</code></a></li> - <li>nsIMobileMessageCallback (API interne à Gecko)</li> - <li>nsIMobileMessageCursorCallback (API interne à Gecko)</li> - <li>nsIMobileMessageService (API interne à Gecko)</li> - <li>nsIMobileMessageDatabaseService (API interne à Gecko)</li> - <li>nsIMmsService (API interne à Gecko)</li> - <li> - <div>nsISmsService (API interne à Gecko)</div> - </li> - </ul> - </li> - <li><a href="/en-US/docs/WebAPI/Simple_Push">Simple Push</a> (API de notifications Push) est arrivé</li> - <li><a href="http://help.vodafone.co.nz/app/answers/detail/a_id/3230">WAP Push</a> est arrivé</li> -</ul> - -<h2 id="Support_HD_dans_Firefox_OS">Support HD dans Firefox OS</h2> - -<p>Depuis Firefox OS 1.1, il existe des versions HD disponibles pour apporter ce support à des appareils avec écrans à haute densité. Il s'agit principalement d'un changement visuel uniquement, traité de la même façon que s'il s'agissait d'autres appareils de résolutions différentes, et rien de plus ne sera visible comme différence au niveau de la plate-forme sous-jacente.</p> - -<h2 id="Problèmes_corrigés_dans_Firefox_OS">Problèmes corrigés dans Firefox OS</h2> - -<ul> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=817972">817972</a> : [Bluetooth][File-Transfer] Support du transfert de plusieurs fichiers.</li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=834672">834672</a>: AppProtocolHandler.js ne devrait pas lever d'exception.</li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=839500">839500</a> : identity.js, dans Gaia, ouvre un processus navigateur qui reste bloqué en avant-plan. Par conséquent, si vous ouvrez l'application marketplace, vous perdez ~10% de mémoire disponible jusqu'au redémarrage du téléphone.</li> - <li>Correction mémoire pour les connexions Persona.</li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=834773">834773</a>: Utiliser l'activité Choisir et valider une image pour la galerie — l'application se bloque sans percevoir de résutat pendant 5–10 secondes</li> -</ul> - -<p><a href="http://mzl.la/1bqXGXS">Plantages résolus</a></p> - -<h2 id="Fonctionnalités_notables_de_Firefox_OS_1.1">Fonctionnalités notables de Firefox OS 1.1</h2> - -<ul> - <li>Le support des Messages Multimédia (MMS) a été ajouté à l'application des messages ce qui permet d'envoyer des images, vidéos et sons aux contacts, ou un message textuel à plusieurs personnes en même temps.</li> - <li>L'enregistrement des images, vidéo et sons depuis le navigateur est maintenant géré.</li> - <li>Les contacts des comptes de messagerie peuvent à présent être importés depuis Gmail et Windows Live Mail (Outlook).</li> - <li>Le téléchargement des pièces-jointes graphiques, audio et vidéo a été implémenté.</li> - <li>Les images de la Galerie peuvent maintenant être mises en pièce-jointe et envoyées.</li> - <li>Le mode brouillon pour les courriels a été implémenté.</li> - <li>Améliorations du téléphone et des contacts, comme la possibilité d'ajouter facilement un numéro composé à un contact existant ou l'affichage de suggestions pour trouver facilement des contacts.</li> - <li>Implémentation de diffusion cellulaire pour la distribution simultanée de messages d'urgence aux utilisateurs abonnés.</li> - <li>Améliorations significatives des performances concernant la vitesse du défilement et du lancement des applications.</li> - <li>Recherche dans <strong>Musique</strong> pour trouver de la musique par artiste, album ou titre de chanson.</li> - <li>Firefox OS offre des fonctionnalités dans l'<strong>Agenda</strong> telles que : - <ul> - <li>Vues séparées pour les détails et l'édition.</li> - <li>Sélection d'une notification sonore d'alarme.</li> - <li>Création d'un événement directement à une date et une heure spécifiques.</li> - </ul> - </li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="http://www.mozilla.org/en-US/firefox/os/notes/1.1/" title="http://www.mozilla.org/en-US/firefox/os/notes/1.1/">Notes de Firefox OS 1.1</a></li> -</ul> - -<h2 id="Anciennes_versions">Anciennes versions</h2> - -<p></p><div class="multiColumnList"> -<ul> -<li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li></ul> -</div><p></p> diff --git a/files/fr/archive/b2g_os/releases/2.0/index.html b/files/fr/archive/b2g_os/releases/2.0/index.html deleted file mode 100644 index 8fd2a38ab8..0000000000 --- a/files/fr/archive/b2g_os/releases/2.0/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: Firefox OS 2.0 for developers -slug: Archive/B2G_OS/Releases/2.0 -translation_of: Archive/B2G_OS/Releases/2.0 ---- -<div class="summary"> - <p>This page details the developer features newly implemented in Gecko that are specific to Firefox OS 2.0.</p> -</div> -<div class="note"> - <p>Firefox OS 2.0's Gecko component is based on Firefox 31/32.</p> -</div> -<h2 id="New_product_features">New product features</h2> -<p>This section provides a summary of the new features available in Firefox OS 2.0. For more details on specific platform changes (API additions, etc.), see the <a href="#Platform_additions_in_detail">Platform additions in detail</a> section.</p> -<dl> - <dt> - NFC</dt> - <dd> - <span class="author-g-x59co88jbi1y2uah b i">This release includes support for device-to-device content sharing support with NFC <span class="author-g-x59co88jbi1y2uah b i">(Near Field Communication)</span>. You can pair your device with another, then <a href="/en-US/docs/Web/API/NFC_API/Using_the_NFC_API#The_P2P_Sharing_UI">swipe to share</a> your contacts, media, or favorite URLs with others.</span></dd> - <dt> - Telephony</dt> - <dd> - <span class="author-g-x59co88jbi1y2uah b i">Firefox OS now supports both IPv4 and IPv6 addresses</span> in the network manager.</dd> - <dt> - Find My Device</dt> - <dd> - <span class="author-g-9k649z122zgh819oqmty">If you’ve lost your Firefox OS smartphone, Find My Device can help you find it (see the <span class="author-g-9k649z122zgh819oqmty url"><a href="http://find.firefox.com">http://find.firefox.com</a> website</span>). You can see it on a map, make it play a sound and have it display a message. You can also remotely lock it or delete your personal info.</span><span class="author-g-9k649z122zgh819oqmty"> To get started, create a Firefox Account (<em>Settings > Firefox Accounts</em> on your device) and enable Find My Device (<span class="author-g-9k649z122zgh819oqmty"><em>Settings > Find My Device</em></span>).</span></dd> - <dt> - Media</dt> - <dd> - <span class="author-g-4iwx7wjdkbf2wjjv b">You can now create your own ringtones using your own music collection, or songs you download from the Web.</span></dd> - <dt> - Camera</dt> - <dd> - <span class="author-g-4iwx7wjdkbf2wjjv b">The Camera app now supports various focus modes: Touch, Continuous Auto and Face tracking</span>.</dd> - <dt> - Productivity</dt> - <dd> - We've done a visual refresh of the Email, Calender, and Clock apps.</dd> - <dt> - Homescreen</dt> - <dd> - <span class="author-g-4f4wmtjtu8s4fjq7 b i">Firefox OS 2.0 introduces a simpler vertical-scrolling homescreen with larger icons.</span></dd> - <dt> - Edge-gesture app switching</dt> - <dd> - <span class="author-g-4f4wmtjtu8s4fjq7 b i">Edge gestures are now available for switching between apps (swipe your thumb from the left edge of the screen to the right and vice versa, to switch between multiple open apps.)</span></dd> -</dl> -<h2 id="New_partner_features">New partner features</h2> -<dl> - <dt> - E.ME integration</dt> - <dd> - E.ME integration provides direct access to web apps while configurable search providers can search the web at the same time.</dd> -</dl> -<h2 id="New_DevTools_features">New DevTools features</h2> -<p>The Firefox <a href="/en-US/docs/Tools">Developer Tools</a> have had a large number of features added in Firefox versions 31 and 32; these aren't Firefox OS-specific, but you can take advantage of them when debugging your Firefox OS apps through <a href="/en-US/docs/Tools/WebIDE">WebIDE</a>. To find out more, read:</p> -<ul> - <li><a href="https://hacks.mozilla.org/2014/05/editable-box-model-multiple-selection-sublime-text-keys-much-more-firefox-developer-tools-episode-31/">Firefox Developer Tools Episode 31</a></li> - <li><a href="https://hacks.mozilla.org/2014/06/toolbox-inspector-scratchpad-improvements-firefox-developer-tools-episode-32/">Firefox Developer Tools Episode 32</a></li> -</ul> -<h2 id="Platform_additions_in_detail">Platform additions in detail</h2> -<div class="note"> - <p><strong>Note</strong>: Our list here includes features most important to Firefox OS. For an expanded list of general Gecko feature additions (which are generally also present in Firefox OS 2.0), consult the <a href="/en-US/docs/Mozilla/Firefox/Releases/31" title="/en-US/docs/Mozilla/Firefox/Releases/31">Firefox 31 release notes for developers</a> and <a href="/en-US/docs/Mozilla/Firefox/Releases/32" title="/en-US/docs/Mozilla/Firefox/Releases/32">Firefox 32 release notes for developers</a>.</p> -</div> -<h3 id="Web_API">Web API</h3> -<ul> - <li>The parameters of the <a href="/fr/docs/Web/API/MozMobileNetworkInfo" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileNetworkInfo</code></a> constructor have been made nullable (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1026727" title="FIXED: Unknown state is displayed instead of Connected during manual network selection">bug 1026727</a>).</li> - <li>WebRTC: <span class="author-g-41mtsa1hor7b107c i"><a href="/fr/docs/Web/API/MozGetUserMedia" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozGetUserMedia</code></a>, <a href="/fr/docs/Web/API/MozRTCPeerConnection" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozRTCPeerConnection</code></a>, and <a href="/fr/docs/Web/API/DataChannels" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>DataChannels</code></a> are supported by default</span>.</li> - <li>New constraints for <a href="https://developer.mozilla.org/en-US/docs/Glossary/WebRTC">WebRTC</a>'s <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUserMedia.getUserMedia" title="The documentation about this has not yet been written; please consider contributing!"><code>getUserMedia()</code></a>, <code>width</code>, <code>height</code>, and <code>framerate</code>, have been added, to limit stream dimensions and frame rate (<a class="external external-icon" href="https://bugzilla.mozilla.org/show_bug.cgi?id=907352" title="FIXED: Implement width/height/framerate gUM constraints">bug 907352</a>): - <pre class="brush: json language-json"><code class="language-json"><span class="token punctuation">{</span> - mandatory<span class="token punctuation">:</span> <span class="token punctuation">{</span> - width<span class="token punctuation">:</span> <span class="token punctuation">{</span> min<span class="token punctuation">:</span> <span class="token number">640</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> - height<span class="token punctuation">:</span> <span class="token punctuation">{</span> min<span class="token punctuation">:</span> <span class="token number">480</span> <span class="token punctuation">}</span> - <span class="token punctuation">}</span><span class="token punctuation">,</span> - optional<span class="token punctuation">:</span> <span class="token punctuation">[</span> - <span class="token punctuation">{</span> width<span class="token punctuation">:</span> <span class="token number">650</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> - <span class="token punctuation">{</span> width<span class="token punctuation">:</span> <span class="token punctuation">{</span> min<span class="token punctuation">:</span> <span class="token number">650</span> <span class="token punctuation">}</span><span class="token punctuation">}</span><span class="token punctuation">,</span> - <span class="token punctuation">{</span> frameRate<span class="token punctuation">:</span> <span class="token number">60</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> - <span class="token punctuation">{</span> width<span class="token punctuation">:</span> <span class="token punctuation">{</span> max<span class="token punctuation">:</span> <span class="token number">800</span> <span class="token punctuation">}</span><span class="token punctuation">}</span><span class="token punctuation">,</span> - <span class="token punctuation">]</span> -<span class="token punctuation">}</span></code></pre> - </li> - <li>RTSP streaming support is now available (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=929372" title="FIXED: [RTSP][User Story]Support basic RTSP streaming function.">bug 929372</a>).</li> - <li>The Resource Statistics API is implemented (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=951976" title="FIXED: API for Resource Statistics">bug 951976</a>).</li> - <li>The Resource Timing API is implemented (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=822480" title="FIXED: Add in the Resource Timing API">bug 822480</a>).</li> - <li>fastSeek API is now available for media elements (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=778077" title="FIXED: Implement fastSeek API on media elements (and switch the built-in controls over to it)">bug 778077</a>).</li> - <li><span class="author-g-41mtsa1hor7b107c i">The <a href="/en-US/docs/Web/API/Network_Information_API">Network Information API</a> is now exposed to Firefox OS (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=960426" title="FIXED: Support Network Information API in Firefox OS">bug 960426</a>).</span></li> - <li><span class="author-g-41mtsa1hor7b107c i"><span class="author-g-41mtsa1hor7b107c i">The Wifi capabilities of the device can now be returned using <code>WifiManager.getCapabilities()</code> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1002314" title="FIXED: [B2G]To have a webapi providing WIFI capabilities of device">bug 1002314</a>).</span></span></li> - <li>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/Navigator.vibrate" title="The Navigator.vibrate() method pulses the vibration hardware on the device, if such hardware exists. If the device doesn't support vibration, this method has no effect. If a vibration pattern is already in progress when this method is called, the previous pattern is halted and the new one begins instead."><code>Navigator.vibrate()</code></a> method behavior has been adapted to the latest specification: too long vibrations are now truncated (<a class="external external-icon" href="https://bugzilla.mozilla.org/show_bug.cgi?id=1014581" title="FIXED: Update Vibration API to conform to latest W3C spec">bug 1014581</a>).</li> - <li><span class="author-g-41mtsa1hor7b107c i">The <a href="/en-US/docs/Web/API/Device_Storage_API">Device Storage API</a> now has mount and unmount capabilities (privileged) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=971612" title='FIXED: Implement "mount", "unmount" API for device storage'>bug 971612</a>).</span></li> - <li><span class="author-g-41mtsa1hor7b107c i"><span class="author-g-41mtsa1hor7b107c i">The Feature Detection API is now available (privileged) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=983502" title="FIXED: Implement and expose the feature detection API to privileged apps">bug 983502</a>).</span></span></li> - <li> The <a class="new" href="https://developer.mozilla.org/en-US/docs/Web/API/MSISDN_Verification_API">MSISDN Verification API</a> has been added (privileged) (<a class="external external-icon" href="https://bugzilla.mozilla.org/show_bug.cgi?id=988469" title="FIXED: MSISDN verification API for privileged apps">bug 988469</a>).</li> - <li>A new CameraControl API is now available (privileged) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=909542" title="FIXED: Camera Control API clean-up/streamline">bug 909542</a>).</li> - <li>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/Data_Store_API">Data Store API</a> has been made available to <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Performance/Using_web_workers">Web Workers</a> (certified) (<a class="external external-icon" href="https://bugzilla.mozilla.org/show_bug.cgi?id=949325" title="FIXED: C++ wrapper to support DataStore API on the worker">bug 949325</a>).</li> - <li>The <a href="/en-US/docs/Web/API/Device_Storage_API">Device Storage API</a> now uses the File System API spec (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=910412" title="FIXED: Change DeviceStorage API to use FileSystem API spec">bug 910412</a>).</li> - <li><span class="author-g-41mtsa1hor7b107c i">The deprecated Audio Data API has been removed</span> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=927245" title="FIXED: Remove deprecated Audio Data API implementation">bug 927245</a>).</li> -</ul> -<h3 id="CSS">CSS</h3> -<ul> - <li><code>position:sticky</code> is now supported, and used in Gaia app layout (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=886646" title="FIXED: implement position:sticky">bug 886646</a>).</li> - <li><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/flex-grow" title="The CSS flex-grow property specifies the flex grow factor of a flex item."><code>flex-grow</code></a> and <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/flex-shrink" title="The CSS flex-shrink property specifies the flex shrink factor of a flex item."><code>flex-shrink</code></a> can now to transition between zero and non-zero values (<a class="external external-icon" href="https://bugzilla.mozilla.org/show_bug.cgi?id=996945" title="FIXED: Allow flex-grow / flex-shrink to transition between zero and nonzero values">bug 996945</a>).</li> -</ul> -<h3 id="Technology_support_improvements">Technology support improvements</h3> -<ul> - <li>Firefox OS 2.0 now supports H.264 video hardware, allowing you to create and playback video encoded using this codec much more efficiently. See <a href="https://developer.mozilla.org/en-US/Firefox_OS/Media_support">Media support on Firefox OS</a> for details.</li> -</ul> -<h2 id="Older_versions">Older versions</h2> -<p></p><div class="multiColumnList"> -<ul> -<li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.4">Firefox OS 1.4 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.3">Firefox OS 1.3 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.2">Firefox OS 1.2 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.1">Firefox OS 1.1 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li></ul> -</div><p></p> diff --git a/files/fr/archive/b2g_os/releases/2.1/index.html b/files/fr/archive/b2g_os/releases/2.1/index.html deleted file mode 100644 index 694ebf60df..0000000000 --- a/files/fr/archive/b2g_os/releases/2.1/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Firefox OS 2.1 for developers -slug: Archive/B2G_OS/Releases/2.1 -translation_of: Archive/B2G_OS/Releases/2.1 ---- -<div class="summary"> -<p>Le composant Gecko de Firefox OS 2.1 est basé sur <strong>Firefox 33/34</strong>. <span class="seoSummary">Cette page détaille les fonctionnalités pour développeurs nouvellement implémentées dans Gecko et spécifiques à Firefox OS 2.1.</span></p> -</div> - -<div class="note"> -<p><strong>Note</strong>: Pour les fonctionnalités générales de Gecko, qui sont généralement aussi présentes dans Firefox OS Gecko, consulter <a href="/en-US/docs/Mozilla/Firefox/Releases/33" title="/en-US/docs/Mozilla/Firefox/Releases/28">Firefox 33 release notes for developers</a> et <a href="/en-US/docs/Mozilla/Firefox/Releases/34" title="/en-US/docs/Mozilla/Firefox/Releases/28">Firefox 34 release notes for developers</a>.</p> -</div> - -<h2 id="Changement_de_plateforme">Changement de plateforme</h2> - -<p>Firefox OS est habitué à avoir une politique de sécurité "application unique par origine", mais ceci a été levé à partir de Firefox 34/Firefox OS 2.1 (lire <a href="https://developer.mozilla.org/fr/Apps/FAQs/About_app_manifests">cette FAQ</a> pour plus d'informations). Si vous avez quand même besoin de supporter les anciennes versions, hébergez vos applis sur des origines différentes; une stratégie consiste à <a href="/en-US/Marketplace/Publishing/Adding_a_subdomain">créer différents sous domaines </a>pour vos applis.</p> - -<h2 id="Changement_d'API_web">Changement d'API web</h2> - -<ul> - <li>Les gestionnaire d'évènement d'appariement de l' <a href="/en-US/docs/WebAPI/WebBluetooth">API Web Bluetooth </a> — <a href="/fr/docs/Web/API/BluetoothAdapter/ondevicepaired" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter.ondevicepaired</code></a> et <a href="/fr/docs/Web/API/BluetoothAdapter/ondeviceunpaired" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter.ondeviceunpaired</code></a> — ont été ajouté (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1036234" title="FIXED: Implement pairing in BluetoothAdapter (event handlers)">bug 1036234</a>).</li> - <li>Des mise à jour des méthodes d'appariement de l' <a href="/en-US/docs/WebAPI/WebBluetooth">API Web Bluetooth</a> ont été ajouté (voir<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1036233" title="FIXED: Implement pairing in BluetoothAdapter (methods)">bug 1036233</a>): - <ul> - <li>Promise<void> <a href="/fr/docs/Web/API/BluetoothAdapter/pair" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter.pair</code></a>(DOMString aAddress)</li> - <li>Promise<void> <a href="/fr/docs/Web/API/BluetoothAdapter/unpair" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter.unpair</code></a>(DOMString aAddress)</li> - <li>sequence<BluetoothDevice> <a href="/fr/docs/Web/API/BluetoothAdapter/getPairedDevices" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>BluetoothAdapter.getPairedDevices</code></a></li> - </ul> - </li> - <li>Le support pour l' <a href="https://dvcs.w3.org/hg/speech-api/raw-file/tip/speechapi.html">API Web Speech</a> est en suspens : un patch a été soumis (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1032964" title="[B2G][SpeechRTC][User Story]: Enabling Voice input in Firefox OS">bug 1032964</a>).</li> - <li><span class="author-g-41mtsa1hor7b107c i">L'API FileHandle a été renommée en MutableFile, et LockedFile a été renommée en FileHandle (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1006485" title="FIXED: FileHandle: Rename FileHandle to MutableFile and LockedFile to FileHandle">bug 1006485</a>).</span></li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>Firefox OS 2.1 Notes (Le lien sera disponible une fois que l'article sera publié)</li> -</ul> - -<h2 id="Anciennes_Versions">Anciennes Versions</h2> - -<p></p><div class="multiColumnList"> -<ul> -<li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/2.0">Firefox OS 2.0 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.4">Firefox OS 1.4 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.3">Firefox OS 1.3 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.2">Firefox OS 1.2 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.1">Firefox OS 1.1 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li></ul> -</div><p></p> diff --git a/files/fr/archive/b2g_os/releases/2.2/index.html b/files/fr/archive/b2g_os/releases/2.2/index.html deleted file mode 100644 index 7b1699ab97..0000000000 --- a/files/fr/archive/b2g_os/releases/2.2/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: Firefox OS 2.2 pour les développeurs -slug: Archive/B2G_OS/Releases/2.2 -tags: - - '2.2' - - Firefox OS - - Notes de version -translation_of: Archive/B2G_OS/Releases/2.2 ---- -<div> -<p class="summary">Cette page détaille les fonctionnalités développeurs nouvellement implémentées dans Gecko et qui sont spécifiques à Firefox OS 2.2, ainsi que les fonctionnalités du produit et des outils de développement, et d'autres points notables de cette nouvelle version.</p> -</div> - -<div class="note"> -<p><strong>Note </strong>: Le composant Gecko de Firefox OS 2.2 est basé sur <strong>Firefox 35/36/37</strong>.</p> -</div> - -<h2 id="Fonctionnalités_du_produit">Fonctionnalités du produit</h2> - -<p>Cette section énumère différentes catégories de fonctionnalités nouvelles ou améliorées.</p> - -<h3 id="Fonctionnalités_systèmes">Fonctionnalités systèmes</h3> - -<dl> - <dt>Bluetooth</dt> - <dd>Bluedroid a été déplacé dans un processus distinct pour accroître la sécurité (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1005934" title="FIXED: Move bluedroid to a separate process">bug 1005934</a>.)</dd> - <dt>Sélection de texte</dt> - <dd>Pour prendre en charge le Copier/Coller, des possibilités de sélection de texte ont été ajoutées au système.</dd> - <dt>WebRTC</dt> - <dd>Le rendu matériel a été ajouté sur WebRTC pour améliorer la gestion de l'alimentation et économiser l'autonomie de la batterie (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1043558" title="FIXED: Use gralloc buffers for WebRTC local camera preview">bug 1043558</a>.)</dd> - <dt>SIM Tool Kit (STK)</dt> - <dd>Le support STK a été ajouté pour lire les numéros d'urgence (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1061130" title="FIXED: [STK] 3GPP TS 22.030 6.6.4 An abbreviated dialling code shall be able to be read using the following procedure: N(N)(N)#">bug 1061130</a>.)</dd> - <dd>Les icônes STK sont maintenant affichées sur les pages des services SIM (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1016807" title="FIXED: B2G STK: Support for STK icon display (GAIA work for Bug 824145)">bug 1016807</a>.)</dd> - <dt>Recherche</dt> - <dd>L'expérience utilisateur pour la recherche a été améliorée pour faciliter le choix du moteur de recherche par l'utilisateur (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1099157" title="FIXED: [Meta] Refactor search results layout">bug 1099157</a>.)</dd> - <dd>Les suggestions de recherche basées sur du texte sont à présent obtenues depuis le moteur de recherche par défaut, ce qui permet de trouver plus facilement ce que l'utilisateur recherche (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1098494" title="FIXED: [User Story] Support search suggestion based on provider">bug 1098494</a>.)</dd> - <dt>Vie privée</dt> - <dd>Les utilisateurs peuvent désormais naviguer sans enregistrer d'historique grâce à la navigation privée (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1081731" title="FIXED: Add private browsing to Firefox OS in Gaia">bug 1081731</a>.)</dd> - <dd>La prise en charge a été ajoutée pour ajuster la précision de la position vers une position approximative d'après différents types basiques de détection de position (désactivé par défaut) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1073419" title="[ALA] All gecko code needed to support adjustable location accuracy">bug 1073419</a>.)</dd> - <dt>Plate-forme</dt> - <dd>Le démarrage des applications et les performances générales ont été améliorés (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1074783" title="[META] SMS app launch latency is higher than LA in v2.1">bug 1074783</a>, <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1082262" title="[meta] Contact app launch latency is worse compared to Android on quad core 1 GB device">bug 1082262</a>, <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1082268" title="[meta] Music app launch latency is worse compared to Android on quad core 1 GB device">bug 1082268</a> et <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1086963" title="[meta] Gallery app launch latency is worse than Android on quad core device">bug 1086963</a>.)</dd> - <dd>Sur les appareils disposant de peu de RAM, les utilisateurs pourront constater de meilleures performances (le support des Cgroup réduisant le swapping des processus de haute priorité) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1082290" title="FIXED: Implement cgroup swappiness feature for low memory target (256 MB)">bug 1082290</a>.)</dd> - <dd>Le support d'Android L a été ajouté (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1094121" title="FIXED: [meta] Android L 5.0 Porting for B2G">bug 1094121</a>.)</dd> - <dd>Le support des extensions est maintenant disponible pour étendre les fonctionnalités de Firefox OS (désactivé par défaut) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=923897" title="FIXED: Extensibility support for b2g">bug 923897</a>.)</dd> - <dt>Langue/Localisation</dt> - <dd>Les langues qui se lisent de droite à gauche sont maintenant gérées par Firefox OS (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=906270" title="Support RTL language for B2G (tracker bug)">bug 906270</a>.)</dd> - <dt>Métriques</dt> - <dd>L'ajout de la possibilité d'avoir des rapports sur les utilisateurs actifs chaque mois permet de meilleures métriques (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1109422" title="FIXED: AppUsage Metric collection enhancements for MonthlyActiveUsers computation">bug 1109422</a>.)</dd> - <dt>NFC</dt> - <dd>Les applications tierces peuvent à présent employer les APIs NFC (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1102019" title="FIXED: [User Story] [NFC] Making NFC APIs privileged so 3rd party apps can use them">bug 1102019</a>.)</dd> -</dl> - -<h3 id="Applications_système">Applications système</h3> - -<dl> - <dt>Téléphone (Composeur)</dt> - <dd>Les appels téléphoniques peuvent être mis en attente depuis l'écran d'appel actif (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=977588" title="FIXED: [Dialer] The Active call screen does not have the option to place calls on hold.">bug 977588</a>.)</dd> - <dt>SMS/MMS</dt> - <dd>Les messages MMS peuvent maintenant être envoyés vers des adresses de messagerie électronique (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=997547" title="FIXED: [MMS]Text to email from Contact details">bug 997547</a> et <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1091486" title="FIXED: [SMS] Switch to MMS when entering a email recipient thread">bug 1091486</a>.)</dd> - <dd>Les contacts peuvent à présent être partagés au format VCF/vCard via courriel, messages, et Bluetooth (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1007932" title="FIXED: Allow to enclose a contact (serialized as vCard) as a message attachment">bug 1007932</a>.)</dd> - <dt>Courriel</dt> - <dd>Il est maintenant possible de joindre aux courriels des fichiers téléchargés présents dans le gestionnaire de téléchargement. (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1113152" title="FIXED: Make the files in download manager available for attachments in mail application">bug 1113152</a>.)</dd> - <dd>Les comptes de courriel peuvent maintenant être configurés manuellement soit en texte clair soit avec SSL (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1046799" title="FIXED: Include an option to manually configure email accounts without SSL">bug 1046799</a>.)</dd> - <dd>Il n'y a plus de contraintes sur les types de fichiers que l'utilisateur peut télécharger pour les pièces-jointes reçues (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=825318" title="FIXED: [B2G][Email] Unable to view a non-image attachment (ex: PDF)">bug 825318</a>.)</dd> - <dt>Écran d'accueil</dt> - <dd>Il est encore plus simple d'organiser et grouper du contenu sur l'écran d'accueil grâce à la nouvelle possibilité de grouper des applications (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1067435" title="FIXED: [meta] Home-screen grouping">bug 1067435</a>.)</dd> - <dt>Clavier</dt> - <dd>Les utilisateurs ont maintenant la possibilité de sélectionner du texte (appuyez et maintenez enfoncé pour sélectionner un mot, puis éditez la sélection avec les poignées fournies), coupez ou copiez le texte sélectionné vers le presse-papiers, et collez-en le contenu dans le texte affiché à la position actuelle.</dd> -</dl> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt>Paramètres</dt> - <dd>Un nouveau menu pour le filtrage d'appels a été ajouté aux paramètres (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=910552" title="FIXED: [zffos1.1][P2][Call Setting]Call Barring menu not implemented">bug 910552</a>.)</dd> - <dt>Vie privée</dt> - <dd>De nouveaux paramètres ont été ajoutés pour permettre à l'utilisateur d'ajuster les paramètres de confidentialité qui contrôlent le partage des données stockées sur le téléphone (désactivé par défaut) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1083953" title="FIXED: [META] Privacy Panel move from dev_apps to apps">bug 1083953</a>.) Quand l'option est activée, voir <em>Paramètres > Confidentialité navigation</em>.</dd> -</dl> - -<h2 id="Nouvelles_fonctionnalités_des_DevTools">Nouvelles fonctionnalités des DevTools</h2> - -<p>Nous avons ajouté un bouton "Réinitialiser et activer les outils de développement" aux <a href="/en-US/Firefox_OS/Debugging/Developer_settings#Reset_and_enable_full_DevTools">Paramètres Développeurs de Firefox OS</a> pour donner de plus grandes permissions sur votre appareil — cela est important pour ceux d'entre-vous qui ne peuvent pas rooter leur appareil — cette option ne nécessite pas les privilèges root.</p> - -<div class="note"> -<p><strong>Note</strong> : Vous pouvez toujours trouver des détails sur les nouveaux outils de développement Firefox et sur ceux à venir en regardant dans la <a href="https://hacks.mozilla.org/category/developer-tools/">catégorie Mozilla Hacks Developer Tools</a>.</p> -</div> - -<h2 id="Modifications_de_la_plate-forme_et_ajouts_en_détail">Modifications de la plate-forme et ajouts en détail</h2> - -<div class="note"> -<p><strong>Note</strong> : Notre présente liste comporte les fonctionnalités les plus importantes de Firefox OS. Pour une liste plus complète des ajouts aux caractéristiques générales de Gecko (qui sont en général également présentes dans Firefox OS 2.2), consultez les <a href="/en-US/docs/Mozilla/Firefox/Releases/35" title="/en-US/docs/Mozilla/Firefox/Releases/28">notes de version Firefox 35 pour développeurs</a>, les <a href="/en-US/docs/Mozilla/Firefox/Releases/36" title="/en-US/docs/Mozilla/Firefox/Releases/28">notes de version Firefox 36 pour développeurs</a> et les <a href="/en-US/docs/Mozilla/Firefox/Releases/37" title="/en-US/docs/Mozilla/Firefox/Releases/28">notes de version Firefox 37 pour développeurs</a>.</p> -</div> - -<h3 id="Changements_de_l'API_Web">Changements de l'API Web</h3> - -<ul> - <li>La méthode <code>app.getLocalizedValue()</code> a été ajoutée pour retourner le nom localisé de l'application (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1118946" title="FIXED: API to provide localized App name">bug 1118946</a>.)</li> - <li>Un important travail de factorisation de code relatif à la téléphonie a été fait ; en particulier, les fonctions <a href="/fr/docs/Web/API/MozMobileConnection/sendMMI" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileConnection.sendMMI</code></a> et <a href="/fr/docs/Web/API/Telephony/dial" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Telephony.dial</code></a> ont été fusionnées (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1031175" title="FIXED: [Gaia] Unify both sendMMI() and dial() functions">bug 1031175</a>.)</li> - <li>Suite aux modifications ci-dessus, <a href="/fr/docs/Web/API/MozMobileConnection/sendMMI" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileConnection.sendMMI</code></a>, <a href="/fr/docs/Web/API/MozMobileConnection/cancelMMI" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileConnection.cancelMMI</code></a>, <a href="/fr/docs/Web/API/MozMobileConnection/onussdreceived" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozMobileConnection.onussdreceived</code></a>, et <a href="/fr/docs/Web/API/USSDReceivedEvent/sessionEnded" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>USSDReceivedEvent.sessionEnded</code></a> ont été dépréciées.</li> - <li>La promesse de <a href="/fr/docs/Web/API/Telephony/dial" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Telephony.dial</code></a> est tenue directement par le résultat de l'appel, et non par un <a href="/fr/docs/Web/API/DOMRequest" title="Un objet DOMRequest représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet DOMRequest que vous pouvez surveiller pour connaitre le déroulement de l'opération"><code>DOMRequest</code></a> pour le résultat (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1080883" title="FIXED: Telephony.dial returning a Promise that resolves to a DOMRequest makes no sense">bug 1080883</a>.)</li> - <li><a href="/fr/docs/Web/API/DOMApplicationsManager/setEnabled" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozApps.mgmt.setEnabled</code></a> et <a href="/fr/docs/Web/API/DOMApplicationsManager/onenabledstatechange" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>mozApps.mgmt.onenabledstatechange</code></a> ajoutés pour activer et désactiver une application (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1072090" title="FIXED: Add a way to enable and disable an app.">bug 1072090</a>)</li> - <li><code>mozApps.mgmt.import</code> et <code>mozApps.mgmt.export</code> ajoutés pour contrôler les imports et exports d'applications (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=982874" title="FIXED: Import / export API for apps">bug 982874</a>.)</li> - <li><a href="/fr/docs/Web/API/HTMLIFrameElement/setNfcFocus" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>HTMLIFrameElement.setNfcFocus()</code></a> ajouté à l'API browser pour indiquer si un iframe peut recevoir un événement NFC (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1105666" title="FIXED: [BrowserAPI] Add an API to indicate this iframe could receive NFC event.">bug 1105666</a>.)</li> - <li>Des valeurs par défaut utiles sont définies pour l'interface <a href="/fr/docs/Web/API/CameraControl" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CameraControl</code></a> — caméra avant sélectionnée, sélection du profil pour le meilleur enregistrement possible, dimensions de fenêtre interne sélectionnées pour la taille de prévisualisation, et largeur/hauteur de l'enregistrement actuel fixées en plein écran, lorsque <a href="/fr/docs/Web/API/CameraControl/getCamera" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CameraControl.getCamera()</code></a> est appelé (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1104913" title="FIXED: [Camera][Gecko] Provide sane defaults to the CameraControl API">bug 1104913</a>.)</li> - <li>L'<a href="/en-US/docs/Web/API/NFC_API">API NFC</a> est rendue accessible aux applications privilégiées (elle ne l'était avant que pour celles internes ou certifiées) (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1091356" title="FIXED: Change AvailableIn to PrivilegedApps for NFC API">bug 1091356</a>.)</li> - <li>Deux nouvelles permissions de manifeste relatives à l'<a href="/en-US/docs/Web/API/NFC_API">API NFC</a> ont été ajoutées — <code>nfc</code> et <code>nfc-share</code> — pour rendre les permissions NFC plus granulaires et plus simples à migrer vers un état privilégié (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1048676" title='FIXED: B2G NFC: Add "nfc" and "nfc-share" permissions.'>bug 1048676</a>.)</li> - <li><a href="/fr/docs/Web/API/NdefReceivedEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>NdefReceivedEvent</code></a> a été ajouté à l'API NFC pour notifier le système lorsqu'un NDEF est reçu depuis un autre appareil NFC (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1127735" title="FIXED: Update TechDiscoveredNotication">bug 1127735</a>.)</li> - <li>Un certain nombre de modifications de l'<a href="/en-US/docs/Web/API/NFC_API">API NFC</a> a été fait pour prendre en charge différents formats de tags (comme les tags ISO 14443-4.) En particulier, la méthode <a href="/fr/docs/Web/API/MozNFCTag/transceive" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFCTag.transceive()</code></a> a été ajoutée pour lire différent formats, et <a href="/fr/docs/Web/API/MozNFCTag/format" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFCTag.format()</code></a> pour formater les cartes dans un format que Firefox OS peut utiliser (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=916428" title="FIXED: [NFC] APIs for ISO 14443-4 tags (IsoDep Support)">bug 916428</a>.)</li> - <li>La méthode <a href="/fr/docs/Web/API/MozNFCTag/makeReadOnly" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFCTag.makeReadOnly()</code></a> a été ajoutée pour mettre un tag en lecture seule.</li> - <li>La propriété <a href="/fr/docs/Web/API/MozNFCTag/id" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFCTag.id</code></a> a été ajoutée pour qu'un ID unique puisse être attribué à tous les tags (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1115465" title="FIXED: Add id attribute to NFCTag">bug 1115465</a>.)</li> - <li>Les propriétés de gestion d'événements <a href="/fr/docs/Web/API/MozNFC/onpeerfound" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFC.onpeerfound</code></a>, <a href="/fr/docs/Web/API/MozNFC/ontagfound" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFC.ontagfound</code></a>, et <a href="/fr/docs/Web/API/MozNFC/ontaglost" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>MozNFC.ontaglost</code></a> ont été ajoutées en remplacement des <a href="/en-US/docs/Web/API/Web_Activities">web activities</a> qui géraient auparavant les mêmes fonctionnalités (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=991970" title="FIXED: [B2G][NFC] Support W3C compliant ontagfound, ontaglost">bug 991970</a>.)</li> - <li>Le support des éléments sécurisés NFC a été ajouté (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=879861" title="FIXED: NFC Secure Element Support">bug 879861</a>.)</li> - <li>Les événements <code>KeyboardEvent</code> (DOM Level 3 Events pour les boutons physiques, e.g power, volume haut, volume bas) sont maintenant envoyés aux éléments du navigateur (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=989198" title="FIXED: [Stingray] Dispatch KeyboardEvent across BrowserElements">bug 989198</a>.)</li> -</ul> - -<h2 id="Annonces_de_sécurité">Annonces de sécurité</h2> - -<p>Une <a href="https://www.mozilla.org/en-US/security/known-vulnerabilities/firefox-os/#firefoxos2.2">liste complète des annonces de sécurité de Firefox OS 2.2</a> est disponible.</p> - -<h2 id="Anciennes_versions">Anciennes versions</h2> - -<p></p><div class="multiColumnList"> -<ul> -<li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/2.0">Firefox OS 2.0 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.4">Firefox OS 1.4 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.3">Firefox OS 1.3 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.2">Firefox OS 1.2 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.1">Firefox OS 1.1 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li></ul> -</div><p></p> diff --git a/files/fr/archive/b2g_os/releases/2.5/index.html b/files/fr/archive/b2g_os/releases/2.5/index.html deleted file mode 100644 index 387969b7ee..0000000000 --- a/files/fr/archive/b2g_os/releases/2.5/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Firefox OS 2.5 pour les développeurs -slug: Archive/B2G_OS/Releases/2.5 -tags: - - '2.5' - - Firefox OS - - Notes de version -translation_of: Archive/B2G_OS/Releases/2.5 ---- -<div> -<p class="summary">Cette page détaille les fonctionnalités développeurs nouvellement implémentées dans Gecko et qui sont spécifiques à Firefox OS 2.5, ainsi que les fonctionnalités du produit et des outils de développement, et d'autres points notables de cette nouvelle version.</p> -</div> - -<div class="note"> -<p><strong>Note</strong> : Le composant Gecko de Firefox OS 2.5 est basé sur celui de Firefox <strong>à partir de la version 38</strong>.</p> -</div> - -<h2 id="Fonctionnalités_du_produit">Fonctionnalités du produit</h2> - -<p>Cette section énumère différentes catégories de fonctionnalités nouvelles ou améliorées.</p> - -<h3 id="Nouvelles_fonctionnalités_systèmes">Nouvelles fonctionnalités systèmes</h3> - -<dl> - <dt> </dt> - <dt>L'app Bugzilla Lite</dt> - <dd>Fournit la possibilité de signaler des bogues/demandes de fonctionnalités directement depuis l'appareil (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180660" title="FIXED: [meta] Bugzilla Lite v2.5 tracking">bug 1180660</a>.)</dd> - <dt>Modules</dt> - <dd>Fournit la possibilité de personnaliser l'expérience de l'utilisateur selon ses envies (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180672" title="addon support">bug 1180672</a>.)</dd> - <dt>Écrans d'accueil remplaçables</dt> - <dd>L'utilisateur peut maintenant choisir entre plusieurs écrans d'accueil différents (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180665" title="FIXED: Support replaceable homescreen">bug 1180665</a>.)</dd> - <dt>L'API Web Speech</dt> - <dd>Permet aux développeurs d'implémenter des applications qui peuvent être contrôlées par la voix (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1051148" title="FIXED: Implementation of Webspeech API & PocketSphinx Integration">bug 1051148</a>.)</dd> - <dt>Épinglage de la page web</dt> - <dd>Cette fonction permet de parcourir le web et d'épingler un site web sur l'écran d'accueil de sorte que les utilisateurs puissent avoir un accès facile et rapide aux contenus qui les intéressent (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180669" title="FIXED: Pin the web support">bug 1180669</a>.)</dd> - <dt>Protection contre le pistage</dt> - <dd>Les utilisateurs peuvent à présent naviguer en sécurité sur le web sans être pistés (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180674" title="FIXED: [Meta] Tracking Protection">bug 1180674</a>.)</dd> - <dt>Durée de démarrage et performances de l'appareil</dt> - <dd>Les régressions de performances/démarrage ont été éradiquées de Firefox OS 2.5, garantissant une bonne expérience dès l'allumage de l'appareil (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180695" title="Device startup time">bug 1180695</a>, <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180696" title="FIXED: app startup times">bug 1180696</a>.)</dd> - <dt>Personnalisation après le premier démarrage</dt> - <dd>Les vendeurs d'appareils ont désormais la possibilité de proposer à leurs clients des applications de leur choix lors du premier démarrage (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180707" title="FIXED: late customisation">bug 1180707</a>.)</dd> - <dt>Expérience RTL améliorée</dt> - <dd>Firefox OS 2.5 dispose d'un bien meilleur support des langues RTL, assurant ainsi un meilleur support des langues pour toute notre base d'utilisateurs (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1179459" title="RTL Support for Firefox OS 2.5">bug 1179459</a>.)</dd> - <dt>Première implémentation de la nouvelle architecture de Gaia (NGA, soit New Gaia Architecture)</dt> - <dd>La première étape consiste à séparer les architectures frontend et backend des applications Gaia, ce qui permettra de nombreuses améliorations dans le futur (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1180716" title="NGA FE/BE split support">bug 1180716</a>.)</dd> - <dt>Voir le code source</dt> - <dd>Quand l'appareil est en mode développeur, les utilisateurs peuvent directement voir dessus le code source des applications intégrées (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1188671" title="FIXED: Implement View Source">bug 1188671</a>.)</dd> - <dt>API Presentation</dt> - <dd> Autorise le développeur à activer des contenus web pour accéder à des affichages externes de type présentation puis à les utiliser pour faire des présentations web (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1184073" title="[meta] 2-UAs support for Presentation API">bug 1184073</a>.)</dd> - <dt> </dt> - <dt> - <h3 id="Firefox_OS_TV–fonctionnalités_spécifiques">Firefox OS TV–fonctionnalités spécifiques</h3> - </dt> - <dt>Navigateur TV</dt> - <dd> Support du facteur d'encombrement TV pour le navigateur de Firefox OS (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1190158" title="FIXED: [Browser app] Firefox Browser app on the main home screen">bug 1190158</a>.)</dd> - <dt>Intégration de Compte Firefox dans le Navigateur TV</dt> - <dd> Permet aux utilisateurs des TV de synchroniser leurs marque-pages et historique via leur Compte Firefox dans le navigateur (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1194108" title="FIXED: [meta][browser] Firefox Account in TV">bug 1194108</a>.)</dd> - <dt>Récepteur de requête pour l'API Presentation</dt> - <dd>Permet aux TV sous Firefox OS de recevoir des URLs envoyées depuis d'autres appareils via des appels à l'API Presentation (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1205999" title="FIXED: [TV][2.5] (TV side) TV to receive URL sent from Fennec">bug 1205999</a>.)</dd> - <dt><strong>Métriques pour la TV</strong></dt> - <dd> Les métriques de Firefox OS sont maintenant activées pour le facteur d'encombrement TV (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1199319" title="[TV][meta] TV Metrics">bug 1199319</a>.)</dd> -</dl> - -<h2 id="Nouvelles_fonctionnalités_des_DevTools">Nouvelles fonctionnalités des DevTools</h2> - -<div class="note"> -<p><strong>Note</strong> : Vous pouvez toujours trouver des détails sur les nouveaux outils de développement Firefox et sur ceux à venir en regardant dans la <a href="https://hacks.mozilla.org/category/developer-tools/">catégorie Mozilla Hacks Developer Tools</a>.</p> -</div> - -<h2 id="Modifications_de_la_plate-forme_et_ajouts_en_détail">Modifications de la plate-forme et ajouts en détail</h2> - -<div class="note"> -<p><strong>Note</strong> : Notre présente liste comporte les fonctionnalités les plus importantes de Firefox OS. Pour une liste plus complète des ajouts aux caractéristiques générales de Gecko (qui sont en général également présentes dans Firefox OS 2.5), consultez les plus récentes <a href="/fr/docs/Mozilla/Firefox/Versions">notes de version de Firefox pour développeurs</a>.</p> -</div> - -<h3 id="JavaScript">JavaScript</h3> - -<ul> - <li>L'<a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Intl">API ECMAScript Internationalization</a> a été activée dans Firefox OS. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=866301" title="FIXED: Enable ECMAScript Internationalization API for Firefox OS">bug 866301</a> pour plus de détails sur l'implémentation, et le message de blog <a href="https://hacks.mozilla.org/2014/12/introducing-the-javascript-internationalization-api/">Introducing the JavaScript Internationalization API</a> pour des exemples d'utilisation.</li> -</ul> - -<h3 id="Changements_de_l'API_Web">Changements de l'API Web</h3> - -<ul> - <li>L'<a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API">API Web Speech</a> permet d'incorporer des données vocales dans des applications web — aussi bien de la reconnaissance vocale que de la synthèse vocale (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1051148" title="FIXED: Implementation of Webspeech API & PocketSphinx Integration">bug 1051148</a>.)</li> - <li>L'<a href="/fr/docs/WebAPI/Camera">API Camera</a> a été enrichie avec deux nouvelles méthodes pour contrôler l'enregistrement vidéo : <a href="/fr/docs/Web/API/CameraControl/pauseRecording" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CameraControl.pauseRecording()</code></a> et <a href="/fr/docs/Web/API/CameraControl/resumeRecording" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>CameraControl.resumeRecording()</code></a> (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1187364" title="FIXED: [Gecko][Camera] Pause and Resume support during video recording">bug 1187364</a>.)</li> - <li>L'<a href="/en-US/docs/Web/API/Data_Store_API">API Data Store</a> est maintenant disponible pour les applications privilégiées de l'écran d'accueil. Ainsi, les applications tierces de l'écran d'accueil peuvent accéder aux mêmes stockages de données que celles par défaut et elles peuvent fournir des fonctionnalités équivalentes. Voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1181329" title="FIXED: [User Story] Make DataStore available to privileged homescreen apps">bug 1181329</a> pour les détails de l'implémentation de la fonctionnalité, et <a href="/en-US/docs/Web/API/Data_Store_API/Using_the_Data_Store_API#Privileged_homescreen_apps">Using the Data Store API</a> pour les détails du code spécifique.</li> - <li>L'interface <a href="/fr/docs/Web/API/DeviceStorage" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>DeviceStorage</code></a> dispose d'une nouvelle propriété <a href="/fr/docs/Web/API/Boolean" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Boolean</code></a> qui retourne <code>true</code> si la zone de stockage est presque pleine (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1204618" title="FIXED: [DeviceStorage] Add a new API to query the current low-disk-space status">bug 1204618</a>.)</li> - <li>L'<a href="/fr/docs/Web/Guide/Telephony">API Telephony</a> dispose d'une nouvelle méthode permettant à une application d'être désignée comme le propriétaire des appels téléphoniques à partir de la stratégie <a href="/en-US/docs/Web/API/AudioChannels_API">AudioChannel</a> — <a href="/fr/docs/Web/API/Telephony/ownAudioChannel" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>Telephony.ownAudioChannel()</code></a> (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1129882" title="FIXED: [B2G] Using the new audio channel design to manage the telephony's sound">bug 1129882</a>.)</li> - <li>L'<a href="/en-US/docs/Web/API/Browser_API">API Browser</a> dispose d'une nouvelle méthode pour récupérer les microdonnées des pages chargées : <a href="/fr/docs/Web/API/HTMLIFrameElement/getStructuredData" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>HTMLIFrameElement.getStructuredData()</code></a> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1195801" title="FIXED: Add API function for fetching Microdata data to the Browser API">bug 1195801</a>.)</li> - <li>L'<a href="/en-US/docs/Web/API/Browser_API">API Browser</a> dispose d'une nouvelle méthode pour récupérer le manifeste d'une application chargée : <a href="/fr/docs/Web/API/HTMLIFrameElement/getManifest" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>HTMLIFrameElement.getManifest()</code></a> (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1169633" title="FIXED: [Browser API] getWebManifest()">bug 1169633</a>.)</li> - <li>L'événement <code><a href="/fr/docs/Web/Reference/Events/mozbrowserasyncscroll" title="/fr/docs/Web/Reference/Events/mozbrowserasyncscroll">mozbrowserasyncscroll</a></code> de l'<a href="/en-US/docs/Web/API/Browser_API">API Browser</a> a été supprimé (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=898075" title="FIXED: Remove the mozbrowserasyncscroll event">bug 898075</a>.)</li> -</ul> - -<h2 id="Bogues_et_régressions">Bogues et régressions</h2> - -<p>Un appui long sur une image en mode édition provoque l'apparition d'un menu contextuel dont les options ne fonctionnent pas correctement à cause d'un sélecteur d'activité incorrect. Cette régression a été corrigée début octobre (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1198522" title="FIXED: Long pressing on an image in edit mode will bring up a menu that does not function">bug 1198522</a>.)</p> - -<h2 id="Annonces_de_sécurité">Annonces de sécurité</h2> - -<p>Aucune jusqu'à présent.</p> - -<h2 id="Anciennes_versions">Anciennes versions</h2> - -<p></p><div class="multiColumnList"> -<ul> -<li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/2.0">Firefox OS 2.0 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.4">Firefox OS 1.4 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.3">Firefox OS 1.3 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.2">Firefox OS 1.2 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.1">Firefox OS 1.1 pour les développeurs</a></li><li><a href="/fr/docs/Mozilla/Firefox_OS/Versions/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li></ul> -</div><p></p> diff --git a/files/fr/archive/b2g_os/releases/index.html b/files/fr/archive/b2g_os/releases/index.html deleted file mode 100644 index 3c4c86b0d5..0000000000 --- a/files/fr/archive/b2g_os/releases/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Firefox OS developer release notes -slug: Archive/B2G_OS/Releases -tags: - - Firefox OS - - TopicStub -translation_of: Archive/B2G_OS/Releases ---- -<h2 id="Notes_de_version_de_Firefox_OS_par_version">Notes de version de Firefox OS par version</h2> - -<p>Cette section fournit des articles couvrant chaque nouvelle version de Gaia et Gecko pour Firefox OS, expliquant quelles fonctionnalités ont été ajoutées et les bogues éliminés dans chaque mise à jour. Il existe également un tableau récapitulatif lié indiquant les API prises en charge par chaque version de Firefox OS.</p> - -<div class="multiColumnList"> -<ol> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/1.0.1">Firefox OS 1.0.1 pour les développeurs</a></li> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/1.1">Firefox OS 1.1 pour les développeurs</a></li> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/2.0">Firefox OS 2.0 pour les développeurs</a></li> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/2.1">Firefox OS 2.1 pour les développeurs</a></li> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/2.2">Firefox OS 2.2 pour les développeurs</a></li> - <li><a href="/fr/docs/Archive/B2G_OS/Releases/2.5">Firefox OS 2.5 pour les développeurs</a></li> -</ol> -</div> - -<h2 id="Autres_informations_complémentaires">Autres informations complémentaires</h2> - -<dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/API_support_table">Tableau de prise en charge de l'API Firefox OS</a></dt> - <dd>Répertorie les différentes API disponibles et les versions de Firefox qui les prennent en charge.</dd> - <dt><a href="/en-US/docs/Web/Apps/App_permissions">Permissions d'application</a></dt> - <dd>Répertorie les API hébergées, privilégiées et certifiées, ainsi que des informations sur les autorisations qu'elles doivent avoir définies dans le manifeste d'application de vos applications installables, telles que le nom de l'autorisation manifeste, le type d'application requis, la description, la propriété d'accès et l'autorisation par défaut.</dd> -</dl> diff --git a/files/fr/archive/b2g_os/resources/index.html b/files/fr/archive/b2g_os/resources/index.html deleted file mode 100644 index 3023f24587..0000000000 --- a/files/fr/archive/b2g_os/resources/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Ressources -slug: Archive/B2G_OS/Resources -tags: - - Firefox OS -translation_of: Archive/B2G_OS/Resources ---- -<p id="Resources_for_App_hackers.2C_as_generated_from_our_workshops"><em>Ressources pour hackers d'applications, produites par nos ateliers</em></p> - -<h3 id="Simulateur_Firefox_OS">Simulateur Firefox OS</h3> - -<h4 id="Simulateur_Firefox_OS_2">Simulateur Firefox OS</h4> - -<p><a href="https://developer.mozilla.org/fr/docs/Outils/Simulateur_Firefox_OS/" title="https://github.com/robnyman/Firefox-OS-Boilerplate-App">https://developer.mozilla.org/fr/docs/Outils/Simulateur_Firefox_OS/</a><br> - <a href="https://addons.mozilla.org/fr/firefox/addon/firefox-os-simulator/" title="http://robnyman.github.com/Firefox-OS-Boilerplate-App/">https://addons.mozilla.org/fr/firefox/addon/firefox-os-simulator/</a></p> - -<h3 id="Développerinstaller_une_app">Développer/installer une app</h3> - -<h4 id="Firefox_OS_Boilerplate_App_(travail_en_cours)">Firefox OS Boilerplate App (travail en cours)</h4> - -<p><a href="https://github.com/robnyman/Firefox-OS-Boilerplate-App" title="https://github.com/robnyman/Firefox-OS-Boilerplate-App">https://github.com/robnyman/Firefox-OS-Boilerplate-App</a><br> - <a href="http://robnyman.github.com/Firefox-OS-Boilerplate-App/" title="http://robnyman.github.com/Firefox-OS-Boilerplate-App/">http://robnyman.github.com/Firefox-OS-Boilerplate-App/</a><br> - <br> - (version basique avec bouton Install, Web Activities, exemples de WebAPI, support hors-ligne facultatif etc)</p> - -<h4 id="Code_pour_version_avec_app_empaquetée">Code pour version avec app empaquetée :</h4> - -<p><a href="https://github.com/robnyman/Firefox-OS-Boilerplate-App/tree/packaged-app" title="https://github.com/robnyman/Firefox-OS-Boilerplate-App/tree/packaged-app">https://github.com/robnyman/Firefox-OS-Boilerplate-App/tree/packaged-app</a></p> - -<h4 id="FxOSStub_(modèledesign_pour_une_app_avec_un_bouton_Install)">FxOSStub (modèle/design pour une app avec un bouton Install) :</h4> - -<p><a href="https://github.com/Jaxo/fxosstub" title="https://github.com/Jaxo/fxosstub">https://github.com/Jaxo/fxosstub</a><br> - <br> - Recommandé : à héberger sur votre propre serveur ou via des pages GitHub <br> - (<a href="http://pages.github.com/" title="http://pages.github.com/">http://pages.github.com/</a>). Exemple sur <a href="http://robnyman.github.com/Firefox-OS-Boilerplate-App/" title="http://robnyman.github.com/Firefox-OS-Boilerplate-App/">http://robnyman.github.com/Firefox-OS-Boilerplate-App/</a></p> - -<h4 id="Mortar">Mortar :</h4> - -<p><a href="https://hacks.mozilla.org/2013/01/writing-web-apps-quickly-with-mortar/" title="https://hacks.mozilla.org/2013/01/writing-web-apps-quickly-with-mortar/">https://hacks.mozilla.org/2013/01/writing-web-apps-quickly-with-mortar/</a></p> - -<h4 id="Design_patterns">Design patterns :</h4> - -<p><a href="https://marketplace.firefox.com/developers/docs/patterns" title="https://marketplace.firefox.com/developers/docs/patterns">https://marketplace.firefox.com/developers/docs/patterns</a></p> - -<h4 id="Charte_graphique_de_Firefox_OS">Charte graphique de Firefox OS :</h4> - -<p><a href="https://t.co/I9VaxvBu" title="https://t.co/I9VaxvBu">https://t.co/I9VaxvBu</a><br> - <br> - droid@screen : <a href="http://blog.ribomation.com/droid-at-screen/" title="http://blog.ribomation.com/droid-at-screen/">http://blog.ribomation.com/droid-at-screen/</a></p> - -<h3 id="WebAPIs">WebAPIs</h3> - -<h4 id="WebAPIs_en_version_1">WebAPIs en version 1 :</h4> - -<p><a href="https://wiki.mozilla.org/WebAPI" title="https://wiki.mozilla.org/WebAPI">https://wiki.mozilla.org/WebAPI</a></p> - -<h4 id="Documentation_des_APIs_et_leur_statut">Documentation des APIs et leur statut :</h4> - -<p><a href="/fr/docs/MDN/Doc_status/API" title="/fr/docs/MDN/Doc_status/API">https://developer.mozilla.org/fr/docs/MDN/Doc_status/API</a></p> - -<h4 id="Diaporama_de_Robert_sur_les_Web_APIs">Diaporama de Robert sur les Web APIs</h4> - -<p><a href="http://www.slideshare.net/robnyman/web-apis-apps-mozilla-london" title="http://www.slideshare.net/robnyman/web-apis-apps-mozilla-london">http://www.slideshare.net/robnyman/web-apis-apps-mozilla-london</a></p> - -<h4 id="Writing_(good)_Webapps">Writing (good) Webapps :</h4> - -<p><a href="http://jlongster.github.com/writing-webapps/" title="http://jlongster.github.com/writing-webapps/">http://jlongster.github.com/writing-webapps/</a></p> - -<h3 id="Firefox_Marketplace_Developer_Hub">Firefox Marketplace & Developer Hub</h3> - -<h4 id="Rapporter_un_bogue_à_propos_de_Marketplace_!">Rapporter un bogue à propos de Marketplace !</h4> - -<p><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Marketplace&component=General" title="https://bugzilla.mozilla.org/enter_bug.cgi?product=Marketplace&component=General">https://bugzilla.mozilla.org/enter_bug.cgi?product=Marketplace&component=General</a></p> - -<h4 id="Developer_Hub">Developer Hub</h4> - -<p><a href="https://marketplace.firefox.com/developers/" title="https://marketplace.firefox.com/developers/">https://marketplace.firefox.com/developers/</a></p> - -<h4 id="Liste_de_diffusion_WebApps">Liste de diffusion WebApps</h4> - -<p><a href="https://lists.mozilla.org/listinfo/dev-webapps" title="https://lists.mozilla.org/listinfo/dev-webapps">https://lists.mozilla.org/listinfo/dev-webapps</a></p> - -<h4 id="Serveur_de_développement_Marketplace_(s'attendre_à_des_bogues_!)">Serveur de développement Marketplace (s'attendre à des bogues !)</h4> - -<p><a href="http://marketplace-dev.allizom.org/" title="http://marketplace-dev.allizom.org/">http://marketplace-dev.allizom.org/</a></p> - -<h4 id="Apps_de_référence_(Chrono_Face_Value_Roller)">Apps de référence (Chrono, Face Value, Roller) :</h4> - -<p><a href="https://marketplace.firefox.com/developers/docs/apps/chrono" title="https://marketplace.firefox.com/developers/docs/apps/chrono">https://marketplace.firefox.com/developers/docs/apps/chrono</a></p> - -<h3 id="WebPayments">WebPayments</h3> - -<p><a href="https://wiki.mozilla.org/WebAPI/WebPayment" title="https://wiki.mozilla.org/WebAPI/WebPayment">https://wiki.mozilla.org/WebAPI/WebPayment</a><br> - <a href="https://wiki.mozilla.org/WebAPI/WebPaymentProvider" title="https://wiki.mozilla.org/WebAPI/WebPaymentProvider">https://wiki.mozilla.org/WebAPI/WebPaymentProvider</a></p> - -<h3 id="Pitfalls_and_helpers_for_mobile_Web_apps">Pitfalls and helpers for mobile Web apps</h3> - -<h4 id="Diaporama_de_Rob_Pitfalls_and_Helpers">Diaporama de Rob Pitfalls and Helpers</h4> - -<p><a href="http://www.slideshare.net/robhawkes/mobile-app-development-pitfalls-helpers" title="http://www.slideshare.net/robhawkes/mobile-app-development-pitfalls-helpers">http://www.slideshare.net/robhawkes/mobile-app-development-pitfalls-helpers</a><br> - </p> diff --git a/files/fr/archive/b2g_os/running_tests_on_firefox_os_for_developers/index.html b/files/fr/archive/b2g_os/running_tests_on_firefox_os_for_developers/index.html deleted file mode 100644 index 7219ca4082..0000000000 --- a/files/fr/archive/b2g_os/running_tests_on_firefox_os_for_developers/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: 'Running tests on Firefox OS: A guide for developers' -slug: Archive/B2G_OS/Running_Tests_on_Firefox_OS_for_Developers -translation_of: Archive/B2G_OS/Running_Tests_on_Firefox_OS_for_Developers ---- -<div class="summary"> -<p>Les équipes behind our automation harnesses have been working hard to expand our automated testing infrastructure to accomodate Firefox OS as well as writing new harnesses to specifically target testing a phone OS rather than a browser (which our old harnesses were specialized for). Due to the architecture of Firefox OS all these test harnesses will work and will apply, but that also makes things rather complicated and you are a developer and just want to run some tests to see if your patch worked or not. This article aims to make sense of all the available testing resources at Mozilla.</p> -</div> - -<h2 id="Getting_started">Getting started</h2> - -<p>If you are a Gecko developer, then you should review the Firefox OS-specific documentation for the test automation you are already familar with: <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Mochitests">mochitest</a>, <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Automated_testing/Reftests">reftest</a>, and <a href="https://developer.mozilla.org/en-US/Firefox_OS/Platform/Automated_testing/XPCShell">xpcshell</a>.</p> - -<p>If you are a Gaia or App developer, or if you're a Gecko developer interested in doing a deeper "end user" style test where you actually exercise the OS, then you'll need to look into the Gaia test suites. There are two primary test suites:</p> - -<ul> - <li><a href="/en-US/Firefox_OS/Platform/Automated_testing/gaia-ui-tests">Gaia UI Tests</a>: These tests are Python-based, and can be run on both desktop and devices. These tests test various aspect of the Gaia UI such as endurance tests (adding lots of contacts to the Contacts app, unlocking the lock screen repeatedly, setting many alarms in the Alarms app, etc.), functional tests (e.g. finding stations on the FM radio app, capturing a photo using the Camera app) and accessibility tests (e.g. enabling and disabiling the screenreader.)</li> - <li><a href="https://github.com/mozilla-b2g/gaia/#integration-tests">Gaia Integration tests</a>: These tests are JavaScript-based, using <a href="https://github.com/mozilla-b2g/marionette-js-runner">marionette-js-runner</a>, and can only be run on B2G desktop builds at the time of this writing (real device support is coming very soon.) These test various aspects of how Gaia interacts with other apps and services, so for example, if the Calendar app can successfully add a CalDAV server, or if the Browser app can successfully handle interactions with search engines.</li> -</ul> - -<p>Which one you choose really depends on your preferred toolchain, and what things you want to test.</p> - -<p>Let's now move and look at running these tests.</p> - -<h2 id="Running_the_Gaia_UI_Tests">Running the Gaia UI Tests</h2> - -<p>The <a href="https://github.com/mozilla-b2g/gaia/tree/master/tests/python/gaia-ui-tests">Gaia UI Test</a> suite can be run on real devices and B2G Desktop builds, but in this section we'll concentrate on running them on a real device, as real devices are always best where possible.</p> - -<p>Note that this test is <em><strong>destructive</strong></em> and as such, you should back up anything you care about on the phone before running these tests. Depending on which tests you run, they can also make phone calls. So be aware that you want to be very careful about what you run and how you back up the phone, remove the SIM card, etc. That said, if you've already created an engineering build they are really easy to get running. Here's how.</p> - -<h3 id="One_Time_Set_up">One Time Set up</h3> - -<p>You only need to perform the following steps once, assuming you do not change the location of your Gaia directory. Create a python virtualenv (<a href="https://pypi.python.org/pypi/virtualenv">install the virtualenv tool</a> first if you haven't already), activate it, and install the gaia UI test tool into your virtualenv. By creating the virtual environment using the steps below, you ensure that you are running the gaia UI test harness code that lives in your Gaia repo (that's useful in case you need to debug anything).</p> - -<pre><code class="brush: bash">$ virtualenv gaia_ui_venv # This will create a gaia_ui_venv directory where the virtual environment lives. It can be anywhere on your system. -$ source gaia_ui_venv/bin/activate # This activates our virtualenv -(gaia_ui_venv)$ cd <b2groot>/gaia/tests/python/gaia-ui-tests;python setup.py develop # This installs the gaia ui harness into your virtual environment. </code></pre> - -<p>If you have already created a virtual environment for gaia ui tests, you can simply do the following:</p> - -<pre><code class="brush: bash">$ source gaia_ui_venv/bin/activate</code></pre> - -<h3 id="To_Run_the_Tests">To Run the Tests</h3> - -<p>First you need to create the testvars file. To do this, copy the standard one over, and add in the attributes to turn off the warnings that this test will <strong>destroy all content on your phone</strong>. These are good tests, they leave no state around and as such, you will need to make sure your phone is backed up before running them. Instructions from here on will assume you've activated the virtual environment and are working in the <code>gaia/tests/python/gaia-ui-tests</code> directory.</p> - -<pre><code class="brush: bash">(gaia_ui_venv)$ cp gaiatest/testvars_template.json testvars.json -# Now edit your copy of testvars.json and add in the following attributes into the json: -"acknowledged_risks": true, -"skip_warning": true,</code></pre> - -<p>Now you just need to connect our phone via USB, forward the marionette port so your test runner can access it and run our tests. The tests are in <code>gaiatest/tests</code> and you can pick whichever one you want to run. For example, if you wanted to run contacts tests you would do the following:</p> - -<pre><code>(gaia_ui_venv)$ adb forward tcp:2828 tcp:2828 -(gaia_ui_venv)$ gaiatest --testvars=testvars.json --address=localhost:2828 gaiatest/tests/functional/contacts/</code></pre> - -<div class="note"> -<p><strong>Note</strong>: To find out what UI tests are available, browse through the <a href="https://github.com/mozilla-b2g/gaia/tree/master/tests/python/gaia-ui-tests/gaiatest/tests">gaiatest directories inside the Gaia repo</a>.</p> -</div> - -<p>To get out of the python virtualenv, just use the special virtualenv command <code>deactivate</code>:</p> - -<pre><code>(gaia_ui_venv)$ deactivate -$</code></pre> - -<div class="note"> -<p><strong>Note</strong>: To learn more about the Gaia UI Tests and find more detailed information, move on to the <a href="/en-US/Firefox_OS/Platform/Automated_testing/gaia-ui-tests">Gaia UI Tests</a> pages.</p> -</div> - -<h2 id="Running_the_Gaia_Integration_tests">Running the Gaia Integration tests</h2> - -<p>To run the <a href="https://github.com/mozilla-b2g/gaia/#integration-tests">Gaia Integration tests</a> tests you currently have to use a B2G Desktop build (note that these are also going to be available for devices soon as well). Let's look at how this is done.</p> - -<p>These just require a Gaia tree and NodeJS to be installed on your computer; the following command will do the rest:</p> - -<pre><code>$ cd gaia $ make test-integration </code></pre> - -<p>That's it — this instruction will download a B2G desktop build, and start running the tests in that build.</p> - -<div class="note"> -<p><strong>Note</strong>: To learn more about Gaia Integration Tests, read the <a href="https://github.com/mozilla-b2g/gaia/#integration-tests">Gaia Integration Tests</a> Github repo.</p> -</div> - -<div class="note"> -<p><strong>Note</strong>: To find out what integration tests are available, look in the <a href="https://github.com/mozilla-b2g/gaia/tree/master/apps">apps directory in the Gaia repo</a>; integration tests can be found in <code>test/marionette/</code> subfolders.</p> -</div> - -<h2 id="Wrapping_Up">Wrapping Up</h2> - -<p>As always, work is underway to make all our tests easier to run both locally for developers as well as in our automation systems. Feel free to drop into the #ateam channel any time you have questions about test automation for Firefox OS or any of the Mozilla automation tools.</p> diff --git a/files/fr/archive/b2g_os/samsung_nexus_s/index.html b/files/fr/archive/b2g_os/samsung_nexus_s/index.html deleted file mode 100644 index a23dbdacbc..0000000000 --- a/files/fr/archive/b2g_os/samsung_nexus_s/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Samsung Nexus S -slug: Archive/B2G_OS/Samsung_Nexus_S -tags: - - B2G - - Firefox OS - - NexusS - - Samsung - - nexus_s -translation_of: Archive/B2G_OS/Phone_guide ---- -<p>Le Nexus S est une plate-forme de second rang (tier 2) pour Firefox OS. Ce n'est pas une cible, mais il y a du support pour le processus de construction. Toute aide pour supporter cet équipement est la bienvenue. Notez qu'à partir de mi-mars 2015, il n'est plus utilisé activement ni maintenu.</p> - -<h2 id="Compatibilité">Compatibilité</h2> - -<p>Les équipements i9020, i9020A, i9023 et SHW-M200k sont connus pour fonctionner. Une liste complète de problèmes relatifs au support de cet équipement est disponible à cette adresse : <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=b2g-nexuss">https://bugzilla.mozilla.org/show_bug.cgi?id=b2g-nexuss</a>.</p> - -<h2 id="Utilisabilité_(jusqu'à_v1.1)">Utilisabilité (jusqu'à v1.1)</h2> - -<p>Le téléphone devrait être utilisable au quotidien sans problème bloquant. Jusqu'ici, voici ce qui doit correctement fonctionner en construisant un système Gecko 18 (BRANCH=v1-train ./config.sh nexus-s) :</p> - -<ul> - <li>Emettre/recevoir des appels téléphoniques</li> - <li>Gérer les codes MMI/USSD (comme *#06# pour l'IMEI, *#21# pour l'état du transfert d'appel)</li> - <li>Emettre et recevoir des SMS et MMS</li> - <li>Prendre des photos (Le dépôt Gaia à la fin de cette page contient une modification spécifique pour prendre des photos de 5Mp)</li> - <li>Enregitrer des vidéos 480p (Le dépôt Gaia à la fin de cette page contient une modification spécifique pour enregistrer des vidéos)</li> - <li>Utiliser HSDPA et le WiFi (fonctionne également avec EAP, nécessite d'écrire manuellement la configuration WPA Supplicant)</li> - <li>Bluetooth</li> - <li>Géolocalisation</li> - <li>Lecture de vidéo avec accélération matérielle (avec quelques modifications, voir les problèmes référencés)</li> - <li>Stockage de masse USB</li> - <li>USB Tethering</li> - <li>WiFi Tethering (voir ci-dessous)</li> -</ul> - -<h2 id="Utilisabilité_(master_depuis_v1.42.0)">Utilisabilité (master, depuis v1.4/2.0)</h2> - -<p>La plupart des fonctionnalités doivent marcher. La lecture et l'enregistrement vidéo ne fonctionnent pas complètement.</p> - -<h2 id="Problèmes_à_l'exécution">Problèmes à l'exécution</h2> - -<h3 id="WiFi_Tethering">WiFi Tethering</h3> - -<p>Le WiFi Tethering fonctionne, mais il semble que le Wifi soit indisponible après l'avoir désactivé. Décharger puis recharger le pilote noyau Wifi ou redémarrer l'appareil permettent de contourner ce problème.</p> - -<pre>rmmod bcm4329 && insmod /system/modules/bcm4329.ko iface_name=wlan0</pre> - -<h2 id="Dépôts_de_modifications">Dépôts de modifications</h2> - -<p>Utilisez la branche gecko-18-local (et gecko-18-local+hd) pour le dépôt mozilla-central, master-local pour les autres.</p> - -<ul> - <li><a href="https://github.com/lissyx/mozilla-central" title="https://github.com/lissyx/mozilla-central">https://github.com/lissyx/mozilla-central</a></li> - <li><a href="https://github.com/lissyx/gaia" title="https://github.com/lissyx/gaia">https://github.com/lissyx/gaia</a></li> - <li><a href="https://github.com/lissyx/android-device-crespo" title="https://github.com/lissyx/android-device-crespo">https://github.com/lissyx/android-device-crespo</a></li> -</ul> - -<h2 id="Plus_d'informations">Plus d'informations</h2> - -<p>Vous trouverez un fil de discussion à propos de Firefox OS sur le Nexus S ici <a href="http://forum.xda-developers.com/showthread.php?t=1924367&page=13" title="http://forum.xda-developers.com/showthread.php?t=1924367&page=13">http://forum.xda-developers.com/showthread.php?t=1924367</a>. Il devrait contenir des images relativement à jour et fonctionnelles.</p> diff --git a/files/fr/archive/b2g_os/screencast_series_colon__app_basics_for_firefox_os/index.html b/files/fr/archive/b2g_os/screencast_series_colon__app_basics_for_firefox_os/index.html deleted file mode 100644 index 8e65a0d478..0000000000 --- a/files/fr/archive/b2g_os/screencast_series_colon__app_basics_for_firefox_os/index.html +++ /dev/null @@ -1,226 +0,0 @@ ---- -title: 'Screencast series: App Basics for Firefox OS' -slug: 'Archive/B2G_OS/Screencast_series:_App_Basics_for_Firefox_OS' -tags: - - API - - Apps - - B2G - - Firefox OS - - Marketplace - - Videos -translation_of: 'Archive/B2G_OS/Firefox_OS_apps/Screencast_series:_App_Basics_for_Firefox_OS' ---- -<div class="summary"> -<p><span class="seoSummary"><a href="http://www.mozilla.org/en-US/firefox/os/">Firefox OS</a> est un système d'exploitation qui apporte les technologies du Web aux smartphones. Au lieu d'être un nouvel OS avec de nouvelles technologies et des environnements de développements, il est construit sur des technologies web standardisées utilisées depuis des années. Si vous êtes un développeur web et que vous voulez coder une application mobile, Firefox OS vous donne les outils pour le faire, sans devoir changer votre workflow ou apprendre à utiliser un nouvel environnement de développement. Dans cette collection de petites vidéos, les développeurs de Mozilla et de Telenor se sont rencontrés à Oslo, en Norvège pour expliquer en quelques étapes comment vous pouvez commencer à coder des applications pour Firefox OS.</span></p> -</div> - -<p>Dans cette série vous apprendrez:</p> - -<ul> - <li>Comment coder votre première application pour Firefox OS.</li> - <li>Comment débuger et tester votre application sur votre ordinateur et sur un appareil physique.</li> - <li>Comment la publier sur le <a href="https://developer.mozilla.org/fr-FR/Marketplace">Marketplace Firefox</a> .</li> - <li>Comment utiliser les APIs et les interfaces spéciales : Firefox OS offre un support du JavaScript pour tirer profit du hardware embarqué sur les smartphones.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Chacune des vidéos est assez courte pour être regardée durant une courte pause; la série entière se regarde en moins d'une heure.</p> -</div> - -<h2 id="Code_et_environnement_de_développement">Code et environnement de développement<br> - </h2> - -<p>En plus des vidéos, vous pouvez télécharger les <a href="https://github.com/comoyo/fxos-video-script/">exemples de codes depuis GitHub</a>. Si vous voulez essayer les exemples vous-même, vous devrez mettre en place un environnement de développement simplifié. Vous aurez besoin de:</p> - -<ul> - <li>Une version à jour de <a href="https://www.mozilla.org/fr-FR/firefox/">Firefox</a>, qui est livrée avec les outils de développement dont vous aurez besoin — nous recommandons l'utilisation de <a href="https://www.mozilla.org/fr/firefox/channel/#aurora">Firefox Aurora</a> ou <a href="https://www.mozilla.org/fr/firefox/channel/#nightly">Bêta</a> si vous souhaitez vraiment "jouer" avec le must de la technologie.</li> - <li>Un éditeur de texte — dans les vidéos, nous utilisons <a href="http://www.sublimetext.com/">Sublime Text</a>, mais n'importe quel logiciel d'édition fera l'affaire. Si vous souhaitez développer nativement pour le web, vous pouvez essayer <a href="http://brackets.io/">Adobe Brackets</a>.</li> - <li>Un serveur local ou un serveur distant pour y envoyer les fichiers de démonstration.<em> Certaines applications de démonstration nécessitent une connexion HTTP au lieu d'une connexion locale.</em></li> -</ul> - -<h2 id="Introduction">Introduction</h2> - -<p>Interviennent dans cette série <a href="http://twitter.com/janjongboom">Jan Jongboom (@janjongboom)</a> et <a href="http://twitter.com/sergimansilla">Sergi Mansilla (@sergimansilla)</a> de Telenor Digital, de <a href="http://twitter.com/codepo8">Chris Heilmann (@codepo8)</a> de Mozilla; cette série a été tournée en trois jours à Oslo, en Norvège au siège social de Telenor, en février 2014.</p> - -<p>Voici les trois d'entre nous qui vous parleront de cette série et ce à quoi vous attendre:</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/bp87xaLI0h4?rel=0&html5=1"></iframe></div></div><p></p> - -<h2 id="Section_1_Construire_sa_première_application_Firefox_OS_et_la_publier">Section 1: Construire sa première application Firefox OS et la publier</h2> - -<p>Dans les cinq captures vidéos de la Section 1 nous vous montrons comment construire une application Firefox OS, comment la déboguer et la tester sur votre ordinateur — ainsi que sur un vrai appareil, et comment la mettre sur le <a href="/fr/Marketplace">Marketplace Firefox</a>. Cela peut sembler être une charge de travail fastidieuse mais vous découvrirez bien assez vite que si vous savez déjà comment construire un site web, vous avez déjà accompli 90% du travail.</p> - -<h3 id="Plus_qu'un_site_web">Plus qu'un site web</h3> - -<p>Les applications Firefox OS sont des applications HTML5. Par définition, elles utilisent les même technologies que les sites web. Vous pouvez commencer à écrire un site web et le transformer en application simplement en lui rajoutant un fichier manifeste (voir <a href="https://developer.mozilla.org/fr/Firefox_OS/Screencast_series:_App_Basics_for_Firefox_OS#Le_manifeste_d%27application">manifeste d'application</a> pour plus de détails). Ce dernier dit à Firefox OS que vous écrivez une application et vous permet de:</p> - -<ul> - <li>Intégrer l'application dans la liste du Marketplace</li> - <li>Avoir accès au matériel de l'appareil sur lequel il tourne, pour récupérer des informations comme <a href="/fr/docs/Using_geolocation">Utiliser la Géolocalisation</a> ou <a href="/fr/docs/WebAPI/Detecting_device_orientation">Détecter l'orientation de l'appareil</a>.</li> - <li>Et bien plus!</li> -</ul> - -<p>Par essence, les applications HTML5 sont des sites web suralimentées et devraient suivre les mêmes règles, comme:</p> - -<ul> - <li>Une amélioration progresssive: Vérifiez que ce que vous voulez utiliser est vraiment disponible avant d'essayer d'y avoir accès.</li> - <li>Adaptation à leur environnement: Par exemple en utilisant les <a href="/fr/docs/Web/CSS/Media_queries">Media queries</a> et des images <a href="https://developer.mozilla.org/en-US/Apps/Design/UI_layout_basics/responsive_design_building_blocks#Responsive_images.2Fvideo">Responsive</a> pour optimiser les applications sur différents écrans, résolutions et vitesse de connexion disponible.</li> - <li>Une utilisation de l'<a href="/fr/docs/Web/HTML">HTML</a>, du <a href="/fr/docs/CSS">CSS</a> et du <a href="/fr/docs/Web/JavaScript">JavaScript</a> comme technlogies centrale.</li> -</ul> - -<p>La principale différence est que pour qu'un site web devienne une bonne application, vous devriez vraiment prendre en compte les utilisateurs mobile. Cela signifie tout d'abord que votre application devrait:</p> - -<ul dir="ltr"> - <li><a href="/fr/Apps/Build/Hors-ligne">Fonctionner hors-ligne</a>.</li> - <li>Permettre à vos utilisateurs de faire une chose et d'avoir une interface qui permette de le faire facilement.</li> - <li>Soit peu consommatrice de batterie, et de ressources processeur.</li> -</ul> - -<p>Dans beaucoup de cas, cela signifie que vous devriez faire amincir votre page web et simplifier l'interface. La bonne nouvelle est que tous les utilisateurs en bénéficieront.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/fBJmUreevRU?rel=0&html5=1"></iframe></div></div><p></p> - -<div class="note"> -<p><strong>Note</strong>: Pour en apprendre plus sur le design d'une bonne application HTML5, regardez du coté de la page <a href="/fr/Apps">Applications [fr]</a>.</p> -</div> - -<h3 id="Le_manifeste_d'application">Le manifeste d'application</h3> - -<p>Le manifeste d'application dans Firefox OS est un simple fichier JSON qui donne des informations au système d'exploitation sur votre application. C'est lui qui transforme une page web en application web ouverte. Dans celui-ci, vous allez définir le nom et demander au système d'exploitation d'avoir accès à plusieurs services et au matériel. Vous pouvez aussi définir l'orientation apropriée pour votre application et si besoin, la verrouiller.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/txyux8RZrxY?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Plus d'informations sur le manifeste et les outils qui peuvent vous aider:</p> - -<ul> - <li>Le <a href="https://marketplace.firefox.com/developers/validator">Testeur de validité d'application</a>, aussi disponible en tant qu'<a href="http://firefox-marketplace-api.readthedocs.org/en/latest/">API</a>.</li> - <li>La documentation du <a href="/fr/Apps/Manifeste">MDN sur les manifestes d'application</a>. Incluant les informations sur comment servir un manifeste depuis votre propre serveur.</li> -</ul> - -<h3 id="Le_Gestionnaire_d'application">Le Gestionnaire d'application</h3> - -<p>La façon la plus simple de commencer avec Firefox OS est <a href="/fr/Firefox_OS/Using_the_App_Manager">d'utiliser le gestionnaire d'applications</a>. Cet outil fait parti des <a href="https://developer.mozilla.org/fr/docs/Outils">outils de développement de Firefox pour pc</a> et vous permet de vous connecter à un émulateur de Firefox OS tournant sur votre ordinateur, ou sur un véritable appareil Firefox OS si vous en possédez un. De là, vous pouvez jouer avec Firefox OS, installer des applications directement sur l'émulateur ou sur un vrai appareil, et les déboguer pendant qu'elle tournent sur Firefox OS. Ceci permettra de voir immédiatement les changements sans réinstaller ou mettre à jour les applications.</p> - -<p>La vidéo suivante montre les premiers pas avec le Gestionnaire d'application dans l'émulateur:</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/wiROpnExj-A?rel=0&html5=1"></iframe></div></div><p></p> - -<div class="note"> -<p><strong>Note</strong>: Le Gestionnaire d'application vous permet de déboguer sans problème vos applications même si vous êtes hors-ligne</p> -</div> - -<p>Pour plus d'informations sur le Gestionnaire d'application:</p> - -<ul> - <li>La documentation pour <a href="/fr/Firefox_OS/Using_the_App_Manager">utiliser le gestionnaire d'applications.</a></li> - <li>Une introduction dans un <a href="https://hacks.mozilla.org/2013/10/introducing-the-firefox-os-app-manager/">article de blog de Mozilla Hacks</a>.</li> -</ul> - -<h3 id="L'essayer_sur_votre_appareil">L'essayer sur votre appareil</h3> - -<p>Tester vos applications sur l'émulateur c'est bien, mais vous ne pourrez pas dépasser les limites de l'environnement d'émulation. Si vous voulez tester les performances d'interaction de votre appareil, ou le faire réagir à l'orientation, vous aurez besoin d'un vrai appareil. Avec le Gestionnaire d'application et les outils de développements, vous pouvez regarder en détail ce qu'il se passe dans votre application sur votre appareil pendant son utilisation.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/OIUQwqQMVZM?rel=0&html5=1"></iframe></div></div><p></p> - -<h3 id="Publier_sur_le_Marketplace">Publier sur le Marketplace</h3> - -<p>Le <a href="http://marketplace.firefox.com/">Marketplace de Firefox OS</a> est l'endroit qui convient le mieux pour ajouter votre application dans la liste et la rendre accessible aux autres personnes et à leur appareil ainsi que sur le Web. Le Marketplace vous permet aussi de mettre à disposition votre application sur d'autres plateformes comme Firefox Desktop et Firefox pour Android. Vous pouvez aussi permettre aux utilisateurs de noter votre application, vous donner des retours d'utilisation, et acheter votre application en utilisant un simple processus de vérification. Rajouter votre application est très simple:</p> - -<ul> - <li>Envoyez au marketplace l'URL de votre fichier manifeste.</li> - <li>Ajoutez une descirption de votre application (qui permettra aussi aux gens de la trouver parmis plusieurs autres.)</li> - <li>Mettre des captures d'écrans ou des vidéos pour faire des démonstrations des fonctionnalités de votre appareil.</li> - <li>Choisir une catégorie pour votre application.</li> - <li>Fournissez-nous une adresse email pour vous contacter.</li> - <li>Donnez à vos utilisateurs finaux un lien vers votre politique de confidentialité et un site de support web.</li> -</ul> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/gipaEJTM3TU?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Les applications soumises au Marketplace sont verifiées par l'équipe de vérification d'applications de Mozilla et vous serez notifié de l'état de votre soumission d'application dans les jours qui suivent. S'il y a des problèmes avec votre application vous recevrez un message durant la période de validation mais il se peut aussi que vous receviez des explications humaines de ce qui ne va pas et comment les réparer.</p> - -<div class="note"> -<p><strong>Note</strong>: Lisez <a href="/fr/docs/Apps/Publishing/Proposer_une_application">Proposer une application sur le Firefox Marketplace</a> pour plus d'informations sur le processus de soumission d'application.</p> -</div> - -<h2 id="Section_2_Sujets_avancés_du_Firefox_OS">Section 2: Sujets avancés du Firefox OS</h2> - -<p>Dans les première vidéos nous vous avons présenté Firefox OS et comment construire votre première application. Nous avons aussi expliqué comment déboguer votre application sur le pc, sur un vrai appareil et comment le proposer sur le Marketplace Firefox. Dans les cinq vidéos restantes nous allons aller plus loin dans l'explication des technologies qui permettent aux applications Firefox OS de gagner en puissance et vous donner accès aux fonctionnalités qui rendent le développement sur un smartphone ou une tablette intéressant pour les développeurs. Bien que certaines de ces technologies soient en cours de travaux sur le Firefox OS, elles sont toutes open-source et soumises aux standards. Travailler avec ces APIs aujourd'hui signifie que vous êtes prêt pour les prochains appareils et plateformes à venir.</p> - -<h3 id="APIs_Web">APIs Web</h3> - -<p>Les smartphones contiennent de puissantes technologies: cameras, accéléromètre et un GPS pour ne nommer qu'eux. Le problème est que celles-ci n'étaient pas accessible par les technologies web, mais en créant des applications natives. Pour réparer cela, Mozilla et ses partenaires ont définit des APIs pour permettre aux développeurs de contrôler le matériel des appareils mobiles en utilisant le JavaScript de manière sécurisée. Elles sont appelées les <a href="https://wiki.mozilla.org/WebAPI">Web APIs</a>, elles sont libres et peuvent être implémentées. Firefox OS est la première plateforme qui les utilisent, la vidéo suivante vous en dira plus:</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/p0DWpWNTd7w?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Plus d'informations sur les Web APIs:</p> - -<ul> - <li>La page de <a href="https://wiki.mozilla.org/WebAPI">Wiki de description</a> sur l'état de l'implémentation, qui comprend aussi des liens vers les standards auxquels elles sont rattachées.</li> - <li>Les articles sur <a href="https://hacks.mozilla.org/category/webapi/">Mozilla Hacks</a> traitant des Web APIs.</li> -</ul> - -<h3 id="Web_Activities">Web Activities</h3> - -<p><a href="https://wiki.mozilla.org/WebAPI/WebActivities">Web Activities</a> sont une alternative pour accéder au matériel d'un appareil. Au lieu d'utiliser une API pour communiquer directement avec l'appareil, les Web Activities vous permettent de créer un écosystème d'applications sur votre appareil qui communiqueront et partageront leur fonctionnalités. Par exemple, au lieu d'essayer d'accéder à la caméra directement, votre application peut utiliser une Web Activity pour demander une image et l'utilisateur utilisera son application favorite pour prendre une photo, qui sera ensuite envoyée à l'application correspondante.</p> - -<p>Au lieu de demander aux utilisateurs l'accès à leur matériel (ce qui, en terme de sécurité est important) vous leur permettrez d'utiliser les applications auxquelles ils font déjà confiance pour s'occuper de ces fonctionnalités. Mieux encore, vous pouvez enregistrer votre application pour accomplir certaines tâches dans le système d'exploitation. Vous pouvez comparer les Web Activities à un Clic droit sur un fichier sur votre ordinateur et choisir quelle application utiliser pour ouvrir le fichier. Vous avez accès à plusieurs choix dont une pour demander au système d'exploitation de toujours utiliser cette application pour ouvrir ce type de fichier.</p> - -<p>Les Web Activities permettent aux application de communiquer entre-elles, sur l'appareil, sans nécessiter de serveur entre. Tout ce qu'elles transmettent d'une application à l'autre sont les données finales.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/CQODL9AGKv0?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Plus d'informations sur les Web Activities:</p> - -<ul> - <li>La page de <a href="https://wiki.mozilla.org/WebAPI/WebActivities">Wiki sur les Web Activities.</a></li> - <li><a href="/en-US/docs/WebAPI/Web_Activities">La page de référence MDN sur les Web Activities</a></li> - <li>Une <a href="https://hacks.mozilla.org/2013/01/introducing-web-activities/">Introduction aux Web Activities</a> sur Mozilla Hacks. </li> -</ul> - -<h3 id="Push_Notifications">Push Notifications</h3> - -<p>Les Push Notifications, appelées en utilisant l'<a href="https://wiki.mozilla.org/WebAPI/SimplePush">API Web SimplePush</a>, sont un moyen de réveiller les applications quand un appareil reçoit un certain message. Cela vous permet de créer des applications qui peuvent rester éteintes, et donc qui économisent de la batterie, jusqu'à ce que vous en ayez besoin. Utiliser les notifications ainsi a aussi l'avantage de ne pas transporter de données. Ainsi Mozilla n'obtiendra jamais d'informations sur votre application et des attaquants potentiels ne pourront pas observer l'application.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/qpgNIsJ2pg4?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Plus d'information sur les Push Notifications utilisant SimplePush:</p> - -<ul> - <li>La page de Wiki <a href="https://wiki.mozilla.org/WebAPI/SimplePush">SimplePush</a></li> - <li><a href="/en-US/docs/WebAPI/Simple_Push">Le guide SimplePush sur MDN</a></li> - <li>Une <a href="https://hacks.mozilla.org/2013/07/dont-miss-out-on-the-real-time-fun-use-firefox-os-push-notifications/">introduction à SimplePush</a> sur Mozilla Hacks</li> -</ul> - -<h3 id="Fonctionnalités_hors-ligne">Fonctionnalités hors-ligne</h3> - -<p>Les applications ne sont que peu utilisées si elles ne fonctionnent pas hors-ligne. C'est pourquoi la plupart des utilisateurs préfèrent les appliations installées plutôt que d'ouvrir un navigateur et regarder du contenu sur leur navigateur web mobile. Le nom "application web" sous-entend même qu'il faut avoir une connexion pour pouvoir l'utiliser. Nos utilisateurs <strong>seront</strong> hors-ligne parfois (dans un avion, dans un métro, là où il n'y a pas de connexion vers leur carte SIM) et nous devons nous assurer que nos applications resteront utilisable quand ça arrivera. HTML5 propose plusieurs technologies qui proposent des fonctionnalités hors-ligne, principalement <a href="https://developer.mozilla.org/en-US/docs/HTML/Using_the_application_cache">AppCache</a> et <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/API/DOM/Storage">DOMStorage</a>.</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/dnuoUM_bIQM?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Plus d'informations sur les fonctionnalités hors-ligne:</p> - -<ul> - <li>La page de Wiki <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/API/DOM/Storage">DOMStorage</a>.</li> - <li>La page de Wiki <a href="https://developer.mozilla.org/en-US/docs/HTML/Using_the_application_cache">AppCache.</a></li> - <li><a href="https://developer.mozilla.org/en-US/docs/IndexedDB/Using_IndexedDB">Utiliser IndexedDB</a> pour un stockage avancé chez le client.</li> - <li>LocalForage est une surcouche utilisée dans Firefox OS pour fournir la simplicité de DOMStorage avec la puissance de IndexedDB (expliqué en détail dans cet article de <a href="https://hacks.mozilla.org/2014/02/localforage-offline-storage-improved/">Mozilla Hacks</a></li> -</ul> - -<h2 id="Où_en_trouver_plus">Où en trouver plus</h2> - -<p>Nous espèrons que cette série de vidéos vous aura donné une introduction claire pour construire vos premières applications web ouvertes. Si vous voulez en savoir plus, il existe quelques sources supplémentaires que vous pouvez regarder:</p> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/Z2yVFXEYnnc?rel=0&html5=1"></iframe></div></div><p></p> - -<ul> - <li>Le <a href="https://developer.mozilla.org/en-US/docs/Apps/">MDN App Center</a> explique comment faire un design et construire une bonne application web ouverte</li> - <li>Le <a href="/en-US/Marketplace">MDN Marketplace</a> contient des instructions détaillées pour voir votre application listée dans le Firefox Marketplace, les différentes options de publications ainsi que la gestion des paiements.</li> - <li>Le <a href="https://hacks.mozilla.org">Hacks Blog</a> écrit de façon hebdomadaire sur les applications Firefox OS (provenant de l'équipe Mozilla et des développeurs tiers comme vous) et les technologies de pointe. C'est le meilleur endroit pour savoir ce qu'il y aura dans les prochaines versions de Firefox OS)</li> - <li>La partie <a href="/en-US/Firefox_OS">Firefox OS du </a><a href="/en-US/Firefox_OS">MDN</a> et le wiki <a href="https://wiki.mozilla.org/B2G">B2G</a> proposent plus d'informations sur le système d'exploitation Firefox OS</li> - <li>Nous sommes souvent sur IRC, il suffit d'aller sur <a href="http://irc.mozilla.org">irc.mozilla.org</a> et de nous trouver aux canaux comme #devrel, #b2g, #openwebapps ou #marketplace.</li> -</ul> - -<p>En espérant vous voir par ici,</p> - -<p>Chris, Sergi et Jan</p> diff --git a/files/fr/archive/b2g_os/securite/application_security/index.html b/files/fr/archive/b2g_os/securite/application_security/index.html deleted file mode 100644 index 07b15909b5..0000000000 --- a/files/fr/archive/b2g_os/securite/application_security/index.html +++ /dev/null @@ -1,224 +0,0 @@ ---- -title: La sécurité des applications -slug: Archive/B2G_OS/securite/Application_security -tags: - - Apps - - Firefox OS - - Guide - - Mobile - - Security -translation_of: Archive/B2G_OS/Security/Application_security ---- -<div class="summary"> -<p><span id="result_box" lang="fr"><span class="hps">Cet article explique</span> en détail <span class="hps">le modèle de sécurité</span> <span class="hps">des application</span>s <span class="hps">Firefox</span> <span class="hps">OS</span><span>.</span></span></p> -</div> - -<p><span id="result_box" lang="fr"><span class="hps">Les</span> <span class="hps">contrôles de sécurité</span> <span class="hps">d'applications</span> <span class="hps">web</span> <span class="alt-edited hps">introduites dans</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">sont</span><span> les suivants :</span></span></p> - -<ul> - <li>Les applications web sont explicitement installées et lancées plutôt que simplement chargées depuis un navigateur. Les applications doivent être installées avant toute utilisation et les contrôles de sécurité régissent la mise à jour et la suppression des applications afin de protéger l'utilisateur.</li> - <li><span id="result_box" lang="fr"><span class="hps">L'accès aux nouvelles</span> <span class="hps">API web</span> <span class="hps">est contrôlé par un</span> <span class="hps">système de permissions</span><span>,</span> <span class="hps">où</span> <span class="hps">une application</span> <span class="hps">doit déclarer</span> <span class="hps">les</span> <span class="hps">autorisations</span> <span class="hps">qu'elle veut utiliser</span> <span class="hps">avant l'installation.</span> <span class="hps">Afin</span> <span class="hps">d'avoir accès à</span> certaines<span class="hps"> API</span>, <span class="hps">les</span> <span class="hps">applications</span> <span class="hps">doivent respecter certaines exigences</span> <span class="hps">et</span> <span class="hps">être examinées</span><span>, approuvées et</span> <span class="hps">signées par</span> <span class="hps">le Marketplace</span><span>.</span></span></li> - <li>Les applications web sont mises dans une <a href="https://fr.wikipedia.org/wiki/Sandbox_%28s%C3%A9curit%C3%A9_informatique%29">sandbox</a> afin qu'elles ne voient que leurs propres ressources (cookies, base de données IndexedDB, etc.). Même si deux applications chargent la même URL, ces deux pages ne seront pas considérées comme provenant de la même origine car elles sont en cours d'exécution sur des applications différentes.</li> -</ul> - -<h3 id="Types_d'applications">Types d'applications</h3> - -<p>Firefox OS supporte trois types d'applications : <strong>web</strong>, <strong>privilégiée</strong> et <strong>certifiée</strong>. Le type d'application est déclaré dans le <a href="/fr/Apps/Manifeste">manifeste d'application</a> et indique la liste des permissions que chaque application peut demander.</p> - -<ul> - <li><strong><strong>Application </strong>web :</strong> La plupart des applications tierces sont des applications "web". C'est le type par défaut qui ne nécessite pas d'autorisations supplémentaires en plus de celles déjà en place sur le web. Les applications web peuvent être installées à partir de n'importe quel site web, sans autre vérification. Elles peuvent aussi être <a href="https://developer.mozilla.org/fr/Marketplace/Options/Packaged_apps">empaquetées</a>, mais cela n'induira pas d'autres autorisations.</li> - <li><strong><strong><strong>Application p</strong></strong>rivilégiée</strong> : Les applications sont autorisées à demander des autorisations accrues. Ces applications privilégiées doivent être vérifiées et signées par le Marketplace.</li> - <li><strong><strong><strong>Application</strong></strong> certifiée : </strong>Les applications certifiées sont obligatoirement préinstallées sur le périphérique par le constructeur/opérateur qui diffuse le téléphone.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong> : Pour plus de détails sur les différents types d'applications, voir la documentation du <a href="https://developer.mozilla.org/fr/Apps/Manifeste#type">manifeste d'application</a>.</p> -</div> - -<h3 id="Mettre_une_application_à_disposition">Mettre une application à disposition</h3> - -<p>Sous Firefox OS, les applications peuvent être mises à disposition de deux façons différentes : hébergées ou empaquetées. Les applications web classiques peuvent être mises à disposition via deux mécanismes, les applications privilégiées et certifiées en revanche doivent être empaquetées.</p> - -<h4 id="Les_applications_hébergées"><span class="mw-headline" id="Hosted_apps">Les applications hébergée</span>s</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Une application</span> <span class="hps">hébergée</span> <span class="hps">est constituée uniquement</span> <span class="hps">d'un fichier</span><a href="https://developer.mozilla.org/fr/Apps/Manifeste"> <span class="hps">manifeste</span></a> <span class="hps">sur le serveur</span> <span class="hps">web</span> <span class="hps">du développeur,</span> <span class="hps">qui contient un</span> <a href="https://developer.mozilla.org/fr/Apps/Manifeste#launch_path"><span class="hps">launch_path</span></a> <span class="hps">pour</span> <span class="hps">indiquer quelles page</span>s <span class="hps">doivent figurer</span> <span class="hps">lorsque l'application</span> <span class="hps">est lancée</span><span>.</span> <span class="hps">D'un point de</span> <span class="hps">vue de la sécurité</span><span>,</span> <span class="hps">les applications</span> <span class="hps">hébergées</span> <span class="hps">fonctionnent </span> <span class="hps">presque comme des sites</span> <span class="hps">web</span> <span class="hps">normaux</span><span>.</span> Lorsqu'u<span class="hps">ne application</span> <span class="hps">hébergée est</span> <span class="hps">chargée</span><span>,</span> <span class="hps">se sont</span> <span class="hps">les URL</span> <span class="hps">« normales</span> <span class="hps">» de ces</span> <span class="hps">pages</span>, qui sont chargées. Elles sont <span class="hps">chargées depuis le serveur web, ou depuis </span><span class="hps">l'appareil</span> <span class="hps">si elles </span>étaient stockées<span class="hps"> dans un</span> <span class="hps">fichier cache</span><span>.</span></span></p> - -<h4 id="Les_applications_empaquetées"><span class="mw-headline" id="Packaged_apps">Les applications empaquetées</span></h4> - -<p><span id="result_box" lang="fr"><span class="hps">Une application</span> <span class="alt-edited hps">empaquetée</span> <span class="hps">est</span> <span class="hps">un application web ayant l'ensemble de ses </span><span class="hps">ressources</span> <span class="atn hps">(</span><span>HTML</span><span>,</span> <span class="hps">CSS</span><span>,</span> <span class="hps">JavaScript</span><span>, manifeste</span> <span class="hps">et</span> <span class="hps">ainsi de suite</span><span>)</span> <span class="hps">contenues dans</span> <span class="hps">un fichier zip</span><span> (les ressources ne sont pas présentes </span><span class="hps">sur</span> <span class="hps">un serveur web)</span><span>.</span> <span class="hps">Pour plus de détails</span> <span class="hps">sur ce format</span><span>,</span> <span class="hps">voir</span> <span class="hps">la page sur les <a href="https://developer.mozilla.org/fr/Marketplace/Options/Packaged_apps">applications empaquetées</a></span>. </span></p> - -<h3 id="Origine_de_l'application">Origine de l'application</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Pour les applications</span> <span class="hps">hébergées</span><span>,</span> <span class="hps">l'origine</span> <span class="hps">de l'application</span> correspond à<span class="hps"> l'origine</span> <span class="hps">du <a href="https://developer.mozilla.org/fr/Apps/Manifeste#origin">manifeste</a></span><a href="https://developer.mozilla.org/fr/Apps/Manifeste#origin"> <span class="hps">de l'application</span></a><span>.</span> </span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Pour</span> les<span class="hps"> applications</span> empacketées<span>,</span> l'<span class="hps">origine est affectée de façon unique à l'application lors de l'installation. </span><span class="hps">Les applications</span> <a href="https://developer.mozilla.org/fr/Apps/Publishing/Packaged_Apps#Types_of_packaged_apps"><span class="hps">privilégiées</span> <span class="hps">et</span> </a><span class="hps"><a href="https://developer.mozilla.org/fr/Apps/Publishing/Packaged_Apps#Types_of_packaged_apps">certifiées</a> peuvent</span> <span class="hps">également demander</span> <span class="hps">une origine</span> <span class="hps">spécifique</span> <span class="hps">en spécifiant le paramètre</span> <span class="hps"><a href="https://developer.mozilla.org/fr/Apps/Manifeste#origin">origin</a></span> <span class="hps">dans le fichier manifeste de l'application.</span> </span></p> - -<h3 id="Installation_de_l'application"><strong>Installation de l'application</strong></h3> - -<p>Les applications sont installées grâce à l'<a href="https://developer.mozilla.org/fr/Apps/API_JavaScript_Apps">API JavaScript Apps</a> :</p> - -<ul> - <li><span id="result_box" lang="fr"><span class="hps">Les applications hébergées</span><span> </span><span class="hps">sont installées</span> <span class="hps">en appelant</span><code> <span class="hps">navigator.mozApps.<a href="https://developer.mozilla.org/fr/docs/DOM/Apps.install">install</a></span></code> <span class="atn hps">(</span><code><span>manifestURL</span></code><span>)</span><span>,</span> <span class="hps">où</span> <code><span class="hps">manifestURL</span></code> <span class="hps">est une URL</span> <span class="hps">qui</span> définit<span class="hps"> l'emplacement</span> <span class="hps">de l'application</span><span>.</span> <span class="hps">Pour plus de détails</span><span>,</span> <span class="hps">voir la page sur</span> <span class="hps">l'<a href="https://developer.mozilla.org/fr/docs/DOM/Apps.install">installation d'applications</a></span><span>.</span> </span></li> - <li><span id="result_box" lang="fr"><span class="hps">Les applications empaquetées :</span> <span class="hps">elles</span><span class="hps"> sont</span> <span class="hps">installées</span> <span class="hps">en appelant<code> </code></span><code><span class="hps">navigator.mozApps.<a href="https://developer.mozilla.org/fr/docs/Web/API/Apps.installPackage">installPackage</a></span><span class="atn hps">(</span><span>PackageURL</span></code><span><code>)</code>.</span> <span class="hps">Pour</span> <span class="hps">les</span> <span class="hps">applications</span> empaquet<span class="hps">ées</span><span>,</span> le manifeste de <span class="hps">l'application principale</span> <span class="hps">est stocké dans</span> <span class="hps">le</span> <span class="hps">paquet lui-même</span><span>, de sorte qu'il</span> <span class="hps">est</span> <span class="hps">signé</span><span>.</span> <span class="hps">Il y a un deuxième</span> <span class="atn hps">« </span><span class="atn">mini-</span><span>manifeste</span><span> »</span><span>,</span><span class="hps"> utilisé pour démarrer</span> <span class="hps">le processus d'installation</span><span>.</span> <span class="hps">Voir l'<a href="https://developer.mozilla.org/fr/docs/Web/API/Apps.installPackage">installation</a></span><a href="https://developer.mozilla.org/fr/docs/Web/API/Apps.installPackage"> d'<span class="hps">applications</span> empaquetées</a><span class="hps"> et <a href="https://developer.mozilla.org/fr/Marketplace/Options/Packaged_apps">les applications</a></span><a href="https://developer.mozilla.org/fr/Marketplace/Options/Packaged_apps"> em<span class="hps">paquetées</span></a> <span class="hps">pour plus d'informations</span><span>.</span> </span></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Afin de garantir</span> qu'<span class="hps">une application</span> est bien installée comme une application web, il faut s'assurer que le site web ne trompe pas le mécanisme avec un manifeste d'application. Pour cela<span class="hps">, on vérifie que le type MIME du manifeste servi est </span><code>application/x-web-app-manifest+json</code><span>.</span> <span class="hps">Cette restriction</span> <span class="hps">est levée lorsque le manifeste de l'application a la même origine que la page demandant l'installation de l'application</span><span class="hps">.</span> </span></p> - -<h3 id="Mise_à_jour"><span class="mw-headline" id="Updates">Mise à jour</span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Le processus de</span> <span class="hps">mise à jour</span> <span class="hps">pour les applications</span> <span class="hps">est décrit</span> <span class="hps">à</span> <span class="hps">la page <a href="https://developer.mozilla.org/fr/Marketplace/Publishing/Updating_apps">mise à jour</a></span><a href="https://developer.mozilla.org/fr/Marketplace/Publishing/Updating_apps"> <span class="hps">des applications</span><span>.</span></a> </span></p> - -<h2 id="Autorisations">Autorisations</h2> - -<p><span id="result_box" lang="fr"><span class="hps">Les applications peuvent</span> avoir <span class="hps">des privilèges supplémentaires</span> <span class="hps">par rapport à </span><span class="hps">ceux</span> <span class="hps">accordés aux</span> <span class="hps">sites web</span> <span class="hps">normaux</span><span>.</span> <span class="hps">Par défaut</span>, <span class="hps">une application</span> <span class="hps">possède les</span> <span class="hps">mêmes autorisations qu'une page</span><span class="hps"> web</span> <span class="hps">normale</span><span>.</span> <span class="hps">Afin d'obtenir</span> <span class="hps">des autorisations supplémentaires</span><span>,</span> il faut tout d'abord lister les autorisations nécessaires dans le manifeste : </span></p> - -<h3 id="Déclaration_de_manifeste">Déclaration de manifeste</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Pour chaque</span> <span class="hps">autorisation supplémentaire</span><span>,</span> <span class="hps">le</span> <span class="hps">manifeste doit</span> <span class="hps">lister</span> <span class="hps">cette autorisation</span> ainsi qu'<span class="hps">une description</span> <span class="hps">lisible</span> <span class="hps">de</span> <span class="hps">la raison pour laquelle</span> <span class="hps">l'application</span> souhaite<span class="hps"> accéder à</span> <span class="hps">cette autorisation.</span> <span class="hps">Par exemple, si</span> <span class="hps">une application</span> <span class="hps">souhaite</span> <span class="hps">utiliser l'API</span> <span class="hps">de</span> <a href="https://developer.mozilla.org/fr/docs/Web/API/NavigatorGeolocation.geolocation"><span class="hps">navigator.geolocation</span></a><span>, le manifeste devra contenir le fragment suivant </span><span>:</span> </span></p> - -<pre class="brush: html">"permissions": { - "geolocation":{ -<code class="language-js"><span class="string token"> "description"</span><span class="punctuation token">:</span> <span class="string token">"Required for autocompletion in the share screen"</span><span class="punctuation token">,</span></code> - } -}, -</pre> - -<p>Cela permettra à l'application de demander la permission pour utiliser la géolocalisation (de la même manière qu'une page web). Pour plus de détails sur le fichier de manifeste, voir <a href="https://developer.mozilla.org/fr/Apps/Manifeste">manifeste d'application</a>.</p> - -<div class="note"> -<p><strong>Note </strong>: À l'heure actuelle, les descriptions des autorisations ne sont pas affichées : voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=823385" title="https://bugzilla.mozilla.org/show_bug.cgi?id=823385">bug 823385</a>.</p> -</div> - -<h3 id="Accorder_les_permissions"><span id="result_box" lang="fr"><span class="alt-edited hps">Accorder les permissions</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Lorsque les autorisations</span> <span class="hps">sont demandées dans</span> <span class="hps">le manifeste</span><span>, il y a deux modes pour activer les permissions : la demande ou l'activation par défaut. L'activation par défaut est mise en place grâce au manifeste, sans autre interaction. Les permissions demandées sont affichées lors de la première utilisation et l'utilisateur peut choisir d'autoriser ou non l'API</span><span class="hps">.</span> <span class="hps">En général</span><span>,</span> <span class="hps">Firefox</span> <span class="hps">OS </span>ne demande les autorisations que si celles-ci ont un impact sur la vie privée et qu'il est pertinent que l'utilisateur sache pourquoi l'API est utilisée<span>.</span> <span class="hps">Par exemple</span><span>, l'application demandera une permission pour accéder aux</span> <span class="hps">contacts</span><span>,</span> <span class="hps">mais</span> <span class="hps">l'établissement d'</span><span class="hps">une connexion</span> <span class="hps">TCP</span> <span class="hps">brut</span>e <span class="hps">est implicite</span>ment autorisé <span class="hps">car ici, il n'est pas nécessaire que l'utilisateur fournisse son accord. Lorsque les applications sont revues pour être intégrées au Marketplace</span>, l'utilisation des permissions est examinée afin d'assurer la protection des utilisateurs.</span></p> - -<h3 id="Révoquer_les_permissions"><span id="result_box" lang="fr"><span class="hps">Révoquer les permissions</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">À tout moment, les utilisateurs peuvent changer d'avis sur les permissions qui auront été demandées. Pour révoquer une permission, il faut aller dans l'application Paramètres. En revanche, les permissions activées par défaut ne sont pas paramétrables</span><span>.</span></span></p> - -<h2 id="Application_web_Sandbox">Application web Sandbox</h2> - -<h3 id="Stockage_des_données_par_application"><span id="result_box" lang="fr"><span class="hps">Stockage des données par application</span> </span></h3> - -<p>Chaque application s'exécute dans une <em>sandbox</em> de façon indépendante, ce qui signifie que toutes les données stockées par une application <span id="result_box" lang="fr"><span class="hps">sont séparées des données stockées par les autres applications. Parmi ces données, on retrouve </span></span>les cookies, les données locales et les autorisations liées au site.</p> - -<p><img alt="A diagram showing three Firefox OS apps all open is separate sandboxes, so none of them can affect each other." src="https://mdn.mozillademos.org/files/7091/sandbox.png" style="display: block; height: 437px; margin: 0px auto; width: 1040px;"></p> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Cela signifie que si</span> <span class="hps">l'utilisateur possède deux</span> <span class="hps">applications installées</span><span>,</span> <span class="hps">App</span>li <span class="hps">A et</span> <span class="hps">Appli B</span><span>,</span> <span class="hps">ces applications</span> <span class="hps">ne partageront pas les cookies</span><span class="hps">,</span> les <span class="hps">différentes</span> <span class="hps">données locales</span> <span class="hps">et</span> <span class="hps">les autorisations</span><span>.</span></span> Ceci s'applique également si ces deux applications ouvrent un <a href="/fr/docs/Web/HTML/Element/iframe" title="Cet élément prend en charge les attributs universels."><code><iframe></code></a> qui pointe vers la même origine. Par exemple, si <span id="result_box" lang="fr"><span class="hps">Appli</span> <span class="hps">A et</span> <span class="hps">Appli</span> B ouvrent<span class="hps"> un</span> <span class="hps"><iframe</span><span>></span> <span class="hps">pointant vers</span> <a href="http://www.mozilla.org"><span>http://www.mozilla.org</span></a><span>,</span> <span class="hps">elles iront toutes les deux sur ce site</span><span>,</span> <span class="hps">mais ce dernier sera récupéré et servi avec</span> <span class="alt-edited hps">des cookies distincts selon</span><span class="hps"> les</span> <span class="hps">deux</span> <span class="hps">applications</span><span>.</span></span></div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<p><span id="result_box" lang="fr"><span class="hps">Ainsi, si l'utilisateur se connecte sur F</span><span class="hps">acebook</span> <span class="hps">avec l'Appli A, cela n'aura aucun impact sur l'utilisation de Facebook par l'Appli B. </span><span class="hps">Le cookie</span> <span class="hps">de connexion</span> entre Facebook et l'Appli A n'est disponible que pour l'Appli A. Si l'Appli<span class="hps"> B</span> <span class="hps">ouvre un</span> <span class="hps"><iframe</span><span>></span> <span class="hps">pour Facebook</span><span>,</span> <span class="hps">le cookie</span> <span class="hps">ne sera pas disponible.</span> C'est pourquoi, <span class="hps">quand</span> <span class="hps">l'Appli</span> <span class="hps">B</span> <span class="hps">ouvre</span> <span class="hps">Facebook</span><span>, elle affichera la page de connexion plutôt que le compte de l'utilisateur.</span></span></p> - -<h3 id="Une_application_ne_peut_en_ouvrir_une_autre"><span class="mw-headline" id="Apps_can.27t_open_each_other">Une application ne peut en ouvrir une autre</span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Cela signifie</span> <span class="hps">que les applications</span> <span class="hps">ne peuvent pas</span> <span class="hps">ouvrir d'autres</span> <span class="hps">applications</span> <span class="hps">en utilisant</span> <span class="hps">les iframes</span><span>.</span> <span class="hps">Si</span> l'application <span class="hps">A crée</span> <span class="hps">une</span> <code><span class="hps"><iframe</span><span>></span></code> <span class="hps">dont le</span> <code><span class="hps">src</span></code> <span class="hps">correspond à l'URL de l'application B, cela n'ouvrira pas l'application B </span><span class="hps">dans l'</span><code><span class="hps"><iframe</span><span>></span></code><span>.</span> <span class="hps">Cela ouvrira uniquement le site web situé à cet emplacement. Elle n'utilisera aucun des cookies de l'application B et le comportement observé sera le même que si l'application n'était pas installée sur l'appareil de l'utilisateur</span><span>.</span></span></p> - -<p>Cela s'applique également aux applications empaquetées (voir ci-après pour plus d'informations). Si l'application A tente d'ouvrir l'application empaquetée B en utilisant un <code><iframe> </code>dirigeant vers l'URL <code>app://</code> de l'application B, celle-ci ne sera pas chargée. Cela provoquera une erreur 404 ou une autre erreur. Que l'application B soit installée ou non, cela échouera car l'application A ne peut pas détecter si l'application B est installée.</p> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">La</span> <span class="hps">même chose se produit</span> <span class="hps">si la frame de plus haut niveau </span><span class="hps">de l'application</span> <span class="hps">A est</span> dirigée <span class="hps">vers une URL</span> de <span class="hps">l'application</span> <span class="hps">B.</span> Pour chaque frame, le système connaît l'application ouverte, ainsi, toute tentative d'ouverture de l'application B depuis une frame de l'application A échouera comme décrit précédemment et l'application A ne pourra accéder à aucune des ressources de B<span>.</span></span></div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<h3 id="Les_raisons_de_ce_fonctionnement"><span class="mw-headline" id="Motivation">Les raisons de ce fonctionnement</span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Cette approche possède des avantages et des inconvénients. Un des premiers inconvénients est le suivant : </span><span class="hps">si</span> <span class="hps">l'utilisateur interagit avec</span> <span class="hps">le même site</span> <span class="hps">web à travers</span> <span class="hps">plusieurs</span> <span class="hps">applications</span><span>,</span> <span class="hps">il</span> <span class="hps">devra</span> <span class="hps">se connecter à</span> <span class="hps">toutes les applications</span><span>.</span> <span class="hps">De même, si</span> <span class="hps">un site web</span> <span class="hps">veut stocker</span> <span class="hps">des données localement</span> <span class="hps">et que</span> <span class="hps">l'utilisateur interagit avec</span> <span class="hps">ce site</span> <span class="hps">web</span> <span class="hps">parmi les différentes applications</span><span>,</span> <span class="hps">les</span> <span class="hps">données</span> <span class="hps">vont ainsi </span><span class="hps">se</span> <span class="hps">dupliquer pour </span><span class="hps">chaque application</span><span>. Cela peut poser problème lorsque le volume de données devient conséquent</span><span>.</span></span></p> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Le principal avantage</span> <span class="hps">de cette approche est</span> <span class="hps">qu'il s'agit d'un</span> <span class="hps">modèle</span> <span class="hps">plus stable</span><span>.</span> <span class="hps">Il est impossible</span> <span class="hps">que plusieurs</span> <span class="hps">applications</span> <span class="hps">interagissent</span> <span class="hps">les unes avec les</span> <span class="hps">autres par un</span> <span class="hps">site tiers</span> <span class="hps">de manière inattendue. Par exemple, l'installation d'une application ne peut pas empêcher le fonctionnement d'une autre application. </span><span class="hps">Quand</span> <span class="hps">une application</span> <span class="hps">est désinstallée</span>, les données utilisées par une autre application ne peuvent pas être supprimées. De même, la désinstallation d'une application ne pourra poser aucun problème de dépendance pour une autre application.</span></div> - -<div dir="ltr" style="zoom: 1;"> </div> - -<p><span id="result_box" lang="fr"><span class="hps">Cela permet aussi de bénéficier d'une meilleure </span><span class="hps">sécurité</span><span>.</span> <span class="hps">Un utilisateur peut</span> ainsi <span class="hps">utiliser son application SuperRéseauSocial pour se connecter à Facebook sans se soucier du fait que l'application DessineMoiUnMouton puisse exploiter des données tierces grâce à d'éventuelles failles du site</span><span>.</span></span></p> -</div> - -<p><span id="result_box" lang="fr"><span class="hps">Cela permet aussi de bénéficier de certains avantages en ce qui concerne la vie privée</span><span>.</span> <span class="hps">L'utilisateur peut</span> ainsi <span class="hps">installer</span> <span class="hps">l'application</span> <span class="hps">MonPartiPolitique <span id="result_box" lang="fr"><span class="hps">en toute sécurité</span> </span>sans se soucier du fait que </span>MonAppliProfessionnelle puisse détecter <span class="hps">les nouvelles données.</span></span></p> - -<h3 id="Isolement_des_permissions"><span class="mw-headline" id="Sandboxed_Permissions">Isolement des permissions</span></h3> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">De façon analogue aux données, les permissions sont isolées les unes des autres. Ainsi si l'application A </span><span class="hps">charge une page</span> <span class="hps">de</span> <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a> <span class="hps">et demande à l'utilisateur la permission d'utiliser la </span><span class="hps">géolocalisation, que l'utilisateur autorise la page et choisit </span><span class="hps">« oui</span><span>,</span> se souvenir de cette décision »<span>,</span> <span class="hps">cela signifie seulement</span> <span class="hps">que</span> <a href="http://maps.google.com"><span class="hps">http</span><span>:</span> <span class="hps">//maps.google</span> <span class="hps">com</span></a> <span class="hps">aura accès à</span> <span class="hps">la géolocalisation</span> depuis l'application A. Si l'application <span class="hps">B</span> utilise la page <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a><span>,</span> <span class="hps">cette page</span> <span class="hps">n'aura pas</span><span class="hps"> accès à</span> <span class="hps">la géolocalisation</span> sauf si<span class="hps"> l'utilisateur</span> <span class="hps">accorde</span> <span class="hps">à nouveau</span> la permission<span class="hps">.</span></span></div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">De façon semblable au navigateur, les permissions sont isolées selon l'origine</span><span>.</span> <span class="hps">Si</span> <span class="alt-edited hps">l'application A est autorisée à utiliser l'API Geolocation, cela ne signifie pas que toutes les origines présentes dans l'application A pourront utiliser l'API. Par exemple, si l'application A ouvre une </span><code><span class="hps"><iframe</span><span>></span></code> <span class="hps">ver</span>s <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a><span>,</span> <span class="hps">alors</span> <a href="http://docs.google.com"><span class="hps">http://docs.google.com</span></a> <span class="hps">devra demander la permission</span></span><span lang="fr"><span class="hps"> à l'utilisateur</span> <span class="hps">pour pouvoir utiliser l'API de géolocalisation</span><span>.</span></span></div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<h3 id="Sandbox_pour_l'API_Browser">Sandbox pour l'API Browser</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Pour sécuriser les applications qui ouvrent un grand nombre d'URL, comme les navigateurs, nous avons ajouté un indicateur (<em>flag</em>) </span><code> <span class="hps">browserContent</span></code><span>. </span><span class="hps">L'indicateur</span> <code><span class="hps">browserContent</span></code> <span class="hps">permet à chaque</span> <span class="hps">application</span> <span class="hps">d'avoir</span> <span class="hps">non pas un,</span> <span class="hps">mais</span> <span class="hps">deux</span> <span class="hps">bacs à sable (<em>sandboxes</em>) </span><span>:</span> <span class="hps">un pour</span> <span class="hps">l'application</span> <span class="hps">elle-même</span> <span class="hps">et l'autre pour</span> <span class="hps">tout le</span> <span>contenu web</span><span> ouvert par l'application.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Par exemple, si l'application monNavigateur est chargée depuis </span><span class="hps">https://monnavigateur.com</span><span class="hps">, les scripts et ressources seront chargées dans ce bac à sable, ils <em>appartiennent</em> à ce domaine.</span></span></p> - -<p><span id="result_box" lang="fr">Ensuite, <span class="hps">si une page</span> <span class="hps">de </span><span class="hps">l'application</span> <span class="hps">crée un</span> </span><code><iframe mozbrowser></code><span id="result_box" lang="fr"><span>,</span> <span class="alt-edited hps">une sandbox</span> <span class="hps">différente sera</span> <span class="hps">créée et utilisée</span> <span class="hps">pour cette</span> </span><code><iframe></code><span id="result_box" lang="fr"><span>. Cette sandbox sera différente de la première</span><span>.</span> <span class="hps">Ainsi, si cet </span></span><code><iframe></code><span id="result_box" lang="fr"> <span class="alt-edited hps">dirige vers</span> <span class="hps">https://monnavigateur.com</span><span>,</span> <span class="alt-edited hps">cela se traduira par</span> l'utilisation d'autres cookies pour cet </span><code><iframe mozbrowser></code>. <span id="result_box" lang="fr"><span class="hps">De même</span><span>,</span> <span class="hps">le contenu</span> <span class="hps">à l'intérieur de</span> <span class="hps">la</span> </span><code><iframe mozbrowser></code><span id="result_box" lang="fr"> <span class="hps">verra</span> <span class="hps">des données locales différentes de celles correspondant à l'application</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Ceci s'appliquera également si</span> <span class="hps">l'application</span> </span>monNavigateur souhaite intégrer des fonctionnalités de Google Maps<span id="result_box" lang="fr"> pour proposer des outils de navigation basés sur la géo<span class="hps">localisation</span><span>.</span> <span class="hps">Ainsi, si l'application</span> <span class="hps">ouvre</span> <span class="hps">un</span> </span><code><iframe></code><span id="result_box" lang="fr"> <span class="hps">vers</span> <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a><span>, il</span> <span class="hps">recevra</span> <span class="hps">un ensemble</span> <span class="hps">de cookies</span> <span class="hps">pour</span> <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a><span class="hps">.</span> <span class="hps">Si</span> <span class="hps">l'utilisateur navigue</span> <span class="hps">alors</span> <span class="hps">à l'intérieur du</span> </span><code><iframe mozbrowser></code><span id="result_box" lang="fr"> <span class="hps">contenant</span> <a href="http://maps.google.com"><span class="hps">http://maps.google.com</span></a><span>,</span> <span class="hps">cela</span> <span class="hps">utilisera</span> <span class="hps">différents cookies</span> <span class="hps">et</span> d'autres autorisations au niveau le plus haut de l'application<span>.</span></span></p> - -<p>Voici un autre scénario où cela peut être utile : l'application Yelp. Cette application permet d'ouvrir différents sites Internet de restaurants. En utilisant <code><iframe mozbrowser>, </code><span id="result_box" lang="fr"><span class="hps">afin d'ouvrir le site</span> <span class="hps">du restaurant,</span> <span class="hps">l'application Yelp</span> <span class="hps">s'assure</span> <span class="hps">que le site web</span> <span class="hps">du restaurant</span> <span class="hps">ne contiendra pas d'</span></span><code><iframe></code><span id="result_box" lang="fr"> <span class="hps">pointant vers</span> <span class="atn hps">l'</span><span>application</span> <span class="hps">Yelp. En effet, si le site du restaurant pointe d'une certaine façon vers</span> <span class="hps">http://yelp.com</span><span>, il « verra » le site web Yelp plutôt que l'application. Ainsi, il est théoriquement impossible que le site du restaurant attaque les données de l'application Yelp.</span></span></p> - -<h2 id="Résumé_sur_la_sécurité_des_applications">Résumé sur la sécurité des applications</h2> - -<div class="almost_half_cell" id="gt-res-content"> -<div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Le tableau</span> <span class="hps">ci-dessous résume</span> <span class="hps">les</span> <span class="atn hps">différents types d'</span><span>applications</span> <span class="hps">de Firefox</span> <span class="hps">OS</span> <span class="hps">et</span> <span class="hps">décrit le format</span><span>, l'installation et</span> <span class="hps">les processus</span> <span class="hps">de mise à jour</span> <span class="hps">pour les applications</span> web <span class="hps">fonctionnant sur</span> <span class="hps">Firefox</span> <span class="hps">OS</span><span>.</span></span></div> - -<div dir="ltr" style="zoom: 1;"> </div> -</div> - -<table> - <caption>Les types d'application web</caption> - <thead> - <tr> - <th scope="col">Type</th> - <th scope="col">Mise à disposition</th> - <th scope="col" style="text-align: center;">Modèle d'autorisations</th> - <th scope="col">Installation</th> - <th scope="col">Mise à jour</th> - </tr> - </thead> - <tbody> - <tr> - <td>Web</td> - <td style="text-align: center;">Hébergée ou empaquetée</td> - <td>Les permissions les moins sensibles qui ont le moins d'impact lorsqu'un contenu web non autorisé est exposé</td> - <td>Peut être installée depuis n'importe où</td> - <td> - <div class="almost_half_cell" id="gt-res-content"> - <div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Peut être</span> <span class="hps">mis à jour</span> <span class="hps">de façon transparente pour</span> <span class="hps">l'utilisateur</span> <span class="hps">ou explicitement</span> grâce au Ma<span class="alt-edited hps">rketplace</span><span>,</span> en fonction de l'emplacement où <span class="hps">l'application a été</span> <span class="alt-edited hps">installée</span> <span class="hps">et du mécanisme</span> <span class="hps">de livraison</span></span></div> - </div> - </td> - </tr> - <tr> - <td>Privilégié</td> - <td>Empaquetée ou signée</td> - <td>Les API privilégiées ont besoin d'une validation et d'une authentification de l'application</td> - <td>Doit être installée depuis le Marketplace</td> - <td><span id="result_box" lang="fr"><span class="hps">Mise à jour</span> <span class="hps">via</span> <span class="alt-edited hps">un Marketplace</span> <span class="hps">de confiance</span><span class="alt-edited">, l'utilisateur est</span> <span class="hps">invité à</span> <span class="hps">approuver</span> <span class="hps">le téléchargement</span> <span class="hps">et l'installation</span> <span class="hps">des mises à jour</span></span></td> - </tr> - <tr> - <td>Certifié</td> - <td>Empaquetée</td> - <td> - <div class="almost_half_cell" id="gt-res-content"> - <div dir="ltr" style="zoom: 1;"><span id="result_box" lang="fr"><span class="hps">Les API</span> <span class="hps">puissantes</span> <span class="hps">et</span> <span class="hps">dangereuses</span> <span class="hps">ne sont pas disponibles</span> <span class="hps">pour</span> <span class="hps">les applications tierces</span></span></div> - </div> - </td> - <td>L'application est préinstallée sur l'appareil</td> - <td><span id="result_box" lang="fr"><span class="hps">Mise à jour</span> <span class="hps">uniquement dans le cadre</span> <span class="hps">des mises à jour du </span><span class="hps">système</span></span></td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note </strong>: <span id="result_box" lang="fr"><span class="hps">Pour la version</span> <span class="hps">1.0</span> <span class="hps">de</span> <span class="hps">Firefox</span> <span class="hps">OS</span><span>,</span> <span class="hps">bien que</span> <span class="hps">les applications web</span> <span class="hps">puissent être installées</span> <span class="hps">depuis n'importe quel site ou Marketplace, certaines applications priv</span><span class="hps">ilégiées</span> <span class="hps">ne peuvent être</span> <span class="hps">installées que depuis le</span> <span class="alt-edited hps">Marketplace</span> <span class="hps">de Mozilla</span><span>. La gestion des autres Marketplace de confiance n'est pas encore finalisée</span><span>.</span></span></p> -</div> - -<p> </p> diff --git a/files/fr/archive/b2g_os/securite/index.html b/files/fr/archive/b2g_os/securite/index.html deleted file mode 100644 index d57b968b65..0000000000 --- a/files/fr/archive/b2g_os/securite/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Sécurité dans Firefox OS -slug: Archive/B2G_OS/securite -tags: - - Firefox OS - - Mobile - - Sécurité -translation_of: Archive/B2G_OS/Security ---- -<p>Les articles suivants sont relatifs à la sécurité de Firefox OS. Ceci inclut les fonctionnalités de sécurité liées au système, la sécurité des applications, les processus d'installation d'applications sécurisés...</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation" name="Documentation">Documentation à propos de la sécurité dans Firefox OS</h2> - - <dl> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/Security_model" title="/en-US/docs/Mozilla/Firefox_OS/Security/Security_model">Le modèle de sécurité de Firefox OS</a></dt> - <dd>Un aperçu du modèle de sécurité de Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/System_security" title="/en-US/docs/Mozilla/Firefox_OS/Security/Security_model">Sécurité du système</a></dt> - <dd>Détails des mécanismes de sécurité directement inclus dans Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security" title="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security">Sécurité des applications dans Firefox OS</a></dt> - <dd>Un aperçu de la manière dont les applications sont sécurisées dans Firefox OS.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/Installing_and_updating_applications" title="/en-US/docs/Mozilla/Firefox_OS/Security/Installing_and_updating_applications">Installation et mise à jour sécurisée des applications</a></dt> - <dd>Comment Firefox OS installe et met à jour les applications de manière sécurisée.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/Software_permissions" title="/en-US/docs/Mozilla/Firefox_OS/Security/Software_permissions">Permissions logicielles dans Firefox OS</a></dt> - <dd>Un guide expliquant quelles sont les permissions requises par différents types d'applications pour qu'elles puissent réaliser certaines tâches.</dd> - <dt><a href="/en-US/docs/Mozilla/Firefox_OS/Security/Debugging_and_security_testing#Marionette.3A_A_JavaScript_debugging_shell_for_Firefox_OS" title="/en-US/docs/Mozilla/Firefox_OS/Security/Debugging_and_security_testing#Marionette.3A_A_JavaScript_debugging_shell_for_Firefox_OS"><span style="display: none;"> </span>Déboguer et tester la sécurité avec Firefox OS</a></dt> - <dd>Ce guide vous montre les étapes basiques du test de la sécurité. De l'ouverture d'un débogueur JavaScript à distance pour mettre en place un proxy d'interception HTTP(S) contre une version ordinateur de Firefox OS.</dd> - </dl> - - <p><span class="alllinks"><a href="/fr/docs/tag/B2G" title="/en-US/docs/tag/B2G">Voir tout...</a></span></p> - </td> - <td> - <h2 class="Community" id="Community" name="Community">Obtenir de l'aide de la communauté</h2> - - <p>Si vous travaillez avec Firefox OS ou développez des applications que vous aimeriez voir fonctionner sur des appareils Firefox OS, des ressources communautaires sont à votre disposition !</p> - - <ul> - <li>Consultez le forum du projet Boot to Gecko : <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-b2g"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.b2g"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.b2g/feeds"> Flux de syndication</a></li> -</ul></li> - </ul> - - <ul> - <li>Posez votre question sur le canal IRC de Mozilla : <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a></li> - </ul> - - <p><span class="alllinks"><a class="external" href="http://www.gnurou.org/writing/smartquestionsfr" title="http://www.gnurou.org/writing/smartquestionsfr">N'oubliez pas la <em>netiquette</em></a> pour poser vos questions…</span></p> - - - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Articles similaires</h2> - - <ul> - <li><a href="/fr/docs/Mobile" title="en-US/docs/Mobile">Mobile</a></li> - <li><a href="/fr/docs/Sécurité" title="/en-US/docs/Security">Securité</a></li> - </ul> - </td> - </tr> - </tbody> -</table> - -<p> </p> - -<div id="cke_pastebin" style="position: absolute; top: 483px; width: 1px; height: 1px; overflow: hidden; left: -1000px;"><br> -Firefox OS</div> diff --git a/files/fr/archive/b2g_os/securite/installing_and_updating_applications/index.html b/files/fr/archive/b2g_os/securite/installing_and_updating_applications/index.html deleted file mode 100644 index e133d1e6d2..0000000000 --- a/files/fr/archive/b2g_os/securite/installing_and_updating_applications/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Installation et mise à jour d'applications -slug: Archive/B2G_OS/securite/Installing_and_updating_applications -tags: - - Apps - - Firefox OS - - Guide - - Installation - - Mise à jour -translation_of: Archive/B2G_OS/Security/Installing_and_updating_applications ---- -<div class="summary"> -<p><span class="seoSummary">Cet article constitue un guide sur le processus de mise à jour des application Firefox OS.</span></p> -</div> - -<h2 id="Vue_d'ensemble_de_l'implémentation">Vue d'ensemble de l'implémentation</h2> - -<h3 id="Types_d'applications">Types d'applications</h3> - -<p>Il existe de base trois catégories d'applications qui peuvent être mises à jour en utilisant ce mécanisme :</p> - -<dl> - <dt>Applications centrales</dt> - <dd>Les applications centrales (celles qui sont livrées comme faisant partie du système Firefox OS de base, comme Téléphone) sont empaquetées, certifiées, pré-installées et non supprimables. Elles ne peuvent être mises à jour que lors de la mise à niveau du système complet ou d'une mise à jour des couches Gonk et Gaia.</dd> - <dt>Applications installées par l'utilisateur</dt> - <dd>Les applications installées par l'utilisateur sont soit empaquetées, soit hébergées. La politique de mise à jour est le principal sujet de cet article.</dd> - <dt>Applications tierces pré-installées</dt> - <dd>Ces applications sont pré-installées par l'opérateur ou le fabricant, mais ne font pas partie du cœur du système d'exploitation de la plate-forme. Leur mise à jour est soumise aux mêmes règles et conventions que pour les applications installées par l'utilisateur.</dd> -</dl> - -<h3 id="Suppositions_concernant_les_utilisateurs">Suppositions concernant les utilisateurs</h3> - -<p>Pour au moins les premières versions de Firefox OS, les hypothèses suivantes sont prises en compte à propos des utilisateurs :</p> - -<ul> - <li>Les transferts de données sont lents, onéreux, et intentionnellement limités ; en d'autres termes, nous partons du principe que l'utilisateur dispose d'une connexion de données lente et que la quantité de trafic autorisée chaque mois est limitée.</li> - <li>Nous supposons que l'utilisateur n'a que rarement ou pas du tout accès au WiFi ; la plupart des mises à jour seront effectuées via la connexion de données cellulaires.</li> - <li>Les appareils sont rarement en itinérance.</li> - <li>Les utilisateurs laissent le service de données mobiles désactivé par défaut, ils ne l'activent que pour réaliser certaines transactions.</li> - <li>Les utilisateurs possèdent et utilisent plusieurs cartes SIM.</li> -</ul> - -<p>Toutes ces conditions utilisateurs sont répandues dans beaucoup de pays, il paraît donc juste de faire de telles hypothèses. Notre objectif est d'essayer d'optimiser l'expérience utilisateur lors des mises à jour pour les personnes concernées par celles-ci. En général, ces suppositions n'auront pas d'impact négatif sur les utilisateurs qui disposent d'un accès WiFi rapide et pas cher.</p> - -<h3 id="Paramètres_de_conception_technique">Paramètres de conception technique</h3> - -<p>Cette section aborde quelques principes de conception pour l'implémentation des mises à jour d'applications dans Firefox OS :</p> - -<ul> - <li>Pour l'instant, l'appareil va régulièrement consulter le Marketplace pour chercher des mises à jour ; nous évaluerons plus tard la possibilité pour les mises à jour d'être envoyées automatiquement.</li> - <li>Le Marketplace connaîtra la version actuelle de chaque application.</li> - <li>Les mises à jour peuvent être téléchargées et installées alors que la version actuelle de l'application est ouverte, et cela avec un faible risque de casser l'application en cours d'exécution.</li> -</ul> - -<h3 id="Considérations_pour_les_développeurs">Considérations pour les développeurs</h3> - -<p>Il y a plusieurs choses dont les développeurs doivent prendre en considération, compte-tenu du modèle de mise à jour des applications :</p> - -<ul> - <li>Les développeurs Web sont habitués aux utilisateurs qui sont toujours sur la dernière version de leurs sites ; garder les applications à jour imite ce modèle.</li> - <li>La sécurité est aussi améliorée lorsqu'il y a le plus possible d'utilisateurs à jour.</li> -</ul> - -<h2 id="Expérience_utilisateur">Expérience utilisateur</h2> - -<h3 id="Principes_de_conception">Principes de conception</h3> - -<p>Afin de bénéficier de la meilleure expérience utilisateur possible lors de la mise à jour des applications, quelques principes essentiels doivent être gardés à l'esprit :</p> - -<ul> - <li>Les mises à jour doivent avoir un impact minimal sur l'utilisateur ; ne pas l'interrompre plus que nécessaire, ne pas nuire à sa vitesse de connexion, et ainsi de suite.</li> - <li>Ne pas laisser à l'utilisateur la charge de mettre à jour ses applications.</li> - <li>Minimiser les conséquences en cas d'échec de la mise à jour.</li> - <li>Prendre en charge la compatibilité ascendante pour les utilisateurs qui ne peuvent pas mettre à jour leurs applications ou qui ne peuvent pas le faire souvent.</li> - <li>Éviter de présenter aux utilisateurs des détails techniques qui ne sont pas nécessaires.</li> -</ul> - -<h3 id="Types_de_mises_à_jour">Types de mises à jour</h3> - -<p>Il existe trois types basiques de mise à jour :</p> - -<dl> - <dt>Manuel : individuel</dt> - <dd>Une mise à jour d'une unique application, à l'initiative de l'utilisateur</dd> - <dt>Manuel : lot</dt> - <dd>Une mise à jour de plusieurs applications en une seule fois, à l'initiative de l'utilisateur</dd> - <dt>Silencieuse</dt> - <dd>Une mise à jour en arrière-plan, automatisée</dd> -</dl> diff --git a/files/fr/archive/b2g_os/securite/security_model/index.html b/files/fr/archive/b2g_os/securite/security_model/index.html deleted file mode 100644 index 77e0212528..0000000000 --- a/files/fr/archive/b2g_os/securite/security_model/index.html +++ /dev/null @@ -1,396 +0,0 @@ ---- -title: Présentation de la sécurité de Firefox OS -slug: Archive/B2G_OS/securite/Security_model -translation_of: Archive/B2G_OS/Security/Security_model ---- -<div class="summary"> -<p>Ce document donne un aperçu du cadre de la sécurité de Mozilla Firefox OS, qui est conçu pour protéger les appareils mobiles contre les menaces de la plateforme, des applications et des données. Dans le Firefox OS, Mozilla a mis en place un modèle de sécurité globale, intégrée et multicouche qui offre une protection best-of-breed contre les risques de sécurité pour les téléphones mobiles.</p> -</div> - -<h2 id="Sécurité_de_la_plate-forme">Sécurité de la plate-forme</h2> - -<p><span id="result_box" lang="fr"><span class="hps">La plate-forme</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">utilise</span> <span class="hps">un modèle de sécurité</span> <span class="hps">multi-couches</span> <span class="hps">qui est conçu pour</span> <span class="hps">atténuer les risques</span> <span class="hps">d'exploitation</span> <span class="hps">à tous les niveaux</span><span>. Une </span></span>première ligne de <span id="result_box" lang="fr"><span class="hps">contre-mesures </span></span>combinée avec une stratégie de sécurité en profondeur offrent une protection complète contre les menaces.</p> - -<h3 id="L'architecture_sécurisée">L'architecture sécurisée</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Le</span> <span class="hps">système d'exploitation Firefox</span> <span class="hps">OS connecte</span> <span class="hps">des applications Web</span> <span class="hps">au</span> <span class="hps">matériel sous-jacent</span><span>.</span> <span class="hps">C</span>'<span class="hps">est une</span> <span class="hps">technologie de pile</span> <span class="hps">intégrée, composée</span> <span class="hps">des niveaux suivants</span><span>:</span></span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5023/platform.png" style="height: 478px; width: 678px;"></p> - -<ul> - <li> - <div id="gt-src-tools"> - <div id="tts_button"><span id="result_box" lang="fr"><span class="hps">Gaia</span><span>:</span> <span class="hps">La</span> <span class="hps">suite d'applications</span> <span class="hps">Web</span> <span class="hps">qui composent</span> <span class="hps">l'expérience utilisateur</span> <span class="atn hps">(les </span><span>applications</span> <span class="hps">se composent de</span> <span class="hps">HTML5</span><span>,</span> <span class="hps">CSS</span><span>,</span> <span class="hps">JavaScript</span><span>,</span> <span class="hps">les images</span><span>, les médias</span><span>,</span> <span class="hps">et ainsi de suite</span><span>)</span><span>.</span></span></div> - </div> - </li> - <li><span id="result_box" lang="fr"><span class="hps">Gecko</span><span>:</span> <span class="hps">La couche</span> <span class="hps">d'exécution</span> <span class="hps">d'application qui fournit</span> <span class="hps">le cadre</span> <span class="hps">pour l'exécution</span> <span class="hps">de</span> <span class="hps">l'application</span><span>,</span> <span class="hps">et met en œuvre</span> <span class="hps">les API</span> <span class="hps">Web utilisées pour</span> <span class="hps">accéder à des fonctions</span> <span class="hps">dans l'appareil mobile</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Gonk</span><span>:</span> <span class="hps">Le noyau</span> <span class="hps">Linux sous-jacent</span><span>,</span> <span class="hps">les bibliothèques du système</span><span>, le micrologiciel</span> <span class="hps">et les pilotes de périphériques</span> que <span class="hps">tout ce qui fonctionne </span><span class="hps">au-dessus</span><span>.</span></span></li> - <li>Le dispositif mobile: <span id="result_box" lang="fr"><span class="hps">Le téléphone</span> <span class="hps">mobile fonctionnant</span> <span class="hps">avec Firefox</span> <span class="hps">OS</span><span>.</span></span></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Gecko</span> <span class="hps">est le </span></span><span class="short_text" id="result_box" lang="fr"><span class="alt-edited">contrôleur d'accès</span></span><span lang="fr"> <span class="hps">qui applique</span> <span class="hps">les politiques de sécurité</span> <span class="atn hps">destinées à protéger l'</span><span>appareil mobile</span> <span class="hps">d'une mauvaise utilisation</span><span>.</span> <span class="hps">La couche</span> <span class="hps">Gecko</span> <span class="hps">agit comme</span> <span class="hps">intermédiaire entre</span> <span class="hps">les applications web</span> <span class="atn hps">(</span><span>à la</span> <span class="hps">couche</span> <span class="hps">Gaia</span><span>)</span> <span class="hps">et le téléphone</span><span>.</span> <span class="hps">Gonk</span> <span class="hps">offre des caractéristiques</span> <span class="hps">du matériel du</span> <span class="hps">téléphone mobile</span> <span class="hps">sous-jacent</span> <span class="hps">directement à la couche</span> <span class="hps">Gecko</span><span>. </span><span class="hps">Les applications</span> <span class="hps">Web accèdent à</span> <span class="hps">des fonctionnalités du téléphone</span> <span class="hps">mobile uniquement</span> <span class="hps">via les API</span> <span class="hps">Web</span><span>,</span> <span class="hps">et seulement si</span> <span class="hps">Gecko</span> <span class="hps">permet</span> <span class="hps">la demande d'accès</span> </span>— <span lang="fr"><span class="hps">il n'y a</span> <span class="hps">pas d'accès direct</span><span>,</span> <span class="hps">pas de</span> <span class="hps">«porte arrière»</span> <span class="hps">dans le téléphone</span><span>.</span> <span class="hps">Gecko</span> <span class="hps">applique des autorisations</span> <span class="hps">et empêche l'accès</span> <span class="hps">aux demandes</span> <span class="hps">non autorisées</span><span>.</span></span></p> - -<h3 id="le_déploiement_du_système">le déploiement du système</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">est livré installé</span> <span class="hps">sur un</span> <span class="hps">téléphone intelligent</span></span>. <span id="result_box" lang="fr"><span class="hps">L'image du système</span> <span class="hps">d'origine est créée</span> <span class="hps">par une</span> <span class="hps">source de confiance</span> <span class="hps">connue</span></span> — <span id="result_box" lang="fr"><span class="hps">habituellement le OEM</span></span> (<span class="lang-en" lang="en">Original Equipment Manufacturer)</span> <span id="result_box" lang="fr"><span class="hps">de l'appareil </span></span>— <span id="result_box" lang="fr"><span class="hps">qui est</span> <span class="hps">responsable de l'assemblage</span><span>, la construction</span><span>, les tests et</span> <span class="hps">la signature numérique de</span> <span class="hps">l'emballage</span> <span class="hps">de distribution</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Les mesures de sécurité</span> <span class="hps">sont utilisées dans</span> <span class="hps">la pile de</span> <span class="hps">technologie.</span> Les <span class="hps">privilèges</span> <span class="hps">du système de fichiers</span> <span class="hps">sont appliqués par</span> <span class="hps">les</span> <span class="hps">listes</span> <span class="hps">de contrôle d'accès</span> <span class="hps">de</span> <span class="hps">Linux</span> <span class="hps">(les</span> <span class="hps">ACL)</span><span>.</span> Les a<span class="hps">pplications</span> <span class="hps">du système sont</span> <span class="hps">installées</span> <span class="hps">sur un support de stockage qui</span> <span class="hps">est en lecture seule</span> <span class="atn hps">(</span><span>sauf pendant</span> <span class="hps">les mises à jour</span><span>,</span> <span class="hps">quand il</span> <span class="hps">est temporairement</span> <span class="hps">en lecture-écriture</span><span>)</span><span>;</span> <span class="hps">généralement</span> il n'y a <span class="hps">que les zones contenant</span> <span class="hps">le contenu</span> <span class="hps">de l'utilisateur qui peuvent être</span> <span class="hps">en lecture-écriture</span><span>.</span> <span class="hps">Divers composants</span> <span class="hps">dans le</span> <span class="hps">matériel de l'appareil</span> <span class="hps">sont équipés de</span> <span class="hps">protections</span> <span class="hps">qui sont</span> <span class="hps">mises en œuvre par</span> <span class="hps">défaut</span> <span class="hps">en tant que pratique</span> <span class="hps">standard de l'industrie</span> <span class="hps">-</span> <span class="hps">les fabricants de puces</span><span>, par exemple</span><span>,</span> <span class="hps">employent des</span> <span class="hps">techniques</span> <span class="hps">de durcissement</span> <span class="hps">pour réduire les vulnérabilités</span><span>.</span> <span class="hps">La plate-forme</span> <span class="hps">de base</span> <span class="atn hps">(</span><span>Gecko</span> <span class="hps">et</span> <span class="hps">Gonk</span><span>)</span> <span class="hps">est durcie</span> <span class="hps">pour renforcer</span> <span class="hps">sa défense</span> <span class="hps">contre les menaces potentielles</span><span>,</span> <span class="hps">et les caractéristiques</span> <span class="hps">de durcissement</span> <span class="hps">du</span> <span class="hps">compilateur sont utilisées</span> <span class="hps">le cas échéant</span><span>.</span> <span class="hps">Pour plus de</span> <span class="hps">détails, voir</span> </span><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Security/Runtime_security" title="/en-US/docs/Mozilla/Firefox_OS/Security/Runtime_security">Runtime security</a>.</p> - -<h3 id="Mises_à_jour_de_Système_Sécurisé">Mises à jour de Système Sécurisé</h3> - -<p>Les mises à jour ultérieures et les correctifs de la plate-forme Firefox OS sont déployés en utilisant un processus Mozilla sécurisé qui garantit l'intégrité continue de l'image du système sur le téléphone mobile. <span id="result_box" lang="fr"><span class="hps">La mise à jour</span> <span class="hps">est créée par une entité </span><span class="hps">connue</span><span>,</span> <span class="hps">une source de confiance</span> <span class="hps">-</span> <span class="hps">habituellement le</span> <span class="hps">OEM</span> <span class="hps">de l'appareil</span> <span class="hps">-</span> <span class="hps">qui est</span> <span class="hps">responsable de l'assemblage</span><span>, la construction</span><span>, les tests et</span> <span class="hps">la signature numérique</span> <span class="hps">du paquet</span> <span class="hps">de mise à jour</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Les mises à jour</span> <span class="hps">du système peuvent</span> <span class="hps">concerner tout ou</span> <span class="hps">une partie</span> <span class="hps">de la pile</span> <span class="hps">Firefox</span> <span class="hps">OS</span><span>. </span><span class="hps">Si des changements</span> <span class="hps">à</span> <span class="hps">Gonk</span> <span class="hps">sont inclus dans</span> <span class="hps">la mise à jour</span><span>,</span> cependant <span class="hps">FOTA</span> <span class="hps">(Firmware</span> <span class="hps">Over The Air</span><span>)</span> <span class="hps">est</span> <span class="hps">le processus d'installation</span> <span class="hps">utilisé</span><span>. </span><span class="hps">Les mises à jour</span> <span class="hps">FOTA</span> <span class="hps">peuvent également inclure</span> <span class="hps">toute autre</span> <span class="hps">partie de la pile de Firefox OS</span><span>,</span> <span class="hps">y compris la gestion</span> <span class="atn hps">de l'appareil (</span><span>FOTA</span><span>,</span> <span class="hps">firmware</span> <span class="hps">/ drivers</span><span>)</span><span>, la gestion des</span> <span class="hps">paramètres</span> <span class="hps">(paramètres de</span> <span class="hps">Firefox</span> <span class="hps">OS</span><span>)</span><span>,</span> <span class="hps">les mises à jour</span> <span class="hps">de sécurité</span><span>,</span> <span class="hps">Gaia</span><span>,</span> <span class="hps">Gecko</span><span>,</span> <span class="hps">et d'autres</span> <span class="hps">correctifs</span><span>.</span></span><span lang="fr"><span> </span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Les mises à jour</span> <span class="hps">qui ne comportent pas</span> <span class="hps">Gonk</span> <span class="hps">peuvent être</span> <span class="hps">effectuées en utilisant</span> <span class="hps">la mise à jour</span> <span class="hps">de l'utilitaire système</span> <span class="hps">Mozilla</span><span>.</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">utilise le même</span> <span class="hps">framework de </span><span class="hps">mise à jour</span><span>, les mêmes processus et</span> le même format <span class="hps">Mozilla</span> <span class="atn hps">ARCHIVE (</span><span>MAR</span><span>) </span><span class="atn hps">(</span><span>utilisé</span> <span class="hps">pour les packages</span> <span class="hps">de mise à jour</span><span>)</span> <span class="hps">que le produit</span> <span class="hps">Firefox</span> <span class="hps">Desktop.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Un service</span> <span class="hps">intégré</span> <span class="hps">dans</span> <span class="hps">la mise à jour</span> </span>— lequel<span lang="fr"><span class="hps"> peut être fourni</span> <span class="hps">par le fabricant</span> </span>—<span lang="fr"> <span class="hps">sur le téléphone mobile</span> <span class="hps">vérifie périodiquement les</span> <span class="hps">mises à jour système</span><span>.</span> <span class="hps">Une fois</span> <span class="hps">un paquet</span> <span class="hps">système devient</span> <span class="hps">disponible et</span> <span class="hps">est détecté</span> <span class="hps">par le service</span> <span class="hps">de mise à jour</span><span>,</span> <span class="atn hps">l'</span><span>utilisateur est invité à</span> <span class="hps">confirmer l'installation</span><span>. </span><span class="hps">Avant</span> que <span class="hps">les mises à jour</span> soient <span class="hps">installées sur</span> <span class="atn hps">l'</span><span>appareil mobile, le</span> <span class="hps">stockage de l'appareil</span> <span class="hps">est vérifié pour</span> <span class="hps">un espace suffisant pour</span> <span class="hps">appliquer la</span> <span class="hps">mise à jour</span><span>,</span> <span class="hps">et</span> <span class="hps">la distribution</span> <span class="hps">est vérifiée pour</span><span>: </span></span></p> - -<ul> - <li>Update origin <span id="result_box" lang="fr"><span class="atn hps">(</span><span>vérifier</span> <span class="hps">le protocole</span> <span class="hps">de</span> <span class="hps">localisation de la source</span><span>:</span> <span class="hps">domaine</span><span>:</span> <span class="hps">port de</span> <span class="hps">la mise à jour</span> <span class="hps">du système et</span> <span class="hps">manifeste)</span></span></li> - <li>File integrity (<span class="short_text" id="result_box" lang="fr"><span class="hps">SHA-256</span> vérifie <span class="hps">de hachage</span></span>)</li> - <li>Code signature (vérification de cetificat)</li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Les</span> <span class="hps">mesures de sécurité</span> <span class="hps">suivantes sont utilisées</span> <span class="hps">au cours du processus</span> <span class="hps">de mise à jour</span><span>:</span></span></p> - -<ul> - <li><span id="result_box" lang="fr"><span class="hps">Mozilla</span> <span class="hps">recommande</span> <span class="hps">et espère que</span> <span class="hps">les mises à jour</span> <span class="hps">sont récupérées</span> <span class="hps">via une connexion</span> <span class="hps">SSL</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Une vérification cryptographique</span> <span class="hps">forte</span> <span class="hps">est nécessaire</span> <span class="hps">avant d'installer</span> <span class="hps">un paquet</span> <span class="hps">de</span> <span class="hps">firmware</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">La mise à jour</span> <span class="hps">complète</span> <span class="hps">doit être téléchargé</span>e <span class="hps">dans un emplacement spécifique</span> <span class="hps">et sécurisé</span> <span class="hps">avant le début du</span> <span class="hps">processus de</span> <span class="hps">mise à jour</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Le système doit être</span> <span class="hps">dans un état</span> <span class="hps">sécurisé</span> <span class="hps">lorsque le processus de</span> <span class="hps">mise à jour démarre</span><span>,</span> <span class="hps">sans</span> <span class="hps">les applications </span><span class="hps">en marche.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Les</span> <span class="hps">clés doivent être</span> <span class="hps">stockées dans un</span> <span class="hps">emplacement sécurisé sur</span> <span class="hps">le dispositif</span><span>.</span></span></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Des contrôles rigoureux</span> <span class="hps">sont en mis place pour</span> <span class="hps">veiller à ce que</span> <span class="hps">la mise à jour</span> <span class="hps">est appliquée</span> <span class="hps">correctement</span> <span class="hps">sur le téléphone mobile</span><span>.</span></span></p> - -<div class="note"> -<p><strong>Note</strong>: <span id="result_box" lang="fr"><span>Pour plus d'informations</span> <span>sur la façon dont</span> <span>les mises à jour</span> <span>fonctionnent et comment</span> <span>créer et distribuer des</span> <span>mises à jour</span><span>,</span> <span>lire </span></span><a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Creating_Firefox_OS_update_packages">Création et application des paquets de mise à jour de Firefox OS</a>.</p> -</div> - -<h2 id="Securité_des_applications">Securité des applications</h2> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">utilise une stratégie de</span> <span class="hps">sécurité de défense</span> <span class="hps">en profondeur</span> <span class="hps">pour protéger le</span> <span class="hps">téléphone mobile</span> <span class="hps">des applications</span> <span class="hps">intrusives</span> <span class="hps">ou malveillantes</span><span>.</span> <span class="hps">Cette stratégie</span> <span class="hps">utilise une</span> <span class="hps">variété de</span> <span class="hps">mécanismes</span><span>,</span> <span class="hps">y compris les</span> <span class="hps">niveaux d'autorisation</span> <span class="hps">implicites</span> <span class="hps">basés sur</span> <span class="hps">un</span> <span class="hps">modèle de confiance</span> <span class="hps">de</span> <span class="hps">l'application</span><span>, l'exécution</span> <span class="hps">en sandbox</span> <span class="hps">au</span> <span class="hps">moment de l'exécution</span><span>, d'un accès</span><span class="hps"> </span>au <span class="hps">matériel sous-jacent</span> <span class="hps">du téléphone mobile uniquement par API</span></span><span lang="fr"><span>,</span> <span class="hps">un modèle d'autorisation</span> <span class="hps">robuste,</span> <span class="hps">et les processus</span> <span class="hps">d'installation et de</span> <span class="hps">mise à jour sécurisé</span><span>.</span> <span class="hps">Pour les détails techniques</span><span>,</span></span> <span class="short_text" id="result_box" lang="fr"><span class="hps">faire référence à</span></span> <a href="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security" title="/en-US/docs/Mozilla/Firefox_OS/Security/Application_security">Application security.</a></p> - -<p><span id="result_box" lang="fr"><span class="hps">Dans Firefox</span> <span class="hps">OS</span><span>,</span> <span class="hps">toutes les applications</span> <span class="hps">sont</span> <span class="hps">des applications Web</span> <span class="hps">-</span> <span class="hps">programmes écrits</span> <span class="hps">en utilisant</span> <span class="hps">HTML5</span><span>,</span> <span class="hps">JavaScript, CSS</span><span>, les médias,</span> <span class="hps">et d'autres technologies</span> <span class="hps">Web ouvertes</span> <span class="hps">(les pages</span> <span class="hps">en cours d'exécution</span> <span class="hps">dans le navigateur</span> <span class="hps">ne sont pas visées</span>; <span class="hps">que les applications</span> <span class="hps">Web</span> <span class="hps">dans ce contexte</span><span>). </span><span class="hps">Parce qu'il</span> <span class="hps">n'y a d'application binaires </span> <span class="atn hps">(</span><span class="atn hps">«natives</span><span>»)</span> <span class="hps">installées</span> <span class="hps">par l'utilisateur</span><span>,</span> <span class="hps">tous les</span> <span class="hps">accès au système sont</span> <span class="hps">strictement</span> effectués <span class="hps">via les API</span> <span class="hps">Web</span><span>.</span> <span class="hps">Même</span> <span class="hps">l'accès au</span> <span class="hps">système de fichiers</span> <span class="hps">ne se produit que</span> <span class="hps">par le biais</span> <span class="hps">des API</span> <span class="hps">Web et</span> <span class="hps">une base de données</span> <span class="hps">SQLite</span> <span class="hps">back-end</span> <span class="hps">-</span> <span class="hps">il n'y a</span> <span class="hps">pas d'accès direct</span> entre les <span class="hps">applications</span> et les<span class="hps"> fichiers stockés sur</span> <span class="hps">la carte SD</span><span>.</span></span></p> - -<p>Firefox OS limite <span id="result_box" lang="fr"><span class="hps">et fait respecter</span> <span class="hps">la portée</span> <span class="hps">des ressources</span> <span class="hps">qui peuvent être consultées</span> <span class="hps">ou utilisées par une</span> <span class="hps">application</span><span>,</span> <span class="hps">tout en soutenant</span> <span class="atn hps">un large éventail d'</span><span>applications</span> <span class="hps">avec différents</span> <span class="hps">niveaux d'autorisation</span><span>. </span><span class="hps">Mozilla</span> <span class="hps">a mis en place</span> <span class="hps">un contrôle serré sur</span> <span class="hps">ce</span> <span class="hps">type d'applications qui peuvent accéder aux API. Par exemple</span><span>,</span> seules l<span class="hps">es applications</span> <span class="hps">certifiées</span> <span class="hps">(livrées avec</span> <span class="hps">le téléphone</span><span>)</span> <span class="hps">peuvent</span> <span class="hps">avoir accès à</span> <span class="atn hps">l'</span><span>API de téléphonie</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Cela empêche</span> <span class="hps">une situation</span><span>, par exemple</span><span>,</span> <span class="hps">dans laquelle</span> <span class="hps">une application</span> <span class="hps">arbitraire</span> <span class="hps">tiers</span> <span class="hps">est installée</span><span>,</span> <span class="hps">compose un numéro</span> <span class="hps">de téléphone</span> <span class="atn hps">pay-per-use </span><span class="atn hps">(</span><span>900 et</span> <span class="hps">910</span><span>)</span><span>,</span> <span class="hps">et engrange </span><span class="hps">une grosse facture</span> <span class="hps">de téléphone cellulaire</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">D'autres</span> <span class="hps">applications</span> <span class="hps">OEM</span> <span class="hps">pourraient cependant être</span> <span class="hps">sélectionnées</span> pour avoir <span class="hps">accès à l'API</span> <span class="hps">de téléphonie. Par exemple</span><span>,</span> <span class="hps">un opérateur</span> <span class="hps">pourrait fournir une</span> <span class="hps">application de systèmes de gestion</span> <span class="hps">qui permet à un</span> <span class="hps">client de gérer</span> sont <span class="hps">compte</span><span>,</span> <span class="hps">y compris la possibilité</span> <span class="hps">de téléphoner au service client </span><span class="hps">ou le service d'aide </span> <span class="hps">de l'opérateur</span> <span class="hps">directement</span><span>.</span></span></p> - -<h3 id="sect1"> </h3> - -<h3 id="Applications_approuvées_et_non_approuvées"><span class="short_text" id="result_box" lang="fr"><span class="hps">Applications</span> <span class="hps">approuvées et non approuvées</span></span></h3> - -<p> </p> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">catégorise</span> <span class="hps">les applications</span> <span class="hps">selon les</span> <span class="hps">types</span> <span class="hps">suivants</span><span>:</span></span></p> - -<table class="standard-table" style="height: 404px; width: 765px;"> - <thead> - <tr> - <th scope="col">Type</th> - <th scope="col">Niveau de confiance</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td>Certifié</td> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Très fiable</span></span></td> - <td><span id="result_box" lang="fr"><span class="hps">Les applications</span> <span class="hps">du système</span> <span class="hps">qui ont été approuvées</span> <span class="hps">par l'opérateur</span> <span class="hps">ou l'OEM</span> <span class="hps">(en raison de</span> <span class="hps">risques de corruption</span> <span class="hps">de l'appareil</span> <span class="hps">ou un risque pour</span> <span class="hps">la fonctionnalité</span> <span class="hps">critique)</span><span>.</span> <span class="hps">Les applications</span> <span class="hps">et services</span> <span class="hps">système</span> <span class="hps">uniquement;</span> <span class="hps">non destinées à</span> <span class="hps">des applications tierces</span><span>.</span><br> - <span class="hps">Cette désignation</span> <span class="hps">est réservée à</span> <span class="hps">un petit nombre</span> <span class="hps">d'applications critiques</span><span>.</span> <span class="hps">Exemples:</span> <span class="hps">SMS</span><span>,</span> <span class="hps">Bluetooth</span><span>, appareil photo,</span> <span class="hps">horloge système</span><span>, la téléphonie et</span> <span class="hps">le numéroteur</span> <span class="hps">par défaut</span> <span class="atn hps">(</span><span>pour que les services</span> <span class="hps">d'urgence</span> <span class="hps">soient toujours accessibles</span><span>)</span><span>.</span></span></td> - </tr> - <tr> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Privilégié</span></span></td> - <td>Fiable</td> - <td><span id="result_box" lang="fr"><span class="hps">Des applications tierces</span> <span class="hps">qui ont été examinées</span><span>,</span> <span class="hps">approuvées</span> <span class="hps">et</span> <span class="hps">signées numériquement</span> <span class="hps">par un</span> <span class="hps">marché</span> <span class="hps">autorisé</span><span>.</span></span></td> - </tr> - <tr> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Web</span> <span class="atn hps">(</span><span>tout le reste</span><span>)</span></span><span id="result_box" lang="fr"><span class="hps">applique</span></span></td> - <td>Non fiable</td> - <td><span id="result_box" lang="fr"><span class="hps">Contenu Web</span> <span class="hps">régulier</span><span>.</span> <span class="hps">Comprend les</span> <span class="hps">applications installées</span> <span class="atn hps">(</span><span>stockées sur le</span> <span class="hps">téléphone mobile</span><span>)</span> <span class="hps">et</span> <span class="hps">des applications</span> <span class="hps">hébergées</span> <span class="atn hps">(</span><span>stockées à distance</span><span>,</span> <span class="hps">avec seulement</span> <span class="hps">une application</span> <span class="hps">manifeste</span> <span class="hps">stockée sur le</span> <span class="hps">téléphone mobile</span><span>)</span><span>.</span> <span class="hps">Le manifeste</span> <span class="hps">pour les applications</span> <span class="hps">hébergées</span> <span class="hps">peut être obtenu</span> <span class="hps">grâce à un</span> <span class="hps">marché</span><span>.</span></span></td> - </tr> - </tbody> -</table> - -<p><span id="result_box" lang="fr"><span class="hps">Le niveau de confiance</span> <span class="hps">d'une application</span> <span class="hps">détermine</span><span>,</span> <span class="hps">en partie,</span> <span class="hps">sa capacité à</span> <span class="hps">accéder aux fonctionnalités</span> <span class="hps">de</span> <span class="hps">téléphone mobile</span><span>.</span></span></p> - -<ul> - <li><span lang="fr"><span class="hps">Les applications</span> <span class="hps">certifiées ont</span> <span class="hps">des autorisations à</span> <span class="hps">la plupart des</span> opérations de APIs Web<span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Les applications</span> <span class="hps">privilégiées</span> <span class="hps">ont</span> <span class="hps">des autorisations à un</span> <span class="hps">sous-ensemble des </span><span class="hps">opérations des API</span>s <span class="hps">Web</span><span class="hps"> qui sont accessibles aux</span> <span class="hps">applications</span> <span class="hps">certifiées</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Les applications</span> <span class="hps">non fiables</span> <span class="hps">ont</span> <span class="hps">des autorisations à un</span> <span class="hps">sous-ensemble des</span> <span class="hps">opérations des API</span> <span class="hps">Web</span> <span class="hps">accessibles aux</span> <span class="hps">applications</span> <span class="hps">privilégiées -</span> <span class="hps">seules les</span> <span class="hps">API</span> <span class="hps">Web qui contiennent des</span> <span class="hps">mesures d'atténuation</span> <span class="hps">de sécurité</span> <span class="hps">suffisantes pour</span> <span class="hps">être</span> <span class="hps">exposées à du contenu</span> <span class="hps">Web</span> <span class="hps">non sécurisé</span><span>.</span></span></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Certaines opérations,</span> <span class="hps">telles que</span> <span class="hps">l'accès au réseau</span><span>,</span> <span class="hps">sont supposées être</span> <span class="hps">une</span> <span class="hps">autorisation</span> <span class="hps">implicite pour</span> <span class="hps">toutes les applications</span><span>.</span> <span class="hps">En général</span><span>, plus </span><span class="hps">l'opération</span> est sensible <span class="atn hps">(</span><span>par exemple,</span> <span class="hps">composer un</span> <span class="hps">numéro de téléphone</span> <span class="hps">ou accéder à</span> <span class="hps">la liste de contacts</span><span>)</span><span>,</span> plus <span class="hps">le niveau de confiance</span> <span class="hps">de</span> <span class="hps">l'application</span> <span class="hps">nécessaire</span> <span class="hps">pour l'exécuter est élevé.</span></span></p> - -<div class="note"> -<p><span id="result_box" lang="fr"><span class="hps">Remarque</span><span>:</span> <span class="hps">pour plus d'informations</span> <span class="hps">sur les</span> <span class="hps">API disponibles</span> <span class="hps">et leurs</span> <span class="hps">niveaux d'autorisation</span><span>,</span> <span class="hps">consulter</span> </span><a href="https://developer.mozilla.org/fr/Apps/Build/App_permissions">App permissions</a>.</p> -</div> - -<h4 id="Principe_de_la_Moindre_partie_de_Permissions">Principe de la Moindre partie de Permissions</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Pour</span> <span class="hps">les applications Web</span><span>,</span> <span class="hps">le framework de sécurité</span> <span class="hps">de Firefox</span> <span class="hps">OS</span> <span class="hps">suit le principe</span> <span class="hps">des moindres</span> <span class="hps">autorisations</span><span>:</span> <span class="hps">commencer</span> <span class="hps">avec les autorisations</span> <span class="hps">minimales absolues</span><span>,</span> <span class="hps">puis accorder</span> <span class="hps">sélectivement</span> <span class="hps">des privilèges supplémentaires</span> <span class="hps">que</span> <span class="hps">lorsque cela est nécessaire</span> <span class="hps">et raisonnable</span><span>.</span> <span class="hps">Par défaut</span><span>,</span> <span class="hps">une application</span> <span class="hps">commence</span> <span class="hps">avec de très faibles</span> <span class="hps">autorisations</span><span>,</span> <span class="hps">ce qui est comparable</span> <span class="hps">au contenu</span> <span class="hps">Web</span> <span class="hps">non sécurisé</span><span>.</span> <span class="hps">Si l'application</span> <span class="hps">effectue des appels</span> <span class="hps">API</span> <span class="hps">Web qui</span> <span class="hps">nécessitent des autorisations</span> <span class="hps">supplémentaires</span><span>,</span> <span class="hps">il doit</span> <span class="hps">énumérer</span> <span class="hps">ces autorisations</span> <span class="hps">supplémentaires</span> <span class="hps">dans son</span> <span class="atn hps">manifeste (</span><span>décrit plus loin dans</span> <span class="hps">ce document</span><span>)</span><span>.</span> <span class="hps">Gecko</span> <span class="hps">envisagera d'accorder</span> <span class="hps">l'accès</span> <span class="hps">de l'API Web</span> <span class="hps">à une application</span> <span class="hps">que si les</span> <span class="hps">privilèges applicables</span> <span class="hps">sont priés</span> <span class="hps">explicitement</span> <span class="hps">dans son</span> <span class="hps">manifeste.</span> <span class="hps">Gecko</span> <span class="hps">accordera l'autorisation</span> <span class="hps">demandée uniquement si</span> <span class="hps">le type de l'application </span><span class="hps">Web</span> <span class="atn hps">(</span><span>certifiée</span><span>,</span> <span class="hps">confiance</span><span>,</span> <span class="hps">ou</span> <span class="hps">Web</span><span>)</span> <span class="hps">est</span> <span class="hps">suffisamment qualifié</span> <span class="hps">pour l'accès</span><span>.</span></span></p> - -<h4 id="Processus_d'Examen_pour_Applications_Privilégiés_dans_le_Marché">Processus d'Examen pour Applications Privilégiés dans le Marché</h4> - -<p>Pour qu'une application devienne privilégée, le fournisseur de l'application doit la soumettre pour examen sur le Marketplace<span lang="fr"><span class="alt-edited">. Le Marketplace soumet l'application dans un processus de révision du code rigoureux: vérification de son authenticité et de l'intégrité, veiller à ce que les autorisations demandées sont utilisées aux fins indiquées (dans la justification de l'autorisation), vérifier que l'utilisation des autorisations implicites est appropriée, et de valider que toutes les interfaces entre le contenu de l'application privilégiée et contenu externe non privilégié ont les mesures d'atténuation appropriées pour prévenir des attaques d'élévation de privilèges. Le Marketplace a la responsabilité de veiller à ce que l'application web ne se comportera pas malicieusement avec les autorisations qu'il est accordée.</span></span></p> - -<p>Après q'une application est passé cet examen, elle est approuvée pour utilisation, le manifeste de l'application est signé numériquement par le Marketplace, et il est disponible pour les utilisateurs mobiles. La signature garantit que, si la boutique en ligne a été en quelque sorte piratée, le pirate ne pouvait pas sortir avec l'installation de contenu arbitraire ou du code malveillant sur les téléphones des utilisateurs. En raison de ce processus de vérification, Firefox OS donne des applications privilégiées obtenues à partir du Marketplace un plus haut degré de confiance tous les jours que de contenu Web.</p> - -<p> </p> - -<div class="note"> -<p><strong>Remarque</strong>: pour en savoir plus à propos de <a href="https://marketplace.firefox.com/">Marketplace</a>, y compris le marché de Firefox, aller à la zone du <a href="/fr/docs/Mozilla/Marketplace">Marketplace</a>.</p> -</div> - -<p> </p> - -<h3 id="Applications_empaquetées_et_hébergées"><span class="short_text" id="result_box" lang="fr"><span class="alt-edited">Applications empaquetées et hébergées</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Les applications pour Firefox OS peuvent être soit empaquetées (stockées sur le téléphone mobile) ou hébergées (stockées sur un serveur web distant, avec juste un manifeste stocké sur le téléphone mobile). Il ya quelques différences dans la façon dont la sécurité est gérée pour chaque. Néanmoins, les applications empaquetées et hébergées sont toutes deux soumises à l'application sandboxing, qui est décrite plus loin dans ce document.</span></span></p> - -<div class="note"> -<p><strong>Note</strong>: <span id="result_box" lang="fr"><span class="hps">Vous pouvez</span> <span class="hps">en savoir plus sur</span> <span class="hps">les applications</span> <span class="hps">hébergées</span> <span class="hps">et </span><span class="alt-edited">empaquetées</span></span><span lang="fr"> <span class="hps">à </span></span><a href="/fr/Marketplace/Options/Self_publishing">Auto-publication d'application</a></p> -</div> - -<h4 id="Applications_empaquetées"><span class="short_text" id="result_box" lang="fr"><span class="hps">Applications</span> empaquetées</span></h4> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Une application empaquetée se compose d'un fichier ZIP contenant des ressources d'application (HTML5, CSS, Javascript, images, médias), ainsi que d'un manifeste qui fournit une liste explicite des actifs et leurs valeurs de hachage correspondant. Applications certifiées et privilégiées doivent être empaquetées parce que le manifeste de l'application doit être signé numériquement. Quand un utilisateur obtient une application incluse dans le paquet, le fichier ZIP téléchargé sur le téléphone mobile, et le manifeste est lu à partir d'un emplacement connu à l'intérieur du fichier ZIP. Pendant le processus d'installation, les actifs d'applications sont dignes de confiance et restent stockés localement dans le paquet. </span><span>Toutes les</span> <span>autorisations explicites</span> <span>sont demandées</span> <span>lors de l'exécution</span><span>,</span> <span>montrant à l'utilisateur</span> <span>les intentions</span> <span>d'utilisation des données</span> <span>de l'</span><span>application</span><span>,</span> <span>et sont persistées par</span> <span>défaut</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Pour faire référence à des ressources d'applications dans une application empaquetée, l'URL commence par app: en utilisant le format suivant:</span></span></p> - -<p><code>app://<em>identifier</em>/<em>path_within_zipfile</em>/file.html</code></p> - -<p><span id="result_box" lang="fr"><span class="alt-edited">où app:// représente le point de montage du fichier ZIP, et l'identifiant est un UUID qui est généré lorsque l'application est installée sur le téléphone mobile. Ce mécanisme garantit que les ressources appelées avec app:URL contenues dans le fichier ZIP. Le chemin au sein d'une app: est relative, donc des liens relatifs à des ressources dans le fichier ZIP sont autorisés.</span></span></p> - -<p>Alors que les applications empaquetées sont principalement destinées à être utilisées pour les applications certifiées ou privilégiées, les applications web régulières peuvent aussi être empaquetées. <span id="result_box" lang="fr"><span>Cependant, elles</span> <span>ne gagnent pas</span> <span>d'augmentation</span> <span>de l'accès</span> <span>en confiance ou</span> <span>autorisations</span> <span>simplement parce qu'elles</span> <span>sont </span></span>empaquetées<span lang="fr"><span>.</span></span></p> - -<h4 id="Applications_hébergées"><span class="short_text" id="result_box" lang="fr"><span class="hps">Applications hébergées</span></span></h4> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Les applications hébergées sont situées sur un serveur Web et chargées via HTTP. Seulement le manifeste de l'application est stocké sur le téléphone mobile. Tout le reste est stocké à distance. Certaines APIs sont disponibles uniquement aux applications privilégiées et certifiées, ce qui nécessite que l'application soit empaquetée en raison des exigences de signature. Par conséquent, une application hébergée n'aura pas accès à l'une des API Web qui nécessitent un statut d'application privilégiée ou certifiée.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Du point de</span> <span class="hps">vue de la sécurité</span><span>,</span> <span class="hps">des applications</span> <span class="hps">hébergées</span> <span class="hps">fonctionnent très</span> <span class="hps">bien</span> <span class="hps">comme des sites Web</span> <span class="hps">normaux</span><span>.</span> <span class="hps">Une application</span> <span class="hps">hébergée est</span> <span class="hps">chargé</span>e <span class="hps">en invoquant un</span> <span class="hps">codage en dur</span><span>,</span> <span class="hps">URL</span> <span class="hps">pleinement qualifiée</span> <span class="hps">qui pointe vers</span> <span class="hps">la page</span> <span class="hps">de démarrage dans</span> <span class="hps">le répertoire racine</span> <span class="hps">de l'application</span> <span class="hps">sur le serveur</span> <span class="hps">Web</span><span>.</span> <span class="hps">Une fois</span> <span class="hps">une application</span> <span class="hps">hébergée est</span> <span class="hps">chargée</span><span>,</span> <span class="hps">le </span><span class="hps">téléphone mobile pointe</span> <span class="hps">vers des pages</span> <span class="hps">en utilisant les mêmes</span> <span class="hps">URL qui</span> <span class="hps">sont utilisées lors de</span> <span class="hps">la navigation sur le</span> <span class="hps">site web</span><span>.</span></span></p> - -<h3 id="Manifeste_d'une_Application">Manifeste d'une Application</h3> - -<p>Le manifeste d'une application Open Web contient des informations dont le navigateur Web a besoin pour interagir avec une application. Un manifeste est un fichier JSON avec (au moins) un nom et une description pour l'application. Pour plus de détails, reportez-vous à <a href="/fr/Apps/FAQs/About_app_manifests">FAQs about app manifests</a>.</p> - -<h4 id="Exemple_de_Manifeste">Exemple de Manifeste</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Les lignes de code</span> <span class="hps">suivantes montrent un exemple</span> <span class="hps">de manifeste</span> <span class="hps">avec les réglages</span> <span class="hps">de base</span> <span class="hps">seulement</span><span>:</span></span></p> - -<pre class="brush:text">{ - "name": "My App", - "description": "My elevator pitch goes here", - "launch_path": "/", - "icons": { - "128": "/img/icon-128.png" - }, - "developer": { - "name": "Your name or organization", - "url": "http://your-homepage-here.org" - }, - "default_locale": "en" -}</pre> - -<h3 id="Paramètres_de_sécurité_dans_le_Manifeste_de_l'Application"><span class="short_text" id="result_box" lang="fr"><span class="hps">Paramètres de sécurité</span> <span class="hps">dans le Manifeste de l'Application</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Le manifeste</span> <span class="hps">peut</span> <span class="hps">également contenir d'autres</span> <span class="hps">paramètres</span><span>, y compris</span> <span class="hps">les</span> <span class="hps">paramètres de sécurité suivants</span><span>:</span></span></p> - -<p> </p> - -<table> - <thead> - <tr> - <th style="width: 152px;"> - <p>Champs</p> - </th> - <th style="width: 479px;"> - <p>Description</p> - </th> - </tr> - </thead> - <tbody> - <tr> - <td style="width: 152px;"> - <p>permissions</p> - </td> - <td style="width: 479px;"> - <p><span id="result_box" lang="fr"><span class="atn hps">Permissions requises par l'</span><span>application</span><span>.</span> <span class="hps">Une application</span> <span class="hps">doit</span> <span class="hps">énumérer toutes les</span> <span class="hps">API</span> <span class="hps">Web</span> <span class="hps">qu'elle entend utiliser</span> <span class="hps">qui nécessite</span> <span class="hps">l'autorisation</span> <span class="hps">de l'utilisateur</span><span>.</span> <span class="hps">La plupart des</span> <span class="hps">autorisations</span> <span class="hps">ont du sens</span> <span class="hps">pour les applications</span> <span class="hps">privilégiées</span> <span class="hps">ou</span> <span class="hps">des applications</span> <span class="hps">certifiées</span><span>,</span> <span class="hps">mais pas</span> <span class="hps">pour les applications</span> <span class="hps">hébergées</span><span>.</span> <span class="hps">Propriétés</span> <span class="hps">par</span> <span class="hps">API</span><span>:</span></span></p> - - <ul> - <li><span id="result_box" lang="fr"><strong><span class="hps">Description</span></strong><span>:</span> <span class="hps">Une</span> <span class="hps">chaîne spécifiant</span> <span class="hps">l'intention derrière</span> la demande <span class="hps">d'utilisation</span> <span class="hps">de cette API</span><span>.</span> <span class="hps">Requis</span></span></li> - <li><span id="result_box" lang="fr"><strong><span class="hps">Accès</span></strong></span><span lang="fr"><span>:</span> <span class="hps">Une</span> <span class="hps">chaîne spécifiant le</span> <span class="hps">type d'accès requis</span> <span class="hps">pour l'autorisation</span><span>.</span> <span class="hps">Les autorisations</span> <span class="hps">implicites</span> <span class="hps">sont accordées</span> <span class="hps">lors de l'installation</span><span>.</span> <span class="hps">Requis pour</span> <span class="hps">seulement quelques</span> <span class="hps">API</span><span>.</span> <span class="hps">Les valeurs acceptées</span><span>: </span></span><strong>read</strong>, <strong>readwrite</strong>, <strong>readcreate</strong>, et <strong>createonly</strong>.</li> - </ul> - </td> - </tr> - <tr> - <td style="width: 152px;"> - <p>installs_allowed_from</p> - </td> - <td style="width: 479px;"> - <p><span id="result_box" lang="fr"><span class="hps">L'origine</span> <span class="hps">de l'application</span><span>;</span> <span class="hps">peut</span> <span class="hps">être au singulier</span> <span class="hps">ou un tableau</span> <span class="hps">des origines</span> <span class="atn hps">(</span></span>scheme+unique hostname<span lang="fr"><span>)</span> <span class="hps">qui sont autorisés</span> <span class="hps">à déclencher</span> <span class="hps">l'installation</span> <span class="hps">de cette application</span><span>.</span> <span class="hps">Permet aux fournisseurs</span> <span class="hps">d'applications</span> <span class="hps">de restreindre</span> <span class="hps">les installations</span> <span class="hps">à partir de seulement</span> l'autorisation du Marketplace</span> (<a href="https://marketplace.firefox.com/">https://marketplace.firefox.com/</a>).</p> - </td> - </tr> - <tr> - <td style="width: 152px;"> - <p>csp</p> - </td> - <td style="width: 479px;"> - <p>Content Security Policy<span lang="fr"> <span class="atn hps">(</span><span>CSP</span><span>)</span><span>.</span> <span class="hps">Appliquée à toutes les</span> <span class="hps">pages chargées</span> <span class="hps">dans l'application</span><span>.</span> <span class="hps">Utilisé pour</span> <span class="hps">durcir</span> <span class="hps">l'application</span> <span class="hps">contre les</span> <span class="hps">bugs qui pourraient</span> <span class="hps">permettre à un attaquant</span> <span class="hps">d'injecter du code</span> <span class="hps">dans l'application</span><span>.</span> <span class="hps">Si</span> <span class="hps">non spécifié</span><span>,</span> <span class="hps">les applications</span> <span class="hps">privilégiées</span> <span class="hps">et certifiées</span> <span class="hps">ont</span> des réglages système <span class="hps">par défaut</span><span>.</span> <span class="hps">Syntaxe:</span></span><br> - <a href="https://developer.mozilla.org/en-US/docs/Apps/Manifest#csp">https://developer.mozilla.org/en-US/docs/Apps/Manifest#csp</a></p> - - <p><em><span id="result_box" lang="fr"><span class="hps">Notez que cette</span> <span class="hps">directive</span> <span class="hps">ne peut</span> <span class="hps">augmenter le</span> <span class="hps">CSP</span> <span class="hps">appliqué</span><span>.</span> <span class="hps">Vous ne pouvez pas</span> <span class="hps">l'utiliser</span><span>, par exemple</span><span>,</span> <span class="hps">de réduire le</span> <span class="hps">CSP</span> <span class="hps">appliqué à un</span>e application <span class="hps">privilégiée</span><span>.</span></span></em></p> - </td> - </tr> - <tr> - <td style="width: 152px;"> - <p>type</p> - </td> - <td style="width: 479px;"> - <p><span id="result_box" lang="fr"><span class="hps">Type d'application</span> </span>(web, privilegiée, or certifiée)<span lang="fr"><span>.</span></span></p> - </td> - </tr> - </tbody> -</table> - -<p> </p> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">exige que</span> <span class="hps">le manifest</span>e soit<span class="hps"> servi</span> <span class="hps">avec un</span> <span class="hps">type mime</span> <span class="atn hps">spécifique (</span><code><span class="atn">application / x-</span><span>web-app</span><span class="atn">-</span><span>manifeste</span> <span class="hps">+</span> <span class="hps">JSON</span></code><span>) et</span> <span class="hps">à partir du même</span> <span class="hps">nom d'hôte</span> <span class="hps">pleinement qualifié</span> <span class="hps">(origine</span><span>)</span> <span class="hps">à partir de laquelle</span> <span class="hps">l'application</span> <span class="hps">est servie</span><span>.</span> <span class="hps">Cette restriction</span> <span class="hps">est assouplie</span> <span class="hps">lorsque l'application</span> <span class="atn hps">manifeste (</span><span>et donc</span> <span class="hps">l'application</span> <span class="hps">manifeste)</span> <span class="hps">est</span> <span class="hps">de la même origine</span> <span class="hps">avec la page</span> <span class="hps">qui a demandé</span> <span class="hps">l'application</span> <span class="hps">à installer.</span> <span class="hps">Ce mécanisme</span> <span class="hps">est utilisé pour</span> <span class="hps">assurer qu'il est</span> <span class="hps">impossible de</span> <span class="hps">tromper un</span> <span class="hps">site Web en</span> <span class="hps">accueillant un</span> <span class="hps">manifeste d'application</span><span>.</span></span></p> - -<p> </p> - -<h3 id="Exécution_sandbox"><span class="short_text" id="result_box" lang="fr"><span>Exécution</span> <span>sandbox</span></span></h3> - -<p> </p> - -<p><span id="result_box" lang="fr"><span class="hps">Cette section décrit</span> <span class="hps">l'application</span> <span class="hps">et l'exécution </span></span>sandboxes.</p> - -<h4 id="Application_Sandbox">Application Sandbox</h4> - -<p><span id="result_box" lang="fr"><span class="hps">Le framework</span> <span class="hps">de sécurité</span> <span class="hps">de Firefox</span> <span class="hps">OS</span> <span class="hps">utilise</span> <span class="hps">sandboxing</span> <span class="hps">comme</span> <span class="hps">une stratégie de défense</span> <span class="hps">en profondeur</span> <span class="hps">pour atténuer les risques</span> <span class="hps">et protéger le</span> <span class="hps">téléphone mobile</span><span>,</span> <span class="hps">la plate-forme</span><span>,</span> <span class="hps">et les données</span><span>.</span> <span class="hps">Sandboxing</span> <span class="hps">est</span> <span class="hps">une façon de mettre</span> <span class="hps">les frontières et les</span> <span class="hps">restrictions</span> <span class="hps">autour d'une</span> <span class="hps">application</span> <span class="hps">en cours d'exécution</span><span>.</span> <span class="hps">Chaque</span> <span class="hps">application</span> <span class="hps">fonctionne</span> <span class="hps">dans son propre espace</span> <span class="hps">de travail</span> <span class="hps">et a</span> <span class="hps">uniquement accès aux</span> <span class="hps">API Web</span> <span class="hps">et</span> <span class="hps">les données dont elle</span><span class="hps"> a</span> <span class="hps">l'accès</span><span>, ainsi que</span> <span class="hps">les ressources associées à</span> <span class="hps">cet espace</span> <span class="hps">de travail</span> <span class="hps">(bases de données</span> <span class="hps">IndexedDB</span><span>, biscuits,</span> <span class="hps">stockage</span><span> en mode déconnecté,</span> <span class="hps">et ainsi de suite</span><span>)</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">La figure suivante</span> <span class="hps">donne un aperçu de</span> <span class="hps">ce modèle de sécurité</span><span>.</span></span></p> - -<p> </p> - -<p> </p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5025/sandbox.png"></p> - -<p> </p> - -<p><span id="result_box" lang="fr"><span class="hps">En isolant</span> <span class="hps">chaque application</span><span>,</span> <span class="hps">son impact</span> <span class="hps">est contenue dans</span> <span class="hps">son propre espace</span> <span class="hps">de travail</span> <span class="hps">et </span><span class="hps">ne peut pas</span> <span class="hps">interférer avec</span> <span class="hps">quoi que ce soit</span> <span class="hps">(comme d'autres</span> <span class="hps">applications</span> <span class="hps">ou</span> <span class="hps">leurs données</span><span>) en dehors</span> <span class="hps">de cet espace</span> <span class="hps">de travail</span><span>.</span></span></p> - -<h4 id="Execution_Sandbox">Execution Sandbox</h4> - -<p><span id="result_box" lang="fr"><span class="hps">B2G</span> <span class="atn hps">(</span><span>Gecko</span><span>)</span> <span class="hps">s'exécute dans un processus</span> <span class="hps">de</span> <span class="hps">système</span> <span class="hps">hautement</span> <span class="hps">privilégiée</span> <span class="hps">qui a accès à</span> <span class="hps">des fonctionnalités matérielles</span> <span class="hps">dans le téléphone mobile</span><span>.</span> <span class="hps">A l'exécution,</span> <span class="hps">chaque application</span> <span class="hps">fonctionne à l'intérieur</span> <span class="hps">d'un environnement</span> <span class="hps">d'exécution qui</span> <span class="hps">est un processus enfant du</span> <span class="hps">processus </span><span class="hps">système</span> <span class="hps">de</span> <span class="hps">B2G</span><span class="hps">.</span> <span class="hps">Chaque</span> <span class="hps">processus enfant</span> <span class="hps">a</span> <span class="hps">un ensemble restreint de</span> <span class="hps">privilège</span> <span class="hps">OS</span> <span class="hps">-</span> <span class="hps">par exemple,</span> <span class="hps">un processus enfant</span> <span class="hps">ne peut pas lire</span> <span class="hps">ou écrire des fichiers</span> <span class="hps">arbitraires</span> <span class="hps">sur le système de</span> <span class="hps">fichiers directement</span><span>.</span> <span class="hps">Un accès privilégié</span> <span class="hps">est fourni</span> <span class="hps">via des API</span> <span class="hps">Web, qui</span> <span class="hps">sont médiées</span> <span class="hps">par le processus</span> <span class="hps">B2G</span> <span class="hps">mère</span><span>.</span> <span class="hps">Le parent</span> <span class="hps">s'assure que</span><span>,</span> <span class="hps">quand un</span> <span class="hps">processus enfant</span> <span class="hps">demande une</span> <span class="hps">API</span> <span class="hps">privilégiée</span><span>, il</span> <span class="hps">dispose de l'autorisation</span> <span class="hps">nécessaire pour</span> <span class="hps">effectuer cette action</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Les applications communiquent uniquement avec le processus de base B2G, pas avec d'autres processus ou applications. Les applications ne fonctionnent pas indépendamment de B2G, ne peuvent ouvrir des applications de l'autre. La seule «communication» entre les applications est indirecte (par exemple, quand une application établit une alarme système et une autre application déclenche une notification du système à la suite de celui-ci), et est médiée par le processus B2G.</span></span></p> - -<h4 id="Hardware_Access_Only_via_the_Web_API">Hardware Access Only via the Web API</h4> - -<p> </p> - -<p><span id="result_box" lang="fr"><span class="hps">Les applications Web</span> <span class="hps">ont un seul</span> <span class="hps">point d'entrée</span> <span class="hps">pour accéder aux fonctionnalités</span> <span class="hps">de téléphonie mobile</span><span>:</span> <span class="hps">les</span> <span class="hps">API Web de Firefox</span> <span class="hps">OS</span><span class="hps">, qui</span> <span class="hps">sont mises en œuvre</span> <span class="hps">dans Gecko</span><span>.</span> <span class="hps">Gecko</span> <span class="hps">fournit</span> <span class="hps">la seule</span> <span class="hps">porte d'entrée de</span> <span class="hps">l'appareil mobile</span> <span class="hps">et les services</span> <span class="hps">sous-jacents</span><span>.</span> <span class="atn hps">La seule façon d'</span><span>accéder à la fonctionnalité</span> <span class="hps">matérielle du périphérique</span> <span class="hps">est de faire un</span> <span class="hps">appel d'API</span> <span class="hps">Web</span><span>.</span> <span class="hps">Il n'y a aucune</span> <span class="hps">API</span> <span class="hps">"native"</span> <span class="hps">et</span> <span class="hps">il n'y a pas</span> <span class="atn hps">d'autres façons (</span><span class="atn">pas de «</span><span>portes</span> <span class="hps">arrière</span><span>s"</span><span>) pour contourner</span> <span class="hps">ce mécanisme</span> <span class="hps">et d'interagir</span> <span class="hps">directement avec le matériel</span> <span class="hps">ou</span> <span class="hps">pénétrer dans</span> <span class="hps">la couche</span> <span class="hps">logicielle</span> <span class="hps">de bas niveau</span><span>.</span></span></p> - -<p> </p> - -<h2 id="Infrastructure_de_sécurité"><span class="short_text" id="result_box" lang="fr"><span class="hps">Infrastructure de sécurité</span></span></h2> - -<p><span id="result_box" lang="fr"><span class="hps">La figure suivante montre</span> <span class="hps">les</span> <span class="hps">composantes du framework</span> <span class="hps">de sécurité</span> <span class="hps">de Firefox</span> <span class="hps">OS</span><span>:</span></span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5027/securityframework.png" style="height: 591px; width: 979px;"></p> - -<ul> - <li><span id="result_box" lang="fr"><strong><span class="hps">Permission</span> <span class="hps">Manager</span><span>:</span></strong> <span class="hps">la passerelle</span> <span class="hps">à l'accès aux</span> <span class="hps">fonctionnalités de</span> <span class="hps">l'API Web</span><span>,</span> <span class="hps">qui est le seul</span> <span class="hps">accès au</span> <span class="hps">matériel sous-jacent</span><span>.</span></span></li> - <li><span id="result_box" lang="fr"><strong><span class="hps">Access Control List</span><span>:</span></strong> <span class="hps">Matrice</span> <span class="hps">des rôles et des</span> <span class="hps">autorisations requises pour</span> <span class="hps">accéder à la fonctionnalité</span> <span class="hps">de l'API Web</span><span>.</span></span></li> - <li><strong>Credential Validation</strong>: <span lang="fr"><span class="hps">l'authentification</span> <span class="hps">des</span> <span class="hps">applications</span> <span class="hps">/</span> <span class="hps">utilisateurs</span><span>.</span></span></li> - <li><strong>Permissions Store</strong><span lang="fr"><span class="hps">:</span> <span class="hps">Ensemble de</span> <span class="hps">privilèges requis</span> <span class="hps">pour accéder aux fonctionnalités</span> <span class="hps">de l'API Web</span><span>.</span></span></li> -</ul> - -<h3 id="Gestion_des_autorisations_et_mise_en_application"><span class="short_text" id="result_box" lang="fr"><span class="hps">Gestion</span> <span class="hps">des autorisations</span> <span class="hps">et mise en application</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">La sécurité</span> <span class="hps">de Firefox</span> <span class="hps">OS</span> <span class="hps">est conçue pour</span> <span class="hps">vérifier et</span> <span class="hps">appliquer les</span> <span class="hps">autorisations accordées à</span> <span class="hps">des applications web</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Le système</span> <span class="hps">accorde une</span> <span class="hps">autorisation</span> <span class="hps">particulière à</span> <span class="hps">une application</span> <span class="hps">que si le contenu</span> <span class="hps">lui demande</span><span>,</span> <span class="hps">et seulement si elle</span> <span class="hps">a les</span> <span class="hps">autorisations appropriées</span> <span class="hps">demandées</span> <span class="hps">dans le manifeste</span> <span class="hps">de l'application.</span> <span class="hps">Certaines autorisations</span> <span class="hps">exigent</span> <span class="hps">en outre</span> <span class="hps">l'autorisation de</span> <span class="hps">l'utilisateur</span><span>,</span> <span class="hps">qui est</span> <span class="hps">invité à accorder</span> <span class="hps">l'autorisation</span> <span class="atn hps">(</span><span>comme dans le cas</span> <span class="hps">d'une application</span> <span class="hps">demandant l'accès à</span> <span class="hps">l'emplacement actuel de</span> <span class="hps">l'utilisateur</span><span>)</span><span>.</span> <span class="hps">Ce framework</span> <span class="hps">app</span><span>-centrique</span> <span class="hps">fournit</span> <span class="hps">un contrôle plus granulaire</span> <span class="hps">sur les autorisations</span> <span class="hps">que les approches</span> <span class="hps">de rôle</span> <span class="hps">centré</span> <span class="hps">traditionnelles</span> <span class="atn hps">(</span><span>dont les rôles</span> <span class="hps">individuels</span> <span class="hps">sont</span> <span class="hps">affectés chacun</span> <span class="hps">un ensemble d'autorisations</span><span>)</span><span>.</span></span></p> - -<p><span id="result_box" lang="fr"><span class="hps">Une API</span> <span class="hps">Web</span> <span class="hps">a</span> <span class="hps">donné</span> <span class="hps">un ensemble d'actions</span> <span class="hps">et d'écouteurs</span><span>.</span> <span class="hps">Chaque</span> <span class="hps">API</span> <span class="hps">Web</span> <span class="hps">a un niveau</span> <span class="hps">d'autorisation requis</span><span>.</span> <span class="hps">Chaque fois</span> <span class="hps">une API</span> <span class="hps">Web</span> <span class="hps">est appelé</span><span>,</span> <span class="hps">Gecko</span> <span class="hps">vérifie</span> <span class="hps">les exigences</span> <span class="atn hps">d'autorisation (</span><span>rôle</span> <span class="hps">de consultation</span><span>)</span> <span class="hps">basées sur</span><span>:</span></span></p> - -<ul> - <li><span id="result_box" lang="fr"><span class="hps">Permissions associées pour </span><span class="hps">appeler</span> <span class="hps">l'application</span> <span class="hps">(comme spécifié dans</span> <span class="hps">le manifeste et</span> <span class="hps">basé sur le type</span> <span class="atn hps">d'</span><span>application</span><span>.</span><span>)</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">Autorisations requises pour exécuter</span> <span class="hps">l'opération demandée</span> <span class="atn hps">(</span><span class="hps">appel API</span><span> Web.</span><span>)</span></span></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Si</span> <span class="hps">la demande</span> <span class="hps">ne satisfait pas aux</span> <span class="hps">critères</span> <span class="hps">d'autorisation</span><span>,</span> alors <span class="hps">Gecko</span> <span class="hps">rejette la demande</span><span>.</span> <span class="hps">Par exemple</span><span>,</span> <span class="hps">des applications</span> <span class="hps">non approuvées</span> <span class="hps">ne peuvent pas exécuter</span> <span class="hps">des</span> <span class="hps">API Web</span> <span class="hps">qui sont réservées pour</span> <span class="hps">des applications</span> <span class="hps">de confiance</span><span>.</span></span></p> - -<h3 id="Inviter_les_utilisateurs_pour_Permissions"><span class="short_text" id="result_box" lang="fr"><span class="hps">Inviter les utilisateurs</span> <span class="hps">pour</span> <span class="hps">Permissions</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">En</span> <span class="hps">plus des autorisations</span> <span class="hps">qui sont implicitement</span> <span class="hps">associées aux</span> <span class="hps">applications web</span><span>,</span> <span class="hps">certaines</span> <span class="hps">opérations nécessitent</span> <span class="hps">l'autorisation</span> <span class="hps">explicite de l'utilisateur</span> <span class="hps">avant de pouvoir être</span> <span class="hps">exécutées</span> <span class="atn hps">(</span><span>par exemple,</span> <span class="atn hps">"l'application web </span><span>peut avoir accès</span> à <span class="hps">votre appareil photo</span><span>?</span><span>"</span><span>)</span><span>.</span> <span class="hps">Pour ces opérations</span><span>,</span> <span class="hps">les applications web</span> <span class="hps">sont tenues de</span> <span class="hps">spécifier</span><span>,</span> <span class="hps">dans leur</span> <span class="hps">manifeste,</span> <span class="hps">leur justification</span> <span class="hps">pour exiger</span> <span class="hps">cette autorisation</span><span>.</span> <span class="hps">Cette intention</span> <span class="hps">d'utilisation des données</span> <span class="hps">informe les utilisateurs</span> <span class="hps">sur ce que</span> <span class="hps">l'application Web</span> <span class="hps">a l'intention de</span> <span class="hps">faire avec</span> <span class="hps">ces données</span> <span class="hps">si l'autorisation est</span> <span class="hps">accordée,</span> <span class="hps">ainsi que tout</span> <span class="hps">risque impliqué</span><span>.</span> <span class="hps">Cela permet</span> <span class="hps">aux utilisateurs de</span> <span class="hps">prendre des décisions éclairées</span> <span class="hps">et de</span> <span class="hps">garder le contrôle sur</span> <span class="hps">leurs données</span><span>.</span></span></p> - -<h3 id="Processus_de_mise_à_jour_sécurisé_d'une_Application"><span class="short_text" id="result_box" lang="fr"><span class="hps">Processus</span> <span class="hps">de mise à jour sécurisé</span> <span class="hps">d'une Application</span></span></h3> - -<p> </p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5029/updateprocess.png" style="height: 102px; width: 979px;"></p> - -<p><span id="result_box" lang="fr"><span class="alt-edited">Pour les mises à niveau d'applications et des correctifs à une application privilégiée, les fournisseurs d'applications soumettent l'archive mis à jour pour l'autorisation du Marketplace, où elle est examinée et, si elle est approuvée, signée et mise à la disposition des utilisateurs. Sur les appareils OS Firefox, une application utilitaire de une mise à jour vérifie périodiquement des mises à jour de l'application. Si une mise à jour est disponible, l'utilisateur est alors interroger s'ils veulent l'installer. Avant qu'une mise à jour soit installée sur l'appareil mobile, le paquet est vérifié:</span></span></p> - -<ul> - <li><span id="result_box" lang="fr"><span class="hps">Origine de la mise à jour</span> <span class="atn hps">(</span><span>vérifier</span> <span class="hps">le protocole</span> <span class="hps">de</span> <span class="hps">localisation de la source</span><span>:</span> <span class="hps">domaine</span><span>:</span> <span class="hps">port de</span> <span class="hps">la mise à jour</span> <span class="hps">et manifeste</span><span>)</span></span></li> - <li>Intégrité du fichier (SHA-256 <span class="short_text" id="result_box" lang="fr"><span class="alt-edited">vérification du hachage</span></span>)</li> - <li><span id="result_box" lang="fr"><span class="hps">Signature</span> <span class="atn hps">de code (</span><span>certificat de vérification</span> <span class="hps">contre une</span> <span class="hps">racine de confiance</span><span>)</span></span></li> -</ul> - -<p>Des contrôles rigoureux sont mises en place pour veiller à ce que la mise à jour soit appliquée correctement sur le téléphone mobile. Le package de mise à jour complète doit être téléchargé dans un emplacement spécifique et sécurisé avant le début du processus de mise à jour. L'installation ne remplace pas les données des utilisateurs.</p> - -<div class="note"> -<p><strong>Note</strong>: <span id="result_box" lang="fr"><span class="hps">Pour plus d'informations</span> <span class="hps">sur les</span> <span class="hps">mises à jour</span> <span class="hps">d'applications</span><span>, lisez</span> </span><a href="/en-US/Apps/Developing/Updating_apps">Updating apps</a><span lang="fr"><span>.</span></span></p> -</div> - -<h2 id="Securité_de_l'appareil_(Hardware)"><span class="short_text" id="result_box" lang="fr"><span class="hps">Securité de l'appareil </span><span class="atn hps">(</span><span>Hardware</span><span>)</span></span></h2> - -<p><span id="result_box" lang="fr"><span class="hps">Les mécanismes de sécurité</span> <span class="hps">pour le matériel</span> <span class="hps">de l'appareil mobile</span> <span class="hps">sont généralement</span> <span class="hps">traitées par</span> <span class="atn hps">l'</span><span>OEM</span><span>.</span> <span class="hps">Par exemple</span><span>,</span> <span class="hps">un OEM</span> <span class="hps">peut</span> <span class="hps">offrir</span> une <span class="hps">SIM</span> <span class="atn hps">(</span><span>Subscriber Identity Module</span><span>)</span> <span class="hps">serrures à carte</span><span>, avec</span> <span class="hps">PUK (PIN</span> <span class="hps">Unlock Key</span><span>)</span> <span class="hps">codes</span> <span class="hps">pour débloquer</span> <span class="hps">les cartes SIM</span> <span class="hps">qui sont devenus</span> <span class="hps">verrouillé</span> <span class="hps">les entrées suivantes</span> <span class="hps">de</span> <span class="hps">code PIN erroné</span><span>.</span> <span class="hps">Contactez votre</span> <span class="hps">OEM</span> <span class="hps">pour plus de détails</span><span>.</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">ne</span> <span class="hps">permettent</span> <span class="hps">aux utilisateurs de configurer</span> <span class="hps">des codes d'accès</span> <span class="hps">et les écrans</span> <span class="hps">de délai d'attente</span><span>, qui sont décrits</span> <span class="hps">dans la section suivante</span><span>.</span></span></p> - -<h2 id="Sécurité_des_données"><span class="short_text" id="result_box" lang="fr"><span class="hps">Sécurité des données</span></span></h2> - -<p><span id="result_box" lang="fr"><span class="hps">Les utilisateurs peuvent</span> <span class="hps">stocker des données personnelles</span> <span class="hps">sur leur</span> <span class="hps">téléphone qu'ils</span> <span class="hps">veulent garder</span> <span class="hps">privées, y compris</span> <span class="hps">les contacts, les</span> <span class="hps">informations financières</span> <span class="atn hps">(</span><span>bancaires</span> <span class="hps">et</span> <span class="hps">les détails de cartes de crédit</span><span class="hps">)</span><span>,</span> <span class="hps">les mots de passe</span><span>, des calendriers,</span> <span class="hps">et ainsi de suite</span><span>.</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">est</span> <span class="hps">conçu pour protéger contre</span> <span class="hps">les applications malveillantes</span> <span class="hps">qui peuvent voler</span><span>,</span> <span class="hps">exploiter</span><span>,</span> <span class="hps">ou de détruire</span> <span class="hps">des données sensibles</span><span>.</span></span></p> - -<h3 id="Code_d'accès_et_Ecran_de_temporisation"><span class="short_text" id="result_box" lang="fr"><span class="hps">Code d'accès et</span> </span>Ecran de temporisation</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">permet</span> <span class="hps">aux utilisateurs de définir</span> <span class="hps">un code d'accès</span> <span class="hps">à leur</span> <span class="hps">téléphone mobile afin</span> <span class="hps">que</span> <span class="hps">ceux qui fournissent</span> <span class="hps">le code d'accès</span> puissent <span class="hps">utiliser le téléphone</span><span>.</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">fournit</span> <span class="hps">également un écran</span> <span class="hps">de temporisation</span> <span class="hps">qui est affiché</span> <span class="hps">après une période d'inactivité</span></span><span lang="fr"> <span class="hps">configurable depuis le</span> <span class="hps">téléphone</span> <span class="hps">,</span> <span class="hps">nécessitant une authentification</span> <span class="hps">de</span> <span class="hps">mot de passe</span> <span class="hps">avant de reprendre</span> <span class="hps">l'utilisation</span> <span class="hps">du téléphone</span><span>.</span></span></p> - -<h3 id="Données_sandbox"><span class="short_text" id="result_box" lang="fr"><span class="hps">Données </span></span><span class="short_text" lang="fr"><span class="hps">sandbox</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Comme décrit précédemment,</span> <span class="hps">les applications sont</span> <span class="hps">sandbox</span> <span class="hps">à l'exécution.</span> <span class="hps">Cela empêche</span> <span class="hps">les applications</span> <span class="hps">d'accéder aux données</span> <span class="hps">qui appartient</span> <span class="hps">à d'autres</span> <span class="hps">applications</span> <span class="hps">à moins</span> <span class="hps">que les données</span> soient<span class="hps"> explicitement</span> <span class="hps">partagé</span><span>es,</span> <span class="hps">et</span> que <span class="hps">l'application</span> <span class="hps">dispose des autorisations suffisantes</span> <span class="hps">pour y accéder.</span></span></p> - -<h3 id="Données_sérialisées"><span class="short_text" id="result_box" lang="fr"><span class="hps">Données</span> <span class="hps">sérialisées</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Les applications Web</span> <span class="hps">n'ont pas</span> un accès direct <span class="hps">en lecture</span> <span class="hps">et </span><span class="hps">écriture</span> <span class="hps">au système</span> <span class="hps">de fichiers</span><span>.</span> <span class="hps">Au lieu de cela</span><span>,</span> <span class="hps">tous les</span> <span class="hps">accès au stockage</span> <span class="hps">se produisent uniquement</span> <span class="hps">via les API</span> <span class="hps">Web</span><span>.</span> <span class="hps">Les API Web</span> <span class="hps">lisent à partir</span><span>,</span> <span class="hps">et écrivent sur</span><span>, le stockage</span> <span class="hps">via une</span> <span class="hps">base de données SQLite</span> <span class="hps">intermédiaire.</span> <span class="hps">Il n'y a pas</span> <span class="hps">d'accès</span> <span class="hps">E / S</span> <span class="hps">directe</span><span>.</span> <span class="hps">Chaque</span> <span class="hps">application</span> <span class="hps">possède son propre</span> stockage<span class="hps"> de données</span><span>,</span> <span class="hps">qui est</span> <span class="hps">sérialisé</span> <span class="hps">sur le disque</span> <span class="hps">par la</span> <span class="hps">base de données</span><span>.</span></span></p> - -<p> </p> - -<h3 id="Destruction_de_données"><span class="short_text" id="result_box" lang="fr"><span class="hps">Destruction de données</span></span></h3> - -<p><span id="result_box" lang="fr"><span class="hps">Quand un</span> <span class="hps">utilisateur désinstalle</span> <span class="hps">une application</span><span>,</span> <span class="hps">toutes les</span> <span class="hps">données (cookies</span><span>,</span> <span class="hps">localStorage</span><span>,</span> <span class="hps">IndexedDB</span><span>, etc.</span><span>)</span> <span class="hps">associées à cette application</span> sont<span class="hps"> supprimé</span><span>es.</span></span></p> - -<h3 id="Privacy">Privacy</h3> - -<p><span id="result_box" lang="fr"><span class="hps">Mozilla</span> <span class="hps">est engagé à protéger</span> <span class="hps">la vie privée</span> <span class="hps">de l'utilisateur</span> <span class="hps">et les données utilisateur</span> <span class="hps">en fonction de ses</span> <span class="hps">principes de confidentialité</span> </span>(<a href="https://www.mozilla.org/privacy/">https://www.mozilla.org/privacy/</a>)<span lang="fr"><span>,</span> <span class="hps">qui découlent</span> <span class="hps">du Manifeste</span> <span class="hps">Mozilla</span> </span>(<a href="https://www.mozilla.org/about/manifesto.html">https://www.mozilla.org/about/manifesto.html</a>)<span lang="fr"><span>.</span> <span class="hps">La politique de confidentialité</span> <span class="hps">Mozilla Firefox</span> <span class="hps">décrit comment</span> <span class="hps">Mozilla</span> <span class="hps">collecte et utilise</span> <span class="hps">des informations</span> <span class="hps">sur les utilisateurs du</span> <span class="hps">navigateur Web</span> <span class="hps">Mozilla Firefox</span><span>, y compris</span> <span class="hps">ce que</span> <span class="hps">Firefox</span> <span class="hps">envoie</span> <span class="hps">aux sites Web</span><span>,</span> <span class="hps">ce que</span> <span class="hps">Mozilla</span> <span class="hps">fait</span> <span class="hps">pour sécuriser les données</span><span>, les pratiques</span> <span class="hps">de données</span> <span class="hps">de Mozilla</span><span>,</span> <span class="hps">et ainsi de suite</span><span>.</span> <span class="hps">Pour plus d'informations</span><span>,</span> <span class="hps">voir</span><span>:</span></span></p> - -<ul> - <li><a href="http://www.mozilla.org/en-US/legal/privacy/firefox.html">http://www.mozilla.org/en-US/legal/privacy/firefox.html</a></li> - <li><a href="https://blog.mozilla.org/privacy/">https://blog.mozilla.org/privacy/</a></li> - <li><a href="http://support.mozilla.org/en-US/kb/privacy-and-security-settings-firefox-os-phones">http://support.mozilla.org/en-US/kb/privacy-and-security-settings-firefox-os-phones</a></li> -</ul> - -<p><span id="result_box" lang="fr"><span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">met en œuvre</span> <span class="hps">ces</span> <span class="hps">principes</span> <span class="hps">en mettant</span> <span class="hps">le contrôle des</span> <span class="hps">données de l'utilisateur</span> <span class="hps">dans les</span> <span class="hps">mains de l'utilisateur</span><span>,</span> <span class="hps">qui</span> <span class="hps">doit décider</span> <span class="hps">où cette information</span> <span class="hps">est personnelle va</span><span>.</span> <span class="hps">Firefox</span> <span class="hps">OS</span> <span class="hps">offre les fonctionnalités suivantes</span><span>:</span></span></p> - -<ul> - <li><span class="short_text" id="result_box" lang="fr"><span class="hps">option Ne pas suivre</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">possibilité de désactiver</span> <span class="hps">les cookies</span> <span class="hps">du navigateur Firefox</span></span></li> - <li><span id="result_box" lang="fr"><span class="hps">possibilité de supprimer</span> <span class="hps">l'historique de navigation</span> <span class="hps">Firefox</span> <span class="hps">OS</span></span></li> -</ul> diff --git a/files/fr/archive/b2g_os/securite/system_security/index.html b/files/fr/archive/b2g_os/securite/system_security/index.html deleted file mode 100644 index 98ab311d64..0000000000 --- a/files/fr/archive/b2g_os/securite/system_security/index.html +++ /dev/null @@ -1,449 +0,0 @@ ---- -title: Sécurité du système -slug: Archive/B2G_OS/securite/System_security -translation_of: Archive/B2G_OS/Security/System_security ---- -<div class="summary"> -<p>Cet article donne un aperçu du modèle de sécurité du système de Firefox OS ; il explique comment le système d'exploitation assure la sécurité et applique des autorisations.</p> -</div> - -<h2 id="Terminologie">Terminologie</h2> - -<p>Avant de plonger dans le modèle de sécurité du système, voici quelques termes clés que vous devez comprendre.</p> - -<dl> - <dt>Application web</dt> - <dd>Une <strong>application Web</strong>, <strong>application open web</strong>, <strong>application moz</strong><strong>illa</strong>, ou application est un programme écrit en <a href="/en-US/docs/HTML">HTML</a>, <a href="/en-US/docs/JavaScript">JavaScript</a>, et d'autres technologies Open Web, fonctionnant sur Firefox OS (ou toute autre plate-forme qui prend en charge le même modèle d'application installable). Toutes les demandes présentées aux internautes sur B2G sont des applications web. Par exemple, le Dialer est une application Web dans Firefox OS. Pages exécutées dans le navigateur ne sont pas désignés comme des applications Web dans ce contexte.</dd> - <dt><strong>Processus b2g</strong></dt> - <dd>Le processus de b2g Firefox OS est généralement appelé "<strong>b2g</strong>" ou "<strong>Gecko</strong>". Ceci est, essentiellement, une application qui fonctionne avec des privilèges élevés (par exemple, s'exécute en tant que root) et contrôle l'accès que toute application Web a sur toutes les ressources et les dispositifs.</dd> - <dt>Content process</dt> - <dd>Ceci est un processus enfant engendré par le processus de B2G, et qui communique avec le processus B2G. Elle représente une application web. Ceci est un processus à faible privilégié (exemple: exécuter comme utilisateur régulier et a un accès et vue sur / pour le système d'exploitation très limitée). Il communique avec le processus de base de Firefox OS en utilisant la communication inter-processus (IPC).</dd> - <dt>IPDL</dt> - <dd>Intercommunication Protocole Définition Langue, vous pouvez aussi consulter IPDL.</dd> - <dt>AOSP</dt> - <dd>Android Open Source Project (Projet Open source Android).</dd> - <dt>Appel system</dt> - <dd>Une interface d'appel entre l'espace de l'utilisateur (processus) et le noyau. Il n'y a pas d'autre moyen direct pour un processus de l'espace pour communuquer au noyau.</dd> - <dt>DAC, MAC</dt> - <dd>Discretionary Access Control (configuré par l'utilisateur) and Mandatory Access Control (forcée par le noyau).</dd> - <dt>FOTA</dt> - <dd>Firmware Over The Air met a jour le mecanisme du système. Il décrit les mises à jour du firmware complètes, généralement envoyés "over the air", soit sur une connexion sans fil à un téléphone mobile.</dd> - <dt>MSU, MAR</dt> - <dd>Mozilla System Updater, Mozilla ARchive. Terme utilisé pour décrire les mises à jour de Gecko, en utilisant le même mécanisme de mise à jour et le format archive comme pour Firefox Desktop.</dd> -</dl> - -<h2 id="Objectifs_et_portée_du_modèle_de_sécurité_du_système_Firefox_OS">Objectifs et portée du modèle de sécurité du système Firefox OS</h2> - -<p>Le modèle de sécurité du système Firefox OS est conçu pour:</p> - -<ul> - <li>Limiter et faire respecter la portée des ressources qui peuvent être consultés ou utilisés par une application web.</li> - <li>Veiller à plusieurs couches de sécurité qui sont correctement utilisés dans le système d'exploitation.</li> - <li>Limiter et contenir l'impact des vulnérabilités causées par des bogues de sécurité, de la couche Gonk.</li> - <li>Les autorisations d'application Web et une caractéristique de sécurité liées à l'application sont détaillés dans <a href="https://developer.mozilla.org/fr/Firefox_OS/securite/Application_security">la sécurité des applications</a></li> -</ul> - -<p>Voir les sections ci-dessous pour des explications plus détaillées de chacun de ces objectifs, et comment ils sont traités par Firefox OS.</p> - -<h2 id="Mettre_en_œuvre_les_permissions">Mettre en œuvre les permissions</h2> - -<p>Le modèle de <a href="/fr/docs/Mozilla/Firefox_OS/securite/Application_security">sécurité d'application</a> décrit comment les utilisateurs accordent des autorisations pour les applications, que ce soit directement ou par un tiers de confiance. Ces autorisations sont appliquées sur le processus contenu par l'application de tout accès à la ressource est réalisée par l'intermédiaire d'un appel IPC au processus de base.</p> - -<ul> - <li>Le processus de base de Firefox OS, b2g, a des privilèges très élevés et a accès à la plupart des périphériques matériels.</li> - <li>Les applications Web fonctionnent dans un processus contenu à faible privilégié et ne communiquent avec le processus de base b2g utilisant IPC, qui est mis en œuvre à l'aide de <a href="/fr/docs/IPDL">IPDL</a>.</li> - <li>Le processus de contenu n'a pas de system de niveau d'acces aux ressources.</li> - <li>Chaque API Web a un ou plusieurs fichiers de déclaration de protocole IPDL plus associés) (* .ipdl).</li> - <li>Le processus de contenu de Firefox OS ne peuvent communiquer à travers le mécanisme de IPDL dèrière le processus de base, qui effectuera des actions au nom du contenu.</li> -</ul> - -<h2 id="Initialisation_du_processus_de_contenu">Initialisation du processus de contenu</h2> - -<p>Toutes les applications web tournent dans un processus distinct doté de droits : le <strong>processus de contenu</strong> de Firefox OS. Ce processus est lancé par le processus de base b2g quand il atteint un <a href="/fr/docs/Web/HTML/Element/iframe" title="Cet élément prend en charge les attributs universels."><code><iframe></code></a> type spécial : <iframe mozapp>. Cela sépare l'application web du reste du contenu et est fortement associée à un manifeste (voir le modèle de <a href="/fr/docs/Mozilla/Firefox_OS/securite/Application_security">sécurité des applications</a> pour plus d'informations). Les processus de contenu sont lancés dans le récipient appelé récipient « en dehors du processus », ou un OOP (Out Of Process). Il est représenté par le processus plugin-conteneur et utilise un code similaire au plug-in-conteneur utilisé par le bureau Firefox.</p> - -<h3 id="Risques">Risques</h3> - -<ul> - <li>Fuite d'informations lors de la ponte du processus de contenu de l'application Web.</li> - <li>Possibilité d'accéder à des ressources système d'exploitation, et l'escalade au même niveau de privilèges que le processus de b2g.</li> - <li>Contourner l'initialisation du processus de contenu.</li> -</ul> - -<h3 id="Implémentation">Implémentation</h3> - -<h4 id="Initialisation_dans_le_processus_b2g">Initialisation dans le processus b2g</h4> - -<p>Dans cet ordre :</p> - -<ol> - <li><code>fork()</code></li> - <li><code>setuid(new, different, unused user id|nobody)</code> (which is an unprivileged user)</li> - <li><code>chrdir('/')</code></li> - <li><code>execve('plugin-container')</code></li> -</ol> - -<p>Cela garantit que le processus de POO fonctionne dans un espace mémoire séparé (nouveau processus) et un utilisateur des droits bas ne peut pas élever ses privilèges au niveau du processus de b2g.</p> - -<h4 id="Gestion_des_descripteurs_de_fichier">Gestion des descripteurs de fichier</h4> - -<p>Les descripteurs de fichiers sont traités en utilisant une méthode whitelist; une liste de descripteurs de fichiers autorisés (FDs) est créé et stocké dans l'objet <code>mFileMap</code>. La fonction <code>LaunchApp()</code> ferme avec force tous les FDS qui ne sont pas sur la liste blanche. Ceci est fait après <code>fork()</code> (qui est quand les FDs sont copiés) mais avant <code>execve() </code>(qui est quand la nouvelle application commence à courir).</p> - -<p>Contrairement à la méthode plus traditionnelle qui utilise une liste noire (close-on-exec flag: <code>CLOEXEC</code>), ce qui garantit aucun FDs sont laissées ouvertes; ceci est donc plus fiable.</p> - -<h2 id="Content_process_sandboxing_(processus_de_contenu_des_droits_réduits)">Content process sandboxing (processus de contenu des droits réduits)</h2> - -<h3 id="Risques_2">Risques</h3> - -<ul> - <li>Corruption de mémoire ou les erreurs logiques dans le runtime Gecko conduisant à l'exécution de code arbitraire.</li> - <li>Défauts similaires dans le système d'exploitation lui-même (en particulier, le noyau) conduisant à l'exécution de code arbitraire.</li> - <li>Fuite de l'information, l'accès en lecture / écriture au système de fichiers.</li> -</ul> - -<p>Cet element a une table de modélisation des menaces avec un sandbox de permis, en plus de la rapide récapitulation des risques mentionnés ci-dessus.</p> - -<div class="warning"> -<p dir="ltr"><strong>Étendue</strong> : les menaces suivantes apparaissent si un attaquant exécute du code arbitraire dans le processus de contenu. En d'autres termes, l'attaquant a déjà trouvé une vulnérabilité au sein de gecko.</p> -</div> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Menace</th> - <th scope="col">Impact potentiel</th> - <th scope="col">Facteur(s) de vraisemblance</th> - <th scope="col">Mesures d'atténuation proposées(s)</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <p>Les processus de contenu malveillants exploitent la vulnerabilité du noyau</p> - - <p>"2 étapes attaquent".</p> - </td> - <td><strong>Critique</strong>: le contrôle de l'appareil complet.</td> - <td><strong>Faible</strong>: Contenu processus a un nombre limité de système appelle disponibles.</td> - <td> - <ul> - <li>Réduire le nombre d'appels système permi au strict minimum.</li> - <li>Utilisez des correctifs proactives pour protéger le noyau, comme PaX (Protection Against eXecution).</li> - </ul> - </td> - </tr> - <tr> - <td> - <p>Elévation de privilèges au processus parent.</p> - - <p>processus de contenu malveillant exploite processus parent par l'intermédiaire de IPDL.</p> - - <p>"2 étapes attaquent".</p> - </td> - <td><strong>Haut</strong>: Possibilité d'exécuter un nombre important d'appels système sensibles (perte de données, l'accès à la caméra, l'accès au réseau, etc.).</td> - <td><strong>Moyen</strong>: Une grande quantité de code dans le processus parent. Grande surface d'attaque. sanitization Minimal des données envoyées par l'intermédiaire de BNPI (il est en mesure d'envoyer des pointeurs, par exemple).</td> - <td> - <ul> - <li>Exécutez le processus parent comme non-root / utilisateur non privilégié.</li> - <li>Attempt to sandbox the parent process as much as possible.</li> - </ul> - </td> - </tr> - <tr> - <td> - <p>Les processus de contenu malveillant exploite le processus parent pour exploiter la vulnérabilité du noyau exposée.</p> - - <p>"3 étapes attaquent".</p> - </td> - <td><strong>Critique</strong>: le contrôle de l'appareil complet.</td> - <td> - <p>Faible: Requiert un bug dans le processus parent qui peut être consulté par le biais de BNPI.</p> - - <p>Nécessite la vulnérabilité du noyau au sein de l'appel système accessible au processus parent (beaucoup plus d'appels système sont disponibles pour le processus parent, par rapport au processus de contenu.)</p> - </td> - <td> - <ul> - <li>Exécutez le processus parent comme non-root / utilisateur non privilégié.</li> - <li>Attempt to sandbox the parent process as much as possible.</li> - <li>Utilisez des correctifs proactives pour protéger le noyau, comme PaX (Protection Against eXecution).</li> - </ul> - </td> - </tr> - <tr> - <td> - <p>Contenu malveillant, processus parent ou de l'application Web exploite un bug dans le matériel de l'appareil.</p> - - <p>"1 and 2 steps attack".</p> - </td> - <td> - <p>Haut: Possibilité d'exécuter des opérations privilégiées (comme les appels, l'envoi de SMS, etc.) jusqu'à:</p> - - <p>Critique: Capacité d'exécuter du code au niveau du matériel, le contrôle de l'appareil complet.</p> - </td> - <td>Faible: Nécessite un canal de communication avec le matériel, acquis par le biais de IPDL ou d'un appel système, et un bug matériel.</td> - <td> - <ul> - <li>Périphériques matériels Fuzz.</li> - <li>Travailler autour des problèmes via le noyau et / ou patchs API de processus parents (désactiver l'accès à la fonctionnalité matérielle vulnérable ou aseptiser les données avant de passer au-dessus).</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<div class="note"> -<p>Note: PaX (Protection Against eXecution) est un patch du noyau de <a href="https://grsecurity.net/~paxguy1/">GrSecurity</a> (<a href="https://pax.grsecurity.net/docs/">docs</a>), qui met en œuvre les deux «PaX» et des protections additionel tels que UDEREF et SMAP.</p> - -<p>vulnérabilités non listés sont atténués par le sandbox lui-même.</p> -</div> - -<h3 id="Implementation">Implementation</h3> - -<div class="geckoVersionNote"> -<p>Superviseur n'a pas encore été mis en œuvre.</p> -</div> - -<p><img alt="Process Model Sandbox" src="https://mdn.mozillademos.org/files/5347/sq1ftZvuape-uCT8CDfJ10Q.png" style="height: 470px; width: 708px;"></p> - -<div class="note"> -<p><strong>Remarque</strong> : Les processus en cours d'exécution de contenu sont les applications Web, et sont les processus à sandbox.</p> -</div> - -<h4 id="Implémentation_des_API_de_Gecko">Implémentation des API de Gecko</h4> - -<p>Les API exposées via JavaScript dans le processus de contenu ne devrait jamais tenter d'accéder aux ressources du système de fichiers directs. Au lieu de cela, ils doivent émettre un appel IPDL pour la ressource. Cela signifie que toute API faisant accès à la ressource doit avoir une composante dans le processus parent d'accéder à la ressource pour le compte du processus de contenu.</p> - -<p>Des précautions supplémentaires doivent être prises lors de l'implémentation des appels. Toutes les entrées doivent être désinfectés par le processus parent. Le contenu processus ne peut pas être digne de confiance, et de la IPDL messages provenant du contenu processus ne peut pas être digne de confiance.</p> - -<div class="warning"> -<p><strong>Attention</strong> : Toute confiance accordée au processus de contenu peut et sera utilisé pour échapper à la sandbox.</p> -</div> - -<h4 id="Qu'est-ce_que_seccomp">Qu'est-ce que seccomp</h4> - -<p>Seccomp signifie le mode de calcul sécurisé. Il y a actuellement 2 version de seccomp:</p> - -<ol> - <li> - <p><code>seccomp</code>, disponibles dans le noyau Linux 2.6.12 et ci-dessus:</p> - - <ul> - <li> - <p>Activation <code>seccomp</code> limite les appels des processus du système à lire, écrire, sigreturn, et la sortie.</p> - </li> - <li> - <p>Utilise l'appel système <code>prctl()</code>.</p> - </li> - <li> - <p>Peut être démarré après l'initialisation du processus, dans un lieu d'arbitrage.</p> - </li> - </ul> - </li> - <li> - <p><code>seccomp-bpf</code> également appelé mode filtre seccomp ou mode 2, est disponible dans le noyau Linux 3.5 et ci-dessus:</p> - - <ul> - <li> - <p>Identique à <code>seccomp</code>, mais met en oeuvre BPF pour filtrer les appels système.</p> - </li> - <li> - <p>Peut utiliser une liste blanche des d'appels et arguments systèmes lors de l'initialisation, au lieu d'appels système codé en dur.</p> - </li> - <li> - <p>Plus flexible, permet une "sandbox plus permissive". Utile pour sandbox légèrement plus faibles, et pour un chemin de transition vers "sandbox stricte".</p> - </li> - <li> - <p>Ajoute un drapeau qui empêche les processus de traitement et de l'enfant pour revenir privilèges.</p> - </li> - </ul> - </li> -</ol> - -<div class="note"> -<p><strong>Remarque</strong> : En raison de la flexibilité accrue qui est permi, nous avons décidé d'utiliser seccomp-bpf, avec rétroportage à tout noyau <3.5. Cela inclut la plupart des noyaux Android actuels. Un patch est déjà disponible et peut généralement être appliquée sans conflits (voir le bogue 790923).</p> -</div> - -<h4 id="Performances_seccomp-bpf">Performances seccomp-bpf</h4> - -<p>Les performance <code>seccomp-bpf</code> à des impacts chaque fois qu'il y a un appel system . Il n'y a pas de référence exacte, comme la mesure dépend de la mise en œuvre. Nous estimons que cela peut influer sur les performances jusqu'à 1% quand un appel système est fait et seccomp-bpf est activé pour le processus en cours. Cela reste à être mesurée par QA.</p> - -<p>Étant donné que le nombre d'appels système est considérablement réduit dans notre modèle de processus, nous prévoyons également l'impact sur les performances du monde réel qui devrait être presque nulle.</p> - -<p>Les appels IPDL peuvent toutefois ajouter la latence et réduire les performances, en fonction de leur mise en œuvre. Il est fortement recommandé de regarder la <a href="https://bugs.chromium.org/p/chromium/issues/detail?id=29120">mise en œuvre de chrome</a> pour les API gourmandes en ressources telles que les appels OpenGL. De façon similaire à seccomp-bpf, si nous réduisons le nombre d'appel IPDL, nous allons minimiser les impacts sur les performances.</p> - -<h3 id="Implémentation_2">Implémentation</h3> - -<p><code>seccomp</code> est activé dans Gecko <em>avec <code>--enable-content-sandbox</code>.</em></p> - -<p>Le reporteur, qui reporte les appel systèmes refusé (le cas échéant) ne soit jamais construit par défaut et est activé avec l'option <code>--enable-content-sandbox-reporter</code>.</p> - -<p>La majeure partie du code est dans<em> </em><code>gecko/security/sandbox</code>. Le liste blanche elle-même est stocké dans <code>gecko/security/sandbox/seccomp_filter.h</code>.</p> - -<p>La liste blache peut contenir des appels système qui peuvent être utilisés les cloisonnements. En règle générale, ces appels ont des commentaires indiquant pourquoi, et devraient éventuellement être supprimés lorsque le code affecté est fixé. Par conséquent, il est presque jamais OK pour ajouter le code qui va briser le sandbox, puis ajoutez l'appel dans la liste blanche, sans un examen très attentif. Dans le doute, soulever un bug. La plupart du temps cependant, ce qui est faux, et la ressource devrait plutôt être contrôlé, accessible par le processus de b2g, puis passé au processus de contenu si l'accès est accordé et / ou les données sont filtrées.</p> - -<h2 id="Durcissement_du_système_de_fichiers">Durcissement du système de fichiers</h2> - -<h3 id="Risques_3">Risques</h3> - -<ul> - <li>L'écriture, la suppression ou la lecture de fichiers appartenant à un autre utilisateur; cela pourrait entraîner une fuite d'informations ou un comportement inattendu, comme une escalade de privilège.</li> - <li>Exécution de code natif par une vulnérabilité d'application.</li> - <li>Des vulnérabilités dans les programmes <code>setuid</code> (et donc, une escalade de privilège).</li> -</ul> - -<h3 id="Implémentation_3">Implémentation</h3> - -<p>La raison en est que seules les zones qui contiennent du contenu d'utilisateur peut être en lecture-écriture (à moins que le système d'exploitation lui-même exige une nouvelle zone de lecture-écriture dans le futur), et doivent inclure<code>nodev</code>, <code>nosuid</code>, et <code>noexec</code> Les supports du système de fichiers standard sont limitées comme suit:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Point de montage</th> - <th scope="col">Système de fichiers</th> - <th scope="col">Options</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>/</code></td> - <td>rootfs</td> - <td>read-only</td> - </tr> - <tr> - <td><code>/dev</code></td> - <td>tmpfs</td> - <td>read-write, nosuid, noexec, mode=0755</td> - </tr> - <tr> - <td><code>/dev/pts</code></td> - <td>ptsfs</td> - <td>read-write, nosuid, noexec, mode=0600</td> - </tr> - <tr> - <td><code>/proc</code></td> - <td>proc</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/sys</code></td> - <td>sysfs</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/cache</code></td> - <td>yaffs2 or ext4</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/efs</code></td> - <td>yaffs2 or ext4</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/system</code></td> - <td>ext4</td> - <td>read-only, nodev</td> - </tr> - <tr> - <td><code>/data</code></td> - <td>ext4</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/mnt/sdcard</code></td> - <td>ext4 or vfat</td> - <td>read-write, nosuid, nodev, noexec, uid=1000, fmask=0702, dmask=0702</td> - </tr> - <tr> - <td><code>/acct</code></td> - <td>cgroup</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - <tr> - <td><code>/dev/cpuctl</code></td> - <td>cgroup</td> - <td>read-write, nosuid, nodev, noexec</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Remarque</strong> : Les points de montage exacts peuvent varier.</p> -</div> - -<h3 id="Linux_DAC">Linux DAC</h3> - -<p>Le Linux DAC représente le modèle d'autorisation de système de fichiers de Linux bien connue.</p> - -<div class="note"> -<p><strong>Remarque</strong> : Ceci est le traditionel user/group/other modèle d'autorisation et non les Linux POSIX 1E ACLs.</p> -</div> - -<ul> - <li>L'utilisateur du système d'application Web n'a pas accès en écriture à un fichier.</li> - <li>L'utilisation des binaires <code>setuid</code> est limité si nécessaire.</li> - <li>Les nouveaux procédés de contenu sont lancés avec un <code>umask</code> sain d'esprit.</li> -</ul> - -<h2 id="Mises_à_jour_du_système_sécurisé">Mises à jour du système sécurisé</h2> - -<h3 id="Risques_4">Risques</h3> - -<ul> - <li>Données du package de mise à jour compromise, résultant dans un package de mise à jour untrusted en cours d'installation.</li> - <li>Vérification de mise à jour compromis : - <ul> - <li>L'utilisateur ne voit pas de nouvelles mises à jour qui sont disponibles.</li> - <li>L'utilisateur reçoit un paquet obselete comme une mise à jour, ce qui dégrade efficacement le logiciel sur le dispositif.</li> - </ul> - </li> - <li>L'état du système compromis ou inconnu lors de l'installation de la mise à jour; cela peut (par exemple) conduire à: - <ul> - <li>Éléments au cours de l'installation, dont certains peuvent avoir des correctifs de sécurité manquants.</li> - <li>Les corrections de sécurité rétrocédées par le système compromis après la mise à niveau.</li> - </ul> - </li> - <li>Des vulnérabilités dans la mise à jour de vérification mécanisme fonctionnant sur le dispositif.</li> - <li>Le manque de mises à jour sur le suivi d'un composant logiciel avec une vulnérabilité connue.</li> -</ul> - -<h3 id="Implémentation_4">Implémentation</h3> - -<p>Mises à jour ultérieures et des correctifs à la plate-forme Firefox OS sont déployés en utilisant un processus sécurisé de Mozilla qui assure l'intégrité continue de l'image du système sur le téléphone mobile. La mise à jour est créé par un connu, source de confiance - habituellement le OEM de l'appareil - qui est responsable de l'assemblage, la construction, les essais et la signature numérique du package de mise à jour.</p> - -<h4 id="Firmware_over_the_air_updates">Firmware over the air updates</h4> - -<p>Les mises à jour du système peuvent concerner tout ou une partie de la pile Firefox OS. Si des modifications à Gonk sont inclus dans la mise à jour, puis la FOTA (Firmware Over the Air) est le processus d'installation utilisé. les mises à jour FOTA peuvent également inclure toute autre partie de la pile de Firefox OS, y compris la gestion des périphériques (FOTA, firmware / pilotes), la gestion des paramètres (réglages du système d'exploitation Firefox), les mises à jour de sécurité, Gaia, Gecko, et d'autres correctifs.</p> - -<h4 id="Mises_à_jours_MSUMAR">Mises à jours MSU/MAR</h4> - -<p>Les mises à jour qui ne concernent pas Gonk peuvent être effectuées en utilisant l'utilitaire Mozilla System Update. Firefox OS utilise le même cadre de mise à jour, les processus et Mozilla ARchive (MAR) Format (utilisé pour les packages de mise à jour) que le produit Firefox Desktop.</p> - -<h4 id="Service_de_mise_à_jour">Service de mise à jour</h4> - -<div class="note"> -<p><strong>Remarque</strong> : Le service de mise à jour peut être fourni par l'OEM.</p> -</div> - -<p>Un service de mise à jour intégrée sur le téléphone mobile vérifie périodiquement les mises à jour du système. Une fois un paquet de système devient disponible et est détecté par le service de mise à jour, l'utilisateur est invité à confirmer l'installation. Avant que les mises à jour s'installes sur l'appareil mobile, le stockage de l'appareil est vérifié pour un espace suffisant pour appliquer la mise à jour, et la distribution est vérifiée:</p> - -<ul> - <li>Mettre à jour l'origine (vérifier le protocole de localisation de la source: domain: port de la mise à jour du système et manifeste).</li> - <li>L'intégrité des fichiers (checksums de hachage cryptographique).</li> - <li>signature de code (certificat de vérification contre une racine de confiance).</li> -</ul> - -<p>Les mesures de sécurité suivantes sont utilisées au cours du processus de mise à jour:</p> - -<ul> - <li>Mozilla recommande et espère que les mises à jour sont récupérées via une connexion SSL avec un certificat de confiance.</li> - <li>Vérification cryptographique forte est nécessaire avant l'installation d'un package de firmware.</li> - <li>La mise à jour complète doit être téléchargé dans un endroit précis et sécurisé avant le début du processus de mise à jour.</li> - <li>Le système doit être dans un état sécurisé lorsque le processus de mise à jour commence, sans applications Web en cours d'exécution.</li> - <li>Les clés doivent être stockés dans un emplacement sécurisé sur le périphérique.</li> -</ul> - -<p>Des contrôles rigoureux sont en place pour veiller à ce que la mise à jour est appliquée correctement sur le téléphone mobile.</p> - -<div class="note"> -<p><strong>Remarque</strong>: Pour plus d'informations sur les mises à jour de la plate-forme, lisez Création et application de packages de mise à jour de Firefox OS.</p> -</div> diff --git a/files/fr/archive/b2g_os/simulator/index.html b/files/fr/archive/b2g_os/simulator/index.html deleted file mode 100644 index 4c657e5d09..0000000000 --- a/files/fr/archive/b2g_os/simulator/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: Simulateur Firefox OS -slug: Archive/B2G_OS/Simulator -tags: - - Apps - - Firefox OS - - Tools - - WebIDE - - simulator -translation_of: Archive/B2G_OS/Simulator ---- -<div class="note"> -<p>Cette page décrit le fonctionnement du simulateur Firefox OS pour les versions de Firefox OS 1.2 et supérieures. Si vous développez des applications sur Firefox OS 1.1, consultez la documentation du <a href="/fr/docs/Tools/Firefox_OS_1.1_Simulator">simulateur pour Firefox OS 1.1</a>.</p> -</div> - -<p>Le simulateur Firefox OS (<em>Firefox OS Simulator</em> en anglais) est une version des couches supérieures de Firefox OS qui permet de simuler le fonctionnement d'un appareil Firefox OS sur un ordinateur de bureau. Cela signifie que, pour la plupart des cas, il n'est pas nécessaire d'avoir un vrai appareil pour déboguer l'application. Le simulateur s'affiche dans une fenêtre de la même taille qu'un appareil Firefox OS, comprend l'interface utilisateur de Firefox OS et les applications natives, il permet également de simuler plusieurs API matérielles pour Firefox OS.</p> - -<p>Le simulateur est distribué comme un module complémentaire pour Firefox. Une fois que vous l'avez téléchargé et installé dans Firefox, vous pouvez le lancer, y envoyer des applications ainsi qu'utiliser les outils de développement avec <span style="line-height: 1.5;"><a href="/fr/Firefox_OS/Using_the_App_Manager">le gestionnaire d'applications</a> et, sous <a href="https://nightly.mozilla.org/">Nightly</a>/<a href="https://www.mozilla.org/firefox/channel/#aurora">Aurora</a>, avec </span><a href="/fr/docs/Tools/WebIDE"><span style="line-height: 1.5;">WebIDE</span></a><span style="line-height: 1.5;">.</span></p> - -<h2 id="Installation"><span style="line-height: 1.5;">Installation</span></h2> - -<p><span style="line-height: 1.5;">Pour installer le simulateur, utilisez le panneau de gestion des simulateurs de <a href="https://developer.mozilla.org/docs/Tools/WebIDE#Adding_a_Simulator">WebIDE</a> (disponible depuis Firefox 33). Plusieurs versions sont disponibles, </span>et il est recommandé de toutes les installer pour plus de flexibilité.</p> - -<p>Pour lancer le simulateur, choisissez-le dans la liste des environnements de WebIDE. Pour plus de détails, voir les <a href="https://developer.mozilla.org/docs/Tools/WebIDE#Selecting_a_runtime" style="font-size: 14px; font-weight: normal; line-height: 1.5;">instructions dans la documentation WebIDE</a>. Une fois que le simulateur est lancé, vous pouvez y envoyer des applications et les déboguer grâce à WebIDE, comme vous le feriez avec un vrai appareil.</p> - -<p>Si vous utilisez <a href="/Firefox_OS/Using_the_App_Manager">App Manager</a> (l'ancien outil, disponible avant WebIDE), vous pouvez installer un simulateur en cliquant sur le bouton suivant :</p> - -<p><a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" style="margin-bottom: 20px; padding: 10px; color: white; text-align: center; border-top-left-radius: 4px; border-top-right-radius: 4px; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; display: inline-block; background-color: rgb(129, 188, 46); white-space: nowrap; text-shadow: rgba(0, 0, 0, 0.247059) 0px 1px 0px; box-shadow: rgba(0, 0, 0, 0.2) 0px 1px 0px 0px, rgba(0, 0, 0, 0.298039) 0px -1px 0px 0px inset;">Installer le simulateur</a></p> - -<h2 id="L'interface_utilisateur_du_simulateur" style="line-height: 30px;">L'interface utilisateur du simulateur</h2> - -<p><span style="line-height: 22.00800132751465px;">Le simulateur apparaît dans une fenêtre séparée dont les dimensions sont telles que l'écran représenté mesure 320x480 pixels. Pour simuler les événements tactiles, vous pouvez cliquer avec la souris et la déplacer en maintenant le clic.</span><span style="line-height: 22.00800132751465px;"> Ainsi, si vous cliquez et que vous « tirez » l'écran de la droite vers la gauche avec la souris, vous devriez voir les applications natives ainsi que les applications que vous avez ajoutées :</span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/7173/simulator-1.2.png" style="display: block; height: 623px; margin: 0px auto; width: 810px;"></p> - -<p>Le simulateur possède deux boutons dans une barre d'outils située en bas :</p> - -<ul> - <li>le bouton situé à gauche vous ramène à l'écran d'accueil ou éteint le simulateur si vous le maintenez enfoncé</li> - <li>le bouton situé à droite permet de passer du mode portrait au mode paysage et vice versa pour simuler le changement d'orientation de l'appareil. Cela génèrera un événement <a href="/docs/Web/API/CSS_Object_Model/Managing_screen_orientation#Listening_orientation_change" title="/docs/Web/API/CSS_Object_Model/Managing_screen_orientation#Listening_orientation_change">orientationchange</a>.</li> -</ul> - -<h2 id="Émulation_de_carte_SD">Émulation de carte SD</h2> - -<p>Dans le simulateur, la carte SD est mappée au dossier "fake-sdcard" dans le profil du simulateur. Profil qui est situé dans le dossier "extensions" du profil Firefox dans lequel le simulateur est installé. Par exemple :</p> - -<pre class="language-html"><code class="language-html">/path/to/Firefox/Profiles/Firefox-profile-name/extensions/fxos_2_2_simulator@mozilla.org/profile/fake-sdcard</code></pre> - -<div class="line-number" style="top: 0px;"> </div> - -<p>Les fichiers lus ou écrits utilisant l'API <code><a href="https://developer.mozilla.org/en-US/docs/Web/API/Navigator.getDeviceStorage">getDeviceStorage</a></code> apparaitront ici.</p> - -<p>Dans les versions antérieures à la version 2.2, il fallait créer le répertoire "fake-sdcard" manuellement. Depuis la version 2.2, le répertoire est créé automatiquement.</p> - -<p>De plus, depuis la version 2.2, il est possible de définir un répertoire différent en utilisant le simulateur en ligne de commande et en passant l'option<code>--storage-path</code>.</p> - -<h2 id="Les_limites_du_simulateur">Les limites du simulateur</h2> - -<p>Le simulateur Firefox OS possède quelques limitations qui empêchent une simulation parfaitement réaliste.</p> - -<h3 id="Les_limites_matérielles">Les limites matérielles</h3> - -<p>En dehors de la taille de l'écran, le simulateur ne simule aucune des limitations matérielles d'un appareil Firefox OS comme peuvent l'être la mémoire disponible ou la vitesse du processeur.</p> - -<h3 id="Les_codecs_audiovidéo">Les codecs audio/vidéo</h3> - -<p>Les codecs suivants se basent sur une accélération matérielle du décodage et ne sont donc pas supportés :</p> - -<ul> - <li>MP3</li> - <li>AAC</li> - <li>H.264 (MP4)</li> - <li>WebM</li> -</ul> - -<p>Cela signifie qu'il n'est pas possible d'utiliser le simulateur pour lire des vidéos en boucle ou utiliser des sites web comme YouTube qui utilisent ces codecs.</p> - -<h3 id="API_non_supportées"><a name="Unsupported-APIs">API non supportées</a></h3> - -<p>Certaines API qui fonctionnent sur les appareils ne fonctionneront pas avec le simulateur. La plupart du temps, cela est dû à une absence du matériel nécessaire pour ces API. Des simulations de ces API ont été faites (par exemple pour la géolocalisation). Il est prévu d'en ajouter d'autres pour les versions à venir. Malgré cela, les API qui suivent ne sont pas supportées et leur utilisation pourra renvoyer des erreurs ou des résultats incorrects :</p> - -<ul> - <li><a href="/fr/docs/Web/Guide/Telephony" title="/fr/docs/Web/Guide/Telephony">Telephony</a></li> - <li><a href="/fr/docs/WebAPI/WebSMS" title="/fr/docs/WebAPI/WebSMS">WebSMS</a></li> - <li><a href="/fr/docs/WebAPI/WebBluetooth" title="/fr/docs/WebAPI/WebBluetooth">WebBluetooth</a></li> - <li><a href="/fr/docs/WebAPI/Utiliser_les_événéments_de_luminosité" title="/fr/docs/WebAPI/Utiliser_les_événéments_de_luminosité">Ambient Light</a></li> - <li><a href="/fr/docs/WebAPI/Proximity" title="/fr/docs/WebAPI/Proximity">Proximity</a></li> - <li><a href="/fr/docs/WebAPI/Network_Information" title="/fr/docs/WebAPI/Network_Information">Network Information</a></li> - <li><a href="/fr/docs/Évènements_online_et_offline" title="/en-US/docs/Online_and_offline_events">événements navigator.onLine et navigator.offline</a></li> - <li><a href="/docs/Web/Guide/API/Vibration" title="/docs/Web/Guide/API/Vibration">Vibration</a></li> -</ul> - -<h2 id="Obtenir_de_l'aide"><a name="Simulator-help"></a>Obtenir de l'aide</h2> - -<p><span style="line-height: 1.5;">Si vous avez une question, vous pouvez la poser (en anglais) sur la liste de diffusion</span><a href="https://lists.mozilla.org/listinfo/dev-developer-tools" style="line-height: 1.5;">dev-developer-tools</a><span style="line-height: 1.5;"> ou sur IRC sur le canal </span><a href="irc://irc.mozilla.org/#devtools" style="line-height: 1.5;">#devtools de irc.mozilla.org</a><span style="line-height: 1.5;">.</span></p> - -<h3 id="Activer_les_enregistrements_verbeux_(verbose_logging)"><a name="Simulator-verbose-logging"></a>Activer les enregistrements verbeux (<em>verbose logging</em>)</h3> - -<p>Vous pouvez voir les messages enregistrés depuis votre application dans la <a href="/fr/docs/Outils/Web_Console">console Web</a>, que vous pouvez lier à votre application en utilisant <a href="/docs/Tools/WebIDE/Troubleshooting">WebIDE</a>. Si vous souhaitez obtenir des messages pour le moment où l'application démarre, avant que la console soit connectée et fonctionne, vous devrez activer le mode verbeux pour les enregistrements (<em>logs</em>).</p> - -<p>Allez dans about:config et <strong>créez </strong>une nouvelle option. Le nom de l'option est différent en fonction de la version du simulateur utilisée :</p> - -<ul> - <li>extensions.fxos_1_3_simulator@mozilla.org.sdk.console.logLevel pour Firefox OS 1.3</li> - <li>extensions.fxos_1_2_simulator@mozilla.org.sdk.console.logLevel pour Firefox OS 1.2</li> -</ul> - -<p>Fixez la valeur de cette chaîne de caractère à "all", ensuite, désactivez puis réactivez le module complémentaire dans le gestionnaire de modules complémentaires. Vous devriez maintenant pouvoir lire de nouveaux messages dans la <a href="/fr/docs/Console_JavaScript">console JavaScript du navigateur</a>.</p> - -<h2 id="Compiler_le_Simulateur">Compiler le Simulateur</h2> - -<p>Si vous voulez tester des patchs du code de Gecko ou de Gaia que le Simulateur contient, il est possible que vous ayez envie de <a href="/fr/Firefox_OS/Running_custom_builds_in_the_App_Manager">modifier le Simulateur</a> pour utiliser une version personnalisée de Gecko ou un profil personnalisé de Gaia. Il est également possible de compiler un nouveau Simulateur depuis votre checkout de Gecko.</p> diff --git a/files/fr/archive/b2g_os/simulator_vs_emulator_vs_device/index.html b/files/fr/archive/b2g_os/simulator_vs_emulator_vs_device/index.html deleted file mode 100644 index c6b95f5bbf..0000000000 --- a/files/fr/archive/b2g_os/simulator_vs_emulator_vs_device/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Simulateur vs. Émulateur vs. Appareil -slug: Archive/B2G_OS/Simulator_vs_Emulator_vs_Device -tags: - - Firefox OS - - QA - - test -translation_of: Archive/B2G_OS/Developing_Gaia/Different_ways_to_run_Gaia ---- -<p>Trois options de base sont possibles pour obtenir un environnement Firefox OS afin de travailler ou développer dessus. Il y a le Simulateur Firefox OS, l'Émulateur Firefox OS et enfin Firefox OS sur un téléphone compatible Firefox OS.</p> - -<p>Les utilisateurs finaux ne sont en contact avec Firefox OS que sur un véritable appareil, néanmoins, le Simulateur et l'Émulateur offrent une alternative accessible pour les développeurs qui visent Firefox OS. Pour la majorité d'entre-eux, le Simulateur ou l'Émulateur seront suffisants, mais gardez à l'esprit qu'il y a des cas où leur comportement sera partiel ou différent de celui d'un appareil. Les descriptions ci-dessous devraient vous aider à choisir parmi les trois options celle qui sera la meilleure pour vous.</p> - -<h2 id="Le_Simulateur_Firefox_OS">Le Simulateur Firefox OS</h2> - -<p>Le Simulateur Firefox OS est une extension pour le navigateur Firefox. Il est principalement destiné à être utilisé par les développeurs d'applications.</p> - -<h3 id="Avantages">Avantages</h3> - -<ul> - <li>De loin l'option la plus simple et la plus rapide à mettre en oeuvre parmi les trois.</li> -</ul> - -<h3 id="Inconvénients">Inconvénients</h3> - -<ul> - <li>La moins complète des quatre options.</li> - <li>TODO lister ici ce que le simulateur ne gère pas</li> -</ul> - -<h2 id="Le_client_Firefox_OS_pour_ordinateur">Le client Firefox OS pour ordinateur</h2> - -<p>Le <a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client">client Firefox OS pour ordinateur</a>, également appelé <em>B2G desktop client</em>, permet d'exécuter des applications Web et Gaia dans un environnement basé sur Gecko quelque peu similaire à un véritable appareil. Comme il n'émule pas le matériel de l'appareil, il n'est pas adapté pour tester les APIs des périphériques et ne remplace pas un vrai matériel pour faire des tests. Cependant, il intègre plusieurs APis qui ne sont pas disponibles dans Firefox comme les APIs Contacts et Settings. Il peut donc être utile pendant le développement de votre application, ou lors du travail sur l'interface utilisateur Gaia elle-même.</p> - -<h2 id="L'Émulateur_Firefox_OS">L'Émulateur Firefox OS</h2> - -<p>L'Émulateur Firefox OS est un programme compilé à partir du code source de Firefox OS et exécuté sur une machine de bureau. En général, les développeurs qui ont besoin d'un environnement Firefox OS plus complet que le Simulateur choisiront cette option. (Voir Opera Mobile Emulator pour les fonctionnalités)</p> - -<h3 id="Avantages_2">Avantages</h3> - -<ul> - <li>Ressemble davantage à un véritable appareil.</li> - <li>Peut être utilisé et testé avec le débogage à distance</li> - <li>Selenium peut y accéder pour les tests</li> - <li>Peut être configuré avec des profils prédéfinis (taille d'écran, caractéristiques, etc.)</li> - <li>TODO lister ce qu'il propose en plus ou en moins par rapport au simulateur.</li> -</ul> - -<h3 id="Inconvénients_2">Inconvénients</h3> - -<ul> - <li>Mettre en place un environnement de construction Firefox OS et compiler les sources requiert beaucoup de ressources et de temps, et souvent cela nécessite des dépannages à différentes étapes du processus. (sauf si c'est un binaire téléchargé déjà construit comme Opera Mobile Emulator)</li> - <li>TODO lister les différences par rapport au comportement d'un appareil.</li> -</ul> - -<h2 id="Firefox_OS_sur_un_appareil">Firefox OS sur un appareil</h2> - -<p>En général, les développeurs qui travaillent sur le code du coeur de Firefox OS (gonk, gecko) ou qui souhaitent tester leurs applications (ou des modifications de gaia) sur un vrai appareil choisiront cette option.</p> - -<h3 id="Avantages_3">Avantages</h3> - -<ul> - <li>C'est un objet concret - toutes les APIs sont disponibles.</li> - <li>TODO lister ce qu'il y a en plus ou en moins par rapport au simulateur.</li> -</ul> - -<h3 id="Inconvénients_3">Inconvénients</h3> - -<ul> - <li>Compiler les sources consomme des ressources et du temps, des interventions de dépannage sont souvent nécessaires.</li> - <li>Parmi les trois options, c'est celle où les barrières sont les plus difficiles à franchir car cela impose au développeur de posséder un appareil qu'il veut bien flasher.</li> - <li>En fonction des problèmes rencontrés, le débogage sur un appareil réel peut se révéler plus difficile que sur le Simulateur ou l'Émulateur.</li> - <li>TODO lister plus de choses</li> -</ul> diff --git a/files/fr/archive/b2g_os/spark/index.html b/files/fr/archive/b2g_os/spark/index.html deleted file mode 100644 index 26b1466bdd..0000000000 --- a/files/fr/archive/b2g_os/spark/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Spark -slug: Archive/B2G_OS/Spark -translation_of: Archive/B2G_OS/Building_and_installing_B2G_OS ---- -<div class="warning"> -<p>Spark est compilé de la même manière que Firefox OS, excepté que la variable d'environnement <em>GAIA_DISTRIBUTION_DIR=distros/spark</em> est définie.</p> -</div> - -<h3 id="Compiler_B2G_avec_Spark">Compiler B2G avec Spark</h3> - -<p><a href="/fr/Firefox_OS/Compiler#Compiler_Boot_to_Gecko">Article principal : Compiler Boot2Gecko</a></p> - -<pre>GAIA_DISTRIBUTION_DIR=distros/spark ./build.sh</pre> - -<h3 id="Compiler_Gaia_avec_Spark">Compiler Gaia avec Spark</h3> - -<p><a href="/fr/Firefox_OS/Developing_Gaia/Référence_options_make">Article principal : Développer pour Gaia - référence des options de make</a></p> - -<pre>GAIA_DISTRIBUTION_DIR=distros/spark make</pre> diff --git a/files/fr/archive/b2g_os/tips_and_tricks/faire_des_captures_ecran/index.html b/files/fr/archive/b2g_os/tips_and_tricks/faire_des_captures_ecran/index.html deleted file mode 100644 index 8834995d79..0000000000 --- a/files/fr/archive/b2g_os/tips_and_tricks/faire_des_captures_ecran/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Faire des captures d'écran -slug: Archive/B2G_OS/Tips_and_tricks/faire_des_captures_ecran -translation_of: Archive/B2G_OS/Debugging/taking_screenshots ---- -<p class="summary">Prendre des captures d'écran de votre application peut être utile à plusieurs égards, comme pour montrer votre travail à un client,<span id="result_box" lang="fr"> <span class="hps">frimer devant</span> <span class="hps">vos amis avec votre</span> <span class="hps">téléphone</span> <span class="hps">FxOS</span></span>, ou encore publier une application sur le Marketplace. Cet article explique comment faire des captures d'écran sur votre appareil Firefox OS.</p> - -<div class="note"> -<p><strong>Note</strong>: Les développeurs Android ne seront pas perdu car les étapes sont assez similaires.</p> -</div> - -<h2 id="Préparer_votre_téléphone">Préparer votre téléphone</h2> - -<ol> - <li>Sur votre téléphone, ouvrez les <a href="https://developer.mozilla.org/fr/Firefox_OS/Debugging/Developer_settings">paramètres pour développeurs</a> puis cochez : <em>Débogage distant</em> et<em> Console activée</em>.</li> - <li>Assurez-vous qu'<a href="https://developer.mozilla.org/fr/Firefox_OS/Debugging/Installing_ADB">ADB est installé et fonctionnel</a> sur votre ordinateur.</li> - <li>Branchez votre téléphone au port USB de votre ordinateur.</li> -</ol> - -<p>Sur votre téléphone, allez dans Paramètres > Informations > Plus d'informations > Développeurs</p> - -<h2 id="Prendre_une_capture_d'écran">Prendre une capture d'écran</h2> - -<p>Maintenant vous avez quatre choix possibles : le terminal, DDMS dans Eclipe, la combinaison de boutons dédiée sur le téléphone, ou le gestionnaire d'application.</p> - -<h3 id="Terminal">Terminal</h3> - -<p>Ouvrez une fenêtre de terminal, et exécutez les trois commandes suivantes:</p> - -<ol> - <li>Prendre une capture d'écran (l'image s'appellera "capture.png" dans l'exemple)<br> - <code>adb shell screencap -p /sdcard/capture.png</code></li> - <li>Transférer l'image sur votre ordinateur<br> - <code>adb pull /sdcard/capture.png</code></li> - <li>Supprimer l'image de votre appareil<br> - <code>adb shell rm /sdcard/capture.png</code></li> -</ol> - -<p>Vous désirez en apprendre plus sur ADB ? Regardez la <a href="http://developer.android.com/tools/help/adb.html" lang="en-US" title="http://developer.android.com/tools/help/adb.html">documentation d'ADB</a>.</p> - -<p>Autrement, vous pouvez utiliser ffmpeg:</p> - -<ol> - <li>Assurez-vous d'avoir ffmpeg installé: - <ol> - <li>Sur Mac, si vous utilisez MacPorts, vous pouvez exécuter <code>sudo port install ffmpeg</code>. Pour homebrew, exécutez <code>brew install ffmpeg</code>.</li> - <li>Sur Linux (Ubuntu/Debian), exécutez <code>sudo apt-get install ffmpeg</code>.</li> - </ol> - </li> - <li>Placez vous dans le bon dossier : <code>cd B2G/gaia</code>.</li> - <li>Utilisez la commande <code>make screenshot</code> pour réaliser la capture d'écran.</li> - <li>L'image créée s'appelle <code>screenshot.png</code>.</li> -</ol> - -<h3 id="DDMS">DDMS</h3> - -<p>Ouvrez Eclipse.</p> - -<ol> - <li>Ouvrez DDMS<br> - <em>Fenêtre</em> > <em>Ouvrir la Perspective</em> > <em>Autres</em> > <em>DDMS</em></li> - <li>Sur le panneau de gauche dans l'onglet <em>Appareils</em>, cliquez sur le bouton <em>Capture d'écran</em>.</li> - <li>Une nouvelle fenêtre apparaît avec plusieurs options, cliquez sur le bouton <em>Enregistrer</em> pour sauvegarder votre image.</li> -</ol> - -<div class="note"> -<p><strong>Note</strong>: Pour en savoir plus sur DDMS, regardez la <a href="http://developer.android.com/tools/debugging/ddms.html" lang="en-US" title="http://developer.android.com/tools/debugging/ddms.html">documentation de DDMS</a>.</p> -</div> - -<h3 id="Boutons_du_téléphone">Boutons du téléphone</h3> - -<ol> - <li>Sur les versions Firefox OS 2.0 et précédentes, appuyez simultanément sur les boutons <em>Accueil</em> et <em>Bouton d'alimentation</em> pendant quelques secondes.</li> - <li>À partir de la version Firefox OS 2.1, appuyez simultanément sur les boutons <em>Volume moins</em> et <em>Bouton d'alimentation</em> pendant quelques secondes.</li> -</ol> - -<p>Ceci fait une capture d'écran qui est sauvegardée dans votre Galerie. Ensuite il vous suffit de récupérer l'image sur votre carte SD par la méthode de votre choix.</p> - -<div class="note"> -<p><strong>Note</strong>: La combinaison de boutons fut modifiée parce que de nombreuses personnes la trouvaient plus compliquée que nécessaire, particulièrement avec une seule main. Et aussi parce que les appareil sans bouton <em>Accueil</em> matériel ne sont pas très bien supportés (il n'est pas possible d'utiliser le bouton <em>Accueil</em> logiciel partout, comme par exemple sur l'écran de verrouillage).</p> -</div> - -<h3 id="Le_gestionnaire_d'applicationsimulateur">Le gestionnaire d'application/simulateur</h3> - -<ol> - <li>Ouvrez le <a href="https://developer.mozilla.org/fr/Firefox_OS/Using_the_App_Manager">gestionnaire d'application</a>, connectez votre téléphone, et naviguez jusqu'à l'onglet <strong>Appareil</strong> sur la gauche.</li> - <li>Cliquez sur le bouton <strong>Capture d'écran</strong> en bas de la page (à l'endroit où vous démarrez le simulateur).</li> -</ol> diff --git a/files/fr/archive/b2g_os/tips_and_tricks/modifier_le_fichier_hosts/index.html b/files/fr/archive/b2g_os/tips_and_tricks/modifier_le_fichier_hosts/index.html deleted file mode 100644 index 11043f1dc3..0000000000 --- a/files/fr/archive/b2g_os/tips_and_tricks/modifier_le_fichier_hosts/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Modifier le fichier hosts -slug: Archive/B2G_OS/Tips_and_tricks/Modifier_le_fichier_hosts -translation_of: Archive/B2G_OS/Developing_Firefox_OS/modifying_hosts_file ---- -<div class="summary"> -<p>Il est parfois nécessaire d'éditer le fichier hosts de votre machine : en cas d'attaque, pour bloquer des connexions indésirables, pour rediriger des requêtes vers une adresse spécifique, etc... Cet article vous guidera à travers les étapes à effectuer pour modifier le fichier hosts de votre téléphone Firefox OS. Ce fichier se trouve par exemple dans le dossier /system/etc pour un Linux, et dans le dossier /etc dans les nouvelles versions de Mac OS X.</p> -</div> -<h2 id="Préparer_votre_téléphone">Préparer votre téléphone</h2> -<p>Sur le téléphone, allez à <a href="/fr/Firefox_OS/Déboguer/Les_paramètres_développeurs">Paramètres pour développeurs</a> et cocher :</p> -<ul> - <li>"Débogage distant" (Pour Firefox OS 1.4 et supérieur, choisissez "ADB et outils de développement" dans le menu Débogage USB")</li> - <li>"Activer la console"</li> -</ul> -<p>Branchez alors votre téléphone à votre ordinateur.</p> -<p>Les étapes suivantes, pour modifier le fichier hosts, sont les mêmes que sur Android. Les développeurs Android retrouveront rapidement leurs petits !</p> -<h2 id="Étapes_dans_le_terminal">Étapes dans le terminal</h2> -<ol> - <li>Ouvrez une fenêtre de terminal.</li> - <li>Remontez la partition /system sur le téléphone afin d'obtenir les permissions en lecture/écriture - <pre class="brush: bash">adb remount</pre> - </li> - <li>Transférez le fichier hosts vers votre ordinateur - <pre class="brush: bash">adb pull /system/etc/hosts /tmp</pre> - </li> - <li>Modifiez le fichier hosts dans /tmp/hosts selon vos besoins puis sauvegardez le. Par exemple : - <pre class="brush: bash">127.0.0.1 localhost -ip.à.rediriger nom_de_la_machine_distante</pre> - </li> - <li>Envoyez le fichier hosts modifié vers votre téléphone - <pre class="brush: bash">adb push /tmp/hosts /system/etc/hosts</pre> - </li> -</ol> -<p>Voilà, votre fichier hosts devrait maintenant être à jour.</p> -<div class="note"> - <p><strong>A noter</strong> : En savoir plus sur ADB ? La <a href="http://developer.android.com/tools/help/adb.html" title="http://developer.android.com/tools/help/adb.html">documentation ADB</a> n'attend plus que vous !</p> -</div> -<p> </p> diff --git a/files/fr/archive/b2g_os/using_the_app_manager/index.html b/files/fr/archive/b2g_os/using_the_app_manager/index.html deleted file mode 100644 index 91631c48f8..0000000000 --- a/files/fr/archive/b2g_os/using_the_app_manager/index.html +++ /dev/null @@ -1,293 +0,0 @@ ---- -title: Utiliser le gestionnaire d'applications -slug: Archive/B2G_OS/Using_the_App_Manager -tags: - - App Manager - - Apps - - Debugging - - Firefox OS - - WebIDE - - simulator -translation_of: Archive/B2G_OS/Using_the_App_Manager ---- -<div class="summary"> -<p>Le gestionnaire d'applications est un nouvel outil disponible dans Firefox pour ordinateur et qui fournit un nombre d'outils utiles pour vous aider à tester, déployer et déboguer des applications web HTML5 sur des téléphones Firefox OS ainsi que sur le simulateur de Firefox OS directement depuis votre navigateur.</p> - -<p>Le gestionnaire d'applications est destiné aux développeurs visant Firefox OS 1.2 ou plus. Si vous développez des applications pour Firefox OS 1.1, vous devriez plutôt consulter la documentation concernant le <a href="/fr/docs/Tools/Firefox_OS_1.1_Simulator">simulateur de Firefox OS 1.1</a>.</p> -</div> - -<p></p><div class="intrinsic-wrapper"><div class="intrinsic-container "><iframe src="https://www.youtube.com/embed/z1Bxg1UJVf0?rel=0&html5=1"></iframe></div></div><p></p> - -<p>Le gestionnaire d'applications est composé de :</p> - -<ul> - <li>Un <a href="#Apps_panel"><em>panneau " Applications "</em></a> qui gère les applications locales (les applications dont le code source est situé sur votre ordinateur) et les applications hébergées autre part. Il vous permet de les empaqueter et de les installer sur votre appareil ou sur votre simulateur et de les déboguer en utilisant les outils de développement.</li> - <li>Un <a href="#Device_panel"><em>panneau " Appareil "</em></a> qui affiche les informations à propos de l'appareil connecté comprenant la version de Firefox OS installée, les permissions requises pour utiliser les APIs sur l'appareil et les applications installées.</li> - <li><a href="/fr/docs/Tools_Toolbox"><em>Les outils de développement</em></a> : collection d'outils pour le développeur (console web, inspecteur, debugger, etc.) pouvant être connectés à une application en cours d'exécution via le panneau " Applications " pour réaliser des opérations de débogage.</li> -</ul> - -<h2 id="Installation_rapide"><a name="Configuring_device">Installation rapide</a></h2> - -<p><span id="result_box" lang="fr"><span class="hps">Cette section est conçue pour vous permettre de démarrer rapidement.</span></span> Si vous avez besoin de plus de détails, rendez-vous à la section <a href="#Configuration_du_syst.C3.A8me_et_de_l'appareil">Configuration du système et de l'appareil</a>. Consultez également la section <a href="#Troubleshooting">Dépannage</a>, si vous rencontrez des problèmes.</p> - -<ol> - <li>Assurez-vous que vous avez installé Firefox 26 ou plus ;</li> - <li>ouvrez le gestionnaire d'applications (tapez <code>about:app-manager dans la barre d'URL</code>).</li> - <li>En fonction de votre situation :</li> -</ol> - -<p style="margin-left: 40px;"><u>a. Si vous n'avez pas d'appareil physique</u> :<span id="cke_bm_281E" style="display: none;"> </span></p> - -<ul style="margin-left: 40px;"> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">Installez le simulateur de Firefox OS ;</a></li> - <li>dans la barre d'outils du bas du gestionnaire d'applications, cliquez sur <em>Lancer le simulateur</em>, puis cliquez sur le nom du simulateur installé pour qu'il apparaisse.<span id="cke_bm_171E" style="display: none;"> </span></li> -</ul> - -<p style="margin-left: 40px;"><u>b. Si vous avez un appareil physique</u> :</p> - -<ul> - <li>Assurez-vous que votre appareil utilise Firefox OS 1.2 ou plus ;</li> - <li>sur Windows, installez les pilotes fournis par le fabricant de votre téléphone ;</li> - <li>dans les paramètres de votre appareil, désactivez le verrouillage (<code>Paramètres > <code>Verrouillage</code></code>) et activez le débogage distant (<code>Paramètres > Informations sur l'appareil > Plus d'informations > Développeurs</code>) ;</li> - <li><a href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/">installez l'extension ADB Helper</a> sur Firefox pour ordinateur ;</li> - <li>connectez votre appareil à votre ordinateur via un câble USB ;</li> - <li>vous devriez voir le nom de votre appareil dans la barre d'outils du bas du gestionnaire d'applications, cliquez dessus.</li> -</ul> - -<p>La barre du bas devrait afficher " Connecté à xxx "</p> - -<ol> - <li>Cliquez sur le panneau <em>Applications</em> et ajoutez une application (empaquetée ou hébergée) ;</li> - <li>le bouton <em>Mettre à jour</em> valide votre application et l'installe sur le simulateur ou l'appareil ;</li> - <li>le bouton <em>Déboguer</em> connecte les outils de développement à l'application en cours d'exécution.</li> -</ol> - -<p><strong>Consultez la section <a href="#Troubleshooting">Dépannage</a>, si vous rencontrez des problèmes</strong>.</p> - -<h2 id="Configuration_du_système_et_de_l'appareil">Configuration du système et de l'appareil</h2> - -<p>La première chose que vous avez besoin de faire quand vous utilisez le gestionnaire d'applications, c'est de vous assurer que votre système et votre téléphone sont installés correctement. Cette partie va passer en revue toutes les étapes requises.</p> - -<h3 id="Firefox_1.2_requis">Firefox 1.2+ requis</h3> - -<p>Assurez-vous que votre appareil dispose de Firefox OS 1.2/Boot2Gecko 1.2 ou plus. Pour vérifier la version de Firefox OS que votre appareil utilise, rendez-vous dans <code>Paramètres > Informations sur l'appareil > Logiciel</code>.</p> - -<p>Si votre version n'est pas assez récente, selon le téléphone que vous avez, vous aurez besoin soit d'installer une version nightly téléchargeable de Firefox OS 1.2 ou plus, soit de configurer et de compiler vous-même une version de Firefox OS depuis les sources.</p> - -<p>Versions disponibles :</p> - -<ul> - <li><a href="http://downloads.geeksphone.com/">Les versions Keon/Peak de Geeksphone</a> (pour en apprendre plus sur comment les utiliser, lisez <a href="/fr/Firefox_OS/Developer_phone_guide/Geeksphone">l'article concernant Geeksphone</a>)</li> - <li>D'autres à suivre</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Pour compiler votre propre distribution de Firefox OS 1.2+, suivez les instructions afin de <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a>, en commençant par les <a href="/fr/docs/Mozilla/Firefox_OS/Prerequis_pour_construire_Firefox_OS">Prérequis pour compiler Firefox OS</a>.</p> -</div> - -<h3 id="Débogage_distant">Débogage distant</h3> - -<p>Ensuite, vous avez besoin d'activer le débogage distant dans Firefox OS. Pour ce faire, rendez-vous dans <code>Paramètres > Informations sur l'appareil > Plus d'informations > Développeurs</code> et cochez la case <em>Débogage distant</em>.</p> - -<h3 id="Adb_Helper_Add-on" name="Adb_Helper_Add-on">ADB ou ADB Helper</h3> - -<p>Le processus utilise l'Android Debug Bridge (ADB) pour la connexion et la communication entre l'ordinateur et l'appareil. Il y a deux options pour utiliser ADB :</p> - -<ul> - <li> - <p>Laissez Firefox s'occuper d'ADB (recommandé). <a class="external" href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" rel="noopener">Installer l'extension ADB Helper</a> qui rend le processus plus facile. Avec cette extension, il n'est pas nécessaire d'installer ADB et il n'y a pas besoin de taper la commande <code>adb forward</code>. Tout est pris en charge par l'extension.</p> - <a class="download-button external ignore-external" href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" rel="noopener">Télécharger l'extension ADB Helper</a></li> - <li>Utilisez ADB manuellement. ADB doit être installé sur votre ordinateur. Téléchargez et installez <code>adb</code> comme expliqué dans <a href="/fr/Firefox_OS/Debugging/Installing_ADB">Installer et utiliser ADB</a>. Vous aurez besoin d'activer la redirection de port en exécutant la commande suivante dans votre terminal : - <pre>adb forward tcp:6000 localfilesystem:/data/local/debugger-socket</pre> - Notez que vous aurez besoin de le faire à chaque fois que le téléphone sera redémarré ou qu'il sera déconnecté puis reconnecté à l'ordinateur.</li> -</ul> -<div class="note"> -<p><strong>Note</strong>: Il est inutile d'exécuter cette commande si vous avez installé l'extension ADB Helper.</p> -</div> - -<h2 id="Connecter_votre_appareil_au_gestionnaire_d'applications">Connecter votre appareil au gestionnaire d'applications</h2> - -<p>Une fois votre configuration terminée, il est temps de brancher votre appareil sur votre ordinateur et de démarrer le gestionnaire d'applications :</p> - -<ol> - <li>Branchez l'appareil sur votre ordinateur via USB ;</li> - <li>Désactivez le verrouillage sur votre appareil en allant dans <code>Paramètres > Verrouillage</code> et décochez la case <code>Écran de verrouillage</code>. C'est pratique car quand l'écran se verrouille, la connexion avec le téléphone se perd. Il ne sera donc plus disponible pour le débogage.</li> - <li>Démarrez le gestionnaire d'applications — Dans Firefox pour ordinateur, sélectionnez l'option dans le menu<code> Développement web > Gestionnaire d'applications</code>, ou tapez <code>about:app-manager</code> dans la barre d'URL.</li> - <li>Dans l'onglet du bas du gestionnaire d'application, vous verrez une barre de statut de connexion (reportez-vous à l'image ci-dessous). Vous devriez être capable de connecter votre appareil en cliquant sur le bouton « Se connecter à localhost:6000 ».</li> - <li>Si cela fonctionne, une boîte de dialogue devrait apparaître sur votre appareil : « Une requête entr<span class="highlight">an</span>te pour permettre une connexion de débogage à dist<span class="highlight">an</span>ce a été détectée. Au<span class="highlight">to</span>riser la connexion<span class="highlight-red" title="Thin space"> </span>? ». Appuyez sur le bouton OK ( vous aurez peut-être besoin d'appuyer sur le bouton « Power » du téléphone pour voir la boîte de dialogue). La barre de statut de connexion devrait s'actualiser pour afficher « Connecté à B2G » avec un bouton « Se déconnecter » pour permettre d'interrompre la connexion.</li> -</ol> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6263/connection-status.png" style="display: block; height: 30px; margin: 0px auto; width: 600px;"></p> - -<div class="note"> -<p><strong>Note </strong>: Les autres boutons dans la barre de statut de connexion vous permettent de connecter un simulateur au gestionnaire d'applications, ce que nous aborderons à la prochaine section, et de changer le port de connexion. Si vous modifiez le port de connexion, vous aurez aussi besoin d'activer la redirection sur ce port.</p> -</div> - -<h2 id="Utiliser_un_simulateur_de_Firefox_OS"><a name="Simulator">Utiliser un simulateur de Firefox OS</a></h2> - -<p>Si vous n'avez pas d'appareil physique disponible, vous pouvez essayer d'utiliser le gestionnaire d'applications sur un <a href="/en-US/docs/Tools/Firefox_OS_Simulator">simulateur de Firefox OS</a>. Pour commencer, installez le simulateur en utilisant le bouton suivant (plusieurs versions sont disponibles ; vous devriez toutes les installer pour pouvoir tester sur le plus de versions possible) :</p> - -<p><a class="download-button external ignore-external" href="https://ftp.mozilla.org/pub/mozilla.org/labs/fxos-simulator/" rel="noopener">Installer le simulateur</a></p> - -<p>Une fois que vous avez installé le ou les simulateurs, rendez-vous dans le gestionnaire d'applications et cliquez sur le bouton « Lancer le simulateur » dans la barre de statut de connexion dans l'onglet du bas. Au moins trois boutons vont apparaître :</p> - -<ul> - <li>« Firefox OS 1.3 », « Firefox OS 1.2 », etc. (ou quelque chose de similaire) : le bouton le plus à gauche contient le nom de la version des simulateurs installés. Cliquez sur l'un d'entre eux pour démarrer une connexion à un simulateur.</li> - <li>« Ajouter » : le bouton du milieu dirige vers le lien d'installation des simulateurs de cet article de façon à ce que vous puissiez installer plus de simulateurs (Firefox OS 1.2, Firefox OS 1.3, etc.).</li> - <li>« Annuler » : le bouton de droite annule la connexion.</li> -</ul> - -<h2 id="Lancer_ses_propres_versions_dans_le_gestionnaire_d'applications">Lancer ses propres versions dans le gestionnaire d'applications</h2> - -<p>Vous pouvez lancer des versions de B2G pour ordinateur et de Gaia/Gecko que vous avez compilées dans le gestionnaire d'application avec le simulateur. Lire la page <a href="/Firefox_OS/Running_custom_builds_in_the_App_Manager">lancer ses propres versions de Firefox OS/Gaia dans le gestionnaire d'applications</a> pour plus d'informations sur comment procéder.</p> - -<h2 id="Le_panneau_«_Applications_»_Tester_et_déboguer_les_applications_Firefox_OS"><a name="Apps_panel">Le panneau « Applications » : Tester et déboguer les applications Firefox OS</a></h2> - -<p>Maintenant que tout fonctionne, examinons les fonctionnalités disponibles dans le gestionnaire d'applications. Commençons avec le panneau <em>Applications</em>. D'ici, vous pouvez importer une application existante pour l'envoyer sur votre appareil et la déboguer :</p> - -<ul> - <li>Pour installer une application locale, cliquez sur le bouton « Ajouter une application empaquetée » et utilisez la boîte de dialogue pour sélectionner le répertoire dans lequel votre application se trouve.</li> - <li>Pour installer une application hébergée autre part, renseignez l'URL absolue du fichier manifeste de l'application dans le champ texte à l'intérieur de l'encadré « Ajouter une application hébergée », puis cliquez sur l'icône <img alt="plus" src="https://mdn.mozillademos.org/files/7735/plus.svg" style="height: 16px; vertical-align: middle; width: 16px;">.</li> -</ul> - -<p>Les informations à propos de votre application devraient apparaître sur le côté droit de la fenêtre, comme sur l'image ci-dessous :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6261/apps-panel.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<h3 id="L'éditeur_de_manifeste">L'éditeur de manifeste</h3> - -<p>Depuis Firefox 28, le panneau <em>Applications</em> incorpore un éditeur pour le manifeste de l'application :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6613/apps-panel-fx-28.png" style="display: block; margin: 0px auto; width: 600px;"></p> - -<h3 id="Le_débogage">Le débogage</h3> - -<p>Cliquer sur <em>« Mettre à jour »</em> mettra à jour (installera) l'application sur l'appareil. Cliquer sur <em>« Déboguer »</em> connectera les outils de développement à l'application, vous permettant ainsi de déboguer directement son code.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6265/debug.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<div class="note"> -<p>Note : <span class="short_text" id="result_box" lang="fr"><span class="hps">Découvrez en manipulant</span> <span class="hps">les outils</span></span> de développement — Essayez de modifier les DOM, CSS, etc., et vous verrez les modifications s'afficher sur votre appareil en temps réel. <span id="result_box" lang="fr"><span class="alt-edited">Ces modifications seront enregistrées dans le code de l'application installée </span></span>; vous les verrez la prochaine fois que vous lancerez l'application sur votre appareil.</p> -</div> - -<p>Avant Firefox 28, les outils de développement se lancent dans une fenêtre séparée. Depuis Firefox 28, les outils de développement se lancent dans un onglet dans le gestionnaire d'applications lui-même auprès des onglets <em>Applications</em> et <em>Appareil</em>. L'icône de votre application s'affiche dans le nouvel onglet, il est donc facile de le repérer :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6615/toolbox-fx-28.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<h3 id="Les_erreurs">Les erreurs</h3> - -<p>Si une application ne s'ajoute pas — par exemple si l'URL est incorrecte — une entrée sera ajoutée sur la page de cette application indiquant des informations sur l'erreur.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6259/apps-error.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<p>Vous pouvez également supprimer une application depuis cette vue en survolant le nom ou la description de l'application sur la gauche de la fenêtre et en cliquant sur la croix qui apparaît. Cependant, cela ne supprime pas l'application de l'appareil. Pour ce faire, vous devez supprimer l'application manuellement en utilisant directement l'appareil.</p> - -<h2 id="Le_panneau_«_Appareil_»"><a name="Device_panel">Le panneau « Appareil »</a></h2> - -<p><span id="result_box" lang="fr"><span class="alt-edited">L'onglet <em>Appareil</em> affiche des informations sur l'appareil connecté. Dans la fenêtre « Applications installées », les applications sur l'appareil peuvent être démarrées et déboguées.</span></span></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6267/device-tab.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<div class="note"> -<p>Note : Par défaut, les applications certifiées ne sont pas listées. <a href="#Debugging_Certified_Apps">Voir comment déboguer les applications certifiées.</a></p> -</div> - -<p><a name="permissions"></a>La fenêtre des « Permissions » affiche les privilèges requis pour les différentes <a href="/en-US/docs/WebAPI">API web </a>sur l'appareil actuel :</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6269/permissions.png" style="display: block; height: 375px; margin: 0px auto; width: 600px;"></p> - -<p>Enfin, vous pouvez prendre une capture d'écran de l'appareil actuel en cliquant sur le bouton « Capture d'écran ». La capture d'écran apparaitra alors dans un nouvel onglet de Firefox. Depuis celui-ci, vous pouvez le sauvegarder ou l'abandonner.</p> - -<h2 id="Déboguer_des_applications_certifiées"><a name="Debugging_Certified_Apps">Déboguer des applications certifiées</a></h2> - -<p>Actuellement, seuls les appareils tournant sous un « <em>build</em> » de Firefox OS 1.2+ sont capables de déboguer les applications certifiées. Si vous avez ce type d'appareil, vous pouvez activer le débogage d'applications certifiées en changeant les préférences <code>devtools.debugger.forbid-certified-apps</code> à <code>false</code> dans votre profil. Pour ce faire , suivez les étapes décrites ci-dessous :</p> - -<h3 id="En_utilisant_un_appareil">En utilisant un appareil</h3> - -<ol> - <li> - <p>Sur votre ordinateur, entrez la commande suivante dans le Terminal/console pour entrer dans le système de fichiers de l'appareil via l'invite de commandes :</p> - - <pre class="brush: bash">adb shell</pre> - - <p>La console devrait changer pour devenir <code>root@android</code>.</p> - </li> - <li> - <p>Ensuite, stoppez B2G en utilisant la commande suivante :</p> - - <pre class="brush: bash">stop b2g</pre> - </li> - <li> - <p>Naviguez dans le dossier suivant :</p> - - <pre>cd /data/b2g/mozilla/*.default/</pre> - </li> - <li> - <p>Il faut maintenant mettre à jour le fichier <em>prefs.js</em> avec la ligne suivante :</p> - - <pre class="brush: js">echo 'user_pref("devtools.debugger.forbid-certified-apps", false);' >> prefs.js</pre> - </li> - <li> - <p>Après avoir modifié et sauvegardé le fichier, redémarrez B2G avec la commande suivante :</p> - - <pre class="brush: bash">start b2g</pre> - </li> - <li> - <p>Sortez du système de fichier d'Android en utilisant la commande <code>exit</code>. Vous retournerez au terminal normal.</p> - </li> - <li> - <p>Ensuite, reconnectez-vous au gestionnaire d'applications, vous devriez alors voir les applications certifiées disponibles pour le débogage</p> - </li> -</ol> - -<h3 id="En_utilisant_le_client_B2G_pour_ordinateur">En utilisant le client B2G pour ordinateur</h3> - -<p>Avec le client B2G Desktop, la préférence est déjà définie dans votre profil dans <code>greprefs.js</code>, située à la racine du répertoire de votre client B2G pour ordinateur. Arrêtez le client puis éditez le fichier afin de passer <code>devtools.debugger.forbid-certified-apps</code> à <code>false</code>. Ensuite, redémarrer le client B2G et connectez le gestionnaire d'applications. Vous devriez désormais pouvoir toutes les applications.</p> - -<div class="note"> -<p>Note : Si vous voulez ajouter cette préférence à votre " build " de Gaia, vous pouvez faire <code>make DEVICE_DEBUG=1 reset-gaia</code>.</p> -</div> - -<h2 id="Dépannage"><a name="Troubleshooting">Dépannage</a></h2> - -<p id="My_device_is_not_recognized">Si l’appareil n’est pas reconnu :</p> - -<ul> - <li>Si cliquer sur le bouton correspondant à votre téléphone Firefox OS ne fait rien, vérifiez que vous n'avez pas connecté un téléphone Android <strong>ET</strong> un téléphone Firefox OS.</li> - <li>Lisez bien la section <a href="https://developer.mozilla.org/fr/Firefox_OS/Using_the_App_Manager$edit#Configuring_device">configuration des appareils et systèmes</a> et assurez-vous de suivre toutes les étapes : - <ul> - <li>Votre téléphone est-il au minimum sous Firefox OS 1.2 ?</li> - <li>Vous ne voyez pas toutes les applications ? Avez-vous besoin d'activer le <a href="https://developer.mozilla.org/fr/Firefox_OS/Using_the_App_Manager$edit#Debugging_Certified_Apps">Débogage d'applications certifiées </a>?</li> - <li>Avez-vous autorisé le « Débogage à distance » dans les paramètres de votre téléphone ?</li> - </ul> - </li> -</ul> - -<ul> - <li>Si vous n'utilisez pas <a href="https://developer.mozilla.org/fr/Firefox_OS/Using_the_App_Manager$edit#Adb_Helper_Add-on">ADB ou ADB Helper </a>: - - <ul> - <li>Avez-vous reussi à exécuter la commande <code>adb forward</code> ?</li> - </ul> - </li> - <li>Si vous utilisez <a href="https://developer.mozilla.org/fr/Firefox_OS/Using_the_App_Manager$edit#Adb_Helper_Add-on">ADB ou ADB Helper</a> et que votre appareil n'est pas listé dans la barre d'outils en bas : - <ul> - <li>Si vous utilisez Linux, <a href="http://developer.android.com/tools/device.html#setting-up">soyez sûr de configurer correctement <em>udev</em></a> ;</li> - <li>Si vous utilisez Windows, <a href="http://developer.android.com/tools/device.html#setting-up">soyez sûr d'avoir installé les drivers appropriés ;</a></li> - <li>Vous pouvez aussi activer le <em>verbose logging</em> pour rassembler des diagnostics : - <ul> - <li>utilisez <em>about:config </em> pour mettre la préférence « <span class="message"><span class="content"><code><span class="email">extensions.adbhelper@mozilla.org.sdk</span>.console.logLevel</code> »</span></span> à la valeur string "<code>all</code>"</li> - <li>désactivez et réactivez le module complémentaire ADB Helper depuis le gestionnaire des modules complémentaires, ou redémarrez Firefox ;</li> - <li>ouvrez à nouveau le gestionnaire d'applications ;</li> - <li>dans la <a href="ools/Brhttps://developer.mozilla.org/docs/Towser_Console">Console JavaScript</a>, vous devriez maintenant voir de nouvelles lignes qui mentionnent « adbhelper ».</li> - <li>Si vous les voyez, mais n'êtes pas sûr de leurs significations, faites un tour sur le canal <a href="https://wiki.mozilla.org/DevTools/GetInvolved#Communication">#devtools </a> ou <a href="https://bugzilla.mozilla.org/enter_bug.cgi?alias=&assigned_to=nobody%40mozilla.org&attach_text=&blocked=&bug_file_loc=http%3A%2F%2F&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_blocking_b2g=---&cf_crash_signature=&cf_status_b2g18=---&cf_status_b2g_1_1_hd=---&cf_status_b2g_1_2=---&cf_status_firefox24=---&cf_status_firefox25=---&cf_status_firefox26=---&cf_status_firefox27=---&cf_status_firefox_esr17=---&cf_status_firefox_esr24=---&cf_tracking_b2g18=---&cf_tracking_firefox24=---&cf_tracking_firefox25=---&cf_tracking_firefox26=---&cf_tracking_firefox27=---&cf_tracking_firefox_esr17=---&cf_tracking_firefox_esr24=---&cf_tracking_firefox_relnote=---&cf_tracking_relnote_b2g=---&comment=&component=Developer%20Tools%3A%20App%20Manager&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&data=&defined_groups=1&dependson=&description=&flag_type-203=X&flag_type-37=X&flag_type-41=X&flag_type-5=X&flag_type-607=X&flag_type-720=X&flag_type-721=X&flag_type-737=X&flag_type-748=X&flag_type-781=X&flag_type-787=X&flag_type-791=X&flag_type-799=X&flag_type-800=X&flag_type-802=X&flag_type-803=X&flag_type-809=X&flag_type-825=X&form_name=enter_bug&keywords=&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=All&priority=--&product=Firefox&qa_contact=developer.tools%40firefox.bugs&rep_platform=x86&requestee_type-203=&requestee_type-41=&requestee_type-5=&requestee_type-607=&requestee_type-748=&requestee_type-781=&requestee_type-787=&requestee_type-791=&requestee_type-800=&short_desc=&status_whiteboard=&target_milestone=---&version=Trunk">rapportez un bug</a> avec les logs.</li> - </ul> - </li> - </ul> - </li> - <li>Vous voyez <strong>« ??????? »</strong> à la place du nom de l'appareil sous Linux ? Vous avez des problèmes de permissions : <a href="http://developer.android.com/tools/device.html#setting-up">Assurez-vous d'avoir correctement configuré <em>udev</em></a>.</li> - <li>Votre écran de téléphone est-il débloqué ?</li> - <li>Si la commande « <code>adb devices</code> » ne montre pas d'entrée alors que le téléphone est connecté et débloqué, il est possible que vous ayez à <a href="http://blog.fh-kaernten.at/wehr/?p=1182">éditer adb_usb.ini</a>.</li> -</ul> - -<p>Vous ne pouvez pas connecter votre appareil au gestionnaire d'applications ou démarrer le simulateur ? <a href="https://wiki.mozilla.org/DevTools/GetInvolved#Communication">Informez-nous</a> ou <a href="https://bugzilla.mozilla.org/enter_bug.cgi?alias=&assigned_to=nobody%40mozilla.org&attach_text=&blocked=&bug_file_loc=http%3A%2F%2F&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_blocking_b2g=---&cf_crash_signature=&cf_status_b2g18=---&cf_status_b2g_1_1_hd=---&cf_status_b2g_1_2=---&cf_status_firefox24=---&cf_status_firefox25=---&cf_status_firefox26=---&cf_status_firefox27=---&cf_status_firefox_esr17=---&cf_status_firefox_esr24=---&cf_tracking_b2g18=---&cf_tracking_firefox24=---&cf_tracking_firefox25=---&cf_tracking_firefox26=---&cf_tracking_firefox27=---&cf_tracking_firefox_esr17=---&cf_tracking_firefox_esr24=---&cf_tracking_firefox_relnote=---&cf_tracking_relnote_b2g=---&comment=&component=Developer%20Tools%3A%20App%20Manager&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&data=&defined_groups=1&dependson=&description=&flag_type-203=X&flag_type-37=X&flag_type-41=X&flag_type-5=X&flag_type-607=X&flag_type-720=X&flag_type-721=X&flag_type-737=X&flag_type-748=X&flag_type-781=X&flag_type-787=X&flag_type-791=X&flag_type-799=X&flag_type-800=X&flag_type-802=X&flag_type-803=X&flag_type-809=X&flag_type-825=X&form_name=enter_bug&keywords=&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=All&priority=--&product=Firefox&qa_contact=developer.tools%40firefox.bugs&rep_platform=x86&requestee_type-203=&requestee_type-41=&requestee_type-5=&requestee_type-607=&requestee_type-748=&requestee_type-781=&requestee_type-787=&requestee_type-791=&requestee_type-800=&short_desc=&status_whiteboard=&target_milestone=---&version=Trunk">rapportez un bug</a>.</p> diff --git a/files/fr/archive/b2g_os/using_the_b2g_emulators/index.html b/files/fr/archive/b2g_os/using_the_b2g_emulators/index.html deleted file mode 100644 index e21111a942..0000000000 --- a/files/fr/archive/b2g_os/using_the_b2g_emulators/index.html +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: Utiliser les émulateurs B2G -slug: Archive/B2G_OS/Using_the_B2G_emulators -tags: - - B2G - - Emulateur - - Firefox OS -translation_of: Archive/B2G_OS/Using_the_B2G_emulators ---- -<p></p> - -<div class="summary"> -<p><span class="seoSummary">Cet article est un guide succinct qui décrit les choses à savoir si vous décidez d'utiliser les émulateurs Boot to Gecko. Il ne prétend pas à être un guide de l'utilisateur complet ; il vous présente seulement quelques petits trucs à savoir que vous ne pourriez peut-être pas découvrir par vous-même.</span></p> -</div> - -<p>Ce guide part du principe que vous avez déjà compiler un des émulateurs. Si ce n'est pas le cas, vous pouvez vous référer à la page <a href="/fr/docs/Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko">Compiler et installer Firefox OS</a> !</p> - -<h2 id="À_propos_des_émulateurs_B2G"><a id="A propos des émulateurs B2G" name="A propos des émulateurs B2G">À propos des émulateurs B2G</a></h2> - -<p>Il existe deux émulateurs B2G. Le premier est un émulateur ARM qui est compilé lorsque l'on configure <code>config.sh</code> avec le champ "emulator". Même si c'est plus lent que d'utiliser directement un processeur x86, c'est tout de même une représentation plus stable et plus précise du fonctinnement d'un terminal réel. Utiliser le champ "emulator-x86" lorsque l'on lance <code>config.sh </code>permet d'utiliser l'émulateur x86.</p> - -<div class="note"> -<p><strong>Note : </strong>Depuis quelques mois la Team Automation a arrêté d'utiliser l'émulateur x86 à cause de problèmes de stabilité. Il y a donc de grandes chances que cela ne marche pas du tout avec l'émulateur x86. Utilisez l'emulateur ARM à moins d'avoir une bonne raison de faire autrement.</p> -</div> - -<p>Une fois que vous avez sélectionné, configuré et compilé un émulateur, le reste marche de la même façon donc le reste de ce guide est commun pour les deux.</p> - -<div class="note"> -<p><strong>Note : </strong>Sur Mac OS X, l'émulateur BG nécessite un processeur Core 2 Duo ou plus récent, c'est-à-dire un système compatible avec Mac OS X 10.7 "Lion." Vous n'avez pas besoin d'utiliser Lion, juste d'être compatible avec.</p> -</div> - -<h2 id="Démarrer_l'émulateur"><a id="Démarrer l'émulateur" name="Démarrer l'émulateur">Démarrer l'émulateur</a></h2> - -<p>Pour démarrer l'émulateur B2G, tapez la commande suivante :</p> - -<pre>./run-emulator.sh</pre> - -<p>Cela va prendre en charge toutes les étapes du démarrage. Maintenant attendez pendant que l'émulateur démarre et que Boot to Gecko démarre dessus. Cela peut prendre plusieurs minutes, donc soyez patient.</p> - -<h2 id="Quand_l'émulateur_ne_marche_pas"><a id="Quand l'émulateur ne marche pas" name="Quand l'émulateur ne marche pas">Quand l'émulateur ne marche pas</a></h2> - -<p>Parfois l'émulateur ne réussi pas à démarrer. Voici quelques astuces pour résoudre les problèmes.</p> - -<h3 id="Utilisez-vous_une_VM"><a id="Utilisez-vous une VM ?" name="Utilisez-vous une VM ?">Utilisez-vous une VM ?</a></h3> - -<p>VirtualBox et Parallels ont un support de l'accélération graphique problématique qui peut causer l'échec du démarrage de l'émulateur, quelque chose à propos d'un terminal OpenGL. L'émulateur commence à démarrer, et redémarre en boucle ou démarre mais n'affiche rien sur l'écran. Il n'y a malheureusement pas de solutions (il y a un <a href="http://www.digitalmihailo.com/setting-up-ubuntu-12-04-virtual-machine-for-firefox-os-build/">moyen détourné</a> pour VirtualBox). Vous devez utiliser VMWare Player (Freeware), Workstation ou Fusion. Pour VirtualBox, n'installez pas les Guest Addons ou ne désactivez pas le module vboxvideo.</p> - -<h3 id="Assurez-vous_que_le_serveur_adb_est_lancé"><a id="Assurez vous que le serveur adb soit lancé" name="Assurez vous que le serveur adb soit lancé">Assurez-vous que le serveur adb est lancé</a></h3> - -<p>Cela arrive lorsque le serveur adb qui prend en charge l'interaction avec l'émulateur soit n'est pas lancé, soit a mal fonctionné. Dans ce cas vous pourrez voir le message d'erreur suivant dans le terminal où vous avez lancé l'émulateur : </p> - -<pre>emulator: control console listening on port 5554, ADB on port 5555 -emulator: can't connect to ADB server: Connection refused</pre> - -<div class="note"> -<p><strong>Note : </strong>Si vous utilisez l'adb compilé par le processus de compilation de B2G (ce qui est probablement le cas), il est situé dans le dossier <code>$B2G/out/host/<platform>/bin</code>. Sur Mac, c'est le dossier <code>$B2G/out/host/darwin-x86/bin</code>, par exemple.</p> -</div> - -<p>Regardez si adb est lancé avec : </p> - -<pre>ps aux | grep adb</pre> - -<p>S'il y est tuez-le avec la commande suivante parce qu'il ne marche sans doute pas correctement.</p> - -<pre>adb kill-server</pre> - -<p>S'il ne l'est pas faites ceci :</p> - -<pre>adb start-server</pre> - -<p>Ensuite tentez de relancer l'émulateur. S'il ne marche toujours pas allez sur <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a> sur irc.mozilla.org pour de l'aide (en anglais).</p> - -<h3 id="Effacer_les_options_de_configuration"><a id="Effacer les options de configuration" name="Effacer les options de configuration">Effacer les options de configuration</a></h3> - -<p>Parfois, des options de configurations obsolètes de l'émulateur peuvent causer un mauvais comportement. Vous pouvez supprimer la Base de Données IndexedDB pour résoudre le problème, comme ceci :</p> - -<ol> - <li> Assurez-vous que le service adb est démarré, comme décrit <a href="#Assurez vous que le serveur adb soit lancé">ici</a>.</li> - <li>Démarrez l'émulateur.</li> - <li> - <p>Dans le terminal sur l'ordinateur hôte, allez à la racine du code de B2G pour votre émulateur et tapez :<code> out/host/<platform>/bin/adb -e shell</code> ; sur Mac ce serait <code>out/host/darwin-x86/bin/adb -e shell</code>.</p> - </li> - <li> - <p>Maintenant que vous êtes dans le shell adb, vous pouvez exécuter des commandes shell sur votre émulateur. Maintenant stoppez B2G sur l'émulateur : <code>stop b2g</code>.</p> - </li> - <li> - <p>Supprimez la Base de Données IndexedDB : <code>rm -rf /data/local/indexedDB</code>.</p> - </li> - <li> - <p>Redémarrez B2G sur l'émulateur : <code>start b2g.</code></p> - </li> -</ol> - -<p> Espérons que vous vous retrouverez avec l'interface de Gaia et tout ira bien.</p> - -<h2 id="Si_l'émulateur_démarre_mais_que_l'écran_est_noir_avant_ou_après_le_splash_screen_mozilla_technology"><a id="Si l'émulateur démarre mais que l'écran est noir avant ou après le splash screen "mozilla technology"" name="Si l'émulateur démarre mais que l'écran est noir avant ou après le splash screen "mozilla technology"">Si l'émulateur démarre mais que l'écran est noir avant ou après le splash screen "mozilla technology"</a></h2> - -<p>Si cela arrive, c'est peut-être un bogue de pilotes sur la machine qui fait tourner l'émulateur. Cela a été observé sur le pilote Linux open source nouveau. La solution la plus simple est de changer le pilote sur la machine. Dans le cas du pilote nouveau, cela peut-être d'installer un pilote propriétaire ("additionnel" dans Ubuntu) à la place. Dans le cas de chipsets graphiques embarqués Intel graphics, le pilote Linux open source par défaut peut causer une erreur de l'émulateur de type 'eglMakeCurrent failed' dont la source semble le fait qu'il supporte une version d'OpenGL plus faible que la version 2.0 nécessaire pour l'émulation du GPU. La solution consiste à désactiver le GPU en éditant le script <code>run-emulator.sh</code> (l'émulateur sera plus lent).</p> - -<h2 id="Configurer_l'émulateur"><a id="Configurer l'émulateur" name="Configurer l'émulateur">Configurer l'émulateur</a></h2> - -<p>Il y a plusieurs options que vous pouvez changer pour que l'émulateur ressemble au terminal que vous voulez émuler. Cette section vous fournit des informations de base sur la façon de faire. Vous pouvez modifier la configuration de l'émulateur en éditant le script <code>run-emulator.sh</code>. Ou, idéalement, une copie. Seulement une partie des paramètres les plus utiles seront abordés ici. Vous pourrez aller sur le site de <a href="http://www.qemu.org/">quemu </a>pour obtenir des détails sur les autres.</p> - -<div class="note"> -<p><strong>Astuce : </strong>Créez une copie de <code>run-emulator.sh</code> pour chaque terminal que vous voulez émuler. Cela permet d'utiliser plusieurs configurations différentes facilement.</p> -</div> - -<h3 id="Changer_de_skins"><a id="Changer de skins" name="Changer de skins">Changer de skins</a></h3> - -<p>Par défaut, l'émulateur démarre en mode HVGA, half-VGA mode, soit 320x480 pixels. Cela est spécifié par le paramètre <code>-skin</code> donné à l'émulateur lorsqu'il démarre. Vous pouvez passer à un mode d'affichage différent en éditant le script <code>run-emulator.sh</code> (ou, idéalement, une copie). Les skins fournis sont :</p> - -<ul> - <li>HVGA (320x480)</li> - <li>QVGA (240x320)</li> - <li>WQVGA (240x400)</li> - <li>WQVGA432 (240x432)</li> - <li>WSVGA (1024x600)</li> - <li>WVGA800 (480x800)</li> - <li>WVGA854 (480x854)</li> - <li>WXGA720 (1280x720)</li> - <li>WXGA800 (1280x800)</li> -</ul> - -<p> Les skins sont situés dans le dossier <code>$B2G/development/tools/emulator/skins</code>. Un skin est plutôt simple, si vous regardez, il sont simplement des dossiers avec des fichiers PNG pour les objets de l'interface et un fichier texte nommé <code>layout </code>qui décrit l'agencement de l'interface et de l'écran. Il est plutôt simple de créer vos propres skins si besoin.</p> - -<h3 id="Changer_la_taille_de_la_mémoire"><a id="Changer la taille de la mémoire" name="Changer la taille de la mémoire">Changer la taille de la mémoire</a></h3> - -<p>Une autre option que vous pouvez ou devez configurer est la taille de la mémoire de l'émulateur. Par défaut elle est de 512 Mo, mais si le terminal que vous émulez à plus ou moins de mémoire, il est important que vous mettiez la bonne quantité de mémoire pour vous assurer que votre application tournera dans le terminal de base sur lequel vous voulez travailler. Pour cela, changez la valeur du paramètre <code>-memory </code>à la taille dont vous avez besoin en mégaoctets. En plus de 512 Mo par défaut, 256 Mo et 1024 Mo seront celles que vous utiliserez le plus probablement pour tester.</p> - -<p>Pour changer la quantité de stockage émulé (c'est-à-dire, l'espace de stockage pour les données locales, comme la mémoire flash sur les téléphones moblies ou le disque dur d'un ordinateur), changez la valeur du paramètre <code>-partition-size </code>Par défaut il est de 512 Mo, mais vous pouvez spécifier n'importe quelle taille en mégaoctets pour simuler le type de terminal pour lequel vous devez tester.</p> - -<h3 id="Connexion_réseau"><a id="Connexion réseau" name="Connexion réseau">Connexion réseau</a></h3> - -<p>Si pour certaines raisons vous ne pouvez pas connecter l'émulateur à internet, vous pouvez lancer la commande suivante depuis votre terminal :</p> - -<pre>adb shell setprop net.dns1 10.0.2.3</pre> - -<p>Si vous utilisez emulator-jb ou emulator-kk, la commande pour paramètrer le serveur DNS est différente :</p> - -<pre>adb shell ndc resolver setdefaultif eth0 -adb shell ndc resolver setifdns eth0 10.0.0.0 10.0.2.3</pre> - -<div class="displayNone" id="axon-example-container"> -<div id="example-tail-container"> -<div id="example-tail-main"> -<div id="example-tail-inner-left"> </div> - -<div id="example-tail-outer-left"> </div> -</div> -</div> -</div> diff --git a/files/fr/archive/b2g_os/web_telephony_api/index.html b/files/fr/archive/b2g_os/web_telephony_api/index.html deleted file mode 100644 index e9e2d76504..0000000000 --- a/files/fr/archive/b2g_os/web_telephony_api/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Web Telephony -slug: Archive/B2G_OS/Web_Telephony_API -tags: - - WebAPI -translation_of: Archive/B2G_OS/Web_Telephony_API ---- -<p></p><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/API/Web_Telephony_API">Web Telephony API</a></strong></li><li class="toggle"><details open><summary>Interfaces</summary><ol><li><a href="/fr/docs/Web/API/Telephony"><code>Telephony</code></a></li><li><a href="/fr/docs/Web/API/TelephonyCall"><code>TelephonyCall</code></a></li><li><a href="/fr/docs/Web/API/TelephonyCallGroup"><code>TelephonyCallGroup</code></a></li><li><a href="/fr/docs/Web/API/CallEvent"><code>CallEvent</code></a></li><li><a href="/fr/docs/Web/API/CallGroup"><code>CallGroup</code></a></li><li><a href="/fr/docs/Web/API/MMICall"><code>MMICall</code></a></li></ol></details></li><li class="toggle"><details open><summary>Propriétés</summary><ol><li><a href="/fr/docs/Web/API/Navigator/mozTelephony"><code>Navigator.mozTelephony</code></a></li></ol></details></li><li class="toggle"><details open><summary>Événements</summary><ol><li><a href="/fr/docs/Web/Events/incoming"><code>incoming</code></a></li></ol></details></li></ol></section><p></p> - -<p></p><div class="overheadIndicator nonStandard nonStandardHeader"> - <p><strong><span title="Cette API n'a pas été standardisée."><i class="icon-warning-sign"> </i></span> Non standard</strong><br> - Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> - </div><p></p> - -<p></p><div class="warning"> - <p style="text-align: center;">Cette API est disponible sur <a href="/fr/docs/Mozilla/Firefox_OS">Firefox OS</a> pour <a href="/fr/docs/Mozilla/Firefox_OS/Security/Application_security#App_Types">des applications internes</a> seulement.</p> -</div><p></p> - -<p>WebTelephony est une API qui permet à du contenu web de gérer les appels téléphoniques (voix) à partir de code JavaScript.</p> - -<p>Cette API est disponible en utilisant <a href="/fr/docs/Web/API/Window/navigator/mozTelephony" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.navigator.mozTelephony</code></a>. Voir ci-après pour une liste complète d'interfaces :</p> - -<h2 id="Interfaces_DOM">Interfaces DOM</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Window/navigator/mozTelephony" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>window.navigator.mozTelephony</code></a></li> - <li><a href="/fr/docs/Web/API/Telephony"><code>Telephony</code></a></li> - <li><a href="/fr/docs/Web/API/TelephonyCall"><code>TelephonyCall</code></a></li> - <li><a href="/fr/docs/Web/API/CallEvent"><code>CallEvent</code></a></li> -</ul> - -<h2 id="Exemple_de_code_et_introduction_à_l'API">Exemple de code et introduction à l'API</h2> - -<div></div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a class="link-https" href="https://wiki.mozilla.org/WebAPI/WebTelephony">WebTelephony API</a> (document de conception)</li> -</ul> diff --git a/files/fr/archive/b2g_os/writing_apps_for_boot_to_gecko/index.html b/files/fr/archive/b2g_os/writing_apps_for_boot_to_gecko/index.html deleted file mode 100644 index eed9c54562..0000000000 --- a/files/fr/archive/b2g_os/writing_apps_for_boot_to_gecko/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Développement d'Applications Firefox OS -slug: Archive/B2G_OS/Writing_apps_for_Boot_to_Gecko -tags: - - Apps - - B2G - - Firefox OS -translation_of: Archive/B2G_OS/Firefox_OS_apps/Building_apps_for_Firefox_OS ---- -<p>Pour de l'information sur le développement d'application Firefox OS, consultez le <a href="https://marketplace.firefox.com/developers/" title="https://marketplace.firefox.com/developers/">Centre pour Développeur du Firefox Maketplace</a>.</p> -<p>Vous pouvez aussi consulter la <a href="/en-US/docs/Apps/Reference" title="/en-US/docs/Apps/Reference">référence de l'API Développement d'Applications</a>.</p> -<p>Les applications Firefox OS ne sont rien de plus que des applications <a href="/fr/Applications" title="https://developer.mozilla.org/fr/Applications">Open Web </a>installées sur un téléphone Firefox OS.</p> -<ul> - <li><a href="/fr/Applications/Pour_commencer" title="Pour commencer à créer des applications">Commencer à créer des applications</a></li> - <li><a href="/en/Mozilla/Boot_to_Gecko/Writing_a_web_app_for_B2G" title="Writing a web app">Écrire une application pour Firefox OS</a></li> -</ul> -<div class="note"> - <strong>Note :</strong> Firefox OS s'identifie pour le moment avec le même User Agent que Firefox pour Android, sans la clause <code>Android;.</code> Par exemple : <code>Mozilla/5.0 (Mobile; rv:15.0) Gecko/15.0 Firefox/15.0a1</code>.</div> diff --git a/files/fr/archive/css3/index.html b/files/fr/archive/css3/index.html deleted file mode 100644 index 818d53e75d..0000000000 --- a/files/fr/archive/css3/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: CSS3 -slug: Archive/CSS3 -tags: - - CSS - - Draft - - Intermédiaire - - Reference -translation_of: Archive/CSS3 ---- -<div>{{draft}}<br> -Cette documentation n'est pas maintenue et le contenu de l'article anglais n'est plus complètement à jour.</div> - -<div>Une meilleure ressource est actuellement disponible et récapitule <a href="https://www.w3.org/Style/CSS/current-work">l'état actuel du travail du W3C sur les spécifications relatives à CSS (en anglais)</a>.</div> diff --git a/files/fr/archive/deviceproximity/index.html b/files/fr/archive/deviceproximity/index.html deleted file mode 100644 index f4eea4fc98..0000000000 --- a/files/fr/archive/deviceproximity/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: deviceproximity -slug: Archive/deviceproximity -translation_of: Archive/API/deviceproximity ---- -<p>L'événement <strong>deviceproximity</strong> est déclenché lorsque de nouvelles données sont disponibles à partir d'un capteur de proximité.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Spécification</dt> - <dd style="margin: 0 0 0 120px;"><a class="external" href="https://w3c.github.io/proximity/#event-handlers" hreflang="en" lang="en" title="La spécificaction 'Proximity Sensor'">Proximity Sensor</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/DeviceProximityEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>DeviceProximityEvent</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Non</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Non</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">DefaultView (<code>window</code>)</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Aucune</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td><a href="/en-US/docs/Web/API/EventTarget" title="EventTarget is an interface implemented by objects that can receive events and may have listeners for them."><code>EventTarget</code></a></td> - <td>The event target (the topmost target in the DOM tree).</td> - </tr> - <tr> - <td><code>type</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td><a href="/en-US/docs/Web/API/DOMString" title="DOMString is a UTF-16 String. As JavaScript already uses such strings, DOMString is mapped directly to a String."><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td><a href="/en-US/docs/Web/API/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not.</td> - </tr> - <tr> - <td><code>cancelable</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td><a href="/en-US/docs/Web/API/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not.</td> - </tr> - <tr> - <td><code>value</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td>Double (float)</td> - <td>The sensor data for ambient light in Lux.</td> - </tr> - <tr> - <td><code>min</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td>Double (float)</td> - <td>The minimum value in the range the sensor detects (if available, 0 otherwise).</td> - </tr> - <tr> - <td><code>max</code> <span class="inlineIndicator readOnly readOnlyInline" title="Cette valeur ne peut pas être changée.">Lecture seule </span></td> - <td>Double (float)</td> - <td>The maximum value in the range the sensor detects (if available, 0 otherwise).</td> - </tr> - </tbody> -</table> - -<h2 id="Evénement_liés">Evénement liés</h2> - -<ul> - <li><code><a href="/fr/docs/Web/Reference/Events/userproximity" title="/fr/docs/Web/Reference/Events/userproximity">userproximity</a></code></li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/DeviceProximityEvent" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>DeviceProximityEvent</code></a> Object definition</li> -</ul> diff --git a/files/fr/archive/index.html b/files/fr/archive/index.html deleted file mode 100644 index 91bf4e1cba..0000000000 --- a/files/fr/archive/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Archive of obsolete content -slug: Archive -tags: - - Archive - - TopicStub -translation_of: Archive ---- -<p>Chez MDN, nous essayons d'éviter de supprimer purement et simplement le contenu qui pourrait être utile aux personnes ciblant les plates-formes, les systèmes d'exploitation et les navigateurs hérités. Peut-être que votre public cible est constitué de personnes qui utilisent du matériel plus ancien, par exemple, et qui ne peuvent pas passer aux derniers et meilleurs navigateurs. Ou pour des «raisons», votre entreprise doit utiliser un logiciel très ancien et vous devez créer un contenu Web qui s'exécute sur ce logiciel. Ou peut-être êtes-vous simplement curieux de connaître l'historique d'une fonctionnalité ou d'une API obsolète et son fonctionnement.</p> - -<p>Il existe de nombreuses raisons pour lesquelles une documentation plus ancienne peut être utile. Nous avons donc créé cette zone dans laquelle nous pouvons archiver une documentation plus ancienne. Le contenu de cette zone de contenu archivé <strong>ne doit pas</strong> être utilisé pour créer de nouveaux sites Web ou applications pour les navigateurs modernes. C'est ici pour référence historique seulement.</p> - -<div class="note"> -<p><strong>Note aux rédacteurs:</strong> Nous devons essayer de garder les sous-pages organisées ici au lieu de toutes les stocker dans un seul grand dossier. Essayez de créer des sous-arbres pour les catégories de matériaux. De plus, ne déplacez ici que les pages extrêmement obsolètes. Si quelqu'un a besoin de manière réaliste des informations contenues dans un produit vivant, il peut ne pas être approprié de les déplacer ici. En général, il peut être préférable d'en discuter dans la <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">chat room MDN Web Docs</a> avant de déplacer le contenu ici.</p> -</div> - -<p>{{SubpagesWithSummaries}}</p> - -<h2 id="Subnav">Subnav</h2> - -<p>{{ListSubpages("", 2, 0, 1)}}</p> diff --git a/files/fr/archive/marketplace/api/domapplicationsregistry/getinstalled/index.html b/files/fr/archive/marketplace/api/domapplicationsregistry/getinstalled/index.html deleted file mode 100644 index c45592bda7..0000000000 --- a/files/fr/archive/marketplace/api/domapplicationsregistry/getinstalled/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Apps.getInstalled -slug: Archive/Marketplace/API/DOMApplicationsRegistry/getInstalled -tags: - - API Apps - - Apps -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/getInstalled ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Résumé">Résumé</h2> -<p>Obtient la liste de toutes les applications installées pour cette origine. Par exemple, si appelé depuis le Firefox OS Marketplace, vous aurez la liste de toutes les application installées par le Firefox OS Marketplace.</p> -<div class="note"> - <p><strong>Note :</strong> Plusieurs applications pour une même origine ne sont pas supportées. Pour héberger plusieur applications depuis un domaine, <a href="/en-US/docs/Apps/Adding_a_subdomain" title="/en-US/docs/Apps/Adding_a_subdomain">créer un sous-domaine pour chaque application</a>. Par exemple : <code>monapp.mondomaine.com</code>, <code>autreapp.mondomaine.com</code>, et ainsi de suite.</p> -</div> -<h2 id="Syntaxe">Syntaxe</h2> -<pre><code>var requete = window.navigator.mozApps.<code>getInstalled</code>()</code>; -</pre> -<h2 id="Paramètre">Paramètre</h2> -<p>Aucun.</p> -<h2 id="Exemple">Exemple</h2> -<pre class="brush: js">var requete = window.navigator.mozApps.getInstalled(); -requete.onerror = function(e) { - alert("Erreur lors de l'appel de getInstalled : " + requete.error.name); -}; -requete.onsuccess = function(e) { - alert("Succès, nombre d'applications : " + requete.result.length); - var appsRecord = requete.result; -};</pre> -<p>Il est nécessaire de définir des callbacks pour les propriétés <code>onsuccess</code> et <code>onerror</code>, tel que montré dans cet exemple. Si l'appel est réussi, un tableau d'<a href="/fr/docs/DOM/App" title="/fr/docs/DOM/App">objet <code>App</code></a> sera renvoyé dans la propriété <code>result</code> de l'objet renvoyé. Dans cette exemple, il s'agit de <code>requete.result</code>.</p> -<h2 id="Erreurs">Erreurs</h2> -<p>La chaîne de caractère <code>ERROR</code> peut être renvoyé dans<code> DOMRequest.error</code>.</p> -<h2 id="Sujets_en_relation">Sujets en relation</h2> -<ul> - <li><a href="/fr/docs/DOM/App">Objet <code>App</code></a></li> - <li><a href="/fr/docs/Applications/API_JavaScript_Apps">API JavaScript Apps</a></li> -</ul> diff --git a/files/fr/archive/marketplace/api/domapplicationsregistry/getself/index.html b/files/fr/archive/marketplace/api/domapplicationsregistry/getself/index.html deleted file mode 100644 index 4c307a8d38..0000000000 --- a/files/fr/archive/marketplace/api/domapplicationsregistry/getself/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Apps.getSelf -slug: Archive/Marketplace/API/DOMApplicationsRegistry/getSelf -tags: - - API Apps - - Apps -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/getSelf ---- -<p>{{ ApiRef() }}</p> -<p>{{ non-standard_header() }}</p> -<h2 id="Résumé">Résumé</h2> -<p>Renvoie les informations sur l'application courante, ce qui veut dire une application installée dont le domaine correspond au domaine de l'application appelée.</p> -<div class="note"> - <p><strong>Note :</strong> Plusieurs applications pour une même origine ne sont pas supportées. Pour héberger plusieurs applications depuis un domaine, <a href="/en-US/docs/Apps/Adding_a_subdomain" title="/en-US/docs/Apps/Adding_a_subdomain">créer un sous-domaine pour chaque application</a>. Par exemple : <code>monapp.mondomaine.com</code>, <code>autreapp.mondomaine.com</code>, et ainsi de suite.</p> -</div> -<h2 id="Syntaxe">Syntaxe</h2> -<pre><code>var requete = window.navigator.mozApps.getSelf()</code>; -</pre> -<h2 id="Paramètres">Paramètres</h2> -<p>Aucun.</p> -<h2 id="Renvoie">Renvoie</h2> -<p><code>getSelf()</code> renvoie un objet {{ domxref("DOMRequest") }}. Le champ <code>DOMRequest.result</code> contient un <a href="/fr/docs/DOM/App">objet <code>App</code></a>, qui est un objet JavaScript décrivant l'application. Avant que l'opération soit terminée, <code>DOMRequest.result</code> est <code>null</code>.</p> -<div class="note"> - <p><strong>Note :</strong> A cause du {{ Bug("806597") }}, <code>requete.result</code> retourne incorrectement <code>null</code> même sur l'application tourne sur l'ordinateur ou Firefox pour Android.</p> -</div> -<p>Si l'appel est un echec, <code>DOMRequest.error </code>contient un objet {{ domxref("DOMError") }}, qui contient des informations sur l'erreur.</p> -<h2 id="Exemple">Exemple</h2> -<p>Un exemple montrant comme utiliser <code>getSelf()</code> avec les propriétés de callback <code>DOMRequest.onsuccess</code> et <code>DOMRequest.onerror.</code></p> -<pre class="brush: js">var requete = window.navigator.mozApps.getSelf(); -requete.onsuccess = function() { - // Affiche le nom de l'application depuis l'objet App - alert("Nom de l'application : " + requete.result.manifest.name); -}; -requete.onerror = function() { - // Affiche le nom de l'erreur depuis l'objet DOMError - alert("Erreur : " + requete.error.name); -};</pre> -<p>Si l'appel est réussi, un objet {{ domxref("App") }} est renvoyé dans la propriété <code>result</code> de l'objet renvoyé. Dans cette exemple, il s'agit de <code>requete.result</code>.</p> -<h2 id="Sujets_en_relation">Sujets en relation</h2> -<ul> - <li><a href="/fr/docs/Applications/API_JavaScript_Apps">API JavaScript Apps</a></li> -</ul> diff --git a/files/fr/archive/marketplace/api/domapplicationsregistry/index.html b/files/fr/archive/marketplace/api/domapplicationsregistry/index.html deleted file mode 100644 index 0a8dbc2490..0000000000 --- a/files/fr/archive/marketplace/api/domapplicationsregistry/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Apps -slug: Archive/Marketplace/API/DOMApplicationsRegistry -tags: - - API Apps - - Apps - - B2G - - Firefox OS - - Interface - - Non-standard -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry ---- -<p>{{APIRef("Apps")}}</p> - -<div class="blockIndicator deprecated"> -<p><strong>Retrait du marketplace</strong><br> - La fonctionnalité décrite ici ne fonctionne plus. Firefox Marketplace a été décommisionné pour Android, les ordinateurs de bureau, les tablettes et les paiement. Voir <a href="https://wiki.mozilla.org/Marketplace/FutureofMarketplaceFAQ">Future of Marketplace FAQ</a> pour plus d'informations.</p> -</div> - -<p><span class="seoSummary">Permet d'installer, de gérer et de contrôler des applications Web depuis un navigateur pour une installation dans Firefox OS. Implémentée par <a href="/fr/docs/Archive/B2G_OS/API/Navigator/mozApps" title="The documentation about this has not yet been written; please consider contributing!"><code>navigator.mozApps</code></a>.</span></p> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/mgmt" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.mgmt</code></a></dt> - <dd>Un objet <code>mgmt</code> qui expose les fonctions pour la gestion du tableau de bord et le lancement d'applications au nom de l'utilisateur.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<dl> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/checkInstalled" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.checkInstalled()</code></a></dt> - <dd>Vérifie si une application a déjà été installée avec le manifeste passé en paramètre.</dd> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/install" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.install()</code></a></dt> - <dd>Déclenche l'installation de l'application. Lors de l'installation, l'application est validée et l'utilisateur doit approuver l'installation.</dd> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/installPackage" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.installPackage()</code></a></dt> - <dd>Installe une application <a href="https://developer.mozilla.org/fr/docs/Apps/Packaged_apps">empaquetée</a>.</dd> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/getSelf" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.getSelf()</code></a></dt> - <dd>Renvoie un objet contenant l'objet <a href="/fr/docs/Archive/B2G_OS/API/DOMApplication" title="The documentation about this has not yet been written; please consider contributing!"><code>app</code></a> de l'application.</dd> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/getInstalled" title="The documentation about this has not yet been written; please consider contributing!"><code>DOMApplicationsRegistry.getInstalled()</code></a></dt> - <dd>Fournit une liste des applications installées.</dd> -</dl> - -<h3 id="Méthodes_obsolètes">Méthodes obsolètes</h3> - -<dl> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/amInstalled" title="Provides a means for an app to check whether it is installed. This function is typically called from an origin that hosts an app."><code>DOMApplicationsRegistry.amInstalled()</code></a> {{Obsolete_Inline}}</dt> - <dd>Permet de vérifier si une application est installée.</dd> - <dt><a href="/fr/docs/Archive/Marketplace/API/DOMApplicationsRegistry/getInstalledBy" title="Returns, through the callback function, the apps that were installed by the calling domain. This allows an app directory or store to determine which app it has installed on behalf of the current user."><code>DOMApplicationsRegistry.getInstalledBy()</code></a> {{Obsolete_Inline}}</dt> - <dd>Renvoie les applications installées depuis le domaine appelant. Cela permet à un registre d'application de déterminer quelle application a été installée au nom de l'utilisateur.</dd> -</dl> diff --git a/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html b/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html deleted file mode 100644 index ba677690fa..0000000000 --- a/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Apps.install -slug: Archive/Marketplace/API/DOMApplicationsRegistry/install -tags: - - API Apps - - Apps -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/install ---- -<div> - {{ApiRef}} {{non-standard_header}}</div> -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Déclenche l'installation d'une application. Pendant le processus d'installation, l'application est validée et l'utilisateur doit approuver l'installation.</p> -<p>Si une application a déjà été installé depuis le même domaine, appeler <code>install()</code> à nouveau peux écraser silencieusement, les données déjà installées. Ceci peut être utilisé pour modifier le reçu d'achat, par exemple, quand un utilisateur passe d'une application gratuite à une application premium.</p> -<h2 id="Syntax" name="Syntax">Syntaxe</h2> -<pre class="syntaxbox"><code>var <em>request</em> = window.navigator.mozApps.install(<em>url</em>, <em>[receipts]</em>)</code>;</pre> -<h3 id="Parameters" name="Parameters">Paramètres</h3> -<div class="note"> - <strong>Note :</strong> Il y a actuellement (Février 2013) un bug lorsque l'on passe un chemin relatif dans le paramètre <code>url</code>. Voir {{ Bug("745928") }}.</div> -<dl> - <dt> - <code>url</code></dt> - <dd> - Une chaîne de caractères d'URL contenant l'adresse du <a href="/fr/docs/Applications/Manifeste" title="/fr/docs/Applications/Manifeste">manifeste</a> à installer. Dans le cas d'une distribution personnel (quand l'origine d'installation est la même que celle de l'application), le site peut omettre l'origine dans l'URL et fournir un chemin absolu (commençant par <code>/</code>).</dd> - <dt> - <code><strong>receipts</strong></code></dt> - <dd> - (facultatif) un objet <a href="/en-US/docs/JSON" title="/en-US/docs/JSON">JSON</a> contenant un tableau d'un ou plusieurs reçus.</dd> - <dd> - <pre>window.navigator.mozApps.install(url, {receipts: ["receipt1", ...]})</pre> - </dd> - <dd> - Si <code>receipts</code> n'est pas renseigné, il est traité comme <code>null</code>.</dd> -</dl> -<p>La fonction <code>install()</code> lève une exception si l'argument requis (<code>url</code>) est absent, ou si des arguments non supportés sont présent.</p> -<h2 id="Returns" name="Returns">Renvoie</h2> -<div class="note"> - <strong>Note :</strong> Il y a actuellement (Février 2013) un bug avec l'attribut <code>DOMRequest.result</code> affectant les appareils Android et les ordinateurs. Voir {{ Bug("806597") }}.</div> -<p>La fonction <code>install()</code> renvoie un objet {{ domxref("DOMRequest") }}. Le champ <code>DOMRequest.result</code> contient un <a href="/fr/docs/DOM/App" title="/en-US/docs/DOM/App">objet <code>App</code></a>, qui est un objet JavaScript décrivant l'application venant d'être installée. Avant que l'opération soit finie, <code>DOMRequest.result</code> est <code>null</code>.</p> -<p>Si l'installation est infructueuse, <code>DOMRequest.error</code> contient un <a href="/en-US/docs/JavaScript_API/Error_object" title="/en-US/docs/JavaScript_API/Error_object">objet <code>DOMError</code></a>, qui a les informations à propos de l'erreur.</p> -<h2 id="Example" name="Example">Exemple</h2> -<p>Un exemple montrant comment utiliser <code>install()</code> avec les propriétés de callback <code>DOMRequest.onsuccess</code> et <code>DOMRequest.onerror</code>.</p> -<pre class="brush: js">var request = window.navigator.mozApps.install(manifestUrl); -request.onsuccess = function () { - // Enregistre l'objet App qui est renvoyé - var appRecord = this.result; - alert('Installation réussie !'); -}; -request.onerror = function () { - // Affiche le nom de l'erreur depuis l'objet DOMError - alert('Installation échouée, erreur : ' + this.error.name); -}; -</pre> -<p>Le callback <code>onsuccess</code> est appelé si l'installation est réussie. Ceci veut dire que les <a href="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme" title="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme">actions de l'installation</a> ont eu lieu.</p> -<p>Si l'installation est un échec, le callback <code>onerror</code> est appelé. Sur une installation échouée, <code>DOMRequest.error </code>contient un objet <code>DOMError </code>qui a des informations sur l'erreur.</p> -<p>Le code peut vous apparaître étrange, avec les guetteurs d'évènement ajoutés après que la fonction ait été appelée. Cependant, c'est la façon dont l'objet <code>DOMRequest</code> opère. L'appel de la fonction attendra que les guetteurs d'évènement aient été définis, et ils seront déclenchés en fonction de la situation. La fonction <code>install()</code> marche aussi par elle-même sans les guetteurs d'évènement<code>.onsuccess</code> et <code>.onerror</code>.</p> -<h2 id="Error" name="Error">Erreurs</h2> -<p>Quand l'installation est un échec, l'une de ces erreurs peut être retournée dans <code>DOMRequest.error</code>.</p> -<dl> - <dt> - <code>DENIED</code></dt> - <dd> - L'utilisateur a annulé l'installation.</dd> - <dt> - <code>INVALID_MANIFEST</code></dt> - <dd> - Le manifeste, bien qu'étant un JSON correctement formé, n'a pas certains champs requis, ou est pour une raison quelconque non valide.</dd> - <dt> - <code>MANIFEST_URL_ERROR</code></dt> - <dd> - Un autre code HTTP que le code statut 200 a été reçu, ou une autre erreur de connection.</dd> - <dt> - <code>MANIFEST_PARSE_ERROR</code></dt> - <dd> - JSON mal formé pour le manifeste.</dd> - <dt> - <code>NETWORK_ERROR</code></dt> - <dd> - Erreur de connection.</dd> -</dl> -<h2 id="Related_topics" name="Related_topics">Sujets en relation</h2> -<ul> - <li><a href="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme">Détails spécifiques à la plateforme lors de l'installation d'une Application</a></li> - <li><a href="/fr/docs/DOM/App">L'objet <code>App</code></a></li> - <li><a href="/fr/docs/DOM/DOMError">L'objet <code>DOMError</code></a></li> - <li><a href="/fr/docs/Applications/API_JavaScript_Apps">API JavaScript Apps</a></li> -</ul> diff --git a/files/fr/archive/marketplace/api/index.html b/files/fr/archive/marketplace/api/index.html deleted file mode 100644 index 2d3a3d7bf3..0000000000 --- a/files/fr/archive/marketplace/api/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Marketplace API reference -slug: Archive/Marketplace/API -tags: - - API - - Archive - - Marketplace - - Overview - - Reference - - TopicStub -translation_of: Archive/Marketplace/API ---- -<p class="summary">Les API liées à la marketplace ont été supprimées, les informations les concernant ont donc été archivées.</p> - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/API/App_installation_and_management_APIs">API d'installation et de gestion des applications</a></dt> - <dd class="landingPageList">L'API JavaScript Open Web Apps est une interface de programmation permettant d'installer des applications Web et de gérer une collection côté client d'applications Web installées par un utilisateur. Cette collection est appelée le référentiel d'applications.</dd> - <dt class="landingPageList"><code><a href="/en-US/docs/Archive/Marketplace/API/DOMApplicationsManager">Gestionnaire d'applications DOM</a></code></dt> - <dd class="landingPageList"><span class="tlid-translation translation" lang="fr"><span title="">Fournit une assistance pour la gestion et l'installation des applications Web ouvertes dans un navigateur.</span></span> Un gestionnaire est accessible via <a href="/en-US/docs/Web/API/DOMApplicationsRegistry/mgmt" title="The documentation about this has not yet been written; please consider contributing!"><code>Navigator.mozApps.mgmt</code></a></dd> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><code><a href="/en-US/docs/Archive/Marketplace/API/DOMApplicationsRegistry">Registre des applications DOM</a></code></dt> - <dd class="landingPageList">Fournit une assistance pour l'installation, la gestion et le contrôle des applications Web ouvertes dans un navigateur pour une installation sur Firefox OS. Actuellement implémenté en tant que <a href="/en-US/docs/Web/API/Navigator/mozApps" title="The documentation about this has not yet been written; please consider contributing!"><code>navigator.mozApps</code></a>.</dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/API/Navigator_(Marketplace)"><code>Navigateur</code> (Marketplace)</a></dt> - <dd class="landingPageList">Extensions de navigateur spécifiques à Marketplace qui sont désormais dépréciés / obsolètes.</dd> -</dl> -</div> -</div> - -<p>{{IncludeSubnav("/en-US/docs/Archive/Marketplace")}}</p> diff --git a/files/fr/archive/marketplace/index.html b/files/fr/archive/marketplace/index.html deleted file mode 100644 index 29aa1090cc..0000000000 --- a/files/fr/archive/marketplace/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Marketplace -slug: Archive/Marketplace -tags: - - Archive - - Landing - - Marketplace - - TopicStub -translation_of: Archive/Marketplace ---- -<p class="summary">De nombreux aspects de Firefox Marketplace seront bientôt supprimés, d'autres suivront alors que les différents services proposés par Marketplace sont en fin de vie. La documentation associée sera déplacée ici au fur et à mesure de sa suppression. Consultez la <a href="https://wiki.mozilla.org/Marketplace/FutureofMarketplaceFAQ">FAQ sur le future de la Marketplace</a> pour plus de réponses.</p> - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/API">Référence de l'API marketplace</a></dt> - <dd class="landingPageList">Les API liées à la marketplace ont été supprimées, les informations les concernant ont donc été archivées.</dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Monetization">Monétisation</a></dt> - <dd class="landingPageList">Sujets de monétisation qui ont maintenant été archivés en raison de la suppression des fonctionnalités pertinentes de Firefox Marketplace.</dd> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Options">Options</a></dt> - <dd class="landingPageList">Options de publication qui ne sont plus disponibles, d'où l'archivage des informations.</dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/Marketplace/Publishing">Publication</a></dt> - <dd class="landingPageList">Publication de détails qui ne sont plus disponibles, d'où l'archivage des informations.</dd> -</dl> -</div> -</div> - -<div class="hidden"> -<h2 id="Subnav">Subnav</h2> - -<section id="Quick_Links"> -<ol> - <li><strong><a href="/en-US/docs/Archive/Marketplace">Marketplace</a></strong></li> - <li class="toggle"> - <details><summary><a href="/en-US/docs/Archive/Marketplace/API">Marketplace APIs</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/API", 1, 0, 1)}}</details> - </li> - <li class="toggle"> - <details><summary><a href="/en-US/docs/Archive/Marketplace/Monetization">Monétisation</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Monetization", 1, 0, 1)}}</details> - </li> - <li class="toggle"> - <details><summary><a href="/en-US/docs/Archive/Marketplace/Options">Options</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Options", 1, 0, 1)}}</details> - </li> - <li class="toggle"> - <details><summary><a href="/en-US/docs/Archive/Marketplace/Publishing">Publication</a></summary>{{ListSubpages("/en-US/docs/Archive/Marketplace/Publishing", 1, 0, 1)}}</details> - </li> -</ol> -</section> -</div> diff --git a/files/fr/archive/mdn/index.html b/files/fr/archive/mdn/index.html deleted file mode 100644 index 42ad1f3fe5..0000000000 --- a/files/fr/archive/mdn/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: MDN -slug: Archive/MDN -tags: - - TopicStub -translation_of: Archive/MDN ---- -<div class="overheadIndicator obsolete obsoleteHeader"> -<p><strong>Obsolète</strong><br> - Cette fonctionnalité est obsolète. Bien qu'il puisse toujours fonctionner dans certains navigateurs, son utilisation est déconseillée car il peut être supprimé à tout moment. Essayez d'éviter de l'utiliser.</p> -</div> - - - -<p>La documentation répertoriée ci-dessous est un matériel archivé et obsolète sur MDN lui-même.</p> - - - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/en-US/docs/Archive/MDN/Content_kits">Kits de contenu</a></dt> - <dd class="landingPageList">Les kits de contenu MDN sont des collections de ressources techniques basées sur des sujets pour vous aider à organiser une réunion de développeurs locaux ou à faire une présentation technique lors d'un événement, d'une conférence ou d'un atelier.</dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/MDN/Howto_Link_a_Github_account">Comment lier un compte GitHub à votre profil MDN</a></dt> - <dd class="landingPageList">Tous les utilisateurs qui souhaitent contribuer à MDN doivent ajouter une connexion GitHub à leur compte MDN pour pouvoir modifier. Cet article décrit comment ajouter l'authentification GitHub à votre profil MDN.</dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/MDN/Persona_sign-ins">Connexions MDN et Persona</a></dt> - <dd class="landingPageList">À compter du 1er novembre 2016, nous ne prenons en charge que GitHub pour la connexion à MDN. Si vous n'avez pas ajouté de connexion GitHub à votre compte MDN avant que nous ayons désactivé les connexions Persona, veuillez déposer un bogue <a href="https://mzl.la/accounthelp">"Account Help" bug</a> sur Bugzilla.</dd> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/en-US/docs/Archive/MDN/Subject-matter_experts">Experts en la matière</a></dt> - <dd class="landingPageList">Le but de cet article est d'aider les rédacteurs à trouver les développeurs Mozilla qui ont des réponses aux questions sur diverses technologies. Si vous êtes ingénieur sur un projet Mozilla, <strong>s'il vous plait</strong> <span class="tlid-translation translation" lang="fr"><span title="">veuillez vous assurer que votre technologie figure sur cette liste et que les coordonnées de votre groupe sont fournies.</span></span></dd> - <dt class="landingPageList"><a href="/en-US/docs/Archive/MDN/Zones">Zones</a></dt> - <dd class="landingPageList">Une <strong>zone</strong> <span class="tlid-translation translation" lang="fr"><span title="">est une zone spéciale de MDN dont le contenu est présenté avec des éléments d'interface utilisateur supplémentaires, tels qu'une zone de navigation de zone spéciale et des éléments visuels améliorés dans la zone d'en-tête de la page.</span></span></dd> -</dl> -</div> -</div> diff --git a/files/fr/archive/meta_docs/index.html b/files/fr/archive/meta_docs/index.html deleted file mode 100644 index 86342ad94c..0000000000 --- a/files/fr/archive/meta_docs/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: MDN "meta-documentation" archive -slug: Archive/Meta_docs -tags: - - Archive - - MDN - - TopicStub -translation_of: Archive/Meta_docs ---- -<p>Vous trouverez ici la "méta-documentation" archivée; c'est-à-dire de la documentation sur la façon d'écrire de la documentation sur MDN. Les articles ici sont obsolètes et ne devraient plus être référencés; nous les conservons ici pour référence pendant que nous migrons certains contenus vers de nouveaux endroits, mais très peu de ces éléments sont utiles.</p> - - - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt></dt> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/fr/docs/Project%3AClasses_CSS_personnalis%C3%A9es">Classes CSS personnalisées</a></dt> - <dd class="landingPageList">Cette page liste les classes CSS qui ont été spécifiquement créées pour MDC. Si vous avez d'autres idées de classes CSS qui pourraient être utiles pour ce wiki, n'hésitez pas à contacter <a href="/User:Dria">Dria (en)</a>.</dd> -</dl> -</div> -</div> diff --git a/files/fr/archive/misc_top_level/images,_tableaux_et_décalages_mystérieux/index.html b/files/fr/archive/misc_top_level/images,_tableaux_et_décalages_mystérieux/index.html deleted file mode 100644 index 508196322e..0000000000 --- a/files/fr/archive/misc_top_level/images,_tableaux_et_décalages_mystérieux/index.html +++ /dev/null @@ -1,195 +0,0 @@ ---- -title: 'Images, tableaux et décalages mystérieux' -slug: 'Archive/Misc_top_level/Images,_tableaux_et_décalages_mystérieux' -tags: - - CSS -translation_of: 'Archive/Misc_top_level/Images,_Tables,_and_Mysterious_Gaps' ---- -<p> </p> - -<p>Quelle que soit l'époque à laquelle vous avez créé vos premières pages Web, il y a de fortes chances pour vous ayez utilisé l'un ou l'autre graphisme basé sur le schéma classique « tableaux imbriqués et pléthore d'images ». Que vous ayez découpé un logo en plusieurs morceaux afin de l'adapter correctement à la mise en page, ou que vous ayez utilisé une multitude de GIF d'espacement à un seul pixel, les principes (et les dangers) restent les mêmes. Dans les premiers temps du Web, cette approche fonctionnait car les navigateurs adaptaient les dimensions des cellules de tableaux à celles des images qu'elles contenaient.</p> - -<p>Avançons rapidement jusqu'en 2001, avec l'apparition de nombreux navigateurs respectant les standards qui affichent les pages Web en utilisant HTML et CSS plutôt que leur propre algorithme propriétaire de rendu. Grâce à une partie obscure de la spécification CSS, chaque mise en page basée sur une disposition précise de petites images dans des cellules de tableau devient un désastre visuel ne demandant qu'à se produire. Il suffit d'un navigateur moderne et du bon DOCTYPE, et badaboum !</p> - -<h3 id="Les_composants" name="Les_composants">Les composants</h3> - -<p>Regardons de plus près à l'endroit où cela se produit, et pourquoi cela pose problème. Commençons par un exemple simple, illustré par le figure 1 : un tableau d'une seule cellule contenant une image.</p> - -<p><img alt="Figure 1" src="/@api/deki/files/718/=Images-tables-gaps-figure1.gif"></p> - -<p>Évidemment, la plupart des mises en page sont un peu plus compliquées que cela, mais cela convient parfaitement pour notre démonstration. Une image, une cellule — c'est tout ce qu'il faut. Il n'y a apparemment aucun problème dans cet exemple. Et il n'est pas censé y en avoir puisque cet exemple reproduit le comportement traditionnel des navigateurs.</p> - -<p>Voyons maintenant ce que cet exemple donne dans un navigateur moderne lorsque la page a un DOCTYPE strict.</p> - -<p><img alt="Figure 2" src="/@api/deki/files/721/=Images-tables-gaps-figure2.gif"></p> - -<p>Remarquez l'espace supplémentaire sous l'image de la figure 2. Le balisage du tableau et de la cellule n'a pas changé — c'est le mode de rendu qui est différent. Plutôt que « d'adapter » l'image elle-même, le navigateur enveloppe maintenant la ligne sur laquelle repose l'image. L'image repose sur une ligne parce que c'est, par défaut, un élément de type inline (en-ligne). Il n'en faut pas plus.</p> - -<h3 id="Construction_d.27un_contenu_en-ligne" name="Construction_d.27un_contenu_en-ligne">Construction d'un contenu en-ligne</h3> - -<p>Afin de comprendre ce qui se passe exactement, regardons de plus près la construction d'une boîte de type en-ligne, le placement d'une image dans une boîte en-ligne, et enfin, le placement d'une boîte en-ligne dans une cellule de tableau. Tout d'abord, prenons une boite en-ligne basique contenant du texte, telle que montrée sur la figure 3.</p> - -<p><img alt="Figure 3" src="/@api/deki/files/722/=Images-tables-gaps-figure3.gif"></p> - -<p>La partie la plus cruciale de la figure 3 est la ligne de référence (ou ligne de base, représentée par la ligne bleue), et sa position dans la boîte en-ligne. Le positionnement exact de cette ligne dépend de la police « par défaut » de la boîte en-ligne (représentée par le cadre rouge), qui est déterminée par la valeur de la propriété CSS <a href="/fr/docs/Web/CSS/font-family" title="La propriété font-family permet de définir une liste, ordonnée par priorité, de polices à utiliser pour mettre en forme le texte de l'élément ciblé."><code>font-family</code></a> pour l'élément contenant la boîte en-ligne. Il n'est pas possible pour un auteur de changer directement la position de la ligne de référence, elle ne bougera pas d'où elle s'est mise. L'espace sous la ligne de base est appelé « espace descendant » car c'est l'endroit où s'affichent les jambages des lettres bas de casse comme « j » et « p ». La figure 4 montre ce qui arrive lorsqu'on ajoute une image à cet ensemble.</p> - -<p><img alt="Figure 4" src="/@api/deki/files/723/=Images-tables-gaps-figure4.gif"></p> - -<p>Remarquez l'endroit où se pose l'image par défaut : son bord inférieur est aligné avec la ligne de référence de la boîte en-ligne. Ce placement peut être modifié à l'aide de la propriété <a href="/fr/docs/Web/CSS/vertical-align" title="La propriété vertical-align définit l'alignement vertical d'une boîte en ligne (inline) ou d'une cellule de tableau."><code>vertical-align</code></a> — nous en reparlons plus loin — mais presque personne ne modifie sa valeur par défaut. Enlevons le texte et conservons l'image seule, comme sur la figure 5.</p> - -<p><img alt="Figure 5" src="/@api/deki/files/724/=Images-tables-gaps-figure5.gif"></p> - -<p>Nous avons donc une image posée sur la ligne de référence d'une boîte de type en-ligne qui ne contient que cette image. Imaginez maintenant ce que nous obtenons en mettant cette ligne dans une cellule de tableau (figure 6).</p> - -<p><img alt="Figure 6" src="/@api/deki/files/725/=Images-tables-gaps-figure6.gif"></p> - -<p>Et là, ça y est — des espaces s'ouvrent là où il n'y en avait pas auparavant. C'est pire avec de petites images comme celles qui ne font qu'un pixel, comme l'illustre la figure 7.</p> - -<p><img alt="Figure 7" src="/@api/deki/files/726/=Images-tables-gaps-figure7.gif"></p> - -<p>Maintenant, toutes sortes d'espaces s'ouvrent inopinément. C'est suffisant pour rendre fou un graphiste.</p> - -<h3 id="Les_solutions_possibles" name="Les_solutions_possibles">Les solutions possibles</h3> - -<p>Une solution évidente existe — arrêter de créer des mises en page dépendantes de tableaux ou utilisant des images découpées ou d'espacement de 1 pixel — mais elle n'est pas terriblement pratique pour de nombreux graphistes Web, et elle n'aide pas à corriger les anciennes conceptions qui volent en éclats dans les navigateurs récents. Une autre solution évidente consiste à vous assurer que votre document ne déclenchera pas le mode de rendu « standard ».</p> - -<p>Cela peut ce faire à l'aide d'une déclaration DOCTYPE qui appellera le <a href="fr/Mode_quirks_de_Mozilla">mode « quirks »</a> ou le <a href="fr/Mode_presque_standard_de_Gecko">mode « presque standard »</a>, ou en ne mettant tout simplement pas de DOCTYPE dans votre document. L'absence de DOCTYPE empêchera la validation et ce n'est par conséquent par recommandé. Pour les auteurs qui travaillent avec des documents récupérés d'autres personnes, un DOCTYPE pour le mode « quirks » est le meilleur choix. Dans le cas où l'auteur écrit un nouveau document ou s'il désire migrer une mise en page en respectant le plus possible les standards, alors le mode « presque standard » est probablement plus adapté.</p> - -<p>Bien sûr, les documents écrits en XHTML Strict ou en HTML Strict appelleront le mode de rendu « standard », aussi allons-nous voir deux méthodes basiques de résoudre ce problème dans les documents stricts, et un certain nombre de façons d'appeler les « corrections ».</p> - -<h4 id="D.C3.A9finir_les_images_comme_.C3.A9l.C3.A9ments_de_type_bloc" name="D.C3.A9finir_les_images_comme_.C3.A9l.C3.A9ments_de_type_bloc">Définir les images comme éléments de type bloc</h4> - -<p>Le premier choix, et un de ceux qui fonctionnera pour les graphismes chargés en images, est de convertir les images, qui sont par défaut des éléments en-ligne, en éléments de type bloc. Faites cela et une image ne créera plus de boîte en-ligne, ce qui résoudra le problème — en supposant que l'image est le seul élément contenu dans la cellule de tableau. Dans le cas le plus simple, il faudra ajouter une règle de style comme celle qui suit :</p> - -<pre class="eval">td img {display: block;} -</pre> - -<p>Observons l'application de cette règle au code HTML suivant :</p> - -<pre><table cellspacing="0" cellpadding="0" border="0" width="500"> - - <tr> - <td> - <img src="nav1.gif"><img src="nav2.gif"><img src="nav3.gif"> - <img src="nav4.gif"><img src="nav5.gif"> - </td> - </tr> - - <tr> - <td style="background: red;"> - <img src="smallred.gif" height="1" width="1"> - </td> - </tr> - - <tr> - <td> - <p style="margin: 0.5em;">Ce texte est dans une - autre cellule de tableau. Au milieu du texte se - trouve une icône <img src="icon2.gif"> indiquant - un lien externe. It's very worldly. Lorem - ipsum, dolor sit amet…</p> - </td> - </tr> - -</table> -</pre> - -<p>Comme on peut le voir sur la figure 8, cela fonctionne dans certain cas, mais ce n'est pas vrai toutes les images.</p> - -<p><img alt="Figure 8" src="/@api/deki/files/727/=Images-tables-gaps-figure8.gif"></p> - -<p>La fine ligne rouge indique que la cellule est redimensionnée à 1 pixel de hauteur par l'image GIF d'espacement de 1 pixel, comme le voulait le graphiste. Malheureusement, les boutons en haut de la cellule sont maintenant des éléments de type bloc et ils s'empilent les uns au dessus des autres au lieu de s'afficher côte-à-côte.</p> - -<p>Une solution possible consiste à ajouter une classe CSS pour toutes les images nécessitant une redéfinition en éléments de type bloc et d'écrire la règle qui correspond :</p> - -<pre>td img.decoration {display: block;} - -<td> - <img src="reddot.gif" class="decoration"> -</td> -</pre> - -<p>Selon le graphisme, cela pourrait conduire à ajouter de nombreuses classes pour ce simple effet. Ce sera particulièrement vrai si de nombreuses cellules de 1 pixel destinées à créer des lignes d'empilement idéales sont présentes, ou quelque chose dans ce genre. Si vous disposez d'un balisage se prêtant bien à cette approche, vous pouvez définir des classes CSS sur les rangs de tableau plutôt que sur les images. Ainsi vous auriez :</p> - -<pre class="eval">tr.decoration img { display: block; } -</pre> - -<p>… avec la modification du code HTML suivante :</p> - -<pre><tr class="decoration"> - <td style="background: red;"> - <img src="smallred.gif" height="1" width="1"> - </td> -</tr> -</pre> - -<p>Le résultat obtenu est que le GIF d'espacement devient un élément de type bloc, sans que l'on touche aux autres images. Cela conduit au résultat décrit par la figure 9.</p> - -<p><img alt="Figure 9" src="/@api/deki/files/728/=Images-tables-gaps-figure9.gif"></p> - -<p>Vous pouvez également classer les cellules plutôt que les rangs, si c'est le meilleur choix pour vous. Dans tous les cas, définir les images en élément de type bloc peut avoir des effets inattendus si vos cellules de tableau contiennent plus d'une image, comme sur la figure 8.</p> - -<p>Bien sûr, bien que nous ayons une cellule d'espacement de 1 pixel à la figure 9, nous avons toujours un espace indésirable sous les boutons et sur toute la largeur. Enlever cet espace pourrait être aussi facile que de mettre chaque image dans une cellule de tableau et de les définir en élément de type bloc, mais laissons-les toutes dans la même cellule que nous puissions illustrer une autre approche.</p> - -<h4 id="Utilisation_de_l.27alignement_vertical" name="Utilisation_de_l.27alignement_vertical">Utilisation de l'alignement vertical</h4> - -<p>L'autre solution consiste à laisser l'image comme élément en-ligne et de modifier son alignement vertical par rapport à la ligne de référence de la boîte en-ligne. Par exemple, vous pouvez essayez ce qui suit :</p> - -<pre class="eval">td img { vertical-align: bottom; } -</pre> - -<p>Ceci alignera les bords inférieurs des images avec les bords inférieurs des boîtes de type en-ligne, plutôt qu'avec la ligne de base. Comme vous pouvez le voir sur la figure 10, nous obtenons l'effet souhaité : l'espace sous les images de la barre de navigation a disparu. Cependant, la cellule décorative est toujours trop grande, et les autres images sont mal alignées par rapport au texte qui les entoure.</p> - -<p><img alt="Figure 10" src="/@api/deki/files/719/=Images-tables-gaps-figure10.gif"></p> - -<p>Une fois encore, nous pourrions définir des classes d'images, de cellules ou de rangs afin de nous rapprocher de l'effet désiré. Cependant, les styles affichés ci-dessus ne surmonteront pas le problème des images d'espacement, parce que la boîte en-ligne qui les entoure aura la hauteur de la police pour la cellule, et ne rétrécira donc pas. L'image se déplacera vers le bas de la cellule, mais la cellule ne « rétractera » pas sur l'image. De plus, toute autre image de taille plus petite que la boîte en-ligne aura toujours un espace autour d'elle — comme cela se produit avec la cellule de séparation rouge. L'image d'espacement de 1 pixel est maintenant alignée dans la cellule avec le bord inférieur de celle-ci, mais la ligne de référence est de retour et elle a la taille du texte normal.</p> - -<p>Voyez, par exemple, la figure 11, où la taille de la police a été considérablement augmentée. Les images de la barre de navigation ont maintenant un espace en dessous d'elles, et la bande rouge est bien plus large.</p> - -<p><img alt="Figure 11" src="/@api/deki/files/720/=Images-tables-gaps-figure11.gif"></p> - -<p>Il est difficile d'éviter cela, parce que les images sont, dans cette solution, encore des éléments de type en-ligne et participent donc toujours à la création d'une boîte de type en-ligne. Si cette boîte devient suffisamment grande, l'espace commencera à apparaître autour des images.</p> - -<h3 id="Voir_plus_loin" name="Voir_plus_loin">Voir plus loin</h3> - -<p>Grâce à l'implémentation minutieuse de CSS2 dans Mozilla, ce problème des images en-ligne dans des cellules de tableaux créant des espaces non désirés a été porté à l'attention du groupe de travail CSS du W3C. Plusieurs propositions de corrections ont été soumises, mais l'une des plus prometteuses est la propriété <a class="external" href="http://www.w3.org/TR/css3-box/#line-box-contain">line-box-contain</a>, qui a été proposée pour l'intégration dans CSS3. Si cette propriété devait être adoptée, alors tous les navigateurs la supportant pourraient émuler le comportement traditionnel de « rétrécissement », sans risquer d'autre problème d'affichage avec la règle suivante :</p> - -<pre class="eval">td {line-box-contain: font replaced;} /* proposée pour CSS3 */ -</pre> - -<p>Il existe d'autres solutions possibles dans le brouillon de travail CSS3, comme <a class="external" href="http://www.w3.org/TR/css3-box/#line-height">line-height-policy (en)</a>. Évidemment, plus vite des solutions seront trouvées et implémentées, plus les auteurs seront contents.</p> - -<h3 id="Recommandations" name="Recommandations">Recommandations</h3> - -<p>En l'absence du support de CSS3, il est difficile d'établir un ensemble précis de règles permettant de résoudre chaque occurrence de ces problèmes, car la meilleure solution pour un document donné dépendra grandement de sa structure. Si votre document utilise un balisage transitionnel, assurez-vous que son DOCTYPE corresponde et qu'il n'appelle pas le mode « standard ». Cela évitera aux navigateurs d'utiliser les modes de rendu standards, et ainsi tous les problèmes liés à la disposition des images seront résolus. Si vous utilisez un balisage strict, ou si vous avez besoin pour toute autre raison d'avoir un mode de rendu « standard », alors souvenez-vous de ces conseils :</p> - -<ul> - <li>Une image seule dans une cellule de tableau (par exemple, les GIF d'espacement de 1 pixel) doit être définie comme un élément de type bloc.</li> - <li>Une image dans une cellule de tableau contenant d'autres images doit être alignée verticalement avec le bas de la boîte de type en-ligne.</li> - <li>Une image dans une cellule de tableau contenant d'autres images et du texte doit être, le cas échéant, alignée verticalement suivant les situations.</li> -</ul> - -<p>Avec un cocktail judicieux des différentes approches et une réduction du nombre de GIF d'espacement de 1 pixel — qui ne sont absolument pas nécessaires dans un navigateur respectant les standards CSS — il est toujours possible de contourner cet étrange effet du support des standards.</p> - -<p>La meilleure solution est de s'assurer que les images soient toujours dans les cellules elles-mêmes, ce qui permet de les définir comme éléments de type bloc, mais comme toujours, cela dépendra de la conception de l'auteur.</p> - -<h3 id="Articles_connexes" name="Articles_connexes">Articles connexes</h3> - -<ul> - <li><a href="fr/Mode_presque_standard_de_Gecko">Mode presque standard de Gecko</a></li> - <li><a href="fr/Mode_quirks_de_Mozilla">Mode quirks de Mozilla</a></li> -</ul> - -<div class="originaldocinfo"> -<h3 id="Informations_sur_le_document_original" name="Informations_sur_le_document_original">Informations sur le document original</h3> - -<ul> - <li>Auteur(s) : Eric A. Meyer</li> - <li>Dernière mise à jour : 21 mars 2003</li> - <li>Copyright : © 2001-2003 Netscape.</li> -</ul> -</div> - -<p><span class="comment">Interwiki Languages Links</span></p> - -<p></p> diff --git a/files/fr/archive/misc_top_level/index.html b/files/fr/archive/misc_top_level/index.html deleted file mode 100644 index 95bf3b61ab..0000000000 --- a/files/fr/archive/misc_top_level/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Misc top level -slug: Archive/Misc_top_level -translation_of: Archive/Misc_top_level ---- -<p>In progress. These pages were moved from the top level of MDN in a spate of furious reorganization.</p> - -<p></p> diff --git a/files/fr/archive/misc_top_level/monitoring_wifi_access_points/index.html b/files/fr/archive/misc_top_level/monitoring_wifi_access_points/index.html deleted file mode 100644 index 11f243a830..0000000000 --- a/files/fr/archive/misc_top_level/monitoring_wifi_access_points/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Monitoring WiFi access points -slug: Archive/Misc_top_level/Monitoring_WiFi_access_points -translation_of: Archive/Misc_top_level/Monitoring_WiFi_access_points ---- -<p></p> - -<p>Avec les privilèges UniversalXPConnect le code peut scruter les points d'accès WiFi disponibles afin d'obtenir des informations à leur sujet, entre autres leur SSID, adresses MAC et la force du signal. Cette fonctionnalité a été introduite principalement pour permettre aux <a href="/Fr/Using_geolocation">services de geolocalisation</a> d'utiliser les services de localisation basés sur le WiFi.</p> - -<h2 id="Exemple">Exemple</h2> - -<p>Cette exemple affiche simplement une liste des points d'accès diponibles.</p> - -<pre class="brush: html"><html> -<head> -<title>Exemple de scrutation WiFi</title> -<script> - -var count = 0; - -function test() { -} - -test.prototype = -{ - onChange: function (accessPoints) - { - netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect'); - var d = document.getElementById("d"); - d.innerHTML = ""; - - for (var i=0; i<accessPoints.length; i++) { - var a = accessPoints[i]; - d.innerHTML += "<p>" + a.mac + " " + a.ssid + " " + a.signal + "</p>"; - } - - var c = document.getElementById("c"); - c.innerHTML = "<p>" + count++ + "</p>"; - - }, - - onError: function (value) { - alert("error: " +value); - }, - - QueryInterface: function(iid) { - netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect'); - if (iid.equals(Components.interfaces.nsIWifiListener) || - iid.equals(Components.interfaces.nsISupports)) - return this; - throw Components.results.NS_ERROR_NO_INTERFACE; - }, -} - - netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect'); - - var listener = new test(); - var wifi_service = Components.classes["@mozilla.org/wifi/monitor;1"].getService(Components.interfaces.nsIWifiMonitor); - - wifi_service.startWatching(listener); - -</script> -</head> - -<body> -<div id="d"><p></p></div> -<div id="c"><p></p></div> -</body> -</html> -</pre> - -<h3 id="L'objet_nsIWifiListener">L'objet nsIWifiListener</h3> - -<p>La première action de ce code est de prototyper l'objet écouteur qui recevra les notifications de changement dna sla liste des points d'accès. Cet objet est décrit par les lignes 11 à 40.</p> - -<p>La méthode <code>onChange()</code> (lignes 13 à 27) commence par activer les privilèges UniversalXPConnect, puis vide le <code>div</code> (<code>d</code>) qui va recevoir la liste des points daccès mis à jour. La boucle lignes 19 à 22 itère ensuite sur la liste des points d'accès reçus dans le tableau accessPoints et les ajoute au contenu du <code>div</code>.</p> - -<p>Par la suite le <code>div c</code> est mis à jour avec le nombre de fois où liste a été renouvellée.</p> - -<p>La méthode <code>onError()</code> fait simplement surgir une laert qui affiche le code erreur reçu.</p> - -<h3 id="Lancer_la_scrutation_des_points_d'accès">Lancer la scrutation des points d'accès</h3> - -<p>Pour commencer la scrutation des points d'accès, on instancie l'écouteur (ligne 44) puis on attrape une référence à l'interface de scrutation WiFi ligne 45. La scrutation commence ligne 47 en appelant la méthode <code>startWatching()</code> sur l'interface.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWifiMonitor" title="">nsIWifiMonitor</a></code></li> - <li><code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWifiListener" title="">nsIWifiListener</a></code></li> - <li><code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWifiAccessPoint" title="">nsIWifiAccessPoint</a></code></li> -</ul> diff --git a/files/fr/archive/misc_top_level/utilisation_de_data_islands_xml_dans_mozilla/index.html b/files/fr/archive/misc_top_level/utilisation_de_data_islands_xml_dans_mozilla/index.html deleted file mode 100644 index 5e4e7d224e..0000000000 --- a/files/fr/archive/misc_top_level/utilisation_de_data_islands_xml_dans_mozilla/index.html +++ /dev/null @@ -1,198 +0,0 @@ ---- -title: Utilisation de Data Islands XML dans Mozilla -slug: Archive/Misc_top_level/Utilisation_de_Data_Islands_XML_dans_Mozilla -tags: - - Obsolete - - XML -translation_of: Archive/Misc_top_level/Using_XML_Data_Islands_in_Mozilla ---- -<p> </p> -<p><span id="result_box" lang="fr"><span class="hps" title="Click for alternate translations">Cet article</span> <span class="hps" title="Click for alternate translations">est</span> <span class="hps" title="Click for alternate translations">obsolète</span><span title="Click for alternate translations">.</span> <span class="hps" title="Click for alternate translations">S'il vous plaît</span> <span class="hps" title="Click for alternate translations">voir</span> <a href="/en/Using_XML_Data_Islands_in_Mozilla" title="en/Using XML Data Islands in Mozilla"><span class="hps" title="Click for alternate translations">le</span> <span class="hps" title="Click for alternate translations">nouvel article</span> <span class="hps" title="Click for alternate translations">en anglais</span></a><span title="Click for alternate translations">.</span></span></p> -<p>Une fonctionnalité pratique d'Internet Explorer est la possibilité d'utiliser des îlots de données (Data islands, en anglais) pour lier des données aux contrôles HTML sur une page. Cette fonctionnalité n'est pas intégrée telle quelle dans Mozilla, mais on peut aisément imiter ce comportement pour créer des applications Web multi-navigateurs.</p> -<p>L'îlot de données basique que nous allons utiliser est un élément XML simple, soit lié à la page, soit codé explicitement dans celle-ci. Voici un exemple simple pour illustrer ceci :</p> -<pre class="eval"><xml id="xmlDataIsland"> - <loaninfo> - <borrower id="1"> - <firstname>Brian</firstname> - <middlename>Ellis</middlename> - <lastname>Johnson</lastname> - </borrower> - </loaninfo> -</xml> -</pre> -<p>Avec cet îlot de données, nous pouvons placer sur une page autant de contrôles que désirés en liant simplement l'îlot de données à ces contrôles à l'aide de JavaScript et du DOM.</p> -<p>Pour lier ceci, tout ce que nous avons besoin de faire est de confier le remplissage des contrôles à une fonction telle que :</p> -<pre class="eval">function loadFields() -{ - var xmlNode = window.document.getElementsByTagName('xml'); - var borrowerNode = xmlNode[0].childNodes[1]; - if(borrowerNode.hasChildNodes()) - { - var i = 0; - var xmlChildNode, nodeVal=<em>;</em> - while(borrowerNode.childNodes[i]) - { - // Recherche un nœud - xmlChildNode = borrowerNode.childNodes[i]; - // Vérifie le type de nœud - if(xmlChildNode.nodeType != 3) // #text == 3 - { - // Récupère la valeur du nœud (aka texte) - nodeVal += xmlChildNode.firstChild.nodeValue + ' '; - } - i++; - } - // Applique la valeur du contrôle au nœud - window.document.getElementById('txtBorrowerName').value = nodeVal; - } -} -</pre> -<p><a class="external" href="http://www.mozilla.org/xmlextras/xmldataislands/example1.html">Exemple 1</a></p> -<p>Voici un autre exemple d'ilot de données XML utilisable dans Mozilla ou IE :</p> -<pre class="eval"><xml id="mxxdataisland"> - <mxxdataisland> - <rowset tagid="DATES"></rowset> - <rowset tagid="SUBJPRP"></rowset> - <rowset tagid="PRODUCT"></rowset> - </mxxdataisland> -</xml> -</pre> -<p>Le role de cet îlot de données est d'apprendre au serveur d'applications à quels tableaux cette page va accéder.</p> -<p>Les contrôles de cette page sont alors liés au moyen des attributs personnalisés MXXOBJECT et MXXPROPERTY, très semblables aux attributs DATASRC et DATAFLD utilisés par IE. Ceci permet aux données XML retournées d'être analysées et liées ou « attachées » aux contrôles.</p> -<p>Remarque : Les noms MXXOBJECT et MXXPROPERTY ont été créés pour cet article, et peuvent être différents.</p> -<p>Lier les contrôles :</p> -<pre class="eval"><input - type="text" - id="PropertyStAddr1" - name="PropertyStAddr1" - style="height:21px;width:302px;text-align:left;" - maxlength="35" - class="fldDefault" - <span style="color: #CC0000;">mxxobject="SUBJPRP" mxxproperty="PropertyStAddr1"</span> <-- voici nos balises "d'attache" -> - -<input - type="text" - class="fldZipCode" - name="PropertyZip" - id="PropertyZip" - size="10" - style="height:21px;width:69px;" - <span style="color: #CC0000;">mxxobject="SUBJPRP" mxxproperty="PropertyZip"</span> <-- voici nos balises "d'attache" - <span style="color: #CC0000;">mxxxmlnode="xmldef_PropertyZip"</span> <-- this links to a control-level data island - <span style="color: #CC0000;">mxxtype="MXXZipCodeAutoLoadEdit"</span> <-- type personnalisé et optionnel pour manipuler les contrôles -> -</pre> -<p>Comme nous envoyons du XML au serveur, nous pouvons également lui envoyer certaines informations supplémentaires dont un contrôle particulier pourrait avoir besoin, ou lui signaler d'autres contrôles sur la page liés ou dirigés par un contrôle. Ci-dessous, voici un exemples de <em>DataIsland</em> personnalisé pour un type spécifique de contrôle :</p> -<pre class="eval"><select - id="PropertyState" - name="PropertyState" - style="height:20px;width:48px;" - class="cmbDefault" - mxxtype="GFXStateList" - <span style="color: #CC0000;">mxxxmlnode="xmldef_PropertyState"</span> - mxxobject="GOXSUBJPRP" mxxproperty="PropertyState" -> -</select> - -<div style="width:0px; height:0px; visibility:hidden;z-index:1"> - <xml <span style="color: #CC0000;">id="xmldef_PropertyState"</span>> - <mxxstatelist> - <status value="initialize"></status> - <contenttype value="abbrev"></contenttype> - <controls> - <control type="countylist" tagid="PropertyCounty" contenttype="name" - valuetype ="name"></control> - </controls> - </mxxstatelist> - </xml> -</div> -</pre> -<p>Telles quelles, ces <em>XMLDataIslands</em> ne nous sont d'aucune utilité. Il nous faut d'abord accomplir deux choses.</p> -<ol> - <li>Construire un gestionnaire de contrôle pour gérer les mises à jour et le rendu des différents types de contrôles.<br> - (Note : Les types de contrôles peuvent être n'importe quoi ; objet formulaire, tableau, spans, divs, iFrames, et tout ce à quoi vous avez accès via le DOM et un ID est valide)</li> - <li>Construire un gestionnaire pour créer un DOM à envoyer au serveur, et transmettre la réponse une fois analysée aux contrôles.</li> -</ol> -<p>Tout ce qu'un gestionnaire de contrôle doit être capable est de mettre à jour une valeur de contrôle. Cela signifie que tous les TextInputs peuvent partager un même gestionnaire, les selects un autre, etc. Une façon d'y parvenir est de regrouper les contrôles d'une page donnée dans un tableau associatif. Puis, lorsqu'une réponse est retournée, nous pouvons analyser le code XML à l'aide d'un attribut ID pour faire correspondre les données utiles XML avec un contrôle.</p> -<pre class="eval"><input type="text" id="FirstName" ...> -</pre> -<p>Exemple de fonction de collection d'objets :</p> -<pre class="eval"> // Extraction de tous les éléments pour les analyser - var tags = window.document.body.getElementsByTagName("*"); - var pPrevElem = null; - var pNextElem = null; - for (var i = 0; i < tags.length; i++) - { - pHTMLElement = tags[i]; - - switch (pHTMLElement.tagName.toLowerCase()) - { - case "span": - case "table": - // this indexes by controlID and stores the elementObject - m_MXXPageObjectsArray[pHTMLElement.id] = pHTMLElement; - break; - case "input": - case "select": - case "textarea": - case "button": - // this indexes by controlID and stores the elementObject - m_MXXPageObjectsArray[pHTMLElement.id] = pHTMLElement; - break; - case "div": - // this indexes by controlID and stores the elementObject - m_MXXPageObjectsArray[pHTMLElement.id] = pHTMLElement; - break; - } - } -</pre> -<p>La charge XML sortante pourrait être :</p> -<pre class="eval"><page id="NewUser"> - <formcontrols> - <control id="FirstName"> - <value /> - </control> - </formcontrols> -</page> -</pre> -<p>Le retour sera alors :</p> -<pre class="eval"><page id="NewUser"> - <formcontrols> - <control id="FirstName"> - <value>Dennis</value> - </control> - </formcontrols> -</page> -</pre> -<p>L'analyseur prend alors la réponse retournée, la charge dans un DOM XML, et passe chaque nœud au gestionnaire de contrôle approprié.</p> -<pre class="eval"> processTextControl(control, xmlNode); -</pre> -<p>Exemple d'analyse XML retournée :</p> -<pre class="eval"> // parseout to controls - var formControlNodes = xmlDoc.getElementsByTagName('formcontrols'); - for(i=0; i<formControlNodes.length;++i) - { - var pFormControlNode = formControlNodes[i]; - var pPageObject = m_MXXPageObjectsArray[pFormControlNode.getAttribute('id')]; - if(!pPageObject) - continue; - processTextControl(pPageObject, pBoundControlNode); - } -</pre> -<p>Le gestionnaire de contrôles va alors extraire les données nécessaires pour remplir le contrôle. Dans ce cas, la valeur <code>nodevalue</code> sera utilisée pour l'attribut <code>control.value</code>. Un Select pourrait créer de nouvelles Options() avec ces données, ou même remplacer le noeud ou le HTML par les nouvelles données.</p> -<p><a class="external" href="http://www.mozilla.org/xmlextras/xmldataislands/MXX_Info.html">Voici une page exemple.</a></p> -<p>Finalement, voici un <a class="external" href="http://www.mozilla.org/xmlextras/xmldataislands/table.html">exemple simple de tableau</a> utilisant les <em>Data Islands</em> XML qui fonctionne dans IE6 et dans Mozilla.</p> -<p>Pour que tout ce qui est décrit ci-dessus fonctionne, il nous faut envoyer cette information au serveur. Il y a plusieurs moyens, dont ASP, JSP et CGI. J'utilise XMLHTTP car il me permet de mettre à jour la page sans avoir à la recharger, qu'il permet aux contrôles de mettre à jour d'autres contrôles et qu'il agit comme une application 2-tiers classique en fournissant des mises à jour instantanées et la gestion des évènements.</p> -<p> </p> -<div class="originaldocinfo"> - <h2 id="Informations_sur_le_document_original" name="Informations_sur_le_document_original">Informations sur le document original</h2> - <ul> - <li>Auteur(s) : Thad Hoffman (<a class="link-mailto" href="mailto:phiori@mindspring.com">phiori@mindspring.com</a>, <a class="link-mailto" href="mailto:phiori@mac.com">phiori@mac.com</a>)</li> - <li>Autres contributeurs : Heikki Toivonen (<a class="link-mailto" href="mailto:heikki@netscape.com">heikki@netscape.com</a>)</li> - <li>Dernière mise à jour : 21 juin 2005</li> - <li>Copyright : Copyright (C) <a class="link-mailto" href="mailto:phiori@mindspring.com">Thad Hoffman</a>, <a class="link-mailto" href="mailto:heikki@netscape.com">Heikki Toivonen</a></li> - </ul> -</div> -<p><span class="comment">Liens Interwikis</span></p> -<p> </p> diff --git a/files/fr/archive/misc_top_level/utilisation_des_préférences_de_contenu/index.html b/files/fr/archive/misc_top_level/utilisation_des_préférences_de_contenu/index.html deleted file mode 100644 index bba4777f31..0000000000 --- a/files/fr/archive/misc_top_level/utilisation_des_préférences_de_contenu/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Utilisation des préférences de contenu -slug: Archive/Misc_top_level/Utilisation_des_préférences_de_contenu -tags: - - Firefox 3 -translation_of: Archive/Misc_top_level/Using_content_preferences ---- -<p> -Firefox 3 introduit le concept de préférences de contenu. Ceci permet à du code s'exécutant dans le chrome (en d'autres mots : les extensions et le navigateur lui-même, pas les sites Web) d'enregistrer localement des préférences sur une base site par site. Cela permet d'écrire une extension permettant à l'utilisateur de personnaliser l'apparence de sites Web particuliers (augmenter la taille de la police sur des sites qui utilisent des tailles très petites, par exemple). -</p><p>Le service de préférences de contenu, implémenté par <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentPrefService" title="">nsIContentPrefService</a></code>, offre des fonctions permettant de définir et de lire des préférences pour des sites particuliers ou dans l'espace global des préférences ; les préférences globales sont utilisées lorsqu'une préférence particulière à un site n'est pas disponible. -</p> -<h3 id="Exemple_:_d.C3.A9finition_et_lecture_de_pr.C3.A9f.C3.A9rences" name="Exemple_:_d.C3.A9finition_et_lecture_de_pr.C3.A9f.C3.A9rences"> Exemple : définition et lecture de préférences </h3> -<p>Cet exemple montre comment enregistrer une préférence et ensuite retrouver sa valeur. -</p> -<pre class="eval">var ioSvc = Components.classes["@mozilla.org/network/io-service;1"] - .getService(Components.interfaces.nsIIOService); -var prefService = Components.classes["@mozilla.org/content-pref/service;1"] - .getService(Components.interfaces.nsIContentPrefService); - -// Crée un objet URI référençant le site pour lequel enregistrer une préférence -var uri = ioSvc.newURI("<span class="nowiki">http://developer.mozilla.org/</span>", null, null); - -// Définit la valeur de la préférence "devmo.somesetting" à "foo". - -prefService.setPref(uri, "devmo.somesetting", "foo"); - -... - -// Récupère la valeur de la préférence "devmo.somesetting". - -var value = prefService.getPref(uri, "devmo.somesetting"); -</pre> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<p><code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentPrefService" title="">nsIContentPrefService</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentPrefObserver" title="">nsIContentPrefObserver</a></code> -</p><p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/drag_and_drop/index.html b/files/fr/archive/mozilla/drag_and_drop/index.html deleted file mode 100644 index bfe2d51f0e..0000000000 --- a/files/fr/archive/mozilla/drag_and_drop/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Drag and Drop -slug: Archive/Mozilla/Drag_and_drop -tags: - - TopicStub - - XUL -translation_of: Archive/Mozilla/Drag_and_drop ---- -<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> - -<p>{{ deprecated_header("gecko1.9.1") }}</p> - -<div class="warning">Depuis Gecko 1.9.1 (Firefox 3.5), ces API sont officiellement obsolètes, <a href="/En/DragDrop/Drag_and_Drop" title="en/DragDrop/Drag and Drop">les API portables plus récentes et plus simple</a> doivent être utilisées à leur place.</div> - -<p>Cette section décrit comment implémenter des objets qui peuvent être glissés et déposés sur d'autres objets.</p> - -<h3 id="The_Drag_and_Drop_Interface" name="The_Drag_and_Drop_Interface">L'interface glisser-déposer</h3> - -<p>De nombreuses interfaces utilisateur permettent de faire glisser des objets particuliers dans l'interface. Par exemple, faire glisser des fichiers vers d'autres répertoires ou faire glisser une icône vers une autre fenêtre pour ouvrir le document auquel elle fait référence. Mozilla et <a href="/en/XUL" title="en/XUL">XUL</a> fournissent un certain nombre d'événements qui peuvent gérer lorsque l'utilisateur tente de faire glisser des objets.</p> - -<p>Un utilisateur peut commencer à faire glisser en maintenant le bouton de la souris enfoncé et en déplaçant la souris. Le glissement s'arrête lorsque l'utilisateur relâche la souris. Les gestionnaires d'événements sont appelés lorsque l'utilisateur démarre et termine le glissement, et à divers points intermédiaires.</p> - -<p>Mozilla implémente le glissement en utilisant une session de glissement. Lorsqu'un utilisateur demande à faire glisser quelque chose qui peut être glissé, une session de glissement doit être lancée. La session de glissement gère la mise à jour du curseur de la souris et l'emplacement où l'objet doit être déposé. Si quelque chose ne peut pas être glissé, il ne doit pas démarrer une session de glisser. Étant donné que l'utilisateur n'a généralement qu'une seule souris, une seule session de glissement est en cours d'utilisation à la fois.</p> - -<p>Notez que les sessions de glissement peuvent être créées depuis Mozilla lui-même ou depuis d'autres applications. Mozilla traduira les données glissées selon les besoins.</p> - -<p>La liste ci-dessous décrit les gestionnaires d'événements qui peuvent être appelés, qui peuvent être placés sur n'importe quel élément. Il vous suffit de mettre des valeurs pour les gestionnaires là où vous devez faire quelque chose lorsque l'événement se produit.</p> - -<dl> - <dt>ondrag {{ Fx_minversion_inline(3) }}</dt> - <dd>Appelé périodiquement tout au long de l'opération de glisser-déposer.</dd> - <dt>ondraggesture </dt> - <dd>Appelé lorsque l'utilisateur commence à faire glisser l'élément, ce qui se produit normalement lorsque l'utilisateur maintient le bouton de la souris enfoncé et déplace la souris. Le script de ce gestionnaire doit configurer une session de glissement.</dd> - <dt>ondragstart {{ Fx_minversion_inline(3) }} </dt> - <dd>Un alias pour <code>ondraggesture</code>; il s'agit du nom de spécification HTML 5 de l'événement et peut être utilisé en HTML ou XUL; cependant, pour une compatibilité descendante avec les anciennes versions de Firefox, vous souhaiterez peut-être continuer à utiliser <code>ondraggesture</code> dans XUL.</dd> - <dt>ondragover </dt> - <dd>Ce gestionnaire d'événements est appelé pour un élément lorsque quelque chose est glissé dessus. Si l'objet peut être déposé sur l'élément, la session de glissement doit être notifiée.</dd> - <dt>ondragenter </dt> - <dd>Appelé pour un élément lorsque le pointeur de la souris passe pour la première fois sur l'élément pendant que quelque chose est déplacé. Cela peut être utilisé pour modifier l'apparence de l'élément pour indiquer à l'utilisateur que l'objet peut être déposé dessus.</dd> - <dt>ondragexit </dt> - <dd>Appelé pour un élément lorsque le pointeur de la souris sort d'un élément pendant que quelque chose est déplacé. Il est également <span class="tlid-translation translation" lang="fr"><span title="">appelé une fois qu'une suppression est terminée afin qu'un élément ait une chance de supprimer toute mise en évidence ou autre indication.</span></span></dd> - <dt>ondragdrop </dt> - <dd>Ce gestionnaire d'événements est appelé pour un élément lorsque quelque chose est déposé sur l'élément. À ce stade, l'utilisateur a déjà relâché le bouton de la souris. L'élément peut simplement ignorer l'événement ou le gérer d'une manière ou d'une autre, par exemple en collant l'objet glissé sur lui-même.</dd> - <dt>ondragend {{ Fx_minversion_inline(3) }} </dt> - <dd>Appelé lorsque l'opération de glissement est terminée.</dd> -</dl> - -<p>Il existe deux façons de gérer les événements par glisser-déposer. Cela consiste d'abord à utiliser directement les interfaces <a href="/en/XPCOM" title="en/XPCOM">XPCOM</a> glisser-déposer. La seconde consiste à utiliser un objet <a href="/en/Drag_and_Drop_JavaScript_Wrapper" title="en/Drag_and_Drop_JavaScript_Wrapper">wrapper JavaScript</a> qui gère une partie de cela pour vous. Le code de ce wrapper se trouve dans un fichier nommé {{ Source("toolkit/content/nsDragAndDrop.js nsDragAndDrop.js") }} qui est contenu dans le package widget-toolkit (ou global).</p> - -<h3 id="XPCOM_Drag_and_Drop_interfaces" name="XPCOM_Drag_and_Drop_interfaces">Interfaces XPCOM Glisser-déposer</h3> - -<p>Deux interfaces sont utilisées pour prendre en charge le glisser-déposer. Le premier est un service de glissement, <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> et le second est la session de glissement, <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a>.</p> - -<p>Le <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> est responsable de la création de sessions de glissement lorsqu'un glissement démarre et de la suppression de la session de glissement lorsque le glissement est terminé. La fonction <code>invokeDragSession</code> doit être appelée pour démarrer un glissement dans un gestionnaire d'événements <code>ondraggesture</code>. Une fois cette fonction appelée, un glissement a commencé.</p> - -<p>La fonction invokeDragSession prend quatre paramètres, comme décrit ci-dessous:</p> - -<pre class="eval notranslate">invokeDragSession(element,transferableArray,region,actions) -</pre> - -<dl> - <dt>element </dt> - <dd>Une référence à l'élément qui est déplacé. Cela peut être récupéré en obtenant la propriété <code>event.target</code> pendant le gestionnaire d'événements.</dd> - <dt>transferableArray </dt> - <dd>Un tableau d'objets <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a>, un pour chaque élément glissé. <span class="tlid-translation translation" lang="fr"><span title="">Un tableau est utilisé car vous souhaiterez peut-être faire glisser plusieurs objets à la fois, comme un ensemble de fichiers.</span></span></dd> - <dt>region </dt> - <dd>Une région utilisée pour l'indication de rétroaction. Cela devrait généralement être défini sur null.</dd> - <dt>actions </dt> - <dd>Les actions utilisées par le glissement. Cela doit être défini sur l'une des constantes suivantes, ou sur plusieurs ajoutées. L'action peut être modifiée pendant le glissement en fonction de ce qui est glissé.</dd> -</dl> - -<dl> - <dt>nsIDragService.DRAGDROP_ACTION_NONE </dt> - <dd> - <dl> - <dt>Utilisé pour indiquer qu'aucun glissement n'est valide.</dt> - <dt>nsIDragService.DRAGDROP_ACTION_COPY </dt> - <dd>L'élément déplacé doit être copié vers son emplacement de dépôt.</dd> - <dt>nsIDragService.DRAGDROP_ACTION_MOVE </dt> - <dd>L'élément déplacé doit être déplacé vers son emplacement de dépôt.</dd> - <dt>nsIDragService.DRAGDROP_ACTION_LINK </dt> - <dd>Un lien (ou un raccourci ou un alias) vers l'élément en cours de glissement doit être créé à l'emplacement de dépôt.</dd> - </dl> - </dd> -</dl> - -<p>L'interface {{ interface("nsIDragService") }} fournit également la fonction <code>getCurrentSession</code> qui peut être appelée depuis les gestionnaires d'événements de glissement pour obtenir et modifier l'état du glissement. La fonction renvoie un objet qui implémente {{interface ("nsIDragSession")}}.</p> - -<p>L'interface <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a> est utilisée pour obtenir et définir les propriétés du glissement en cours. Les propriétés et méthodes suivantes sont disponibles:</p> - -<dl> - <dt>canDrop </dt> - <dd>Définissez cette propriété sur <code>true</code> si l'élément sur lequel se trouve actuellement la souris peut accepter que l'objet actuellement glissé soit déposé dessus. Définissez la valeur sur <code>false</code> si cela n'a pas de sens d'y déposer l'objet. Cela doit être modifié dans les gestionnaires d'événements <code>ondragover</code> et <code>ondragenter</code>.</dd> - <dt>dragAction </dt> - <dd>Défini sur l'action en cours à effectuer, qui doit être une ou plusieurs des constantes décrites précédemment. Cela peut être utilisé pour fournir des commentaires supplémentaires à l'utilisateur.</dd> - <dt>numDropItems </dt> - <dd>Le nombre d'éléments glissés. Par exemple, il sera défini sur 5 si cinq signets sont déplacés.</dd> - <dt>getData(transfer,index) </dt> - <dd>Récupérez les données glissées. Le premier argument doit être un objet <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a> pour contenir les données. Le deuxième argument, <code>index</code>, doit être l'index de l'élément à renvoyer.</dd> - <dt>sourceDocument </dt> - <dd>Le document où le glissement a commencé</dd> - <dt>sourceNode </dt> - <dd>Le <span class="tlid-translation translation" lang="fr"><span title="">nœud</span></span> <a href="/en/DOM" title="en/DOM">DOM</a> où le glissement a commencé.</dd> - <dt>isDataFlavorSupported(flavor) </dt> - <dd>Renvoie <code>true</code> si les données déplacées contiennent des données de la saveur spécifiée.</dd> -</dl> - -<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> - -<div class="originaldocinfo"> -<h2 id="Original_Document_Information" name="Original_Document_Information">Informations sur le Document Original</h2> - -<ul> - <li>Auteur(s): <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> - <li>Document original:</li> - <li>Information sur les droits d'auteur: Copyright (C) <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> -</ul> -</div> diff --git a/files/fr/archive/mozilla/firefox/index.html b/files/fr/archive/mozilla/firefox/index.html deleted file mode 100644 index 9e61c718ff..0000000000 --- a/files/fr/archive/mozilla/firefox/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Firefox -slug: Archive/Mozilla/Firefox -translation_of: Archive/Mozilla/Firefox ---- -<p>In progress. Out-of-date information about the Firefox project.</p> - -<p></p> diff --git a/files/fr/archive/mozilla/firefox/les_états_de_contenu_et_le_système_de_style/index.html b/files/fr/archive/mozilla/firefox/les_états_de_contenu_et_le_système_de_style/index.html deleted file mode 100644 index 9d070c55b1..0000000000 --- a/files/fr/archive/mozilla/firefox/les_états_de_contenu_et_le_système_de_style/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Les états de contenu et le système de style -slug: Archive/Mozilla/Firefox/Les_états_de_contenu_et_le_système_de_style -tags: - - Développement_de_Mozilla -translation_of: Archive/Mozilla/Firefox/Content_states_and_the_style_system ---- -<p> -Les états de contenu sont ce que Gecko utilise pour mettre en œuvre les différentes règles CSS dépendant de l'état du contenu (comme par exemple <code>:hover</code>, <code>:active</code>, <code>:focus</code>, <code>target</code>, <code>:checked</code>). Nous nous concentrerons sur la description de la façon dont les changements dans ces états de contenus sont manipulés. -</p><p>Généralement, quand l'état de contenu d'un nœud change, le style doit être résolu à nouveau (recalculé) pour ce nœud et tous ses descendants. C'est une opération coûteuse cependant, c'est pourquoi le système de style essaie de minimiser le nombre de styles qu'il doit recalculer. À cette fin, quand une notification <a href="https://dxr.mozilla.org/mozilla-central/source/content/base/public/nsIDocumentObserver.h" rel="custom"><code>ContentStatesChanged</code></a><sup>(en)</sup> est acheminée pour un nœud de contenu, la première chose qui est faite est de vérifier si ce changement dans les états de contenu <em>pourrait</em> affecter certains styles. -</p><p>Ceci est réalisé en parcourant la liste de tous les <a class="external" href="http://www.w3.org/TR/CSS21/selector.html#q2"><sup>(en) </sup>sélecteurs simples CSS2.1</a> dans toutes les feuilles de style appliquées à la page qui ont une pseudo-classe de dépendance d'état faisant partie du sélecteur. Cette liste est créée durant l'analyse des feuilles de style impliquées. Pour chaque sélecteur de cette liste, on vérifie s'il a pu cesser correspondre au nœud ou commencer à le faire. Si c'est le cas, le style pourrait dépendre de l'état qui a changé et ce style doit donc être recalculé. -</p><p>Pour déterminer si le sélecteur pourrait avoir arrêté ou commencé à correspondre au nœud, on vérifie en fait s'il correspond à la règle selon laquelle toutes les pseudo-classes dépendantes de l'état correspondant aux états qui ont changé doivent être traitées comme concordantes avec le nœud (le fait qu'elles concordent, et leur éventuelle inversion). Ceci est nécessaire pour obtenir à la fois les sélecteurs qui se sont mis à concorder et ceux qui ne concordent plus. -</p><p>Par exemple, supposons que nous avons les sélecteurs suivants : -</p> -<pre class="eval"> a:hover - a:not(:hover) - div:hover -</pre> -<p>et que l'état <code>hover</code> sur certains nœuds change. On essaie alors d'appliquer au nœud ces sélecteurs, en supposant qu'à la fois <code>:hover</code> et <code>:not(:hover)</code> correspondent au nœud. L'effet sera donc identique à essayer d'appliquer à chaque nœud les sélecteurs : -</p> -<pre class="eval"> a - a - div -</pre> -<p>Le code qui met en œuvre ce procédé est dans la <a href="http://mxr.mozilla.org/mozilla-central/search?string=PRBool+SelectorMatches%28"><code>méthode SelectorMatches</code></a><sup>(en)</sup>, à qui est passée la liste des états qui ont changé dans le paramètre <code>aStateMask</code>. -</p> diff --git a/files/fr/archive/mozilla/firefox/soap_dans_les_navigateurs_gecko/index.html b/files/fr/archive/mozilla/firefox/soap_dans_les_navigateurs_gecko/index.html deleted file mode 100644 index 34537b58ef..0000000000 --- a/files/fr/archive/mozilla/firefox/soap_dans_les_navigateurs_gecko/index.html +++ /dev/null @@ -1,284 +0,0 @@ ---- -title: SOAP dans les navigateurs Gecko -slug: Archive/Mozilla/Firefox/SOAP_dans_les_navigateurs_Gecko -tags: - - SOAP - - Services_Web_XML -translation_of: Archive/Mozilla/Firefox/SOAP_in_Gecko-based_Browsers ---- -<p>Cet article décrit comment accéder à un service Web en utilisant SOAP et des fonctions JavaScript disponibles dans les navigateurs Gecko récents.</p> - -<h3 id="Introduction" name="Introduction">Introduction</h3> - -<p><em>Simple Object Access Protocol</em>(<a class="external" href="http://www.w3.org/TR/SOAP/">SOAP</a>) est la base de conception des services Web. C'est un protocole XML utilisé pour communiquer et interopérer avec les services Web. Avec Mozilla 1.0 (sur lequel est basé Netscape 7.0x) et Firefox, il est maintenant possible pour le navigateur de communiquer directement avec les services Web en utilisant son implémentation SOAP de bas niveau à l'aide de JavaScript.</p> - -<p>L'interface JavaScript de Gecko pour l'établissement des appels SOAP est une API de bas niveau qui requiert la construction de l'enveloppe SOAP en utilisant plusieurs objets JavaScript spécifiques à SOAP. Ce document couvre les opérations SOAP de base. Pour des informations plus détaillées sur l'API de bas niveau de SOAP dans Gecko, voir <a class="external" href="http://lxr.mozilla.org/mozilla/source/extensions/webservices/docs/Soap_Scripts_in_Mozilla.html">SOAP Scripts in Mozilla</a>.</p> - -<p>L'utilisation de JavaScript pour les communications avec les services Web est sujette aux mêmes politiques de sécurité que tous les autres scripts en terme d'accès inter-domaines. Par conséquent accéder à des services Web situés sur des serveurs autres que celui où est exécuté le JavaScript constitue une violation de la politique inter-domaines. Ce document montrera comment détourner temporairement ces règles pour la conduite de tests.</p> - -<h3 id="Param.C3.A9trer_un_appel_SOAP" name="Param.C3.A9trer_un_appel_SOAP">Paramétrer un appel SOAP</h3> - -<p>L'objet le plus basique est <code>SOAPCall</code>, il est utilisé pour initier et invoquer un appel SOAP.</p> - -<p>Figure 1 : paramétrage de base et invocation d'un appel SOAP</p> - -<pre>var mySOAPCall = new SOAPCall(); -mySOAPCall.transportURI = "http-based service URI" - -var parameters = new Array(); -mySOAPCall.encode(SOAPCall.VERSION_1_1, - // method - "method", "namespaceURI", - // header block - 0, null, - // parameter - parameters.length, parameters); - -var response = mySOAPCall.invoke(); -</pre> - -<p>Un objet <code>SOAPCall</code> à un membre appelé <code>transportURI</code>, qui est l'URI de l'emplacement où il doit envoyer l'appel SOAP. La méthode <code>encode()</code> requiert le nom de la méthode à appeler depuis le service Web, son <code>namespaceURI</code>, le nombre de <code>SOAPParameters</code> passé, et un tableau de <code>SOAPParameters</code> qui contient tous les paramètres. Tous ces paramètres peuvent sont regroupés dans le fichier WSDL du service Web, qui sera abordé dans les exemples suivants.</p> - -<p>Les paramètres SOAP sont créés à l'aide de l'objet <code>SOAPParameter</code>. Ce sont des paires nom/valeur qui sont passées au service Web.</p> - -<p>Figure 2 : Création d'un paramètre SOAP</p> - -<pre>var param = new SOAPParameter(); -param.name = "translationmode"; -param.value = "en_fr"; -</pre> - -<h3 id="Traitement_d.27une_r.C3.A9ponse" name="Traitement_d.27une_r.C3.A9ponse">Traitement d'une réponse</h3> - -<p>Une fois que <code>invoke()</code> a été appelé, Gecko génère l'enveloppe SOAP et l'envoie à l'URI spécifiée. Comme la requête est synchrone, la réponse sera la valeur retournée par <code>invoke()</code>.</p> - -<p>Figure 3 : Traitement d'une réponse à un appel SOAP</p> - -<pre>var returnObject = mySOAPCall.invoke(); - -if(returnObject.fault){ - alert("An error occured: " + returnObject.fault.faultString); -} else { - var response = new Array(); - response = returnObject.getParameters(false, {}); - alert("Return value: " + response[0].value); -} -</pre> - -<p>La valeur retournée par <code>invoke()</code> est stockée et examinée pour un membre <code>fault</code>. Si il existe, une erreur se produit du côté du service Web, et le message d'erreur est stocké dans <code>fault.faultString</code>. Si <code>fault</code> n'existe pas, nous appelons la fonction <code>getParameters()</code> sur l'objet retourné pour récupérer les <code>SOAPParameters</code> retournés.</p> - -<h3 id="Exemple" name="Exemple">Exemple</h3> - -<p>L'exemple utilise un service Web existant, Babelfish, fournit par <a class="external" href="http://www.xmethods.net/">xmethods.net</a>. Le service Web Babelfish permet des traductions dans de nombreuses langues. Il prend deux paramètres en entrée : une chaîne au format « originalLanguage_resultLanguage » et le texte à traduire. Le fichier WSDL du service Web Babelfish est disponible <a class="external" href="http://www.xmethods.net/sd/2001/BabelFishService.wsdl">à cette adresse</a> et contient toutes les informations nécessaires au paramétrage d'un appel SOAP de bas niveau vers le service Web.</p> - -<p>La première étape est de déterminer l'emplacement du service Web, qui sera la valeur du membre <code>transportURI</code> de <code>SOAPCall</code>. Elle peut être trouvée dans l'élément <code>service</code> de WSDL, et plus spécifiquement dans l'attribut <code>location</code> de <code>soap:address</code>.</p> - -<p>Figure 4 : Détermination de l'emplacement d'un service Web depuis son WSDL</p> - -<pre class="eval"><strong>WSDL:</strong> - <service name="BabelFishService"> - <documentation> - Traduit des textes dans de nombreuses langues. - </documentation> - <port name="BabelFishPort" binding="tns:BabelFishBinding"> - <span style="color: green;"><soap:address location="<span class="nowiki">http://services.xmethods.net:80/perl/soaplite.cgi</span>"/></span> - </port> - <service> - -<strong>JavaScript:</strong> - var babelFishCall = new SOAPCall(); - babelFishCall.transportURI = "<span class="nowiki">http://services.xmethods.net:80/perl/soaplite.cgi</span>"; - ... -</pre> - -<p>L'étape suivante est plus complexe : déterminer exactement quels paramètres le service Web attend qu'on lui envoie. Le service Web Babelfish ne possède qu'une méthode, « BabelFish », qui est représentée dans le WSDL entre la balise <code>operation</code>, qui est un enfant de l'élément <code>portType</code>. Chaque <code>operation</code> WSDL possède deux enfants : les éléments d'entrée et de sortie, qui peuvent contenir les types attendus. Les types sont définis dans les éléments <code>message</code>, au nombre de deux : <code>BabelFishRequest</code>, qui est ce qu'on passe au service Web, et <code>BabelFishResponse</code>, le type de retour.</p> - -<p>BabelFish attend l'opération deux dans les paramètres <code>translationmode</code> et <code>sourcedata</code>. L'exemple de la figure 5 va traduire la chaîne « I am » d'anglais en français.</p> - -<p>Figure 5 : Définir les paramètres nécessaires</p> - -<pre class="eval"><strong>WSDL:</strong> - <message <span style="color: blue;">name="BabelFishRequest"></span> - <span style="color: green;"><part name="translationmode" type="xsd:string"/></span> - <span style="color: green;"><part name="sourcedata" type="xsd:string"/></span> - </message> - - <message name="BabelFishResponse"> - <part name="return" type="xsd:string"/> - </message> - - <portType name="BabelFishPortType"> - <operation name="BabelFish"> - <span style="color: green;"><input message="tns:BabelFishRequest"/></span> - <output message="tns:BabelFishResponse"/> - </operation> - </portType> - -<strong>JavaScript:</strong> - // SOAP parameters - var param1 = new SOAPParameter(); - param1.value = "en_fr"; - param1.name = "translationmode"; - - var param2 = new SOAPParameter(); - param2.value = "I am"; - - param2.name = "sourcedate"; - - // combine the 2 params into an array - var myParamArray = [param1,param2]; -</pre> - -<p>Ensuite, il faut définir et invoquer l'objet <code>SOAPCall</code>. « BabelFish » est la méthode que notre exemple veut utiliser pour le service Web. Le prochain paramètre est l'espace de nommage attendu qui doit être passé au service Web pour la méthode BabelFish.</p> - -<p>Ceci peut être trouvé dans le l'élément WSDL <code>binding</code>. L'élément <code>binding</code> possède un enfant <code>operation</code> pour la méthode BabelFish. L'espace de nommage voulu est la valeur de l'attribut <code>namespace</code> de <code>soap:body</code> qui se trouve dans l'élément <code>input</code>.</p> - -<p>Figure 6 : Définir la méthode d'encodage</p> - -<pre class="eval"><strong>WSDL:</strong> - <binding name="BabelFishBinding" type="tns:BabelFishPortType"> - <soap:binding style="rpc" transport="<span class="nowiki">http://schemas.xmlsoap.org/soap/http</span>"/> - <operation name="BabelFish"> - <soap:operation soapAction="urn:xmethodsBabelFish#BabelFish"/> - <input> - <span style="color: green;"><soap:body use="encoded" namespace="urn:xmethodsBabelFish" - encodingStyle="<span class="nowiki">http://schemas.xmlsoap.org/soap/encoding/</span>"/></span> - </input> - ... - </operation> - </binding> - -<strong>JavaScript:</strong> - babelFishCall.encode(0, "BabelFish", "urn:xmethodsBabelFish", 0, null, myParamArray.length, myParamArray); - - var translation = babelFishCall.invoke(); -</pre> - -<p>Comme on l'a vu à la figure 5, la réponse de la méthode BabelFish ("BabelFishResponse") est un paramètre, à savoir une chaîne. Après avoir vérifier que <code>fault</code> n'a pas été retourné, la méthode <code>getParameters()</code> de l'objet retourné est utilisée pour récupérer un tableau de SOAPResponses. Comme on n'attend qu'un seul paramètre en retour -- le texte traduit -- la méthode <code>alert()</code> est utilisée pour afficher la traduction.</p> - -<p>Figure 7 : Traitement de la réponse</p> - -<pre class="eval"><strong>JavaScript:</strong> - if(translation.fault){ - // erreur retournée par le service Web - alert(translation.fault.faultString); - } else { - // nous attendons un seul SOAPParameter en retour - la chaîne traduite. - var response = new Array(); - response = translation.getParameters(false, {}); - alert("Translation: " + response[0].value); - } -</pre> - -<p>Comme indiqué dans l'introduction, les appels SOAP obéissent à une politique d'accès inter-domaines des scripts. Il existe deux façons de contourner cette politique de sécurité pour conduire des tests :</p> - -<ol> - <li> - <p>Exécutez le script depuis votre disque local.</p> - - <p>Enregistrez localement le code sur votre disque dur.</p> - - <p>Le modèle de sécurité inter-domaines ne concerne pas les codes exécutés depuis un disque local.</p> - </li> - <li> - <p>Activer l'accès inter-domaine</p> - - <p>Vous pouvez contourner la vérification inter-domaine en définissant une préférence comme expliqué dans l'article <a href="fr/Bypassing_Security_Restrictions_and_Signing_Code">contournement des restrictions de sécurité et signature de code (à traduire)</a> et en ajoutant une commande JavaScript pour demander une dérogation à la vérification inter-domaine.</p> - - <p>Après avoir contourner la vérification, démarrez le navigateur et chargez cette <a class="external" href="http://developer.mozilla.org/samples/soap/example-crossdomain.html">page exemple modifiée</a>. Il vous sera demandé (dans une boîte de dialogue) l'autorisation de désactiver l'inter-domaine (pour cette session) de la fonction générant l'appel SOAP. Le seul changement est l'ajout de <code>netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead");</code> à la fonction qui génère l'appel SOAP.</p> - </li> -</ol> - -<p>Figure 8 : Code final - <a class="external" href="http://developer.mozilla.org/samples/soap/example.html">Exemple local (en)</a>, <a class="external" href="http://developer.mozilla.org/samples/soap/example-crossdomain.html">Exemple inter-domaine (en)</a></p> - -<pre class="eval"><strong>JavaScript:</strong> - var babelFishCall = new SOAPCall(); - babelFishCall.transportURI = "<span class="nowiki">http://services.xmethods.net:80/perl/soaplite.cgi</span>"; - - // paramètres SOAP - var param1 = new SOAPParameter(); - param1.value = "en_fr"; - param1.name = "translationmode"; - - var param2 = new SOAPParameter(); - param2.value = "I am"; - param2.name = "sourcedate"; - - // combinaison des 2 paramètres dans un tableau - var myParamArray = [param1,param2]; - - babelFishCall.encode(0, "BabelFish", "urn:xmethodsBabelFish", 0, null, myParamArray.length, myParamArray); - - var translation = babelFishCall.invoke(); - - if(translation.fault){ - // erreur retournée par le service Web - alert(translation.fault.faultString); - } else { - // nous attendons un seul SOAPParameter en retour - la chaîne traduite. - var response = new Array(); - response = translation.getParameters(false, {}); - alert("Translation: " + response[0].value); - } -</pre> - -<h3 id="Chemin_de_l.27enveloppe_Soap" name="Chemin_de_l.27enveloppe_Soap">Chemin de l'enveloppe Soap</h3> - -<p>Voici un<em>HTTP dump</em> (utilisant l'outil multiplate-forme <a class="external" href="http://www.ethereal.com/">Ethereal</a>) de ce qui a été vraiment envoyé et reçu lorsque l'exemple a été exécuté :</p> - -<p>Figure 9 : HTTP Dumps</p> - -<pre class="eval"><strong>Sent:</strong> -POST /perl/soaplite.cgi HTTP/1.1 -Host: services.xmethods.net:80 -... -Content-Type: text/xml -Content-Length: 516 - -<env:Envelope xmlns:env="<span class="nowiki">http://schemas.xmlsoap.org/soap/envelope/</span>" - xmlns:enc="<span class="nowiki">http://schemas.xmlsoap.org/soap/encoding/</span>" - env:encodingStyle="<span class="nowiki">http://schemas.xmlsoap.org/soap/encoding/</span>" - xmlns:xs="<span class="nowiki">http://www.w3.org/1999/XMLSchema</span>" - xmlns:xsi="<span class="nowiki">http://www.w3.org/1999/XMLSchema-instance</span>"> - <env:Header/> - <env:Body> - <a0:BabelFish xmlns:a0="<span style="color: green;">urn:xmethodsBabelFish</span>"> - <span style="color: green;"><a0:translationmode xsi:type="xs:string">en_fr</a0:translationmode></span> - <span style="color: green;"><a0:sourcedata xsi:type="xs:string">I am</a0:sourcedata></span> - </a0:BabelFish> - </env:Body> -</env:Envelope> - - -<strong>Recieved:</strong> -HTTP/1.1 200 OK -Date: Tue, 11 Mar 2003 20:28:11 GMT -Server: Apache/1.3& (Unix) Enhydra-Director/3 PHP/4.0.6 DAV/1.0.3 AuthNuSphere/1.0.0 -SOAPServer: SOAP::Lite/Perl/0.52 -Content-Length: 532 - -... -Content-Type: text/xml; charset=utf-8 - -<?xml version="1.0" encoding="UTF-8"?> -<SOAP-ENV:Envelope xmlns:SOAP-ENC="<span class="nowiki">http://schemas.xmlsoap.org/soap/encoding/</span>" - SOAP-ENV:encodingStyle="<span class="nowiki">http://schemas.xmlsoap.org/soap/encoding/</span>" - xmlns:SOAP-ENV="<span class="nowiki">http://schemas.xmlsoap.org/soap/envelope/</span>" - xmlns:xsi="<span class="nowiki">http://www.w3.org/1999/XMLSchema-instance</span>" - xmlns:xsd="<span class="nowiki">http://www.w3.org/1999/XMLSchema</span>"> - <SOAP-ENV:Body> - <namesp1:BabelFishResponse xmlns:namesp1="urn:xmethodsBabelFish"> - <span style="color: green;"><return xsi:type="xsd:string">je suis</return></span> - </namesp1:BabelFishResponse> - </SOAP-ENV:Body> -</SOAP-ENV:Envelope> -</pre> - -<h3 id="Ressources" name="Ressources">Ressources</h3> - -<p><a class="external" href="http://lxr.mozilla.org/mozilla/source/extensions/webservices/docs/Soap_Scripts_in_Mozilla.html">SOAP Scripts in Mozilla (en)</a> par Ray Whitmer<br> - <a class="external" href="http://www.oreillynet.com/lpt/a/2677">Using the Mozilla SOAP API (en)</a> par Scott Andrew LePera et Apple Developer Connection.<br> - <a class="external" href="http://www.w3.org/TR/soap12-part1/">The Latest w3.org SOAP Specification (en)</a><br> - <a class="external" href="http://www.onlamp.com/lpt/a/5981">Calling SOAP Servers from JS in Mozilla (en)</a>, article de OnLamp.com par Zachary Kessin<br> - <a class="external" href="http://www.xulplanet.com/references/objref/SOAPCall.html">SOAPCall documentation on XULPlanet.com (en)</a><br> - <a class="external" href="http://www.xulplanet.com/references/objref/SOAPResponse.html">SOAPResponse documentation on XULPlanet.com (en)</a></p> diff --git a/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html b/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html deleted file mode 100644 index f45f86c6b4..0000000000 --- a/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: Utilisation de microformats -slug: Archive/Mozilla/Firefox/Utilisation_de_microformats -tags: - - Firefox 3 - - Microformats -translation_of: Archive/Mozilla/Firefox/Using_microformats ---- -<div></div> - -<p>Les microformats permettent aux sites Web de fournir des données sémantiques au navigateur afin que celui-ci puisse présenter un résumé des informations présentes sur une page sans avoir à connaître de manière particulière d'analyser son contenu. Firefox 3 implémente un objet global <code>Microformats</code> permettant d'accéder aux microformats. Cet objet et l'API associée facilitent la recherche et la lecture de microformats.</p> - -<h2 id="Chargement_de_l.27API_des_microformats" name="Chargement_de_l.27API_des_microformats">Chargement de l'API des microformats</h2> - -<p>L'objet <code>Microformats</code> est créé à l'aide du nouveau chargeur de scripts JavaScript ajouté à Firefox 3. Pour utiliser l'API, il faut d'abord charger cet objet :</p> - -<pre>Components.utils.import("resource://gre/modules/Microformats.js"); -</pre> - -<p>Une fois l'API des microformats chargée, il est possible de gérer des microformats à l'aide des méthodes listées ici. Pour plus d'information sur l'analyse de microformats, consultez <a href="/fr/docs/Analyse_de_microformats_en_JavaScript">Analyse de microformats en JavaScript</a>.</p> - -<h2 id="Microformats_pr.C3.A9d.C3.A9finis" name="Microformats_pr.C3.A9d.C3.A9finis">Microformats prédéfinis</h2> - -<p>Firefox 3 fournit des définitions implémentant divers microformats répandus :</p> - -<dl> - <dt><code><a href="/fr/docs/Le_microformat_adr">adr</a></code></dt> - <dd>Représente une adresse (comme une adresse de destination ou une adresse postale).</dd> - <dt><code><a href="/fr/docs/Le_microformat_geo">geo</a></code></dt> - <dd>Représente un emplacement géographique en utilisant sa latitude et sa longitude.</dd> - <dt><code><a href="/fr/docs/Le_microformat_hCard">hCard</a></code></dt> - <dd>Représente les informations de contact d'une personne.</dd> - <dt><code><a href="/fr/docs/Le_microformat_hCalendar">hCalendar</a></code></dt> - <dd>Représente une entrée de rendez-vous d'un agenda.</dd> - <dt><code><a href="/fr/docs/Le_microformat_tag">tag</a></code></dt> - <dd>Utilisé pour ajouter des balises à d'autres microformats.</dd> -</dl> - -<h2 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h2> - -<h3 id="add.28.29" name="add.28.29">add()</h3> - -<p>Ajoute un nouveau microformat au module des microformats.</p> - -<p></p><div class="note"><strong>Note :</strong> Si un microformat du nom spécifié existe déjà, il sera remplacé par le nouveau.</div><p></p> - -<pre>add(nom, définition); -</pre> - -<h5 id="add-Param.C3.A8tres" name="add-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat à ajouter au module des microformats.</dd> - <dt><code>définition</code></dt> - <dd>Une structure JavaScript décrivant le microformat. Consultez <a href="/fr/docs/Description_de_microformats_en_JavaScript">Description de microformats en JavaScript</a> pour plus de détails.</dd> -</dl> - -<h3 id="count.28.29" name="count.28.29">count()</h3> - -<p>Compte le nombre de microformats dans un document qui correspondent à des critères spécifiés.</p> - -<pre>nbMicroformats = Microformats.count(nom, élémentRacine, options); -</pre> - -<h5 id="count-Param.C3.A8tres_2" name="count-Param.C3.A8tres_2">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat à compter.</dd> - <dt><code>élémentRacine</code></dt> - <dd>Obligatoire. L'élément DOM où doit commencer la recherche. Pour rechercher dans le document entier, utiliser <code>content.document</code>.</dd> - <dt><code>options</code></dt> - <dd>Facultatif. Si ce paramètre est fourni, il s'agit d'un objet JavaScript contenant une série de drapeaux parmi les suivants : - <dl> - <dt><code>recurseExternalFrames</code></dt> - <dd>Si à <code>true</code>, les cadres enfants font partie de la recherche. La valeur par défaut est <code>true</code>.</dd> - <dt><code>showHidden</code></dt> - <dd>Si à <code>true</code>, les microformats cachés seront ajoutés ; autrement ils sont ignorés. La valeur par défaut est <code>false</code>.</dd> - <dt><code>debug</code></dt> - <dd>Spécifiez <code>true</code> si le mode debug est utilisé ; sinon indiquez <code>false</code>. La valeur par défaut est <code>false</code>.</dd> - </dl> - </dd> -</dl> - -<h5 id="count-Valeur_de_retour" name="count-Valeur_de_retour">Valeur de retour</h5> - -<p>Une valeur entière indiquant le nombre de microformats correspondant aux critères spécifiés.</p> - -<h3 id="debug.28.29" name="debug.28.29">debug()</h3> - -<p>Renvoie une chaîne qui décrit un objet de microformat.</p> - -<p></p><div class="note"><strong>Note :</strong> Il est possible d'appeler simplement <code>debug()</code> sur un objet de microformat : <code>objetMicroformat.debug()</code> au lieu d'utiliser cette méthode, si cela vous convient mieux.</div><p></p> - -<pre>dumpString = debug(objetMicroformat); -</pre> - -<h5 id="debug-Param.C3.A8tres" name="debug-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>objetMicroformat</code></dt> - <dd>L'objet de microformat à afficher.</dd> -</dl> - -<h5 id="debug-Valeur_de_retour_2" name="debug-Valeur_de_retour_2">Valeur de retour</h5> - -<p>Une chaîne décrivant le contenu de l'objet de microformat spécifié.</p> - -<h3 id="get.28.29" name="get.28.29">get()</h3> - -<p>Renvoie un tableau d'objets de microformat correspondant aux critères spécifiés.</p> - -<pre>microformats = Microformats.get(nom, élémentRacine, options, tableauCible); -</pre> - -<h5 id="get-Param.C3.A8tres" name="get-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat recherché.</dd> - <dt><code>élémentRacine</code></dt> - <dd>Obligatoire. L'élément DOM d'où sera lancée la recherche. Pour rechercher dans le document entier, indiquer <code>content.document</code>.</dd> - <dt><code>options</code></dt> - <dd>Facultatif. Si fourni, il s'agit d'un objet JavaScript contenant une série éventuellement vide des drapeaux suivants : - <dl> - <dt><code>recurseExternalFrames</code></dt> - <dd>Si défini à <code>true</code>, les cadres enfants référençant du contenu externe feront partie de la recherche. La valeur par défaut est <code>true</code>.</dd> - <dt><code>showHidden</code></dt> - <dd>Si défini à <code>true</code>, les microformats masqués seront ajoutés ; dans le cas contraire ils seront ignorés. La valeur par défaut est <code>false</code>.</dd> - <dt><code>debug</code></dt> - <dd>Indique d'utiliser le mode<em>debug</em> si à <code>true</code>. La valeur par défaut est <code>false</code>.</dd> - </dl> - </dd> - <dt><code>tableauCible</code></dt> - <dd>Facultatif. Si fourni, il s'agir d'un tableau d'objets microformat auquel ajouter les résultats de la recherche.</dd> -</dl> - -<h5 id="get-Valeur_de_retour" name="get-Valeur_de_retour">Valeur de retour</h5> - -<p>Un nouveau tableau d'objets microformat correspondant aux critères de recherche, ou le tableau spécifié par le paramètre <code>microformats</code> auquel les nouveaux objets microformat trouvés auront été ajoutés.</p> - -<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3> - -<p>Renvoie une liste de noms de microformats séparés par des espaces qui correspondent au nœud de microformat spécifié.</p> - -<pre>liste = Microformats.getNamesFromNode(nœud); -</pre> - -<h5 id="getNamesFromNode-Param.C3.A8tres" name="getNamesFromNode-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud pour lequel une liste de noms de microformats doit être obtenue.</dd> -</dl> - -<h5 id="getNamesFromNode-Valeur_de_retour" name="getNamesFromNode-Valeur_de_retour">Valeur de retour</h5> - -<p>Si le <code>nœud</code> spécifié est un microformat, le résultat est une chaîne listant tous les noms de microformats, séparés par des espaces, qui correspondent à ce nœud. Si le nœud n'est pas un microformat, rien ne sera renvoyé.</p> - -<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3> - -<p>Renvoie le nœud parent du microformat ou enfant de microformat spécifié.</p> - -<pre>nœudParent = Microformats.getParent(nœud); -</pre> - -<h5 id="getParent-Param.C3.A8tres" name="getParent-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud dont le parent doit être retrouvé.</dd> -</dl> - -<h5 id="getParent-Valeur_de_retour" name="getParent-Valeur_de_retour">Valeur de retour</h5> - -<p>Le parent du nœud spécifié. Ne renvoie rien si le <code>nœud</code> spécifié n'est pas un microformat ou l'enfant d'un microformat.</p> - -<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3> - -<p>Détermine si le nœud DOM spécifié est un microformat.</p> - -<pre>valeur = Microformats.isMicroformat(nœud); -</pre> - -<h5 id="isMicroformat-Param.C3.A8tres" name="isMicroformat-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud DOM dont on veut savoir s'il est un microformat.</dd> -</dl> - -<h5 id="isMicroformat-Valeur_de_retour" name="isMicroformat-Valeur_de_retour">Valeur de retour</h5> - -<p><code>true</code> si le nœud est un microformat, <code>false</code> sinon.</p> - -<p></p><div class="note"><strong>Note :</strong> Cette méthode ne renvoie<em>pas</em> <code>true</code> si le nœud est l'enfant d'un microformat.</div><p></p> diff --git a/files/fr/archive/mozilla/index.html b/files/fr/archive/mozilla/index.html deleted file mode 100644 index 9bdeac9114..0000000000 --- a/files/fr/archive/mozilla/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Archived Mozilla and build documentation -slug: Archive/Mozilla -tags: - - TopicStub -translation_of: Archive/Mozilla ---- -<p>Ces articles sont des documents archivés et obsolètes sur Mozilla, Gecko et le processus de construction de projets Mozilla.</p> - - - -<dl> - <dt class="landingPageList"><a href="/fr/docs/Archive/Mozilla/Persona">Persona</a></dt> - <dd class="landingPageList"><a class="link-https" href="https://login.persona.org">Mozilla Persona</a> est un système d'identification pour le web facile à utiliser et à déployer. Il fonctionne sur <a href="/fr/docs/persona/Browser_compatibility">tous les principaux navigateurs</a>, vous pouvez l'<a href="/fr/Persona/Quick_Setup">utiliser dès maintenant</a>.</dd> - <dt class="landingPageList"><a href="/fr/docs/Plug-n-Hack">Plug-n-Hack</a></dt> - <dd class="landingPageList"><strong>Plug-n-Hack</strong> (PnH) est un standard proposé par l'équipe de sécurité de Mozilla pour définir comment les outils de sécurité peuvent interagir avec les navigateurs de manière plus utile et utilisable.</dd> - <dt class="landingPageList"><a href="/fr/docs/Prism">Prism</a></dt> - <dd class="landingPageList">Prism est une <a href="fr/Cr%c3%a9ation_d'applications_XULRunner_avec_le_syst%c3%a8me_de_compilation_de_Mozilla">application XULRunner</a>. En plus du moteur de navigation inclus dans XULRunner, elle est constituée de :</dd> -</dl> diff --git a/files/fr/archive/mozilla/nouveau_modèle_de_sécurité_des_services_web/index.html b/files/fr/archive/mozilla/nouveau_modèle_de_sécurité_des_services_web/index.html deleted file mode 100644 index a17843a89a..0000000000 --- a/files/fr/archive/mozilla/nouveau_modèle_de_sécurité_des_services_web/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: Nouveau modèle de sécurité des services Web -slug: Archive/Mozilla/Nouveau_modèle_de_sécurité_des_services_Web -tags: - - SOAP -translation_of: Archive/Mozilla/New_Security_Model_for_Web_Services ---- -<h2 id="Securing_Resources_From_Untrusted_Scripts_Behind_Firewalls" name="Securing_Resources_From_Untrusted_Scripts_Behind_Firewalls">Securing Resources From Untrusted Scripts Behind Firewalls</h2> - -<h3 id="Introduction" name="Introduction">Introduction</h3> - -<p>This page describes an alternative mechanism which can be used to protect all internal resources against requests from sandboxed scripts. This should especially be implemented for SOAP calls by untrusted scripts. When an attempt is made to access a resource at a previously-unknown URI, the sandbox reads a file at that domain with declarations to determine whether access is permitted to the script. If the file is not there, access is denied.</p> - -<h3 id="The_Problem" name="The_Problem">The Problem</h3> - -<p>External untrusted scripts loaded behind a firewall are executed in a sandbox. These scripts may legitimately require access to external resources, but permitting them to access internal resources permits the compromise of these resources that would normally not be available to applications outside of the firewall. The sandbox must distinguish and protect internal resources.</p> - -<h3 id="Client-controlled_Solutions" name="Client-controlled_Solutions">Client-controlled Solutions</h3> - -<p>Several client-controlled solutions have been designed to prevent sandboxed applications loaded behind a firewall from compromising other resources protected behind the firewall.</p> - -<h4 id="Same_Source_Restriction" name="Same_Source_Restriction">Same Source Restriction</h4> - -<p>By restricting sandboxed scripts to access only resources in the domain from which they were loaded, any script loaded from one domain into another is prevented from accessing resources in the domain into which it has been loaded. This policy has generally been successful in sandboxing Javascript and Java applets across the web.</p> - -<p>If the sandbox is unable to distinguish the common URI substring of the domain to be trusted from similar URIs of untrusted domains, then it could allow a script loaded from an indistinguishable domain to exploit firewall-protected resources.</p> - -<p>Also, this technique prevents the script from accessing many legitimate external resources not provided in the same domain as the script. This prevents a script from accessing web services and data published from any domain besides its own.</p> - -<h4 id="White-listing" name="White-listing">White-listing</h4> - -<p>By creating a white list of trusted URIs from which scripts are trusted to not compromise internal resources, it is possible to release domains from the stricter same-source sandbox. A white list is a good tool for including always-trusted domains, but on the web, it is often a script from a relatively-untrusted domain that must be granted access to other untrusted domains, without compromising internal domains.</p> - -<p>More-complex access lists could be created to try to establish, with finer granularity, which domains are to be accessible or permitted from which other domains, but this requires extensive management which at best is quite error-prone for the end user and easily opens holes in a firewall that do not directly hurt the user who reconfigured his browser to try to access some external service but hurts the owners of other services behind the firewall.</p> - -<h4 id="Signed_Scripts" name="Signed_Scripts">Signed Scripts</h4> - -<p>A certain degree of additional trust may be lent to a script by having the author digitally sign it. But signed scripts have not really caught on as they require certificates do not change the basic problem that some completely-unknown party has written a script that might now have access to internal resources.</p> - -<h4 id="Asking_the_User" name="Asking_the_User">Asking the User</h4> - -<p>Where the sandbox cannot otherwise determine whether the executing script should be permitted access to the resource, a dialog box may be raised to ask the user to grant special privileges. This is currently permitted for locally-saved scripts and signed scripts. This could be combined with the other options above such as whitelisting, signed scripts, etc. But the big problem with this is that the typical browser user really does not either understand or pay the consequences if he inadvertently opens a hole in his company's firewall. Quite complex settings may be required to permit the user to allow access to desired external services without risking other resources.</p> - -<h3 id="Controlling_Resource_Access_on_the_Server" name="Controlling_Resource_Access_on_the_Server">Controlling Resource Access on the Server</h3> - -<p>Access by untrusted scripts really needs to be under the control of the stake holder, which is the resource and server owner -- not the user -- to determine whether a resource should be insulated from web applications loaded from outside of the firewall.</p> - -<h4 id="Using_a_SOAP_Header_for_Verification" name="Using_a_SOAP_Header_for_Verification">Using a SOAP Header for Verification</h4> - -<p>SOAP messages have a distinct processing model allowing a header to be added that the recipient is required to understand and accept, which identifies the untrusted source of a script making a request. SOAP services which have not been cleared for access by untrusted scripts will reject the requests. This is offered in the Mozilla implementation of SOAP today.</p> - -<p>Unfortunately, this does not prevent SOAP messages from being sent to non-SOAP addresses, which is a big enough problem that the verification cannot stand alone to guarantee that untrusted service requests are always properly rejected by services that should be firewall-protected.</p> - -<p>It may also be inconvenient to modify a SOAP service to ignore the specific verification header.</p> - -<h4 id="Using_a_Declarations_File" name="Using_a_Declarations_File">Using a Declarations File</h4> - -<p>A more robust solution is to rely on getting a file named "web-scripts-access.xml" in the root directory of the server that the sandboxed script requests to communicate with. It should be fairly easy for most providers of public resources to create.</p> - -<h3 id="Web_Scripts_Access_Statements" name="Web_Scripts_Access_Statements">Web Scripts Access Statements</h3> - -<p>The syntax of statements of the access file are as follows.</p> - -<pre><!ELEMENT webScriptAccess (delegate?|allow*)> -<!ELEMENT delegate EMPTY> -<!ELEMENT allow EMPTY> -<!ATTLIST allow type|from CDATA #IMPLIED>. -</pre> - -<h4 id="L.27.C3.A9l.C3.A9ment_racine" name="L.27.C3.A9l.C3.A9ment_racine">L'élément racine</h4> - -<p>Le premier élément du fichier doit être le suivant :</p> - -<pre><wsa:webScriptAccess xmlns:wsa="http://www.mozilla.org/2002/soap/security"> -</pre> - -<h4 id="Delegation" name="Delegation">Delegation</h4> - -<p>If the <code><delegate/></code> element is present then <code>"web-scripts-access.xml"</code> is required in the subdirectory for URIs which are in a subdirectory. For example, if the script in question is <code><span class="nowiki">"http://www.example.com/foo/bar.xml"</span></code>, then the declarations file <code><span class="nowiki">http://www.example.com/web-scripts-access.xml</span></code> which contains the "delegate" keyword delegates to <code><span class="nowiki">http://www.example.com/foo/web-scripts-access.xml</span></code>. If the URI is in a subdirectory, and the root directory's access file delegated but no access file exists in the subdirectory, then no access is granted. If the root's access file did not delegate, then that access file also handles all resources in subdirectories.</p> - -<p>Any syntax error in the document will result in the rest of the file to be ignored. Since the commands only allow access, the order of processing the "allow" commands that were successfully parsed is never significant.</p> - -<h4 id="Autoriser_l.27acc.C3.A8s_de_script_Web" name="Autoriser_l.27acc.C3.A8s_de_script_Web">Autoriser l'accès de script Web</h4> - -<p>Pour permettre aux scripts d'accéder aux ressources de ce serveur, utiliser la commande suivante:</p> - -<pre><wsa:allow type="<request-type>" from ="<uri-prefix>"/> -</pre> - -<p>Le type de requête, s'il est spécifié, sera vérifié par rapport au type de requête demandé par le script, comme "soap", "soapv", ou "load". Les types ne doivent pas contenir d'espace. Le type "any" permet à n'importe quel type de requête d'accéder aux ressources.</p> - -<p>Le principe URI du script sera vérifié par le préfixe URI spécifié.</p> - -<p>Si "from" n'est pas spécifié, tous les scripts seront autorisés.</p> - -<p>Note : On peut également utiliser n'importe quel(s) caractère(s) pour renseigner la valeur de "from".</p> - -<p>Par exemple:</p> - -<pre><wsa:allow type="soapv" from="http://www.mozilla.org"/> -</pre> - -<p>Cette commande autorise les reqêtes SOAP avec une vérification des en-têtes des scripts chargé depuis le domaine www.mozilla.org.</p> - -<pre><wsa:allow type="soapv" from="http://*.mozilla.org"/> -</pre> - -<p>Cette commande autorise les requêtes SOAP avec une vérification des en-têtes des scripts chargé depuis le domaine avec un nom d'hôte contenant mozilla.org.</p> - -<p>C'est à dire, <span class="nowiki">http://www.mozilla.org/</span>, <span class="nowiki">http://lxr.mozilla.org</span>, <span class="nowiki">http://komodo.mozilla.org</span>, etc. auront un droit d'accès.</p> - -<h3 id="Implementation" name="Implementation">Implementation</h3> - -<h4 id="nsIWebScriptsAccessService" name="nsIWebScriptsAccessService"><a href="fr/NsIWebScriptsAccessService">nsIWebScriptsAccessService</a></h4> - -<p>This interface provides a way to check whether the running script has access to the server that the script wishes to communicate.</p> - -<ul> - <li>boolean canAccess(in nsIURI aTransportURI, in AString aType); - <ul> - <li>aTransportURI - The service URI</li> - <li>aType - Type requested by the script ( ex. soapv, soap, load, etc. )</li> - <li>return PR_TRUE if access granted else PR_FALSE</li> - </ul> - </li> - <li>void invalidateCache(in string aTransportURI); - <ul> - <li>Invalidate cached entry for the given transport uri.</li> - <li>Empty the cache by passing in a empty string</li> - </ul> - </li> -</ul> - -<h4 id="nsWebScriptsAccess_.28Implements_nsIWebScriptsAccessService.29" name="nsWebScriptsAccess_.28Implements_nsIWebScriptsAccessService.29"><a href="fr/NsWebScriptsAccess">nsWebScriptsAccess</a><em>(Implements <a href="fr/NsIWebScriptsAccessService">nsIWebScriptsAccessService</a>)</em></h4> - -<p>Maintains access information, for servers, in an access-info-cache ( hashtable ). If an entry was not found in the cache creates one by loading the declaration file (web-scripts-access.xml) and extracting information from it (declaration file); requested type and subject princple's prefix are compared to the allowed type and prefix in order to determine access. An entry is created if and only if the declaration file is considered valid (validation based on the syntax described above); an invalid document will result in access denial. Denies script access in the event of an xml-wellformedness error, or validation error, or if the declaration file does not grant access. Reports errors (validation, wellformedness, file not found, etc.) to the console via <a href="fr/NsIConsoleService">nsIConsoleService</a>.</p> - -<div class="note"> -<p>Note: Script access is checked via declaration file only if the script security manager denies access.</p> -</div> - -<h3 id="Summary" name="Summary">Summary</h3> - -<h4 id="Advantages" name="Advantages">Advantages</h4> - -<p>The proposed declaration file places the server operator, not the client in control of access to his server by untrusted scripts. The access hole is no bigger than the service in question. The access is disabled by default, and there is nothing the user needs to do to open access, and nothing that can go wrong to make a hole in his firewall. It seems fairly easy to drop an access file into the root directory of the web server to allow access.</p> - -<h4 id="Delegation_with_Mixed_Ownership" name="Delegation_with_Mixed_Ownership">Delegation with Mixed Ownership</h4> - -<p>Independent owners of subdirectories cannot grant web script access to these subdirectories without getting the owner of the root directory to post a delegating access file. Normally a server will be either inside or outside of a firewall, so this is not a problem. Where a server spans multiple owners, the alternative would be to scan all directories in the path looking for a web scripts access file, which seems undesirable. On the other hand, perhaps it is not so bad, since it permits independent management in domains where the top level owner may not care about providing access to web services.</p> - -<h4 id="Adjustments" name="Adjustments">Adjustments</h4> - -<p>As this new model is applied to SOAP, and potentially document.load or xml-request, it may be desirable to eliminate the same source security bypass, because it is not clear that this is always secure. Other security adjustments may be desired as well.</p> - -<h3 id="Feedback.3F" name="Feedback.3F">Feedback?</h3> - -<p>Please send me some feedback on this proposal.</p> - -<h2 id="See_Also" name="See_Also">See Also</h2> - -<ul> - <li><a href="fr/Mozilla_Web_Services_Security_Model">Mozilla Web Services Security Model</a> - documentation of what is currently implemented</li> -</ul> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/mozilla/persona/api_de_verification/index.html b/files/fr/archive/mozilla/persona/api_de_verification/index.html deleted file mode 100644 index 04a8400141..0000000000 --- a/files/fr/archive/mozilla/persona/api_de_verification/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: API de vérification -slug: Archive/Mozilla/Persona/API_de_verification -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Remote_Verification_API ---- -<h2 id="Summary" name="Summary">Résumé</h2> -<p>Lorsqu'un utilisateur essaie de se connecter sur un site, son navigateur génère un objet de données appelé une <em>assertion</em>. Il s'agit essentiellement d'une adresse mail cryptée. Le navigateur envoie cette assertion au site, qui doit vérifier sa validité avant de connecter l'utilisateur.</p> -<p>Les assertions peuvent être vérifiées localement, ou en utilisant l'API disponible à l'adresse <span class="link-https"><code>https://verifier.login.persona.org/verify</code></span>. Cette page décrit comment utiliser l'API.</p> -<h2 id="Methods" name="Methods">Méthode</h2> -<p>Envoyez une requête HTTP POST à l'adresse <code>https://verifier.login.persona.org/verify</code>.</p> -<h3 id="Parameters" name="Parameters">Paramètres</h3> -<dl> - <dt> - <code>assertion</code></dt> - <dd> - L'assertion est fournie par l'utilisateur. Disponible en tant que premier paramètre passé à la fonction <code>onlogin</code> dans <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>.</dd> - <dt> - <code>audience</code></dt> - <dd> - Le protocole, nom de domaine et port de votre site. Par exemple : "<code>https://example.com:443</code>".</dd> -</dl> -<h3 id="Return_values" name="Return_values">Valeurs de retour</h3> -<p>La requête retourne un objet JSON contenant une propriété <code>status</code> qui peut valoir "okay" ou "failure". En fonction de ces valeurs, l'objet peut contenir des éléments additionels listés ci-dessous.</p> -<h4 id="okay" name="okay">"okay"</h4> -<p>L'assertion est valide.</p> -<p>Dans ce cas, l'objet JSON contient en plus les propriétés suivantes :</p> -<table class="standard-table" style="width: 80%;"> - <tbody> - <tr> - <td>"<code>email</code>"</td> - <td>L'adresse mail contenue dans l'assertion, pour permettre la connexion de l'utilisateur.</td> - </tr> - <tr> - <td>"<code>audience</code>"</td> - <td>La valeur audience contenue dans l'assertion. Doit être l'URL de votre propre site.</td> - </tr> - <tr> - <td>"<code>expires</code>"</td> - <td>La date à laquelle expire l'assertion, exprimée The date the assertion expires, exprimé comme une <a href="/fr/docs/Référence_de_JavaScript_1.5_Core/Objets_globaux/Date/valueOf" title="en/JavaScript/Reference/Global_Objects/Date/valueOf">valeur primitive de l'objet Date</a> qui est le nombre de secondes écoulées depuis le 1er Janvier 1970 00h00 GMT.</td> - </tr> - <tr> - <td>"<code>issuer</code>"</td> - <td>Le nom du fournisseur d'identité ayant fourni l'assertion.</td> - </tr> - </tbody> -</table> -<h4 id="failure" name="failure">"failure"</h4> -<p>L'assertion n'est pas valide.</p> -<p><span style="line-height: 1.572;">Dans ce cas, l'objet JSON contient une propriété additionnelle :</span></p> -<table class="compact-table"> - <tbody> - <tr> - <td><code>"reason"</code></td> - <td>Une chaîne de caractère expliquant pourquoi la validation de l'assertion a échoué</td> - </tr> - </tbody> -</table> -<h2 id="Examples" name="Examples">Exemples</h2> -<h3 id="node.js" name="node.js">node.js</h3> -<p>Cet exemple utilise un serveur node.js utilisant express.js</p> -<pre class="brush: js">var express = require("express"), - app = express.createServer(), - https = require("https"), - querystring = require("querystring"); -/* ... */ - -// La variable audience doit correspondre à ce qu'affiche la barre d'adresse du navigateur, -// ce qui inclut le protocole, le nom de domaine et le port -var audience = "http://localhost:8888"; - -app.post("/authenticate", function(req, res) { - var vreq = https.request({ - host: "verifier.login.persona.org", - path: "/verify", - method: "POST" - }, function(vres) { - var body = ""; - vres.on('data', function(chunk) { body+=chunk; } ) - .on('end', function() { - try { - var verifierResp = JSON.parse(body); - var valid = verifierResp && verifierResp.status === "okay"; - var email = valid ? verifierResp.email : null; - req.session.email = email; - if (valid) { - console.log("l'assertion a été vérifiée avec succès pour le mail :", email); - res.json(email); - } else { - console.log("l'assertion n'a pas été validée pour la raison suivante :", verifierResp.reason); - res.send(verifierResp.reason, 403); - } - } catch(e) { - console.log("le verifier n'a pas renvoyé un objet JSON"); - // bogus response from verifier! - res.send("bogue de la part du verifier !", 403); - - } - }); - }); - - vreq.setHeader('Content-Type', 'application/x-www-form-urlencoded'); - - var data = querystring.stringify({ - assertion: req.body.assertion, - audience: audience - }); - - vreq.setHeader('Content-Length', data.length); - vreq.write(data); - vreq.end(); - - console.log("vérification de l'assertion"); -}); - -</pre> -<p>via <a class="link-https" href="https://github.com/lloyd/myfavoritebeer.org/blob/06255b960e1f9078bc935c1c7af0662f33c88818/server/main.js#L112">Lloyd Hilaiel</a></p> -<h3 id="PHP" name="PHP">PHP</h3> -<pre class="brush: php">$url = 'https://verifier.login.persona.org/verify'; -$assert = filter_input( - INPUT_POST, - 'assertion', - FILTER_UNSAFE_RAW, - FILTER_FLAG_STRIP_LOW|FILTER_FLAG_STRIP_HIGH -); -//utiliser la superglobale $_POST pour PHP < 5.2 et écrire votre propre filtre -$params = 'assertion=' . urlencode($assert) . '&audience=' . - urlencode('http://example.com:80'); -$ch = curl_init(); -$options = array( - CURLOPT_URL => $url, - CURLOPT_RETURNTRANSFER => TRUE, - CURLOPT_POST => 2, - CURLOPT_POSTFIELDS => $params -); -curl_setopt_array($ch, $options); -$result = curl_exec($ch); -curl_close($ch); -echo $result;</pre> -<p>Via <a class="link-https" href="https://github.com/codepo8/BrowserID-login-with-PHP/blob/184fdb74c8a554461c262875859968154d09288e/verify.php">Christian Heilmann</a></p> -<p>Note: si vous envoyez les paramètres assertion et audience en tant qu'objet JSON, ils <strong>ne doivent pas</strong> être encodés. S'ils sont envoyés en tant que paramètres normaux d'une requête HTTP POST, comme dans l'exemple ci-dessus, ils <strong>doivent</strong> être encodés.</p> diff --git a/files/fr/archive/mozilla/persona/bootstrapping_persona/index.html b/files/fr/archive/mozilla/persona/bootstrapping_persona/index.html deleted file mode 100644 index ed8caf194e..0000000000 --- a/files/fr/archive/mozilla/persona/bootstrapping_persona/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Persona Hosted Services -slug: Archive/Mozilla/Persona/Bootstrapping_Persona -translation_of: Archive/Mozilla/Persona/Bootstrapping_Persona ---- -<p>Pour réussir et être vraiment décentralisé, Persona a besoin du soutien de trois groupes différent :</p> - -<ul> - <li><strong>Les Sites Web</strong> doivent permettre à leurs utilisateurs de se connecter avec Persona.</li> - <li><strong>Les Navigateurs Web</strong> doivent implémanter l'API <a href="/en/DOM/navigator.id" title="navigator.id"><code>navigator.id</code></a>.</li> - <li><strong>Les Fournisseurs d'Email</strong> doivent devenir des Fournisseur d'identité (IdPs).</li> -</ul> - -<p>Cela crée un cercle vicieux : aucun de ces groupes n'auraient un intêret significatif tant qu'il n'y avait un grand nombre d'utilisateur, mais un système distribué ne peut pas avoir un grand nombre d'utilisateur sans le soutien des groupes ci-dessus.</p> - -<p>Pour résoudre ce problème, <a class="link-https" href="https://login.persona.org" rel="freelink">https://login.persona.org</a> enregistre trois resources :</p> - -<ol> - <li>Un Fournisseur d'Identité de secours, qui es disponible pour les utilisateurs dont les fournisseurs d'email ne supporte pas Persona.</li> - <li>A <a href="/en-US/docs/persona/Browser_compatibility" title="/en-US/docs/persona/Browser_compatibility">cross-browser</a>, JavaScript implementation of the <code><a href="/en/DOM/navigator.id" title="navigator.id">navigator.id</a></code> APIs for browsers without native support.</li> - <li>A hosted verification API to make it easy for sites to verify user credentials.</li> -</ol> - -<p>Together, this allows web sites to offer Persona to users regardless of browser and without email providers needing to get involved.</p> - -<p>These services are temporary, and the Persona system is designed such that they transparently and automatically drop away as native support gets added to browsers and email providers. Thus, they will become less relevant as Persona matures, and may eventually be removed all together. At that point, <a href="https://login.persona.org" rel="freelink">https://login.persona.org</a> won't feature at all in the Persona system.</p> - -<h2 id="Fallback_Identity_Provider">Fallback Identity Provider</h2> - -<p>Any domain can become an Identity Provider as long as relying parties are willing to trust the certificates issued by that domain. We expect email providers to act as an IdPs for the addresses they administer, making the user experience of Persona seamless for those users. It allows the user to leverage their existing relationship with the email provider when authenticating at other sites.</p> - -<p>However, email providers won't become IdPs until there is significant demand from their users. In the meantime, Mozilla operates a fallback IdP at <a href="https://login.persona.org" rel="freelink">https://login.persona.org</a>. This fallback allows users to sign into sites with their existing email address, regardless of whether or not the email provider supports Persona. The fallback IdP will certify email addresses from any domain using its own authentication flow and its own password, so long as the user is able to prove control of an address by clicking a link in a verification email.</p> - -<p>Once an email provider supports Persona natively, its users will transparently begin use it instead of the fallback IdP.</p> - -<h2 id="Cross-browser_API_Library">Cross-browser API Library</h2> - -<p>For Persona to work, the user's browser must support the <a href="/en/DOM/navigator.id" title="navigator.id">navigator.id</a> API. Eventually, browsers will add native support for these APIs, but until then a <a href="/en-US/docs/persona/Browser_compatibility" title="/en-US/docs/persona/Browser_compatibility">cross-browser </a>implementation is available at <a href="https://login.persona.org/include.js" title="https://login.persona.org/include.js">https://login.persona.org/include.js</a>. By including this file, web sites can already begin using Persona. Once native implementations of the API are available, the library will automatically defer to those.</p> - -<h2 id="Remote_verification_service">Remote verification service</h2> - -<p>At <a href="https://login.persona.org" rel="freelink">https://login.persona.org</a> Mozilla hosts a <a href="/en/Persona/Remote_Verification_API" title="en/BrowserID/Remote_Verification_API">remote verification service</a> that web sites can use to verify identity assertions sent from users. This makes it simpler for web sites to support Persona as it takes care of parsing the assertion and cryptographically verifying user identities.</p> - -<p>Once the Persona data formats stabilize, verification will most likely be done locally on each site's server. This transition is especially important for user privacy, since it will make it impossible for the fallback IdP to track its users. Even with remote verification, users of native IdPs can't be tracked by that IdP.</p> diff --git a/files/fr/archive/mozilla/persona/branding/index.html b/files/fr/archive/mozilla/persona/branding/index.html deleted file mode 100644 index 6baff2ccdc..0000000000 --- a/files/fr/archive/mozilla/persona/branding/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Ressources promotionnelles -slug: Archive/Mozilla/Persona/branding -tags: - - Persona -translation_of: Archive/Mozilla/Persona/User_interface_guidelines ---- -<h2 id="Se_connecter_avec_des_boutons_Persona">Se connecter avec des boutons Persona</h2> -<h3 id="Images">Images</h3> -<p>Le bouton "Se connecter" est disponible en trois versions et trois couleurs:</p> -<table> - <thead> - <tr> - <th scope="row"> </th> - <th scope="col">Se connecter avec votre Email</th> - <th scope="col">Se connecter avec Persona</th> - <th scope="col">Se connecter</th> - </tr> - </thead> - <tbody> - <tr> - <th scope="row">Noir</th> - <td><img alt="" src="/files/3955/email_sign_in_black.png" style="width: 202px; height: 25px;"></td> - <td><img alt="" src="/files/3961/persona_sign_in_black.png" style="width: 185px; height: 25px;"></td> - <td><img alt="" src="/files/3967/plain_sign_in_black.png" style="width: 95px; height: 25px;"></td> - </tr> - <tr> - <th scope="row">Bleu</th> - <td><img alt="" src="/files/3957/email_sign_in_blue.png" style="width: 202px; height: 25px;"></td> - <td><img alt="" src="/files/3963/persona_sign_in_blue.png" style="width: 185px; height: 25px;"></td> - <td><img alt="" src="/files/3969/plain_sign_in_blue.png" style="width: 95px; height: 25px;"></td> - </tr> - <tr> - <th scope="row">Rouge</th> - <td><img alt="" src="/files/3959/email_sign_in_red.png" style="width: 202px; height: 25px;"></td> - <td><img alt="" src="/files/3965/persona_sign_in_red.png" style="width: 185px; height: 25px;"></td> - <td><img alt="" src="/files/3971/plain_sign_in_red.png" style="width: 95px; height: 25px;"></td> - </tr> - </tbody> -</table> -<h3 id="En_CSS">En CSS</h3> -<p><a href="http://sawyerhollenshead.com/" title="http://sawyerhollenshead.com/">Sawyer Hollenshead</a> a créé une série d'excellents boutons en CSS. <a href="/files/3973/persona-css-buttons.zip" title="/files/3973/persona-css-buttons.zip">Télécharger (.zip)</a></p> -<h2 id="Informations_complémentaires">Informations complémentaires</h2> -<p>Vous pouvez obtenir des informations complémentaires sur la conception visuelle de Persona dans <a href="http://people.mozilla.org/~smartell/persona/" title="http://people.mozilla.org/~smartell/persona/">les embelissement du style de Sean Martell</a>.</p> diff --git a/files/fr/archive/mozilla/persona/browser_compatibility/index.html b/files/fr/archive/mozilla/persona/browser_compatibility/index.html deleted file mode 100644 index 1bdf4c4e5d..0000000000 --- a/files/fr/archive/mozilla/persona/browser_compatibility/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Compatibilité des navigateurs -slug: Archive/Mozilla/Persona/Browser_compatibility -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Browser_compatibility ---- -<h2 id="Navigateurs_supportés">Navigateurs supportés</h2> -<p>Persona est développé, testé, et supporté avec les navigateurs suivants. Grâce à la bibliothèque JavaScript inter-plateformes de Persona, les utilisateurs n'ont pas besoin de greffons pour utiliser Persona.</p> -<table> - <tbody> - <tr> - <th colspan="3" style="text-align: center; background-color: #d3d7cf;" scope="row"><strong>Navigateurs pour ordinateur de bureau</strong></th> - </tr> - <tr> - <th scope="row"><strong>Internet Explorer</strong></th> - <td colspan="2" style="background-color: #8ae234;" rowspan="1">8.0<sup>*</sup>, 9.0<sup>†</sup>, 10.0** (mais voir le <a href="#Mode_de_compatibilit.C3.A9_d'Internet_Explorer">mode de compatibilité</a> ci-dessous)</td> - </tr> - <tr> - <th scope="row"><strong>Firefox</strong></th> - <td colspan="2" style="background-color: #8ae234;">Versions courante, stable, Beta, Aurora, Nightly, et ESR.<br> - Précédente version stable</td> - </tr> - <tr> - <th scope="row"><strong>Chrome</strong></th> - <td colspan="2" style="background-color: #8ae234;">Dernière version stable</td> - </tr> - <tr> - <th scope="row"><strong>Safari</strong></th> - <td colspan="2" style="background-color: #8ae234;">Dernière version stable</td> - </tr> - <tr> - <th scope="row"><strong>Opera</strong></th> - <td colspan="2" style="background-color: #8ae234;">Dernière version stable<sup>‡</sup></td> - </tr> - <tr> - <th colspan="3" style="text-align: center; background-color: #d3d7cf;" scope="row"><strong>Navigateurs iOS</strong></th> - </tr> - <tr> - <th scope="row"><strong>Safari</strong> Mobile</th> - <td colspan="2" style="background-color: #8ae234;" rowspan="1">iOS 5.x — 6.x</td> - </tr> - <tr> - <th colspan="3" style="text-align: center; background-color: #d3d7cf;" scope="row"><strong>Navigateurs Android</strong></th> - </tr> - <tr> - <th scope="row"><strong>Navigateur par défaut</strong></th> - <td colspan="2" style="background-color: #8ae234;" rowspan="1">2.x — 4.x</td> - </tr> - <tr> - <th scope="row"><strong>Firefox</strong></th> - <td colspan="2" style="background-color: #8ae234;">Versions stable courante, Beta, Aurora, et Nightly<br> - Précédente version stable</td> - </tr> - <tr> - <th scope="row"><strong>Chrome</strong></th> - <td colspan="2" style="background-color: #8ae234;">Dernière version stable</td> - </tr> - </tbody> -</table> -<p><sup>*</sup> : pour Windows XP. <sup>†</sup> : pour Windows Vista et Windows 7. ** : Windows 8. <sup>‡</sup> : selon durée de vie.</p> -<h2 id="Navigateurs_non_supportés">Navigateurs non supportés</h2> -<ul> - <li>Internet Explorer versions 6.0 et 7.0 non supportés. Les utilisateurs seront incités à mettre à jour leur navigateur.</li> - <li>Google Chrome Frame non supporté et ne fonctionne pas.</li> - <li>Les navigateurs tierces sur iOS ne sont pas supportés et ne fonctionnent pas. Le support pourra être ajouté par la suite (<a href="https://github.com/mozilla/browserid/issues/2034" title="https://github.com/mozilla/browserid/issues/2034">Issue #2034</a>).</li> -</ul> -<h2 id="Mode_de_compatibilité_d'Internet_Explorer">Mode de compatibilité d'Internet Explorer</h2> -<p>À partir de la version 8.0, Internet Explorer supporte une fonctionnalité appelée <em>Mode de compatibilité</em>, dans lequel le navigateur peut être amené à émuler une version antérieure à la 8.0, en affichant la page. Cette fonctionnalité peut être contrôlée de trois façons différentes :</p> -<ul> - <li>À travers un paramètre dans le navigateur ;</li> - <li>En se basant sur la présence et la valeur de la déclaration DOCTYPE de la page ;</li> - <li>À travers une instruction envoyée depuis le site, utilisant l'en-tête <code>X-UA-Compatible</code>, par un en-tête HTTP ou une balise <code><meta></code> dans la page. Cette méthode peut supplanter les deux autres.</li> -</ul> -<p>Parce que les versions Internet Explorer avant la 8.0 ne sont pas supportées par Persona, toute version d'Internet Explorer qui est configurée pour émuler une version antérieure à la 8.0, ne fonctionnera pas avec Persona.</p> -<h2 id="Autres_navigateurs">Autres navigateurs</h2> -<p>Bien qu'ils ne soient pas explicitement supportés, un navigateur incluant aussi bien <a href="/fr/docs/Web/API/Window/postMessage" title="La méthode window.postMessage permet une communication inter-domaine en toute sécurité. Normalement, les scripts de différentes pages sont autorisés à accéder les uns aux autres si et seulement si les pages depuis lesquelles ils sont exécutés ont des URL de même origine, c'est-à-dire avec le même protocole (généralement http ou https), le même numéro de port (80 étant le port par défaut pour http), et le même nom d'hôte (à condition que document.domain soit initialisé à la même valeur par les deux pages). window.postMessage fournit un mécanisme contrôlé pour contourner cette restriction d'une manière sécurisée si bien utilisée."><code>window.postMessage()</code></a> que <a href="/fr/docs/Web/API/Storage" title="L'interface Storage de l'API Web Storage donne accès au stockage de session (SessionStorage) ou au stockage local (LocalStorage) pour un domaine donné, vous permettant par exemple d'ajouter, de modifier ou de supprimer des éléments enregistrés."><code>localStorage</code></a> devrait fonctionner. Ces API ont été rendues disponibles dans les principaux navigateurs depuis mars 2010.</p> -<h2 id="Problèmes_connus">Problèmes connus</h2> -<ul> - <li>Les utilisateurs d'Android 2.x qui n'ont pas sélectionné de navigateur par défaut ne pourront pas se connecter (<a href="https://github.com/mozilla/browserid/issues/1854" title="https://github.com/mozilla/browserid/issues/1854">Issue #1854</a>) ;</li> - <li>Les navigateurs doivent accepter les cookies tiers pour bénéficier de toutes les fonctionnalités (<a href="https://github.com/mozilla/browserid/issues/1352" title="https://github.com/mozilla/browserid/issues/1352">Issue #1352</a>).</li> -</ul> diff --git a/files/fr/archive/mozilla/persona/considerations_de_securite/index.html b/files/fr/archive/mozilla/persona/considerations_de_securite/index.html deleted file mode 100644 index d067791639..0000000000 --- a/files/fr/archive/mozilla/persona/considerations_de_securite/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Considérations de sécurité -slug: Archive/Mozilla/Persona/Considerations_de_securite -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Security_Considerations ---- -<p>Lorsque vous ajoutez Persona sur votre site, il s'occupe du fardeau que représente la sécurité tant qu'il le peut. Cependant, certains aspects de la sécurité peuvent uniquement être gérés par votre site. Ils sont listés ci-dessous.</p> -<h2 id="Essential_practices" name="Essential_practices">Pratiques essentielles</h2> -<h3 id="Verify_assertions_on_your_server" name="Verify_assertions_on_your_server">Vérifier les assertions côté serveur</h3> -<p>Lorsque vous utilisez Persona, les assertions d'identité sont passées à la fonction <code> onlogin</code> passée à <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>. Vous devriez <em>toujours</em> envoyer l'assertion au serveur pour vérification, et seul votre serveur devrait décider de donner à l'utilisateur les permissions additionnelles selon le résultat de la vérification:</p> -<pre class="brush:js;">// Dans navigator.id.watch({ ... -onlogin: function(assertion) { - // Un utilisateur veut se connecter ! Vous devez: - // 1. Envoyer l'assertion à votre backend pour vérification et création d'une session. - // 2. Mettre à jour l'interface. -}, -</pre> -<p>Si vous essayez de vérifier l'assertion en utilisant le JavaScript client, un utilisateur malveillant pourrait usurper l'identité d'un utilisateur légitime en injectant localement du code et en modifiant votre JavaScript. Ceci est possible parce que vous n'êtes pas en contrôle total de ce qui se passe dans le navigateur de l'utilisateur, là où le JavaScript est exécuté.</p> -<p>Encore une fois, vous devriez <em>systématiquement</em> envoyer l'assertion au serveur pour vérification. Même si vous utilisez l'API de vérification locale.</p> -<h3 id="Explicitly_specify_the_audience_parameter" name="Explicitly_specify_the_audience_parameter">Spécifiez explicitement le paramètre audience</h3> -<p>Pour vérifier une assertion, vous pouvez envoyer une requête POST à l'adresse <code>https://verifier.login.persona.org/verify</code>. La requêtre inclut un paramètre appelé <code>audience :</code></p> -<pre><code>assertion=<ASSERTION>&audience=https://monsite.com:443"</code></pre> -<p>Le paramètre <code>audience</code> est requis. Vous devriez toujours spécifier l'audience explicitement dans votre code, où dans votre configuration. Attention à :</p> -<ul> - <li>Ne pas croire le header Host envoyé par le navigateur.</li> - <li>Ne pas croire un paramètre explicite envoyé par le navigateur, mais généré par votre JavaScript en utilisant par exemple <code>document.location</code>.</li> -</ul> -<p>Si vous faites confiance au navigateur pour vous fournir l'audience, alors il devient possible pour un site malveillant de réutiliser les assertions de <em>son</em> site pour se connecter sur <em>votre</em> site.</p> -<h3 id="Verify_SSL_certificates" name="Verify_SSL_certificates">Vérifier les certificats SSL</h3> -<p>Pour vérifier une assertion, vous pouvez envoyer une requête POST à l'adresse <code>https://verifier.login.persona.org/verify</code>. Vous devez vous assurer que la requête HTTPS vérifie le certificat envoyé par le serveur contre un certificat-racine sûr. Si vous ne le faites pas, alors un hacker pourrait se faire passer pour <code>verifier.login.persona.org</code> et renvoyer des vérifications erronées.</p> -<p>Vérifiez que la librairie utilisée vérifie les certicicats correctements, et que vous l'intialisez avec les certificats-racines appropriés.</p> -<p><span style="line-height: 1.572;">Par exemple, le module standard de Python 2.7 ne valide pas les certificats serveurs. Nous recommandons plutôt d'utiliser les modules "</span><a class="external" href="http://pypi.python.org/pypi/requests" style="line-height: 1.572;">requests</a><span style="line-height: 1.572;">" (en) ou "</span><a class="external" href="http://pypi.python.org/pypi/urllib3" style="line-height: 1.572;" title="http://pypi.python.org/pypi/urllib3">urllib3</a><span style="line-height: 1.572;">" (en) en Python 2.x, ou la classe standard <code>http.client.HTTPSConnection</code></span> en Python 3.x<span style="line-height: 1.572;">. En Perl, assurez-vous d'utiliser au moins la version 6.0 de <code>libwww-perl</code></span>. En fonction du langage, de la bibliothèque et du système d'exploitation utilisé, vous pourriez devoir fournir soit une liste de certificats-racines sûrs, soit le seul certificat utilisé par <code>verifier.login.persona.org</code>.</p> -<h3 id="Implement_CSRF_protection" name="Implement_CSRF_protection">Implémenter une protection CSRF</h3> -<p>Lors d'une attaque de connexion CSRF (Cross-Site Request Forgery, contrefaçon de requêtes trans-sites), un hacker utilise une contrefaçon de requête trans-site pour connecter un utilisateur sur un site en utilisant ses identifiants.</p> -<p>Par exemple : un utilisateur visite un site web malveillant contenant un élément <code>form</code>. L'attribut <font face="Courier New, Andale Mono, monospace"><span style="line-height: normal;">action</span></font> du formulaire est défini sur une requête HTTP POST pointant vers <a class="external" href="http://www.google.com/login" title="http://www.google.com/login">http://www.google.com/login</a>, en envoyant le nom d'utilisateur et le mot de passe du hacker. Lorsque l'utilisateur envoie le formulaire, sa requête est envoyée à Google, la connexion est faite avec succès et le serveur Google définit un cookie dans le navigateur de l'utilisateur. À présent, l'utilisateur est sans le savoir connecté sur le compte Google du hacker.</p> -<p>Cette attaque peut être utilisée pour récupérer des informations sensibles à propos de l'utilisateur. Par exemple, la fonctionnalité d'<a class="link-https" href="https://www.google.com/history/">Historique Web</a> de Google recense tous les mots-clefs de recherche de l'utilisateur. Si l'utilisateur est connecté sur le compte Google du hacker ayant la fonctionnalité d'Historique Web activée, alors l'utilisateur donne toutes ses informations au hacker.</p> -<p>Les attaques de connexion CSRF, et les défenses potentielles à mettre en place contre elles, sont documentées plus exhaustivement dans <a class="external" href="http://www.adambarth.com/papers/2008/barth-jackson-mitchell-b.pdf">Défenses robustes contre les contrefaçons de requêtes trans-sites</a> (PDF, en). Elles ne sont pas spécifiques à Persona : la plupart des mécanismes de connexion sont potentiellement vulnérables face à elles.</p> -<p>Il y a plusieurs techniques qui peuvent être utilisées pour protéger un site contre les attaques de connexion CSRF, qui sont documentées plus exhaustivement dans l'étude ci-dessus.</p> -<p>Une de ces approches est de créer un identifiant secret dans le serveur, partagé avec le navigateur et de demander au navigateur de le fournir lors de requêtes de connexions. Par exemple :</p> -<ol> - <li>Dès que l'utilisateur arrive sur votre site, avant qu'il n'essaie de se connecter, créez une session pour lui sur le serveur. Enregistrez l'ID de la session dans un cookie de navigateur.</li> - <li>Sur le serveur, générez une chaîne de caractères aléatoire d'au moins 10 caractères alphanumériques. Un UUID généré aléatoirement est une bonne solution. C'est le jeton CSRF. Enregistrez-le dans la session.</li> - <li>Donnez le jeton CSRF au navigateur en l'incluant dans du JavaScript ou dans le HTML en tant que variable de formulaire cachée.</li> - <li>Assurez-vous que les envois AJAX ou les requêtes POST de formulaires incluent le jeton CSRF.</li> - <li>Côté serveur, avant d'accepter une assertion, assurez-vous que le jeton CSRF envoyé correspond au jeton CSRF enregistré dans la session.</li> -</ol> -<h2 id="Enhancements" name="Enhancements">Améliorations</h2> -<h3 id="Content_Security_Policy_(CSP)" name="Content_Security_Policy_(CSP)">Politique de sécurité du contenu (CSP)</h3> -<p>La <a href="/fr/docs/Sécurité/CSP" title="Security/CSP">Politique de sécurité du contenu</a> (CSP) est une couche supplémentaire de sécurité qui aide à détecter et atténuer certains types d'attaques, dont le Scriptage Trans-sites (XSS) et les attaques d'injection de données. Ces attaques sont utilisées pour beaucoup de choses du vol de données à la dégradation du site ou la distribution de logiciels malveillants.</p> -<p>Si vous utilisez la CSP sur votre site, vous devriez modifier votre politique pour inclure Persona. En fonction de votre politique, vous pourriez avoir besoin de :</p> -<ul> - <li>Supprimer les URI <font face="Courier New, Andale Mono, monospace"><span style="line-height: normal;">javascript:</span></font> les remplacer par du code chargé depuis un fichier de script additionnel. Ce fichier peut parcourir les éléments d'après leur ID et attacher des événements aux éléments en modifiant la propriété <a href="/fr/docs/Web/API/Element/onclick" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>onclick</code></a> ou en apppelant <a href="/fr/docs/Web/API/Element/addEventListener" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>addEventListener()</code></a>.</li> - <li>Autoriser <code>https://login.persona.org</code> aussi bien en tant que <code>script-src</code> qu'en tant que <code>frame-src</code> afin que votre site puisse charger le fichier <code>include.js</code> local et que ce fichier puisse communiquer avec l'implémentation alternative de Persona.</li> -</ul> -<p>Une configuration Apache d'example pourrait inclure :</p> -<pre><span class="diff-content"><span class="idiff">Header set X-Content-Security-Policy: "default-src 'self'; frame-src 'self' https://login.persona.org ; script-src 'self' https://login.persona.org"</span></span></pre> diff --git a/files/fr/archive/mozilla/persona/identity_provider_overview/index.html b/files/fr/archive/mozilla/persona/identity_provider_overview/index.html deleted file mode 100644 index 6a29be7c8f..0000000000 --- a/files/fr/archive/mozilla/persona/identity_provider_overview/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Identity Provider Overview -slug: Archive/Mozilla/Persona/Identity_Provider_Overview -translation_of: Archive/Mozilla/Persona/Identity_Provider_Overview ---- -<p>Un Fournisseur d'Identité (Identity Provider ou IdP) Persona est un domaine qui enregistre et certifie directement l'identité de ses utilisateurs. Parce que les identités de Persona sont basées sur les adresses email, tous domaine offrant des emails à leurs utilisateurs peut simplement devenir un IdP.</p> - -<p>Si vous avez un nom de domaine, vous pouvez devenir un IdP Persona en implémentant un support pour le protocole BrowserID.</p> - -<p><em>If you have a domain name, you can become a Persona IdP by implementing support for the underlying BrowserID protocol.</em></p> - -<h2 id="Le_document_support_IdP">Le document support IdP</h2> - -<p>Domains advertise their ability to act as IdPs by publishing a support document at <code>/.well-known/browserid</code>. This JSON-formatted document contains three values:</p> - -<ul> - <li><code>public-key</code>: The public part of the domain's cryptographic key.</li> - <li><code>authentication</code>: The domain's page for asking users to log in.</li> - <li><code>provisioning</code>: The domain's page for certifying its users' identities.</li> -</ul> - -<p>Websites use the <code>public-key</code> to verify the authenticity of users' identity assertions.</p> - -<p>Browsers use the <code>authentication</code> and <code>provisioning</code> values to obtain certification of their user's identity.</p> - -<p>For more information, including how domains can delegate to other IdPs, see the <a href="https://developer.mozilla.org/en-US/docs/Persona/.well-known-browserid" title="https://developer.mozilla.org/en-US/docs/BrowserID/.well-known-browserid"><code>/.well-known/browserid</code> documentation</a>.</p> - -<h2 id="Comment_le_navigateur_interagit-t-il_avec_les_IdPs">Comment le navigateur interagit-t-il avec les IdPs ?</h2> - -<p>Pour montrer l'interaction entre les Navigateurs et les IdPs, nous allons regarder ce qui doit se passer la première fois que <code>alice@example.com</code> essaie de se connecter à un site en utilisant Persona.</p> - -<ol> - <li>Le navigateur d'alice récupère le document support à l'url <code>https://example.com/.well-known/browserid</code>.</li> - <li>Alice's browser invisibly loads the <code>provisioning</code> page for <code>example.com</code> and asks it to sign a public key certifying Alice's identity.</li> - <li>Before signing the key, <code>example.com</code> needs proof that the user really is Alice, so it tells the browser that she needs to authenticate.</li> - <li>Alice's browser shows Alice the <code>authentication</code> page for <code>example.com</code> and she signs in, establishing a new session at <code>example.com</code>.</li> - <li>Alice's browser reloads the <code>provisioning</code> page and again asks it to sign a public key certifying Alice's identity.</li> - <li>The <code>provisioning</code> page can verify Alice's identity by inspecting the new session. Satisfied, it signs a certificate containing Alice's public key, her email address, and an expiration date for the certificate.</li> -</ol> - -<p>For the duration of the signed certificate, Alice's browser can create valid identity assertions for <code>alice@example.com</code> whenever she wants to log into a web site with Persona.</p> - -<p>Steps 3-5 can be skipped if Alice already has a valid session with <code>example.com</code>, for example, from logging into her webmail or an intranet portal.</p> - -<h2 id="Comment_les_Sites_Web_interagissent_avec_les_IdPs">Comment les Sites Web interagissent avec les IdPs ?</h2> - -<p>Let's say Alice wants to sign in to <a href="http://123done.org" title="http://123done.org">123done.org</a>. Her browser would generate and sign an identity assertion containing the certificate from above and present it as proof of her identity.</p> - -<p>By comparing Alice's signature on the identity assertion with the public key inside the signed certificate, 123done can be confident that the certificate was issued to the same person that generated the identity assertion. However, 123done still needs to check that the certificate itself is valid by examining its signature.</p> - -<p>Because the certificate was issued for <code>alice@example.com</code>, 123done fetches the support document from <code>https://example.com/.well-known/browserid</code>. It then extracts the <code>public-key</code> and compares that to the signature on Alice's certificate. If the key matches the signature, 123done knows that the certificate is legitimate and can finish logging Alice in.</p> - -<p>Note that 123done never "phoned home" or otherwise revealed Alice's identity when she logged in. Rather, it only needed to request a single, cacheable document from <code>example.com</code>.</p> - -<h2 id="Security_and_trust">Security and trust</h2> - -<p>The BrowserID protocol, and thus Persona, are built on standard public key crytography techniques.</p> - -<p>Feel free to explore our documentation on the <a href="/en/Persona/Crypto" title="https://developer.mozilla.org/en/Persona/Crypto">cryptographic concepts</a> behind how a Persona IdP works or read <a href="/en-US/docs/Persona/Implementing_a_Persona_IdP" title="/en-US/docs/Persona/Implementing_a_Persona_IdP">more detail on how IdPs are implemented</a>.</p> diff --git a/files/fr/archive/mozilla/persona/index.html b/files/fr/archive/mozilla/persona/index.html deleted file mode 100644 index 160cdb0e3a..0000000000 --- a/files/fr/archive/mozilla/persona/index.html +++ /dev/null @@ -1,195 +0,0 @@ ---- -title: Persona -slug: Archive/Mozilla/Persona -tags: - - Persona -translation_of: Archive/Mozilla/Persona ---- -<div class="summary">Un système de connexion simple et respectueux de la vie privée : laissez vos utilisateurs s'identifier avec leurs adresses e-mail, et libérez-vous de la gestion des mots de passe.</div> - -<p><span class="seoSummary"><a class="link-https" href="https://login.persona.org">Mozilla Persona</a> est un système d'identification pour le web facile à utiliser et à déployer. Il fonctionne sur <a href="/fr/docs/persona/Browser_compatibility">tous les principaux navigateurs</a>, vous pouvez l'<a href="/fr/Persona/Quick_Setup">utiliser dès maintenant</a>.</span></p> - -<p>Pourquoi utiliser Persona sur votre site web ?</p> - -<ol> - <li><strong>Persona élimine complètement les mots de passe spécifiques à un site web</strong>, libérant les utilisateurs et les sites web du fardeau de créer, gérer et sauvegarder de manière sécurisée les mots de passe.</li> - <li><strong>Persona est facile à utiliser.</strong> En deux clics seulement, un utilisateur de Persona peut se connecter sur un site web comme <a href="http://voo.st" title="http://voo.st">Voost</a>, en s'affranchissant des contraintes liées à la création d'un nouveau compte.</li> - <li><strong>Persona est facile à mettre en oeuvre</strong><strong>. </strong>Les développeurs peuvent ajouter Persona à leur site web en seulement un après-midi.</li> - <li>Bien mieux, il n'y a <strong>pas de contrainte</strong>. Les développeurs recoivent une adresse e-mail vérifiée pour chacun de leurs utilisateurs, et l'utilisateur peut utiliser n'importe quelle adresse e-mail avec Persona.</li> -</ol> - -<p>De plus, Persona ne peut que s'améliorer : il est constuit sur un <strong>protocole ouvert et décentralisé</strong>, qui a été conçu pour permettre une i<strong>ntégration direct aux navigateurs</strong> et un <strong>support natif par les fournisseurs d'e-mail</strong>. Les sites qui implémentent Persona aujourd'hui profiteront automatiquement de ces améliorations sans avoir à modifier leur code.</p> - -<hr> -<div class="column-container"> -<h2 id="Utiliser_Persona_sur_votre_site">Utiliser Persona sur votre site</h2> - - -<div class="column-third"> -<h3 id="Pour_commencer">Pour commencer</h3> - -<dl> - <dt><a href="/fr/Persona/Pourquoi_Persona">Pourquoi Persona ?</a></dt> - <dd>Qu'est ce qui rend Persona spécial comparé aux autres systèmes d'identification et authentification.</dd> - <dt><a href="/fr/Persona/Quick_Setup">Configuration rapide</a></dt> - <dd>Une rapide introduction montrant comment ajouter Persona à votre site web.</dd> -</dl> - -<h3 id="Référence_de_l'API">Référence de l'API</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/navigator.id">L'API navigator.id </a></dt> - <dd>Référence pour l'objet <code>navigator.id</code>.</dd> - <dt><a href="/fr/Persona/API_de_verification">L'API de vérification</a></dt> - <dd>Référence pour l'API de vérification.</dd> -</dl> -</div> - -<div class="column-third"> -<h3 id="Guides">Guides</h3> - -<dl> - <dt><a href="/fr/Persona/Considerations_de_securite">Considérations de sécurité</a></dt> - <dd>Pratiques et techniques pour déployer votre Persona en toute sécurité.</dd> - <dt><a href="/fr/docs/persona/Browser_compatibility">Compatibilité des navigateurs</a></dt> - <dd>Découvrez quels navigateurs sont supportés par Persona.</dd> - <dt><a href="/fr/Persona/Internationalisation">Internationalisation</a></dt> - <dd>Découvrez comment Persona supporte différents langages.</dd> - <dt><a href="/fr/Persona/The_implementor_s_guide">Le guide de l'implémenteur</a></dt> - <dd>Des astuces par les sites qui ont ajouté le support de Persona.</dd> -</dl> -</div> - -<div class="column-third"> -<h3 id="Ressources">Ressources</h3> - -<dl> - <dt><a class="link-https" href="/fr/Persona/Libraries_and_plugins" title="https://developer.mozilla.org/en-US/docs/Mozilla/Persona/Libraries_and_plugins">Librairies et plugins</a></dt> - <dd>Vous trouverez une drop-in librairie pour votre langage de programmation favori, web framework, blog, ou CMS.</dd> - <dt><a class="link-https" href="https://github.com/mozilla/browserid-cookbook" title="https://github.com/mozilla/browserid-cookbook">Le livre d'astuces Personna</a></dt> - <dd>Exemples de codes sources pour les sites Persona. Avec des extraits en C# (MVC3), PHP, Node.JS, et autres.</dd> - <dt><a href="/fr/docs/persona/branding" title="/en-US/docs/persona/branding">Ressources promotionnelles</a></dt> - <dd>Boutons <em>se connecter</em> et autres éléments graphiques pour aider à présenter Persona à vos utilisateurs.</dd> -</dl> -</div> -</div> - -<hr> -<h2 id="Devenir_un_fournisseur_d'identité">Devenir un fournisseur d'identité</h2> - -<p>Si vous êtes un fournisseur d'adresses de messagerie ou d'un autre service d'identification, voyez les liens ci-dessous pour apprendre comment devenir un fournisseur d'identité Persona.</p> - -<div class="column-container"> -<div class="column-third"> -<dl> - <dt><a href="/en-US/docs/Persona/Identity_Provider_Overview">IdP : vue d'ensemble</a></dt> - <dd>Une vue haut niveau des fournisseurs d'identité de Persona.</dd> -</dl> -</div> - -<div class="column-third"> -<dl> - <dt><a href="/en/Persona/Implementing_a_Persona_IdP">Implémenter un IdP</a></dt> - <dd>Un guide précis sur les détails techniques pour devenir un IdP.</dd> -</dl> -</div> - -<div class="column-third"> -<dl> - <dt><a href="/en-US/docs/Persona/.well-known-browserid">.well-known/browserid</a></dt> - <dd>Un aperçu de la structure et de l'objet du fichier <code>.well-known/browserid</code> que les IdPs utilisent pour signaler leur utilisation du protocole.</dd> -</dl> -</div> -</div> - -<hr> -<h2 id="Le_projet_Persona">Le projet Persona</h2> - -<div class="column-container"> -<div class="column-third"> -<dl> - <dt><a href="/en/Persona/Glossary" title="navigator.id">Glossaire</a></dt> - <dd>Définitions de la terminologie utilisée par BrowserID et Persona.</dd> - <dt><a href="/en/Persona/FAQ" title="en/BrowserID/FAQ">FAQ</a></dt> - <dd>Réponses aux questions fréquentes.</dd> - <dt><a href="/fr/Persona/vue_densemble_du_protocole" title="BrowserID/Protocol overview">Protocole : vue d'ensemble</a></dt> - <dd>Un aperçu de niveau technique intermédiaire du protocole sous-jacent BrowserID.</dd> -</dl> -</div> - -<div class="column-third"> -<dl> - <dt><a href="/en/persona/Crypto" title="MDN">Crypto</a></dt> - <dd>Un aperçu des concepts cryptographiques derrière Persona et BrowserID.</dd> - <dt><a class="link-https" href="https://github.com/mozilla/id-specs/blob/master/browserid/index.md" title="https://github.com/mozilla/id-specs/blob/master/browserid/index.md">Les Spécifications</a></dt> - <dd>Détails techniques approfondis.</dd> -</dl> -</div> - -<div class="column-third"> -<dl> - <dt><a href="/Persona/Bootstrapping_Persona" title="en/BrowserID/Bootstrapping_BrowserID">Le site web de Persona</a></dt> - <dd>Pour faire fonctionner Persona, nous hébergeons trois services sur <a class="link-https" href="https://login.persona.org" rel="freelink">https://login.persona.org</a>: un fournisseur d'identité de substitution, une implémentation portable des APIs <a href="/fr/docs/Web/API/Navigator/id" title="Le protocole BrowserID définit une nouvelle propriété id dans l'objet window.navigator, dans laquelle l'API BrowserID est rendue disponible. Cette API a subi plusieurs importantes modifications. Chaque modification est listée séparément ci-dessous."><code>navigator.id</code></a> et un service de vérification des affirmations d'identité.</dd> - <dt><a href="https://github.com/mozilla/browserid">Code source de Persona </a></dt> - <dd>Le code source de Persona pour les sites web est sur un dépot sur GitHub. Patches bienvenus !</dd> -</dl> -</div> -</div> - -<p></p><div class="overheadIndicator communitybox"> - - <div class="column-container"> - <h2 id="Rejoignez_la_communauté_Identity">Rejoignez la communauté Identity</h2> - <div class="column-half"> - <div class="communitysubhead">Choisissez votre méthode préférée pour rejoindre la discussion :</div> - <ul class="communitymailinglist"> - <li><a href="https://lists.mozilla.org/listinfo/dev-identity"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.identity"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.identity/feeds"> Flux de syndication</a></li> -</ul> - </div> - <div class="column-half"> - <ul class="communitycontact"><li><strong>IRC: </strong><a href="irc://irc.mozilla.org/identity">#identity</a> <span class="smaller">(<a href="https://wiki.mozilla.org/IRC">en apprendre plus</a>)</span></li><li><strong>Blog: </strong><a href="http://identity.mozilla.com/" title="Visitez le blog Identity">identity.mozilla.com</a></li><li><strong>GitHub: </strong><a href="https://github.com/mozilla/browserid/issues/new" title="Signaler un bug">Signaler un bug</a></li></ul> - </div> - </div> -</div><p></p> - -<p> </p> - -<h2 id="Subnav">Subnav</h2> - -<ol> - <li><a href="#">Utiliser Persona sur votre site web</a> - - <ol> - <li><a href="/fr/Persona/Pourquoi_Persona" title="Why Persona?">Pourquoi utiliser Persona ?</a></li> - <li><a href="/fr/Persona/Quick_Setup" title="Quick Start">Configuration rapide</a></li> - <li><a href="/fr/Persona/The_implementor_s_guide" title="Implementor's Guide">Astuces pour implémenter Persona</a></li> - <li><a href="/fr/Persona/Considerations_de_securite" title="Security Considerations">Considérations de sécurité</a></li> - <li><a href="/fr/docs/persona/Browser_compatibility" title="Browser compatibility">Compatibilité navigateurs</a></li> - <li><a href="/fr/Persona/Internationalisation" title="Internationalization">Internationalisation</a></li> - <li><a href="/en-US/Persona/The_navigator.id_API" title="The navigator.id API">L'API navigator.id</a></li> - <li><a href="/fr/Persona/API_de_verification" title="Remote Verification API">L'API de vérification à distance</a></li> - <li><a href="/fr/Persona/Libraries_and_plugins" title="Libraries and plugins">Bibliothèques et plugins</a></li> - <li><a href="/fr/docs/persona/branding" title="User interface guidelines">Recommandations d'interface Utilisateur</a></li> - </ol> - </li> - <li><a href="#">Devenir un fournisseur d'identité</a> - <ol> - <li><a href="/en-US/Persona/Identity_Provider_Overview" title="IdP Overview">Vue d'ensemble IdP</a></li> - <li><a href="/en-US/Persona/Implementing_a_Persona_IdP" title="Implementing an IdP">Implémenter un IdP</a></li> - <li><a href="/en-US/Persona/.well-known-browserid" title=".well-known-browserid format">Format de .well-known-browserid</a></li> - </ol> - </li> - <li><a href="#">Le projet Persona</a> - <ol> - <li><a href="/en-US/Persona/Glossary" title="Glossary">Glossaire</a></li> - <li><a href="/en-US/Persona/FAQ" title="FAQ">FAQ</a></li> - <li><a href="/en-US/Persona/Bootstrapping_Persona" title="Persona hosted services">Services hébergés Persona</a></li> - <li><a href="/fr/Persona/vue_densemble_du_protocole" title="Protocol overview">Vue d'ensemble du protocole</a></li> - <li><a href="/en-US/Persona/Crypto" title="Crypto">Cryptographie</a></li> - </ol> - </li> -</ol> diff --git a/files/fr/archive/mozilla/persona/internationalisation/index.html b/files/fr/archive/mozilla/persona/internationalisation/index.html deleted file mode 100644 index 0989a4d086..0000000000 --- a/files/fr/archive/mozilla/persona/internationalisation/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Internationalisation -slug: Archive/Mozilla/Persona/Internationalisation -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Internationalization ---- -<h2 id="Qu'est-ce_qui_est_traduit_dans_Persona">Qu'est-ce qui est traduit dans Persona ?</h2> -<p>Dans le futur, l'interface pour se connecter sur des sites avec Persona sera intégrée directement dans le navigateur, et ainsi traduite avec la traduction du navigateur. Pour les navigateurs qui n'intégrent pas Persona, son interface consiste en une série de dialogues affichées depuis <a style="line-height: 1.572;" href="https://login.persona.org" title="https://login.persona.org">login.persona.org</a><span style="line-height: 1.572;">. Ces dialogues sont traduits par une équipe de volontaires de la communauté, et plus de 45 langues sont actuellement </span><a style="line-height: 1.572;" href="https://github.com/mozilla/browserid/blob/dev/config/l10n-prod.json" title="https://github.com/mozilla/browserid/blob/dev/config/l10n-prod.json">activées en production</a><span style="line-height: 1.572;">.</span></p> -<h2 id="Comment_Persona_choisit_la_langue">Comment Persona choisit la langue</h2> -<p>Le service Persona sélectionne une langue en se basant sur le header <code>Accept-Language</code> envoyé dans les requêtes du navigateur. L'algorithme utilisé pour faire correspondre une langue au header <code>Accept-Language</code> est le même que celui utilisé par <code>mozilla.org</code> :</p> -<ol> - <li>Pour chaque identifiant de langue dans le header <code>Accept-Language</code> : - <ul> - <li>vérifier s'il existe une correspondance exacte pour la langue associée à l'identifiant de langue</li> - <li>vérifier s'il existe une correspondance partielle de la première partie de l'identifiant de langue avec une langue</li> - </ul> - </li> - <li>Si une correspondance ne peut pas être établie en utilisant la première règle, s'en remettre à en-US. Cependant, <em>en</em> ou <em>en-US</em> est presque toujours le dernier header de langue préférée envoyé par la plupart des navigateurs.</li> -</ol> -<p>Par exemple, le tableau ci-dessous liste la langue choisie pour différents headers <code>Accept-Language</code>, si les langues suivantes étaient supportées : <code>en-US, es, es-MX</code> :</p> -<table> - <thead> - <tr> - <th scope="col"><strong>Header <code>Accept-Language</code></strong></th> - <th scope="col"><strong>Langue sélectionnée</strong></th> - </tr> - </thead> - <tbody> - <tr> - <td><code>es-AR,es;q=0.8,en-us;q=0.5</code></td> - <td><code>es</code></td> - </tr> - <tr> - <td><code>es-MX,es;q=0.8,en-us;q=0.5</code></td> - <td><code>es-MX</code></td> - </tr> - <tr> - <td><code>e</code><code>s-es,en-us;q=0.5</code></td> - <td><code>en-US</code></td> - </tr> - <tr> - <td><code>e</code><code>s-es</code></td> - <td><code>en-US</code></td> - </tr> - </tbody> -</table> -<p>Il n'y a pour le moment pas de possibilité pour un site de forcer le dialogue d'être dans un langage prédéfini. C'est parce que l'interface de Persona est d'un point de vue logique (et tout comme les futures implémentations natives le seront) intégrée dans l'interface du navigateur, c'est pourquoi sa langue doit être cohérente avec la langue du navigateur.</p> -<h2 id="Comment_aider">Comment aider</h2> -<p>Persona utilise Mozilla Verbatim pour permettre aux volontaires de créer de nouvelles traductions. Si vous souhaitez aider, lisez le guide « <a href="https://developer.mozilla.org/en-US/docs/Localizing_with_Verbatim" title="https://developer.mozilla.org/en-US/docs/Localizing_with_Verbatim">démarrer avec Verbatim</a> (en) » et visitez le <a href="https://localize.mozilla.org/projects/browserid/" title="https://localize.mozilla.org/projects/browserid/">projet « BrowserID »</a> (en) sur Verbatim.</p> diff --git a/files/fr/archive/mozilla/persona/libraries_and_plugins/index.html b/files/fr/archive/mozilla/persona/libraries_and_plugins/index.html deleted file mode 100644 index 54d297c63b..0000000000 --- a/files/fr/archive/mozilla/persona/libraries_and_plugins/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Bibliothèques et plugins -slug: Archive/Mozilla/Persona/Libraries_and_plugins -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Libraries_and_plugins ---- -<p>Envie d'utiliser Persona sur votre site ou votre blog ? Implémenter Persona à partir de rien, c'est <a href="/fr/docs/Persona/Quick_Setup" title="/en-US/docs/Persona/Quick_Setup">simple</a>, mais les plugins et bibliothèques listées ici pourraient bien vous aider à aller plus vite !<br> - <br> - Cette page liste trois types de bibliothèques :<br> - <br> - 1. des <strong>p</strong><strong>lugins</strong> qui intégrent Persona dans des environnements de travail et systèmes de gestion de contenu (CMS) existants<br> - 2. des <strong>bibliothèques utilitaires</strong>, utiles lorsque vous développez de nouveaux plugins ou que vous intégrez Persona dans un site à partir de rien<br> - 3. <strong>n'importe quoi d'autre</strong> en rapport avec Persona, ce qui inclut des bibliothèques pour faire de votre domaine un Persona Identity Provider<br> - <br> - Ceci est une liste maintenue par la communauté. Si vous avez créé une bibliothèque ou un plugin, merci de l'ajouter à cette page.</p> - -<div class="note">Cette page est actuellement en cours de tri, et certains plugins pourraient être obsolètes. N'oubliez pas de faire des recherches sur les plugins avant de les utiliser.</div> - -<div class="warning"> -<p>Les liens vers les plugins listés ici sont des documents rédigés en anglais</p> -</div> - -<h2 id="Plugins">Plugins</h2> - -<h3 id="Clojure">Clojure</h3> - -<ul> - <li>Noir: <a href="https://github.com/tmarble/nongrata" title="https://github.com/tmarble/nongrata">https://github.com/tmarble/nongrata</a></li> - <li>ring / cemerick.friend / cljs: <a href="https://github.com/osbert/persona-kit" title="https://github.com/osbert/persona-kit">https://github.com/osbert/persona-kit</a></li> -</ul> - -<h3 id="Cold_Fusion">Cold Fusion</h3> - -<ul> - <li>CFML: <a href="https://github.com/gregmoser/cfpersona" title="https://github.com/gregmoser/cfpersona">https://github.com/gregmoser/cfpersona</a></li> -</ul> - -<h3 id="Haskell">Haskell</h3> - -<ul> - <li>Yesod: <a href="https://github.com/yesodweb/authenticate" title="https://github.com/yesodweb/authenticate">https://github.com/yesodweb/authenticate</a></li> -</ul> - -<h3 id="Java">Java</h3> - -<ul> - <li>Spring: <a href="https://github.com/webdetails/SpringSecurityBrowserID" title="https://github.com/webdetails/SpringSecurityBrowserID">https://github.com/webdetails/SpringSecurityBrowserID</a></li> - <li>Lutece: <a href="http://dev.lutece.paris.fr/plugins/module-mylutece-persona/" title="https://dev.lutece.paris.fr/plugins/module-mylutece-persona/">http://dev.lutece.paris.fr/plugins/module-mylutece-persona/</a></li> -</ul> - -<h3 id="JavaScript">JavaScript</h3> - -<ul> - <li>Mootools: <a href="http://mootools.net/forge/p/browserid" title="http://mootools.net/forge/p/browserid">http://mootools.net/forge/p/browserid</a></li> - <li>jQuery: <a href="https://github.com/altryne/browserID-jQuery" title="https://github.com/altryne/browserID-jQuery">https://github.com/altryne/browserID-jQuery</a></li> - <li>Meteor: <a href="https://github.com/vladikoff/meteor-accounts-persona" title="https://github.com/vladikoff/meteor-accounts-persona">https://github.com/vladikoff/meteor-accounts-persona</a></li> -</ul> - -<h3 id="Node.js">Node.js</h3> - -<ul> - <li>Express: <a href="https://github.com/jbuck/express-persona" title="https://github.com/jbuck/express-persona">https://github.com/jbuck/express-persona</a></li> - <li>Express / Jungles: <a href="https://npmjs.org/package/jungles-auth-persona" title="https://npmjs.org/package/jungles-auth-persona">https://npmjs.org/package/jungles-auth-persona</a></li> - <li>Passport: <a href="https://github.com/jaredhanson/passport-browserid" title="https://github.com/jaredhanson/passport-browserid">https://github.com/jaredhanson/passport-browserid</a></li> - <li>Express / connect - connect-auth: <a href="https://github.com/ciaranj/connect-auth" title="https://github.com/ciaranj/connect-auth">https://github.com/ciaranj/connect-auth</a></li> - <li>Persona + LevelDB session storage: <a href="https://github.com/maxogden/doorknob" title="/en-US/docs/">https://github.com/maxogden/doorknob</a></li> -</ul> - -<h3 id="PHP">PHP</h3> - -<ul> - <li>CakePHP: <a href="https://github.com/overflow636/ofbid" title="https://github.com/overflow636/ofbid">https://github.com/overflow636/ofbid</a> et <a href="https://github.com/markomarkovic/cakephp-plugin-persona" title="https://github.com/markomarkovic/cakephp-plugin-persona">https://github.com/markomarkovic/cakephp-plugin-persona</a></li> - <li>DokuWiki: <a href="https://github.com/Rudloff/dokuwiki-browserid" title="https://github.com/Rudloff/dokuwiki-browserid">https://github.com/Rudloff/dokuwiki-browserid</a></li> - <li>Dotclear: <a href="http://plugins.dotaddict.org/dc2/details/browserID" title="http://plugins.dotaddict.org/dc2/details/browserID">http://plugins.dotaddict.org/dc2/details/browserID</a></li> - <li>Drupal: <a href="https://drupal.org/project/persona" title="https://drupal.org/project/persona">https://drupal.org/project/persona</a></li> - <li>Elgg: <a href="http://community.elgg.org/plugins/1154520/1.0/persona" title="/en-US/docs/">http://community.elgg.org/plugins/1154520/1.0/persona</a></li> - <li>Joomla: <a href="http://extensions.joomla.org/extensions/access-a-security/authentication-cloud-based/18567" title="http://extensions.joomla.org/extensions/access-a-security/authentication-cloud-based/18567">http://extensions.joomla.org/extensions/access-a-security/authentication-cloud-based/18567</a></li> - <li>Midgard MVC: <a href="https://github.com/midgardproject/midgardmvc_core/blob/master/services/authentication/browserid.php" title="https://github.com/midgardproject/midgardmvc_core/blob/master/services/authentication/browserid.php">https://github.com/midgardproject/midgardmvc_core/blob/master/services/authentication/browserid.php</a></li> - <li>MyBB: <a href="https://github.com/Rudloff/mybb-browserid" title="https://github.com/Rudloff/mybb-browserid">https://github.com/Rudloff/mybb-browserid</a></li> - <li>SPIP: <a href="http://www.spip-contrib.net/BrowserID" title="http://www.spip-contrib.net/BrowserID">http://www.spip-contrib.net/BrowserID</a></li> - <li>Symfony2: <a href="https://github.com/Proxiweb/PersonaBundle" title="https://github.com/Proxiweb/PersonaBundle">https://github.com/Proxiweb/PersonaBundle</a>, <a href="https://github.com/bitgrave/BGPersonaBundle" title="https://github.com/bitgrave/BGPersonaBundle">https://github.com/bitgrave/BGPersonaBundle</a>, https://packagist.org/packages/champs-libres/persona-user-bundle</li> - <li>Tiki: <a href="http://dev.tiki.org/Mozilla+Persona" title="http://dev.tiki.org/Mozilla+Persona">http://dev.tiki.org/Mozilla+Persona</a></li> - <li>WordPress / bbPress 2: <a href="http://wordpress.org/extend/plugins/browserid/" title="http://wordpress.org/extend/plugins/browserid/">http://wordpress.org/extend/plugins/browserid/</a></li> -</ul> - -<h3 id="Python">Python</h3> - -<ul> - <li>CherryPy: <a href="https://bitbucket.org/jaraco/jaraco.persona">https://bitbucket.org/jaraco/jaraco.persona</a></li> - <li>Django: <a href="https://github.com/mozilla/django-browserid" title="https://github.com/mozilla/django-browserid">https://github.com/mozilla/django-browserid</a> (voir des <a href="http://godjango.com/11-browser-id/" title="http://godjango.com/11-browser-id/">captures d'écran</a>)</li> - <li>Django Social Auth: <a href="https://github.com/omab/django-social-auth/blob/master/social_auth/backends/browserid.py" title="https://github.com/omab/django-social-auth/blob/master/social_auth/backends/browserid.py">https://github.com/omab/django-social-auth/blob/master/social_auth/backends/browserid.py</a></li> - <li>Django 1.5 and Python 3: <a href="https://github.com/mozillaperu/MozTanta-Persona" title="/en-US/docs/">https://github.com/mozillaperu/MozTanta-Persona</a></li> - <li>Flask: <a href="http://pypi.python.org/pypi/Flask-BrowserID" title="http://pypi.python.org/pypi/Flask-BrowserID">http://pypi.python.org/pypi/Flask-BrowserID</a></li> - <li>Google App Engine: <a href="https://github.com/psawaya/BrowserID-GAE" title="https://github.com/psawaya/BrowserID-GAE">https://github.com/psawaya/BrowserID-GAE</a></li> - <li>Pyramid: <a href="http://www.rfk.id.au/blog/entry/painless-auth-pyramid-browserid/" title="http://www.rfk.id.au/blog/entry/painless-auth-pyramid-browserid/">http://www.rfk.id.au/blog/entry/painless-auth-pyramid-browserid/</a></li> - <li>Pyramid: <a href="https://github.com/madjar/pyramid_persona/" title="https://github.com/madjar/pyramid_persona/">https://github.com/madjar/pyramid_persona/</a> (voir un <a href="http://compiletoi.net/quick-authentication-on-pyramid-with-persona.html" title="http://compiletoi.net/quick-authentication-on-pyramid-with-persona.html">billet de blog</a>)</li> - <li>Repoze: <a href="https://github.com/mozilla-services/repoze.who.plugins.browserid" title="https://github.com/mozilla-services/repoze.who.plugins.browserid">https://github.com/mozilla-services/repoze.who.plugins.browserid</a></li> - <li>Tornado: <a href="http://www.peterbe.com/plog/integrate-browserid-in-a-tornado-web-app" title="http://www.peterbe.com/plog/integrate-browserid-in-a-tornado-web-app">http://www.peterbe.com/plog/integrate-browserid-in-a-tornado-web-app</a></li> - <li>Twisted: <a href="https://github.com/warner/browserid-cred" title="https://github.com/warner/browserid-cred">https://github.com/warner/browserid-cred</a></li> - <li>web.py: <a href="https://github.com/oscarfroberg/browserid-webpy" title="https://github.com/oscarfroberg/browserid-webpy">https://github.com/oscarfroberg/browserid-webpy</a></li> - <li>WSGI: <a href="https://github.com/ianb/wsgibrowserid" title="https://github.com/ianb/wsgibrowserid">https://github.com/ianb/wsgibrowserid</a></li> -</ul> - -<h3 id="Ruby">Ruby</h3> - -<ul> - <li>Devise: <a href="https://rubygems.org/gems/devise-browserid" title="https://rubygems.org/gems/devise-browserid">https://rubygems.org/gems/devise-browserid</a></li> - <li>Devise: <a href="https://github.com/denschub/devise_browserid_authenticatable" title="https://github.com/denschub/devise_browserid_authenticatable">https://github.com/denschub/devise_browserid_authenticatable</a></li> - <li>OmniAuth: <a href="https://github.com/intridea/omniauth-browserid" title="https://github.com/intridea/omniauth-browserid">https://github.com/intridea/omniauth-browserid</a></li> - <li>Rails: <a href="http://rubygems.org/gems/browserid-rails" title="http://rubygems.org/gems/browserid-rails">http://rubygems.org/gems/browserid-rails</a></li> - <li>Sinatra: <a href="http://rubygems.org/gems/sinatra-browserid" title="http://rubygems.org/gems/sinatra-browserid">http://rubygems.org/gems/sinatra-browserid</a></li> - <li>Warden / Rack: <a href="https://rubygems.org/gems/warden-browserid" title="/en-US/en-US/docs/">https://rubygems.org/gems/warden-browserid</a></li> -</ul> - -<h3 id="Miscellaneous">Miscellaneous</h3> - -<ul> - <li>Apache: <a href="https://github.com/mozilla/mod_browserid" title="/Link_Type_Article_Title_Lookup_/_Link_Text_Attachments_URL">https://github.com/mozilla/mod_browserid</a></li> - <li>Cyrus SASL: <a href="https://github.com/ozten/sasl-browserid" title="https://github.com/ozten/sasl-browserid">https://github.com/ozten/sasl-browserid</a></li> - <li>PhoneGap: <a href="https://github.com/couchbaselabs/cordova-browserid" title="https://github.com/couchbaselabs/cordova-browserid">https://github.com/couchbaselabs/cordova-browserid</a></li> -</ul> - -<p>Vous n'avez pas vu votre langage ou environnement de travail ici ? <a href="http://identity.mozilla.com/post/31008721633/" title="http://identity.mozilla.com/post/31008721633/">LoginRadius</a>, un widget d'authentification, offre une intégration de Persona pour beaucoup de plateformes.</p> - -<h2 id="Bibliothèques_utilitaires">Bibliothèques utilitaires</h2> - -<h3 id="C">C</h3> - -<ul> - <li><a href="https://github.com/PADL/gss_browserid" title="https://github.com/PADL/gss_browserid">https://github.com/PADL/gss_browserid</a> (composant libbrowserid)</li> -</ul> - -<h3 id="Go">Go</h3> - -<ul> - <li><a href="https://github.com/elathan/gobrowserid" title="https://github.com/elathan/gobrowserid">https://github.com/elathan/gobrowserid</a></li> -</ul> - -<h3 id="Haskell_2">Haskell</h3> - -<ul> - <li><a href="http://hackage.haskell.org/package/authenticate" title="http://hackage.haskell.org/package/authenticate">http://hackage.haskell.org/package/authenticate</a></li> -</ul> - -<h3 id=".Net">.Net</h3> - -<ul> - <li><a href="https://github.com/cvrajeesh/NBrowserID" title="https://github.com/cvrajeesh/NBrowserID">https://github.com/cvrajeesh/NBrowserID</a></li> - <li><a href="http://www.codeguru.com/csharp/.net/net_asp/using-browserid-authentication-in-asp.net-web-sites.htm" title="http://www.codeguru.com/csharp/.net/net_asp/using-browserid-authentication-in-asp.net-web-sites.htm">http://www.codeguru.com/csharp/.net/net_asp/using-browserid-authentication-in-asp.net-web-sites.htm</a></li> - <li><a href="https://github.com/fernandozamoraj/BrowserIdDemoWithMVC3" title="https://github.com/fernandozamoraj/BrowserIdDemoWithMVC3">https://github.com/fernandozamoraj/BrowserIdDemoWithMVC3</a> (voir un <a href="http://fernandozamorajimenez.blogspot.com/2012/04/integrating-browserid-with-mvc3.html" title="http://fernandozamorajimenez.blogspot.com/2012/04/integrating-browserid-with-mvc3.html">billet de blog</a>)</li> - <li><a href="https://github.com/sergiotapia/ASP.Net-MVC3-Persona-Demo" title="https://github.com/sergiotapia/ASP.Net-MVC3-Persona-Demo">https://github.com/sergiotapia/ASP.Net-MVC3-Persona-Demo</a></li> -</ul> - -<h3 id="Node.js_2">Node.js</h3> - -<ul> - <li><a href="https://github.com/substack/persona-id" title="https://github.com/substack/persona-id">https://github.com/substack/persona-id</a></li> - <li><a href="https://github.com/lloyd/node-browserid" title="https://github.com/lloyd/node-browserid">https://github.com/lloyd/node-browserid</a></li> -</ul> - -<h3 id="PHP_2">PHP</h3> - -<ul> - <li><a href="https://github.com/Falco20019/php-browseridlib" title="https://github.com/Falco20019/php-browseridlib">https://github.com/Falco20019/php-browseridlib</a></li> - <li><a href="https://github.com/raymondjavaxx/php5-browserid" title="https://github.com/raymondjavaxx/php5-browserid">https://github.com/raymondjavaxx/php5-browserid</a></li> -</ul> - -<h3 id="Python_2">Python</h3> - -<ul> - <li><a href="https://github.com/mozilla/PyBrowserID" title="https://github.com/mozilla/PyBrowserID">https://github.com/mozilla/PyBrowserID</a></li> -</ul> - -<h2 id="Autres">Autres</h2> - -<h3 id="Perl">Perl</h3> - -<ul> - <li>Perl/CGI IdP: <a href="https://github.com/benkard/mulkyid" title="https://github.com/benkard/mulkyid">https://github.com/benkard/mulkyid</a></li> -</ul> - -<h3 id="Python_3">Python</h3> - -<ul> - <li>WSGI IdP: <a href="https://bitbucket.org/djc/persona-totp" title="https://bitbucket.org/djc/persona-totp">https://bitbucket.org/djc/persona-totp</a></li> -</ul> - -<h3 id="Ruby_2">Ruby</h3> - -<ul> - <li>Rack IdP: <a href="https://rubygems.org/gems/browserid-provider" title="https://rubygems.org/gems/browserid-provider">https://rubygems.org/gems/browserid-provider</a> (voir un <a href="https://rin.no/category/browserid-2/" title="https://rin.no/category/browserid-2/">billet de blog</a>)</li> -</ul> - -<h3 id="PHP_3">PHP</h3> - -<ul> - <li>Symfony2 IdP: <a href="https://github.com/gigablah/GBPersonaProviderBundle" title="https://github.com/gigablah/persona-provider-bundle">https://github.com/gigablah/GBPersonaProviderBundle</a></li> -</ul> - -<h3 id="Racket">Racket</h3> - -<ul> - <li>web-server module: <a href="https://github.com/cosmez/racket-persona">https://github.com/cosmez/racket-persona</a></li> -</ul> diff --git a/files/fr/archive/mozilla/persona/pourquoi_persona/index.html b/files/fr/archive/mozilla/persona/pourquoi_persona/index.html deleted file mode 100644 index 589c24e8be..0000000000 --- a/files/fr/archive/mozilla/persona/pourquoi_persona/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Pourquoi Persona ? -slug: Archive/Mozilla/Persona/Pourquoi_Persona -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Why_Persona ---- -<p style="">Le mécanisme le plus répandu, basé sur le couple identifiant/mot de passe, n'est pas tenable : on demande aux utilisateurs de créer et de retenir un nouveau mot de passe complexe pour chaque site ou service qu'ils utilisent, et chaque site doit stocker de son côté les mots de passe de manière sécurisée. Pourtant, des intrusions récentes montrent que même des entreprises de premier plan peuvent avoir des failles dans la sécurité de leur base de mots de passe, ce qui met en danger les informations de leurs utilisateurs.</p> -<p>Persona est un système de gestion des identités ouvert, distribué, adapté à l'échelle d'internet, qui remplace le système des mots de passe par site. Il répond aux limitations en termes d'ergonomie et de vie privée que peuvent rencontrer des systèmes comme OpenID, sans avoir recours à une infrastructure centralisée comme le fait Facebook Connect.</p> -<h2 id="Persona_la_fin_des_mots_de_passe_par_site">Persona : la fin des mots de passe par site</h2> -<p>Au lieu d'utiliser un mot de passe pour chaque site, Persona permet aux utillisateurs de se connecter en seulement deux clics après avoir réalisé un processus simple une seule fois pour chacune de leurs identités en ligne. Le processus est totalement sécurisé et basé sur les principes de la cryptographie à clé publique. Plutôt qu'un mot de passe, le navigateur internet de l'utilisateur génère ensuite une « assertion d'identité » chiffrée, qui expire après quelques minutes et n'est valable que pour un seul site. Du fait qu'il n'y a plus de mot de passe spécifique pour chaque site, les sites utilisant Persona n'ont plus à se préoccuper du stockage sécurisé des mots de passe ou de la perte éventuelle de leur base de mots de passe.</p> -<p>Cette méthode rapide d'authentification réduit aussi la complexité lors de la première connexion d'un utilisateur à un nouveau site.</p> -<h2 id="Les_identifiants_Persona_sont_vos_adresses_de_courriel">Les identifiants Persona sont vos adresses de courriel</h2> -<p>Plutôt que des identifiants à saisie libre, Persona utilise des adresses de courriel, ce qui a plusieurs avantages pour les utilisateurs comme pour les développeurs :</p> -<h3 id="Avantages_des_adresses_de_courriel_pour_les_utilisateurs">Avantages des adresses de courriel pour les utilisateurs</h3> -<ul> - <li>Les utilisateurs connaissent déjà leurs adresses de courriel, ils n'ont pas à apprendre une nouvelle adresse internet (URL), potentiellement complexe, comme c'est le cas avec OpenID.</li> - <li>Les adresses de courriel portent en elles l'idée <code>une-personne@un-contexte</code>, facilitant ainsi pour les utilisateurs la séparation de leurs identités comme <code>@travail</code>, <code>@maison</code>, <code>@ecole, etc</code>. C'est très différent de la tendance à la centralisation des identités que l'on retrouve dans les conditions d'utilisation des réseaux sociaux comme Facebook et Google+, de type « un seul compte basé sur la vraie identité ».</li> - <li>Les courriels peuvent etre auto-hébergés ou délégués à d'autres fournisseurs de service, laissant aux utilisateurs le contrôle total de leur indentité en ligne.</li> -</ul> -<h3 id="Avantages_des_adresses_de_courriel_pour_les_développeurs">Avantages des adresses de courriel pour les développeurs</h3> -<ul> - <li>Les adresses de courriel donnent aux développeurs un moyen direct pour contacter leurs utilisateurs.</li> - <li>La plupart des sites demandent une adresse de courriel à leurs utilisateurs. Persona la leur fournit automatiquement quand un utilisateur se connecte, éliminant le besoin d'avoir des formulaires supplémentaires après connexion.</li> - <li>De nombreux systèmes d'authentification traitent déjà les adresses de courriel comme des clés uniques. Cela signifie qu'il n'y a pas d'enfermement (lock-in) avec Persona, et qu'il peut être déployé à côté de systèmes d'authentification déjà existants.</li> -</ul> -<p>Sans oublier par ailleurs que le courriel est un système qui est déjà complètement distribué, avec des milliards de comptes existant chez d'innombrables fournisseurs.</p> -<h2 style="" id="En_quoi_Persona_diffère-t-il_des_autres_systèmes_d'authentification_unique_(Single_Sign-On)">En quoi Persona diffère-t-il des autres systèmes d'authentification unique (Single Sign-On) ?</h2> -<p>Persona est sécurisé et facile à utiliser. Il protège la vie privée des utilisateurs, leur laisse le contrôle et une liberté de choix de façon inégalée.</p> -<p>De nombreux réseaux sociaux comme Facebook ou Google+ imposent aux utilisateurs l'utilisation de leurs vrais noms et leur limitent l'accès à un compte unique. En utilisant comme identifiant de base l'adresse de courriel, Persona permet aux utilisateurs de garder séparées leurs identités de travail, de maison, d'école ainsi que leurs autres identités.</p> -<p>Persona est ouvert et distribué : toute personne ayant une adresse de courriel peut se connecter à des sites web avec Persona. Plus encore, chacun peut héberger son propre service d'authentification ou le déléguer à d'autres, exactement comme dans le cas des courriels, et contrairement aux services uniques et centralisés utilisés par les réseaux sociaux.</p> -<p>Persona propose aussi une nouvelle approche de la protection de la vie privée en mettant le navigateur internet au centre du processus d'authentification : le navigateur obtient d'un côté des certificats du fournisseur de courriel de l'utilisateur, et les présente de l'autre côté au site web. Le service de courriel ne peut pas pister l'utilisateur, et les sites tiers peuvent avoir confiance dans l'identité de l'utilisateur grâce à la signature chiffrée des certificats. La plupart des systèmes concurrents comme OpenID exigent que les sites tiers envoient un message en retour avant d'autoriser l'utilisateur à se connecter.</p> diff --git a/files/fr/archive/mozilla/persona/quick_setup/index.html b/files/fr/archive/mozilla/persona/quick_setup/index.html deleted file mode 100644 index ee692b5274..0000000000 --- a/files/fr/archive/mozilla/persona/quick_setup/index.html +++ /dev/null @@ -1,241 +0,0 @@ ---- -title: Configuration rapide -slug: Archive/Mozilla/Persona/Quick_Setup -tags: - - Persona -translation_of: Archive/Mozilla/Persona/Quick_Setup ---- -<p>Seules cinq étapes sont nécessaires pour installer un système d'authentification Persona sur votre site :</p> - -<ol> - <li>Inclure la bibliothèque JavaScript Persona sur vos pages.</li> - <li>Ajouter les boutons “connexion” et “déconnexion”.</li> - <li>Observer les actions connexion et déconnexion.</li> - <li>Vérifier l'identification de l'utilisateur.</li> - <li>Consulter les meilleures pratiques.</li> -</ol> - -<p>Vous devriez être en mesure de le faire fonctionner en un simple après-midi, mais chaque chose en son temps : si vous comptez utiliser Persona sur votre site, s'il vous plaît, prenez un moment pour vous inscrire sur la liste de diffusion <a href="https://mail.mozilla.org/listinfo/persona-notices">Persona notices</a>. Elle est à faible trafic, étant uniquement utilisée pour annoncer les changements et les problème de sécurité qui pourraient affecter votre site.</p> - -<h2 id="Étape_1_Inclure_la_bibliothèque_Persona">Étape 1 : Inclure la bibliothèque Persona</h2> - -<p>Persona est conçu pour ne pas être lié à un navigateur en particulier et fonctionne bien dans <a href="/fr/docs/persona/Browser_compatibility">les principaux navigateurs de bureau et mobile</a>.</p> - -<p><span style="line-height: inherit;">Dans le futur nous espérons que les navigateurs fourniront un support natif de Persona, mais en attendant nous fournissons une bibliothèque JavaScript qui implémente pleinement l'interface et l'API client du protocole. En incluant cette <span style="line-height: inherit;">bibliothèque</span>, vos utilisateurs seront en mesure de se connecter avec Persona, que leur navigateur en ait un support natif ou non.</span></p> - -<p>Une fois la bibliothèque chargée sur la page, les fonctions Persona dont vous avez besoin (<a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>watch()</code></a>, <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>request()</code></a>, et <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>logout()</code></a>), seront accessible depuis l'objet global <code>navigator.id</code>.</p> - -<p>Pour inclure la <span style="line-height: inherit;"><span style="line-height: inherit;">bibliothèque</span></span> JavaScript Persona, vous pouvez placer cette balise <a href="/fr/docs/Web/HTML/Element/script" title="L'élément HTML <script> est utilisé pour intégrer ou faire référence à un script exécutable."><code><script></code></a> tout en bas de de votre code HTML, avant la fermeture de la balise <a href="/fr/docs/Web/HTML/Element/body" title="L'élément <body> représente le contenu principal du document HTML. Il ne peux y avoir qu'un élément <body> par document."><code><body></code></a> :</p> - -<pre class="brush: html;"><script src="https://login.persona.org/include.js"></script> -</pre> - -<p>Vous <strong>devez</strong> inclure ceci dans toutes les pages qui utilisent les fonctions de <a href="/fr/docs/Web/API/Navigator/id" title="Le protocole BrowserID définit une nouvelle propriété id dans l'objet window.navigator, dans laquelle l'API BrowserID est rendue disponible. Cette API a subi plusieurs importantes modifications. Chaque modification est listée séparément ci-dessous."><code>navigator.id</code></a>. Persona étant toujours en développement, il est déconseillé d'héberger vous-même une copie du fichier <code>include.js</code>.</p> - -<h3 id="Supprimer_le_Mode_de_Compatibilité">Supprimer le Mode de Compatibilité</h3> - -<p>Vous devez vous assurer que les utilisateurs d'Internet Explorer n'utilisent pas le Mode de Compatibilité, car il cassera Persona.</p> - -<p>Vous pouvez soit inclure cette balise <a href="/fr/docs/Web/HTML/Element/meta" title="L'élément HTML <meta> représente toute information de métadonnées qui ne peut pas être représentée par un des éléments (<base>, <link>, <script>, <style> ou <title>)"><code><meta></code></a>, dans votre page, avant tout élément <code>script</code> :</p> - -<pre class="brush: html"><code><meta http-equiv="X-UA-Compatible" content="IE=Edge"></code></pre> - -<p>Ou vous pouvez définir un entête HTTP sur votre page : <code>X-UA-Compatible: IE=Edge</code>.</p> - -<h2 id="Étape_2_Ajoutez_des_boutons_de_connexion_et_de_déconnexion">Étape 2 : Ajoutez des boutons de connexion et de déconnexion</h2> - -<p>Persona étant conçu comme une API DOM, vous devez appeler des fonctions quand un utilisateur clique sur un bouton de connexion ou de déconnexion sur votre site. Pour ouvrir la boîte de dialogue Persona et demander à l'utilisateur de se connecter, vous devez appeler <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a>. Pour la déconnexion, appelez <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.logout()</code></a>. Notez que l'appel à <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>logout()</code></a> <em>doit</em> être fait depuis la fonction attachée à l'évènement.</p> - -<p>Par exemple :</p> - -<pre class="brush: js;">var signinLink = document.getElementById('signin'); -if (signinLink) { - signinLink.onclick = function() { navigator.id.request(); }; -}; - -var signoutLink = document.getElementById('signout'); -if (signoutLink) { - signoutLink.onclick = function() { navigator.id.logout(); }; -}; -</pre> - -<p>À quoi devraient ressembler ces boutons ? Consultez notres page de <a href="/fr/docs/persona/branding">ressources graphiques</a> pour des exemple complets basés sur du CSS !</p> - -<h2 id="Étape_3_Gérez_les_actions_de_connexion_et_de_déconnexion">Étape 3 : Gérez les actions de connexion et de déconnexion</h2> - -<p>Afin que Persona puisse fonctionner, vous devez lui dire quoi faire lorsqu'un utilisateur se connecte ou se déconnecte. Pour cela, appelez la fonction <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a> et passez lui trois paramètres :</p> - -<ol> - <li>L'adresse email de l'utilisateur actuellement connecté à votre site depuis cet ordinateur, ou <code>null</code> si aucun utilisateur n'est connecté. Par exemple, vous pouvez consulter un cookie du navigateur pour déterminer qui est connecté.</li> - <li>Une fonction à appeler lorsqu'une action <code>onlogin</code> est déclenchée. Cette fonction reçoit un seul paramètre, une "assertion d'identité" qui doit être vérifiée.</li> - <li>Une fonction à appeler lorsqu'une action <code>onlogout</code> est déclenchée. Cette fonction ne reçoit aucun paramètre.</li> -</ol> - -<div class="note style-wrap"> -<p><strong>Note:</strong> Vous devez toujours inclure à la fois <code>onlogin</code> et <code>onlogout</code> lorsque vous appelez <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>.</p> -</div> - -<p>Par exemple, si vous pensez que Bob est connecté à votre site, vous pourriez faire ceci :</p> - -<pre class="brush: js;">var currentUser = 'bob@example.com'; - -navigator.id.watch({ - <code class="language-js">loggedInUser</code>: currentUser, - onlogin: function(assertion) { - // Un utilisateur est connecté ! Voici ce qu'il faut faire : - // 1. Envoyer l'assertion à votre backend pour vérification et pour créer la session. - // 2. Mettre à jour l'interface utilisateur. - <code class="language-js">$<span class="punctuation token">.</span><span class="function token">ajax<span class="punctuation token">(</span></span><span class="punctuation token">{</span> - type<span class="punctuation token">:</span> <span class="string token">'POST'</span><span class="punctuation token">,</span> - url<span class="punctuation token">:</span> <span class="string token">'/auth/login'</span><span class="punctuation token">,</span><span class="comment token"> // Ceci est une URL sur votre site web. -</span> data<span class="punctuation token">:</span> <span class="punctuation token">{</span>assertion<span class="punctuation token">:</span> assertion<span class="punctuation token">}</span><span class="punctuation token">,</span> - success<span class="punctuation token">:</span> <span class="keyword token">function</span><span class="punctuation token">(</span>res<span class="punctuation token">,</span> status<span class="punctuation token">,</span> xhr<span class="punctuation token">)</span> <span class="punctuation token">{</span> window<span class="punctuation token">.</span>location<span class="punctuation token">.</span><span class="function token">reload<span class="punctuation token">(</span></span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="punctuation token">}</span><span class="punctuation token">,</span> - error<span class="punctuation token">:</span> <span class="keyword token">function</span><span class="punctuation token">(</span>xhr<span class="punctuation token">,</span> status<span class="punctuation token">,</span> err<span class="punctuation token">)</span> <span class="punctuation token">{</span> - navigator<span class="punctuation token">.</span>id<span class="punctuation token">.</span><span class="function token">logout<span class="punctuation token">(</span></span><span class="punctuation token">)</span><span class="punctuation token">;</span> - <span class="function token">alert<span class="punctuation token">(</span></span><span class="string token">"Login failure: "</span> <span class="operator token">+</span> err<span class="punctuation token">)</span><span class="punctuation token">;</span> - <span class="punctuation token">}</span> - <span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span></code> - }, - onlogout: function() { - // Un utilisateur s'est déconnecté ! Voici ce qu'il faut faire : - // Détruire la session de l'utilisateur en redirigeant l'utilisateur ou en appelant votre backend. - // Assurez vous aussi de réinitialiser loggedInUser à null sur la prochain fois où la page sera chargée - // (Pas false, ni 0 ou undefined. null) - <code class="language-js">$<span class="punctuation token">.</span><span class="function token">ajax<span class="punctuation token">(</span></span><span class="punctuation token">{</span> - type<span class="punctuation token">:</span> <span class="string token">'POST'</span><span class="punctuation token">,</span> - url<span class="punctuation token">:</span> <span class="string token">'/auth/logout'</span><span class="punctuation token">,</span><span class="comment token"> // Ceci est une URL sur votre site web. -</span> success<span class="punctuation token">:</span> <span class="keyword token">function</span><span class="punctuation token">(</span>res<span class="punctuation token">,</span> status<span class="punctuation token">,</span> xhr<span class="punctuation token">)</span> <span class="punctuation token">{</span> window<span class="punctuation token">.</span>location<span class="punctuation token">.</span><span class="function token">reload<span class="punctuation token">(</span></span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="punctuation token">}</span><span class="punctuation token">,</span> - error<span class="punctuation token">:</span> <span class="keyword token">function</span><span class="punctuation token">(</span>xhr<span class="punctuation token">,</span> status<span class="punctuation token">,</span> err<span class="punctuation token">)</span> <span class="punctuation token">{</span> <span class="function token">alert<span class="punctuation token">(</span></span><span class="string token">"Logout failure: "</span> <span class="operator token">+</span> err<span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="punctuation token">}</span> - <span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span></code> - } -}); -</pre> - -<p>Dans cet exemple, <code>onlogin</code> et <code>onlogout</code> sont tous deux implémentés en effectuant des requêtes <code>POST</code> asynchrones vers le backend de votre site. Le backend effectue ensuite la connexion ou la déconnexion de l'utilisateur, généralement en créant ou en effaçant des informations dans un cookie de session. Ensuite, si tout fonctionne bien, la page se recharge afin de prendre en compte le nouvel état de connexion.</p> - -<p>Notez que si l'assertion ne peut être vérifiée, vous devez appeler <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.logout()</code></a>, qui indique à Persona qu'aucun utilisateur n'est actuellement connecté. Si vous ne le faîtes pas, alors Persona peut appeler <code>onlogin</code> immédiatement à nouveau, avec la même assertion, et entrainer une <a href="/en-US/Persona/The_implementor_s_guide/Call_logout()_after_a_failed_login">boucle infinie d'échecs de connexion</a>.</p> - -<p>Bien entendu vous pouvez utiliser des requêtes AJAX pour implémenter cela sans recharger la page ni rediriger l'utilisateur, mais cela ne fait pas partie du périmètre de ce tutoriel.</p> - -<p>Voici un autre exemple, cette fois-ci sans utiliser jQuery.</p> - -<pre class="brush: js;">function simpleXhrSentinel(xhr) { - return function() { - if (xhr.readyState == 4) { - if (xhr.status == 200) { - // recherche la page pour prendre en compte le nouveau statut de connexion - window.location.reload(); - } else { - navigator.id.logout(); - alert("XMLHttpRequest error: " + xhr.status); - } - } - }; -} - -function verifyAssertion(assertion) { - // Votre backend doit retourner un status code HTTP 200 pour indiquer la bonne - // vérification de l'adresse e-mail de l'utilisateur et il doit s'arranger pour que - // currentUser soit bien associer à cette adresse quand la page est rechargée - var xhr = new XMLHttpRequest(); - xhr.open("POST", "/xhr/sign-in", true); - // voir http://www.openjs.com/articles/ajax_xmlhttp_using_post.php - var param = "assertion="+assertion; - xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded"); - xhr.setRequestHeader("Content-length", param.length); - xhr.setRequestHeader("Connection", "close"); - xhr.send(param); // pour la vérification par votre backend - xhr.onreadystatechange = simpleXhrSentinel(xhr); -} - -function signoutUser() { - // Votre backend doit retourner un code statut HTTP 200 pour indique la bonne déconnexion - // (habituellement après la réinitialisation de plusieurs variables de session) - // et s'arranger pour que l'association à currentUser soit 'null' quand la page est rechargée - var xhr = new XMLHttpRequest(); - xhr.open("GET", "/xhr/sign-out", true); - xhr.send(null); - xhr.onreadystatechange = simpleXhrSentinel(xhr); -} - -// C'est parti ! -navigator.id.watch({ - loggedInUser: currentUser, - onlogin: verifyAssertion, - onlogout: signoutUser -}}; -</pre> - -<p>Vous <strong>devez</strong> appeler <code>navigator.id.watch()</code> sur toutes les pages comprenant un bouton de connexion ou de déconnexion. Pour gérer les améliorations de Persona comme la connexion automatique et la déconnexion globale de vos utilisateurs, <strong>il est conseillé</strong> d'appeler cette fonction sur toutes les pages de votre site.</p> - -<p>Persona comparera l'adresse e-mail que vous passez dans <code>loggedInUser</code> avec celle qu'il connaît pour l'utilisateur actuellement connecté. Si elles ne correspondent pas, il peut déclencher automatiquement <code>onlogin</code> ou <code>onlogout</code> au chargement de la page.</p> - -<h2 id="Étape_4_Vérifiez_les_identifiants_de_l'utilisateur">Étape 4 : Vérifiez les identifiants de l'utilisateur</h2> - -<p>Plutôt qu'un mot de passe, Persona utilise des "assertions d'identité" qui sont une sorte de mot de passe à usage unique, lié à un seul site et combiné à l'adresse e-mail de l'utilisateur. Lorsqu'un utilisateur désire se connecter, votre fonction de callback <code>onlogin</code> sera appelée et recevra en paramètre une assertion de cet utilisateur. Avant d'autoriser la connexion, vous devez vérifier la validité de cette assertion.</p> - -<p>Il est <em>extrêmement important</em> que vous vérifiiez cette assertion sur votre serveur et non en JavaScript (qui s'exécute dans le navigateur de votre utilisateur) car cela serait trop facile à contourner. L'exemple ci-dessous confie l'assertion au backend du site en utilisant le helper jQuery <code>$.ajax()</code> pour effectuer un <code>POST</code> de celle-ci vers <code>/api/login</code>.</p> - -<p>Une fois que le serveur dispose d'une assertion, comment la vérifier ? Le moyen le plus simple est d'utiliser un helper fourni par Mozilla. Effectuez un simple <code>POST</code> de l'assertion vers <code>https://verifier.login.persona.org/verify</code> avec deux paramètres :</p> - -<ol> - <li><code>assertion</code>: L'assertion d'identité fournie par l'utilisateur.</li> - <li><code>audience</code>: Le nom de domaine et le port de votre site web. Vous devez coder cette valeur en dur dans votre backend ; ne la composez pas en fonction d'une quelconque donnée fournie par l'utilisateur.</li> -</ol> - -<p>Par exemple, si vous êtes <code>example.com</code>, vous pouvez utiliser la ligne de commande pour tester une assertion avec :</p> - -<pre class="brush: bash;">$ curl -d "assertion=<ASSERTION>&audience=https://example.com:443" "https://verifier.login.persona.org/verify" -</pre> - -<p>Si elle est valide, vous recevrez une réponse en JSON comme celle-ci :</p> - -<pre class="brush: js;">{ - "status": "okay", - "email": "bob@eyedee.me", - "audience": "https://example.com:443", - "expires": 1308859352261, - "issuer": "eyedee.me" -} -</pre> - -<p>Pour en apprendre plus à propos du service de vérification, lisez l'<a href="/fr/Persona/API_de_verification">API de vérification à distance</a>. Un exemple d'implémentation de <code>/api/login</code> utilisant <a href="http://python.org/">Python</a>, le framework web <a href="http://flask.pocoo.org/">Flask</a>, et la librairie HTTP <a href="http://python-requests.org">Requests</a> ressemblerait à ça :</p> - -<pre class="brush: python;">@app.route('/api/login', methods=['POST']) -def login(): - # La requête doit avoir une assertion à vérifier - if 'assertion' not in request.form: - abort(400) - - # Envoyer l'assertion au service de vérification de Mozilla. - data = {'assertion': request.form['assertion'], 'audience': 'https://example.com:443'} - resp = requests.post('https://verifier.login.persona.org/verify', data=data) - - # Le vérificateur a-t-il répondu ? - if resp.ok: - # Décoder la réponse - verification_data = json.loads(resp.content) - - # Si l'assertion est valide - if verification_data['status'] == 'okay': - # Connecter l'utilisateur en lui envoyant un cookie de session sécurisé - session.update({'email': verification_data['email']}) - return resp.content - - # Oups, quelque chose a échoué. Abandon. - abort(500) -</pre> - -<p>La gestion de session est probablement très similaire à votre système de connexion existant. Le premier grand changement est de vérifier l'identité de l'utilisateur en vérifiant une assertion plutôt que son mot de passe. L'autre grand changement est de s'assurer que l'adresse email de l'utilisateur est disponible pour la passer dans le paramètre <code>loggedInEmail</code> de <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>.</p> - -<p>La déconnexion est simple : vous n'avez qu'à effacer le cookie de session de l'utilisateur.</p> - -<h2 id="Étape_5_Consultez_les_bonnes_pratiques">Étape 5 : Consultez les bonnes pratiques</h2> - -<p>Une fois que tout fonctionne et que vous vous êtez connecté et déconnecté avec succès de votre site, vous devriez prendre un moment pour consulter les <a href="/fr/Persona/Considerations_de_securite">bonnes pratiques</a> pour utiliser Persona de manière sûre et sécurisée.</p> - -<p>Si vous construisez un site de production, consulter le <a href="/fr/Persona/The_implementor_s_guide">guide de l'implémenteur</a>, où nous collections les astuces pour intégrer les fonctionnalités souvent requises dans les systèmes de connexion.</p> - -<p>Enfin, n'oubliez pas de vous inscrire à la<span style="line-height: inherit;"> liste de difussion </span><a style="line-height: inherit;" href="https://mail.mozilla.org/listinfo/persona-notices">Persona notices</a><span style="line-height: inherit;"> afin d'être informé des failles de sécurité ou de changements incompatibles avec de précédentes versions de l'API Persona. Cette liste a un taffic extrêmement faible : elle est uniquement utilisée pour annoncer des changements qui pourraient avoir un impact négatif sur votre site.</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/ajouter_adresse_email_supplementaire_avec_persona/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/ajouter_adresse_email_supplementaire_avec_persona/index.html deleted file mode 100644 index 2058fd4b0a..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/ajouter_adresse_email_supplementaire_avec_persona/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Ajouter des adresses e-mail supplémentaires avec Persona -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Ajouter_adresse_email_supplementaire_avec_Persona -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Adding_extra_email_addresses_with_Persona ---- -<p>C'est une bonne idée de permettre à vos utilisateurs d'ajouter des adresses e-mail supplémentaires à leurs comptes. Ceci leur permet de <a href="/fr/Persona/The_implementor_s_guide/permettre_utilisateurs_changer_adresse_email">changer leurs adresses e-mail</a>, et d'accéder à leur compte même s'ils sont dans l'impossibilité d'accéder à leur compte e-mail principal.</p> -<p>Vous devrez vérifier les adresses supplémentaires. Vous pouvez le faire manuellement, en envoyant un e-mail contenant un lien de vérification à la nouvelle adresse, ou le faire en utilisant Persona.</p> -<p>Si vous utilisez Persona pour ajouter des adresses e-mail, il vous faut alors faire attention à plusieurs points : rendez le contexte de la requête explicite, et mettez à jour la valeur passer dans <code>loggedInUser </code>pour assurer que la transaction n'est pas cassée par le gestionnaire de session de Persona</p> -<h3 id="Clarifier_le_context_de_la_requête">Clarifier le context de la requête</h3> -<p>Quand vous requêtez une nouvelle assertion en utilisant soit la vieille API <a href="/fr/docs/Web/API/Navigator/id/get" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.get()</code></a> ou l'API <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a>, Persona part du principe que l'utilisateur est en train d'essayer de se connecter au site web, et l'interface utilisateur est affiché en conséquence. Si vous utilisez Persona seulement pour vérifier une nouvelle adresse e-mail, votre site doit expliquer ceci clairement aux utilisateurs, afin qu'ils ne soient pas étonnés par la fenêtre de Persona.</p> -<h3 id="Mettre_à_jour_loggedInUser">Mettre à jour <code>loggedInUser</code></h3> -<p>Si vous utilisez l'API <a href="/fr/docs/Web/API/Navigator/id/get" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.get()</code></a> sur l'ensemble de votre site, alors vous pouvez simplement faire un nouvel appel à <a href="/fr/docs/Web/API/Navigator/id/get" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.get()</code></a> pour obtenir la nouvelle adresse e-mail.</p> -<p>Mais si vous utilisez <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a>, il vous faut alors utiliser <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a> pour obtenir l'adresse e-mail supplémentaire. Dans ce cas, quand vous avez vérifié l'assertion dans votre gestionnaire <code>onlogin</code>, vous devez mettre à jour l'argument <code>loggedInUser</code> de <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a> avec la nouvelle adresse.</p> -<p>Si vous ne le faîtes pas, il y aura une mauvaise correspondance : Persona pensera que l'utilisateur connecté est <code>nouvelle_adresseemail@example.org</code>, mais votre site web dira que l'utilisateur connecté est <code>vieille_adresseemail@example.org</code>. Persona réagira en déclenchant <code>onlogin </code>avec une assertion pour <code>nouvelle_adresseemail@example.org</code>, que votre site web reconnatra sûrement comme un nouveau utilisateur souhaitant se connecter.</p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/appeler_request()_seulement_depuis_gestionnaire_clic/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/appeler_request()_seulement_depuis_gestionnaire_clic/index.html deleted file mode 100644 index fb2c27e81b..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/appeler_request()_seulement_depuis_gestionnaire_clic/index.html +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Appeler request() seulement depuis un gestionnaire de clic -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/appeler_request()_seulement_depuis_gestionnaire_clic -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Call_request()_only_from_a_click_handler ---- -<p>Le fenêtre Persona est actuellement implémentée comme une fenêtre popup. Les navigateurs web modernes <a href="https://support.mozilla.org/fr/kb/parametres-exceptions-depannage-blocage-popup">bloquent les popups</a>, sauf s'ils sont déclenchés directement depuis un clic de la souris ou depuis un touche du clavier. Ceci veut dire que vous devez appeler <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a> ou <a href="/fr/docs/Web/API/Navigator/id/get" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.get()</code></a> directement depuis la fonction gérant le clic ou la touche pressée. Si c'est fait en réaction à un autre évènement, le popup ne s'affichera pas et l'utilisateur ne pourra pas s'identifier.</p> -<p>Par exemple : Supposons que votre site web diffère l'identification. Les utilisateurs peuvent parcourir le contenu, mais ils ne doivent s'identifier que lorsqu'ils souhaitent éditer le contenu. Si vous implémentez ceci en appelant <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a> en réponse à un évènement <code>focus</code> sur un champ texte, alors la popup sera bloquée.</p> -<p>Vous pouvez toujours implémenter l'identification sur le focus de cette façon : sur l'évènement <code>focus</code>, affichez un dialogue avec un bouton "Identifiez-vous", et attachez le déclenchement de <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a> sur l'évènement <code>click</code>.</p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/call_logout()_after_a_failed_login/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/call_logout()_after_a_failed_login/index.html deleted file mode 100644 index b587288f2d..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/call_logout()_after_a_failed_login/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Appeler logout() après une connexion échouée -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Call_logout()_after_a_failed_login -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Call_logout()_after_a_failed_login ---- -<p>Après que votre gestionnaire <code>onlogin</code> a été appelé avec une assertion, si pour quelque raison, vous ne pouvez utiliser cette assertion pour connecter l'utilisateur, vous devez appeler <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.logout()</code></a>.</p> -<p>Si vous ne le faîtes pas, la prochaine que vous appelerez <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>, Persona appelera immédiatement, à nouveau, votre gestionnaire <code>onlogin</code>, avec la même assertion. Ceci amène généralement à une boucle infinie d'echec de connexion :</p> -<ol> - <li>L'utilisateur clique sur "Se connecter"</li> - <li>L'utilisateur intéragit avec l'interface de Persona, et Persona génère une assertion</li> - <li>Persona livre l'assertion au gestionnaire <code>onlogin</code> de la page</li> - <li>Le gestionnaire <code>onlogin</code> rejète l'assertion, et redirige l'utilisateur vers la page de connexion</li> - <li>La page de connexion se charge, et appelle <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a>. Nous retournons à l'étape 3.</li> -</ol> -<p>Ceci car Persona essaye de se souvenir de l'adresse e-mail que vous voulez utilisez pour la connexion sur un site donné. Une fois que l'utilisateur a essayé de se connecté à votre site en tant que bob@example.org, Personna se souvient que c'est l'adresse que vous souhaitez utiliser pour ce site. Quand une nouvelle page se charge et appele <a href="/fr/docs/Web/API/Navigator/id/watch" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.watch()</code></a> avec un <code>loggedInUser</code> à '<code>null</code>', Persona compare à nouveau avec sa valeur "bob@example.org", et envoie l'assertion à nouveau.</p> -<p>Pour que Persona oublie l'association entre votre site l'adresse e-mail, appelez <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.logout()</code></a> si vous ne souhaitez pas identifier l'utilisateur avec cette assertion. Ceci parce que l'assertion n'est pas valide, ou parce que vous ne voulez pas utiliser cette adresse e-mail.</p> -<p>Un scénario commun, où ce problème peut survenir, est quand un service veut autoriser ses utilisateurs à <strong>se connecter</strong> avec Persona, mais ne veut pas permettre de <strong>s'inscrire</strong> avec Persona, préférant un système d'inscription personnalisé pour les nouveaux utilisateurs. Dans ce cas, quand vous recevez l'assertion, vous vérifiez que l'adresse e-mail est bien celui d'un de vos utilisateurs, et si ce n'est pas le cas, vous rejetez la connexion. Si vous rejetez l'assertion, vous devez appeler <a href="/fr/docs/Web/API/Navigator/id/logout" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.logout()</code></a>.</p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/index.html deleted file mode 100644 index 6057c265b6..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Guide de l'implémenteur -slug: Archive/Mozilla/Persona/The_implementor_s_guide -tags: - - Persona -translation_of: Archive/Mozilla/Persona/The_implementor_s_guide ---- -<p>Le <a href="/fr/Persona/Quick_Setup">guide de configuration rapide</a> peut être suffisant pour démarrer, mais quand vous construisez un site complet pour la production, vous aurez probablement besoin de fonctionnalités qui n'ont pas été couvertes par ce guide. Dans cette page, nous avons rassemblé les fonctionnalités qui sont couramment nécessaires pour les systèmes de connexion, et nous expliquons les meilleures pratiques pour les implémenter avec Persona.</p> -<div class="section"> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/Call_logout()_after_a_failed_login">Appeler logout() après une connexion échouée</a></dt> - <dd> - Appeler toujours logout() si vous rejetez une assertion, pour évider une différence entre votre idée de l'utilisateur courant et l'idée de Persona, qui pourrait amener à une boucle infinie d'échecs de connexion.</dd> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/Ajouter_adresse_email_supplementaire_avec_Persona">Ajouter des adresses e-mail supplémentaires avec Persona</a></dt> - <dd> - Comment permettre à vos utilisateurs d'ajouter une adresse e-mail secondaire en utilisant Persona.</dd> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/permettre_utilisateurs_changer_adresse_email">Permettre aux utilisateurs de changer d'adresse e-mail</a></dt> - <dd> - Comme permettre à vos utilisateurs de changer d'adresse e-mail en utilisant Persona.</dd> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/problemes_integrer_protection_CRSF">Problèmes pour intégrer une protection CSRF</a></dt> - <dd> - Un problème causé par l'intération entre un mécanisme courant de protection CSRF et l'API Observer de Persona.</dd> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/supporter_utilisateurs_sans_javascript" title="BrowserID/Quick setup">Supporter les utilisateurs sans JavaScript</a></dt> - <dd> - Persona requiert JavaScript. Cette page a quelques astuces pour supporter les utilisateurs qui n'ont pas JavaScript.</dd> - </dl> - <dl> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/appeler_request()_seulement_depuis_gestionnaire_clic">Appeler request() seulement depuis un gestionnaire de clic</a></dt> - <dd> - Parce que Persona utilise une fenêtre popup, vous devez appeler<code> request() </code>ou <code>get()</code> seulement dans la fonction attachée à l'évènement <code>click</code> ou <code>keypress</code>, pas à un autre type d'évènement.</dd> - </dl> - <dl> - <dt> - <a href="/fr/Persona/The_implementor_s_guide/tester">Tester votre système</a></dt> - <dd> - Quelques conseils pour simuler la connexion et la déconnexion des utilisateurs sur votre site web.</dd> - </dl> -</div> -<p> </p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/permettre_utilisateurs_changer_adresse_email/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/permettre_utilisateurs_changer_adresse_email/index.html deleted file mode 100644 index be06388a44..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/permettre_utilisateurs_changer_adresse_email/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Permettre aux utilisateurs de changer d'adresse e-mail -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/permettre_utilisateurs_changer_adresse_email -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Enabling_users_to_change_their_email_address ---- -<p>Parce que les noms d'utilisateur Persona sont des adresses e-mail, il n'est pas forcément évident de savoir comment vous pouvez permettre à vos utilisateurs de changer d'adresse e-mail. Nous sommes en train de travailler pour améliorer le processus, et pour le moment, c'est un peu particulier, mais faisable en suivant ces étapes :</p> -<ol> - <li>Utilisez un identifiant qui est indépendant de l'adresse e-mail de l'utilisateur comme clef primaire dans votre table d'utilisateurs. Elle peut ainsi rester la même lorsque l'adresse e-mail change.</li> - <li>Permettez aux utilisateurs d'ajouter des adresses e-mail à leurs comptes. Vous devrez vérifier leurs adresses e-mail, ce que vous pouvez faire manuellement, en envoyer un lien de vérification dans un e-mail à leur nouvelle adresse, ou en utilisant Persona. Si vous utilisez Persona, lisez <a href="/fr/Persona/The_implementor_s_guide/Ajouter_adresse_email_supplementaire_avec_Persona">Ajouter des adresses e-mail supplémentaires avec Persona</a>.</li> - <li>Permettez aux utilisateurs de se connecter avec n'importe quelle adresse e-mail de leur compte.</li> - <li>Permettez aux utilisateurs de supprimer leurs adresses e-mail.</li> -</ol> -<p>Avec ces fonctionnalités, les utilisateurs peuvent changer leur adresse e-mail de cette façon :</p> -<ol> - <li>Connexion à leur compte en utilisant leur adresse e-mail courante</li> - <li>Ajout d'une nouvelle adresse e-mail à leur compte</li> - <li>Suppression de l'ancienne adresse e-mail de leur compte.</li> -</ol> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/problemes_integrer_protection_crsf/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/problemes_integrer_protection_crsf/index.html deleted file mode 100644 index 134f7954ec..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/problemes_integrer_protection_crsf/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Problèmes pour intégrer une protection CSRF -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/problemes_integrer_protection_CRSF -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Problems_integrating_with_CRSF_protection ---- -<p>Si vous implémentez une protection particulière contre les attaques de connexion CSRF (Cross-Site Request Forgery, contrefaçon de requêtes trans-sites), vous rencontrerez des problèmes quand un utilisateur a plusieurs pages ouvertes sur votre site, et essaie ensuite de se connecter avec l'une d'elles. Ce document explique ce problème, et comment le résoudre.</p> -<h3 id="CSRF_et_les_attaques_de_connexion_CSRF">CSRF et les attaques de connexion CSRF</h3> -<p>Dans le cas normal d'une attaque CSRF, l'utilisateur est déjà connecté au site ciblé (par exemple, leur banque). L'utilisateur charge alors une page sur un autre site, construite de manière malveillante. Cette page envoie une requête HTTP vers le site web ciblé : la requête présente un intérêt particulier (par exemple, le transfert d'argent vers l'attaqueur). Le site ciblé permet la requête car il pense que puisque l'utilisateur est connecté au site, elle est faite par l'utilisateur.</p> -<p>Dans le cas d'une attaque de connexion CSRF, l'utilisateur charge une page construite de manière malveillante qui connecte l'utilisateur sur le site ciblé, mais <strong>en tant que l'attaquant</strong> : le site ciblé dépose alors un cookie de session dans le navigateur de l'utilisateur. L'attaquant peut accéder au compte plus tard, et récupérer les informations que le site a collectées sur l'utilisateur.</p> -<h3 id="Protection_contre_CSRF_jetons_CSRF_déclinés_à_partir_de_l'identifiant_de_session">Protection contre CSRF : jetons CSRF déclinés à partir de l'identifiant de session</h3> -<p>Une protection courante contre les attaques normales CSRF consiste pour les sites web de générer un jeton à partir de l'identifiant de session de l'utilisateur, et l'inclure dans les pages qu'ils servent : ensuite les requêtes POST doivent inclure ce jeton, qui est vérifié par le serveur. Ceci veut dire que les requêtes POST ne peuvent pas être faites depuis d'autres domaines, car ils ne peuvent pas accéder au jeton utilisé pour la vérification.</p> -<p>Avec les attaques de <strong>connexion</strong> CSRF, bien sûr, l'utilisateur n'est pas encore connecté au site web. Donc le site prépare une première session dès que l'utilisateur visite une page. Elle est utilisée pour générer le jeton CSRF jusqu'à ce que l'utilisateur se connecte. Une fois l'utilisateur connecté, un nouvel identifiant de session est généré, et un jeton CSRF est regénéré.</p> -<h3 id="Le_problème_avec_Persona">Le problème avec Persona</h3> -<p>Le problème avec Persona survient quand l'utilisateur n'est pas encore identifié, et a des pages de votre site web dans deux différents onglets, A et B. Les pages contiennent le même jeton CSRF, généré à partir de l'identifiant de la première session. Ensuite l'utilisateur se connecte dans l'onglet A, et le site genère un nouvel identifiant de session, et de par le fait, un nouveau jeton CSRF. Mais l'onglet B a toujours l'ancienne page de chargée, contenant l'ancien jeton, maintenant invalide.</p> -<p>Dans des circonstances ordinaires cela n'aurait pas d'importance : dès que l'onglet B recharge la page, ou que l'utilisateur navigue sur une nouvelle page, le jeton CSRF inclus est mis à jour. Mais lorsque Persona a généré une assertion en réponse à un appel à <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a>, Persona appelle <code>onlogin</code> pour chaque onglet qui a chargé le site Web, et pas seulement pour celui qui a réclamé l'assertion. Dès l'appel du gestionnaire <code>onlogin</code> sur l'onglet B, il essaie d'envoyer en POST l'assertion vers le serveur qui utilise l'ancien jeton CSRF — et le serveur lance alors une erreur CSRF.</p> -<h3 id="La_solution">La solution</h3> -<p>La solution consiste pour le gestionnaire de <code>onlogin</code> à envoyer une requête GET qui réclame un nouveau jeton CSRF et vérifie que l'utilisateur est déjà identifié. Si l'utilisateur est bien identifié, le gestionnaire n'a plus qu'à recharger la page. Sinon il utilise le nouveau jeton CSRF pour envoyer l'assertion en POST au serveur.</p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/supporter_utilisateurs_sans_javascript/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/supporter_utilisateurs_sans_javascript/index.html deleted file mode 100644 index 429975768b..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/supporter_utilisateurs_sans_javascript/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Supporter les utilisateurs sans JavaScript -slug: >- - Archive/Mozilla/Persona/The_implementor_s_guide/supporter_utilisateurs_sans_javascript -tags: - - Persona -translation_of: >- - Archive/Mozilla/Persona/The_implementor_s_guide/Supporting_users_without_JavaScript ---- -<p>Persona <a href="/en-US/Persona/FAQ#Why_does_Persona_require_JavaScript.3F">requiert actuellement JavaScript</a>. Si vous avez besoin de supporter les utilisateurs qui n'ont pas JavaScript activé, il vous faudra implémenter un système de connexion alternatif pour ces utilisateurs, et désactiver le bouton "Se connecter avec Persona", en l'activant avec le code JavaScript qui associe le bouton avec <a href="/fr/docs/Web/API/Navigator/id/request" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>navigator.id.request()</code></a>.</p> diff --git a/files/fr/archive/mozilla/persona/the_implementor_s_guide/tester/index.html b/files/fr/archive/mozilla/persona/the_implementor_s_guide/tester/index.html deleted file mode 100644 index cc9db5711b..0000000000 --- a/files/fr/archive/mozilla/persona/the_implementor_s_guide/tester/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Tester -slug: Archive/Mozilla/Persona/The_implementor_s_guide/tester -tags: - - Persona -translation_of: Archive/Mozilla/Persona/The_implementor_s_guide/Testing ---- -<p>Si vous développez un système pour la production, vous aurez sûrement besoin d'écrire des tests d'intégration qui simuleront l'identification par un utilisateur et sa déconnexion, en utilisant Persona.</p> -<p>Si vous utilisez <a href="http://docs.seleniumhq.org/" title="http://docs.seleniumhq.org/">Selenium</a> pour tester, considérez l'utilisation de la bibliothèque <a href="https://github.com/mozilla/bidpom" title="https://github.com/mozilla/bidpom">bidpom</a>. Les sites <a href="https://mockmyid.com/" title="https://mockmyid.com/">mockmyid.com</a> et <a href="http://personatestuser.org" title="http://personatestuser.org">personatestuser.org</a> peuvent aussi être utiles.</p> -<p>Vous voudrez aussi peut-être regarder <a href="http://toolness.github.io/stubbyid/" title="http://toolness.github.io/stubbyid/">stubbyid</a>.</p> diff --git a/files/fr/archive/mozilla/persona/vue_densemble_du_protocole/index.html b/files/fr/archive/mozilla/persona/vue_densemble_du_protocole/index.html deleted file mode 100644 index 2b14af2b69..0000000000 --- a/files/fr/archive/mozilla/persona/vue_densemble_du_protocole/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Vue d'ensemble du protocole -slug: Archive/Mozilla/Persona/vue_densemble_du_protocole -translation_of: Archive/Mozilla/Persona/Protocol_Overview ---- -<p>Persona est construit sur le protocole BrowserID. Cette page décrit le fonctionnement haut niveau de BrowserID.</p> -<h2 id="Acteurs">Acteurs</h2> -<p>Le protocole implique trois acteurs:</p> -<ul> - <li><strong>Les utilisateurs :</strong> Les personnes voulant se connecter a des sites web en utilisant Persona.</li> - <li><strong>Relying Parties (RPs): </strong>Les sites web autorisant la connexion avec Persona.</li> - <li><strong>Fournisseur d</strong>'<strong>identite (IdPs): </strong>Domains that can issue Persona-compatible identity certificates to their users.</li> -</ul> -<p>Persona et le protocole BrowserID utilisent les adresses e-mail comme identifiant, il est donc naturel que les fournisseurs d'e-mail deviennent des IdPs.</p> -<p>Mozilla intervient en tant qu'IdP par défaut pour que les utilisateurs puissent utiliser n'importe quelle adresse e-mail, même si son fournisseur n'est pas un IdP.</p> -<h2 id="Étapes_du_protocole">Étapes du protocole</h2> -<p>Il y a trois étapes distinctes dans le protocole :</p> -<ol> - <li>Fourniture du certificat de l'utilisateur</li> - <li>Génération de l'assertion</li> - <li>Vérification de l'assertion</li> -</ol> -<p>Comme prérequis, l'utilisateur doit avoir une adresse e-mail active qu'il souhaite utiliser pour se connecter. Le protocole ne requière pas que le fournisseur d'identité soit un routeur SMTP, mais il requière que l'identité soit au format <code>utilisateur@domaine</code>.</p> -<h3 id="Fourniture_du_certificat_de_l'utilisateur">Fourniture du certificat de l'utilisateur</h3> -<p>Pour se connecter à un site, un utilisateur doit prouver qu'il est le propriétaire de l'e-mail. La base de cette preuve est un certificat signé et chiffré fourni par l'IdP attestant le lien entre le navigateur d'un utilisateur et une identité donnée par l'IdP.</p> -<p>Comme Persona utilise les techniques standard de <a href="https://fr.wikipedia.org/wiki/Cryptographie_asym%C3%A9trique" title="https://fr.wikipedia.org/wiki/Cryptographie_asym%C3%A9trique">cryptographie par clef publique</a>, le certificat de l'utilisateur est signé avec la clef privée de l'IdP et contient :</p> -<ul> - <li>L'adresse e-mail de l'utilisateur.</li> - <li>La clef publique de l'utilisateur pour cette adresse sur ce navigateur.</li> - <li>La date où le certificat a été publié.</li> - <li>La date où le certificat expire.</li> - <li>Le nom de domaine de l'IdP.</li> -</ul> -<p>Le navigateur de l'utilisateur génére une paire de clef différente pour chaque adresse de l'utilisateur, et ces paires ne sont pas partagées entre les navigateurs. En conséquence, un utilisateur doit obtenir un nouveau certificat à chaque fois qu'un expire, ou à chaque fois qu'il utilise un nouveau navigateur ou ordinateur. Les certificats doivent expirer dans les 24h après leur emission.</p> -<p>Quand un utilisateur séléctionne une identité à utiliser quand il se connécte a un site, le navigateur vérifie s'il a un certificat valide pour cette identité. Si c'est le cas, l'étape est terminée et la navigation continue avec l'étape d'après : la génération de l'assertion. Si le navigateur n'a pas de certificat valide, il essaye d'en obtenir un du domaine associé avec l'identité choisie.</p> -<ol> - <li>Le navigateur va chercher le document de support <a href="/en-US/docs/Persona/.well-known-browserid" title="/en-US/docs/Persona/.well-known-browserid">/.well-known/browserid</a> par SSL depuis le domaine de l'identité.</li> - <li>Avec les informations du document, le navigateur transmet l'adresse e-mail de l'utilisateur et la clef publique associée au fournisseur d'identité et demande un certificat signé.</li> - <li>Si nécessaire, l'utilisateur est invité à se connecter chez le fournisseur avant la fourniture du certificat.</li> - <li>Le fournissseur crée, signe et donne le certificat de l'utilisateur au navigateur de l'utilisateur.</li> -</ol> -<p>Le certificat en main, le navigateur peut continuer avec la génération de l'assertion et la connexion au site.</p> -<p><img alt="user-certificate-provisioning.png" class="internal default" src="/@api/deki/files/6043/=user-certificate-provisioning.png"></p> -<h3 id="Génération_de_l'assertion">Génération de l'assertion</h3> -<p>Le certificat de l'utilisateur établie un lien vérifiable entre une adresse e-mail et une clef publique. Cependant, seul, ce n'est pas suffisant pour se connecter à un site web : l'utilisateur doit encore monter son lien avec le certificat en prouvant sa possession de la clef privée.</p> -<p>Pour cela, le navigateur de l'utilisateur crée et signe un nouveau document appelé "assertion de l'identité". Il contient :</p> -<ul> - <li>Le domaine du site où l'utilisateur veut se connecter.</li> - <li>Une date d'expiration de l'assertion, généralement moins de 5 minutes après sa création.</li> -</ul> -<p>Le navigateur présente alors à la fois le certificat de l'utilisateur et l'assertion de l'identité au site web pour la vérification.</p> -<h3 id="Vérification_de_l'assertion">Vérification de l'assertion</h3> -<p>La combinaison du certificat et de l'assertion est suffisante pour confirmer l'identité d'un utilisateur.</p> -<p>D'abord, le site vérifie le domaine et la date d'expiration dans l'assertion. Si l'assertion est expirée ou destinée a un domaine different, elle est rejetée. Cela évite la réutilisation malicieuse de l'assertion</p> -<p>Ensuite, le site valide la signature de l'assertion avec la clef publique de l'utilisateur contenu dans le certificat. Si la clef et la signature correspondent, le site est assuré que l'utilisateur posséde vraiment la clef associée au certificat.</p> -<p>En dernier, le site va chercher la clef publique du fournisseur depuis son document <a href="/en-US/docs/Persona/.well-known-browserid" title="/en-US/docs/Persona/.well-known-browserid">/.well-known/browserid</a> et verifie qu'il correspond a la signature du certificat de l'utilisateur. Si c'est le cas, le site peut etre certain que le certificat a vraiment ete issue du domaine en question.</p> -<p>Une fois cela vérifié, this is a current login attempt for the proper RP, that the user certificate matches the current user, and that the user certificate is legitimate, the RP is done and can authenticate the user as the identity contained in the certificate.</p> -<p><img alt="assertion-generation-and-verify.png" class="internal default" src="/@api/deki/files/6042/=assertion-generation-and-verify.png"></p> -<h2 id="The_Persona_Fallback_IdP">The Persona Fallback IdP</h2> -<p>What if a user's email provider doesn't support Persona? In that case, the provisioning step would fail. By convention, the user's browser handles this by asking a trusted third party, <a href="https://login.persona.org/" title="https://login.persona.org/">https://login.persona.org/</a>, to certify the user's identity on behalf of the unsupported domain. After demonstrating ownership of the address, the user would then receive a certificate issued by the fallback IdP, <code>login.persona.org</code>, rather than the identity's domain.</p> -<p>RPs follow a similar process when validating the assertion: the RP would ultimately request the fallback IdP's public key in order to verify the certificate.</p> diff --git a/files/fr/archive/mozilla/when_to_use_ifdefs/index.html b/files/fr/archive/mozilla/when_to_use_ifdefs/index.html deleted file mode 100644 index d0c04f0367..0000000000 --- a/files/fr/archive/mozilla/when_to_use_ifdefs/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Quand utiliser les "ifdefs" ? -slug: Archive/Mozilla/When_To_Use_ifdefs -translation_of: Archive/Mozilla/When_To_Use_ifdefs ---- -<p>La base du code Mozilla est utilisée dans de nombreux projets et produits, incluant Firefox, Thunderbird, XULRunner et bien d'autres. Ce code de base est parfois utilisé dans plusieurs projets mais des différences dans certains endroits sont parfois nécessaires. Les "ifdefs", ou instructions conditionnelles, sont alors utilisées pour obtenir un code différent.</p> -<h3 id="What_are_ifdefs" name="What_are_ifdefs">Qu'est-ce qu'un "ifdef" ?</h3> -<p><span style="line-height: inherit;">Un "ifdef" est une directive de compilation conditionnelle pour le préprocesseur qui permet de sélectionner certains bouts de code lorsque certaines conditions sont remplies. Dans ce document, le terme est utilisé en vrac pour désigner n'importe quel type de conditions qui permettent de générer différentes configurations.</span></p> -<h3 id="When_are_ifdefs_used.3F" name="When_are_ifdefs_used.3F">Quand les "ifdefs" sont utilisés ?</h3> -<p><span style="font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'DejaVu Sans', Lucida, Arial, Helvetica, sans-serif; font-size: 14px; font-weight: normal; line-height: inherit;">Il existe 3 principaux cas d'utilisations dans l'arborescence de Mozilla : les ifdefs pour la partie "platform/widget"</span><span style="font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'DejaVu Sans', Lucida, Arial, Helvetica, sans-serif; font-size: 14px; font-weight: normal; line-height: inherit;">, les ifdefs définissant certaines fonctionnalités et les ifdefs spécifiques à une application:</span></p> -<h4 id="Platform.2Fwidget_ifdefs" name="Platform.2Fwidget_ifdefs">ifdefs pour "Platform/widget"</h4> -<p>Le code dans Mozilla aura fréquemment besoin d'être différent pour certaines plateformes et widgets. Ces ifdefs sont pour la plupart acceptés. La seule fois où ils peuvent poser problèmes est lorsque l'on a du code d'une extension multi-plateforme ou pour la localisation: étant donné que ces codes sont téléchargés à travers plusieurs plateformes, les ifdefs spécifiques à une seule plateforme sont interdits.</p> -<p>Pour un exemple d'ifdef spécifique à une plateforme, voir <a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/xpcom/ds/nsCRT.h&rev=3.72&mark=48-61#46" style="line-height: inherit;">nsCRT.h</a><span style="line-height: inherit;">.</span></p> -<h4 id="Feature_ifdefs" name="Feature_ifdefs">ifdefs pour les fonctionnalités (ou "feature")</h4> -<p>Le code dans Mozilla contient beaucoup de fonctionnalités pouvant être activées/désactivées via des flags dans un fichier configure. Par exemple, il est possible de désactiver une grande partie du moteur de rendu de XUL en spécifiant <code>--disable-xul </code>quand on crée une configuration pour un build. Quand on ajoute des ifdefs qui implémente ces flags de configuration, une grande attention doit être portée sur les <strong>dépendances de construction</strong> (<em>build dependencies</em>). Par exemple, XPCOM, le moteur Javascript SpiderMonkey et le moteur réseau ne connaissent rien de XUL et ne devraient avoir aucun ifdefs basé sur <code>--disable-xul</code>.</p> -<p>Un ifdef spécial mérite votre attention : "MOZ_XUL_APP". Cette variable permet de "marquer" toutes applications utilisant le "toolkit". Les ifdefs sur MOZ_XUL_APP ne sont pas acceptables pour le <a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/Makefile.in&rev=1.291&mark=146-208#144">tier 9</a>, mais sont tolérés (et parfois même indispensable) pour les tiers suivants.</p> -<p>Pour un exemple d'ifdef gérant des caractéristiques, voir<span style="line-height: inherit;"> </span><a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/layout/Makefile.in&rev=1.22&mark=57-59,61-63,65-67#55" style="line-height: inherit;">layout/Makefile.in</a><span style="line-height: inherit;">.</span></p> -<h4 id="Application-specific_ifdefs" name="Application-specific_ifdefs">ifdefs spécifiques aux applications</h4> -<p>Pour finir, chaque application/projet a besoin de générer différents morceaux de code. <strong>Les ifdefs liés à une application ne devraient se trouver que dans du code spécifique à cette application</strong>. C'est le ifdef le plus délicat à placer car il est souvent difficile de savoir quel code est partagé et quel code est spécifique à une application. En règle général, tout code dans le <b><a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/Makefile.in&rev=1.291&mark=132-144#130">tier 2</a>, <a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/Makefile.in&rev=1.291&mark=146-208#144">tier 9</a>, ou <a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/Makefile.in&rev=1.291&mark=210-301#208">tier 50</a></b> est du code partagé et ne devrait pas contenir d'ifdef spécifique à une application. N'importe quel code dans les tiers suivants est spécifique à une application. Cette règle comporte de nombreuses exceptions dont certaines sont listées ici :</p> -<ul> - <li>Le code dans <code>editor/ui/</code> est généré pour la suite et la version standalone de l'éditeur de texte Mozilla composer ainsi que pour thunderbird mais il est considéré comme étant du code spécifique à une application (<em>application-specific</em>).</li> - <li>Le code dans <code>xpfe/</code> (excepté pour <code>xpfe/appshell/</code> et <code>xpfe/components/shistory/</code>) est un mélange de code "toolkit" et "application-specific". Ce code est destiné à être déplacé ailleurs (la plupart dans <code>toolkit/</code> ou <code>suite/</code>), mais pour le moment la plupart des ifdefs spécifique à une application sont autorisés car la situation est difficile à changer. Si vous souhaitez plus de détails, demander à <a>Benjamin Smedberg</a>.</li> -</ul> -<p>Pour un exemple d'ifdef spécifique à une application mauvais et qui devrait être supprimé, voir <a class="external" href="http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/toolkit/xre/nsNativeAppSupportWin.cpp&rev=1.19&mark=687-694#684" style="line-height: inherit;">nsNativeAppSupportWin.cpp</a><span style="line-height: inherit;">.</span></p> -<h3 id="Types_of_ifdef" name="Types_of_ifdef">Types d'<em>ifdef</em></h3> -<p>Il existe deux grands types d'ifdef : les ifdef pour le préprocesseur et les ifdefs pour le Makefile. Les ifdefs pour le préprocesseur sont généralement facile à repérer: dans du code C, C++ on les trouve avec des instructions comme #ifdef ou #if.</p> -<p>Les ifdefs dans un Makefile sont cependant plus dur à repérer et peuvent indirectement provoquer des erreurs ce qui est bien plus grave. Les ifdefs d'un Makefile sont utilisés pour construire ou non certains répertoires. Cela signifie qu'il existe des interfaces complètement différentes mais portant le même nom qui sont construites via des conditions. Par exemple (au moment de la rédaction), il existe 2 interfaces <span style="line-height: inherit;">nsIExtensionManager : {{ Source("toolkit/mozapps/extensions/public/nsIExtensionManager.idl", "toolkit version") }} et {{ Source("xpfe/components/extensions/public/nsIExtensionManager.idl", "suite version") }}. Les ifdefs du Makefile qui choisissent l'un ou l'autre ne sont pas évidents à trouver (voir {{ Source("Makefile.in") }} et {{ Source("xpfe/components/Makefile.in") }}).</span></p> -<p>Si vous introduisez un quelconque ifdef dans un makefile, veuillez demander une revue de votre code à un des mainteneurs du "build-config": <a href="/User:Benjamin_Smedberg" title="/User:Benjamin_Smedberg"><span style="line-height: inherit;">Benjamin Smedberg</span></a><span style="line-height: inherit;"> sera généralement ravi de vérifier vos changements.</span></p> diff --git a/files/fr/archive/mozilla/xbl/index.html b/files/fr/archive/mozilla/xbl/index.html deleted file mode 100644 index 126b055462..0000000000 --- a/files/fr/archive/mozilla/xbl/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: XBL -slug: Archive/Mozilla/XBL -tags: - - XBL -translation_of: Archive/Mozilla/XBL ---- -<p> -<b>XML Binding Language</b> (<b>XBL</b>, parfois aussi appelé langage de liaison extensible) est un langage permettant de décrire des liaisons pouvant être attachées à des éléments dans d'autres documents. L'élément auquel la liaison est attachée, appelé l'élément lié (<i>bound element</i>), acquiert le nouveau comportement spécifié par la liaison. -</p><p>Les liaisons peuvent contenir des gestionnaires d'évènements enregistrés sur l'élément lié, une implémentation de nouvelles méthodes et propriétés devenant accessibles depuis cet élément, et du contenu anonyme qui sera inséré par dessous l'élément lié. -</p><p>La plupart des éléments d'interface <a href="fr/XUL">XUL</a> sont au moins partiellement implémentés à l'aide de XBL. Vous pouvez construire vos propres éléments réutilisables à partir d'éléments <a href="fr/XUL">XUL</a>, <a href="fr/HTML">HTML</a>, <a href="fr/SVG">SVG</a>, et d'autres primitives à l'aide de XBL. -</p> -<h3 id="Spécifications"> Spécifications </h3> -<ul><li> XBL 1.0 est spécifié dans la <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0">Référence XBL 1.0</a>. Malheureusement, l'implémentation actuelle dans Mozilla diffère de la spécification, et il n'y a pas de document connu décrivant les différences. Il est à espérer que la référence sera mise à jour pour décrire ces différences.<br>XBL 1.0 est une technologie spécifique à Mozilla, et n'est pas un standard du <a class="external" href="http://w3.org/">W3C</a>. Cependant, au moins deux standards sont en cours d'élaboration : sXBL et XBL 2.0. -</li><li> <a class="external" href="http://w3.org/TR/sXBL/">sXBL</a> du W3C (actuellement un brouillon de travail daté de 2005) signifie <i>SVG's XML Binding Language</i> (langage de liaisons XML pour SVG). Il est supposé inclure un sous-ensemble des fonctionnalités de XBL 2.0 nécessaires à <a href="fr/SVG">SVG</a>. Il est similaire dans l'esprit au XBL de Mozilla, mais il y a quelques différences subtiles (et d'autres moins). Par exemple, les noms des éléments sont différents. Certaines fonctionnalités de XBL sont également absentes de sXBL, comme l'héritage des liaisons et la définition de méthodes/propriétés sur les éléments liés. -</li><li> <a class="external" href="http://www.mozilla.org/projects/xbl/xbl2.html">XBL 2.0</a> (<a class="external" href="http://w3.org/TR/XBL/">brouillon de travail du W3C</a>) est en cours de développement pour résoudre des problèmes découverts dans XBL 1.0 et pour permettre des implémentations dans un plus grand ensemble de navigateurs Web. Mozilla envisage d'implémenter XBL2 dans les futures versions de <a href="fr/Gecko">Gecko</a>. -</li></ul> -<p>Certaines des différences entre sXBL et XBL2 ont été relevées dans <a class="external" href="http://annevankesteren.nl/2005/11/xbl">un article d'Anne van Kesteren</a> (en anglais). -</p><p>Une présentation des différences entre le XBL de Mozilla et XBL2 est disponible dans <a class="external" href="http://groups.google.com/group/mozilla.dev.tech.xbl/msg/af3d4e37cce1d907">ce message de Jonas Sicking</a> (avril 2007). -</p> -<h3 id="Voir_aussi"> Voir aussi </h3> -<ul><li> <a href="fr/Tutoriel_XUL/Introduction_%c3%a0_XBL">Introduction à XBL</a> dans le <a href="fr/Tutoriel_XUL">Tutoriel XUL</a>. -</li><li> Le <a class="external" href="http://mb.eschew.org/15.php">chapitre XBL</a> de « <a class="external" href="http://mb.eschew.org/">Rapid Application Development with Mozilla</a> » -</li><li> <a class="external" href="http://www.w3.org/TR/xbl-primer/">XBL 2.0 Primer (en)</a> (brouillon) -</li><li> <a>Plus de ressources sur XBL…</a> -</li></ul> -<h3 id="Communauté"> Communauté </h3> -<ul><li> Voir les forums Mozilla… -</li></ul> -<p></p><ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-xbl"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xbl"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xbl/feeds"> Flux de syndication</a></li> -</ul> -<p></p> diff --git a/files/fr/archive/mozilla/xbl/référence_xbl_1.0/index.html b/files/fr/archive/mozilla/xbl/référence_xbl_1.0/index.html deleted file mode 100644 index 19f7e528e9..0000000000 --- a/files/fr/archive/mozilla/xbl/référence_xbl_1.0/index.html +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: Référence XBL 1.0 -slug: Archive/Mozilla/XBL/Référence_XBL_1.0 -tags: - - XBL -translation_of: Archive/Mozilla/XBL/XBL_1.0_Reference ---- -<p> -</p> -<h3 id="Résumé"> Résumé </h3> -<p>Ce document décrit le langage de liaison extensible (Extensible Binding Language, <a href="fr/XBL">XBL</a>) 1.0 tel qu'implémenté dans les navigateurs basés sur <a href="fr/Gecko">Gecko</a>. -</p><p>XBL est un langage de balisage basé sur <a href="fr/XML">XML</a> pour implémenter des composants réutilisables (liaisons ou <i>bindings</i>) qui peuvent être liés à des éléments d'autres documents. L'élément pour lequel une liaison a été spécifiée, appelé l'élément lié ou <i>bound element</i>, reçoit un nouveau comportement spécifié par la liaison. Les liaisons peuvent être liées à des éléments à l'aide de feuilles de style en cascade (<a href="fr/CSS">CSS</a>) ou via le <a href="fr/DOM">DOM</a>. Un élément peut être lié à plusieurs liaisons différentes en même temps. </p><p>Fonctionnellement, les liaisons XBL peuvent être comparées avec les fonctionnalités <a class="external" href="http://msdn.microsoft.com/workshop/components/htc/reference/htcref.asp">Behaviors</a> et <a class="external" href="http://msdn.microsoft.com/workshop/author/behaviors/overview/viewlink_ovw.asp">Viewlink</a> de Microsoft, mais implémentées comme une solution XML intégrée. -</p><p>Les liaisons peuvent contenir des gestionnaires d'évènements enregistrées sur l'élément lié, une implémentation de nouvelles méthodes et propriétés qui deviennent accessibles depuis celui-ci, et du contenu anonyme à insérer autour de cet élément. -</p> -<div class="note"> -<p>Différents ajustements dans l'implémentation actuelle ont été faits depuis les <a class="external" href="http://www.w3.org/TR/xbl/">propositions XBL plus anciennes</a>, et tous ne sont pas encore reflétés dans ce document. Le processus de documentation est toujours en cours : gardez cela à l'esprit lorsque vous utilisez les informations fournies. -</p> -</div> -<h3 id="Éléments_XBL"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments">Éléments XBL</a> </h3> -<p>Les éléments XBL 1.0 sont dans l'espace de noms <code><span class="nowiki">http://www.mozilla.org/xbl</span></code>. -</p> -<ul><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#bindings">bindings</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#binding">binding</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#_content">content</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#children">children</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#implementation">implementation</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#constructor">constructor</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#destructor">destructor</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#field">field</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#property">property</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#getter">getter</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#setter">setter</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#method">method</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#parameter">parameter</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#body">body</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#handlers">handlers</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#handler">handler</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#resources">resources</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#stylesheet">stylesheet</a></code> -</li><li> <code><a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/%c3%89l%c3%a9ments#image">image</a></code> -</li></ul> -<h3 id="Attachement_et_détachement_de_liaisons"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons">Attachement et détachement de liaisons</a> </h3> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons#Attachement_avec_CSS">Attachement avec CSS</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons#Attachement_avec_la_propri.C3.A9t.C3.A9_element.style">Attachement avec la propriété element.style</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons#Appel_de_.3Cconstructor.3E">Appel de <constructor></a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons#Appel_de_.3Cdestructor.3E">Appel de <destructor></a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Attachement_et_d%c3%a9tachement_de_liaisons#Documents_de_liaison">Documents de liaison</a> -</li></ul> -<h3 id="Interfaces_DOM"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Interfaces_DOM">Interfaces DOM</a> </h3> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Interfaces_DOM#L.27interface_DocumentXBL">L'interface DocumentXBL</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Interfaces_DOM#L.27interface_ElementXBL">L'interface ElementXBL</a> -</li></ul> -<h3 id="Contenu_anonyme"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme">Contenu anonyme</a> </h3> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Introduction">Introduction</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Visibilit.C3.A9_et_acc.C3.A8s_depuis_le_DOM">Visibilité et accès depuis le DOM</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#G.C3.A9n.C3.A9ration_de_contenu">Génération de contenu</a> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#R.C3.A8gles_de_g.C3.A9n.C3.A9ration">Règles de génération</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#L.27.C3.A9v.C3.A8nement_contentgenerated">L'évènement contentgenerated</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#L.27.C3.A9v.C3.A8nement_contentdestroyed">L'évènement contentdestroyed</a> -</li></ul> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Redirection_d.27attribut">Redirection d'attribut</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Points_d.27insertion">Points d'insertion</a> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#.3Cchildren.3E_et_.3Celement.3E"><children> et <element></a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Gestion_des_changements_du_DOM">Gestion des changements du DOM</a> -</li></ul> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Flux_et_ciblage_des_.C3.A9v.C3.A8nements">Flux et ciblage des évènements</a> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Flux_et_ciblage_au_travers_des_visibilit.C3.A9s">Flux et ciblage au travers des visibilités</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#.C3.89v.C3.A8nements_Focus_et_Blur">Évènements Focus et Blur</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#.C3.89v.C3.A8nements_Mouseover_et_Mouseout">Évènements Mouseover et Mouseout</a> -</li></ul> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Contenu_anonyme_et_CSS">Contenu anonyme et CSS</a> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#S.C3.A9lecteurs_et_visibilit.C3.A9">Sélecteurs et visibilité</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Contenu_anonyme#Liaison_de_feuilles_de_style">Liaison de feuilles de style</a> -</li></ul> -</li></ul> -<h3 id="Implémentations_de_liaisons"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Impl%c3%a9mentations_de_liaisons">Implémentations de liaisons</a> </h3> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Impl%c3%a9mentations_de_liaisons#Introduction">Introduction</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Impl%c3%a9mentations_de_liaisons#M.C3.A9thodes">Méthodes</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Impl%c3%a9mentations_de_liaisons#Propri.C3.A9t.C3.A9s">Propriétés</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Impl%c3%a9mentations_de_liaisons#H.C3.A9ritage_d.27impl.C3.A9mentations">Héritage d'implémentations</a> -</li></ul> -<h3 id="Gestionnaires_d'évènements"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Gestionnaires_d'%c3%a9v%c3%a8nements">Gestionnaires d'évènements</a> </h3> -<h3 id="Exemple_-_Notes"> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Exemple_-_Notes">Exemple - Notes</a> </h3> -<p>Mis à jour et ajusté pour l'implémentation actuelle de Firefox. -</p> -<div class="note"> -<p>Cet exemple est destiné à montrer l'utilisation de XBL plutôt que pour être une application utile en pratique. Pour cette raison, il contient de nombreux commentaires et certains blocs qui auraient pu être évités dans une solution plus compacte mais sont utilisés ici à des fins de démonstration. -</p> -</div> -<ul><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Exemple_-_Notes#notes.html">notes.html</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Exemple_-_Notes#notes.xml">notes.xml</a> -</li><li> <a href="fr/XBL/R%c3%a9f%c3%a9rence_XBL_1.0/Exemple_-_Notes#notes.css">notes.css</a> -</li></ul> -<p><a class="external" href="http://www.nskom.com/external/xbl/notes.html">Voir cet exemple</a> -</p><p><br> -<span class="comment"><a class="external" href="http://www.nskom.com/external/xbl/notes.zip" title="http://www.nskom.com/external/xbl/notes.zip">Téléchargement de tous les fichiers (archive .zip)</a> need to ask to adjust the server - it gives "Access denied" for zip files (?)</span> -</p> -<h3 id="Références"> Références </h3> -<ul><li> <a class="external" href="http://www.w3.org/TR/xbl/">Proposition initiale de XBL 1.0 soumise comme note au W3C</a> (en anglais, ne reflète pas l'implémentation actuelle dans Mozilla, ni les plans futurs) -</li><li> <a class="external" href="http://www.mozilla.org/projects/xbl/xbl2.html">Projet XBL 2.0</a> -</li></ul> -<div class="originaldocinfo"> -<h3 id="Informations_sur_le_document_original"> Informations sur le document original </h3> -<ul><li> Date de dernière mise à jour : le 24 avril 2006 -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xbl/référence_xbl_1.0/éléments/index.html b/files/fr/archive/mozilla/xbl/référence_xbl_1.0/éléments/index.html deleted file mode 100644 index fffa11dcf9..0000000000 --- a/files/fr/archive/mozilla/xbl/référence_xbl_1.0/éléments/index.html +++ /dev/null @@ -1,462 +0,0 @@ ---- -title: Éléments -slug: Archive/Mozilla/XBL/Référence_XBL_1.0/Éléments -translation_of: Archive/Mozilla/XBL/XBL_1.0_Reference/Elements ---- -<h3 id="bindings" name="bindings">bindings</h3> - -<p><span class="comment">Cette section est testée et ajustée selon l'implémentation courante de Firefox. Veuillez ne la modifier que si le comportement réel diffère de celui qui est décrit. Veuillez ne pas le faire seulement sur base d'une autre spécification XBL.</span></p> - -<pre><!ELEMENT bindings ( binding* ) > - -Hiérarchie : élément racine -Peut contenir : <binding> -</pre> - -<p>L'élément <code>bindings</code> est l'élément racine de tout document XBL. Il doit habituellement déclarer XBL en tant qu'espace de noms par défaut (à moins qu'un préfixe d'espaces de noms XBL soit utilisé) et peut également déclarer d'autres préfixes d'espace de noms utilisés dans votre liaison.</p> - -<p><code>bindings</code> contient zéro ou plus éléments <code><a href="/fr/XBL/Référence_XBL_1.0/Éléments#binding" title="fr/XBL/Référence_XBL_1.0/Éléments#binding">binding</a></code> comme enfants. Chaque élément <code><a href="/fr/XBL/Référence_XBL_1.0/Éléments#binding" title="fr/XBL/Référence_XBL_1.0/Éléments#binding">binding</a></code> enfant définit une liaison unique pouvant être attachée à des éléments dans d'autres documents.</p> - -<p>Un élément ne peut avoir qu'une liaison attachée (explicitement ou héritée) à un moment donné. Si plusieurs liaisons sont définies, seule la dernière de la séquence sera utilisée (comme avec toute règle CSS).</p> - -<p>helloworld.html :</p> - -<pre><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<html> -<head> -<title>Hello world!</title> -<style type="text/css"> -p { - -moz-binding: url(hello.xml#default); -} -#p03 { - -moz-binding: url(hello.xml#hello2); -} -</style> -</head> -<body> - - <p>Default content</p> - <p>Default content</p> - <p id="p03">Default content</p> - -</body> -</html> -</pre> - -<p>hello.xml :</p> - -<pre><?xml version="1.0"?> -<bindings xmlns="http://www.mozilla.org/xbl" - xmlns:html="http://www.w3.org/1999/xhtml"> - <binding id="default"> - <content><html:b>Hello world! </html:b><children/></content> - </binding> - <binding id="hello2"> - <content><html:b>Hello from my binding! </html:b><children/></content> - </binding> -</bindings> -</pre> - -<p>Vous pouvez voir le résultat en ouvrant <code>helloworld.html</code> dans Firefox. hello.xml doit se trouver dans le même répertoire que <code>helloworld.html</code>.</p> - -<p>Suivant : <code>bindings > élément <a href="/fr/XBL/Référence_XBL_1.0/Éléments#binding" title="fr/XBL/Référence_XBL_1.0/Éléments#binding">binding</a></code>.</p> - -<h4 id="Notes" name="Notes">Notes</h4> - -<ul> - <li>Dans les versions stables actuelles des produits Mozilla (par exemple Firefox 2), il est impossible d'attacher des liaisons à des sous-éléments de tableaux (lignes, cellules, etc.). Il n'est possible d'attacher des liaisons qu'à l'élément <code>table</code> lui-même. Cela a été corrigé dans les prochaines versions des produits Mozilla. Consultez le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=83830" title="FIXED: Binding TD cells (with XBL) doesn't work, at all">bug 83830</a> pour plus d'informations et des méthodes de contournement.</li> - <li>L'encodage par défaut des documents XML (dont les fichiers XBL) est l'UTF-8. Des déclarations explicites d'encodage peuvent être présentes pour écraser celui par défaut, par exemple <code><?xml version="1.0" encoding="ISO-8859-1"?></code>.</li> - <li>L'URI dans les déclarations d'espaces de noms (<code>namespace</code>) est une chaîne opaque utilisée uniquement pour identifier l'espace de noms de manière unique. Il n'est pas nécessaire (et souvent ce n'est pas le cas) qu'ils pointent vers un schéma réel ou une ressource liée à l'espace de noms. Voir la spécification <a class="external" href="http://www.w3.org/TR/REC-xml-names/#ns-decl">Namespaces in XML</a>.</li> - <li>Outre l'espace de noms par défaut, vous pouvez déclarer un nombre illimité d'autres espaces de noms pour gérer votre contenu. Les plus utiles sont sans doute HTML/XHTML, <a href="/fr/XUL" title="fr/XUL">XUL</a> (XML User Interface Language), <a href="/fr/SVG" title="fr/SVG">SVG</a> (Scalable Vector Graphics) et <a class="external" href="http://www.w3.org/TR/xlink/">XLink</a>. Ainsi, une déclaration plus ou moins universelle d'espaces de noms dans votre élément <code>bindings</code> pourrait ressembler à ceci :</li> -</ul> - -<pre><bindings xmlns="http://www.mozilla.org/xbl" - xmlns:html = "http://www.w3.org/1999/xhtml" - xmlns:xul = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" - xmlns:svg = "http://www.w3.org/2000/svg" - xmlns:xlink= "http://www.w3.org/1999/xlink"> -</pre> - -<h3 id="binding" name="binding">binding</h3> - -<pre><!ENTITY % binding-content "(resources?,content?,implementation?,handlers?)"> -<!ELEMENT binding %binding-content;> -<!ATTLIST binding - id ID #REQUIRED - extends CDATA #IMPLIED - display CDATA #IMPLIED - inheritstyle true #IMPLIED -> -</pre> - -<p>L'élément <code>binding</code> décrit une seule liaison XBL. Une liaison XBL peut ajouter du <em><a href="/fr/XBL/Référence_XBL_1.0/Éléments#_content" title="fr/XBL/Référence_XBL_1.0/Éléments#_content">contenu anonyme</a></em>, des <em><a href="/fr/XBL/Référence_XBL_1.0/Éléments#field" title="fr/XBL/Référence_XBL_1.0/Éléments#field">champs</a></em>, des <em><a href="/fr/XBL/Référence_XBL_1.0/Éléments#property" title="fr/XBL/Référence_XBL_1.0/Éléments#property">propriétés</a></em>, des <em><a href="/fr/XBL/Référence_XBL_1.0/Éléments#method" title="fr/XBL/Référence_XBL_1.0/Éléments#method">méthodes</a></em> et <em><a href="/fr/XBL/Référence_XBL_1.0/Éléments#handlers" title="fr/XBL/Référence_XBL_1.0/Éléments#handlers">des gestionnaires d'évènements</a></em> à des éléments HTML/XML.</p> - -<p>Une seule liaison XBL peut être attachée à un élément à l'aide de feuilles de style pour par script. (Consultez le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=83830" title="FIXED: Binding TD cells (with XBL) doesn't work, at all">bug 83830</a> pour les spécificités de <table>).</p> - -<p>CSS :</p> - -<pre>div { - -moz-binding: url(myBinding.xml#default); -} -</pre> - -<p>DOM :</p> - -<pre>elementReference.style.MozBinding = "url(myBinding.xml#default)"; -</pre> - -<p>Dans les deux cas qui précèdent, on utilise <code>binding</code> avec <code>id="default"</code> dans un fichier <code>myBinding.xml</code>.</p> - -<p> À partir de Firefox 3, il est également possible d'utiliser une URL <code>data:</code> pour intégrer la liaison directement :</p> - -<pre>div { - -moz-binding: url(data:text/xml;charset=utf-8,%3C%3Fxml%20version%3D%221.0%22%3F%3E%0A%3Cbindings%20id%3D%22xbltestBindings%22%20xmlns%3D%22http%3A//www.mozilla.org/xbl%22%3E%0A%20%20%3Cbinding%20id%3D%22xbltest%22%3E%3Ccontent%3EPASS%3C/content%3E%3C/binding%3E%0A%3C/bindings%3E%0A); -} -</pre> - -<p>Comme les URL <code>data:</code> ne gèrent pas les identifiants de fragments, la première liaison trouvée dans le XML intégré est utilisée à la place. N'oubliez pas que la liaison doit toujours avoir un ID même si on ne la référence pas. De plus, les URL <code>data:</code> ne sont gérées que depuis du code chrome (autrement dit, depuis l'application ou une extension).</p> - -<div class="blockIndicator note"><strong>Note :</strong> La politique de même origine est utilisée pour les sites web ; ils peuvent seulement lier des fichiers XBL du même domaine, ou dans le chrome.</div> - -<p>Pour des raisons de clarté, voici à quoi ressemble le XML intégré dans l'exemple qui précède :</p> - -<pre><?xml version="1.0"?> -<bindings id="xbltestBindings" xmlns="http://www.mozilla.org/xbl"> - <binding id="xbltest"><content>PASS</content></binding> -</bindings> -</pre> - -<p>La seule manière simple d'attacher des liaisons à tout ensemble d'éléments est d'utiliser des déclarations CSS. Cela permet également de rendre l'implémentation des liaisons partiellement fonctionnelle si le scripting est désactivé. Dans ce dernier cas, toutes les méthodes et tous les gestionnaires d'évènements seront bloqués, mais le contenu anonyme et les styles seront toujours utilisés. C'est pourquoi que les déclarations CSS doivent toujours être utilisées — à moins que vous deviez ajouter des liaisons en cours d'exécution à des éléments particuliers.</p> - -<p>Un élément <code>binding</code> peut contenur une balise <a href="/fr/XBL/Référence_XBL_1.0/Éléments#resources" title="fr/XBL/Référence_XBL_1.0/Éléments#resources">resources</a>, une balise <a href="/fr/XBL/Référence_XBL_1.0/Éléments#_content" title="fr/XBL/Référence_XBL_1.0/Éléments#_content">content</a>, une balise <a href="/fr/XBL/Référence_XBL_1.0/Éléments#implementation" title="fr/XBL/Référence_XBL_1.0/Éléments#implementation">implementation</a> et une balise <a href="/fr/XBL/Référence_XBL_1.0/Éléments#handlers" title="fr/XBL/Référence_XBL_1.0/Éléments#handlers">handlers</a>.</p> - -<ul> - <li><code><strong>id</strong></code> — L'attribut <code>id</code> est un identifiant unique dans le document. Pour l'élément <code>binding</code>, cet attribut est obligatoire, puisqu'il est utilisé pour attacher des liaisons.</li> - <li><code><strong>extends</strong></code> — L'attribut <code>extends</code> est utilisé pour spécifier l'URL d'une liaison dont cette liaison hérite (consultez <a href="/fr/XBL/Référence_XBL_1.0/Implémentations_de_liaisons#H.C3.A9ritage_d.27impl.C3.A9mentations" title="fr/XBL/Référence_XBL_1.0/Implémentations_de_liaisons#H.C3.A9ritage_d.27impl.C3.A9mentations">Héritage d'implémentations</a>). L'URL spécifie un document de liaison particulier. La notation # doit être utilisée pour pointer vers un <code>id</code> particulier au sein d'un document de liaison. Notez que le contenu ne peut pas être hérité, seulement le comportement.</li> - <li><code><strong>display</strong></code> — Cet attribut spécifie comment sera affichée la balise. En définissant cet attribut, vous pouvez donner à un élément les caractéristiques d'affichage et de positionnement d'un élément existant. Par exemple, utilisez la valeur « xul:button » pour créer un élément qui s'affichera comme un bouton. La partie précédant les deux points est un préfixe d'espace de noms, vous devrez donc égélement déclarer l'espace de noms XUL. Toutes les balises n'ont pas un type d'affichage unique. Les types d'affichage XUL suivant peuvent être utilisés : browser, button, checkbox, description, editor, grippy, iframe, image, label, menu, menuitem, menubar, progressmeter, radio, resizer, scrollbar, scrollbox, spacer, splitter, titlebar, treechildren et treecol. Vous pourriez également utiliser une série de balises HTML, MathML et SVG. L'attribut « display » ne fonctionne pas à mois que l'attribut <code>extends</code> soit défini, consultez le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=119389" title="display= doesn't work if extends= is not present">bug 119389</a>. Dans ce cas, mettre la valeur de l'attribut <code>display</code> dans l'attribut <code>extends</code>.</li> - <li><code><strong>inheritstyle</strong></code> — L'attribut <code>inheritstyle</code> indique si les règles de style du document affecteront le contenu anonyme généré par la liaison XBL. Si cet attribut est à <code>true</code>, les styles du document seront également appliqués au contenu anonyme généré par XBL.</li> -</ul> - -<p> </p> - -<h3 id="content" name="content">content</h3> - -<pre><!ELEMENT content ANY> -<!ATTLIST content - id ID #IMPLIED -> -</pre> - -<p>Une liaison peut spécifier du nouveau contenu qui sera placé à l'intérieur de l'élément lié. Bien que ce contenu soit visible à l'écran comme s'il était directement dans le fichier, il est anonyme et est invisible du <a href="/fr/DOM" title="fr/DOM">DOM</a> normal. Pour accéder à des nœuds anonymes sur un élément XBL lié, vous pouvez utiliser les fonctions <a href="/fr/XBL/Référence_XBL_1.0/Interfaces_DOM#getAnonymousElementByAttribute" title="fr/XBL/Référence_XBL_1.0/Interfaces_DOM#getAnonymousElementByAttribute">getAnonymousElementByAttribute</a> et <a href="/fr/XBL/Référence_XBL_1.0/Interfaces_DOM#getAnonymousNodes" title="fr/XBL/Référence_XBL_1.0/Interfaces_DOM#getAnonymousNodes">getAnonymousNodes</a>. Le seul élément XBL pouvant apparaître dans la balise <code>content</code> est l'élément <a href="/fr/XBL/Référence_XBL_1.0/Éléments#children" title="fr/XBL/Référence_XBL_1.0/Éléments#children">children</a>. Les attributs de l'élément <span class="nowiki"><content></span> dans la liaison sont définis sur l'élément lié.</p> - -<ul> - <li><code><strong>id</strong></code> — L'attribut id est un identifiant unique dans le document.</li> -</ul> - -<h3 id="children" name="children">children</h3> - -<pre><!ELEMENT children EMPTY> -<!ATTLIST children - id ID #IMPLIED - includes CDATA #IMPLIED -> -</pre> - -<p>Spécifie l'emplacement où les éventuels enfants de l'élément lié seront placés dans le contenu généré.</p> - -<p>Normalement, si l'élément lié a son propre contenu, le contenu anonyme n'est pas généré. Cependant, avec un élément <code>children</code>, il est possible de fusionner le contenu de l'élément HTML/XML avec le contenu XBL.</p> - -<p>Si la balise <code>children</code> a elle-même un contenu, celui-ci deviendra le contenu par défaut. Si l'élément auquel la liaison est attachée a du contenu, le contenu par défaut sera ignoré. Si l'élément n'a aucun contenu, le contenu par défaut sera ajouté.</p> - -<ul> - <li><code><strong>id</strong></code> — L'attribut <code>id</code> est un identifiant unique dans le document.</li> - <li><code><strong>includes</strong></code> — L'attribut <code>includes</code> peut être utilisé pour indiquer que seul un certain contenu doit être placé au point d'insertion spécifié par l'élément <code>children</code>. Sa valeur peut être un nom de balise ou plusieurs noms séparés par des virgules. (Avec xulrunner 1.9, il faut utiliser la barre verticale '|` comme séparateur et non pas une virgule.) Un enfant ne peut être placé au point d'insertion que s'il correspond à la valeur de l'attribut <code>includes</code>. Seuls les enfants immédiats sont comparés au sélecteur. Par exemple, pour un fragment XML <code><customElement><foobar><hoge/></foobar></customElement></code> avec une définition de liaison <code><binding id="customElement"><content><xul:box><children includes="hoge"/></xul:box></content></binding></code> pour l'élément <code>customElement</code>, <code><xul:box/></code> devient vide parce que le sélecteur <code>includes="hoge"</code> ne correspond pas à l'élément enfant direct <code>foobar</code>.</li> -</ul> - -<h3 id="implementation" name="implementation">implementation</h3> - -<pre><!ENTITY % implementation-content "(method|property)*"> -<!ELEMENT implementation %implementation-content;> -<!ATTLIST implementation - id ID #IMPLIED - name CDATA #IMPLIED - implements CDATA #IMPLIED -> -</pre> - -<p>The <code>implementation</code> element describes the set of methods and properties that are attached to the bound element. Once the binding is attached, these methods and properties can be invoked directly from the bound element.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>name</strong></code> — The <code>name</code> attribute can be used to provide a specific name for an implementation. This name can then be used to reference the implementation. For example, in JavaScript the value of this attribute represents the name of the corresponding class that is constructed for the implementation. If no name attribute is specified then the binding's document URI and id are used to uniquely reference the binding's implementation.</li> - <li><code><strong>implements</strong></code> — The <code>implements</code> attribute can be used to describe the set of interfaces that are implemented by the binding. Its value is a comma-separated list of named interfaces. If supported, in strongly typed languages the bound element can be referenced not only as any of the interfaces that the element might already support (e.g., HTMLElement) but also as any of the interfaces described by this attribute. Support of this capability is optional.</li> -</ul> - -<h3 id="constructor" name="constructor">constructor</h3> - -<p>The code inside the <code>constructor</code> is called when a <code>binding</code> has just been attached to an element. So full access to anonymous nodes generated by the binding is already possible. The <code>constructor</code> tag must be placed inside the <code>implementation</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<div class="note"><strong>Note:</strong> Prior to Firefox 3, the constructor could be called at a time when reflow of the document layout was locked down, so that attempting to get layout information from within the constructor could return out of date information. In Firefox 3 and later, the constructor is called when reflow can take place, which results in up-to-date information being returned. See <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=398404" title="FIXED: [FIX]Disallow reflow while processing constructors">bug 398404</a> for details.</div> - -<h3 id="destructor" name="destructor">destructor</h3> - -<p>The code inside the <code>destructor</code> is called when a <code>binding</code> is being removed from an element. You can use this to unload resources to free memory. However the <code>destructor</code> is often not called when it should, see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=230086" title="Destructor of XBL element isn't called when I remove this element from DOM">bug 230086</a>. The <code>destructor</code> tag must be placed inside the <code>implementation</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="method" name="method">method</h3> - -<pre><!ENTITY % method-content "(parameter*,body?)"> -<!ELEMENT method %method-content;> -<!ATTLIST method - id ID #IMPLIED - name CDATA #REQUIRED - type CDATA #IMPLIED -> -</pre> - -<p>The <code>method</code> element is used to describe a single method of a binding implementation.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>name</strong></code> — The <code>name</code> attribute's value is the name given to the method when it is attached to the bound element. The method can be invoked directly from the bound element using this value.</li> -</ul> - -<p><em>Example</em></p> - -<pre><method name="scrollTo"> - <parameter name="index"/> - <body> - this.setAttribute("scrollpos", index); - </body> -</method> -</pre> - -<h3 id="parameter" name="parameter">parameter</h3> - -<pre><!ELEMENT parameter EMPTY> -<!ATTLIST parameter - id ID #IMPLIED - name CDATA #REQUIRED -> -</pre> - -<p>The <code>parameter</code> element is used inside a <code>method</code> element. It represents a single parameter of a method.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>name</strong></code> — The value of the <code>name</code> attribute is used by script within a method's <code>body</code> element to reference this parameter.</li> -</ul> - -<h3 id="body" name="body">body</h3> - -<pre><!ELEMENT body CDATA> -<!ATTLIST body - id ID #IMPLIED -> -</pre> - -<p>The <code>body</code> element represents the implementation of its corresponding <code>method</code>. Its contents are the script that is executed when the method is invoked.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="field" name="field">field</h3> - -<pre><!ELEMENT field EMPTY> -<!ATTLIST field - id ID #IMPLIED - name CDATA #REQUIRED - readonly (true|false) #IMPLIED -> -</pre> - -<p>A field is similar to a <code><a href="/fr/XBL/Référence_XBL_1.0/Éléments#property" title="fr/XBL/Référence_XBL_1.0/Éléments#property">property</a></code>, except that it should not have a getter or setter. It is useful as a simple holder for a value. The field element must have content which is code that determines the initial value of the field. The <code>field</code> tag must be inside the <code>implementation</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>name</strong></code> — The name of the field. This is the name used to refer to the field on the bound element.</li> - <li><code><strong>readonly</strong></code> — If true, this field is read-only. If this attribute is omitted, the field will be readable and writable.</li> -</ul> - -<div class="note"><strong>Note:</strong> In Firefox 3, fields are now evaluated the first time they're accessed instead of at binding attachment time. This shouldn't cause any problems in typical use cases, but there are cases in which this will impact the behavior of your code. See <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=372769" title="FIXED: [FIX]<field> evaluation happens at an unsafe time">bug 372769</a> for details.</div> - -<p>Here are some examples of cases in which the behavior of your code may change due to this change in Firefox 3:</p> - -<ol> - <li>If you have two fields, one named <code>A</code> and one named <code>B</code>, and field <code>A</code> sets <code>.B</code>, the value of <code>.B</code> will depend on whether or not <code>.A</code> has already been accessed.</li> - <li>If a proto is inserted into the proto chain after binding instantiation, doing so may affect field values (this wasn't the case in prior versions of Firefox).</li> - <li>At binding attachment time, <code><span class="nowiki"><field name="parentNode">this.parentNode</field></span></code> is undefined instead of the value of <code>parentNode</code>.</li> - <li>A field no longer changes the value of a property set on the object itself (rather than a proto) before binding attachment.</li> -</ol> - -<h3 id="property" name="property">property</h3> - -<pre><!ENTITY % property-content "(getter?,setter?)"> -<!ELEMENT property %property-content;> -<!ATTLIST property - id ID #IMPLIED - name CDATA #REQUIRED - readonly (true|false) #IMPLIED - onget CDATA #IMPLIED - onset CDATA #IMPLIED -> -</pre> - -<p>The <code>property</code> element represents a single property of an implementation. A property consists of a pair of getter/setter functions that can be defined using <code>onget</code>/<code>onset</code> attributes or <a href="/fr/XBL/Référence_XBL_1.0/Éléments#getter" title="fr/XBL/Référence_XBL_1.0/Éléments#getter">getter</a>/<a href="/fr/XBL/Référence_XBL_1.0/Éléments#setter" title="fr/XBL/Référence_XBL_1.0/Éléments#setter">setter</a> elements underneath the <code>property</code> element. Like methods, once the binding is attached, the property can be obtained directly from the bound element. The <code>property</code> tag must be inside the <code>implementation</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>name</strong></code> — The name of the property. This is the name used to refer to the property on the bound element.</li> - <li><code><strong>readonly</strong></code> — The <code>readonly</code> attribute is used to designate a property as read-only. If set to <code>true</code>, the value of the property cannot be altered. If this attribute is omitted, the property will be readable and writable.</li> - <li><code><strong>onget</strong></code> — The <code>onget</code> attribute's value is a script that executes when the value of the property is requested. If this attribute is set, any initial value contained underneath the element will be ignored. The return value of the script represents the value of the property that will be returned to the requestor. A property getter can also be specified as a child of the <code>property</code> element using the <code>getter</code> tag.</li> - <li><code><strong>onset</strong></code> — The <code>onset</code> attribute's value is a script that executes when the value of the property is being altered. If this attribute is set, any initial value contained underneath the element will be ignored. Within the script, the parameter <code>val</code> represents the new value being assigned. A property setter can also be specified as a child of the <code>property</code> element using a <code>setter</code> tag.</li> -</ul> - -<h3 id="getter" name="getter">getter</h3> - -<pre><!ELEMENT getter PCDATA> -<!ATTLIST getter - id ID #IMPLIED -> -</pre> - -<p>The <code>getter</code> element contains script that gets executed when a specific property gets called. The <code>getter</code> tag must be inside the <code>property</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="setter" name="setter">setter</h3> - -<pre><!ELEMENT setter PCDATA> -<!ATTLIST setter - id ID #IMPLIED -> -</pre> - -<p>The <code>setter</code> element contains script that gets executed when a specific property is being set. The <code>setter</code> tag must be inside the <code>property</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="handlers" name="handlers">handlers</h3> - -<pre><!ENTITY % handlers-content "handler*"> -<!ELEMENT handlers %handlers-content;> -<!ATTLIST handlers - id ID #IMPLIED -> -</pre> - -<p>The <code>handlers</code> element contains event handlers that can be attached to elements within the bound document. These handlers are installed when the binding is attached and removed when the binding is detached. The <code>handlers</code> tag must be inside the <code>binding</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="handler" name="handler">handler</h3> - -<pre><!ENTITY % handler-content "PCDATA"> -<!ELEMENT handler %handler-content;> -<!ATTLIST handler - id ID #IMPLIED - event NMREF #REQUIRED - action CDATA #IMPLIED - phase (capturing|bubbling|target) #IMPLIED - button (1|2|3) #IMPLIED - modifiers CDATA #IMPLIED - keycode CDATA #IMPLIED - key CDATA #IMPLIED - charcode CDATA #IMPLIED - clickcount (1|2|3) #IMPLIED - command ID #IMPLIED - preventdefault false|true #IMPLIED -> -</pre> - -<p>The <code>handler</code> element describes a single event handler. This handler is attached to its target at the time the binding is attached and unhooked when the binding is detached from the bound element. The script inside the <code>handler</code> is executed when the event handler is matched. The <code>handler</code> tag must be inside the <code>handlers</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>event</strong></code> — The <code>event</code> attribute describes the specific event that this handler is listening for. Its value can be any legal DOM event name (including custom events created using the DocumentEvent interface of the DOM).</li> - <li><code><strong>action</strong></code> — The <code>action</code> attribute contains script that is invoked when the handler fires. The <code>type</code> attribute on the enclosing <code>handlers</code> element determines the language of the script. The handler script can also be specified as a child of the <code>handler</code> element.</li> - <li><code><strong>phase</strong></code> — This attribute specifies the phase of the event flow that this handler should monitor. The possible values are <code>capturing</code>, <code>bubbling</code>, and <code>target</code>. If a phase is specified, the handler will only be invoked during that phase of the event handling process. If no phase is specified, a default of <code>bubbling</code> is assumed.</li> - <li><code><strong>button</strong></code> — The <code>button</code> attribute imposes a <em>filter</em> on the handler. It is used with mouse handlers to specify a particular button. The event handler will only be matched if the value of the <code>button</code> field in the DOM mouse event object matches the value of the attribute.</li> - <li><code><strong>modifiers</strong></code> — The <code>modifiers</code> attribute imposes a filter on key and mouse handlers. Its value is a whitespace- or comma-separated list of modifier keys. If present in the list, then the modifier key must be set in the DOM event object in order for the handler to be matched. If the <code>modifiers</code> is not empty and the modifier is not present in the list, then the modifier key must not be set in the DOM event object in order for the handler to be matched.<br> - Supported modifiers are: - <ul> - <li><code>shift</code></li> - <li><code>alt</code></li> - <li><code>control</code></li> - <li><code>meta</code></li> - <li><code>accel</code> — the platform's primary accelerator key. It is left up to the user agent to decide which modifier key represents the primary key. (It's the Control key on Windows and Meta on Mac.)</li> - <li><code>accesskey</code> — the platform's primary shortcut mnemonic key should be used (the Alt key on Windows and Linux, has no effect on Mac).</li> - </ul> - </li> - <li><code><strong>keycode</strong></code> — The <code>keycode</code> attribute imposes a filter on key handlers. Its value is a key identifier for a specific keycode, e.g., <code>vk_enter</code>.<br> - <em>[Editor's Note: A forthcoming DOM events specification will presumably outline the list of valid keycode strings.]</em><br> - If this attribute is present, then its value must match the <a href="/fr/DOM/event.keyCode" title="fr/DOM/event.keyCode">keyCode</a> field of the DOM key event object in order for the handler to fire.</li> - <li><code><strong>charcode</strong></code> — The <code>charcode</code> attribute imposes a filter on key handlers. Its value is a single character, e.g., "<code>z</code>". If this attribute is present, then its value must match the <a href="/fr/DOM/event.charCode" title="fr/DOM/event.charCode">charCode</a> field of the DOM key event object in order for the handler to fire.<br> - <em>[Editor's note: As DOM Events mature more attributes may be added. For example, mutation events define several new fields such as relatedTarget that could be supported in the filtering syntax.]</em></li> - <li><code><strong>key</strong></code> — The <code>key</code> attribute has the same meaning as <code>charcode</code>.</li> - <li><code><strong>clickcount</strong></code> — The <code>clickcount</code> attribute imposes a <em>filter</em> on the handler. It is used with mouse handlers to specify how many times a button has been clicked. The event handler will only be matched if the value of the <code>clickcount</code> field in the DOM mouse event object matches the value of the attribute.</li> - <li><code><strong>command</strong></code> — The id of a command to invoke when the event occurs. If used in a non-chrome document, the entire handler will be ignored.</li> - <li><code><strong>preventdefault</strong></code> — If set to true, the default action of the event is not performed. See also <a href="/fr/DOM/event.preventDefault" title="fr/DOM/event.preventDefault">preventDefault</a> method of the Event object.</li> -</ul> - -<h3 id="resources" name="resources">resources</h3> - -<pre><!ENTITY % resources-content "(image?,stylesheet?)"> -<!ELEMENT resources %resources-content;> -<!ATTLIST property - id ID #IMPLIED -> -</pre> - -<p>Used for inclusion of <a href="/fr/XBL/Référence_XBL_1.0/Éléments#image" title="fr/XBL/Référence_XBL_1.0/Éléments#image">image</a> elements, to cache them for later use, and for inclusion of <a href="/fr/XBL/Référence_XBL_1.0/Éléments#stylesheet" title="fr/XBL/Référence_XBL_1.0/Éléments#stylesheet">stylesheet</a> elements. The <code>resources</code> tag must be used directly inside the <code>binding</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> -</ul> - -<h3 id="stylesheet" name="stylesheet">stylesheet</h3> - -<pre><!ELEMENT stylesheet EMPTY> -<!ATTLIST stylesheet - id ID #IMPLIED - src URI #REQUIRED -> -</pre> - -<p>The <code>stylesheet</code> element declares a style sheet used by the binding. The style rules in the style sheet will only be applied to the binding, not to other elements in the document. The <code>stylesheet</code> tag must be inside the <code>resources</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>src</strong></code> — The URL of the style sheet to apply to the binding content.</li> -</ul> - -<h3 id="image" name="image">image</h3> - -<pre><!ELEMENT image EMPTY> -<!ATTLIST image - id ID #IMPLIED - src URI #REQUIRED -> -</pre> - -<p>Declares an image resource used by the binding. The image is loaded as soon as the binding is used. You can use this to preload a number of images for later use. The <code>image</code> tag must be inside the <code>resources</code> tag.</p> - -<ul> - <li><code><strong>id</strong></code> — The <code>id</code> attribute is a document-unique identifier.</li> - <li><code><strong>src</strong></code> — The URL of the image to load.</li> -</ul> diff --git a/files/fr/archive/mozilla/xpinstall/index.html b/files/fr/archive/mozilla/xpinstall/index.html deleted file mode 100644 index 6c582079a1..0000000000 --- a/files/fr/archive/mozilla/xpinstall/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: XPInstall -slug: Archive/Mozilla/XPInstall -tags: - - XPInstall -translation_of: Archive/Mozilla/XPInstall ---- -<div><strong>Cross-Platform Install (XPInstall)</strong> est une technologie utilisée par la suite d'applications Mozilla, Mozilla Firefox, Mozilla Thunderbird et d'autres applications basées sur <a href="/fr/XUL" title="fr/XUL">XUL</a>, pour l'installation d'<a href="/fr/Extensions" title="fr/Extensions">extensions</a>. Un module d'installation XPI (prononcez « zippy », dérivé de XPInstall) est un fichier ZIP contenant un script d'installation ou un manifeste (intitulé install.js ou <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a>) à la racine de ce fichier.</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation"><a href="/Special:Tags?tag=XPInstall&language=fr" title="Special:Tags?tag=XPInstall&language=fr">Documentation</a></h4> - - <dl> - <dt><a href="/fr/Référence_de_l'API_XPInstall" title="fr/Référence_de_l'API_XPInstall">Référence de l'API XPInstall</a></dt> - </dl> - - <dl> - <dt><a href="/fr/Apprenez_à_créer_un_installeur_XPI_par_l'exemple" title="fr/Apprenez_à_créer_un_installeur_XPI_par_l'exemple">Apprenez à créer un installeur XPI par l'exemple</a></dt> - <dd><small>Cet article utilise le script de l'installeur du paquetage d'installation de <code>browser.xpi</code> comme base générale de la discussion autour des installations XPI (à traduire de <a href="/en/Learn_XPI_Installer_Scripting_by_Example">en:Learn XPI Installer Scripting by Example</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Création_de_modules_d'installation_XPI" title="fr/Création_de_modules_d'installation_XPI">Création de modules d'installation XPI</a></dt> - <dd><small>Cet article décrit le schéma de création de paquetage de Mozilla et offre un tutoriel pour la création d'un nouveau paquetage qui peut alors être redistribué, installé et rendu disponible pour les utilisateurs (à traduire de <a href="/en/Creating_XPI_Installer_Modules">en:Creating XPI Installer Modules</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Assistants_d'installation_(ou_Stub_Installers)" title="fr/Assistants_d'installation_(ou_Stub_Installers)">Assistants d'installation (ou Stub Installers)</a></dt> - <dd><small>(à traduire de <a href="/en/Install_Wizards_(aka:_Stub_Installers)">en:Install Wizards (aka: Stub Installers)</a>).</small></dd> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XPInstall&language=fr" title="Special:Tags?tag=XPInstall&language=fr">Tous les articles…</a></span></p> - </td> - <td> - <h4 id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p>{{ DiscussionList("dev-platform", "mozilla.dev.platform") }}</p> - - <h4 id="Outils" name="Outils">Outils</h4> - - <ul> - <li><a class="external" href="http://www.mozilla.org/quality/smartupdate/xpinstall-trigger.html">Déclencheurs XPInstall</a></li> - </ul> - - <h4 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/Extensions" title="fr/Extensions">Extensions</a>, <a href="/fr/XUL" title="fr/XUL">XUL</a>, <a href="/fr/XPI" title="fr/XPI">XPI</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Categories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/codes_retournés/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/codes_retournés/index.html deleted file mode 100644 index 8bd22877f9..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/codes_retournés/index.html +++ /dev/null @@ -1,274 +0,0 @@ ---- -title: Codes retournés -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Codes_retournés -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Return_Codes ---- -<p> </p> -<h2 id="Codes_retourn.C3.A9s" name="Codes_retourn.C3.A9s">Codes retournés</h2> -<p>Les méthodes décrites dans ce document peuvent retournés tous les codes d'erreur ci-dessous. Dans Mozilla/SeaMonkey, ces constantes sont définies comme des composants de l'objet xpinstall (anciennement l'objet SoftwareUpdate dans Netscape Communicator 4.5).</p> -<table class="fullwidth-table"> - <tbody> - <tr> - <td class="header">Nom</td> - <td class="header">Code</td> - <td class="header">Explication</td> - </tr> - <tr> - <td><code>SUCCESS</code></td> - <td>0</td> - <td>Succès.</td> - </tr> - <tr> - <td><code>REBOOT_NEEDED</code></td> - <td>999</td> - <td>Les fichiers ont été installés mais un ou plusieurs composants étaient en cours d'utilisation. Redémarrez l'application et votre ordinateur pour compléter l'installation. Sous Windows NT, vous ne devriez avoir besoin que de relancer l'application tant que vous n'avez pas modifié les fichiers système.</td> - </tr> - <tr> - <td><code>BAD_PACKAGE_NAME</code></td> - <td>-200</td> - <td>Un problème est survenu avec le nom de paquetage fourni à <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a>.</td> - </tr> - <tr> - <td><code>UNEXPECTED_ERROR</code></td> - <td>-201</td> - <td>Une erreur inconnue est survenue.</td> - </tr> - <tr> - <td><code>ACCESS_DENIED</code></td> - <td>-202</td> - <td>L'utilisateur (ou le système d'exploitation) ne possède pas les droits suffisant à l'installation.</td> - </tr> - <tr> - <td><code>TOO_MANY_CERTIFICATES</code></td> - <td>-203</td> - <td>Le script d'installation est signé par plus d'un certificat.</td> - </tr> - <tr> - <td><code>NO_INSTALL_SCRIPT</code></td> - <td>-204</td> - <td>Le script d'installation n'est pas signé.</td> - </tr> - <tr> - <td><code>NO_CERTIFICATE</code></td> - <td>-205</td> - <td>Le fichier extrait n'est pas signé ou le fichier (et donc son certificat) est introuvable.</td> - </tr> - <tr> - <td><code>NO_MATCHING_CERTIFICATE</code></td> - <td>-206</td> - <td>Le fichier extrait n'est pas signé avec le même certificat que celui utilisé pour signer le script d'installation.</td> - </tr> - <tr> - <td><code>CANT_READ_ARCHIVE</code></td> - <td>-207</td> - <td>Le paquetage XPI ne peut pas être lu.</td> - </tr> - <tr> - <td><code>INVALID_ARGUMENTS</code></td> - <td>-208</td> - <td>Les paramètres fournis à la fonction sont incorrects.</td> - </tr> - <tr> - <td><code>ILLEGAL_RELATIVE_PATH</code></td> - <td>-209</td> - <td>Chemin d'accès relatif illégal.</td> - </tr> - <tr> - <td><code>USER_CANCELLED</code></td> - <td>-210</td> - <td>L'utilisateur a annulé l'installation.</td> - </tr> - <tr> - <td><code>INSTALL_NOT_STARTED</code></td> - <td>-211</td> - <td>Il s'est produit un problème avec les paramètres fournis à <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a>, ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a> n'a pas été appelé en premier.</td> - </tr> - <tr> - <td><code>SILENT_MODE_DENIED</code></td> - <td>-212</td> - <td>Les droit pour une installation silencieuse ne sont pas accordés.</td> - </tr> - <tr> - <td><code>NO_SUCH_COMPONENT</code></td> - <td>-213</td> - <td>Le composant spécifié n'existe pas dans la - <i> - Client Version Registry</i> - .</td> - </tr> - <tr> - <td><code>DOES_NOT_EXIST</code></td> - <td>-214</td> - <td>Échec de la suppression. Le fichier spécifié n'existe pas.</td> - </tr> - <tr> - <td><code>READ_ONLY</code></td> - <td>-215</td> - <td>Échec de la suppression. Le fichier spécifié est en lecture seule.</td> - </tr> - <tr> - <td><code>IS_DIRECTORY</code></td> - <td>-216</td> - <td>Échec de la suppression. Le fichier spécifié est un répertoire.</td> - </tr> - <tr> - <td><code>NETWORK_FILE_IS_IN_USE</code></td> - <td>-217</td> - <td>Échec de la suppression. Le fichier spécifié est en cours d'utilisation.</td> - </tr> - <tr> - <td><code>APPLE_SINGLE_ERR</code></td> - <td>-218</td> - <td>Une erreur est survenue lors de la décompression d'un fichier au format AppleSingle.</td> - </tr> - <tr> - <td><code>INVALID_PATH_ERR</code></td> - <td>-219</td> - <td>Le chemin d'accès fourni à <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a> n'existe pas.</td> - </tr> - <tr> - <td><code>PATCH_BAD_DIFF</code></td> - <td>-220</td> - <td>Une erreur est survenue dans GDIFF.</td> - </tr> - <tr> - <td><code>PATCH_BAD_CHECKSUM_TARGET</code></td> - <td>-221</td> - <td>La somme de contrôle du fichier source ne correspond pas à celle indiquée dans le fichier XPI.</td> - </tr> - <tr> - <td><code>PATCH_BAD_CHECKSUM_RESULT</code></td> - <td>-222</td> - <td>La somme de contrôle du patch n'a pu être calculée.</td> - </tr> - <tr> - <td><code>UNINSTALL_FAILED</code></td> - <td>-223</td> - <td>Une erreur s'est produite durant la désinstallation d'un paquetage.</td> - </tr> - <tr> - <td><code>PACKAGE_FOLDER_NOT_SET</code></td> - <td>-224</td> - <td>Le répertoire d'installation n'est pas défini dans le script d'installation.</td> - </tr> - <tr> - <td><code>EXTRACTION_FAILED</code></td> - <td>-225</td> - <td>L'extraction du fichier XPI a échoué.</td> - </tr> - <tr> - <td><code>FILENAME_ALREADY_USED</code></td> - <td>-226</td> - <td>Un fichier portant ce nom existe déjà dans l'installation</td> - </tr> - <tr> - <td><code>INSTALL_CANCELLED</code></td> - <td>-227</td> - <td>L'installation est abandonnée.</td> - </tr> - <tr> - <td><code>DOWNLOAD_ERROR</code></td> - <td>-228</td> - <td>Problème lors du téléchargement.</td> - </tr> - <tr> - <td><code>SCRIPT_ERROR</code></td> - <td>-229</td> - <td>Erreur dans le script.</td> - </tr> - <tr> - <td><code>ALREADY_EXISTS</code></td> - <td>-230</td> - <td>Un fichier existe déjà localement.</td> - </tr> - <tr> - <td><code>IS_FILE</code></td> - <td>-231</td> - <td>Un fichier a été trouvé là où un répertoire cible était attendu.</td> - </tr> - <tr> - <td><code>SOURCE_DOES_NOT_EXIST</code></td> - <td>-232</td> - <td>Le fichier/répertoire source n'a pas été trouvé.</td> - </tr> - <tr> - <td><code>SOURCE_IS_DIRECTORY</code></td> - <td>-233</td> - <td>Un répertoire a été trouvé là où un fichier source était attendu.</td> - </tr> - <tr> - <td><code>SOURCE_IS_FILE</code></td> - <td>-234</td> - <td>Un fichier a été trouvé là où un répertoire source était attendu.</td> - </tr> - <tr> - <td><code>INSUFFICIENT_DISK_SPACE</code></td> - <td>-235</td> - <td>Espace disque insuffisant pour l'installation.</td> - </tr> - <tr> - <td><code>FILENAME_TOO_LONG</code></td> - <td>-236</td> - <td> </td> - </tr> - <tr> - <td><code>UNABLE_TO_LOCATE_LIB_FUNCTION</code></td> - <td>-237</td> - <td> </td> - </tr> - <tr> - <td><code>UNABLE_TO_LOAD_LIBRARY</code></td> - <td>-238</td> - <td> </td> - </tr> - <tr> - <td><code>CHROME_REGISTRY_ERROR</code></td> - <td>-239</td> - <td> </td> - </tr> - <tr> - <td><code>MALFORMED_INSTALL</code></td> - <td>-240</td> - <td> </td> - </tr> - <tr> - <td><code>KEY_ACCESS_DENIED</code></td> - <td>-241</td> - <td>Accès refusé à la clef de registre</td> - </tr> - <tr> - <td><code>KEY_DOES_NOT_EXIST</code></td> - <td>-242</td> - <td>La clef de registre n'existe pas</td> - </tr> - <tr> - <td><code>VALUE_DOES_NOT_EXIST</code></td> - <td>-243</td> - <td>La valeur de registre n'existe pas</td> - </tr> - <tr> - <td><code>INVALID_SIGNATURE</code></td> - <td>-260</td> - <td>Signature du XPI invalide</td> - </tr> - <tr> - <td><code>OUT_OF_MEMORY</code></td> - <td>-299</td> - <td>Mémoire insuffisante pour cette opération.</td> - </tr> - <tr> - <td><code>GESTALT_UNKNOWN_ERROR</code></td> - <td>-5550</td> - <td> </td> - </tr> - <tr> - <td><code>GESTALT_INVALID_ARGUMENT</code></td> - <td>-5551</td> - <td> </td> - </tr> - </tbody> -</table> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Return_Codes" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.macalias/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.macalias/index.html deleted file mode 100644 index d114a737d6..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.macalias/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: File.macAlias -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/File.macAlias -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/File.macAlias ---- -<p> </p> -<h3 id="File.macAlias" name="File.macAlias">File.macAlias</h3> -<p>Dans cet exemple, on crée un alias mac pour le logiciel (AppleCD Audio Player) installé en local.</p> -<pre class="eval">xpiSrc = "Miscellaneous Program"; -var vi = "1.1.1.1"; -initInstall( - "Macintosh Alias", - "misc", - vi, - 0); -f = getFolder("Program"); -g = getFolder("Mac Desktop"); -addFile( - "filemacalias", - "2.2.2.2", - xpiSrc, - f, - xpiSrc, - true); -err = File.macAlias(f, xpiSrc, g, xpiSrc + " alias"); -logComment("File.macAlias returns: " + err); -if (0 == getLastError()) - performInstall(); -else - cancelInstall(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/File.macAlias" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.windowsshortcut/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.windowsshortcut/index.html deleted file mode 100644 index b3877c949f..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/file.windowsshortcut/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: File.windowsShortcut -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/File.windowsShortcut -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/File.windowsShortcut ---- -<p> </p> -<h3 id="File.windowsShortcut" name="File.windowsShortcut">File.windowsShortcut</h3> -<p>Dans cet exemple, la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsShortcut">windowsShortcut</a> est utilisée pour ajouter un raccourci dans le répertoire - <i> - Program</i> - ( - <i> - Program</i> - est un mot clef pour désigner le répertoire d'installation du programme, par exemple, C:\Program Files\Netscape\Netscape 6\" sous Microsoft Windows) au logiciel Windows (misc.exe) installé dans le répertoire - <i> - Windows</i> - .</p> -<pre class="eval">var xpiSrc = "misc.exe"; -var vi = "1.1.1.1"; -initInstall( - "Windows Shortcut", - "test", - vi, - 0); -f = getFolder("Windows"); -g = getFolder("Temporary"); -addFile( - "miscshortcut", - "2.2.2.2", - xpiSrc, - f, - xpiSrc, - true); -target = getFolder(f, xpiSrc); -shortcutpath = getFolder("Program"); -err = File.windowsShortcut( - target, - shortcutpath, - "misc shortcut", - g, - "", - target, - 0); -logComment("file.windowsShortcut returns: " + err); -if (0 == getLastError()) - performInstall(); -else - cancelInstall(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/File.windowsShortcut" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/index.html deleted file mode 100644 index b379807ff9..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/index.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Exemples -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples -translation_of: Archive/Mozilla/XPInstall/Reference/Examples ---- -<p>{{wiki.localize('System.API.page-generated-for-subpage')}}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.adddirectory/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.adddirectory/index.html deleted file mode 100644 index 9c7ed53d4b..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.adddirectory/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Install.addDirectory -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/Install.addDirectory -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/Install.addDirectory ---- -<p> </p> -<h3 id="Install.addDirectory" name="Install.addDirectory">Install.addDirectory</h3> -<p>La méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a> de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a> met en file d'attente un répertoire entier pour qu'il soit installé après l'appel de la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a>.</p> -<pre class="eval">var vi = "10.10.10.10"; -var xpiSrc = "adddir1"; -initInstall("addFileNoVers1", "adddir_1", vi, 1); -f = getFolder("Program"); -setPackageFolder(f); -err = addDirectory(xpiSrc); -logComment("the error = " + err); -if (0 == getLastError()) - performInstall(); -else - cancelInstall(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/Install.addDirectory" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.addfile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.addfile/index.html deleted file mode 100644 index 33f1e12e8a..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/install.addfile/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Install.addFile -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/Install.addFile -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/Install.addFile ---- -<p> </p> -<h3 id="Install.addFile" name="Install.addFile">Install.addFile</h3> -<p>La méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a> de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a> est la manière standard de mettre les fichiers en file d'attente pour l'installation.</p> -<pre class="eval">var xpiSrc = "file.txt"; -initInstall( - "Ajout d'un fihcier", - "testFile", - "1.0.1.7", - 1); -f = getFolder("Program"); -setPackageFolder(f); -addFile(xpiSrc); -if (0 == getLastError()) - performInstall(); -else - cancelInstall(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/Install.addFile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.installchrome/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.installchrome/index.html deleted file mode 100644 index 108b77fb85..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.installchrome/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: InstallTrigger.installChrome -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/InstallTrigger.installChrome -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/InstallTrigger.installChrome ---- -<p> </p> -<h3 id="InstallTrigger.installChrome" name="InstallTrigger.installChrome">InstallTrigger.installChrome</h3> -<p>Les scripts de déclenchement sont généralement invoqués par des événements JavaScript sur des hyperliens. Lorsqu'un utilisateur clique sur le lien « Installer le thème "New Blue" » dans l'exemple ci-dessous, <code>XPInstall</code> télécharge, enregistre et installe le thème contenu dans le fichier <tt>newblue.xpi</tt> dans le répertoire de profil de l'utilisateur.</p> -<pre class="eval"><a href="#" - onclick="InstallTrigger.installChrome( - InstallTrigger.SKIN, - '<span class="nowiki">http://wildskins/newblue.xpi</span>', - 'newblue/1.0');"> - Installer le thème "New Blue"</a> -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/InstallTrigger.installChrome" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.startsoftwareupdate/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.startsoftwareupdate/index.html deleted file mode 100644 index c70d1b55b1..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/installtrigger.startsoftwareupdate/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: InstallTrigger.startSoftwareUpdate -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/InstallTrigger.startSoftwareUpdate -translation_of: >- - Archive/Mozilla/XPInstall/Reference/Examples/InstallTrigger.startSoftwareUpdate ---- -<p> </p> -<h3 id="InstallTrigger.startSoftwareUpdate" name="InstallTrigger.startSoftwareUpdate">InstallTrigger.startSoftwareUpdate</h3> -<p>Ceci est un exemple très simple de la méthode principale de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger">InstallTrigger</a>, <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/startSoftwareUpdate">startSoftwareUpdate</a>, qui prend une chaîne représentant le chemin vers le fichier <tt>xpi</tt> et l'installe sur la machine locale.</p> -<pre class="eval">function triggerURL(url) -{ - InstallTrigger.startSoftwareUpdtate(url); -} -// Récupère l'URL du fichier .xpi depuis un formulaire -// ou une entrée de champ texte. Puis exécute : -... onclick="triggerURL(this.form.url.value); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/InstallTrigger.startSoftwareUpdate" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/scripts_de_déclenchement_et_scripts_d'installation/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/scripts_de_déclenchement_et_scripts_d'installation/index.html deleted file mode 100644 index c46ff4a9ad..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/scripts_de_déclenchement_et_scripts_d'installation/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Scripts de déclenchement et scripts d'installation -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/Scripts_de_déclenchement_et_scripts_d'installation -translation_of: >- - Archive/Mozilla/XPInstall/Reference/Examples/Trigger_Scripts_and_Install_Scripts ---- -<p> </p> -<h3 id="Scripts_de_d.C3.A9clenchement_et_scripts_d.27installation" name="Scripts_de_d.C3.A9clenchement_et_scripts_d.27installation">Scripts de déclenchement et scripts d'installation</h3> -<p>Les scripts de déclenchement sont de simples installations qui peuvent être initialisées depuis des gestionnaires d'événements ou tout autre code JavaScript présent dans une page Web.</p> -<p>Ils utilisent les méthodes de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger">InstallTrigger</a> pour comparer les versions des logiciels, installer le chrome et exécuter des installations simples de logiciels.</p> -<p>Les scripts d'installation utilisent les méthodes des objets <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a>, <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a> et <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a> ainsi que des méthodes d'objets spécifiques à chaque plate-forme pour initialiser, mettre en file d'attente, gérer et exécuter l'installation d'un ou de plusieurs paquetages de logiciels.</p> -<p>Ces scripts d'installation sont généralement localisés au plus haut niveau de l'arborescence des archives <tt>xpi</tt> dans lesquelles les installations sont stockées. Un script de déclenchement peut déclencher le téléchargement d'un <tt>xpi</tt>, qui utisera son propre script <tt>install.js</tt> pour gérer l'installation complète.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Examples/Trigger_Scripts_and_Install_Scripts" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/windows_install/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/windows_install/index.html deleted file mode 100644 index 090866a4c1..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/exemples/windows_install/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: Windows Install -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Exemples/Windows_Install -translation_of: Archive/Mozilla/XPInstall/Reference/Examples/Windows_Install ---- -<h3 id="Exemple_d.27installation_Windows" name="Exemple_d.27installation_Windows">Exemple d'installation Windows</h3> -<p>Cet exemple décrit l'installation d'un fichier <code>xpi</code> dans lequel sont contenues les informations sur le profil de l'utilisateur.</p> -<p>La vérification de l'espace disque, l'édition du registre Windows, l'écriture du journal d'installation et la vérification des erreurs se font avant l'appel des méthodes <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a> ou <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/cancelInstall">cancelInstall</a>.</p> -<pre>// Cette fonction vérifie l'espace disque en kio -function verifyDiskSpace(dirPath, spaceRequired) -{ - var spaceAvailable; - // Récupère l'espace disque pour le chemin donné - spaceAvailable = fileGetDiskSpaceAvailable(dirPath); - // Convertit l'espace disque disponible en kio - spaceAvailable = parseInt(spaceAvailable / 1024); - // Fait la vérification - if(spaceAvailable < spaceRequired) - { - logComment("Espace disque insuffisant : " + dirPath); - logComment(" requis : " + spaceRequired + " kio"); - logComment(" disponible : " + spaceAvailable + " kio"); - return(false); - } - return(true); -} - -function updateWinReg4Ren8dot3() -{ - var fProgram = getFolder("Program"); - var fTemp = getFolder("Temporary"); - // Notes : - // On ne peut pas utiliser un double backslash avant une sous-clef - // car Windows les met déjà. - // Les sous-clefs doivent exister avant d'y mettre une valeur. - var subkey; // Le nom de la sous-clef dans laquelle vous voulez intervenir - var valname; // Le nom de la paire nom_de_valeur/valeur à modifier - var value; // La nouvelle valeur chaîne - var winreg = getWinRegistry() ; - if(winreg != null) - { - // Ici, nous récupérons la version courante. - winreg.setRootKey(winreg.HKEY_CURRENT_USER) ;// CURRENT_USER - subkey = - "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\RunOnce" ; - winreg.createKey(subkey,""); - valname = "ren8dot3"; - value = fProgram + "ren8dot3.exe " + fTemp + "ren8dot3.ini"; - err = winreg.setValueString(subkey, valname, value); - } -} - -function prepareRen8dot3(listLongFilePaths) -{ - var fTemp = getFolder("Temporary"); - var fProgram = getFolder("Program"); - var fRen8dot3Ini = getWinProfile(fTemp, "ren8dot3.ini"); - var bIniCreated = false; - var fLongFilePath; - var sShortFilePath; - if(fRen8dot3Ini != null) - { - for(i = 0; i < listLongFilePaths.length; i++) - { - fLongFilePath = getFolder(fProgram, listLongFilePaths[i]); - sShortFilePath = File.windowsGetShortName(fLongFilePath); - if(sShortFilePath) - { - fRen8dot3Ini.writeString("rename", - sShortFilePath, fLongFilePath); - bIniCreated = true; - } - } - if(bIniCreated) - updateWinReg4Ren8dot3() ; - } - return(0); -} - -// main -var srDest; -var err; -var fProgram; -srDest = 449; -err = initInstall(prettyName, regName, "6.0.0.2000110801"); -logComment("initInstall: " + err); -fProgram = getFolder("Program"); -logComment("fProgram: " + fProgram); -if(verifyDiskSpace(fProgram, srDest)) -{ - setPackageFolder(fProgram); - err = addDirectory("", - "6.0.0.2000110801", - "bin", // Dans le jar, nom du répertoire à extraire - fProgram, // Où mettre le fichier (valeur retournée depuis GetFolder) - "", // Noms des sous-répertoires à créer, relativement à fProgram - true); // Force Flag - logComment("addDirectory() returned: " + err); - // Vérifie la valeur retournée - if(err == SUCCESS) - { - err = performInstall(); - logComment("performInstall() returned: " + err); - } - else - cancelInstall(err); -} -else - cancelInstall(INSUFFICIENT_DISK_SPACE); -// Fin de main -</pre> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/index.html deleted file mode 100644 index cc23e6ee7d..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/index.html +++ /dev/null @@ -1,193 +0,0 @@ ---- -title: Référence de l'API XPInstall -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall -tags: - - Référence_de_l'API_XPInstall - - XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference ---- -<div class="warning"><p>Cette page fait parti de la <a href="https://developer.mozilla.org/fr/docs/Référence_de_l'API_XPInstall">Référence de l'API XPInstall</a>. Notez que si vous être un développeur d'<a href="https://developer.mozilla.org/fr/docs/Extensions">extension</a>, de <a href="https://developer.mozilla.org/fr/docs/Thèmes">thème</a>, ou de <a href="https://developer.mozilla.org/fr/docs/Plugins">plug-in</a>, vous n'avez plus besoin d'une grande partie de cette API. Plus particulièrement, le script <code>install.js</code> utilisé pour l'installation et l'enregistrement du contenu des <code>XPI</code> est déprécié en faveur du nouveau manifeste déclaratif <code><a href="https://developer.mozilla.org/fr/docs/Manifestes_d'installation">install.rdf</a></code> et du nouveau <a href="https://developer.mozilla.org/fr/docs/Bundles">schéma de paquetage</a>.</p></div> - -<h3 id="Objets" name="Objets">Objets</h3> - -<h4 id="Install" name="Install"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></h4> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/Propri%c3%a9t%c3%a9s">Propriétés</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/alert">alert</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/cancelInstall">cancelInstall</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/confirm">confirm</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/deleteRegisteredFile">deleteRegisteredFile</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/execute">execute</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/gestalt">gestalt</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getLastError">getLastError</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinProfile">getWinProfile</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinRegistry">getWinRegistry</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/loadResources">loadResources</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/logComment">logComment</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/patch">patch</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/refreshPlugins">refreshPlugins</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/registerChrome">registerChrome</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/resetError">resetError</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/setPackageFolder">setPackageFolder</a></dd> - </dl> - </dd> -</dl> - -<h4 id="InstallTrigger" name="InstallTrigger"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger">InstallTrigger</a></h4> - -<dl> - <dd><em>Aucune propriété</em></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/compareVersion">compareVersion</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/enabled">enabled</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/getVersion">getVersion</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/install">install</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/installChrome">installChrome</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/startSoftwareUpdate">startSoftwareUpdate</a></dd> - </dl> - </dd> -</dl> - -<h4 id="InstallVersion" name="InstallVersion"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a></h4> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/Propri%c3%a9t%c3%a9s">Propriétés</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/compareTo">compareTo</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/init">init</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/toString">toString</a></dd> - </dl> - </dd> -</dl> - -<h4 id="File" name="File"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></h4> - -<dl> - <dd><em>Aucune propriété</em></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/copy">copy</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirCreate">dirCreate</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirGetParent">dirGetParent</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirRemove">dirRemove</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirRename">dirRename</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/diskSpaceAvailable">diskSpaceAvailable</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/execute">execute</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/exists">exists</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/isDirectory">isDirectory</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/isFile">isFile</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/macAlias">macAlias</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDate">modDate</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDateChanged">modDateChanged</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/move">move</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/remove">remove</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/rename">rename</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/size">size</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsGetShortName">windowsGetShortName</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsRegisterServer">windowsRegisterServer</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsShortcut">windowsShortcut</a></dd> - </dl> - </dd> -</dl> - -<h4 id="WinProfile" name="WinProfile"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile">WinProfile</a></h4> - -<dl> - <dd><em>Aucune propriété</em></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile/M%c3%a9thodes/getString">getString</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile/M%c3%a9thodes/writeString">writeString</a></dd> - </dl> - </dd> -</dl> - -<h4 id="WinReg" name="WinReg"><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></h4> - -<dl> - <dd><em>Aucune propriété</em></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes">Méthodes</a></dd> -</dl> - -<dl> - <dd> - <dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/createKey">createKey</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/deleteKey">deleteKey</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/deleteValue">deleteValue</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/enumKeys">enumKeys</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/enumValueNames">enumValueNames</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValue">getValue</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueNumber">getValueNumber</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueString">getValueString</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/isKeyWritable">isKeyWritable</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/keyExists">keyExists</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setRootKey">setRootKey</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValue">setValue</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueNumber">setValueNumber</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueString">setValueString</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/valueExists">valueExists</a></dd> - </dl> - </dd> -</dl> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/WinRegValue">Constructeur WinRegValue</a></dd> -</dl> - -<h3 id="Autres_informations" name="Autres_informations">Autres informations</h3> - -<h4 id="Codes_retourn.C3.A9s" name="Codes_retourn.C3.A9s">Codes retournés</h4> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Voir la liste complète</a></dd> -</dl> - -<h4 id="Exemples" name="Exemples">Exemples</h4> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/Scripts_de_d%c3%a9clenchement_et_scripts_d'installation">Scripts de déclenchement et scripts d'installation</a></dd> -</dl> - -<h5 id="Extraits_de_code" name="Extraits_de_code">Extraits de code</h5> - -<dl> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/File.macAlias">File.macAlias</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/File.windowsShortcut">File.windowsShortcut</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/Install.addDirectory">Install.addDirectory</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/Install.addFile">Install.addFile</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/InstallTrigger.installChrome">InstallTrigger.installChrome</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/InstallTrigger.startSoftwareUpdate">InstallTrigger.startSoftwareUpdate</a></dd> - <dd><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/Windows_Install">Windows Install</a></dd> -</dl> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/index.html deleted file mode 100644 index fdfa76bd31..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Objet File -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object ---- -<p> </p> -<h2 id="File" name="File">File</h2> -<p>L'objet <code>File</code> s'utilise pour manipuler des fichiers et des répertoires locaux lors d'un processus d'installation.</p> -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> -<p>L'objet <code>File</code> a des méthodes servant à l'analyse du système de fichiers et à sa préparation (dans le cas de création de répertoires, de raccourcis, de comparaison de versions ou de suppression de fichiers) pour les logiciels nouvellement installés. L'objet <code>File</code> fonctionne en conjonction avec l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/copy/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/copy/index.html deleted file mode 100644 index 18343a62aa..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/copy/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: copy -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/copy -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/copy ---- -<p> </p> -<h3 id="copy" name="copy">copy</h3> -<p>Fait une copie mise en file d'attente du fichier spécifié.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int copy( FileSpecObject source, FileSpecObject dest ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>copy</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>source</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier à copier.</dd> - <dt> - <code>dest</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant la destination.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La destination peut être un nom de répertoire ou un nom de fichier. Si la destination n'existe pas, un nouveau fichier sera créé.</p> -<p><span class="comment">Inerwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/copy" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dircreate/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dircreate/index.html deleted file mode 100644 index 84f235f369..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dircreate/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: dirCreate -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/dirCreate -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/dirCreate ---- -<p> </p> -<h3 id="dirCreate" name="dirCreate">dirCreate</h3> -<p>Crée un nouveau répertoire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int dirCreate( FileSpecObject dirToCreate ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>dirCreate</code> a le paramètre suivant:</p> -<dl> - <dt> - <code>dirToCreate</code></dt> - <dd> - Un - <i> - FileSpecObject</i> - représentant le chemin du répertoire à créer.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Le paramètre d'entrée est un FileSpecObject précédemment créé avec la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></code> de l'objet <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></code>. L'exemple suivant montre l'utilisation de la méthode <code>dirCreate</code>. On remarque que la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></code> ne nécessite pas que le dossier ou répertoire spécifié existe pour que la référence objet soit valide.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder("Program", "myNewDirectory"); -err = File.dirCreate(f); -</pre> -<p><br> - <span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/dirCreate" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirgetparent/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirgetparent/index.html deleted file mode 100644 index eadcae9762..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirgetparent/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: dirGetParent -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/dirGetParent -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/dirGetParent ---- -<p> </p> -<h3 id="dirGetParent" name="dirGetParent">dirGetParent</h3> -<p>Retourne un objet représentant le répertoire parent du répertoire ou du fichier courant.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">FileSpecObject dirGetParent( FileSpecObject fichierOuRépertoire ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>dirGetParent</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>fichierOuRépertoire</code></dt> - <dd> - Un - <i> - FileSpecObject</i> - représentant le chemin du fichier ou du répertoire dont il faut retourner le parent.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un FileSpecObject si réussite ; <code>null</code> dans le cas contraire.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder("Program", "myNewDirectory"); -err = File.dirCreate(f); -err = File.getParent(f) // retourne "Program" -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/dirGetParent" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirremove/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirremove/index.html deleted file mode 100644 index d6030a3719..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirremove/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: dirRemove -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/dirRemove -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/dirRemove ---- -<p> </p> -<h3 id="dirRemove" name="dirRemove">dirRemove</h3> -<p>Supprime un répertoire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int dirRemove( FileSpecObject dirToRemove [, booléen recursive] ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>dirRemove</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>dirToRemove</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le répertoire à supprimer.</dd> - <dt> - <code>recursive</code></dt> - <dd> - Une valeur booléenne optionnelle indiquant si l'opération de suppression doit être exécutée récursivement (1) ou non (0).</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/dirRemove" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirrename/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirrename/index.html deleted file mode 100644 index c86cd38cb4..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/dirrename/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: dirRename -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/dirRename -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/dirRename ---- -<p> </p> -<h3 id="dirRename" name="dirRename">dirRename</h3> -<p>Renomme un répertoire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int dirRename( FileSpecObject répertoire, Chaîne nouveauNom ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>dirRename</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>répertoire</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le répertoire à renommer.</dd> - <dt> - <code>nouveauNom</code></dt> - <dd> - Le nouveau nom terminal (ou nœud terminal) du répertoire.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/dirRename" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/diskspaceavailable/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/diskspaceavailable/index.html deleted file mode 100644 index 62847a38d4..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/diskspaceavailable/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: diskSpaceAvailable -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/diskSpaceAvailable -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/diskSpaceAvailable ---- -<p> </p> -<h3 id="diskSpaceAvailable" name="diskSpaceAvailable">diskSpaceAvailable</h3> -<p>Retourne la taille de l'espace disque disponible, en octets, sur le disque local.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">double diskSpaceAvailable ( String NativeFolderPath ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>diskSpaceAvailable</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>NativeFolderPath</code></dt> - <dd> - Une chaîne représentant le chemin de la partition, un fichier ou un répertoire sur la partition, dont on veut connaître l'espace disponible.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre à double précision représentant la taille de l'espace disponible, en octets, du disque vérifié.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Cette méthode est utilisée pour s'assurer qu'il y a assez d'espace disque pour l'extraction et l'installation des fichiers (voir l'exemple ci-dessous).</p> -<p>On peut utiliser une chaîne représentant n'importe quel fichier sur le disque à vérifier et XPInstall résoudra de lui-même la référence à la partition.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">var diskAmtNeeded = 10000; -f = getFolder("Program"); -diskSpace = File.diskSpaceAvailable(f); -g = getFolder(f, "myfile.txt"); -if (diskSpace > diskAmtNeeded) -{ - err = addFile(..., ... g, ...); - if (err == 0) - performInstall(); - else - cancelInstall(); -} -else -{ - alert("Espace disque insuffisant. Aucune installation); - cancelInstall(); -} -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/diskSpaceAvailable" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/execute/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/execute/index.html deleted file mode 100644 index fb929d6424..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/execute/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: execute -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/execute -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/execute ---- -<p> </p> -<h3 id="execute" name="execute">execute</h3> -<p>Met en attente l'exécution d'un fichier local.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int execute ( FileSpecObject executableFile, [Chaîne aParameters] ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>execute</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>executableFile</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier local, déjà présent sur le disque, à exécuter. Les noms de fichier sont sensibles à la casse.</dd> - <dt> - <code>aParameters</code></dt> - <dd> - Une chaîne optionnelle passée à l'exécutable (ignoré sous Mac OS).</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Le fichier spécifié ne sera pas exécuté jusqu'à l'appel de la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a>. Pour plus d'informations sur la mise en attente des commandes pendant le processus d'installation, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder("Program", "myTextEditor.exe"); -err = File.execute(f, "myfile.txt"); -// indique que 'myfile.txt' sera -// ouvert dans l'éditeur -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/execute" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/exists/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/exists/index.html deleted file mode 100644 index 35fb3b658f..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/exists/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: exists -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/exists -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/exists ---- -<p> </p> -<h3 id="exists" name="exists">exists</h3> -<p>Retourne un valeur indiquant si le fichier ou le répertoire spécifié existe.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean exists( FileSpecObject cible ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>exists</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>cible</code></dt> - <dd> - Un - <i> - FileSpecObject</i> - représentant le fichier ou le répertoire dont on veut tester l'existence.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une valeur booléenne indiquant si le fichier ou le répertoire existe ou pas.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder( "Program", "sample.txt" ); -if ( File.exists(f) ) // fait quelque chose avec le fichier -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/exists" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/index.html deleted file mode 100644 index 7476871a02..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Méthodes -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods ---- -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirCreate">dirCreate</a></dt> - <dd> - Crée un nouveau répertoire.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirGetParent">dirGetParent</a></dt> - <dd> - Retourne un objet représentant le répertoire parent.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirRemove">dirRemove</a></dt> - <dd> - Supprime un répertoire.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/dirRename">dirRename</a></dt> - <dd> - Renomme le répertoire spécifié.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/copy">copy</a></dt> - <dd> - Copie le fichier spécifié.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/diskSpaceAvailable">diskSpaceAvailable</a></dt> - <dd> - Retourne l'espace disque disponible en octets.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/exists">exists</a></dt> - <dd> - Retourne une valeur booléenne indiquant l'existence ou non du fichier spécifié.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/execute">execute</a></dt> - <dd> - Met un fichier en file d'attente pour son exécution lors du processus d'installation.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/isFile">isFile</a></dt> - <dd> - Retourne une valeur booléenne indiquant si un objet est un fichier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDate">modDate</a></dt> - <dd> - Retourne un nombre représentant la dernière date de modification du fichier spécifié.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDateChanged">modDateChanged</a></dt> - <dd> - Spécifie si la dernière modification d'un fichier est antérieure à la date spécifiée.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/move">move</a></dt> - <dd> - Déplace un fichier d'un répertoire vers un autre.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/remove">remove</a></dt> - <dd> - Supprime un fichier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/rename">rename</a></dt> - <dd> - Renomme un fichier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/size">size</a></dt> - <dd> - Retourne la taille du fichier en octets.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsShortcut">windowsShortcut</a></dt> - <dd> - Crée un raccourci Windows pour un fichier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/macAlias">macAlias</a></dt> - <dd> - Crée un alias Macintosh pour un fichier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsGetShortName">windowsGetShortName</a></dt> - <dd> - Retourne le nom Windows du chemin.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/windowsRegisterServer">windowsRegisterServer</a></dt> - <dd> - Enregistre les DLL dans le registre.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isdirectory/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isdirectory/index.html deleted file mode 100644 index ad2c6f5d29..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isdirectory/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: isDirectory -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/isDirectory -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/isDirectory ---- -<p> </p> -<h3 id="isDirectory" name="isDirectory">isDirectory</h3> -<p>Retourne une valeur booléenne indiquant si l'objet <code>FileSpecObject</code> spécifié est un répertoire ou non.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean isDirectory ( FileSpecObject NativeFolderPath ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>isDirectory</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>NativeFolderPath</code></dt> - <dd> - Un objet <code>FileSpecObject</code> représentant le répertoire questionné.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une valeur booléenne indiquant si l'objet <code>FileSpecObject</code> spécifié est un répertoire ou non.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/isDirectory" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isfile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isfile/index.html deleted file mode 100644 index 19aca8da63..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/isfile/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: isFile -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/isFile -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/isFile ---- -<p> </p> -<h3 id="isFile" name="isFile">isFile</h3> -<p>Retourne une valeur booléenne indiquant si le <code>FileSpecObject</code> donné est un fichier ou non.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean isFile (FileSpecObject NativeFolderPath); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>isFile</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>NativeFolderPath</code></dt> - <dd> - Un FileSpecObject représentant l'objet fichier demandé.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une valeur booléenne indiquant si <code>FileSpecObject</code> est un fichier ou pas.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder( "Program", "sample.txt" ); -if ( File.isFile(f) ) // the object represents a file -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/isFile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/macalias/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/macalias/index.html deleted file mode 100644 index 1011ebfbe9..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/macalias/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: macAlias -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/macAlias -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/macAlias ---- -<p> </p> -<h3 id="macAlias" name="macAlias">macAlias</h3> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int macAlias( - FileSpecObject destDir, - Chaîne fileName, - FileSpecObject aliasDir, - Chaîne aliasName ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>macAlias</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>destDir</code></dt> - <dd> - Un FileSpecObject représentant le répertoire dans lequel le fichier programme sera installé.</dd> - <dt> - <code>fileName</code></dt> - <dd> - Une chaîne représentant le nom du fichier à installer.</dd> - <dt> - <code>aliasDir</code></dt> - <dd> - Un FileSpecObject représentant le répertoire dans lequel le fichier alias sera installé (par exemple, - <i> - Mac Desktop</i> - ).</dd> - <dt> - <code>aliasName</code></dt> - <dd> - Une chaîne représentant le nom de l'alias lui-même.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/File.macAlias">File.macAlias</a> dans les exemples de scripts.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/macAlias" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddate/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddate/index.html deleted file mode 100644 index c333050427..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddate/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: modDate -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/modDate -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/modDate ---- -<p> </p> -<h3 id="modDate" name="modDate">modDate</h3> -<p>Retourne la dernière date de modification du fichier ou du répertoire spécifié.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">double modDate ( FileSpecObject NativeFolderPath ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>modDate</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>NativeFolderPath</code></dt> - <dd> - Un FileSpecObject représentant le fichier demandé.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre à double précision représentant la date de dernière modification du fichier.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">f = getFolder("Program"); -fileSource = getFolder(f, "myfile.txt"); -err = File.modDate(fileSource); -</pre> -<p>Voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDateChanged">modDateChanged</a> pour un exemple de comparaison des dates de deux fichiers.</p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/modDate" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddatechanged/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddatechanged/index.html deleted file mode 100644 index 87bc66f2ba..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/moddatechanged/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: modDateChanged -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/modDateChanged -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/modDateChanged ---- -<p> </p> -<h3 id="modDateChanged" name="modDateChanged">modDateChanged</h3> -<p>Retourne si le fichier a été modifié depuis une certaine date.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean modDateChanged (FileSpecObject aSourceFolder, Number anOldDate); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>modDateChanged</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>aSourceFolder</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier à interroger.</dd> - <dt> - <code>anOldDate</code></dt> - <dd> - Un nombre à double précision représentant la date.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Une valeur booléenne indiquant si le fichier a été modifié ou non depuis la date spécifiée.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Le plus souvent, la date passée comme second paramètre de la méthode <code>modDateChanged</code> est la valeur retournée par une méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File/M%c3%a9thodes/modDate">modDate</a> appliquée à un fichier séparé, comme dans l'exemple ci-dessous, dans lequel on compare les dates de modification des deux fichiers.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">fileSource1 = getFolder("Program", "file1.txt"); -fileSource2 = getFolder("Program", "file2.txt"); -err1 = File.modDate(fileSource1); // retourne la valeur de base - -err2 = File.modDateChanged(fileSource1, err1); -logComment("File.modDateChanged doit retourner 'false' = " + err2); -// La raison pour laquelle False est attendu, est que -// nous comparons la valeur de date retournée pour -// file1.txt avec le fichier réel file1.txt lui-même. -// Ainsi, il n'y a pas de changement de la valeur de date (time stamp) - -err3 = File.modDateChanged(fileSource2, err1); -logComment("File.modDateChanged doit retourner 'true' = " + err2); -// La raison pour laquelle True est attendu, est que -// nous comparons la valeur de date retournée pour -// file1.txt avec un autre fichier, file2.txt, avec -// une valeur de date différente. -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/modDateChanged" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/move/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/move/index.html deleted file mode 100644 index 901530fde2..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/move/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: move -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/move -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/move ---- -<p> </p> -<h3 id="move" name="move">move</h3> -<p>Déplace un fichier d'un emplacement vers un autre.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int move( FileSpecObject source, FileSpecObject dest ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>move</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>source</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier source.</dd> - <dt> - <code>dest</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le répertoire de destination.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Il faut créer un objet - <i> - FileSpecObject</i> - pour le répertoire de destination à passer à cette fonction. Si la destination n'existe pas, on suppose qu'elle correspond à un nom de fichier.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">source = getFolder("Program", "file.txt"); -dest = getFolder("Chrome"); -err = File.move(source, dest); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/move" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/remove/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/remove/index.html deleted file mode 100644 index 0838d0a68d..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/remove/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: remove -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/remove -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/remove ---- -<p> </p> -<h3 id="remove" name="remove">remove</h3> -<p>Efface un fichier spécifié.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int remove( FileSpecObject file ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>remove</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>file</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier à effacer.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/remove" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/rename/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/rename/index.html deleted file mode 100644 index f4c9147a62..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/rename/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: rename -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/rename -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/rename ---- -<p> </p> -<h3 id="rename" name="rename">rename</h3> -<p>Renomme le fichier spécifié.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int rename( FileSpecObject fichier, Chaîne nouveauNom ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>rename</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>fichier</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le fichier à renommer.</dd> - <dt> - <code>nouveauNom</code></dt> - <dd> - Le nouveau nom terminal (ou nœud terminal) du fichier.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/rename" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/size/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/size/index.html deleted file mode 100644 index 752f615dc5..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/size/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: size -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/size -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/size ---- -<p> </p> -<h3 id="size" name="size">size</h3> -<p>Retourne la taille en octets du fichier spécifié.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int size (Chaîne NativeFolderPath); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>size</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>NativeFolderPath</code></dt> - <dd> - Le chemin complet vers le fichier.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre représentant la taille, en octets, du fichier spécifié.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/size" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsgetshortname/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsgetshortname/index.html deleted file mode 100644 index c81608787b..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsgetshortname/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: windowsGetShortName -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/windowsGetShortName -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/windowsGetShortName ---- -<p> </p> -<h3 id="windowsGetShortName" name="windowsGetShortName">windowsGetShortName</h3> -<p>Retourne un chemin conforme à la convention de nommage des fichiers de Windows, version 8.3.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">string windowsGetShortName( Object localDirSpec ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>windowsRegisterServer</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un <code>FileSpecObject</code> représentant un répertoire obtenu par les méthodes <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a> ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a>.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une chaîne avec le nom raccourci windows. Si le chemin est déjà conforme à la convention de nommage 8.3, la valeur retournée est <code>NULL</code>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">fLongFilePath = getFolder(fProgram, "LongFileName.File"); -sShortFilePath = File.windowsGetShortName(fLongFilePath); -if(sShortFilePath) -{ - // fait quelque chose -} -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/windowsGetShortName" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsregisterserver/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsregisterserver/index.html deleted file mode 100644 index 1dc5de1345..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsregisterserver/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: windowsRegisterServer -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/windowsRegisterServer -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/windowsRegisterServer ---- -<p> </p> -<h3 id="windowsRegisterServer" name="windowsRegisterServer">windowsRegisterServer</h3> -<p><code>windowsRegisterServer</code> enregistre, dans la base de registre Windows, les <tt>dll</tt> installées.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int windowsRegisterServer( Objet localDirSpec ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>windowsRegisterServer</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un <code>FileSpecObject</code> représentant un répertoire obtenu par les méthodes <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a> ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a>.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">fileCdTool = getFolder("<a class="external" rel="freelink">file:///</a>", fAoD + "cdTool.dll"); -err = File.windowsRegisterServer(fileCdTool); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/windowsRegisterServer" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsshortcut/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsshortcut/index.html deleted file mode 100644 index 1d96217e38..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_file/méthodes/windowsshortcut/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: windowsShortcut -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_File/Méthodes/windowsShortcut -translation_of: Archive/Mozilla/XPInstall/Reference/File_Object/Methods/windowsShortcut ---- -<p> </p> -<h3 id="windowsShortcut" name="windowsShortcut">windowsShortcut</h3> -<p>Crée un raccourci Windows vers le logiciel installé.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int WindowsShortcut( - FolderObject aTarget, - FolderObject aShortcutPath, - String aDescription, - FolderObject aWorkingPath, - String aParams, - FolderObject aIcon, - Number aIconId); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>windowsShortcut</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>aTarget</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le chemin absolu (nom de fichier inclus) vers le fichier pour lequel on veut créer un raccourci.</dd> - <dt> - <code>aShortcutPath</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le chemin absolu (nom de fichier exclu) vers l'emplacement où le raccourci sera créé.</dd> - <dt> - <code>aDescription</code></dt> - <dd> - Chaîne de description du raccourci à utiliser comme nom de raccourci, avec l'extension <tt>.lnk</tt> (ne pas mettre l'extension dans la chaîne).</dd> - <dt> - <code>aWorkingPath</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le chemin absolu vers le répertoire de travail depuis lequel <code>aTarget</code> sera exécuté.</dd> - <dt> - <code>aParams</code></dt> - <dd> - Paramètres requis par aTarget.</dd> - <dt> - <code>aIcon</code></dt> - <dd> - Un objet - <i> - FileSpecObject</i> - représentant le chemin absolu (nom de fichier inclus) vers un fichier contenant l'icône. Le format de fichier peut être <tt>.ico</tt>, <tt>.dll</tt>, <tt>.exe</tt> ou tout autre fichier binaire contenant des icônes.</dd> - <dt> - <code>aIconId</code></dt> - <dd> - Index de l'icône depuis aIcon à utiliser pour ce raccourci.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Exemples/File.windowsShortcut">File.windowsShortcut</a> dans les exemples de scripts.</p> -<p><span class="comment">Interwiki Langages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/File_Object/Methods/windowsShortcut" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/index.html deleted file mode 100644 index c2ef84f7a1..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Objet Install -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object ---- -<p> </p> - -<h2 id="Install" name="Install">Install</h2> - -<p>Utilisez l'objet <code>Install</code> pour gérer le téléchargement et l'installation d'un logiciel à partir du gestionnaire d'installations XPI.</p> - -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> - -<p>L'objet <code>Install</code> est principalement utilisé dans les scripts d'installation. Dans tous les cas, l'objet <code>Install</code> est implicite, comme l'objet <code>window</code> dans les scripts de pages Web, et n'a pas besoin d'être mis en préfixe des méthodes de l'objet. Les deux lignes suivantes, par exemple, sont équivalentes :</p> - -<pre class="eval">f = getFolder("Program"); -f = Install.getFolder("Program"); -</pre> - -<p>Un script d'installation est composé d'appels à l'objet <code>Install</code> et possède généralement la structure suivante :</p> - -<dl> - <dt>Initialisation de l'installation</dt> - <dd>Appelle initInstall avec le nom de l'installation et les informations nécessaires d'enregistrement et de version.</dd> - <dt>Ajout des fichiers pour l'installation</dt> - <dd>Ajoute les fichiers à installer en appelant getFolder pour obtenir les objets <code>fichier</code> et passe ces références objet à addFile autant de fois que nécessaire.</dd> - <dt>Exécution de l'installation</dt> - <dd>Vérifie que les fichiers ont été ajoutés avec succès (c'est-à-dire, en vérifiant les <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">codes d'erreur retournés</a> depuis les principales méthodes de l'installation), et poursuit l'installation si tout est correct :</dd> -</dl> - -<pre class="eval">performOrCancel(); -function performOrCancel() -{ - if (0 == getLastError()) - performInstall(); - else - cancelInstall(); -} -</pre> - -<p>Pour des exemples de scripts complets, voir des <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall#Exemples">exemples de scripts</a>.</p> - -<p><span class="comment">Interwiki Languages Links</span></p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/adddirectory/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/adddirectory/index.html deleted file mode 100644 index 00aebd4753..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/adddirectory/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: addDirectory -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/addDirectory -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/addDirectory ---- -<p> </p> -<h3 id="addDirectory" name="addDirectory">addDirectory</h3> -<p>Extrait un répertoire entier dans un emplacement temporaire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">public int addDirectory ( - Chaîne xpiSourcePath); - -public int addDirectory ( - Chaîne registryName, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); - -public int addDirectory ( - Chaîne registryName, - Chaîne version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); - -public int addDirectory ( - Chaîne registryName, - Chaîne version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath, - Booléen forceUpdate); - -public int addDirectory ( - Chaîne registryName, - InstallVersion version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath, - Booléen forceUpdate); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>addDirectory</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>registryName</code></dt> - <dd> - Le chemin, dans la - <i> - Client Version Registry</i> - , du répertoire racine dans lequel les fichiers seront installés. Ce paramètre peut être un chemin absolu (commençant par un /), tel que <code>/royalairways/RoyalSW/executable</code> ou un chemin relatif (ne commençant pas par un /), tel que <code>executable</code>. Un chemin absolu est utilisé comme spécifié. Un chemin relatif est ajouté au nom d'enregistrement du paquetage comme spécifié par la paramètre <code>package</code> de la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a>. Ce paramètre peut également être vide, dans ce cas le paramètre <code>xpiSourcePath</code> est utilisé comme un chemin relatif. Remarquez que le chemin de registre n'est pas l'emplacement du logiciel sur l'ordinateur, il s'agit de l'emplacement des informations concernant le logiciel dans la - <i> - Client Version Registry</i> - .</dd> - <dt> - <code>version</code></dt> - <dd> - Un objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a> ou une <code>Chaîne</code> de 1 à 4 valeurs entières délimitées par des points, telle que <code>1.17.1999.1517</code>. Pour les variantes de cette méthode, sans argument de version, la valeur de <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a> sera utilisée.</dd> - <dt> - <code>xpiSourcePath</code></dt> - <dd> - Une chaîne spécifiant l'emplacement du répertoire dans l'archive <tt>xpi</tt>. Une chaîne vide ("") entraîne la création d'un sous-répertoire dans le registre sans extraire aucun fichier, ce qui peut être utile lors de la mise à jour d'un paquetage contenant des sous-composants, qui peuvent être mis à jour séparément. Lorsque <code>xpiSourcePath</code> est une chaîne vide, <code>registryName</code> ne peut pas être nul.</dd> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un objet représentant un répertoire. Le fichier est installé dans ce répertoire sur la machine de l'utilisateur. Vous pouvez créer cet objet en passant une chaîne représentant le répertoire à la méthode <code>getFolder</code>.</dd> - <dt> - <code>subdir</code></dt> - <dd> - Le nom d'un répertoire à ajouter à <code>localDirSpec</code>, en utilisant '/' comme séparateur de chemin sans considération des conventions d'écriture de la plate-forme. Si <code>subdir</code> est absent, <code>null</code> ou <code>""</code>, les noms de fichiers sont ajoutés directement au nom du répertoire spécifié par <code>localDirSpec</code>.</dd> - <dt> - <code>flags</code></dt> - <dd> - Un champ optionnel, réservé pour un usage futur. Passe 0 comme valeur par défaut.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un code d'erreur entier. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>. Dans certains cas, <code>addDirectory</code> peut retourner d'autres erreurs.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>addDirectory</code> met les fichiers du répertoire spécifié dans un emplacement temporaire. Pour déplacer les fichiers et tous les autres sous-composants vers leurs emplacements finaux, appelez la méthode <code>performInstall</code> après avoir ajouté avec succès tous les sous-composants. Voir également les notes à propos des binaires Macintosh dans <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/addDirectory" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/addfile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/addfile/index.html deleted file mode 100644 index daf8850363..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/addfile/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: addFile -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/addFile -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/addFile ---- -<p> </p> -<h3 id="addFile" name="addFile">addFile</h3> -<p>Extrait un sous-composant unique dans un répertoire temporaire. Met en file d'attente le sous-composant pour son ajout dans la - <i> - Client Version Registry</i> - et son installation dans le répertoire final.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">public int addFile ( - Chaîne registryName, - InstallVersion version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath, - Booléen forceUpdate); - -public int addFile ( - Chaîne registryName, - Chaîne version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath, - Booléen forceUpdate); - -public int addFile ( - Chaîne xpiSourcePath); - -public int addFile ( - Chaîne registryName, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); - -public int addFile ( - Chaîne registryName, - Chaîne version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>addFile</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>registryName</code></dt> - <dd> - Le chemin dans la - <i> - Client Version Registry</i> - concernant le fichier. Ce paramètre peut être un chemin absolu (commençant par /), tel que <code>/royalairways/RoyalSW/executable</code> ou un chemin relatif (ne commençant pas par /), tel que <code>executable</code>. Généralement, les chemins absolus ne sont utilisés que pour composants partagés, ou les composants provenant d'autres éditeurs, tel que <code>/Microsoft/shared/msvcrt40.dll</code>. Généralement, les chemins relatifs le sont par rapport au chemin principal spécifié dans la méthode <code>initInstall</code>. Ce paramètre peut également être vide, dans ce cas le paramètre <code>xpiSourcePath</code> est utilisé comme un chemin relatif. Remarquez que le chemin de registre n'est pas l'emplacement du logiciel sur l'ordinateur, il s'agit de l'emplacement des informations concernant le logiciel dans la - <i> - Client Version Registry</i> - .</dd> - <dt> - <code>version</code></dt> - <dd> - Un objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a> ou une <code>Chaîne</code> de 1 à 4 valeurs entières délimitées par des points, telle que <code>1.17.1999.1517</code>. Pour les variantes de cette méthode sans argument de version, la valeur de <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a> sera utilisée.</dd> - <dt> - <code>xpiSourcePath</code></dt> - <dd> - Une chaîne spécifiant l'emplacement du fichier dans l'archive <tt>xpi</tt>.</dd> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un objet représentant un répertoire. Le fichier est installé dans ce répertoire sur la machine de l'utilisateur. Vous pouvez créer cet objet en passant une chaîne représentant le répertoire à la méthode <code>getFolder</code>.</dd> - <dt> - <code>relativeLocalPath</code></dt> - <dd> - Un chemin relatif au paramètre <code>localDirSpec</code>. Le fichier est installé dans ce répertoire sur la machine de l'utilisateur. Vous devez toujours utiliser des barres obliques (/) dans ce chemin, sans considération pour les conventions d'écritures du système d'exploitation. Si ce paramètre n'est pas renseigné ou <code>NULL</code>, <code>xpiSourcePath</code> est utilisé.</dd> - <dt> - <code>flags</code></dt> - <dd> - Un champ optionnel, réservé pour un usage futur. Passe 0 comme valeur par défaut.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un code d'erreur entier. Pour la liste des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>addFile</code> met le fichier dans un répertoire temporaire. Pour le déplacer, ainsi que tous les autres fichiers, vers son emplacement final, appelez la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a> après avoir ajouté avec succès tous les fichiers.</p> -<div class="note"> - Note : Si vous installez des fichiers binaires sur un Macintosh, soyez attentif à ce que le format binaire de ces fichiers doit être <code>AppleSingle</code> pour que les informations de ressources soient installées proprement. Certains logiciels de transfert de fichiers convertissent les binaires Apple dans ce format si vous les transférez d'un Macintosh vers une machine Unix/Windows avant de compresser ces fichiers sur la machine de destination.</div> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">var xpiSrc = "file.txt"; -initInstall("Ajout d'un fichier", - "addFile", - "1.0.1.7", - 1); -f = getFolder("Program"); -setPackageFolder(f); -addFile(xpiSrc); -if (0 == getLastError()) - performInstall(); -else - cancelInstall();</pre> -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/addFile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/alert/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/alert/index.html deleted file mode 100644 index dbc61fd1c0..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/alert/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: alert -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/alert -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/alert ---- -<p> </p> -<h3 id="alert" name="alert">alert</h3> -<p>La fonction <code>alert</code> affiche une boîte de dialogue modale avec un message représentant l'entrée.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="/fr/Référence_de_l'API_XPInstall/Objet_Install" title="fr/Référence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">void alert ( chaîne de message ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Bien qu'il soit plus courant d'entrer une chaîne pour afficher une boîte d'alerte, l'unique paramètre d'entrée de <code>alert()</code> peut être une valeur de n'importe quel type de données. Vous pouvez, par exemple, entrer une référence à un objet et voir cet objet affiché comme une chaîne dans la boîte d'alerte.</p> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Rien.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/alert" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/cancelinstall/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/cancelinstall/index.html deleted file mode 100644 index 26b6e38789..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/cancelinstall/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: cancelInstall -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/cancelInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/cancelInstall ---- -<p> </p> -<h3 id="cancelInstall" name="cancelInstall">cancelInstall</h3> -<p>Annule l'installation d'un logiciel, exécute un nettoyage des fichiers temporaires.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">void cancelInstall() -void cancelInstall( int errorCode ) -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Aucun.</p> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. L'argument optionnel est un code d'erreur qui peut être retourné à la page de déclenchement. Pour la plupart des cas, il est recommandé d'utiliser l'un des codes standards. Mais un script peut, en fait, retourner tout entier valide. Pour une liste des valeurs possibles, et les <code>errorCode</code> personnalisés créés par l'auteur du script d'installation, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Utilisez le code suivant pour annuler ou pour finaliser une installation, basé sur une variable que vous aurez définie précédemment dans votre code :</p> -<pre class="eval">initInstall("Royal Airways TripPlanner","/RoyalAirways/ -TripPlanner","1.0.0.0"); -... -err = getLastError(); -if (!err) - performInstall(); -else - cancelInstall(err); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/cancelInstall" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/confirm/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/confirm/index.html deleted file mode 100644 index 5f34e55971..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/confirm/index.html +++ /dev/null @@ -1,212 +0,0 @@ ---- -title: confirm -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/confirm -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/confirm ---- -<p> </p> -<h3 id="confirm" name="confirm">confirm</h3> -<p>Affiche une boîte de dialogue modale de confirmation.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int confirm( Chaîne aText ); -</pre> -<pre class="eval">int confirm( Chaîne aText, - Chaîne aDialogTitle, - Nombre aButtonFlags, - Chaîne aButton0Title, - Chaîne aButton1Title, - Chaîne aButton2Title, - Chaîne aCheckMsg, - Objet aCheckState ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Pour la seconde syntaxe, la méthode étendue <code>confirm()</code> est supportée depuis Gecko 1.8. Elle accepte jusqu'à 8 paramètres. Dans les versions précédentes de Gecko seule la première syntaxe était supportée, méthode à un paramètre, qui retournera une erreur pour la forme étendue. Voir les notes à la fin de ce document pour une manière sûre d'implémenter une procédure de secours.</p> -<dl> - <dt> - <code>aText</code></dt> - <dd> - La chaîne à afficher dans la boîte de confirmation. Cette chaîne est généralement sous la forme d'un message pour l'utilisateur (par exemple : « Êtes-vous sûr de vouloir effacer le(s) fichier(s) sélectionné(s) ? »).</dd> -</dl> -<dl> - <dt> - <code>aDialogTitle</code></dt> - <dd> - La chaîne à utiliser comme titre de la boîte de dialogue. La valeur par défaut est - <i> - Confirm</i> - (ou son équivalent localisé).</dd> -</dl> -<dl> - <dt> - <code>aButtonFlags</code></dt> - <dd> - Un ensemble de - <i> - flags</i> - définissant les boutons devant s'afficher dans la boîte de dialogue. La valeur est calculée en multipliant la position correspondante du bouton avec une constante de titre de bouton pour chaque bouton, puis en ajoutant les résultats et toutes autres options (voir <b>Autre constantes</b>).</dd> -</dl> -<dl> - <dd> - <b>Constantes de position des boutons</b> - <ul> - <li>BUTTON_POS_0: Le premier bouton logique</li> - <li>BUTTON_POS_1: Le deuxième bouton logique</li> - <li>BUTTON_POS_2: Le troisième bouton logique</li> - </ul> - </dd> -</dl> -<dl> - <dd> - <b>Constantes des titres des boutons</b> - <ul> - <li>BUTTON_TITLE_OK: Un bouton - <i> - OK</i> - </li> - <li>BUTTON_TITLE_CANCEL: Un bouton - <i> - Annuler</i> - </li> - <li>BUTTON_TITLE_YES: Un bouton - <i> - Oui</i> - </li> - <li>BUTTON_TITLE_NO: Un bouton - <i> - Non</i> - </li> - <li>BUTTON_TITLE_SAVE: Un bouton - <i> - Enregistrer</i> - </li> - <li>BUTTON_TITLE_DONT_SAVE: Un bouton - <i> - Ne pas enregistrer</i> - </li> - <li>BUTTON_TITLE_REVERT: Un bouton - <i> - Précédent</i> - </li> - <li>BUTTON_TITLE_IS_STRING: Titre personnalisé spécifié par le paramètre correspondant <code>aButtonXTitle</code></li> - </ul> - </dd> -</dl> -<dl> - <dd> - <b>Autres constantes</b> - <ul> - <li>BUTTON_POS_0_DEFAULT: Définit le bouton 0 comme bouton par défaut. Sauf indication contraire, c'est la valeur par défaut.</li> - <li>BUTTON_POS_1_DEFAULT: Définit le bouton 1 comme bouton par défaut.</li> - <li>BUTTON_POS_2_DEFAULT: Définit le bouton 2 comme bouton par défaut.</li> - <li>BUTTON_DELAY_ENABLE: Spécifie que les boutons ne doivent être actifs que passé un certain délai. Ceci ne s'applique qu'aux bouton 0 et 2, mais pas au bouton 1 (le bouton - <i> - Annuler</i> - ).</li> - <li>STD_OK_CANCEL_BUTTONS: Utilisez cela plutôt que les constantes ci-dessus pour avoir les boutons standard - <i> - OK</i> - et - <i> - Annuler</i> - . Si vous n'utilisez pas <code>aButtonFlags</code>, c'est l'argument par défaut.</li> - <li>STD_YES_NO_BUTTONS: Utilisez cela plutôt que les constantes ci-dessus pour avoir les boutons standard - <i> - Oui</i> - et - <i> - Non</i> - .</li> - </ul> - </dd> -</dl> -<dl> - <dd> - <b>Avertissement :</b> Ne faites aucune hypothèse quant au placement des boutons, l'implémentation de base peut librement décider de la place de chacun des trois boutons. Les exemples suivants montrent le résultat de l'appel de la fonction <code>confirm()</code> avec trois boutons 0='A', 1='B' et 2='C'. - <dl> - <dd> - <img align="none" alt="Firefox sous Linux"></dd> - <dd> - <img align="none" alt="Suite Mozilla sous Win32"></dd> - </dl> - </dd> - <dd> - Il est donc recommandé de n'utiliser que deux boutons dans la mesure du possible, et de garder à l'esprit que le bouton 1 à la même valeur de retour que « fenêtre fermée » (voir ci-dessous).</dd> -</dl> -<dl> - <dt> - <code>aButton0Title</code></dt> - <dd> - Titre personnalisé pour le bouton 0.</dd> -</dl> -<dl> - <dt> - <code>aButton1Title</code></dt> - <dd> - Titre personnalisé pour le bouton 1.</dd> -</dl> -<dl> - <dt> - <code>aButton2Title</code></dt> - <dd> - Titre personnalisé pour le bouton 2.</dd> -</dl> -<dl> - <dt> - <code>aCheckMsg</code></dt> - <dd> - Une chaîne à afficher comme étiquette d'une case à cocher.</dd> -</dl> -<dl> - <dt> - <code>aCheckState</code></dt> - <dd> - Un objet avec une propriété - <i> - valeur</i> - booléenne représentant l'état de la case à cocher : lorsque la boîte de dialogue s'affiche, sa case à cocher sera cochée lorsque la valeur de cet objet est <code>true</code>. Après la sélection d'un bouton (ou la fermeture de la fenêtre) par l'utilisateur, la propriété est mise à jour selon l'état de la case à cocher.</dd> -</dl> -<pre class="eval">var check = { value: false }; -var button = confirm("Êtes-vous sûr de vouloir installer FooBar 0.1?", - "Confirmation", - STD_YES_NO_BUTTONS, - null, - null, - null, - "Install FluxCompensator 0.4 as well", - check); -</pre> -<h4 id="Retour" name="Retour">Retour</h4> -<p>La valeur retournée est un entier indiquant quel bouton l'utilisateur a sélectionné :</p> -<table class="standard-table"> - <tbody> - <tr> - <td class="header">Valeur</td> - <td class="header">Bouton</td> - </tr> - <tr> - <td>0</td> - <td>'Annuler' ou bouton 1. <b>Également: l'utilisateur a fermé la fenêtre de dialogue</b></td> - </tr> - <tr> - <td>1</td> - <td>'OK' ou bouton 0</td> - </tr> - <tr> - <td>2</td> - <td>Le troisème bouton</td> - </tr> - </tbody> -</table> -<p>Les versions précédentes de l'API XPInstall mentionnaient que la valeur de retour de <code>confirm()</code> était un booléen. C'est incorrect, <code>confirm()</code> retourne toujours un nombre entier (0 ou 1 dans les versions antérieures à pre-Gecko-1.8).</p> -<h4 id="Notes" name="Notes">Notes</h4> -<p>La meilleure méthode pour détecter le support des boîtes de dialogue personnalisées est de déterminer l'existence des constantes de bouton. Les autres approches (par exemple, comparaison des buildID) ne sont pas recommandées.</p> -<pre class="eval">if ("BUTTON_POS_0" in Install) { - // Utilisation de la méthode étendue de confirm() -} else { - // Utilisation de la méthode classique de confirm() -} -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/confirm" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/deleteregisteredfile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/deleteregisteredfile/index.html deleted file mode 100644 index 91ca177e45..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/deleteregisteredfile/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: deleteRegisteredFile -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/deleteRegisteredFile -translation_of: >- - Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/deleteRegisteredFile ---- -<p> </p> -<h3 id="deleteRegisteredFile" name="deleteRegisteredFile">deleteRegisteredFile</h3> -<p>(Netscape 6 et Mozilla ne supportent pas cette méthode)</p> -<p>Efface le fichier spécifié et supprime son entrée dans la - <i> - Client Version Registry</i> - .</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int deleteRegisteredFile - (Chaîne registryName); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>deleteRegisteredFile</code> a la paramètre suivant :</p> -<dl> - <dt> - <code>registryName</code></dt> - <dd> - Le chemin dans la - <i> - Client Version Registry</i> - du fichier à effacer.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>deleteRegisteredFile</code> efface le fichier spécifié et supprime son entrée dans la - <i> - Client Version Registry</i> - . Si le fichier est en cours d'utilisation, le nom du fichier qui doit être effacé est enregistré et Netscape 6 essaiera de l'effacer à chaque lancement jusqu'à ce qu'il arrive à l'effacer. Cette méthode est utilisée pour effacer des fichiers qui ne peuvent pas être supprimés par la méthode <code>uninstall</code>, pour supprimer des fichiers qui ne sont plus utilisés ou dont le nom a changé.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/deleteRegisteredFile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/execute/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/execute/index.html deleted file mode 100644 index c1053c5399..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/execute/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: execute -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/execute -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/execute ---- -<p> </p> -<h3 id="execute" name="execute">execute</h3> -<p>Lance un fichier dans l'archive d'installation.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int execute ( - Chaîne xpiSourcePath [, Booléen blocking]); -</pre> -<pre class="eval">int execute ( - Chaîne xpiSourcePath, - Chaîne args [, Booléen blocking]); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>execute</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>xpiSourcePath</code></dt> - <dd> - Le chemin du fichier à extraire et à exécuter. Notez que ce chemin pointe dans l'archive <tt>xpi</tt> elle-même.</dd> - <dt> - <code>args</code></dt> - <dd> - Un paramètre chaîne passé à l'exécutable. Ignoré sous Mac OS. Voir les notes ci-dessous.</dd> - <dt> - <code>blocking</code></dt> - <dd> - Une valeur booléenne qui spécifie si l'installation doit ou non attendre la fin de l'exécution du fichier avant de continuer. La valeur par défaut est <code>false</code>. Voir les notes ci-dessous. Le paramètre <code>blocking</code> n'est pas disponible comme partie de cette méthode dans les versions antérieures de Netscape 6.1/Mozilla 0.9.3.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un code d'erreur entier. Pour la liste des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>execute</code> extrait le fichier spécifié depuis l'archive <tt>xpi</tt> vers un fichier temporaire.</p> -<p>Le code doit appeler la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a> pour réellement exécuter le fichier. Cette méthode peut être utilisée pour lancer un installeur - <i> - InstallShield</i> - ou tout autre exécutable d'installation stocké dans l'archive <tt>xpi</tt>.</p> -<h5 id="Ex.C3.A9cution_des_fichiers_install.C3.A9s" name="Ex.C3.A9cution_des_fichiers_install.C3.A9s">Exécution des fichiers installés</h5> -<div class="note"> - <b>Note :</b> Si le fichier qu'on veut exécuter est l'un de ceux à installer (contrairement à un installeur exécutable qui sera effacé après utilisation), alors, il faut utiliser la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/execute">execute</a> de l'<a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">objet File</a>. <code>File.execute()</code> exécute un fichier installé (tel que le navigateur) après son installation et est généralement placé à la fin du script d'installation et en dehors du bloc principal.</div> -<p>La méthode <code>execute</code> de l'<a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">objet Install</a>, d'un autre côté, efface l'exécutable de son emplacement temporaire une fois son exécution achevée. L'argument optionnel <code>blocking</code>, lorsqu'il est défini à <code>true</code>, spécifie que l'installation doit attendre que l'exécutable finisse avant de procéder à la prochaine commande d'installation mise en file d'attente. Si ce paramètre n'est pas défini et qu'un exécutable ne faisant pas partie de l'installation est lancé, une erreur survient lors du redémarrage du navigateur.</p> -<h5 id="Passage_d.27arguments_.C3.A0_l.27ex.C3.A9cutable" name="Passage_d.27arguments_.C3.A0_l.27ex.C3.A9cutable">Passage d'arguments à l'exécutable</h5> -<p>Le paramètre <code>args</code>, lorsqu'il est présent, passe une chaîne à l'exécutable comme paramètres de ligne de commande. La ligne suivante, par exemple, passe le paramètre de ligne de commande <code>-c</code> à l'exécutable :</p> -<pre class="eval">err = file.execute(myfile, "-c", true); -</pre> -<p>Lorsqu'on désire passer plus d'un paramètre à l'exécutable, il est nécessaire de formater la chaîne <code>args</code> de façon particulière afin que les paramètres puissent être cassés et passés séparément comme requis. En général, il est possible d'utiliser les guillemets uniques pour la chaîne <code>args</code> et les doubles guillemets pour délimiter les arguments de ligne de commande dans la chaîne. Les règles d'analyse suivantes s'appliquent :</p> -<ul> - <li>Les doubles guillemets sont traités comme des guillemets simples, les guillemets simples sont ignorés par l'exécutable mais valides dans la méthode <code>execute()</code>.</li> - <li>Les guillemets simples extérieurs encadrant la chaîne <code>args</code> sont éliminés lorsque la chaîne est passée à l'exécutable.</li> - <li>Les guillemets échappés, ou - <i> - inversés</i> - , sont passés à l'exécutable. Tous les autres cas d'inversion sont ignorés.</li> -</ul> -<p>Cela signifie qu'afin de passer trois arguments en ligne de commande (-c, -d et -s) à l'exécutable, il est nécessaire de formater la chaîne <code>args</code> comme suit :</p> -<pre class="eval">err = file.execute(myfile, '"-c""-d""-s"', true); -</pre> -<p>Techniquement, en considérant les règles ci-dessus, il est possible de passer les mêmes arguments avec la ligne suivante, mais le résultat sera moins lisible :</p> -<pre class="eval">err = file.execute(myfile, "\"-c\"\"-d\"\"-s\"", true); -</pre> -<p>Voir également la note sur les binaires Macintosh dans <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a>.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<div class="noinclude"> - </div> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/execute" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/gestalt/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/gestalt/index.html deleted file mode 100644 index f3b597571d..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/gestalt/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: gestalt -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/gestalt -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/gestalt ---- -<p> </p> -<h3 id="gestalt" name="gestalt">gestalt</h3> -<p>(Macintosh Uniquement)<br> - Récupère les informations sur le système d'exploitation.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int gestalt ( Chaîne selecteur ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>gestalt </code> a le paramètre suivant :</p> -<dl> - <dt> - <code>selecteur</code></dt> - <dd> - Le code sélecteur de l'information que vous voulez.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Retourne l'information demandée. Le format dépend du code sélecteur spécifié dans le paramètre <code>selecteur</code>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>gestalt</code> est une classe enveloppante pour la fonction <code>gestalt</code> de la boîte à outils Macintosh. Pour plus d'informations, voir <a class="external" href="http://developer.apple.com/documentation/mac/OSUtilities/OSUtilities-2.html">Inside Macintosh: Operating System Utilities (en)</a> (obsolète). Cette méthode retourne <code>null</code> sur les plate-formes Unix et Microsoft Windows.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/deleteRegisteredFile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getcomponentfolder/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getcomponentfolder/index.html deleted file mode 100644 index b97f211388..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getcomponentfolder/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: getComponentFolder -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/getComponentFolder -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/getComponentFolder ---- -<p> </p> -<h3 id="getComponentFolder" name="getComponentFolder">getComponentFolder</h3> -<p>Retourne un objet représentant le répertoire dans lequel le composant est installé.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">Object getComponentFolder - (Chaîne registryName); - -Object getComponentFolder ( - Chaîne registryName, - Chaîne subDirectory); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getComponentFolder</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>registryName</code></dt> - <dd> - Dans la - <i> - Client Version Registry</i> - , le chemin du composant dont on veut obtenir le répertoire d'installation.</dd> - <dt> - <code>subDirectory</code></dt> - <dd> - Une chaîne qui spécifie le nom d'un sous-répertoire. Si le sous-répertoire spécifié n'existe pas, il est créé. Ce paramètre est disponible dans Netscape 6 et peut être sensible à la casse (selon le système d'exploitation).</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un objet représentant le répertoire dans lequel le composant est installé ou <code>NULL</code> si le composant ne peut pas être trouvé ou si <code>subDirectory</code> se réfère à un fichier qui existe déjà.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getComponentFolder</code> récupère l'emplacement d'un paquetage logiciel précédemment installé. Généralement, cette méthode est utilisée avec les méthodes <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> ou <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a></code>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/getComponentFolder" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getfolder/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getfolder/index.html deleted file mode 100644 index fa87bbb90e..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getfolder/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: getFolder -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/getFolder -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/getFolder ---- -<p> </p> -<h3 id="getFolder" name="getFolder">getFolder</h3> -<p>Retourne un objet représentant l'un des répertoires standard.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">FileSpecObject getFolder ( - Chaîne FolderName); -</pre> -<pre class="eval">FileSpecObject getFolder ( - Chaîne folderName, - Chaîne subDirectory); -</pre> -<pre class="eval">FileSpecObject getFolder ( - Objet localDirSpec, - Chaîne subDirectory); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getFolder</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>folderName</code></dt> - <dd> - Une chaîne représentant l'un des répertoires standard de Netscape. Il y a deux ensembles de valeurs possibles pour ce paramètre. Le premier ensemble contient tous les emplacements indépendants de la plate-forme. Le second ensemble contient les emplacements spécifiques à une plate-forme donnée. Vous êtes encouragés à utiliser des emplacements indépendants à la plate-forme. Voir la liste des emplacements des deux ensembles dans la section <a href="#Description">Description</a>.</dd> - <dt> - <code>subDirectory</code></dt> - <dd> - Une chaîne qui définit le nom d'un sous-répertoire. Si ce dernier n'existe pas, il est créé. Ce paramètre est disponible dans Netscape 6 et ultérieur et peut être sensible à la casse (en fonction du système d'exploitation).</dd> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un objet <code>FileSpecObject</code> représentant un répertoire obtenu par les méthodes <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a> ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a>.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un code d'erreur entier. Pour la liste des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getFolder</code> obtient un objet représentant l'un des répertoires standard de Netscape, qui sera utilisé avec les méthodes <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> et <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinProfile">getWinProfile</a></code>. La valeur de <code>folderName</code> doit être l'une des valeurs suivantes (informations basées sur la branche stable Mozilla 1.7, peuvent également être valables pour d'autres versions) :</p> -<table style="margin-left: 2em;"> - <tbody> - <tr> - <td> - <p><code>"Chrome" </code><br> - <code>"Components" </code><br> - <code>"Current User" </code><br> - <code>"Defaults" </code><br> - <code>"<a class="external" rel="freelink">file:///</a>" </code><br> - <code>"OS Drive" </code><br> - <code>"Plugins" </code><br> - <code>"Preferences" </code><br> - <code>"Profile" </code><br> - <code>"Program" </code><br> - <code>"Temporary" </code></p> - </td> - <td> - <p><code>"Mac Apple Menu" </code><br> - <code>"Mac Control Panel" </code><br> - <code>"Mac Desktop"</code><br> - <code>"Mac Documents"</code><br> - <code>"Mac Extension"</code><br> - <code>"Mac Fonts"</code><br> - <code>"Mac Shutdown"</code><br> - <code>"Mac Startup"</code><br> - <code>"Mac System"</code><br> - <code>"Mac Trash"</code><br> - <code>"Mac Preferences"</code></p> - </td> - <td> - <p><code>"MacOSX Default Download" </code><br> - <code>"MacOSX Home" </code><br> - <code>"MacOSX Internet Sites" </code><br> - <code>"MacOSX Local Applications" </code><br> - <code>"MacOSX Local Desktop" </code><br> - <code>"MacOSX Local Documents" </code><br> - <code>"MacOSX Local Frameworks" </code><br> - <code>"MacOSX Local Internet PlugIn" </code><br> - <code>"MacOSX Local Preferences" </code><br> - <code>"MacOSX Movie Documents" </code><br> - <code>"MacOSX Music Documents" </code><br> - <code>"MacOSX Picture Documents" </code><br> - <code>"MacOSX User Applications" </code><br> - <code>"MacOSX User Desktop" </code><br> - <code>"MacOSX User Documents" </code><br> - <code>"MacOSX User Frameworks" </code><br> - <code>"MacOSX User Internet PlugIn" </code><br> - <code>"MacOSX User Preferences" </code></p> - </td> - <td> - <p><code>"Unix Lib" </code><br> - <code>"Unix Local" </code></p> - </td> - </tr> - <tr> - <td> - <p><code>"Windows" </code><br> - <code>"Win AppData" </code><br> - <code>"Win Common Files" </code><br> - <code>"Win Desktop" </code><br> - <code>"Win Desktop Common" </code><br> - <code>"Win Program Files" </code><br> - <code>"Win Programs" </code><br> - <code>"Win Programs Common" </code><br> - <code>"Win StartMenu" </code><br> - <code>"Win StartMenu Common" </code><br> - <code>"Win Startup" </code><br> - <code>"Win Startup Common" </code><br> - <code>"Win System" </code></p> - </td> - </tr> - </tbody> -</table> -<p>La forme <code><a class="external" rel="freelink">file:///</a></code> n'est valide que lorsque le paramètre <code>subDirectory</code> est utilisé. Elle doit être au format URL <code>file:</code> amputée de la partie <code><a class="external" rel="freelink">file:///</a></code>. Par exemple :</p> -<pre class="eval">mydir = getFolder("<a class="external" rel="freelink">file:///</a>", "c|/mysoftco/somedir"); -</pre> -<p>Remarquez l'utilisation de barre oblique (/), quelque soit la plate-forme.</p> -<p>Les dossiers dont les noms commencent par <tt>Win</tt>, <tt>Mac</tt> ou <tt>Unix</tt> sont spécifiques à leur plate-forme respective. Il faut donc faire attention à leur utilisation, car ils rendent l'installation spécifique à une plate-forme.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour récupérer un objet représentant le répertoire standard des plugins, on peut utiliser l'appel suivant :</p> -<pre class="eval">plugindir = getFolder("Plugins"); -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/getFolder" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getlasterror/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getlasterror/index.html deleted file mode 100644 index a937cbb5e5..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getlasterror/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: getLastError -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/getLastError -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/getLastError ---- -<p> </p> -<h3 id="getLastError" name="getLastError">getLastError</h3> -<p>Retourne le plus récent code d'erreur non nul.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int getLastError (); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Aucun.</p> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Le plus récent code d'erreur non nul. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getLastError</code> est utilisée pour obtenir le plus récent code d'erreur non nul survenu depuis l'appel de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></code> ou de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/resetError">resetError</a></code>. Cette méthode permet de différer la vérification des codes d'erreur chaque fois que <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> ou <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a></code> sont appelées jusqu'au dernier appel de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> ou de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a></code>.</p> -<p>La méthode <code>getLastError</code> ne retourne pas d'erreur pour les méthodes qui retournent des objets, telle que la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></code>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>L'exemple suivant appelle la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getLastError">getLastError</a></code> après une série d'appels <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> :</p> -<pre class="eval">addFile("npplug", ...); -addFile("/MS/Shared/ctl3d.dll", ...); -addFile("/NetHelp/royalplug/royalhelp.html",...); -err = getLastError(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/getLastError" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinprofile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinprofile/index.html deleted file mode 100644 index 2f0f4ca506..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinprofile/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: getWinProfile -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/getWinProfile -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/getWinProfile ---- -<p> </p> -<h3 id="getWinProfile" name="getWinProfile">getWinProfile</h3> -<p>(Microsoft Windows uniquement)</p> -<p>Construit un objet pour travailler avec un fichier <tt>.ini</tt> de Windows.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">WinProfile getWinProfile ( - Objet dossier, - Chaîne fichier); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getWinProfile</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>dossier</code></dt> - <dd> - Un objet représentant un répertoire. Cet objet est créé en passant une chaîne représentant le répertoire à la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a>.</dd> - <dt> - <code>fichier</code></dt> - <dd> - Un chemin relatif vers un fichier d'initialisation dans le répertoire spécifié par le paramètre <code>dossier</code>, tel que <code>royal/royal.ini</code>.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un objet <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile">WinProfile</a></code>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getWinProfile</code> crée un objet pour manipuler le contenu d'un fichier <tt>.ini</tt> de Windows. Une fois cet objet créé, on peut appeler cette méthode pour récupérer des chaînes du fichier ou lui en ajouter. Pour plus d'informations sur l'objet retourné, voir <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile">WinProfile</a></code>.</p> -<p>Cette méthode retourne <code>null</code> sur les plate-formes Unix et Macintosh.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour éditer le fichier <code>win.ini</code>, on crée un <code>WinProfile</code> par cet appel :</p> -<pre class="eval">var myWinProfileObj = - getWinProfile (getFolder("Windows"), "win.ini"); -</pre> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/getWinProfile" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinregistry/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinregistry/index.html deleted file mode 100644 index d38d05deb0..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/getwinregistry/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: getWinRegistry -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/getWinRegistry -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/getWinRegistry ---- -<p> </p> -<h3 id="getWinRegistry" name="getWinRegistry">getWinRegistry</h3> -<p>(Windows uniquement) Construit un objet pour travailler avec le registre de Microsoft Windows.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">WinReg getWinRegistry(); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Aucun.</p> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getWinRegistry</code> est utilisée pour créer un objet qui permettra de manipuler le contenu de la base de registre de Microsoft Windows. Une fois cet objet créé, on peut appeler sa méthode pour récupérer ou modifier le contenu du registre. Pour plus d'informations sur l'objet retourné, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a>.</p> -<p>Cette méthode retourne <code>NULL</code> sur les plate-formes Unix et Macintosh.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/getWinRegistry" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/index.html deleted file mode 100644 index ea30f5f01e..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Méthodes -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods ---- -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addDirectory">addDirectory</a></dt> - <dd> - Décompacte un sous-répertoire entier.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></dt> - <dd> - Décompacte un fichier unique.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/alert">alert</a></dt> - <dd> - Affiche une boîte de dialogue contenant un message d'alerte et un bouton « OK ».</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/cancelInstall">cancelInstall</a></dt> - <dd> - Abandonne l'installation du logiciel.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/confirm">confirm</a></dt> - <dd> - Affiche une boîte de dialogue de confirmation contenant le message spécifié et les boutons « OK » et «Annuler ». Permet également des intitulés de bouton personnalisés et les cases à cocher.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/deleteRegisteredFile">deleteRegisteredFile</a></dt> - <dd> - Efface le fichier spécifié et son entrée dans le - <i> - Client Version Registry</i> - .</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/execute">execute</a></dt> - <dd> - Extrait un fichier de l'archive <tt>xpi</tt> dans un répertoire temporaire et le programme pour une exécution ultérieure.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/gestalt">gestalt</a></dt> - <dd> - Récupère les informations concernant le système d'exploitation (Mac OS uniquement).</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a></dt> - <dd> - Retourne un objet représentant le répertoire dans lequel le composant est installé.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></dt> - <dd> - Retourne un objet représentant un répertoire, à utiliser avec la méthode <code>addFile</code>.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getLastError">getLastError</a></dt> - <dd> - Retourne le code d'erreur non nul le plus récent.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinProfile">getWinProfile</a></dt> - <dd> - Construit un objet pour travailler avec un fichier <code>.ini</code> de Windows.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinRegistry">getWinRegistry</a></dt> - <dd> - Construit un objet pour travailler avec la base de registre de Windows.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></dt> - <dd> - Initialise l'installation du logiciel et de la version indiqués.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/loadResources">loadResources</a></dt> - <dd> - Retourne un objet dont les propriétés sont des chaînes localisées, chargées depuis le fichier de propriétés spécifié.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/logComment">logComment</a></dt> - <dd> - Ajoute une ligne de commentaire au rapport d'installation.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/patch">patch</a></dt> - <dd> - Applique un ensemble de différences entre deux versions.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a></dt> - <dd> - Finalise l'installation du logiciel.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/refreshPlugins">refreshPlugins</a></dt> - <dd> - Rafraîchit la liste des plugins disponibles pour le navigateur.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/registerChrome">registerChrome</a></dt> - <dd> - Enregistre le chrome avec le registre chrome.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/resetError">resetError</a></dt> - <dd> - Réinitialise à zéro un code d'erreur sauvegardé.</dd> - <dt> - <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/setPackageFolder">setPackageFolder</a></dt> - <dd> - Définit le dossier par défaut du paquetage qui est enregistré avec le nœud racine</dd> -</dl> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/initinstall/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/initinstall/index.html deleted file mode 100644 index a5a8394f71..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/initinstall/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: initInstall -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/initInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/initInstall ---- -<p> </p> -<h3 id="initInstall" name="initInstall">initInstall</h3> -<p>Initialise l'installation du logiciel spécifié et de sa version.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int initInstall ( - Chaîne displayName, - Chaîne package, - InstallVersion version, - int flags); -</pre> -<pre class="eval">int initInstall ( - Chaîne displayName, - Chaîne package, - Chaîne version, - int flags); -</pre> -<pre class="eval">int initInstall ( - Chaîne displayName, - Chaîne package, - Chaîne version); -</pre> -<p>int initInstall (</p> -<pre class="eval"> String displayName, - String package, - InstallVersion version); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>initInstall</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>displayName</code></dt> - <dd> - Une <code>chaîne</code> qui contient le nom du logiciel à installer. Le nom du logiciel est visible par l'utilisateur.</dd> - <dt> - <code>package</code></dt> - <dd> - Le chemin dans la - <i> - Client Version Registry</i> - concernant le logiciel (par exemple : <code>Plugins/Adobe/Acrobat</code> ou <code>/royalairways/RoyalPI/</code>).</dd> - <dd> - Fournir un nom vide ou <code>null</code> est une erreur.</dd> - <dd> - Le chemin peut être absolu ou relatif. Un chemin relatif est relatif à l'espace de nommage de Netscape 6. Un chemin relatif doit débuter par <code>plugins/</code>, pour être relatif à la partie plugins de cet espace de nommage ou par <code>java/download/</code>, pour être relatif à la partie Java. Toutes les autres parties de l'espace de nommage de Netscape 6 sont réservées à l'usage de Netscape.</dd> - <dd> - La - <i> - Client Version Registry</i> - est une description hiérarchique du logiciel enregistré pour être utilisé par Netscape 6. Le chemin fourni ici n'est pas l'emplacement du logiciel sur le disque local, il correspond aux informations concernant le logiciel dans le registre. La distinction est importante lorsque vous ajoutez des composants avec la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code>.</dd> - <dt> - <code>version</code></dt> - <dd> - Un objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a> ou une <code>Chaîne</code> représentant la version du paquetage à installer. Lorsque <code>version</code> est une <code>Chaîne</code> il peut contenir jusqu'à quatre nombres entiers, délimités par des points, tel que <code>1.17.1999.1517</code>.</dd> - <dt> - <code>flags</code></dt> - <dd> - Un champ optionnel, réservé pour un usage futur. Passe <code>0</code> comme valeur par défaut.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>initInstall</code> initialise l'installation du logiciel spécifié. Elle doit être appelée immédiatement après le constructeur. Il est erroné d'appeler toute autre méthode de l'objet <code>Install</code> avant l'appel de <code>initInstall</code>.</p> -<p>Après l'appel de la méthode <code>initInstall</code>, le script d'installation doit appeler les méthodes <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a> ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/cancelInstall">cancelInstall</a> avant qu'il ne se termine. Si ces appels ne sont pas faits, Netscape 6 ne sera pas en mesure de nettoyer proprement les fichiers temporaires après la fin de l'exécution du script.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour débuter l'installation du plugin - <i> - Royal Airways</i> - , on peut utiliser ce code :</p> -<pre class="eval">initInstall("Royal Airways TripPlanner","/RoyalAirways/ -TripPlanner","1.0.0.0"); -... -err = getLastError(); -if (!err) - performInstall(); -else - cancelInstall(err); -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/initInstall" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/loadresources/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/loadresources/index.html deleted file mode 100644 index 55aa01674d..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/loadresources/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: loadResources -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/loadResources -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/loadResources ---- -<p> </p> -<h3 id="loadResources" name="loadResources">loadResources</h3> -<p>Charge un fichier de propriétés.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">Object loadResources( Chaîne xpiPath ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>L'unique paramètre d'entrée de la méthode <code>loadResources</code> est une chaîne représentant le chemin vers le fichier de propriétés dans une archive <tt>xpi</tt> dans laquelle les paires clefs/valeurs sont définies.</p> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un objet <a href="fr/JavaScript">JavaScript</a> dont les noms des propriétés sont des clefs de ce fichier et dont les valeurs sont les chaînes.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Le format du fichier de propriétés attendu par la méthode <code>loadResources</code> est le même que celui des fichiers de propriétés du chrome local. Cette méthode est utilisée pour internationaliser les scripts d'installation en permettant à l'installeur de récupérer les valeurs des chaînes localisées depuis un fichier annexe. Faites attention à ce que le paramètre spécifie correctement le fichier de l'archive <tt>xpi</tt> et non celui du système de fichiers, comme indiqué dans l'exemple ci-dessous.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Soit un <tt>xpi</tt> avec la structure interne suivante :</p> -<pre class="eval">install.js -bin/res_eg_2.properties -bin/somefile.exe -bin/... -</pre> -<p>Les lignes suivantes récupèrent les propriétés comme objet JavaScript et rendent les valeurs accessibles avec la syntaxe habituelle des fichiers <tt>.property</tt> :</p> -<pre class="eval">resEg2Obj = loadResources("bin/res_eg_2.properties"); -dump( resEg2Obj.title ) -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/loadResources" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/logcomment/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/logcomment/index.html deleted file mode 100644 index 5647853f3e..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/logcomment/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: logComment -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/logComment -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/logComment ---- -<p> </p> -<h3 id="logComment" name="logComment">logComment</h3> -<p>Ajoute une ligne de commentaire dans le journal d'installation.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int logComment( Chaîne aComment ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>L'unique paramètre d'entrée de la méthode <code>logComment</code> est une chaîne dont la valeur sera écrite dans le journal pendant le processus d'installation.</p> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Le journal d'installation est créé, par défaut, dans le répertoire du produit si c'est possible (où se trouve l'exécutable du navigateur). Si l'installation n'a pas les droits requis, le journal d'installation est créé dans le répertoire du profile utilisateur. Respectivement, ces répertoires correspondent aux mots clefs - <i> - Program</i> - et - <i> - Current User</i> - pour la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/logComment" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/patch/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/patch/index.html deleted file mode 100644 index eaa583ee2c..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/patch/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: patch -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/patch -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/patch ---- -<p> </p> -<h3 id="patch" name="patch">patch</h3> -<p>Met à jour un composant existant.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int patch ( - Chaîne registryName, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); -</pre> -<pre class="eval">int patch ( - Chaîne registryName, - InstallVersion version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); -</pre> -<pre class="eval">int patch ( - Chaîne registryName, - Chaîne version, - Chaîne xpiSourcePath, - Objet localDirSpec, - Chaîne relativeLocalPath); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>patch</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>registryName</code></dt> - <dd> - Le chemin dans la - <i> - Client Version Registry</i> - du composant à patcher. Ce paramètre peut être un chemin absolu, tel que <code>/royalairways/RoyalSW/executable</code> ou un chemin relatif, tel que <code>executable</code>.</dd> - <dd> - Généralement, les chemins absolus ne sont utilisés que pour les composants partagés, ou ceux qui proviennent d'un autre éditeur, tel que <code>/Microsoft/shared/msvcrt40.dll</code>.</dd> - <dd> - Généralement, les chemins relatifs sont relatifs au chemin principal spécifié dans la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></code>. Ce paramètre peut également être vide, auquel cas le paramètre <code>xpiSourcePath</code> est utilisé comme un chemin relatif.</dd> - <dd> - Le chemin du registre n'est pas l'emplacement du logiciel sur le disque local, il correspond à l'emplacement des informations concernant le logiciel dans la - <i> - Client Version Registry</i> - .</dd> - <dt> - <code>version</code></dt> - <dd> - Un objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a> ou une <code>Chaîne</code> comportant jusqu'à quatre nombres entiers délimités par des points, tel que "<code>1.17.1999.1517</code>". Pour les variantes de cette méthode sans argument <code>version</code>, la valeur de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></code> sera utilisée.</dd> - <dt> - <code>xpiSourcePath</code></dt> - <dd> - Une chaîne spécifiant l'emplacement des différents fichiers contenus dans l'archive <tt>xpi</tt>.</dd> - <dt> - <code>localDirSpec</code></dt> - <dd> - Un objet représentant le répertoire où se trouve le sous-composant à patcher. Cet objet est créé en passant un chaîne représentant le répertoire à la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></code>.</dd> - <dt> - <code>relativeLocalPath</code></dt> - <dd> - Un chemin relatif vers le paramètre <code>localDirSpec</code> qui identifie le sous-composant à patcher. Il faut toujours utiliser des barres obliques (/) dans ce chemin, sans considération pour les conventions du système d'exploitation. Si ce paramètre est blanc ou <code>NULL</code>, <code>xpiSourcePath</code> est utilisé.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>patch</code> met à jour un composant en appliquant un ensemble de différences entre les deux versions connues. L'ensemble des différences est au format <code>GDIFF</code> et est créé à l'aide de l'utilitaire <code>NSDiff</code>.</p> -<p>Un patch ne peut être appliqué qu'entre deux versions connues. Si la version existante du fichier ne correspond pas à la somme de contrôle stockée dans le fichier <code>GDIFF</code>, <code>patch</code> retourne une erreur sans appliquer le patch.</p> -<p>Après avoir appliqué les différences, la méthode <code>patch</code> compare la somme de vérification ( - <i> - checksum</i> - en anglais) du fichier résultant par rapport à celle stockée dans le fichier <code>GDIFF</code>. Si les sommes ne correspondent pas, la version originale du fichier est préservée, la version patchée est supprimée et un code d'erreur est retourné.</p> -<p>Tout processus d'installation unique peut appliquer plusieurs patches sur un même fichier. Si la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a></code> indique qu'un redémarrage est nécessaire, <code>patch</code> peut ne pas fonctionner dans le processus <a href="fr/XPInstall">XPInstall</a> en cours jusqu'à ce qu'un redémarrage soit exécuté.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/patch" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/performinstall/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/performinstall/index.html deleted file mode 100644 index cd90e320fd..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/performinstall/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: performInstall -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/performInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/performInstall ---- -<p> </p> -<h3 id="performInstall" name="performInstall">performInstall</h3> -<p>Exécute l'installation réelle du logiciel. Déplace tous les composants vers leur emplacement final, lance toutes les exécutions différées et enregistre le paquetage et tous ses composants dans la - <i> - Client Version Registry</i> - .</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int performInstall(); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Aucun.</p> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>. Dans certains cas, cette méthode peut retourner d'autres codes d'erreur. Il peut arriver d'obtenir une erreur d'enregistrement.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Le code suivant est utilisé pour annuler ou pour finaliser une installation, il est basé sur une variable définie précédemment dans le code :</p> -<pre class="eval">initInstall("Royal Airways TripPlanner", - "/RoyalAirways/TripPlanner", - "1.0.0.0"); -... -err = getLastError(); -if (!err) - performInstall(); -else - cancelInstall(err); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/performInstall" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/refreshplugins/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/refreshplugins/index.html deleted file mode 100644 index b8c13894e8..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/refreshplugins/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: refreshPlugins -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/refreshPlugins -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/refreshPlugins ---- -<p> </p> -<h3 id="refreshPlugins" name="refreshPlugins">refreshPlugins</h3> -<p>Rafraîchit la liste des plugins enregistrés pour le navigateur.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int refreshPlugins( [ aReloadPages ] ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>refreshPlugins</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>aReloadPages</code></dt> - <dd> - <code>aReloadPages</code> est une valeur booléenne optionnelle indiquant si vous voulez ou non recharger les pages Web ouvertes après le rafraîchissement de la liste des plugins.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Aucun.</p> -<h4 id="Description" name="Description">Description</h4> -<p><code>refreshPlugins</code> permet d'enregistrer de nouveaux plugins sans avoir à redémarrer le navigateur. Lorsque cette méthode est utilisée dans un script d'installation, comme dans l'exemple ci-dessous, on peut installer de nouveaux plugins et les utiliser pour afficher les média demandés dans une page Web sans interrompre l'expérience utilisateur.</p> -<div class="note"> - Note : La méthode <code>refreshPlugins</code> doit être appelée après la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a></code> qui initie l'installation réelle.</div> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">// Installe une DLL dans le répertoire "Plugins" - // Installe un XPT dans le répertoire "Components" - var xpiSrc = "NPMCult3DP.dll"; - var xpiSrc2 = "nsIC3DPScriptablePeer.xpt"; - initInstall( - "Cult3D Plugin File", - "@cycore.com/Cult3D;version=1.0.0", - "1.0.0"); - setPackageFolder(getFolder("Plugins")); - addFile(xpiSrc); - addFile("",xpiSrc2,getFolder("Components"),""); - var err = getLastError(); - if (err == SUCCESS) - { - err = performInstall(); - if (err == SUCCESS) - refreshPlugins(); - } - else - cancelInstall(err);</pre> -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/refreshPlugins" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/registerchrome/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/registerchrome/index.html deleted file mode 100644 index 2248e87d1d..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/registerchrome/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: registerChrome -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/registerChrome -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/registerChrome ---- -<p> </p> -<h3 id="registerChrome" name="registerChrome">registerChrome</h3> -<p>Enregistre chrome dans le registre Chrome.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int registerChrome( - SWITCH, - srcDir, - xpiPath); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>registerChrome</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>SWITCH</code></dt> - <dd> - <code>SWITCH</code> est le switch chrome indiquant le type de fichier à enregistrer. <code>SKIN</code> est utilisé pour les thèmes, <code>LOCALE</code> est utilisé pour les paquetages de localisation. <code>PACKAGE</code>, un troisième type possible, est équivalent à <code>SKIN AND/OR LOCALE</code> et assure que tout dans le <tt>xpi</tt> sera enregistré. Une option finale pour ce paramètre est <code>DELAYED_CHROME</code>, qui enregistre le switch uniquement après un redémarrage du navigateur.</dd> -</dl> -<p>Il est possible de combiner les switches comme dans l'exemple ci-dessous.</p> -<dl> - <dt> - <code>srcDir</code></dt> - <dd> - <code>srcDir</code> est un objet <code>FileSpecObject</code> représentant la destination source de l'installation. Les - <i> - FileSpecObjects</i> - requis par cette fonction, sont créés en utilisant la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a> de l'objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a>.</dd> -</dl> -<dl> - <dt> - <code>xpiPath</code></dt> - <dd> - <code>xpiPath</code> est le chemin, dans le <tt>xpi</tt>, où se trouve le fichier <code>contents.rdf</code> définissant le chrome. Par exemple, - <i> - locale/myLocale/aim</i> - pointe vers le sous-répertoire <code>locale/myLocale/aim</code> du même fichier <tt>xpi</tt> que le script d'installation.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>. Dans certains cas, cette méthode peut retourner d'autres codes d'erreur. Il peut arriver d'obtenir une erreur d'enregistrement.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Lorsque le troisième paramètre est omis (pointage vers un emplacement précis dans l'archive <tt>xpi</tt>), cette fonction est utilisée de façon dépréciée. Dans ce cas, <code>registerChrome</code> supporte l'ancien format des archives d'installation, dans lequel le fichier <code>manifest.rdf</code> était toujours situé au plus haut niveau de l'archive d'installation. <code>registerChrome</code> ne nécessite alors pas de chemin dans l'archive, comme il le requiert maintenant afin de localiser le format plus flexible du fichier <code>contents.rdf</code> des archives d'installation.</p> -<p>Il est possible de regarder dans le fichier <code>installed-chrome.txt</code> du répertoire <code>chrome</code> pour savoir où et comment la fonction <code>registerChrome</code> a enregistré le paquetage dans le registre chrome.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Cet exemple suppose que votre archive <code>xpi</code> se trouve dans le dossier <code>Plugins</code> et que le fichier <code>RDF</code> est dans le sous-dossier <code>resources</code> de l'archive.</p> -<div class="note"> - <p>Vous devriez évitez cet appel (au cas où vous feriez un copier/coller depuis un ancien script d'installation) pour l'installation de plugin pour Firefox 2.x. Il n'est pas certain de ce que produira cet « enregistrement chrome ».</p> -</div> -<pre class="eval">registerChrome( - PACKAGE | DELAYED_CHROME, - getFolder("Plugins"), - "resources"); -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/registerChrome" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/reseterror/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/reseterror/index.html deleted file mode 100644 index 1b5c5d56ed..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/reseterror/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: resetError -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/resetError -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/resetError ---- -<p> </p> -<h3 id="resetError" name="resetError">resetError</h3> -<p>Réinitialise à zéro un code d'erreur enregistré.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">void resetError (); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Aucun.</p> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Aucun.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>resetError</code> réinitialise à zéro tout code d'erreur enregistré. Pour plus d'informations, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getLastError">getLastError</a>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour réinitialiser à zéro le dernier code d'erreur :</p> -<pre class="eval">resetError(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/resetError" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/setpackagefolder/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/setpackagefolder/index.html deleted file mode 100644 index 73ab053260..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/méthodes/setpackagefolder/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: setPackageFolder -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Méthodes/setPackageFolder -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/setPackageFolder ---- -<p> </p> -<h3 id="setPackageFolder" name="setPackageFolder">setPackageFolder</h3> -<p>Définit le dossier par défaut du paquetage.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">void setPackageFolder ( - Objet dossier); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>setPackageFolder</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>dossier</code></dt> - <dd> - Un objet représentant un répertoire. Cet objet est créé en passant une chaîne représentant le répertoire aux méthodes <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getFolder">getFolder</a></code> ou <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getComponentFolder">getComponentFolder</a></code>.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Aucun.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>setPackageFolder</code> définit le dossier par défaut du paquetage qui est enregistré avec le nœud racine. Lorsque le dossier du paquetage est défini, il est utilisé comme dossier par défaut pour les formulaires de la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/addFile">addFile</a></code> et de toutes celles qui ont un paramètre optionnel <code>localDirSpec</code>.</p> -<p>Cette méthode ne devrait être appelée qu'une seule fois, et devrait toujours l'être immédiatement après l'appel de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/initInstall">initInstall</a></code>. Au cas où elle serait appelée plusieurs fois, le dernier dossier défini est le dossier qui sera enregistré dans la - <i> - Client Version Registry</i> - et utilisé par défaut pour les autres installations.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Methods/setPackageFolder" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/propriétés/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/propriétés/index.html deleted file mode 100644 index 65e0ccaa9f..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_install/propriétés/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Propriétés -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_Install/Propriétés -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Properties ---- -<p> </p> -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> -<dl> - <dt> - <code>archive</code></dt> - <dd> - Le chemin local complet de l'archive après son téléchargement dans le dossier temporaire spécifique de la plate-forme (par exemple <code>C:\TEMP\argstest.xpi</code>)</dd> - <dt> - <code>arguments</code></dt> - <dd> - Les arguments peuvent être passés par les API de déclenchement en attachant un <code>?</code> puis la chaîne de l'argument à l'URL du xpi : <code>startSoftwareUpdate(<span class="nowiki">"http://webserver/argstest.xpi?ARGUMENT_STRING"</span>)</code> donnera <code>ARGUMENT_STRING</code> # comme valeur de <code>Install.arguments</code>. Remarquez que les espaces dans la chaîne de l'argument sont autorisés. Tout ce qui ce trouve après le point d'interrogation est traité comme une chaîne qui devient la propriété <code>Install.arguments</code>.</dd> - <dt> - <code>buildID</code></dt> - <dd> - L'ID de compilation de l'application, sous la forme 20041231. Remarquez qu'à cause des différentes branches de développement (différentes versions de Gecko avec différentes fonctionnalités peuvent être compilées le même jour), l'utilisation de cette propriété pour « détecter » la version de l'application peut produire un résultat erroné. De plus, cet ID peut être égale à <code>0</code> pour les compilations personnalisées.</dd> - <dt> - <code>jarfile</code></dt> - <dd> - Alias pour <code>archive</code></dd> - <dt> - <code>platform</code></dt> - <dd> - Contient les informations sur la plate-forme de compilation et d'exécution de XPInstall. Par exemple, la valeur peut débuter par « Windows », « Macintosh » ou « X11 » (pour Unix/Linux). Pour plus de détails, voir le code correspondant dans la <a class="external" href="http://lxr.mozilla.org/mozilla/ident?i=GetInstallPlatform">méthode GetInstallPlatform de la classe nsInstall</a>.</dd> - <dt> - <code>url</code></dt> - <dd> - L'URL pleinement qualifiée du xpi (URL de fichier, URL http, URL ftp, etc.). Par exemple <code><span class="nowiki">http://dolfin/sgehani/zzz/ip.xpi</span></code>. Remarquez que, même si elle est déclenchée en utilisant des URL relatives, cela affichera l'URL complète (après qualification).</dd> -</dl> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/Install_Object/Properties" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installtrigger/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installtrigger/index.html deleted file mode 100644 index 0c7e9f279b..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installtrigger/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Objet InstallTrigger -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallTrigger -tags: - - Référence_de_l'API_XPInstall -translation_of: Web/API/InstallTrigger ---- -<p> </p> -<h2 id="InstallTrigger" name="InstallTrigger">InstallTrigger</h2> -<p>Un script de déclenchement sur une page Web utilise un objet <code>InstallTrigger</code> pour télécharger et installer un logiciel.</p> -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> -<p>Pour les installations simples, la méthode <code>install</code> sur l'objet <code>InstallTrigger</code> peut être la seule chose nécessaire dans le script d'installation.</p> -<p>Pour des installations plus complexes, vous pouvez avoir besoin d'utiliser les objet d'installation <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a> et/ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_File">File</a>. Dans tous les cas, vous devez déclencher le processus d'installation en créant un script sur une page Web dans lequel les méthodes <code>InstallTrigger</code> téléchargent le fichier <tt>xpi</tt> spécifié et « déclenchent » l'exécution du script <tt>install.js</tt> situé à la racine du <tt>xpi</tt>.</p> -<p>La principale méthode sur l'objet <code>InstallTrigger</code> est <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/install">install</a>, qui télécharge et installe un ou plusieurs paquetages logiciels archivés dans un fichier au format <tt>xpi</tt>. Ce qui suit est un exemple simple d'installation depuis une page Web :</p> -<pre class="eval">xpi={'XPInstall Dialog Display Name':'simple.xpi'}; -InstallTrigger.install(xpi); -</pre> -<p>Vous pouvez également utiliser l'objet <code>InstallTrigger</code> pour vérifier les versions de logiciels, installer des thèmes Netscape6/Mozilla et des paquetages de langues, et exécuter des installations multi-paquetages avec <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallTrigger/M%c3%a9thodes/install">install</a>.</p> -<p><span class="comment">Interwiki Langiages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallTrigger_Object", "ja": "ja/XPInstall_API_Reference/InstallTrigger_Object" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/index.html deleted file mode 100644 index c3a6bcd3fa..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Objet InstallVersion -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object ---- -<p> </p> -<h2 id="InstallVersion" name="InstallVersion">InstallVersion</h2> -<p>Les objets <code>InstallVersion</code> sont utilisés pour stocker des informations sur la version du logiciel.</p> -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> -<p>Cet objet et ses méthodes sont utilisés aussi bien lors du déclenchement d'un téléchargement, afin de vérifier si une version particulière doit être installée, que lors de l'installation d'un logiciel.</p> -<dl> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/init">init()</a></dt> - <dd> - Associe une version particulière à un objet <code>InstallVersion</code>.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/toString">toString()</a></dt> - <dd> - Convertit les différents formats de version en chaînes.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/compareTo">compareTo()</a></dt> - <dd> - Compare ces chaînes et indique les relations entre les deux versions.</dd> -</dl> -<p>Chacun des paramètres de version est également disponible en tant que propriété séparée de l'objet <code>InstallVersion</code>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/compareto/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/compareto/index.html deleted file mode 100644 index 7c27d6d29e..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/compareto/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: compareTo -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion/Méthodes/compareTo -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object/Methods/compareTo ---- -<p> </p> -<h3 id="compareTo" name="compareTo">compareTo</h3> -<p>Compare les informations de version spécifiées dans cet objet à celles spécifiées dans le paramètre <code>version</code>.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">compareTo ( InstallVersion version); -</pre> -<pre class="eval">compareTo ( String version); -</pre> -<pre class="eval">compareTo ( int major, int minor, int release, int build); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>compareTo</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>maj</code></dt> - <dd> - Le numéro de version majeur.</dd> - <dt> - <code>min</code></dt> - <dd> - Le numéro de version mineur.</dd> - <dt> - <code>rev</code></dt> - <dd> - Le numéro de révision.</dd> - <dt> - <code>bld</code></dt> - <dd> - Le numéro de compilation.</dd> - <dt> - <code>version</code></dt> - <dd> - Une chaîne représentant les informations de version au format <code>4.1.2.1234</code>.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Si les versions sont les mêmes, cette méthode retourne <code>0</code>. Si la version de cet objet représente une version plus petite (précédente) que celle représentée dans le paramètre <code>version</code>, cette méthode retourne un nombre négatif. Autrement, elle retourne un nombre positif. En particulier, cette méthode retourne l'un des nombres suivants :</p> -<dl> - <dt> - -4 </dt> - <dd> - La version de l'objet a un numéro majeur plus petit (plus ancien) que le paramètre <code>version</code>.</dd> - <dt> - -3 </dt> - <dd> - La version de l'objet a un numéro mineur plus petit (plus ancien) que le paramètre <code>version</code>.</dd> - <dt> - -2 </dt> - <dd> - La version de l'objet a un numéro de version plus petit (plus ancien) que le paramètre <code>version</code>.</dd> - <dt> - -1 </dt> - <dd> - La version de l'objet a un numéro de compilation plus petit (plus ancien) que le paramètre <code>version</code>.</dd> - <dt> - 0 </dt> - <dd> - Les numéros de version sont égaux ; les deux objets représentent la même version.</dd> - <dt> - 1 </dt> - <dd> - La version de l'objet a un numéro de compilation plus grand (plus récent) que le paramètre <code>version</code>.</dd> - <dt> - 2 </dt> - <dd> - La version de l'objet a un numéro de version plus grand (plus récent) que le paramètre <code>version</code>.</dd> - <dt> - 3 </dt> - <dd> - La version de l'objet a un numéro mineur plus grand (plus récent) que le paramètre <code>version</code>.</dd> - <dt> - 4 </dt> - <dd> - La version de l'objet a un numéro majeur plus grand (plus récent) que le paramètre <code>version</code>.</dd> -</dl> -<p>Les constantes suivantes sont définies et disponible pour vérifier la valeur retournée par <code>compareTo</code> :</p> -<ul> - <li><code>InstallVersion.MAJOR_DIFF</code></li> - <li><code>InstallVersion.MINOR_DIFF</code></li> - <li><code>InstallVersion.REL_DIFF</code></li> - <li><code>InstallVersion.BLD_DIFF</code></li> - <li><code>InstallVersion.EQUAL</code></li> - <li><code>InstallVersion.MAJOR_DIFF_MINUS</code></li> - <li><code>InstallVersion.MINOR_DIFF_MINUS</code></li> - <li><code>InstallVersion.REL_DIFF_MINUS</code></li> - <li><code>InstallVersion.BLD_DIFF_MINUS</code></li> -</ul> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Ce code est utilise la méthode <code>compareTo</code> pour déterminer si oui ou non la version 3.2.1 du logiciel « Royal Airways » a été précédemment installée :</p> -<pre class="eval">existingVI = InstallTrigger.getVersion("/royalairways/royalsw"); - -if ( existingVI.compareTo("3.2.1") <= 0 ) { - // ... procède à la mise à jour ... - } -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object/Methods/compareTo" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/index.html deleted file mode 100644 index 1b8e8ec247..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Méthodes -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion/Méthodes -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object/Methods ---- -<p> </p> -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/compareTo">compareTo()</a></dt> - <dd> - Compare les informations de version spécifiée dans l'objet à celles spécifiées dans le paramètre <code>version</code>.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/init">init()</a></dt> - <dd> - Initialise un objet <code>InstallVersion</code>.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion/M%c3%a9thodes/toString">toString()</a></dt> - <dd> - Convertit un objet <code>InstallVersion</code> en chaîne.</dd> -</dl> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object/Methods" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/init/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/init/index.html deleted file mode 100644 index df326e2a0f..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/init/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: init -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion/Méthodes/init -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object/Methods/init ---- -<p> </p> -<h3 id="init" name="init">init</h3> -<p>Initialise un objet <code>init</code>.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">init ( int maj, int min, int rev, int bld ); -</pre> -<pre class="eval">init ( String version ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>init</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>maj</code></dt> - <dd> - Le numéro de version majeur.</dd> - <dt> - <code>min</code></dt> - <dd> - Le numéro de version mineur.</dd> - <dt> - <code>rev</code></dt> - <dd> - Le numéro de révision.</dd> - <dt> - <code>bld</code></dt> - <dd> - Le numéro de compilation.</dd> - <dt> - <code>version</code></dt> - <dd> - Une chaîne représentant les informations de version au format <code>4.1.2.1234</code>.</dd> -</dl> -<p>Lorsque <code>maj</code>, <code>min</code>, <code>rev</code> et <code>bld</code> sont donnés comme paramètres, ils sont tout quatre obligatoires, mais ils peuvent tous être égaux à <code>0</code>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object/Methods/init" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/tostring/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/tostring/index.html deleted file mode 100644 index 8063509a39..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/méthodes/tostring/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: toString -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion/Méthodes/toString -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object/Methods/toString ---- -<p> </p> -<h3 id="toString" name="toString">toString</h3> -<p>Convertit un objet <code>InstallVersion</code> <code>init</code> en chaîne.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_InstallVersion">InstallVersion</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String version = InstallVersion.toString ( initObj ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>toString</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>initObj</code></dt> - <dd> - <code>initObj</code> est un objet <code>InstallVersion</code> dont la méthode <code>init</code> a été appelée.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Les nombres majeurs, mineurs, de révision et de compilation représentés dans une chaîne unique.</p> -<p>La fonction <code>init()</code> peut entrer le numéro de version comme une chaîne unique ou comme une série de paramètres représentant les numéros de versions de l'installation. Pour sortir le numéro de version d'un objet <code>InstallVersion</code> afin de la comparer avec les autres versions, on peut appeler <code>toString()</code> et récupérer la version sous forme de chaîne au format ""<code>maj.min.rev.bld</code>".</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">var vi = new InstallVersion(); -vi.init("999.888.777.666"); //Chaîne aléatoire -viString = vi.toString(); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object/Methods/toString" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/propriétés/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/propriétés/index.html deleted file mode 100644 index 01c7a3cf90..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_installversion/propriétés/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Propriétés -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_InstallVersion/Propriétés -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/InstallVersion_Object/Properties ---- -<p> </p> -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> -<dl> - <dt> - <code>major</code></dt> - <dd> - Élément le plus significatif de l'objet <code>InstallVersion</code>. Par exemple, la version majeure de Netscape 6 est <code>6</code>.</dd> -</dl> -<dl> - <dt> - <code>minor</code></dt> - <dd> - Second élément significatif de l'objet <code>InstallVersion</code>. Par exemple la version mineure de Netscape Communicator 4.7 est <code>7</code>.</dd> -</dl> -<dl> - <dt> - <code>release</code></dt> - <dd> - Second élément de moindre signification de l'objet <code>InstallVersion</code>.</dd> -</dl> -<dl> - <dt> - <code>build</code></dt> - <dd> - Élément de moindre signification de l'objet <code>InstallVersion</code>. Par exemple, le buildID, ou ID de compilation, de Netscape 6 est représenté par un datage au format AAAAMMJJHH : 2001031808 signifie que la compilation date de 2001, au mois de mars, le 18<sup>e</sup> jour du mois, à 8h00.</dd> -</dl> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/InstallVersion_Object/Properties" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/index.html deleted file mode 100644 index 2b3678e354..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/index.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Objet WinProfile -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinProfile -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/WinProfile_Object ---- -<h2 id="WinProfile" name="WinProfile">WinProfile</h2> -<p>(Microsoft Windows uniquement)</p> -<p>Cet objet peut être utilisé par les développeurs Windows pour manipuler le contenu d'un fichier <code>.ini</code> de Windows.</p> -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> -<p>Cet objet n'a pas de constructeur publique. À la place, vous construisez une instance de cet objet en appelant la méthode <code><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinProfile">getWinProfile</a></code> de l'objet <code><a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></code>.</p> -<p>Les deux méthodes de l'objet <code>WinProfile</code>, <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/WinPro/Objet_File/M%c3%a9thodes/getString">getString</a> et <a href="/fr/docs/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/WinPro/Objet_File/M%c3%a9thodes/writeString">writeString</a>, permettent de lire et d'écrire des données dans les paires de clefs/valeurs d'un fichier <code>.ini</code> de Windows.</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/getstring/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/getstring/index.html deleted file mode 100644 index 8d9f80bb76..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/getstring/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: getString -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinProfile/Méthodes/getString -translation_of: Archive/Mozilla/XPInstall/Reference/WinProfile_Object/Methods/getString ---- -<p> </p> -<h3 id="getString" name="getString">getString</h3> -<p>Récupère une valeur d'un fichier <code>.ini</code>.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile">WinProfile</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String getString ( String section, String key); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Cette méthode a les paramètres suivants :</p> -<dl> - <dt> - <code>section</code></dt> - <dd> - Le nom d'une section du fichier, tel que <code>boot</code> ou <code>drivers</code>.</dd> - <dt> - <code>key</code></dt> - <dd> - La clef de la section dont il faut retourner la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>La valeur de la clef ou une chaîne vide si rien n'a été trouvé.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Cette méthode <code>getString</code> est semblable à la fonction <code>getPrivateProfileString</code> de l'API de Windows. Contrairement à cette dernière, cette méthode ne supporte pas l'utilisation d'une clef vide pour retourner les listes des clefs de la section.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour récupérer le nom du fichier de fond d'écran depuis la section <code>desktop</code> du fichier <code>win.ini</code>, on utilise l'appel :</p> -<pre class="eval">ini = getWinProfile (getFolder("Windows"), "win.ini"); -var wallpaperValue = ini.getString ("Desktop", "Wallpaper"); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinProfile_Object/Methods/getString" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/index.html deleted file mode 100644 index 0c325a8588..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Méthodes -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinProfile/Méthodes -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/WinProfile_Object/Methods ---- -<p> </p> -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile/M%c3%a9thodes/getString">getString</a></dt> - <dd> - Récupère une valeur dans un fichier <code>.ini</code>.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile/M%c3%a9thodes/writeString">writeString</a></dt> - <dd> - Modifie une valeur dans un fichier <code>.ini</code>.</dd> -</dl> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinProfile_Object/Methods" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/writestring/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/writestring/index.html deleted file mode 100644 index 46ec4c3801..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winprofile/méthodes/writestring/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: writeString -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinProfile/Méthodes/writeString -translation_of: Archive/Mozilla/XPInstall/Reference/WinProfile_Object/Methods/writeString ---- -<p> </p> -<h3 id="writeString" name="writeString">writeString</h3> -<p>Changes a value in a .<code>ini</code> file.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinProfile">WinProfile</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">Boolean writeString ( String section, String key, String value); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Cette méthode a les paramètres suivants :</p> -<dl> - <dt> - <code>section</code></dt> - <dd> - Le nom d'une section du fichier, telle que <code>boot</code> ou <code>drivers</code>.</dd> - <dt> - <code>key</code></dt> - <dd> - La clef dans cette section dont on veut modifier la valeur.</dd> - <dt> - <code>value</code></dt> - <dd> - La nouvelle valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p><code>True</code> si correctement programmé, autrement, <code>false</code>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>writeString</code> est similaire à la fonction <code>WritePrivateProfileString</code> de l'API de Windows. Pour effacer une valeur existante, fournissez une valeur vide pour le paramètre <code>value</code>. Contrairement à la fonction <code>WritePrivateProfileString</code>, cette méthode ne supporte pas l'utilisation d'une clef vide pour effacer une section entière. Les valeurs ne seront écrites qu'après l'appel de la méthode <code>performInstall</code>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour définir le nom du fichier de fond d'écran depuis la section <code>Desktop</code> du fichier <code>win.ini</code>, on utilise cet appel :</p> -<pre class="eval">ini = getWinProfile (getFolder("Windows"), "win.ini"); -ini.writeString ("Desktop", "Wallpaper", "newpathname"); -</pre> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinProfile_Object/Methods/writeString" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/index.html deleted file mode 100644 index 84bff48cfa..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Objet WinReg -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object ---- -<p> </p> -<h2 id="WinReg" name="WinReg">WinReg</h2> -<p>(Microsoft Windows uniquement)</p> -<p>Cet objet peut être utilisé par les développeurs pour manipuler le contenu de la base de registre Windows.</p> -<h3 id="Pr.C3.A9sentation" name="Pr.C3.A9sentation">Présentation</h3> -<p>Cet objet n'a pas de constructeur public. À la place, vous devez construire une instance de cet objet en appelant la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/getWinRegistry">getWinRegistry</a></code> de l'objet <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install">Install</a></code>.</p> -<p>Ce document suppose que vous êtes déjà familier avec la base de registre de Windows. Pour plus d'informations sur elle, voir la documentation de l'API pour Windows.</p> -<p>Lors de la construction d'un objet <code>WinReg</code>, il est définit pour opérer avec <code>HKEY_CLASSES_ROOT</code> comme clef racine. Pour utiliser une clef racine différente, il faut utiliser la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setRootKey">setRootKey</a></code>.</p> -<p>Généralement, les valeurs de la base de registre sont des chaînes. Pour manipuler de telles chaînes, il faut utiliser les méthodes <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueString">getValueString</a></code> et <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueString">setValueString</a></code>. Pour manipuler des valeurs d'un autre type, il faut utiliser les méthodes <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValue">getValue</a></code> et <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValue">setValue</a></code>.</p> -<p>La lecture des valeurs de registre est immédiate. Cependant, l'écriture dans la base de registre est retardée jusqu'à l'appel de <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_Install/M%c3%a9thodes/performInstall">performInstall</a></code>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/createkey/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/createkey/index.html deleted file mode 100644 index 79b12fcd7e..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/createkey/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: createKey -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/createKey -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/createKey ---- -<p> </p> -<h3 id="createKey" name="createKey">createKey</h3> -<p>Ajoute une clef à la base de registre.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int createKey ( Chaîne subkey, Chaîne classname); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>createKey</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>classname</code></dt> - <dd> - Habituellement, une chaîne vide. Pour plus d'informations sur ce paramètre, voir la description de <code>RegCreateKeyEx</code> dans la documentation de l'API Windows.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>0 en cas de succès ou un nombre non nul si l'ordonnancement de la création a échoué. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>createKey</code> ajoute une clef à la base de registre. Il faut ajouter une clef au registre avant de pouvoir lui assigner une valeur.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/createKey" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletekey/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletekey/index.html deleted file mode 100644 index e05e7dabc8..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletekey/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: deleteKey -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/deleteKey -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/deleteKey ---- -<p> </p> -<h3 id="deleteKey" name="deleteKey">deleteKey</h3> -<p>Supprime une clef de la base de registre.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int deleteKey ( String subkey); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>deleteKey</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clef, tel que<code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>0 en cas de succès ; un nombre non nul si l'ordonnancement de la suppression a échoué. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/deleteKey" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletevalue/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletevalue/index.html deleted file mode 100644 index a69f08bcd9..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/deletevalue/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: deleteValue -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/deleteValue -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/deleteValue ---- -<p> </p> -<h3 id="deleteValue" name="deleteValue">deleteValue</h3> -<p>Supprime la valeur d'un clef arbitraire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int deleteValue ( Chaîne subkey, Chaîne valname); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>deleteValue</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_valeur/valeur à supprimer.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>0 en cas de succès ou un nombre non nul si la suppression a échouée.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/deleteValue" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumkeys/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumkeys/index.html deleted file mode 100644 index 760d620dcd..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumkeys/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: enumKeys -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/enumKeys -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/enumKeys ---- -<p> </p> -<h3 id="enumKeys" name="enumKeys">enumKeys</h3> -<p>Énumère les sous-clefs de registre de la clef donnée.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String enumKeys ( Chaîne key, int subkeyIndex ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>enumKeys</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>key</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>subkeyIndex</code></dt> - <dd> - Un entier représentant l'index base 0 de la clef dont on cherche la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Le nom en cas de succès ou <code>NULL</code> si la valeur référencée n'existe pas.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>enumKeys</code> peut être utilisée pour définir une itération dans les sous-clefs d'une clef donnée. L'exemple suivant montre comment utiliser la méthode <code>enumKeys</code> pour trouver le sous-répertoire des plugins dans les différentes installations des navigateurs basés sur Mozilla :</p> -<pre class="eval">var winreg = getWinRegistry(); -winreg.setRootKey(winreg.HKEY_LOCAL_MACHINE); -var index = 0; -var baseKey = "Software\\Mozilla"; -while ( (MozillaVersion = winreg.enumKeys(baseKey,index)) != null ) -{ - logComment("MozillaVersion = " + MozillaVersion); - subkey = baseKey + "\\" + MozillaVersion + "\\Extensions"; - pluginsDir = winreg.getValueString ( subkey, "Plugins" ); - if ( pluginsDir ) - logComment("pluginsDir = " + pluginsDir); - else - logComment("No plugins dir for " + baseKey + "\\" + MozillaVersion); - index++; -} -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/enumKeys" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumvaluenames/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumvaluenames/index.html deleted file mode 100644 index 8eddf182b8..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/enumvaluenames/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: enumValueNames -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/enumValueNames -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/enumValueNames ---- -<p> </p> -<h3 id="enumValueNames" name="enumValueNames">enumValueNames</h3> -<p>Énumère la valeur d'une clef donnée.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String enumValueNames ( Chaîne key, int subkeyIndex ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>enumValueNames</code> a les paramètres suivants</p> -<dl> - <dd> - </dd> - <dt> - <code>key</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>subkeyIndex</code></dt> - <dd> - Un entier représentant l'index base 0 de la clef dont on cherche la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>La valeur de la clef en tant que chaîne si l'opération réussit ou <code>NULL</code> si la sous-clef indiquée n'existe pas.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>enumValueNames</code> peut être utilisée pour exécuter une itération dans les valeurs d'une clef donnée. L'exemple suivant récupère la valeur d'une clef à l'aide de cette méthode :</p> -<pre class="eval">var winreg = getWinRegistry(); -winreg.setRootKey(winreg.HKEY_LOCAL_MACHINE); -v1 = winreg.enumValueNames("SOFTWARE\\Mozilla\\", 0); -logComment("The first subkey value of the Mozilla key: " + v1) -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/enumValueNames" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvalue/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvalue/index.html deleted file mode 100644 index 09accbd416..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvalue/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: getValue -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/getValue -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/getValue ---- -<p> </p> -<h3 id="getValue" name="getValue">getValue</h3> -<p>(Netscape 6 et Mozilla ne supportent pas cette méthode)</p> -<p>Récupère la valeur d'une clef arbitraire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">WinRegValue getValue ( Chaîne subkey, Chaîne valname); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getValue</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_la_valeur/valeur dont on veut récupérer la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un objet <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/WinRegValue">WinRegValue</a></code> représentant la valeur de la paire nom_de_la_valeur/valeur ou <code>null</code> s'il n'y a pas de valeur ou s'il se produit une erreur. Pour plus d'informations sur ces valeurs, voir <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/WinRegValue">WinRegValue</a></code>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getValue</code> récupère la valeur d'une clef arbitraire. Cette méthode est utilisée si la valeur voulue n'est pas une chaîne. Si la valeur est une chaîne, la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueString">getValueString</a></code> est plus adpatée.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/getValue" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluenumber/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluenumber/index.html deleted file mode 100644 index 72730a84dc..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluenumber/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: getValueNumber -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/getValueNumber -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/getValueNumber ---- -<p> </p> -<h3 id="getValueNumber" name="getValueNumber">getValueNumber</h3> -<p>Récupère la valeur d'un clef lorsque cette valeur est un nombre.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">Number getValueNumber ( Chaîne subkey, Chaîne valname); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getValueString</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_la_valeur/valeur dont on veut récupérer la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>La valeur du nombre de la clef spécifiée ou <code>null</code> s'il se produit une erreur, la valeur n'a pas été trouvée ou cette valeur n'est pas un nombre.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getValueNumber</code> récupère la valeur d'une clef. Si cette valeur n'est pas un nombre, on utilise la méthode <code>getValue</code>.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/getValueNumber" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluestring/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluestring/index.html deleted file mode 100644 index 176746ce8a..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/getvaluestring/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: getValueString -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/getValueString -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/getValueString ---- -<p> </p> -<h3 id="getValueString" name="getValueString">getValueString</h3> -<p>Récupère la valeur d'une clef lorsque cette valeur est une chaîne.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String getValueString ( Chaîne subkey, Chaîne valname); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>getValueString</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_la_valeur/valeur dont on veut récupérer la valeur.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Une chaîne représentant la valeur de la paire nom_de_la_valeur/valeur ou <code>null</code> si cela produit une erreur, si la valeur n'a pas été trouvée ou si la valeur n'est pas une chaîne.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>getValueString</code> récupère la valeur d'une chaîne. Si cette valeur n'est pas une chaîne, on utilise la méthode <code>getValue</code>.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/getValueString" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/index.html deleted file mode 100644 index df9d96ff76..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Méthodes -slug: Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes -tags: - - Référence_de_l'API_XPInstall -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods ---- -<p> </p> -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/createKey">createKey</a></dt> - <dd> - Ajoute une clef.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/deleteKey">deleteKey</a></dt> - <dd> - Supprime une clef.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/deleteValue">deleteValue</a></dt> - <dd> - Supprime la valeur d'un clef arbitraire.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/enumKeys">enumKeys</a></dt> - <dd> - Récupère les sous-clefs de registre de la clef donnée.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/enumValueNames">enumValueNames</a></dt> - <dd> - Récupère la valeur de la sous-clef donnée.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValue">getValue</a></dt> - <dd> - Récupère la valeur d'un clef arbitraire.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueNumber">getValueNumber</a></dt> - <dd> - Récupère la valeur d'une clef, lorsque cette valeur est un nombre entier.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/getValueString">getValueString</a></dt> - <dd> - Récupère la valeur d'une clef, lorsque cette valeur est une chaîne.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/isKeyWritable">isKeyWritable</a></dt> - <dd> - Retourne si la clef donnée est modifiable ou non.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/keyExists">keyExists</a></dt> - <dd> - Retourne si la clef donnée existe ou si elle est lisible.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/keyExists">setRootKey</a></dt> - <dd> - Change la clef racine à laquelle accéder.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValue">setValue</a></dt> - <dd> - Définit la valeur d'une clef arbitraire.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueNumber">setValueNumber</a></dt> - <dd> - Définit la valeur d'un clef, lorsque cette valeur est un nombre entier.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueString">setValueString</a></dt> - <dd> - Définit la valeur d'une clef, lorsque cette valeur est une chaîne.</dd> - <dt> - <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/valueExists">valueExists</a></dt> - <dd> - Retourne si la valeur donnée existe ou non.</dd> -</dl> -<p>Le constructeur <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/WinRegValue">WinRegValue</a> crée un objet <code>WinRegValue</code>.</p> -<p><span class="comment">Interwiki Languages Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/iskeywritable/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/iskeywritable/index.html deleted file mode 100644 index 8a95f850ed..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/iskeywritable/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: isKeyWritable -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/isKeyWritable -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/isKeyWritable ---- -<p> </p> -<h3 id="isKeyWritable" name="isKeyWritable">isKeyWritable</h3> -<p>Retourne si la clef est accessible en écriture ou non.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean isKeyWritable( chaîne key); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>isKeyWritable</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>key</code></dt> - <dd> - Une chaîne représentant le chemin de la clef.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une valeur booléenne : <code>true</code> si la clef est accessible en écriture ; <code>false</code> dans le cas contraire.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">winreg = getWinRegistry(); -if ( winreg != null ) -{ - winreg.setRootKey ( winreg.HKEY_LOCAL_MACHINE ); - if(winreg.isKeyWritable("SOFTWARE")) - { - //isKeyWritable retourne true - } - else - { - //isKeyWritable retourne false - } -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/isKeyWritable" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/keyexists/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/keyexists/index.html deleted file mode 100644 index e13a16cde3..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/keyexists/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: keyExists -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/keyExists -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/keyExists ---- -<p> </p> -<h3 id="keyExists" name="keyExists">keyExists</h3> -<p>Indique si la clef existe ou non.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean keyExists ( Chaîne key); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>keyExists</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>key</code></dt> - <dd> - Une chaîne représentant le chemin de la clef.</dd> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>Une valeur booléenne.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Si l'utilisateur n'a pas d'accès en lecture à la clef donnée, cette méthode retourne <code>false</code>.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">winreg = getWinRegistry(); -if ( winreg != null ) -{ - winreg.setRootKey( winreg.HKEY_LOCAL_MACHINE); - if(winreg.keyExists("SOFTWARE\\mozilla")) - { - - //keyExists retourne true - - } else { - - //keyExists retourne false - - } -} -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/keyExists" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setrootkey/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setrootkey/index.html deleted file mode 100644 index df3bb58d97..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setrootkey/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: setRootKey -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/setRootKey -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/setRootKey ---- -<p> </p> -<h3 id="setRootKey" name="setRootKey">setRootKey</h3> -<p>Change la clef racine à laquelle on veut accéder.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">void setRootKey ( int key ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>setRootKey</code> a le paramètre suivant :</p> -<dl> - <dt> - <code>key</code></dt> - <dd> - Un nombre entier représentant la clef racine dans la base de registre.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Aucun.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>setRootKey</code> change la clef racine.</p> -<p>Lorsqu'on crée un objet <code>WinReg</code>, il est défini pour accéder aux clefs de la section <code>HKEY_CLASSES_ROOT</code> de la base de registre. Si on désire accéder à des clefs d'une autre section, il est nécessaire d'utiliser cette méthode pour changer la clef racine.</p> -<p>Sur les plate-formes Windows 16-bits, <code>HKEY_CLASSES_ROOT</code> est l'unique valeur validerel et cette méthode n'a aucun effet.</p> -<p>Ces clefs racines sont représentées comme champs de l'objet <code>WinReg</code>. Les valeurs possibles sont :</p> -<ul> - <li><code>HKEY_CLASSES_ROOT</code></li> - <li><code>HKEY_CURRENT_USER</code></li> - <li><code>HKEY_LOCAL_MACHINE</code></li> - <li><code>HKEY_USERS</code></li> -</ul> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<p>Pour utiliser la section <code>HKEY_USERS</code> section, utiliser ce code :</p> -<pre class="eval">winreg = getWinRegistry(); -winreg.setRootKey(winreg.HKEY_USERS); -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/setRootKey" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvalue/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvalue/index.html deleted file mode 100644 index c225685d24..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvalue/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: setValue -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/setValue -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/setValue ---- -<p> </p> -<h3 id="setValue" name="setValue">setValue</h3> -<p>(Netscape 6 and Mozilla ne supporte pas cette méthode)</p> -<p>Définit la valeur d'une clef arbitraire.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">String setValue ( Chaîne subkey, Chaîne valname, valeur WinRegValue); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>setValue</code> a les paramètres suivants :</p> -<dl> - <dt> - </dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clef, tel que<code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_valeur/valeur à modifier.</dd> - <dt> - <code>value</code></dt> - <dd> - Un objet <code>WinRegValue</code> représentant une nouvelle valeur différente d'une chaîne. Pour plus d'informations sur ces valeurs, voir <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/WinRegValue">WinRegValue</a></code>.</dd> -</dl> -<dl> - <dt> - <code>subkey</code></dt> -</dl> -<h4 id="Retours" name="Retours">Retours</h4> -<p>0 en cas de succès ; un nombre non nul si l'ordonnancement de la modification a échoué. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<p> </p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>setValue</code> définit la valeur d'une clef arbitraire. Elle est utilisée si la valeur n'est pas une chaîne. Si la valeur est une chaîne, la méthode <code><a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueString">setValueString</a></code> est plus appropriée.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/setValue" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluenumber/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluenumber/index.html deleted file mode 100644 index f50c659e14..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluenumber/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: setValueNumber -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/setValueNumber -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/setValueNumber ---- -<p> </p> -<h3 id="setValueNumber" name="setValueNumber">setValueNumber</h3> -<p>Définit la valeur d'une clef lorsque cette valeur est un nombre.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int setValueNumber ( Chaîne subkey, Chaîne valname, Nombre value ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code> a les paramètres suivants : </code></p> -<dl> - <dt> - <code><code>subkey</code> </code></dt> - <dd> - <code>Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que<code>"Software\\Netscape\\Navigator\\Mail"</code>. </code></dd> - <dt> - <code><code>valname</code> </code></dt> - <dd> - <code>Le nom de la paire nom_de_valeur/valeur à modifier. </code></dd> - <dt> - <code><code>value</code> </code></dt> - <dd> - <code>Un nombre représentant la nouvelle valeur. </code></dd> -</dl> -<h4 id="Retour" name="Retour"><code>Retour </code></h4> -<p><code>0 en cas de succès ou un nombre non nul si l'ordonnancement de la modification a échoué. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>. </code></p> -<h4 id="Description" name="Description"><code>Description </code></h4> -<p><code>La méthode <code>setValueNumber</code> définit la valeur d'une clef lorsque cette valeur est un nombre. Cette méthode est utilisée si la valeur à définir est un nombre. Si la valeur n'est pas un nombre, il faut utiliser les méthodes <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValue"><code>setValue</code></a> ou <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValueString"><code>setValueString</code></a>. </code></p> -<p><code><span class="comment">Interwiki Language Links</span> </code></p> -<p><code>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/setValueNumber" } ) }}</code></p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluestring/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluestring/index.html deleted file mode 100644 index bb0b166bd4..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/setvaluestring/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: setValueString -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/setValueString -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/setValueString ---- -<p> </p> -<h3 id="setValueString" name="setValueString">setValueString</h3> -<p>Définit la valeur d'une clef lorsque cette valeur est une chaîne.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">int setValueString ( Chaîne subkey, Chaîne valname, Chaîne value); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>setValueString</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>subkey</code></dt> - <dd> - Le chemin de la clef vers l'emplacement approprié dans la hiérarchie de clefs, tel que <code>"Software\\Netscape\\Navigator\\Mail"</code>.</dd> - <dt> - <code>valname</code></dt> - <dd> - Le nom de la paire nom_de_valeur/valeur à modifier.</dd> - <dt> - <code>value</code></dt> - <dd> - La nouvelle valeur chaîne.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>0 en cas de succès ou un nombre non nul si l'ordonnancement de la modification a échoué. Pour la liste complète des valeurs possibles, voir <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Codes_retourn%c3%a9s">Codes retournés</a>.</p> -<h4 id="Description" name="Description">Description</h4> -<p>La méthode <code>setValueString</code> définit la valeur d'une clef lorsque cette valeur est une chaîne. Cette méthode est utilisée si la valeur qu'on veut définir est une chaîne. Dans le cas contraire, il faut utiliser la méthode <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg/M%c3%a9thodes/setValue"><code>setValue</code></a>.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/setValueString" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/valueexists/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/valueexists/index.html deleted file mode 100644 index c879f01034..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/méthodes/valueexists/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: valueExists -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/Méthodes/valueExists -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/Methods/valueExists ---- -<p> </p> -<h3 id="valueExists" name="valueExists">valueExists</h3> -<p>Retourne si une valeur existe pour une clé données.</p> -<h4 id="M.C3.A9thode_de" name="M.C3.A9thode_de">Méthode de</h4> -<p>Objet <a href="fr/R%c3%a9f%c3%a9rence_de_l'API_XPInstall/Objet_WinReg">WinReg</a></p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">boolean valueExists ( chaîne key, chaîne value ); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>La méthode <code>valueExists</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>key</code></dt> - <dd> - Une chaîne représentant le chemin de la clef.</dd> - <dt> - <code>value</code></dt> - <dd> - Une chaîne représentant la valeur à chercher.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Une valeur booléenne : <code>true</code> si la clef existe et si l'utilisateur a accès en lecture, <code>false</code> dans le cas contraire.</p> -<h4 id="Exemple" name="Exemple">Exemple</h4> -<pre class="eval">winreg = getWinRegistry(); -if ( winreg != null ) -{ - winreg.setRootKey( winreg.HKEY_LOCAL_MACHINE); - if(winreg.valueExists("SOFTWARE\\mozilla", "value name")) - { - //valueExists retourne true - } else { - //valueExists retourne false - } -} -</pre> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/Methods/valueExists" } ) }}</p> diff --git a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/winregvalue/index.html b/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/winregvalue/index.html deleted file mode 100644 index 2d3fe83cb1..0000000000 --- a/files/fr/archive/mozilla/xpinstall/référence_de_l_api_xpinstall/objet_winreg/winregvalue/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: WinRegValue -slug: >- - Archive/Mozilla/XPInstall/Référence_de_l_API_XPInstall/Objet_WinReg/WinRegValue -translation_of: Archive/Mozilla/XPInstall/Reference/WinReg_Object/WinRegValue ---- -<p> </p> -<h3 id="Constructeur_winRegValue" name="Constructeur_winRegValue">Constructeur winRegValue</h3> -<p>(Microsoft Windows uniquement)</p> -<p>Crée un objet <code>WinRegValue</code>.</p> -<h4 id="Syntaxe" name="Syntaxe">Syntaxe</h4> -<pre class="eval">WinRegValue ( int datatype, byte[] regdata); -</pre> -<h4 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h4> -<p>Le contructeur <code>WinRegValue</code> a les paramètres suivants :</p> -<dl> - <dt> - <code>datatype</code></dt> - <dd> - Un nombre entier indiquant le type de données compris dans cet objet. Les valeurs possibles sont : - <dl> - <dd> - <code>WinRegValue.REG_SZ</code> = 1</dd> - <dd> - <code>WinRegValue.REG_EXPAND_SZ</code> = 2</dd> - <dd> - <code>WinRegValue.REG_BINARY</code> = 3</dd> - <dd> - <code>WinRegValue.REG_DWORD</code> = 4</dd> - <dd> - <code>WinRegValue.REG_DWORD_LITTLE_ENDIAN</code> = 4</dd> - <dd> - <code>WinRegValue.REG_DWORD_BIG_ENDIAN</code> = 5</dd> - <dd> - <code>WinRegValue.REG_LINK</code> = 6</dd> - <dd> - <code>WinRegValue.REG_MULTI_SZ</code> = 7</dd> - <dd> - <code>WinRegValue.REG_RESOURCE_LIST</code> = 8</dd> - <dd> - <code>WinRegValue.REG_FULL_RESOURCE_DESCRIPTOR</code> = 9</dd> - <dd> - <code>WinRegValue.REG_RESOURCE_REQUIREMENTS_LIST</code> = 10</dd> - </dl> - </dd> -</dl> -<dl> - <dt> - <code>regdata</code></dt> - <dd> - Un tableau Java - <i> - bytes</i> - contenant les données.</dd> -</dl> -<h4 id="Retour" name="Retour">Retour</h4> -<p>Un nouvel objet <code>WinRegValue</code>, avec le type de données compris et les données définies aux valeurs passées à ce constructeur.</p> -<h4 id="Description" name="Description">Description</h4> -<p>Les développeurs Windows avancés peuvent utiliser cet objet pour manipuler des valeurs qui ne sont pas des chaînes dans la base de registre de Microsoft Windows.</p> -<p>Un objet de ce type a deux champs : le type des données et la valeur. Pour plus d'informations sur les types des données possibles pour une valeur du registre, voir la documentation de l'API Windows. Vous fournissez la valeur de ces champs au constructeur de cette classe.</p> -<p><span class="comment">Interwiki Language Links</span></p> -<p>{{ languages( { "en": "en/XPInstall_API_Reference/WinReg_Object/WinRegValue" } ) }}</p> diff --git a/files/fr/archive/mozilla/xul/attributs/acceltext/index.html b/files/fr/archive/mozilla/xul/attributs/acceltext/index.html deleted file mode 100644 index c48e829509..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/acceltext/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: acceltext -slug: Archive/Mozilla/XUL/Attributs/acceltext -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/acceltext ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-acceltext"><a href="http://api/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code></dt> - <dd> - Type : <i>chaîne de caractères</i></dd> - <dd> - Texte qui apparaîtra à côté du label d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut <code>key</code>. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (<code>menubar</code>).</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/accesskey/index.html b/files/fr/archive/mozilla/xul/attributs/accesskey/index.html deleted file mode 100644 index 4b89962e66..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/accesskey/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: accesskey -slug: Archive/Mozilla/XUL/Attributs/accesskey -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/accesskey ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt><div class="noinclude"> -<dd> Attribut de : <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/radio" title="radio">radio</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarbutton" title="toolbarbutton">toolbarbutton</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox (autocomplétion de Firefox)" title="textbox (autocomplétion de Firefox)">textbox (autocomplétion de Firefox)</a></code></dd></div> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. <div class="noinclude">Elle sera généralement affichée soulignée, mais ce comportement est spécifique à la plateforme et au thème. Lorsque l'utilisateur appuie sur ALT (ou une touche similaire variant d'une plateforme à l'autre) et la touche d'accès, l'élément sera activé depuis n'importe où dans la fenêtre. <b>Bien que la valeur ne soit pas sensible à la casse, la lettre correspondant à la casse de l'attribut accesskey sera utlisée si les deux casses existent dans le label</b>. -</div></dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> diff --git a/files/fr/archive/mozilla/xul/attributs/align/index.html b/files/fr/archive/mozilla/xul/attributs/align/index.html deleted file mode 100644 index 46e84c1900..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/align/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: align -slug: Archive/Mozilla/XUL/Attributs/align -tags: - - Attributs_XUL - - Référence_XUL - - XUL -translation_of: Archive/Mozilla/XUL/Attribute/align ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code></dt> - <dd> - Type : - <i> - une des valeurs ci-dessous</i> - </dd> - <dd> - L'attribut <code>align</code> spécifie la manière dont les éléments enfants de la boîte sont alignés lorsque la taille de celle-ci est plus grande que la taille totale de ses enfants. Pour les boîtes orientées horizontalement, il spécifie la manière dont les enfants seront alignés verticalement. Pour les boîtes dont l'orientation est verticale, il est utilisé pour indiquer la manière dont ils seront alignés horizontalement. L'attribut <code><code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code></code> est lié à l'alignement mais est utilisé pour spécifier la position dans la direction opposée. Il est également possible de spécifier la valeur d'<code>align</code> à l'aide de la propriété de style <a href="fr/CSS/-moz-box-align"><code>-moz-box-align</code></a>.</dd> -</dl> -<ul> - <li><code>start</code> : Les éléments enfants sont alignés depuis le bord gauche ou supérieur de la boîte. Si la boîte est plus grande que la taille totale des enfants, l'espace supplémentaire est laissé du côté droit ou en bas.</li> - <li><code>center</code> : L'espace supplémentaire est divisé en parts égales de chaque côté des éléments enfants, ce qui fait que ceux-ci sont placés au centre de la boîte.</li> - <li><code>end</code> : Les éléments enfants sont placés sur le bord droit ou inférieur de la boîte. Si la boîte est plus grande que la taille totale des enfants, l'espace supplémentaire est laissé sur le bord gauche ou en haut.</li> - <li><code>baseline</code> : Cette valeur ne s'applique qu'aux boîtes orientées horizontalement. Elle fait en sorte que les éléments enfants soient alignés afin que leurs labels texte soient sur la même ligne.</li> - <li><code>stretch</code> : Les éléments enfants sont étirés pour remplir la taille de la boîte. Pour une boîte horizontale, les enfants sont étirés à la hauteur de la boîte. Pour une boîte verticale, les enfants sont étirés à la largeur de la boîte. Si la taille de la boîte change, les enfants s'adaptent. Utilisez l'attribut <code><code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code></code> pour créer des éléments qui s'étirent dans la direction opposée.</li> - <li><code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Les éléments sont alignés sur leurs bords gauches.</li> - <li><code>center</code>: <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Les éléments sont centrés horizontalement.</li> - <li><code>right</code>: <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Les éléments sont alignés sur leurs bords droits.</li> -</ul> -<div class="noinclude"> - <h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h3> - <p>L'attribut <code><code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code></code>.</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/allowevents/index.html b/files/fr/archive/mozilla/xul/attributs/allowevents/index.html deleted file mode 100644 index 79ccf6cd21..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/allowevents/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: allowevents -slug: Archive/Mozilla/XUL/Attributs/allowevents -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/allowevents ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même. -</dd></dl> -<div class="noinclude"> -<p>Sur les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/titlebar" title="titlebar">titlebar</a></code>, les évènements souris ne sont normalement pas envoyés aux enfants ; ils sont plutôt redirigés vers les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/titlebar" title="titlebar">titlebar</a></code> eux-mêmes. Cela signifie que les éléments placés dans un <code>listitem</code> ne répondent pas aux évènements, et qu'un clic de la souris sélectionne simplement cet objet dans la liste. En définissant l'attribut <code>allowevents</code> à <code>true</code>, ce comportement particulier est désactivé, et les évènements sont dirigés de la même manière que pour les autres éléments. -</p><p>Pour les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code>, ainsi que les boutons de menus et le popup <code><a href="/fr/docs/Mozilla/Tech/XUL/datepicker" title="datepicker">datepicker</a></code>, les évènements souris sont également redirigés vers l'élément lui-même. Cependant, l'attribut <code>allowevents</code> est traité d'une manière différente. Il peut alors être défini à <code>true</code> sur un descendant à la place. C'est ce qui permet aux évènements d'être ciblés normalement, mais d'être différents pour chaque descendant. -</p><p>Ce comportement est notamment utilisé pour des menus, afin de permettre à un bouton de menu de se comporter comme un menu lors d'un clic, tandis qu'une partie du menu pourra se comporter comme un bouton. Pour cette dernière, l'attribut <code>allowevents</code> est défini à <code>true</code> pour qu'un clic sur le bouton enfant reçoive les évènements plutôt qu'il soient tous dirigés vers le menu. -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/allownegativeassertions/index.html b/files/fr/archive/mozilla/xul/attributs/allownegativeassertions/index.html deleted file mode 100644 index f45b88d10c..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/allownegativeassertions/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: allownegativeassertions -slug: Archive/Mozilla/XUL/Attributs/allownegativeassertions -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/allownegativeassertions ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Valide sur tout élément disposant d'un attribut <code>datasources</code>. Lorsque plusieurs sources de données sont utilisées, l'une d'entre-elles peut écraser une assertion provenant d'une autre. Si cet attribut est à <code>true</code>, ce qui est sa valeur par défaut, une source de données peut contredire une assertion précédente. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/buttondisabledaccept/index.html b/files/fr/archive/mozilla/xul/attributs/buttondisabledaccept/index.html deleted file mode 100644 index 0e465ffa3a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/buttondisabledaccept/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: buttondisabledaccept -slug: Archive/Mozilla/XUL/Attributs/buttondisabledaccept -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/buttondisabledaccept ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-buttondisabledaccept"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/buttondisabledaccept">buttondisabledaccept</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, le bouton d'acceptation est initialement désactivé. -</dd></dl> -<p><br> -</p><p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/checked/index.html b/files/fr/archive/mozilla/xul/attributs/checked/index.html deleted file mode 100644 index 688f898817..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/checked/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: checked -slug: Archive/Mozilla/XUL/Attributs/checked -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/checked ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code></dt> - <dd> - Type : - <i> - booléen</i> - </dd> - <dd> - Indique si l'élément est coché ou non.</dd> - <dd> - Utilisez <code>hasAttribute()</code> pour déterminer si cet attribut est défini plutôt que <code>getAttribute()</code>.<br> - Pour les boutons, l'attribut <code>type</code> doit etre mis à <code>checkbox</code> ou à <code>radio</code> pour qu'un effet soit perceptible.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/class/index.html b/files/fr/archive/mozilla/xul/attributs/class/index.html deleted file mode 100644 index 04ee6410f4..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/class/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: class -slug: Archive/Mozilla/XUL/Attributs/class -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/class ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> La classe de style de l'élément. Plusieurs classes peuvent être spécifiées en les séparant par des espaces. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/coalesceduplicatearcs/index.html b/files/fr/archive/mozilla/xul/attributs/coalesceduplicatearcs/index.html deleted file mode 100644 index 83dff23276..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/coalesceduplicatearcs/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: coalesceduplicatearcs -slug: Archive/Mozilla/XUL/Attributs/coalesceduplicatearcs -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/coalesceduplicatearcs ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Valide sur tout élément disposant d'un attribut <code>datasources</code>. Lorsque plusieurs sources de données sont utilisées, l'une d'entre-elles peut écraser une assertion provenant d'une autre. Si cet attribut est à <code>true</code>, ce qui est sa valeur par défaut, une source de données peut contredire une assertion précédente. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/collapsed/index.html b/files/fr/archive/mozilla/xul/attributs/collapsed/index.html deleted file mode 100644 index c6b879a729..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/collapsed/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: collapsed -slug: Archive/Mozilla/XUL/Attributs/collapsed -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/collapsed ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'élément est réduit et n'est pas visible. C'est l'équivalent de définir la propriété CSS visibility à « collapse ». -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/command/index.html b/files/fr/archive/mozilla/xul/attributs/command/index.html deleted file mode 100644 index e240ec9f15..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/command/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: command -slug: Archive/Mozilla/XUL/Attributs/command -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/command ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> -<div class="noinclude"> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<pre><command id="cmd_openhelp" oncommand="alert('Aide');"/> -<button label="Aide" command="cmd_openhelp"/> -<button label="Plus d'aide" command="cmd_openhelp"/> -</pre> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<p>L'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code></code>, l'attribut <code><code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code></code> et l'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/commandset" title="commandset">commandset</a></code></code>. -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/container/index.html b/files/fr/archive/mozilla/xul/attributs/container/index.html deleted file mode 100644 index da385d1751..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/container/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: container -slug: Archive/Mozilla/XUL/Attributs/container -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/container ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Défini à true si l'élément doit agir comme un conteneur pouvant avoir des éléments enfants. Ceci peut être utilisé pour des dossiers. Cet attribut sera défini par le constructeur de template si nécessaire. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/containment/index.html b/files/fr/archive/mozilla/xul/attributs/containment/index.html deleted file mode 100644 index 47d917f06b..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/containment/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: containment -slug: Archive/Mozilla/XUL/Attributs/containment -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/containment ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code> -</dt><dd> Type : <i>URI d'un prédicat RDF</i> -</dd><dd> Cet attribut spécifie des propriétés RDF indiquant qu'ne ressource est un conteneur. Lors de la génération de contenu depuis un template, ceci est utilisé pour déterminer quelles ressources de la source de données sont des conteneurs et peuvent donc avoir des nœuds enfants, et lesquelles ne le sont pas. -</dd></dl> -<dl><dd> Cet attribut doit être placé sur le même élément que les attributs <code>datasources</code> et <code>ref</code>. Il peut être défini comme une liste de propriétés ou ressources RDF séparées par des espaces. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/context/index.html b/files/fr/archive/mozilla/xul/attributs/context/index.html deleted file mode 100644 index 13e130ea04..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/context/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: context -slug: Archive/Mozilla/XUL/Attributs/context -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/context ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code> -</dt><dd> Type : <i>id de l'élément popup</i> -</dd><dd> Doit être défini à la valeur de l'id de l'élément popup devant apparaître lorsque l'utilisateur fait un clic contextuel sur l'élément. La manière de réaliser un clic contextuel diffère selon la plateforme. Habituellement il s'agira d'un clic droit. La valeur spéciale « <code>_child</code> » peut être utilisée pour indiquer le premier <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> enfant de l'élément. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/contextmenu/index.html b/files/fr/archive/mozilla/xul/attributs/contextmenu/index.html deleted file mode 100644 index 9f11c2f1d6..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/contextmenu/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: contextmenu -slug: Archive/Mozilla/XUL/Attributs/contextmenu -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/contextmenu ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code> -</dt><dd> Type : <i>id d'un élément popup</i> -</dd><dd> Nom alternatif pour l'attribut <code>context</code>, mais dispose également d'une propriété de script correspondante « contextmenu ». -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/crop/index.html b/files/fr/archive/mozilla/xul/attributs/crop/index.html deleted file mode 100644 index 6ee6cd1d52..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/crop/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: crop -slug: Archive/Mozilla/XUL/Attributs/crop -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/crop ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> -<div class="noinclude"> -<dl><dd> Selon la plateforme et le thème utilisé, certains éléments auront une largeur maximale définie de sorte qu'ils seront toujours tronqués. Si vous décidez d'utiliser la valeur <code>none</code> et que le texte est plus grand que cette valeur maximale, vous pouvez faire usage de la propriété CSS <code>max-width</code> (ou de l'attribut maxwidth) pour agrandir cette taille. Par exemple, pour un élément de menu vous pouvez ajouter la règle CSS suivante lorsque vous désirez utiliser la valeur <code>none</code> : -</dd></dl> -<pre class="eval">menupopup > menuitem, menupopup > menu { max-width: none; } -</pre> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/datasources/index.html b/files/fr/archive/mozilla/xul/attributs/datasources/index.html deleted file mode 100644 index 98dd93bbe1..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/datasources/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: datasources -slug: Archive/Mozilla/XUL/Attributs/datasources -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/datasources ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code> -</dt><dd> Type : <i>liste d'URI datasource séparées par des espaces</i> -</dd><dd> Une liste séparée par des espaces de sources de données que le template d'un élément utilisera pour la génération de contenu. Il peut s'agir tant de sources de données internes comme rdf:bookmarks que de l'URL d'un fichier RDF. L'attribut <code>datasources</code> peut être placé sur la plupart des éléments, bien qu'il se trouve le plus souvent sur des arbres (<code>tree</code>) et <code>menupopup</code>s. L'élément doit avoir un élément de template comme enfant. -</dd></dl> -<dl><dd> Les sources de données spécifiées sont combinées en une source de données composite unique qui conserve les données de toutes les sources. Cette source composite est accessible via un script au travers de la propriété <code>database</code>. -</dd></dl> -<dl><dd> Si vous envisagez d'ajouter une source de données à un élément mais ne désirez pas l'ajouter immédiatement, définissez cette propriété à « <code>rdf:null</code> ». Cela préparera l'élément à ce que son contenu soit généré depuis une source de données. Autrement, il ne sera pas possible d'en ajouter une par la suite. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/datepicker.type/index.html b/files/fr/archive/mozilla/xul/attributs/datepicker.type/index.html deleted file mode 100644 index 6046455950..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/datepicker.type/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: datepicker.type -slug: Archive/Mozilla/XUL/Attributs/datepicker.type -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/datepicker.type ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <a href="fr/XUL/Attributs/datepicker.type">type</a></dt> - <dd> - Type : <i>une des valeurs suivantes</i></dd> - <dd> - L'attribut <code>type</code> peut avoir l'une des valeurs ci-dessous afin de spécifier le type de sélecteur de date à utiliser :</dd> -</dl> -<ul> - <li><code>normal</code> : Un sélecteur de date avec trois champs pour entrer l'année, le mois et le jour. C'est la valeur par défaut, il ne faut donc pas spécifier l'attribut <code>type</code> si c'est le genre désiré.</li> - <li><code>grid</code> : Un sélecteur de date qui affiche une grille de calendrier où un mois est affiché à la fois.</li> - <li><code>popup</code> : Un sélecteur de date avec trois champs d'entrée mais un bouton déroulant supplémentaire qui, lorsqu'on clique dessus, affichera une grille de calendrier.</li> -</ul> -<div class="noinclude"> - <dl> - <dt> - Type normal</dt> - <dd> - <img alt="Image:Controlsguide-datepicker.png" class="internal" src="/@api/deki/files/158/=Controlsguide-datepicker.png"></dd> - <dt> - Type grid</dt> - <dd> - <img alt="Image:Controlsguide-datepicker-grid.png" class="internal" src="/@api/deki/files/156/=Controlsguide-datepicker-grid.png"></dd> - <dt> - Type popup</dt> - <dd> - <img alt="Image:Controlsguide-datepicker-popup.png" class="internal" src="/@api/deki/files/5093/=Controlsguide-datepicker-popup.png?"></dd> - </dl> -</div> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/attributs/datepicker.value/index.html b/files/fr/archive/mozilla/xul/attributs/datepicker.value/index.html deleted file mode 100644 index a05c4e5b51..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/datepicker.value/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: datepicker.value -slug: Archive/Mozilla/XUL/Attributs/datepicker.value -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/datepicker.value ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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> - La valeur initiale du sélecteur de date sous la forme <var>AAAA/MM/JJ</var>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/dir/index.html b/files/fr/archive/mozilla/xul/attributs/dir/index.html deleted file mode 100644 index a2f4cce3d4..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/dir/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: dir -slug: Archive/Mozilla/XUL/Attributs/dir -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/dir ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code></dt> - <dd> - Type : - <i> - une des valeurs ci-dessous</i> - </dd> - <dd> - La direction dans laquelle les éléments enfants de l'élément seront placés.</dd> -</dl> -<ul> - <li><code>normal</code> : <magic name="\"PAGENAME\"/">Les valeurs de l'échelle sont triées de gauche à droite (pour les échelles horizontales) ou de haut en bas (pour les échelles verticales)., Les éléments sont placés de gauche à droite ou de haut en bas dans l'ordre dans lequel ils apparaissent dans le code XUL.)</magic></li> - <li><code>reverse</code> : Les valeurs de l'échelle sont triées de droite à gauche (pour les échelles horizontales) ou de bas en haut (pour les échelles verticales)., Les éléments sont placés de droite à gauche ou de bas en haut. C'est le contraire de l'ordre dans lequel ils apparaissent dans le code XUL.)</li> -</ul> -<div class="noinclude"> - <h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h3> - <ul> - <li><code id="a-resizer.dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizer.dir">resizer.dir</a></code></li> - </ul> -</div> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/attributs/disabled/index.html b/files/fr/archive/mozilla/xul/attributs/disabled/index.html deleted file mode 100644 index a397863950..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/disabled/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: disabled -slug: Archive/Mozilla/XUL/Attributs/disabled -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/disabled ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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. <div class="noinclude">L'élément répondra cependant encore aux évènements souris. Pour activer l'élément, ne spécifiez simplement pas cet attribut plutôt que de définir sa valeur à <code>false</code>. -</div></dd></dl> -<p><br> -</p> -<div class="float-right"><img alt="Image:XUL_ref_attr_disabled.png"></div> -<pre><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> diff --git a/files/fr/archive/mozilla/xul/attributs/empty/index.html b/files/fr/archive/mozilla/xul/attributs/empty/index.html deleted file mode 100644 index 0dc77fd889..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/empty/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: empty -slug: Archive/Mozilla/XUL/Attributs/empty -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/empty ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Défini à <code>true</code> si l'élément est un conteneur qui ne contient aucun enfant. Il sera défini par le constructeur de template si nécessaire. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/equalsize/index.html b/files/fr/archive/mozilla/xul/attributs/equalsize/index.html deleted file mode 100644 index c9af38b1aa..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/equalsize/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: equalsize -slug: Archive/Mozilla/XUL/Attributs/equalsize -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/equalsize ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Cet attribut peut être utilisé pour rendre les enfants d'un élément égaux en taille. -</dd></dl> -<ul><li> <code>always</code> : pour un élément orienté horizontalement, tous les enfants auront la largeur de l'élément le plus large. Pour un élément orienté verticalement, tous les enfants auront la hauteur de l'élément le plus haut. -</li><li> <code>never</code> : tous les enfants sont affichés à la taille requise par le contenu ou telle que spécifiée par les attributs <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> et <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> ou les propriétés CSS <a href="/fr/docs/Web/CSS/width" title="La propriété width définit la largeur d'un élément. Par défaut, c'est la largeur de la zone de contenu (comprise à l'intérieur de la boîte de remplissage (padding), de la bordure (border) et de la boîte de marge (margin) de l'élément) mais si box-sizing vaut border-box, ce sera la largeur de la zone incluant la bordure."><code>width</code></a> et <a href="/fr/docs/Web/CSS/height" title="La propriété height définit la hauteur de la boîte de contenu d'un élément. La boîte de contenu est à l'intérieur de la boîte de remplissage (padding) qui est à l'intérieur de la boîte de bordure qui est elle-même à l'intérieur de la boîte de marge de l'élément. Si la propriété box-sizing vaut border-box, cette propriété détermine la hauteur de la boîte de marge."><code>height</code></a>. -</li></ul> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/firstdayofweek/index.html b/files/fr/archive/mozilla/xul/attributs/firstdayofweek/index.html deleted file mode 100644 index c94dc80095..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/firstdayofweek/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: firstdayofweek -slug: Archive/Mozilla/XUL/Attributs/firstdayofweek -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/firstdayofweek ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-firstdayofweek"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/firstdayofweek">firstdayofweek</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Indique le jour de la semaine à afficher comme premier jour dans la grille. Les valeurs vont de 0 à 6, où 0 est dimanche et 6 est samedi. La valeur par défaut est déterminée par la locale, n'utilisez donc cet attribut que si vous désirez l'écraser. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/flags/index.html b/files/fr/archive/mozilla/xul/attributs/flags/index.html deleted file mode 100644 index 28e4635cac..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/flags/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: flags -slug: Archive/Mozilla/XUL/Attributs/flags -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/flags ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code> -</dt><dd> Type : <i>liste de valeurs (voir ci-dessous) séparées par des espaces</i> -</dd><dd> Un ensemble de drapeaux destinés à différentes utilisations. Deux sont définis, et peuvent être la valeur de cet attribut. -</dd></dl> -<ul><li> <code>dont-test-empty</code> : pour le contenu généré par des templates, le constructeur ne vérifiera pas qu'un conteneur est vide. -</li><li> <code>dont-build-content</code> : peut être utilisé sur un arbre pour idniquer que les éléments de contenu ne doivent pas être générés. Cela améliorera les performances, mais vous ne pourrez pas utiliser les fonctions DOM pour obtenir les lignes de l'arbre. -</li></ul> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/flex/index.html b/files/fr/archive/mozilla/xul/attributs/flex/index.html deleted file mode 100644 index cd561f66c1..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/flex/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: flex -slug: Archive/Mozilla/XUL/Attributs/flex -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/flex ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> Indique la flexibilité de l'élément, c'est-à-dire la façon dont le conteneur d'un élément distribue l'espace libre restant parmi ses enfants. Les éléments flexibles s'étendent et rétrécissent pour remplir leur espace donné. Les éléments qui ont les plus grandes valeurs pour flex seront plus grands que ceux qui ont des valeurs plus petites, selon un rapport déterminé par les valeurs données par chaque élément. La valeur réelle n'est pas indicative, à moins qu'il y ait d'autres éléments flexibles dans le même conteneur. Une fois que les tailles par défaut des éléments dans une boîte ont été calculées, l'espace restant est divisé entre les éléments flexibles, selon leurs coefficients pour flex. Indiquer une valeur de 0 pour flex équivaut à ne pas préciser du tout d'attribut flex. </dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/height/index.html b/files/fr/archive/mozilla/xul/attributs/height/index.html deleted file mode 100644 index 967d50b72f..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/height/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: height -slug: Archive/Mozilla/XUL/Attributs/height -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/height ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La hauteur préférée de l'élément en pixels. La hauteur réellement affichée peut être différentes si l'élément ou son contenu ont une hauteur minimum ou maximum. La propriété CSS <code>height</code> peut également être utilisée. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/helpuri/index.html b/files/fr/archive/mozilla/xul/attributs/helpuri/index.html deleted file mode 100644 index e168011f5e..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/helpuri/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: helpURI -slug: Archive/Mozilla/XUL/Attributs/helpURI -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/helpURI ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-helpURI"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/helpURI">helpURI</a></code></dt> - <dd> - Type : <i>URI</i></dd> - <dd> - L'URI de la page d'aide associée avec un panneau de préférences. Celle-ci sera ouverte dans une fenêtre d'aide lors de l'appui sur le bouton d'aide.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/hidden/index.html b/files/fr/archive/mozilla/xul/attributs/hidden/index.html deleted file mode 100644 index ad1afbfed5..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/hidden/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: hidden -slug: Archive/Mozilla/XUL/Attributs/hidden -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/hidden ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'élément n'est pas affiché. Cet attribut est similaire à la valeur « <code>none</code> » de la propriété CSS <code>display</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/hidechrome/index.html b/files/fr/archive/mozilla/xul/attributs/hidechrome/index.html deleted file mode 100644 index 9793b3aced..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/hidechrome/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: hidechrome -slug: Archive/Mozilla/XUL/Attributs/hidechrome -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/hidechrome ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-hidechrome"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidechrome">hidechrome</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Définissez cet attribut à <code>true</code> pour que le chrome, en ce compris la barre de titre, soit caché. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/hideseconds/index.html b/files/fr/archive/mozilla/xul/attributs/hideseconds/index.html deleted file mode 100644 index 1ba80accbe..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/hideseconds/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: hideseconds -slug: Archive/Mozilla/XUL/Attributs/hideseconds -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/hideseconds ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-hideseconds"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hideseconds">hideseconds</a></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Indique si le champ des secondes doit être masqué.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/id/index.html b/files/fr/archive/mozilla/xul/attributs/id/index.html deleted file mode 100644 index 5c27d4d48d..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/id/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: id -slug: Archive/Mozilla/XUL/Attributs/id -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/id ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> -</dt><dd> Type : <i>id d'élément, doit être unique dans la fenêtre</i> -</dd><dd> Un identifiant unique permettant d'identifier l'élément. Celui-ci peut être utilisé comme paramètre pour <code><a href="fr/DOM/document.getElementById">getElementById()</a></code> et d'autres fonctions DOM et pour référencer l'élément dans des feuilles de style. -</dd></dl> -<div class="noinclude"> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<pre><button id="foo" label="Cliquez ici" oncommand="doSomething()"/> - -<script> -function doSomething(){ - var myButton = document.getElementById('foo'); - myButton.setAttribute('label','On a cliqué sur le bouton'); -} -</script> -</pre> -<p>Une version plus abstraite de ce code serait un -</p> -<pre><button id="foo" label="Cliquez ici" oncommand="setWidgetLabel(this, 'On m\' a cliqué dessus')"/> -<script> -function setWidgetLabel(idName, newCaption){ - document.getElementById( idName.id ).setAttribute('label',newCaption) -} - -</script> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p><code><code id="a-name"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/name">name</a></code></code> -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/image/index.html b/files/fr/archive/mozilla/xul/attributs/image/index.html deleted file mode 100644 index b9e988be89..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/image/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: image -slug: Archive/Mozilla/XUL/Attributs/image -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/image ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> -<div class="noinclude"> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<ul><li> L'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/image" title="image">image</a></code></code> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/increment/index.html b/files/fr/archive/mozilla/xul/attributs/increment/index.html deleted file mode 100644 index 7c279c8953..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/increment/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: increment -slug: Archive/Mozilla/XUL/Attributs/increment -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/increment ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La quantité dont l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> (pour les boîtes numériques et les échelles) or <code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code><magic name="\"PAGENAME\"/"> (pour les barres de défilement) </magic> change lorsque l'on clique sur les flèches. La valeur par défaut est 1.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/index.html b/files/fr/archive/mozilla/xul/attributs/index.html deleted file mode 100644 index ca4be7d5ed..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/index.html +++ /dev/null @@ -1,281 +0,0 @@ ---- -title: Attributs -slug: Archive/Mozilla/XUL/Attributs -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute ---- -<p><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></p> - -<div style="-moz-column-width: 16em;"> -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/acceltext">acceltext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/accessible">accessible</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/accesskey">accesskey</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/afterselected">afterselected</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/align">align</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/allowevents">allowevents</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/alternatingbackground">alternatingbackground</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/alwaysopenpopup">alwaysopenpopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/Attributs">Attributs</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autocheck">autocheck</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autoCheck">autoCheck</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autocompleteenabled">autocompleteenabled</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autocompletepopup">autocompletepopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autocompletesearch">autocompletesearch</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autocompletesearchparam">autocompletesearchparam</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autoFill">autoFill</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autoFillAfterMatch">autoFillAfterMatch</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/autoscroll">autoscroll</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/beforeselected">beforeselected</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeyaccept">buttonaccesskeyaccept</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeycancel">buttonaccesskeycancel</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeydisclosure">buttonaccesskeydisclosure</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeyextra1">buttonaccesskeyextra1</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeyextra2">buttonaccesskeyextra2</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonaccesskeyhelp">buttonaccesskeyhelp</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonalign">buttonalign</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttondir">buttondir</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabelaccept">buttonlabelaccept</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabelcancel">buttonlabelcancel</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabeldisclosure">buttonlabeldisclosure</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabelextra1">buttonlabelextra1</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabelextra2">buttonlabelextra2</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonlabelhelp">buttonlabelhelp</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonorient">buttonorient</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttonpack">buttonpack</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/buttons">buttons</a></li> - <li><code id="a-button.type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/button.type">button.type</a></code></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/checked">checked</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/checkState">checkState</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/class">class</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/closebutton">closebutton</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/collapse">collapse</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/collapsed">collapsed</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/color">color</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/cols">cols</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/command">command</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/commandupdater">commandupdater</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/completedefaultindex">completedefaultindex</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/container">container</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/containment">containment</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/contentcontextmenu">contentcontextmenu</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/contenttooltip">contenttooltip</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/context">context</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/contextmenu">contextmenu</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/control">control</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/crop">crop</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/curpos">curpos</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/current">current</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/currentset">currentset</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/customindex">customindex</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/customizable">customizable</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/cycler">cycler</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/datasources">datasources</a></li> - <li><code id="a-decimalplaces"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/decimalplaces">decimalplaces</a></code></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/default">default</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/defaultButton">defaultButton</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/defaultset">defaultset</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/description">description</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/dir">dir</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disableAutocomplete">disableAutocomplete</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disableautocomplete">disableautocomplete</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disableautoselect">disableautoselect</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disableclose">disableclose</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disabled">disabled</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disablehistory">disablehistory</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disableKeyNavigation">disableKeyNavigation</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disablekeynavigation">disablekeynavigation</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/disablesecurity">disablesecurity</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/dlgType">dlgType</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/dragging">dragging</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/editable">editable</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/editortype">editortype</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/element">element</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/empty">empty</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/enableColumnDrag">enableColumnDrag</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/enablehistory">enablehistory</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/equalsize">equalsize</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/eventnode">eventnode</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/events">events</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/firstpage">firstpage</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/first-tab">first-tab</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/fixed">fixed</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/flags">flags</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/flex">flex</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/focused">focused</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/forceComplete">forceComplete</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/forcecomplete">forcecomplete</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/grippyhidden">grippyhidden</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/grippytooltiptext">grippytooltiptext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/group">group</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/handleCtrlPageUpDown">handleCtrlPageUpDown</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/handleCtrlTab">handleCtrlTab</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/height">height</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/helpURI">helpURI</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/hidden">hidden</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/hidechrome">hidechrome</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/hidecolumnpicker">hidecolumnpicker</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/hideheader">hideheader</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/homepage">homepage</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/icon">icon</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/id">id</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ignoreBlurWhileSearching">ignoreBlurWhileSearching</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ignoreblurwhilesearching">ignorebluewhilesearching</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ignorecolumnpicker">ignorecolumnpicker</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ignorekeys">ignorekeys</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/image">image</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/increment">increment</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/inputtooltiptext">inputtooltiptext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/insertafter">insertafter</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/insertbefore">insertbefore</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/instantApply">instantApply</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/inverted">inverted</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/iscontainer">iscontainer</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/isempty">isempty</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/key">key</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/keycode">keycode</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/keytext">keytext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/label">label</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/lastpage">lastpage</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/lastSelected">lastSelected</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/last-tab">last-tab</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/left">left</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/linkedpanel">linkedpanel</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/maxheight">maxheight</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/maxlength">maxlength</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/maxpos">maxpos</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/maxrows">maxrows</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/maxwidth">maxwidth</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/member">member</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/menu">menu</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/menuactive">menuactive</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/minheight">minheight</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/minResultsForPopup">minResultsForPopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/minresultsforpopup">minresultsforpopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/minwidth">minwidth</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/mode">mode</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/modifiers">modifiers</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/mousethrough">mousethrough</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/multiline">multiline</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/name">name</a></li> - <li><code id="a-newlines"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/newlines">newlines</a></code></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/next">next</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/noautohide">noautohide</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/nomatch">nomatch</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/observes">observes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onbeforeaccept">onbeforeaccept</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onbookmarkgroup">onbookmarkgroup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onchange">onchange</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onclosetab">onclosetab</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/oncommand">oncommand</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/oncommandupdate">oncommandupdate</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ondialogaccept">ondialogaccept</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ondialogcancel">ondialogcancel</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ondialogdisclosure">ondialogclosure</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ondialoghelp">ondialoghelp</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onerror">onerror</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onerrorcommand">onerrorcommand</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/oninput">oninput</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onload">onload</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onnewtab">onnewtab</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpageadvanced">onpageadvanced</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpagehide">onpagehide</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpagerewound">onpagerewound</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpageshow">onpageshow</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpanelload">onpanelload</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpopuphidden">onpopuphidden</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpopuphiding">onpopuphiding</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpopupshowing">onpopupshowing</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onpopupshown">onpopupshown</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onsearchcomplete">onsearchcomplete</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onselect">onselect</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ontextcommand">ontextcommand</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ontextentered">ontextentered</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ontextrevert">ontextrevert</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ontextreverted">ontextreverted</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onwizardback">onwizardback</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onwizardcancel">onwizardcancel</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onwizardfinish">onwizardfinish</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/onwizardnext">onwizardnext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/open">open</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ordinal">ordinal</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/orient">orient</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/pack">pack</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/pageid">pageid</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/pageincrement">pageincrement</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/pagestep">pagestep</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/parent">parent</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/parsetype">parsetype</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/persist">persist</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/phase">phase</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/pickertooltiptext">pickertooltiptext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/popup">popup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/position">position</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/preference">preference</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/preference-editable">preference-editable</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/primary">primary</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/properties">properties</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/readonly">readonly</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/ref">ref</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/removeelement">removeelement</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/resizeafter">resizeafter</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/resizebefore">resizebefore</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/rows">rows</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/screenX">screenX</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/screenY">screenY</a></li> - <li><code id="a-searchlabel"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/searchlabel">searchlabel</a></code></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/searchSessions">searchSessions</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/selected">selected</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/selectedIndex">selectedIndex</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/seltype">seltype</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/setfocus">setfocus</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/showCommentColumn">showCommentColumn</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/showcommentcolumn">showcommentcolumn</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/showpopup">showpopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/size">size</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sizemode">sizemode</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sizetopopup">sizetopopup</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sort">sort</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sortActive">sortActive</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sortDirection">sortDirection</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sortResource">sortResource</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/sortResource2">sortResource2</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/src">src</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/state">state</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/statedatasource">statedatasource</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/statusbar">statusbar</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/statustext">statustext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/style">style</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/substate">substate</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/suppressonselect">suppressonselect</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tabindex">tabindex</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tabScrolling">tabScrolling</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tabscrolling">tabscrolling</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/targets">targets</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/template">template</a></li> - <li><code id="a-textbox.type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/textbox.type">textbox.type</a></code></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/timeout">timeout</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/title">title</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/toolbarname">toolbarname</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tooltip">tooltip</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tooltiptext">tooltiptext</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/tooltiptextnew">tooltiptextnew</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/top">top</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/type">type</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/uri">uri</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/userAction">userAction</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/validate">validate</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/value">value</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/wait-cursor">wait-cursor</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/width">width</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/windowtype">windowtype</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/XUL/Attributs/wrap">wrap</a></li> - <li><code id="a-wraparound"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wraparound">wraparound</a></code></li> -</ul> -</div> - -<div class="noinclude"> </div> diff --git a/files/fr/archive/mozilla/xul/attributs/insertafter/index.html b/files/fr/archive/mozilla/xul/attributs/insertafter/index.html deleted file mode 100644 index 8c5d0db612..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/insertafter/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: insertafter -slug: Archive/Mozilla/XUL/Attributs/insertafter -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/insertafter ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Lorsqu'un élément est un <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code>, l'attribut insertafter spécifie l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément dans la fenêtre de base après lequel l'élément overlay doit apparaitre. Cet attribut a priorité sur l'attribut <code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>. Cette valeur peut être une liste d'id séparés par des virgules, et c'est alors le premier d'entre-eux trouvé dans la fenêtre qui sera utilisé. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/insertbefore/index.html b/files/fr/archive/mozilla/xul/attributs/insertbefore/index.html deleted file mode 100644 index ad0d6731d2..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/insertbefore/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: insertbefore -slug: Archive/Mozilla/XUL/Attributs/insertbefore -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/insertbefore ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Lorsqu'un élément est un <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code>, l'attribut insertafter spécifie l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément dans la fenêtre de base avant lequel l'élément overlay doit apparaitre. Cette valeur peut être une liste d'id séparés par des virgules, et c'est alors le premier d'entre-eux trouvé dans la fenêtre qui sera utilisé. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/instantapply/index.html b/files/fr/archive/mozilla/xul/attributs/instantapply/index.html deleted file mode 100644 index 2b4c0b74bf..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/instantapply/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: instantApply -slug: Archive/Mozilla/XUL/Attributs/instantApply -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/instantApply ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-instantApply"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/instantApply">instantApply</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si sa valeur est <code>true</code>, la préférence sera modifiée dès que l'élément d'interface utilisateur est modifié. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/inverted/index.html b/files/fr/archive/mozilla/xul/attributs/inverted/index.html deleted file mode 100644 index 0b5241236e..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/inverted/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: inverted -slug: Archive/Mozilla/XUL/Attributs/inverted -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/inverted ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les préférences booléennes, l'indication de cet attribut à <code>true</code> indique que la valeur de la préférence est l'inverse de celle de l'élément d'interface utilisateur qui y est attaché. Par exemple, elle fait en sorte que cocher une case désactive la préférence associée au lieu de l'activer. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/label/index.html b/files/fr/archive/mozilla/xul/attributs/label/index.html deleted file mode 100644 index afe9b0ed31..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/label/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: label -slug: Archive/Mozilla/XUL/Attributs/label -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/label ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/treeitem.label">treeitem.label</a>, élément <code><a href="fr/XUL/label"><label></a></code> -</li></ul> -<h4 id="Exemples_en_JavaScript" name="Exemples_en_JavaScript">Exemples en JavaScript</h4> -<pre><label value="Whaw" id="the-big-label" command="the-big-button"/> -<button id="the-big-button" label="Cliquez ici" - oncommand="alert(document.getElementById('the-big-label').value)"/> - -<label id="myLabel" value="Mon label"/> -<button label="Cliquez ici" - oncommand="document.getElementById('myLabel').setAttribute('value','Valeur modifiée');" /> - -<checkbox label="ma case à cocher" id="myCheckboX"/> -<button label="Un autre clic" - oncommand="document.getElementById('myCheckboX').setAttribute('label','Toujours pas cochée');"/> -<button label="Afficher le label de la checkbox" - oncommand="alert( document.getElementById('myCheckboX').getAttribute('label') )"/> -</pre> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/left/index.html b/files/fr/archive/mozilla/xul/attributs/left/index.html deleted file mode 100644 index 1a4529d526..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/left/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: left -slug: Archive/Mozilla/XUL/Attributs/left -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/left ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> Pour les éléments placés directement dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>, spécifie la distance en pixels du bord gauche de l'élément par rapport au bord gauche du stack. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/max/index.html b/files/fr/archive/mozilla/xul/attributs/max/index.html deleted file mode 100644 index 5d671a265e..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/max/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: max -slug: Archive/Mozilla/XUL/Attributs/max -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/max ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur maximum que peut prendre l'élément scale ou number box. La valeur par défaut est <code>100</code> pour les éléments scale et <code>Infinity</code> pour les boîtes numériques</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/maxheight/index.html b/files/fr/archive/mozilla/xul/attributs/maxheight/index.html deleted file mode 100644 index 57b9480a9a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/maxheight/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: maxheight -slug: Archive/Mozilla/XUL/Attributs/maxheight -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/maxheight ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La hauteur maximum de l'élément. Ceci correspond à la propriété CSS <code>max-height</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/maxwidth/index.html b/files/fr/archive/mozilla/xul/attributs/maxwidth/index.html deleted file mode 100644 index 3bb415967d..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/maxwidth/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: maxwidth -slug: Archive/Mozilla/XUL/Attributs/maxwidth -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/maxwidth ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La largeur maximum de l'élément. Ceci correspond à la propriété CSS <code>max-width</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/menu/index.html b/files/fr/archive/mozilla/xul/attributs/menu/index.html deleted file mode 100644 index d1c01d2937..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/menu/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: menu -slug: Archive/Mozilla/XUL/Attributs/menu -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/menu ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code> -</dt><dd> Type : <i>id d'un élément popup</i> -</dd><dd> Nom alternatif pour l'attribut <code><code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code></code>, mais dispose également d'une propriété de script « menu ». -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/min/index.html b/files/fr/archive/mozilla/xul/attributs/min/index.html deleted file mode 100644 index 4bdf8e4479..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/min/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: min -slug: Archive/Mozilla/XUL/Attributs/min -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/min ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur minimum que peut prendre l'élément. La valeur par défaut est 0.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/minheight/index.html b/files/fr/archive/mozilla/xul/attributs/minheight/index.html deleted file mode 100644 index 95ea9f8ffb..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/minheight/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: minheight -slug: Archive/Mozilla/XUL/Attributs/minheight -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/minheight ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La hauteur minimum de l'élément. Ceci correspond à la propriété CSS <code>min-height</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/minwidth/index.html b/files/fr/archive/mozilla/xul/attributs/minwidth/index.html deleted file mode 100644 index d1984bdb6b..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/minwidth/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: minwidth -slug: Archive/Mozilla/XUL/Attributs/minwidth -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/minwidth ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La largeur minimum de l'élément. Ceci correspond à la propriété CSS <code>min-width</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/mousethrough/index.html b/files/fr/archive/mozilla/xul/attributs/mousethrough/index.html deleted file mode 100644 index c178218f19..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/mousethrough/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: mousethrough -slug: Archive/Mozilla/XUL/Attributs/mousethrough -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/mousethrough ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Détermine si les évènements souris sont passés à l'élément. Si cet attribut n'est pas spécifié, la valeur est héritée du parent de l'élément. Si aucun ancêtre n'a d'attribut mousethrough défini, la valeur par défaut est <code>never</code>. -</dd></dl> -<ul><li> <code>always</code> : les évènements souris sont invisibles pour l'élément. Cela signifie que l'élément ne recevra aucun évènement souris, que ce soit par des clics ou des déplacements. Les éléments enfants peuvent écraser ce comportement en spécifiant mousethrough="never". -</li><li> <code>never</code> : les évènements souris sont passés normalement à l'élément. -</li></ul> -<div class="noinclude"> -<p>L'attribut mousethrough est typiquement utilisé en conjonction avec un stack pour permettre aux éléments d'être empilés au dessus d'autres tout en permettant aux évènements souris d'être envoyés aux éléments les plus bas. Dans l'exemple suivant, l'image apparait au dessus du bouton, cependant l'attribut mousethrough spécifié sur l'image permet aux évènements souris d'être ignorés sur celle-ci et d'être plutôt renvoyés vers le bouton. Si cet attribut n'avait pas été utilisé, l'image aurait reçu tous les évènements souris et il n'aurait pas été possible d'appuyer sur le bouton. -</p> -<pre><stack> - <button label="En dessous"/> - <image src="happy.png" mousethrough="always"/> -</stack> -</pre> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/name/index.html b/files/fr/archive/mozilla/xul/attributs/name/index.html deleted file mode 100644 index 04b80a0c2c..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/name/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: name -slug: Archive/Mozilla/XUL/Attributs/name -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/name ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/menuitem.name">menuitem.name</a> -</li><li> <a href="fr/XUL/Attributs/preference.name">preference.name</a> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/noautofocus/index.html b/files/fr/archive/mozilla/xul/attributs/noautofocus/index.html deleted file mode 100644 index 307a2db967..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/noautofocus/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: noautofocus -slug: Archive/Mozilla/XUL/Attributs/noautofocus -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/noautofocus ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Attributs/noautofocus">noautofocus</a> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si mis à <code>false</code>, la valeur par défaut, l'élément ayant actuellement le focus le perdra si le popup est ouvert ou fermé. Si mis à <code>true</code>, le focus ne sera pas modifié. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/observes/index.html b/files/fr/archive/mozilla/xul/attributs/observes/index.html deleted file mode 100644 index 7d50606f14..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/observes/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: observes -slug: Archive/Mozilla/XUL/Attributs/observes -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/observes ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code> -</dt><dd> Type : <i>id d'un élément diffuseur</i> -</dd><dd> Défini à l'id d'un élément diffuseur (<code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code>) observé par l'élément. Si un attribut du broadcaster est modifié, il sera également modifié dans l'observateur. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/onchange/index.html b/files/fr/archive/mozilla/xul/attributs/onchange/index.html deleted file mode 100644 index 003e5162cb..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onchange/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: onchange -slug: Archive/Mozilla/XUL/Attributs/onchange -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onchange ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-onchange"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onchange">onchange</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Le code figurant dans l'attribut <code>onchange</code> est appelé lorsque la valeur de l'élément est modifiée. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/oncommand/index.html b/files/fr/archive/mozilla/xul/attributs/oncommand/index.html deleted file mode 100644 index 947dae79d8..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/oncommand/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: oncommand -slug: Archive/Mozilla/XUL/Attributs/oncommand -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/oncommand ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Ce gestionnaire d'évènement est appelé lorsque la commande est activée. Cela se produit quand un utilisateur sélectionne un élément de menu ou active un raccourci clavier attaché à la commande. -</dd></dl> -<div class="noinclude"> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<pre><button label="Cliquez ici" oncommand="alert('Salut')"/> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>L'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code></code>. -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/onpaneload/index.html b/files/fr/archive/mozilla/xul/attributs/onpaneload/index.html deleted file mode 100644 index edaf560356..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onpaneload/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: onpaneload -slug: Archive/Mozilla/XUL/Attributs/onpaneload -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onpaneload ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-onpaneload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpaneload">onpaneload</a></code></dt> - <dd> - Type : <i>code de script</i></dd> - <dd> - Le code défini ici est appelé après le chargement du panneau, de manière similaire à l'évènement <code>load</code> pour une fenêtre.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/onpopuphidden/index.html b/files/fr/archive/mozilla/xul/attributs/onpopuphidden/index.html deleted file mode 100644 index 83e7d64685..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onpopuphidden/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: onpopuphidden -slug: Archive/Mozilla/XUL/Attributs/onpopuphidden -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onpopuphidden ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-onpopuphidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphidden">onpopuphidden</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après qu'il a été caché. <span class="comment"><a class=" external" href="http://www.langue-fr.net/index/A/apres-que.htm" rel="freelink">http://www.langue-fr.net/index/A/apres-que.htm</a></span> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/onpopuphiding/index.html b/files/fr/archive/mozilla/xul/attributs/onpopuphiding/index.html deleted file mode 100644 index 454023d1a0..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onpopuphiding/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: onpopuphiding -slug: Archive/Mozilla/XUL/Attributs/onpopuphiding -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onpopuphiding ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-onpopuphiding"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphiding">onpopuphiding</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/onpopupshowing/index.html b/files/fr/archive/mozilla/xul/attributs/onpopupshowing/index.html deleted file mode 100644 index 42f6d71edb..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onpopupshowing/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: onpopupshowing -slug: Archive/Mozilla/XUL/Attributs/onpopupshowing -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onpopupshowing ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-onpopupshowing"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshowing">onpopupshowing</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> 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 <code>false</code>, le popup ne s'affichera pas. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/onpopupshown/index.html b/files/fr/archive/mozilla/xul/attributs/onpopupshown/index.html deleted file mode 100644 index 07314e2894..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/onpopupshown/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: onpopupshown -slug: Archive/Mozilla/XUL/Attributs/onpopupshown -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/onpopupshown ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-onpopupshown"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshown">onpopupshown</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement <code>onload</code> est envoyé à une fenêtre à son ouverture. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/open/index.html b/files/fr/archive/mozilla/xul/attributs/open/index.html deleted file mode 100644 index fe008056f6..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/open/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: open -slug: Archive/Mozilla/XUL/Attributs/open -tags: - - Attributs_XUL - - Référence_XUL - - needsattention -translation_of: Archive/Mozilla/XUL/Attribute/open ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/ordinal/index.html b/files/fr/archive/mozilla/xul/attributs/ordinal/index.html deleted file mode 100644 index a9b8b0facc..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/ordinal/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: ordinal -slug: Archive/Mozilla/XUL/Attributs/ordinal -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/ordinal ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> Un entier spécifiant la position de l'élément au sein de son parent. Par défaut, les éléments sont affichés dans leur ordre d'apparition dans le code XUL. L'attribut ordinal peut être utilisé pour modifier cet ordre. Notez que la valeur par défaut d'ordinal pour les éléments est 1. L'ordre d'affichage peut être retrouvé à l'aide des propriétés de l'objet <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code> du conteneur. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/orient/index.html b/files/fr/archive/mozilla/xul/attributs/orient/index.html deleted file mode 100644 index 0313690837..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/orient/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: orient -slug: Archive/Mozilla/XUL/Attributs/orient -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/orient ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Utilisé pour spécifier si les enfants de l'élément sont orientés horizontalement ou verticalement. La valeur par défaut dépend de l'élément. Il est également possible d'utiliser la propriété de style <code><a href="fr/CSS/-moz-box-orient">-moz-box-orient</a></code>. -</dd></dl> -<ul><li> <code>horizontal</code> : Les éléments enfants de l'élément sont placés les uns à côté des autres sur une ligne dans l'ordre de leur apparition dans le code source XUL. -</li><li> <code>vertical</code> : Les éléments enfants de l'élément sont placés les uns en dessous des autres sur une colonne dans l'ordre de leur apparition dans le code source XUL. -</li></ul> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <code><a href="fr/XUL/Attributs/separator.orient">separator.orient</a></code> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/pack/index.html b/files/fr/archive/mozilla/xul/attributs/pack/index.html deleted file mode 100644 index 08f444a3f3..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/pack/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: pack -slug: Archive/Mozilla/XUL/Attributs/pack -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/pack ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'attribut <code>pack</code> spécifie où les éléments enfants de la boîte <code><code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code></code> sont placés lorsque celle-ci est plus grande que la taille de ses enfants. Pour les boîtes dont l'orientation est horizontale, il est utilisé pour indiquer la position verticale des enfants. Pour les boîtes dont l'orientation est verticale, il est utilisé pour indiquer la position horizontale des enfants. L'attribut <code>align</code> est utilisé pour spécifier la position dans la direction opposée. Il est également possible de spécifier la valeur de <code>pack</code> à l'aide de la propriété de style <a href="fr/CSS/-moz-box-pack">-moz-box-pack</a>. -</dd></dl> -<ul><li> <code>start</code> : Les éléments enfants sont placés depuis le bord gauche ou supérieur de la boîte. Si celle-ci est plus grande que la taille totale des enfants, l'espace excédentaire est placé du côté droit ou inférieur. -</li><li> <code>center</code> : L'espace excédentaire est partagé également de chaque côté des éléments enfants, ce qui fait que ceux-ci sont placés au centre de la boîte. -</li><li> <code>end</code> : Les éléments enfants sont placés du côté droit ou inférieur de la boîte. Si celle-ci est plus grande que la taille totale des enfants, l'espace excédentaire est placé du côté gauche ou supérieur. -</li></ul> -<div class="noinclude"> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h4> -<p>Plus de détails sur <a href="fr/Tutoriel_XUL/Positionnement_des_%c3%a9l%c3%a9ments#Empaquetage_des_bo.C3.AEtes">l'empaquetage des boîtes dans le Tutoriel XUL</a> -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/pageincrement/index.html b/files/fr/archive/mozilla/xul/attributs/pageincrement/index.html deleted file mode 100644 index 17c3a22c10..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/pageincrement/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: pageincrement -slug: Archive/Mozilla/XUL/Attributs/pageincrement -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/pageincrement ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-pageincrement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pageincrement">pageincrement</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La quantité de laquelle la valeur de l'attribut <code>curpos</code> ou <code>value</code> change lorsque l'utilisateur clique dans la colonne de la barre de défilement (la zone dans laquelle le curseur de la barre se déplace), ou lorsque les touches <kbd>PgUp</kbd> ou <kbd>PgDown</kbd> sont utilisées. La valeur par défaut est 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/persist/index.html b/files/fr/archive/mozilla/xul/attributs/persist/index.html deleted file mode 100644 index 9fe5feb99a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/persist/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: persist -slug: Archive/Mozilla/XUL/Attributs/persist -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/persist ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> -</dt><dd> Type : <i>liste de noms d'attributs séparés par des espaces</i> -</dd><dd> Une liste séparée par des espaces d'attributs à maintenir lorsque la fenêtre est fermée. À sa réouverture, les valeurs des attributs persistants sont restaurées. Dans Mozilla, les attributs persistants sont conservés dans le fichier <code>localstore.rdf</code> du profil. La persistance peut également être stockée à l'aide de la fonction <code>document.persist</code>. Afin qu'elle puisse fonctionner, l'élément doit également avoir un <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/popup.left/index.html b/files/fr/archive/mozilla/xul/attributs/popup.left/index.html deleted file mode 100644 index bf6ab7d045..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/popup.left/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: popup.left -slug: Archive/Mozilla/XUL/Attributs/popup.left -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/popup.left ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Attributs/popup.left">left</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position horizontale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/popup.position/index.html b/files/fr/archive/mozilla/xul/attributs/popup.position/index.html deleted file mode 100644 index bcaf43a628..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/popup.position/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: popup.position -slug: Archive/Mozilla/XUL/Attributs/popup.position -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/popup.position ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Attributs/popup.position">position</a> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'attribut <code>position</code> 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. -</dd></dl> -<ul><li> <code>after_start</code> : Le popup apparait en dessous l'élément avec le coin supérieur gauche du popup aligné avec le coin inférieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. Cette valeur est typiquement uilisée pour les menus déroulants. -</li><li> <code>after_end</code> : Le popup apparait en dessous l'élément avec le coin supérieur droit du popup aligné avec le coin inférieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_start</code> : Le popup apparait au dessus de l'élément avec le coin inférieur gauche du popup aligné avec le coin supérieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_end</code> : Le popup apparait au dessus de l'élément avec le coin inférieur droit du popup aligné avec le coin supérieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_after</code> : Le popup apparait à la droite de l'élément avec le coin inférieur gauche du popup aligné avec le coin inférieur droit de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_before</code> : Le popup apparait à la droite de l'élément avec le coin supérieur gauche du popup aligné avec le coin supérieur droit de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_after</code> : Le popup apparait à la gauche de l'élément avec le coin inférieur droit du popup aligné avec le coin inférieur gauche de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_before</code> : Le popup apparait à la gauche de l'élément avec le coin supérieur droit du popup aligné avec le coin supérieur gauche de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>overlap</code> : Le popup apparait par dessus l'élément avec les coins supérieurs gauches alignés. -</li><li> <code>at_pointer</code> : Le popup apparait à la position du pointeur de la souris. -</li><li> <code>after_pointer</code> : Le popup apparait à la même position horizontale que le pointeur de la souris, mais verticalement, il est placé juste sous l'élément. -</li></ul> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/position">position</a> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/popup.top/index.html b/files/fr/archive/mozilla/xul/attributs/popup.top/index.html deleted file mode 100644 index a451ed325b..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/popup.top/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: popup.top -slug: Archive/Mozilla/XUL/Attributs/popup.top -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/popup.top ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Attributs/popup.top">top</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position verticale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/popup/index.html b/files/fr/archive/mozilla/xul/attributs/popup/index.html deleted file mode 100644 index eccbe7f03e..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/popup/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: popup -slug: Archive/Mozilla/XUL/Attributs/popup -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/popup ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> -</dt><dd> Type : <i>id d'élément popup</i> -</dd><dd> Doit être défini à la valeur de l'<code><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code></code> de l'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code></code> devant apparaitre lorsque l'utilisateur clique sur l'élément. -</dd></dl> -<div class="noinclude"> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Plus d'informations sur l'<a href="fr/Tutoriel_XUL/Menus_surgissants">élément popup dans le tutoriel XUL</a> -</p> -</div> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/position/index.html b/files/fr/archive/mozilla/xul/attributs/position/index.html deleted file mode 100644 index 2d59e59231..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/position/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: position -slug: Archive/Mozilla/XUL/Attributs/position -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/position ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> Lorsqu'un élément est un <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code>, la position est un indice où l'enfant sera inséré. Les indices commencent à 1, utilisez donc une valeur de 1 pour placer un élément au début. Cet attribut est ignoré si un attribut <code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code> ou <code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code> correspond à un élément. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/preference-editable/index.html b/files/fr/archive/mozilla/xul/attributs/preference-editable/index.html deleted file mode 100644 index d81a8aae06..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/preference-editable/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: preference-editable -slug: Archive/Mozilla/XUL/Attributs/preference-editable -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/preference-editable ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code> -</dt><dd> <b><span class="highlightgreen">Mozilla 1.8</span></b> -</dd><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'élément peut être utilisé pour modifier une préférence dans une <code><a href="/fr/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>. L'attribut <code id="a-preference"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference">preference</a></code> peut être utilisé pour se connecter à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>. Cela peut servir aux éléments personnalisés implémentés en XBL. L'élément doit déclencher des évènements change ou select lorsque la valeur est modifiée afin que la préférence soit mise à jour en conséquence. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/preference.name/index.html b/files/fr/archive/mozilla/xul/attributs/preference.name/index.html deleted file mode 100644 index 1fd04497a2..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/preference.name/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: preference.name -slug: Archive/Mozilla/XUL/Attributs/preference.name -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/preference.name ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Attributs/preference.name">name</a> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le nom de la préférence à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>. -</dd></dl> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/name">name</a> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/preference.type/index.html b/files/fr/archive/mozilla/xul/attributs/preference.type/index.html deleted file mode 100644 index 06e0ae3242..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/preference.type/index.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: preference.type -slug: Archive/Mozilla/XUL/Attributs/preference.type -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/preference.type ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> <dt><a href="/fr/XUL/Attributs/preference.type" title="fr/XUL/Attributs/preference.type">type</a></dt> <dd>Type : <em>une des valeurs ci-dessous</em></dd> <dd>Le type de préférence qui doit être une des valeurs suivantes.</dd> -</dl> -<ul> <li><code>bool</code> : Un booléen défini à <code>true</code> ou <code>false</code>. Habituellement, on connectera un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code> à ce type de préférence.</li> <li><code>int</code> : Un entier</li> <li><code>string</code> : Une chaîne de caractères</li> <li><code>unichar</code> : Une chaîne de caractères Unicode</li> <li><code>wstring</code> : Une chaîne localisée. Dans cette situation, la préférence enregistrera le chemin vers un fichier de propriétés contenant la valeur réelle de la préférence.</li> <li><code>file</code> : Un fichier. Le chemin vers le fichier sera stocké dans la préférence.</li> -</ul> diff --git a/files/fr/archive/mozilla/xul/attributs/preference/index.html b/files/fr/archive/mozilla/xul/attributs/preference/index.html deleted file mode 100644 index f4be11503a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/preference/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: preference -slug: Archive/Mozilla/XUL/Attributs/preference -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/preference ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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étés/value">value</a></span></code> de l'élément. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/prefpane.selected/index.html b/files/fr/archive/mozilla/xul/attributs/prefpane.selected/index.html deleted file mode 100644 index ddb5f5de30..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/prefpane.selected/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: prefpane.selected -slug: Archive/Mozilla/XUL/Attributs/prefpane.selected -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/prefpane.selected ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <a href="fr/XUL/Attributs/prefpane.selected">selected</a></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Cet attribut sera défini à <code>true</code> pour l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> actuellement sélectionné. Pour changer le panneau sélectionné, utilisez la méthode <span id="m-showPane"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/showPane">showPane</a></code></span> de <code><a href="/fr/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>.</dd> -</dl> -<div class="noinclude"> - <h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h3> - <ul> - <li><a href="fr/XUL/Attributs/selected">selected</a></li> - </ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/prefpane.src/index.html b/files/fr/archive/mozilla/xul/attributs/prefpane.src/index.html deleted file mode 100644 index f51cb011d3..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/prefpane.src/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: prefpane.src -slug: Archive/Mozilla/XUL/Attributs/prefpane.src -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/prefpane.src ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <a href="fr/XUL/Attributs/prefpane.src">src</a></dt> - <dd> - Type : <i>URL d'un overlay</i></dd> - <dd> - L'URL du contenu du panneau de préférences. Si cet attribut n'est pas spécifié, le contenu de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> sera utilisé.</dd> -</dl> - -<div class="noinclude"> - <h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h3> - <ul> - <li><a href="/fr/docs/XUL/Attributs/src">src</a></li> - </ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/properties/index.html b/files/fr/archive/mozilla/xul/attributs/properties/index.html deleted file mode 100644 index 9939e0557f..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/properties/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: properties -slug: Archive/Mozilla/XUL/Attributs/properties -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/properties ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-properties"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/properties">properties</a></code> -</dt><dd> Type : <i>liste de noms de propriétés séparés par des espaces</i> -</dd><dd> Définit les propriétés de l'élément, qui peuvent être utilisées pour le styler. Pour plus d'informations, consultez <a href="fr/Tutoriel_XUL/Styler_un_arbre">Styler un arbre</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/querytype/index.html b/files/fr/archive/mozilla/xul/attributs/querytype/index.html deleted file mode 100644 index a1be9285d1..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/querytype/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: querytype -slug: Archive/Mozilla/XUL/Attributs/querytype -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/querytype ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Indique le type de source de données (<i>datasource</i>) utilisé dans un template. Firefox 3 fournit les types de données intégrés suivants : 'rdf', default, 'xml' et 'storage'. Des extensions peuvent ajouter une gestion d'autres types de données. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/readonly/index.html b/files/fr/archive/mozilla/xul/attributs/readonly/index.html deleted file mode 100644 index b9c4ee4a7a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/readonly/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: readonly -slug: Archive/Mozilla/XUL/Attributs/readonly -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/readonly ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/ref/index.html b/files/fr/archive/mozilla/xul/attributs/ref/index.html deleted file mode 100644 index 33ad444997..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/ref/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: ref -slug: Archive/Mozilla/XUL/Attributs/ref -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/ref ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> -</dt><dd> Type : <i>URI d'une ressource RDF</i> -</dd><dd> Pour les éléments générés par des templates, cet attribut est utilisé pour indiquer le nœud racine RDF où la génération de contenu commence. Ceci correspondra à la valeur d'un attribut <code>about</code> sur un conteneur RDF. Cet attribut doit être placé en même temps que l'attribut <code>datasources</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/removeelement/index.html b/files/fr/archive/mozilla/xul/attributs/removeelement/index.html deleted file mode 100644 index e818afecba..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/removeelement/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: removeelement -slug: Archive/Mozilla/XUL/Attributs/removeelement -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/removeelement ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Lorsque cet attribut est placé sur un élément dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code>, il indique que l'élément du fichier de base doit être retiré de la fenêtre. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/rows/index.html b/files/fr/archive/mozilla/xul/attributs/rows/index.html deleted file mode 100644 index 5f871bd6bc..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/rows/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: rows -slug: Archive/Mozilla/XUL/Attributs/rows -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/rows ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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éthodes/getRowCount">getRowCount</a></code></span>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/screenx/index.html b/files/fr/archive/mozilla/xul/attributs/screenx/index.html deleted file mode 100644 index 3ec8680474..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/screenx/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: screenX -slug: Archive/Mozilla/XUL/Attributs/screenX -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/screenX ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-screenX"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/screenX">screenX</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> La position horizontale à laquelle la fenêtre apparaît à l'écran. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/screeny/index.html b/files/fr/archive/mozilla/xul/attributs/screeny/index.html deleted file mode 100644 index 1cc65ea6d2..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/screeny/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: screenY -slug: Archive/Mozilla/XUL/Attributs/screenY -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/screenY ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-screenY"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/screenY">screenY</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> La position verticale à laquelle la fenêtre apparaît à l'écran. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/selected/index.html b/files/fr/archive/mozilla/xul/attributs/selected/index.html deleted file mode 100644 index a1b6c466f8..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/selected/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: selected -slug: Archive/Mozilla/XUL/Attributs/selected -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/selected ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code> ou <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedItem">selectedItem</a></span></code> de l'élément conteneur. -</dd></dl> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/prefpane.selected">prefpane.selected</a> -</li><li> <a href="fr/XUL/Attributs/tab.selected">tab.selected</a> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/seltype/index.html b/files/fr/archive/mozilla/xul/attributs/seltype/index.html deleted file mode 100644 index fcb9957382..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/seltype/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: seltype -slug: Archive/Mozilla/XUL/Attributs/seltype -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/seltype ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-seltype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/seltype">seltype</a></code><magic name="\"PAGENAME\"/"></magic></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><magic name="\"PAGENAME\"/">Des cellules individuelles peuvent être sélectionnées.</magic><magic name="\"PAGENAME\"/"> Des lignes sont sélectionnées, cependant, l'indicateur de sélection n'est visible que sur le texte de la colonne principale.</magic></p> diff --git a/files/fr/archive/mozilla/xul/attributs/sizemode/index.html b/files/fr/archive/mozilla/xul/attributs/sizemode/index.html deleted file mode 100644 index 552e358e5f..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/sizemode/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: sizemode -slug: Archive/Mozilla/XUL/Attributs/sizemode -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/sizemode ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-sizemode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sizemode">sizemode</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'état de la fenêtre (<code><code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code></code>). Les valeurs suivantes peuvent être utilisées : -</dd></dl> -<ul><li> <code>maximized</code> : La fenêtre est maximisée, et occupe la totalité de l'écran. -</li><li> <code>minimized</code> : La fenêtre est minimisée, ou masquée. -</li><li> <code>normal</code> : La fenêtre apparaît dans un état normal à la taille désirée. -</li></ul> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/sortdirection/index.html b/files/fr/archive/mozilla/xul/attributs/sortdirection/index.html deleted file mode 100644 index c563a7b193..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/sortdirection/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: sortDirection -slug: Archive/Mozilla/XUL/Attributs/sortDirection -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/sortDirection ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Cet attribut indique la direction dans laquelle le contenu généré par un template est trié. Utilisez l'attribut <code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code> pour spécifier la clé de tri. -</dd></dl> -<ul><li> <code>ascending</code> : les données sont triées dans l'ordre croissant. -</li><li> <code>descending</code>: les données sont triées dans l'ordre décroissant. -</li><li> <code>natural</code> : les données sont triées dans l'ordre naturel, ce qui veut dire l'ordre dans lequel elles sont stockées. -</li></ul> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/sortresource/index.html b/files/fr/archive/mozilla/xul/attributs/sortresource/index.html deleted file mode 100644 index ac33419cef..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/sortresource/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: sortResource -slug: Archive/Mozilla/XUL/Attributs/sortResource -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/sortResource ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code> -</dt><dd> Type : <i>URI d'un prédicat RDF</i> -</dd><dd> Pour du contenu généré par un template, spécifie la clé de tri si le contenu doit être trié. La clé doit être l'URI complète de la ressource par laquelle trier, par exemple « <code><span class="nowiki">http://home.netscape.com/NC-rdf#Name</span></code> ». Placez cet attribut sur le même élément que l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>. Utilisez <code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code> pour spécifier une clé de tri secondaire. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/sortresource2/index.html b/files/fr/archive/mozilla/xul/attributs/sortresource2/index.html deleted file mode 100644 index e1e156e2fd..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/sortresource2/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: sortResource2 -slug: Archive/Mozilla/XUL/Attributs/sortResource2 -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/sortResource2 ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code> -</dt><dd> Type : <i>URI d'un prédicat RDF</i> -</dd><dd> Une clé secondaire de tri pour le contenu. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/src/index.html b/files/fr/archive/mozilla/xul/attributs/src/index.html deleted file mode 100644 index adabab20d0..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/src/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: src -slug: Archive/Mozilla/XUL/Attributs/src -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/src ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code></dt> - <dd> - Type : <i>URL</i></dd> - <dd> - L'adresse URL du contenu devant apparaître dans l'élément.</dd> -</dl> -<div class="noinclude"> - <h3 id="Exemples" name="Exemples">Exemples</h3> - <pre class="brush:xml"><iframe id="content-body" src="http://www.mozilla.org/"/> -<browser src="http://www.mozilla.org" flex="1"/> -<image src="Firefoxlogo.png" width="135" height="130"/> -</pre> - <h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement">Voir également</h3> - <ul> - <li><code id="a-prefpane.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/prefpane.src">prefpane.src</a></code></li> - <li><code id="a-treecell.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/treecell.src">treecell.src</a></code></li> - <li><code id="a-treecol.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/treecol.src">treecol.src</a></code></li> - <li><code id="a-script.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/script.src">script.src</a></code></li> - <li><code id="a-stringbundle.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/stringbundle.src">stringbundle.src</a></code></li> - <li><code id="a-checkbox.src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checkbox.src">checkbox.src</a></code></li> - </ul> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/statustext/index.html b/files/fr/archive/mozilla/xul/attributs/statustext/index.html deleted file mode 100644 index dcbd921f3a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/statustext/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: statustext -slug: Archive/Mozilla/XUL/Attributs/statustext -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/statustext ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Utilisé pour définir le texte apparaissant dans la barre d'état lorsque l'utilisateur passe le pointeur par dessus l'élément. Mozilla ne mettra cependant pas à jour la barre d'état automatiquement. Cet attribut sert juste à conserver le texte. Dans Firefox, celui-ci sera automatiquement placé dans l'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/statusbar" title="statusbar">statusbar</a></code></code> pour les éléments menuitem de la barre de menus. -</dd></dl> -<div class="noinclude"> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<pre><!-- change le message d'état lorsque la souris survole les boutons --> -<button label="Connexion" statustext="Se connecter au serveur distant" - onmouseover="setStatusMessage(this)" onmouseout="clearStatusMessage()"/> -<button label="Ping" statustext="Envoyer un ping au serveur" - onmouseover="setStatusMessage(this)" onmouseout="clearStatusMessage()"/> - -<statusbar> - <statusbarpanel id="myStatusPanel" label="" flex="1"/> - <spacer flex="1"/> -</statusbar> - -<script> -function setStatusMessage(obj){ - document.getElementById('myStatusPanel').label = obj.getAttribute('statustext'); -} -function clearStatusMessage(obj){ - document.getElementById('myStatusPanel').label = ''; -} -</script> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p><code><code><a href="/fr/docs/Mozilla/Tech/XUL/statusbar" title="statusbar">statusbar</a></code></code> et <code><code><a href="/fr/docs/Mozilla/Tech/XUL/statusbarpanel" title="statusbarpanel">statusbarpanel</a></code></code> -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/style/index.html b/files/fr/archive/mozilla/xul/attributs/style/index.html deleted file mode 100644 index 60fa847962..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/style/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: style -slug: Archive/Mozilla/XUL/Attributs/style -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/style ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> -</dt><dd> Type : <i>style CSS inline</i> -</dd><dd> Règles de style CSS à appliquer à l'élément. La syntaxe est identique à celle de l'attribut HTML style. Il est préférable de placer les règles de style dans des feuilles de style séparées. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/suppressonselect/index.html b/files/fr/archive/mozilla/xul/attributs/suppressonselect/index.html deleted file mode 100644 index 5f8cb6b1d5..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/suppressonselect/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: suppressonselect -slug: Archive/Mozilla/XUL/Attributs/suppressonselect -tags: - - Attributs_XUL - - Référence_XUL - - XUL -translation_of: Archive/Mozilla/XUL/Attribute/suppressonselect ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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> diff --git a/files/fr/archive/mozilla/xul/attributs/tabindex/index.html b/files/fr/archive/mozilla/xul/attributs/tabindex/index.html deleted file mode 100644 index 16d1e7e367..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/tabindex/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: tabindex -slug: Archive/Mozilla/XUL/Attributs/tabindex -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/tabindex ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/template/index.html b/files/fr/archive/mozilla/xul/attributs/template/index.html deleted file mode 100644 index 8b88020822..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/template/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: template -slug: Archive/Mozilla/XUL/Attributs/template -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/template ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Pour les éléments générés par des templates, cet attribut peut éventuellement être placé sur le nœud racine (l'élément disposant de l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>) pour faire référence à un template existant autre part dans le code XUL. L'attribut template doit être défini à l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code>. Celui-ci peut être utilisé pour partager un même template entre différents arbres ou menus. Si cet attribut n'est pas spécifié, il doit y avoir un élément template directement dans le nœud. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/timepicker.increment/index.html b/files/fr/archive/mozilla/xul/attributs/timepicker.increment/index.html deleted file mode 100644 index 53d622d39f..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/timepicker.increment/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: timepicker.increment -slug: Archive/Mozilla/XUL/Attributs/timepicker.increment -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/timepicker.increment ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <a href="fr/XUL/Attributs/timepicker.increment">increment</a></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Indique le nombre de minutes à passer chaque fois que les flèches sont actionnées. Cet attribut est à utiliser en combinaison avec une définition de <code>hideseconds</code> à <code>true</code>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/timepicker.value/index.html b/files/fr/archive/mozilla/xul/attributs/timepicker.value/index.html deleted file mode 100644 index 4cc2d5f336..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/timepicker.value/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: timepicker.value -slug: Archive/Mozilla/XUL/Attributs/timepicker.value -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/timepicker.value ---- -<div class="noinclude"> - <span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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> - La valeur initiale du sélecteur de date au format HH:MM:SS ou HH:MM.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/attributs/title/index.html b/files/fr/archive/mozilla/xul/attributs/title/index.html deleted file mode 100644 index 2f123af87d..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/title/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: title -slug: Archive/Mozilla/XUL/Attributs/title -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/title ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-title"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/title">title</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le texte qui doit apparaître dans la barre de titre de la fenêtre ou boîte de dialogue. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/tooltip/index.html b/files/fr/archive/mozilla/xul/attributs/tooltip/index.html deleted file mode 100644 index 8eb387f689..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/tooltip/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: tooltip -slug: Archive/Mozilla/XUL/Attributs/tooltip -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/tooltip ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code> -</dt><dd> Type : <i>id d'un élément tooltip</i> -</dd><dd> Doit être défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code> à utiliser comme fenêtre tooltip (bulle d'information) lorsque l'élément est survolé un certain temps par le pointeur de la souris. Le tooltip disparaîtra automatiquement lors d'un nouveau déplacement de la souris. Si cet attribut est défini à « <code>_child</code> », le premier élément tooltip enfant de l'élément sera utilisé. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/tooltiptext/index.html b/files/fr/archive/mozilla/xul/attributs/tooltiptext/index.html deleted file mode 100644 index f719b5b76a..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/tooltiptext/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: tooltiptext -slug: Archive/Mozilla/XUL/Attributs/tooltiptext -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/tooltiptext ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Utilisé pour définir le texte qui apparaîtra dans la bulle d'information lorsque l'utilisateur place le pointeur de la souris sur l'élément. Ceci peut être utilisé à la place de la définition d'un tooltip vers un popup pour le cas habituel où celui-ci contient uniquement du texte. Le texte est par défaut affiché dans un simple label. Pour modifier le type de tooltip par défaut, définissez l'attribut <code>default</code> sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/top/index.html b/files/fr/archive/mozilla/xul/attributs/top/index.html deleted file mode 100644 index 994e4a27e2..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/top/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: top -slug: Archive/Mozilla/XUL/Attributs/top -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/top ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> Pour les éléments placés directement dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>, spécifie la distance en pixels entre le bord supérieur de l'élément et le bord supérieur du stack. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/type/index.html b/files/fr/archive/mozilla/xul/attributs/type/index.html deleted file mode 100644 index a2d6628e11..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/type/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: type -slug: Archive/Mozilla/XUL/Attributs/type -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/type ---- -<div class="noinclude"> - <h3 id="Voir" name="Voir">Voir</h3> - <ul> - <li><a href="fr/XUL/Attributs/button.type">button.type</a></li> - <li><a href="fr/XUL/Attributs/browser.type">browser.type</a></li> - <li><a href="fr/XUL/Attributs/listitem.type">listitem.type</a></li> - <li><a href="fr/XUL/Attributs/menuitem.type">menuitem.type</a></li> - <li><a href="fr/XUL/Attributs/textbox.type">textbox.type</a></li> - <li><a href="fr/XUL/Attributs/toolbarbutton.type">toolbarbutton.type</a></li> - <li><a href="fr/XUL/Attributs/treecol.type">treecol.type</a></li> - </ul> -</div> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/attributs/uri/index.html b/files/fr/archive/mozilla/xul/attributs/uri/index.html deleted file mode 100644 index 2879d1f18c..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/uri/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: uri -slug: Archive/Mozilla/XUL/Attributs/uri -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/uri ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Pour du contenu généré par un template, l'attribut doit être placé sur l'élément où la génération de contenu doit commencer. Donc, il doit être placé sur un élément qui est le descendant d'un template. La valeur doit être définie à <code>rdf:*</code>. -</dd></dl> -<dl><dd> Les éléments qui apparaissent à l'intérieur de l'élément portant cet attribut seront répétés pour chaque nœud dans la source de données RDF. Les éléments qui sont à l'extérieur n'apparaîtront qu'une seule fois. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/value/index.html b/files/fr/archive/mozilla/xul/attributs/value/index.html deleted file mode 100644 index 86904f020b..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/value/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: value -slug: Archive/Mozilla/XUL/Attributs/value -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/value ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<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 class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Attributs/label.value">label.value</a> -</li><li> <a href="fr/XUL/Attributs/textbox.value">textbox.value</a> -</li><li> [[XUL:Attributs:textnode.value|textnode -</li></ul> -<p>.value]] -</p> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/wait-cursor/index.html b/files/fr/archive/mozilla/xul/attributs/wait-cursor/index.html deleted file mode 100644 index 23677d8118..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/wait-cursor/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: wait-cursor -slug: Archive/Mozilla/XUL/Attributs/wait-cursor -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/wait-cursor ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Définissez cet attribut à <code>true</code> pour que le curseur devienne un curseur d'attente lorsqu'il survole l'élément. Habituellement, on ne l'utilisera que sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> ou d'autres éléments de premier plan. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/width/index.html b/files/fr/archive/mozilla/xul/attributs/width/index.html deleted file mode 100644 index bee18c2365..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/width/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: width -slug: Archive/Mozilla/XUL/Attributs/width -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/width ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La largeur préférée de l'élément. La valeur ne doit pas préciser d'unité car elle est toujours exprimée en pixels. La largeur réellement affichée peut être différente si l'élément ou son contenu ont une largeur minimum ou maximum, ou que la taille est ajustée selon la flexibilité ou l'alignement de son parent. La propriété CSS <code>width</code> peut également être utilisée. -</dd></dl> -<div class="noinclude"> -<p>Dans cet exemple, la largeur préférée de la boîte <code>hbox</code> intérieure sera de 40 pixels. La largeur affichée est également 40 pixels puisqu'aucun ajustement de flexibilité ou d'alignement ne s'applique. -</p> -<pre><hbox> - <hbox width="40" style="background-color: red;"> - <label value="40"/> - </hbox> -</hbox> -</pre> -<p>Cependant, dans l'exemple qui sit, malgré une largeur préférée de 30 pixels pour la boîte, sa largeur affichée sera plus grande pour prendre en compte le label plus grand. -</p> -<pre><vbox width="30" align="start" style="background-color: red;"> - <label value="vbox xul width 10px red"/> -</vbox> -</pre> -<div class="note"><b>Note :</b> Lorsqu'il est utilisé sur des objets <code><a href="fr/XUL/treecol">treecol</a></code> l'attribut <code>width</code> peut permettre à ceux-ci d'être défilables horizontalement si la largeur additionnée des colonnes est supérieure à celle de l'objet conteneur. </div> -</div> diff --git a/files/fr/archive/mozilla/xul/attributs/windowtype/index.html b/files/fr/archive/mozilla/xul/attributs/windowtype/index.html deleted file mode 100644 index 6eb500663d..0000000000 --- a/files/fr/archive/mozilla/xul/attributs/windowtype/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: windowtype -slug: Archive/Mozilla/XUL/Attributs/windowtype -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Attribute/windowtype ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code id="a-windowtype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/windowtype">windowtype</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Définit une chaîne pouvant être utilisée pour identifier le type de fenêtre. Celle-ci peut être utilisée, par exemple, pour faire la distinction entre une fenêtre de navigation et une fenêtre d'édition. Certaines des fonctions de gestion de fenêtres de Mozilla utilisent cet attribut pour grouper les fenêtres du même type. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/box/index.html b/files/fr/archive/mozilla/xul/box/index.html deleted file mode 100644 index a2b2cc6dd4..0000000000 --- a/files/fr/archive/mozilla/xul/box/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: box -slug: Archive/Mozilla/XUL/box -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/box ---- -<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>Un élément conteneur qui peut contenir n'importe quel nombre d'éléments enfants. Si l'élément <code>box</code> a un attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> défini à <code>horizontal</code>, les éléments enfants sont disposés de gauche à droite dans l'ordre de leur apparition dans l'élément box. Si <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> est défini à <code>vertical</code>, ils seront positionnés de haut en bas. Les éléments enfants ne se superposent pas. L'orientation par défaut est <code>horizontal</code>.</p> -<p>Vous trouverez plus d'informations dans le <a href="/fr/Tutoriel_XUL/Le_mod%C3%A8le_de_bo%C3%AEte" title="fr/Tutoriel_XUL/Le_modèle_de_boîte">Tutoriel XUL</a>.</p> -<h3 id="Exemples" name="Exemples">Exemples</h3> -<div class="float-right"><img alt="Image:XUL_ref_box.png"></div> -<pre><box orient="horizontal"> - <label value="Zéro"/> - <box orient="vertical"> - <label value="Un"/> - <label value="Deux"/> - </box> - <box orient="horizontal"> - <label value="Trois"/> - <label value="Quatre"/> - </box> -</box> -</pre> -<h3 id="Attributs" name="Attributs">Attributs</h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h3> -<dl><dt> Éléments </dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> </dd></dl> diff --git a/files/fr/archive/mozilla/xul/button/index.html b/files/fr/archive/mozilla/xul/button/index.html deleted file mode 100644 index adce204aab..0000000000 --- a/files/fr/archive/mozilla/xul/button/index.html +++ /dev/null @@ -1,287 +0,0 @@ ---- -title: button -slug: Archive/Mozilla/XUL/button -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/button ---- -<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>Un bouton qui peut être activé par l'utilisateur. Des gestionnaires d'évènements peuvent être utilisés pour capturer des évènements souris, claviers ou autres. Un bouton est typiquement affiché sous la forme d'un rectangle gris en relief. Le label d'un bouton peut être spécifié à l'aide de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> ou en plaçant du contenu dans l'élément button. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Ajouter_des_boutons">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-autoCheck">autoCheck</a>, <a href="#a-checkState">checkState</a>, <a href="#a-checked">checked</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-dir">dir</a>, <a href="#a-disabled">disabled</a>, <a href="#a-dlgtype">dlgtype</a>, <a href="#a-group">group</a>, <a href="#a-icon">icon</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-open">open</a>, <a href="#a-orient">orient</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-button.type">type</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessKey">accessKey</a>, <a href="#p-accessibleType">accessibleType</a>, <a href="#p-autoCheck">autoCheck</a>, <a href="#p-checkState">checkState</a>, <a href="#p-checked">checked</a>, <a href="#p-command">command</a>, <a href="#p-crop">crop</a>, <a href="#p-dir">dir</a>, <a href="#p-disabled">disabled</a>, <a href="#p-dlgType">dlgType</a>, <a href="#p-group">group</a>, <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-open">open</a>, <a href="#p-orient">orient</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-type">type</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_button.png"></div> -<pre class="eval"><button label="Appuyez" - oncommand="alert('Vous avez appuyé.');"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-autoCheck"> - -</div> -<div id="a-checkState"> - -</div> -<div id="a-checked"> - -<dl> - <dt> - <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code></dt> - <dd> - Type : - <i> - booléen</i> - </dd> - <dd> - Indique si l'élément est coché ou non.</dd> - <dd> - Utilisez <code>hasAttribute()</code> pour déterminer si cet attribut est défini plutôt que <code>getAttribute()</code>.<br> - Pour les boutons, l'attribut <code>type</code> doit etre mis à <code>checkbox</code> ou à <code>radio</code> pour qu'un effet soit perceptible.</dd> -</dl> -</div> -<div id="a-command"> - -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-dir"> - -<dl> - <dt> - <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code></dt> - <dd> - Type : - <i> - une des valeurs ci-dessous</i> - </dd> - <dd> - La direction dans laquelle les éléments enfants de l'élément seront placés.</dd> -</dl> -<ul> - <li><code>normal</code> : <magic name="\"PAGENAME\"/">Les valeurs de l'échelle sont triées de gauche à droite (pour les échelles horizontales) ou de haut en bas (pour les échelles verticales)., Les éléments sont placés de gauche à droite ou de haut en bas dans l'ordre dans lequel ils apparaissent dans le code XUL.)</magic></li> - <li><code>reverse</code> : Les valeurs de l'échelle sont triées de droite à gauche (pour les échelles horizontales) ou de bas en haut (pour les échelles verticales)., Les éléments sont placés de droite à gauche ou de bas en haut. C'est le contraire de l'ordre dans lequel ils apparaissent dans le code XUL.)</li> -</ul> - -<p> </p> -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-dlgtype"> - -</div> -<div id="a-group"> - -</div> -<div id="a-icon"> - -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-open"> - -<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. -</dd></dl> - - -</div> -<div id="a-orient"> - -<dl><dt> <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Utilisé pour spécifier si les enfants de l'élément sont orientés horizontalement ou verticalement. La valeur par défaut dépend de l'élément. Il est également possible d'utiliser la propriété de style <code><a href="fr/CSS/-moz-box-orient">-moz-box-orient</a></code>. -</dd></dl> -<ul><li> <code>horizontal</code> : Les éléments enfants de l'élément sont placés les uns à côté des autres sur une ligne dans l'ordre de leur apparition dans le code source XUL. -</li><li> <code>vertical</code> : Les éléments enfants de l'élément sont placés les uns en dessous des autres sur une colonne dans l'ordre de leur apparition dans le code source XUL. -</li></ul> - - -</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-button.type"> - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<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-autoCheck"></div> -<div id="p-checkState"></div> -<div id="p-checked"></div> -<div id="p-command"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</dd></dl> - -</div> -<div id="p-dir"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/dir">dir</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>. -</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-dlgType"></div> -<div id="p-group"></div> -<div id="p-image"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> - -</div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-open"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/open">open</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code>. -</dd></dl> - -</div> -<div id="p-orient"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/orient">orient</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</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-type"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/type">type</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code>. -</dd></dl> - -</div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<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/NsIDOMXULButtonElement">nsIDOMXULButtonElement</a> -</dd></dl> diff --git a/files/fr/archive/mozilla/xul/caractères_internationaux_dans_du_javascript_xul/index.html b/files/fr/archive/mozilla/xul/caractères_internationaux_dans_du_javascript_xul/index.html deleted file mode 100644 index 756592e74b..0000000000 --- a/files/fr/archive/mozilla/xul/caractères_internationaux_dans_du_javascript_xul/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Caractères internationaux dans du JavaScript XUL -slug: Archive/Mozilla/XUL/Caractères_internationaux_dans_du_JavaScript_XUL -tags: - - Internationalisation - - JavaScript -translation_of: Archive/Mozilla/XUL/International_characters_in_XUL_JavaScript ---- -<p> </p> -<h3 id="Introduction" name="Introduction">Introduction</h3> -<p><a href="/fr/Gecko" title="fr/Gecko">Gecko</a> 1.8, qui est utilisé dans <a href="/fr/Firefox_1.5_pour_les_développeurs" title="fr/Firefox_1.5_pour_les_développeurs">Firefox 1.5</a> et d'autres applications, a ajouté un support pour les caractères non-ASCII dans les fichiers <a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a> chargés depuis des fichiers <a href="/fr/XUL" title="fr/XUL">XUL</a>.</p> -<p>Cela signifie que de tels fichiers de script sont capables d'utiliser virtuellement tous les caractères de n'importe quelle langue dans le monde. Par exemple, ils pourraient contenir une ligne :</p> -<pre class="eval">var text = "Ein schönes Beispiel eines mehrsprachigen Textes: 日本語"; -</pre> -<p>Celle-ci mélange des caractères allemands et japonais.</p> -<p>Les versions précédentes interprétaient toujours les fichiers JS chargés depuis XUL en <a class="external" href="http://fr.wikipedia.org/wiki/ISO_8859-1">ISO-8859-1</a> (Latin-1) aussi bien en local qu'en fichiers distants. Les échappements Unicode, <a href="#Compatibilit.C3.A9_inter-versions">comme expliqué ci-dessous</a>, ont toujours fonctionné.</p> -<h3 id="Comment_l.27encodage_des_caract.C3.A8res_est_d.C3.A9termin.C3.A9_depuis_Gecko_1.8" name="Comment_l.27encodage_des_caract.C3.A8res_est_d.C3.A9termin.C3.A9_depuis_Gecko_1.8">Comment l'encodage des caractères est déterminé depuis Gecko 1.8</h3> -<p>Lorsque le fichier JavaScript est chargé depuis une URL <code>chrome://</code>, un <a href="/fr/Byte_Order_Mark" title="fr/Byte_Order_Mark">Byte Order Mark</a>) est utilisé pour déterminer l'encodage des caractères du script. Autrement, l'encodage sera le même que celui utilisé par le fichier XUL (et spécifié par l'attribut <code>encoding</code> dans la balise <code><?xml?></code>). Par défaut, l'encodage sera l'UTF-8 qui peut représenter virtuellement l'ensemble des caractères dans le monde.</p> -<p>Si le fichier de script est chargé via HTTP, l'en-tête HTTP peut contenir une déclaration d'encodage de caractères comme faisant partie de <code>Content-Type</code>, par exemple :</p> -<pre class="eval">Content-Type: application/x-javascript; charset=UTF-8 -</pre> -<p>Si aucun paramètre charset n'est spécifié, les mêmes règles que précédemment sont appliquées.</p> -<h3 id="Compatibilit.C3.A9_inter-versions" name="Compatibilit.C3.A9_inter-versions">Compatibilité inter-versions</h3> -<p>Si vous voulez que le même code fonctionne à la fois avec Gecko 1.8 et ses versions antérieures, vous devez vous limiter à l'ASCII. Toutefois, vous pouvez employer <a href="/fr/Guide_JavaScript_1.5/Unicode#S.C3.A9quences_d.27.C3.A9chappement_Unicode" title="fr/Guide_JavaScript_1.5/Unicode#S.C3.A9quences_d.27.C3.A9chappement_Unicode">les échappements unicode</a>. Le précédent exemple réécrit deviendrait :</p> -<pre class="eval">var text = "Ein sch\u00F6nes Beispiel eines mehrsprachigen Textes: \u65E5\u672C\u8A9E"; -</pre> -<p>Une alternative serait d'utiliser des fichiers de propriétés via <a href="/fr/NsIStringBundle" title="fr/NsIStringBundle">nsIStringBundle</a> ou <a href="/en/XUL_Tutorial/Property_Files">l\'élément XUL <stringbundle></a> ; ils permettent la localisation du XUL. Ce n'est toutefois pas permis dans des fichiers XUL chargés depuis le Web mais seulement dans un code avec privilèges, c'est-à-dire dans des <a href="/fr/Extensions" title="fr/Extensions">extensions</a>.</p> diff --git a/files/fr/archive/mozilla/xul/checkbox/index.html b/files/fr/archive/mozilla/xul/checkbox/index.html deleted file mode 100644 index cdb848ef56..0000000000 --- a/files/fr/archive/mozilla/xul/checkbox/index.html +++ /dev/null @@ -1,194 +0,0 @@ ---- -title: checkbox -slug: Archive/Mozilla/XUL/checkbox -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/checkbox ---- -<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>Un élément qui peut être activé ou non. Il est le plus généralement affiché sous la forme d'une case vide lorsque l'élément est désactivé et une case avec une coche lorsqu'il est activé. L'utilisateur peut changer l'état de la case à cocher en la sélectionnant avec la souris. Un label, spécifié avec l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>, peut être ajouté à côté de la case à cocher. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Les_champs_de_saisie">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-checked">checked</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-checkbox.src">src</a>, <a href="#a-label">label</a>, <a href="#a-preference">preference</a>, <a href="#a-tabindex">tabindex</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessKey">accessKey</a>, <a href="#p-accessibleType">accessibleType</a>, <a href="#p-checked">checked</a>, <a href="#p-command">command</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-src">src</a>, <a href="#p-label">label</a>, <a href="#p-tabIndex">tabIndex</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_checkbox.png"></div> -<pre class="eval"><checkbox label="Activer JavaScript" checked="true"/> -<checkbox label="Activer Java" checked="false"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-checked"> - -<dl> - <dt> - <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code></dt> - <dd> - Type : - <i> - booléen</i> - </dd> - <dd> - Indique si l'élément est coché ou non.</dd> - <dd> - Utilisez <code>hasAttribute()</code> pour déterminer si cet attribut est défini plutôt que <code>getAttribute()</code>.<br> - Pour les boutons, l'attribut <code>type</code> doit etre mis à <code>checkbox</code> ou à <code>radio</code> pour qu'un effet soit perceptible.</dd> -</dl> -</div> -<div id="a-command"> - -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-checkbox.src"> - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</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-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> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<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-checked"></div> -<div id="p-command"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</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-src"></div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</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> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<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/NsIDOMXULCheckboxElement">nsIDOMXULCheckboxElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/command/index.html b/files/fr/archive/mozilla/xul/command/index.html deleted file mode 100644 index 73dcad8053..0000000000 --- a/files/fr/archive/mozilla/xul/command/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: command -slug: Archive/Mozilla/XUL/command -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/command ---- -<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>Un élément <code>command</code> peut être utilisé pour invoquer une opération pouvant provenir de plusieurs sources différentes. Par exemple, une opération Coller depuis le Presse-papiers peut venir du menu Édition, d'un menu contextuel, ou d'un raccourci clavier. Le code s'attache à une commande avec l'attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code>. Il sera appelé quelle que soit la manière dont la commande est invoquée par l'utilisateur. De plus, la désactivation de la commande désactivera automatiquement les éléments de menus et raccourcis clavier associés. -</p><p>Les commandes sont identifiées par leur attribut <code><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code></code>. Si le script <code><a class=" external" rel="freelink">chrome://global/content/globalOverlay.js</a></code> est inclus dans votre fenêtre, vous pouvez utiliser la fonction <code>goDoCommand</code> pour invoquer la commande. L'avantage est que la commande sera envoyée à la partie de l'interface utilisateur qui y répondra. Typiquement, il s'agira de l'élément ayant actuellement le focus. -</p><p>Comme avec un <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code>, les commandes envoient des attributs à d'autres éléments. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Commandes">Tutoriel XUL</a>. Voir également : l'attribut <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code>, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/commandset" title="commandset">commandset</a></code>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-label">label</a>, <a href="#a-oncommand">oncommand</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>Le code suivant enverra une commande Coller (<code>cmd_paste</code>) à l'élément détenant actuellement le focus : -</p> -<pre class="eval"> // Inclure d'abord <a class=" external" rel="freelink">chrome://global/content/globalOverlay.js</a> - goDoCommand("cmd_paste"); -</pre> -<p>Exemple avec deux boutons -</p> -<pre><command id="cmd_openhelp" oncommand="alert('Aide');"/> -<button label="Aide" command="cmd_openhelp"/> -<button label="Plus d'aide" command="cmd_openhelp"/> -</pre> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-oncommand"> - -<dl><dt> <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Ce gestionnaire d'évènement est appelé lorsque la commande est activée. Cela se produit quand un utilisateur sélectionne un élément de menu ou active un raccourci clavier attaché à la commande. -</dd></dl> - - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<ul><li> <a href="fr/XUL/Liste_de_commandes">XUL:Liste de commandes</a> -</li></ul> diff --git a/files/fr/archive/mozilla/xul/datepicker/index.html b/files/fr/archive/mozilla/xul/datepicker/index.html deleted file mode 100644 index 0425ec07fb..0000000000 --- a/files/fr/archive/mozilla/xul/datepicker/index.html +++ /dev/null @@ -1,231 +0,0 @@ ---- -title: datepicker -slug: Archive/Mozilla/XUL/datepicker -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/datepicker ---- -<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>Un élément <code>datepicker</code> permet à l'utilisateur d'entrer une date. Trois types sont disponibles, ce qui peut être spécifié à l'aide de l'attribut <code>type</code>. -</p> -<ul><li> normal — un sélecteur de date avec trois champs pour entrée l'année, le mois et le jour. -</li><li> grid — un sélecteur de date avec une grille de calendrier pour choisir une date. -</li><li> popup — un sélecteur de date normal avec trois champs, mais avec un bouton déroulant supplémentaire pour afficher une grille dans un popup. -</li></ul> -<p>Plusieurs manières de définir le jour sélectionné existent. En XUL, l'attribut <code>value</code> peut être défini à une valeur de la forme AAAA/MM/JJ pour initialiser le sélecteur de date à une certaine date. S'il n'est pas spécifié, il affichera par défaut le jour actuel. -</p><p>Pour changer la date sélectionnée, la propriété <code>value</code> peut être utilisée pour définir une nouvelle valeur de la forme AAAA/MM/JJ. La propriété <code>dateValue</code> peut être utilisée pour obtenir et définir la date à l'aide d'un objet <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Date"><code>Date</code></a>. En outre, les propriétés <code>date</code>, <code>month</code> et <code>year</code> peuvent être utilisées pour obtenir et modifier chaque composant de la date séparément. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-firstdayofweek">firstdayofweek</a>, <a href="#a-readonly">readonly</a>, <a href="#a-type">type</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-date">date</a>, <a href="#p-dateLeadingZero">dateLeadingZero</a>, <a href="#p-dateValue">dateValue</a>, <a href="#p-disabled">disabled</a>, <a href="#p-month">month</a>, <a href="#p-monthLeadingZero">monthLeadingZero</a>, <a href="#p-open">open</a>, <a href="#p-readOnly">readOnly</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a>, <a href="#p-year">year</a>, <a href="#p-yearLeadingZero">yearLeadingZero</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p><img alt="Image:Controlsguide-datepicker-grid.png"> -</p> -<pre><datepicker type="grid" value="2007/03/26"/> -</pre> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-firstdayofweek"> - -<dl><dt> <code id="a-firstdayofweek"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/firstdayofweek">firstdayofweek</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Indique le jour de la semaine à afficher comme premier jour dans la grille. Les valeurs vont de 0 à 6, où 0 est dimanche et 6 est samedi. La valeur par défaut est déterminée par la locale, n'utilisez donc cet attribut que si vous désirez l'écraser. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-readonly"> - -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</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-datepicker.type"> - -<dl> - <dt> - <a href="fr/XUL/Attributs/datepicker.type">type</a></dt> - <dd> - Type : <i>une des valeurs suivantes</i></dd> - <dd> - L'attribut <code>type</code> peut avoir l'une des valeurs ci-dessous afin de spécifier le type de sélecteur de date à utiliser :</dd> -</dl> -<ul> - <li><code>normal</code> : Un sélecteur de date avec trois champs pour entrer l'année, le mois et le jour. C'est la valeur par défaut, il ne faut donc pas spécifier l'attribut <code>type</code> si c'est le genre désiré.</li> - <li><code>grid</code> : Un sélecteur de date qui affiche une grille de calendrier où un mois est affiché à la fois.</li> - <li><code>popup</code> : Un sélecteur de date avec trois champs d'entrée mais un bouton déroulant supplémentaire qui, lorsqu'on clique dessus, affichera une grille de calendrier.</li> -</ul> - -<p> </p> -</div> -<div id="a-datepicker.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> - La valeur initiale du sélecteur de date sous la forme <var>AAAA/MM/JJ</var>.</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-date"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/date">date</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Le jour du mois actuellement sélectionné, entre 1 et 31. Modifiez cette propriété pour changer la date sélectionnée.</dd> -</dl></div> -<div id="p-dateLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/dateLeadingZero">dateLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché avant la date lorsqu'elle est inférieure à 10.</dd> -</dl></div> -<div id="p-dateValue"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/dateValue">dateValue</a></span></code></dt> - <dd> - Type : <i>Date</i></dd> - <dd> - La date actuellement entrée ou sélectionnée dans le sélecteur de date sous la forme d'un objet <code>Date</code>.</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-month"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/month">month</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Le mois actuellement sélectionné entre 0 (janvier) et 11 (décembre). Définissez cette propriété pour changer le mois sélectionné.</dd> -</dl></div> -<div id="p-monthLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/monthLeadingZero">monthLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché devant le mois s'il est inférieur à 10.</dd> -</dl></div> -<div id="p-datepicker.open"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/open">open</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Pour les sélecteurs de date de type popup, spécifie si celui-ci est ouvert. Définissez cette propriété pour ouvrir ou fermer le popup. Pour les autres types de sélecteurs de date, cette propriété est toujours à <code>false</code>.</dd> -</dl></div> -<div id="p-readOnly"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readonly">readonly</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd> - <dd> - <div class="note"> - Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div> - </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-datepicker.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> - La date actuellement sélectionnée au format AAAA/MM/JJ. Contrairement à la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/month">month</a></span></code>, les mois varient ici dans l'intervalle 01 à 12. Définissez cette propriété pour changer la date sélectionnée.</dd> -</dl></div> -<div id="p-year"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/year">year</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - L'année actuellement sélectionnée entre 1 et 9999. Définissez cette propriété pour changer la date sélectionnée.</dd> -</dl></div> -<div id="p-yearLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/yearLeadingZero">yearLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché devant l'année si elle est inférieure à 1000.</dd> -</dl></div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIDOMXULControlElement">nsIDOMXULControlElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/description/index.html b/files/fr/archive/mozilla/xul/description/index.html deleted file mode 100644 index 2895ae7922..0000000000 --- a/files/fr/archive/mozilla/xul/description/index.html +++ /dev/null @@ -1,150 +0,0 @@ ---- -title: description -slug: Archive/Mozilla/XUL/description -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/description ---- -<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 sert à créer un bloc de texte. Celui-ci peut être défini soit avec l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>, soit en plaçant le texte entre les balises d'ouverture et de fermeture de l'élément <code>description</code>. L'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> sert à définir du texte apparaissant sur une seule ligne. Si du texte apparait comme enfant de l'élément description, il s'étalera éventuellement sur plusieurs lignes. Il peut contenir du balisage arbitraire, qui peut être stylé le cas échéant. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Ajouter_des_libell%c3%a9s_et_des_images">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</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-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-header">header</a>, <a href="#s-indent">indent</a>, <a href="#s-monospace">monospace</a>, <a href="#s-plain">plain</a>, <a href="#s-small-margin">small-margin</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_description.png"></div> -<pre class="eval"><description> - Ceci est une longue section de texte qui sera affichée. -</description> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</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-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</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-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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/header">header</a></code></dt> - <dd>A class used for headings. Typically, this will cause the text to appear bold.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/indent">indent</a></code></dt> - <dd>This class causes the text to be indented on its left side.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/monospace">monospace</a></code></dt> - <dd>This class causes the text to be displayed in a monospace font.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/plain">plain</a></code></dt> - <dd>This class causes the element to be displayed with no border or margin.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/small-margin">small-margin</a></code></dt> - <dd>This class causes the text to be displayed with a smaller margin.</dd> -</dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire. -</p> diff --git a/files/fr/archive/mozilla/xul/dropmarker/index.html b/files/fr/archive/mozilla/xul/dropmarker/index.html deleted file mode 100644 index 88f32fb59d..0000000000 --- a/files/fr/archive/mozilla/xul/dropmarker/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: dropmarker -slug: Archive/Mozilla/XUL/dropmarker -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/dropmarker ---- -<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>Un dropmarker est un bouton avec une flèche qui révèle plus de détails lorsque l'on appuie dessus. Il n'est pas prévu pour être utilisé comme un élément séparé, mais comme partie d'un autre élément. Par exemple, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> et le type « popup » d'un <a href="fr/XUL/datepicker">sélecteur de date</a> utilisent un dropmarker qui, lorsqu'on clique dessus, fera apparaître un menu popup. -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/faq_et_règles_pour_les_accesskeys_en_xul/index.html b/files/fr/archive/mozilla/xul/faq_et_règles_pour_les_accesskeys_en_xul/index.html deleted file mode 100644 index 12a2836539..0000000000 --- a/files/fr/archive/mozilla/xul/faq_et_règles_pour_les_accesskeys_en_xul/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: FAQ et règles pour les accesskeys en XUL -slug: Archive/Mozilla/XUL/FAQ_et_règles_pour_les_accesskeys_en_XUL -tags: - - XUL -translation_of: Archive/Mozilla/XUL/XUL_Accesskey_FAQ_and_Policies ---- -<p> -</p> -<h3 id="Qu.27est-ce_qu.27une_accesskey_.3F" name="Qu.27est-ce_qu.27une_accesskey_.3F"> Qu'est-ce qu'une accesskey ? </h3> -<p>Une accesskey ou touche mnémonique est une lettre soulignée dans une page Web, un menu ou un dialogue qui indique à l'utilisateur un raccourci clavier rapide simulant un clic sur cet élément. Par exemple, un bouton « Appliquer » peut avoir la lettre « A » soulignée. Sous Windows et UNIX, appuyer sur les touches <kbd>ALT+A</kbd> est une façon pratique de pousser le bouton. Sous Macintosh, les accesskeys ne sont disponibles qu'en <a href="fr/HTML">HTML</a> et pas en <a href="fr/XUL">XUL</a>, et elles sont activées en utilisant la touche <kbd>CTRL+</kbd> lettre au lieu de <kbd>ALT</kbd>. -</p> -<h3 id="Comment_une_accesskey_est-elle_ajout.C3.A9e_.C3.A0_un_contr.C3.B4le_de_formulaire_.3F" name="Comment_une_accesskey_est-elle_ajout.C3.A9e_.C3.A0_un_contr.C3.B4le_de_formulaire_.3F"> Comment une accesskey est-elle ajoutée à un contrôle de formulaire ? </h3> -<p>Une accesskey peut être ajoutée à un contrôle ou libellé de formulaire <a href="fr/HTML">HTML</a> ou <a href="fr/XUL">XUL</a> en utilisant l'attribut <code>accesskey</code>. Par exemple, voici comment on peut ajouter une accesskey à un bouton XUL : -</p> -<table style="margin: 0;"> <tbody><tr> -<td><code><button label="Appliquer maintenant" accesskey="A" /></code> -</td><td style="background-color: #DDF; border: blue outset; padding: 3px;"><span style="">A</span>ppliquer maintenant -</td></tr> <tr> -<td colspan="2">- ou - -</td></tr> <tr> -<td><code><button label="Appliquer maintenant" accesskey="a" /></code> -</td><td style="background-color: #DDF; border: blue outset; padding: 3px;">Appliquer m<span style="">a</span>intenant -</td></tr> -</tbody></table> -<p>Dans Mozilla, nous utilisons des DTD pour rajouter une autre couche d'abstraction à des fins d'internationalisation. L'exemple ci-dessus devrait donner : -</p><p><code><button label="Appliquer maintenant" accesskey="&applyInstantly.accesskey" /> </code> -</p><p>(Utilisez toujours <code>accesskey</code> au lieu de <code>akey</code>). -</p><p>Si des méthodes comme <code>confirm()</code>, <code>confirmEx()</code> ou <code>prompt()</code> sont utilisées pour créer un dialogue, utilisez un « & » devant le texte du bouton ou de la case à cocher fait du caractère qui suit une accesskey. Par exemple, <code>&Maintenant</code> transforme « M » en accesskey soulignée. Pour insérer un véritable caractère esperluète, utilisez <code>&&</code>. -</p> -<h3 id="Comment_choisir_une_lettre_d.27accesskey_.3F" name="Comment_choisir_une_lettre_d.27accesskey_.3F"> Comment choisir une lettre d'accesskey ? </h3> -<ul><li> L'attribut « accesskey » est sensible à la casse ! -<ul><li> Remarquez que la différence dans l'exemple des deux boutons ci-dessus est la spécification de la casse. La mise en œuvre des accesskeys de Mozilla essaiera d'abord de souligner une lettre de la même casse, mais s'il n'y en a pas il se rabattra sur la lettre de casse opposée. Nous préférons souligner la première lettre de l'un des mots, il est donc important d'être conscient ce cette particularité. -</li></ul> -</li><li> Évitez les doublons -<ul><li> N'utilisez pas deux fois la même lettre d'accesskey dans la même fenêtre. -</li><li> Soyez particulièrement attentifs aux menus déroulants dans la même fenêtre. Par exemple, dans le dialogue du Gestionnaire de marque-pages, n'utilisez pas F, E, A, T ou i (Fichier, Edition, Affichage, Tâches, Aide). -</li><li> Aide demandée : il serait utile d'avoir un outil automatisé pour vérifier l'existence de doublons d'accesskeys et les accesskeys manquantes dans les fichiers XUL. -</li></ul> -</li><li> Rendez-les faciles à voir -<ul><li> Utilisez les lettres au début du premier ou du second mot du libellé. -</li><li> Utilisez un consonne ou une voyelle distinctive dans le libellé. -</li><li> Utilisez les lettres de grande largeur, telles que w, m et les lettres majuscules. -</li><li> Évitez les lettres avec des jambages, telles que p, g, q ou y. -</li><li> Les lettres adjacentes aux lettres ayant des jambages. -</li><li> Les lettres n'ayant qu'un pixel de largeur, comme i ou l. -</li></ul> -</li><li> Rendez-les faciles à mémoriser -<ul><li> Faites en premier les menus importants pour qu'ils aient les meilleures accesskeys. -</li><li> Regardez si un menu similaire a une accesskey quelque part ailleurs dans Mozilla et utilisez la même accesskey. Il y a aussi des accesskeys standard dans Windows, comme Propriétés. -</li><li> Sinon, essayez la première lettre du premier mot du menu. -</li><li> Puis la première lettre d'un autre mot. -</li><li> Enfin, utilisez des lettres non muettes dans un mot d'action (faites cela quand vous avez choisi les accesskeys pour le reste du dialogue). -</li></ul> -</li><li> Éléments courants n'ayant pas d'accesskeys -<ul><li> Boutons OK. -</li><li> Boutons Annuler. -</li><li> Boutons Fermer. -</li><li> Libellés d'onglets. -</li><li> Boutons des barres d'outils -</li><li> Éléments d'arbres -</li><li> Éléments de listes -</li><li> En-têtes de colonnes -</li></ul> -</li></ul> -<h3 id="Y_a-t-il_des_bogues_critiques_que_je_devrais_conna.C3.AEtre_.3F" name="Y_a-t-il_des_bogues_critiques_que_je_devrais_conna.C3.AEtre_.3F"> Y a-t-il des bogues critiques que je devrais connaître ? </h3> -<ul><li> <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=143065" title="FIXED: Scope of accesskey should be limited to a tab panel/-moz-deck">bug 143065</a> - La portée des accesskeys n'est pas limitée au panneau courant. -</li></ul> -<h3 id="O.C3.B9_les_accesskeys_doivent-elles_.C3.AAtre_ajout.C3.A9es_.3F" name="O.C3.B9_les_accesskeys_doivent-elles_.C3.AAtre_ajout.C3.A9es_.3F"> Où les accesskeys doivent-elles être ajoutées ? </h3> -<p>Recherchez les dépendances du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=129179" title="Meta bug: hook up XUL accesskeys throughout the UI">bug 129179</a> (le méta bogue de gestion des accesskeys XUL), ou recherchez les bogues avec « accesskey » ou « mnemonic » dans le résumé, ou recherchez les dialogues où il n'y a pas d'éléments avec des lettres soulignées. -</p><p>Ouvrez les bogues sous le composant « Keyboard Navigation », et rendez le méta <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=129179" title="Meta bug: hook up XUL accesskeys throughout the UI">bug 129179</a> dépendant de ceux-ci. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/guide_des_popups/index.html b/files/fr/archive/mozilla/xul/guide_des_popups/index.html deleted file mode 100644 index aaebd62a1b..0000000000 --- a/files/fr/archive/mozilla/xul/guide_des_popups/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Guide des popups -slug: Archive/Mozilla/XUL/Guide_des_popups -translation_of: Archive/Mozilla/XUL/PopupGuide ---- -<p> -</p> -<h3 id="Popups_et_menus" name="Popups_et_menus"> Popups et menus </h3> -<p>Différents types de popups et menus peuvent être créés. Un popup est un menu ou une fenêtre flottante sans barre de titre, bordures ou autres décorations de fenêtre qui peut s'étendre au-delà des limites de la fenêtre principale. -</p> -<h4 id="Types_de_popups" name="Types_de_popups"> Types de popups </h4> -<p>XUL fournit un certain nombre de types d'éléments différents qui peuvent être utilisés pour créer des menus popups ou d'autres types de widgets popups, qui varient selon la manière dont ils sont attachés à un élément et de s'ouvrir. Un aperçu rapide de chaque type est donné ici ; plus de détails pour chacun des types peuvent être obtenus en suivant les liens correspondants. -</p><p>Dans ce guide, le terme « popup » fait référence à tous les types de popups, tandis que le terme « menu » fait référence à un type particulier de popup. En particulier, les deux premiers types de la liste ci-dessous sont des menus. -</p> -<dl><dt><a href="fr/XUL/Guide_des_popups/Menus">Menus</a> -</dt><dd> Un menu s'utilise lorsque l'on désire avoir une série de commandes pouvant être activées par l'utilisateur, mais sans devoir utiliser la place que prendrait un bouton pour chaque commande. Un menu est normalement masqué, et lorsqu'il est activé un popup contenant la liste des commandes apparaît. L'utilisateur peut sélectionner une commande et le menu disparaît à nouveau. -</dd><dd> On crée un menu avec l'élément <code>menupopup</code>. Il affiche des éléments dans une liste, peut afficher des sous-menus et fournit une navigation au clavier entre les différents éléments. Un menu ne doit contenir que des éléments liés aux menus. -</dd><dt><a href="fr/XUL/Guide_des_popups/Menus_contextuels">Menus contextuels</a> -</dt><dd> Un menu contextuel est comme un menu normal, sauf que les commandes qu'il contient s'appliquent à ce sur quoi l'utilisateur a cliqué pour ouvrir le menu. Souvent, selon l'élément sur lequel on a cliqué, certaines commandes seront masquées si elles ne sont pas applicables à cet élément. </dd><dt><a href="fr/XUL/Guide_des_popups/Panels">Panels</a> -</dt><dd> Un panel peut contenir tout type de contenu. Il est utile lorsque l'on veut afficher certains contrôles temporairement par dessus l'interface utilisateur existante. Par exemple, un champ de recherche dans un popup peut être utilisé pour permettre une recherche et disparaître dès qu'un terme de recherche a été entré. -</dd><dd> Un panel se crée à l'aide de l'élément <code>panel</code>. -</dd><dt><a href="fr/XUL/Guide_des_popups/Tooltips">Tooltips</a> -</dt><dd> Lorsque le pointeur de la souris est positionné au dessus d'un contrôle d'interface utilisateur, un tooltip fournit une bulle d'aide ou d'information, une petite boîte avec un texte descriptif concernant ce contrôle. Lorsque le pointeur est déplacé en dehors du contrôle, le tooltip disparaît automatiquement. -</dd><dd> Un tooltip peut être créé en définissant l'attribut <code>tooltiptext</code> sur un élément ou à l'aide de l'élément <code>tooltip</code>. -</dd></dl> -<h4 id="Utilisation_de_popups" name="Utilisation_de_popups"> Utilisation de popups </h4> -<p>Les informations complémentaires suivantes sont disponibles concernant la manipulation de menus et de popups. -</p> -<dl><dt> Ouverture d'un menu ou d'un popup -</dt><dd> La plupart des menus et des popups sont ouverts automatiquement lorsqu'ils sont associés avec un élément. Pour ouvrir un popup à l'aide d'un script, utilisez les méthodes <code>openPopup</code> ou <code>openPopupAtScreen</code>. Pour des informations détaillées sur la manière d'ouvrir un popup, consultez <a href="fr/XUL/Guide_des_popups/Ouverture_et_fermeture#Ouverture_d.27un_popup">Ouverture d'un popup</a> ou <a href="fr/XUL/Guide_des_popups/Ouverture_et_fermeture#Ouverture_d.27un_menu">Ouverture d'un menu</a>. -</dd></dl> -<dl><dt> Fermeture d'un menu ou d'un popup -</dt><dd> Pour des informations sur la fermeture d'un popup, consultez <a href="fr/XUL/Guide_des_popups/Ouverture_et_fermeture#Fermeture_d.27un_popup_avec_la_m.C3.A9thode_hidePopup">Fermeture d'un popup</a> ou <a href="fr/XUL/Guide_des_popups/Ouverture_et_fermeture#Fermeture_d.27un_menu">Fermeture d'un menu</a>. -</dd></dl> -<dl><dt> Comment sont placés les popups -</dt><dd> Pour en savoir plus sur la manière dont la position d'un popup à l'écran est déterminée, et comment aligner des popups sur d'autres éléments, consultez <a href="fr/XUL/Guide_des_popups/Positionnement">Positionnement des popups</a>. -</dd></dl> -<dl><dt> Determiner si un popup est ouvert -</dt><dd> Pour déterminer si un popup ou un menu est ouvert, consultez <a href="fr/XUL/Guide_des_popups/Ouverture_et_fermeture#D.C3.A9terminer_si_un_popup_est_ouvert">Déterminer si un popup est ouvert</a>. -</dd></dl> -<dl><dt> Déplacement d'un popup -</dt><dd> Les popups peuvent être déplacés à l'aide de la méthode <code>moveTo</code>. Consultez <a href="fr/XUL/Guide_des_popups/D%c3%a9placement_et_redimensionnement#D.C3.A9placement_d.27un_popup">Déplacement d'un popup</a>. -</dd></dl> -<dl><dt> Redimensionnement d'un popup -</dt><dd> La taille d'un popup peut être ajustée à l'aide de la méthode <code>sizeTo</code>. Consultez <a href="fr/XUL/Guide_des_popups/D%c3%a9placement_et_redimensionnement">Redimensionnement d'un popup</a>. -</dd></dl> -<dl><dt> Attacher des menus à un bouton -</dt><dd> Pour en savoir plus sur l'ouverture d'un menu lorsqu'un bouton est enfoncé, consultez <a href="fr/XUL/Guide_des_popups/Boutons_de_menus">Boutons de menus</a>. -</dd></dl> -<dl><dt> Fonctionnalités des éléments d'un menu -</dt><dd> Pour en savoir plus sur les diverses fonctionnalités des éléments d'un menu, consultez <a href="fr/XUL/Guide_des_popups/%c3%89l%c3%a9ments_de_menus">Fonctionnalités de l'élément menuitem</a> -</dd></dl> -<dl><dt> Modification des éléments d'un menu -</dt><dd> Pour ajouter, insérer et retirer des éléments d'un menu, consultez <a href="fr/XUL/Guide_des_popups/Modification_d'un_menu">Modification d'un menu</a>. -</dd></dl> -<dl><dt> Évènements d'ouverture ou fermeture de popups -</dt><dd> Les évènements <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popupshowing">popupshowing</a> et <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popupshown">popupshown</a> se déclenchent lorsqu'un menu ou un popup s'ouvre. Les évènements <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popuphiding">popuphiding</a> et <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popuphidden">popuphidden</a> se déclenchent lorsqu'un menu ou un popup se ferme. Pour plus d'informations sur ces évènements, consultez <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups">Évènements des popups</a>. -</dd></dl> -<dl><dt> Gestion des touches du clavier dans les popups -</dt><dd> Pour des informations sur la manière dont les touches du clavier sont gérées au sein des menus et panels, consultez <a href="fr/XUL/Guide_des_popups/Touches_du_clavier">Gestion des touches du clavier dans les popups</a>. -</dd></dl> -<dl><dt> Considérations liées à la plateforme -</dt><dd> Consultez <a href="fr/XUL/Guide_des_popups/Menus_de_la_plateforme">les considérations spéciales des menus par plateforme</a> pour quelques notes concernant la gestion des menus sur certaines plateformes, par exemple la création d'un menu Application sur un Macintosh. -</dd></dl> -<h4 id="Utilisation_des_popups_dans_des_extensions" name="Utilisation_des_popups_dans_des_extensions"> Utilisation des popups dans des extensions </h4> -<p>Les extensions peuvent ajouter des éléments de menus supplémentaires à un menu de la barre de menus ou au menu contextuel. De plus une extension peut ajouter un tout nouveau menu complet. Par exemple, une extension peut vouloir ajouter une nouvelle commande dans le menu Outils pour ouvrir un dialogue spécifique à l'extension. Une autre tâche courante est de créer une extension ajoutant un élément au menu contextuel du navigateur. Consultez <a href="fr/XUL/Guide_des_popups/Extensions">Utilisation de menus et popups dans des extensions</a> pour plus de détails. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/guide_des_popups/ouverture_et_fermeture/index.html b/files/fr/archive/mozilla/xul/guide_des_popups/ouverture_et_fermeture/index.html deleted file mode 100644 index ee61ae1e5f..0000000000 --- a/files/fr/archive/mozilla/xul/guide_des_popups/ouverture_et_fermeture/index.html +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Ouverture et fermeture -slug: Archive/Mozilla/XUL/Guide_des_popups/Ouverture_et_fermeture -tags: - - Guide Popup XUL - - XUL -translation_of: Archive/Mozilla/XUL/PopupGuide/OpenClose ---- -<h3 id="Ouverture_et_fermeture_de_popups" name="Ouverture_et_fermeture_de_popups">Ouverture et fermeture de popups</h3> - -<p>Les popups et menus peuvent être ouverts et fermés depuis un script.</p> - -<h4 id="Ouverture_d.27un_menu" name="Ouverture_d.27un_menu">Ouverture d'un menu</h4> - -<p>Les menus s'afficheront d'eux-mêmes automatiquement dès que nécessaire sans aucun travail supplémentaire. Par exemple, le popup d'un menu s'ouvrira lors d'un clic sur le label de menu, et un sous-menu s'ouvrira lors du passage de la souris sur l'élément du menu parent.</p> - -<p>Cependant, vous pourrez vouloir ouvrir un menu manuellement dans certaines situations. L'élement <code>menu</code> a une propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> qui peut être définie à <code>true</code> pour ouvrir le menu, ou <code>false</code> pour le fermer. Un exemple simple :</p> - -<pre>un_menu.open = true; -</pre> - -<p>Cette unique ligne de code ouvrira un menu référencé par la variable « un_menu ». Notez que la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> s'applique au menu ou au bouton, pas à l'élément menupopup. Voici un exemple complet utilisant un bouton pour ouvrir un menu :</p> - -<pre><button label="Ouvrir un menu" - oncommand="document.getElementById('editMenu').open = true;"/> - -<menu id="editMenu" label="Édition"> - <menupopup> - <menuitem label="Couper"/> - <menuitem label="Copier"/> - <menuitem label="Coller"/> - </menupopup> -</menu> -</pre> - -<p>Cette technique peut être utilisée pour les menupopups qui utilisent la balise <code>menu</code> tant que pour ceux qui utilisent les balises <code>button</code> et <code>toolbarbutton</code>. Pour les menupopups attachés à d'autres éléments à l'aide des attributs <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> ou <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, consultez <a href="#Ouverture_d.27un_popup">Ouverture d'un popup</a> plus bas.</p> - -<p>Comme avec les autres manières d'ouvrir un menu, l'évènement <code>popupshowing</code> sera déclenché pour permettre de personnaliser les commandes apparaissant dans le menu.</p> - -<p>Dans certaines situations, il n'est pas permis d'ouvrir un menu :</p> - -<ul> - <li>si le menu est déjà ouvert, ou en cours d'ouverture. Naturellement, essayer d'ouvrir un menu qui est déjà ouvert n'aura aucun effet.</li> - <li>si le menu est l'enfant d'un autre menu et que ce menu parent n'est pas ouvert. Dans ce cas, le menu parent doit d'abord être ouvert. Si vous voulez ouvrir un sous-menu, ouvrez d'abord le menu parent, puis le sous-menu dans un gestionnaire d'évènement <code>popupshown</code>. Consultez <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popupshown">L'évènement popupshown</a> pour un exemple de réalisation.</li> - <li>un menu dans une fenêtre de contenu sans privilèges (comme une page Web) ne peut ouvrir un popup que si sa fenêtre a le focus, et qu'il est dans l'onglet actif. Cela signifie qu'un document dans un onglet d'arrière-plan ne peut ouvrir de menu ou de popup.</li> -</ul> - -<h4 id="Fermeture_d.27un_menu" name="Fermeture_d.27un_menu">Fermeture d'un menu</h4> - -<p>Un menu se fermera automatiquement une fois que l'utilisateur a fait une sélection depuis celui-ci. Lorsqu'un élément de menu est sélectionné, il déclenche un évènement de commande afin que du code puisse être utilisé pour effectuer une action. L'utilisateur peut annuler la sélection d'une commande en appuyant sur la touche Échap. Ceci fermera un menu simple, mais s'il avait un menu parent, celui-ci restera ouvert. Un utilisateur peut également annuler la sélection en cliquant end ehors du menu. Dans ce cas, non seulement le menu sera fermé, mais tous les menus parents le seront également.</p> - -<p>Un menu peut être fermé par un script en définissant la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> à <code>false</code>, le contraire de ce qu'on ferait pour ouvrir le menu. La propriété <code>open</code> s'applique au menu ou au bouton, mais pas au <code>menupopup</code>.</p> - -<pre>un_menu.open = false; -</pre> - -<p>Cette commande fermera uniquement un seul niveau de menus, de sorte que tout menu parent devra être fermé avec une commande semblable si nécessaire. Cependant, les éventuels menus enfants de « un_menu » dans cet exemple seront fermé puisque celui-ci ne sera plus ouvert. Par exemple, disons qu'un menu Fichier a un sous-menu contenant une liste de fichiers récemment utilisés. Si les deux menus sont ouverts et que l'on met la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> du sous-menu à <code>false</code>, celui-ci sera fermé mais le menu Fichier parent restera ouvert. D'un autre côté, si c'est la propriété <code>open</code> du menu Fichier qui est mise à <code>false</code>, les deux menus se fermeront.</p> - -<p>Cette technique peut être utilisée tant pour les menupopups qui utilisent les balises <code>menu</code> et <code>button</code> que <code>toolbarbutton</code>. Pour les menupopups attachés à d'autres éléments à l'aide des attributs <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> ou <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, consultez <a href="#Fermeture_d.27un_popup_avec_la_m.C3.A9thode_hidePopup">Fermeture d'un popup</a> plus bas.</p> - -<p>Lorsqu'un menu est fermé, l'évènement <code>popuphiding</code> est déclenché sur celui-ci. On peut donc attacher un écouteur sur cet évènement pour retirer toute commande qui avait été ajoutée au cours de l'évènement <code>popupshowing</code>.</p> - -<p>Les menus et popups seront également fermés lorsque le document ou la fenêtre dans lesquels ils sont contenus seront fermés, ou si l'élément <code>menupopup</code> est retiré du document. Ce sont des situations dans lesquelles les évènements <code>popuphiding</code> et <code>popuphidden</code> peuvent ne pas se déclencher étant donné que les éléments concernés ne sont plus disponibles. Si des actions spécifiques doivent être effectués à ce moment-là, il vaut mieux utiliser un évènement <code>unload</code>.</p> - -<h4 id="Test_de_l.27.C3.A9tat_d.27ouverture_d.27un_menu" name="Test_de_l.27.C3.A9tat_d.27ouverture_d.27un_menu">Test de l'état d'ouverture d'un menu</h4> - -<p>Pour vérifier si un menu est ouvert, vérifiez l'état de sa propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code>. Si celle-ci vaut <code>true</code>, le menu est ouvert, sinon il est fermé.</p> - -<pre>var open = un_menu.open; -</pre> - -<h4 id="Ouverture_d.27un_popup" name="Ouverture_d.27un_popup">Ouverture d'un popup</h4> - -<p>Pour ouvrir des popups de menu utilisant les balises <code>menu</code>, <code>button</code> et <code>toolbarbutton</code>, consultez <a href="#Ouverture_d.27un_menu">Ouverture d'un menu</a> plus haut.</p> - -<p>Les popups attachés à l'aide de l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> sont ouverts lors d'un clic gauche de la souris par l'utilisateur. Il n'y a pas moyen d'effectuer la même action à partir du clavier, vous devrez donc toujours fournir une manière alternative d'accéder aux fonctionnalités du menu. Cela peut se faire soit en plaçant des commandes alternatives ailleurs dans l'interface, ou en fournissant un raccourci clavier permettant d'ouvrir le menu. Une fois que celui-ci est ouvert, le clavier peut être utilisé pour y naviguer et sélectionner des éléments de la manière habituelle.</p> - -<p>Les popups attachés à l'aide de l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code> sont ouvert lorsque l'utilisateur effectue une action essayant d'ouvrir un menu contextuel. Cette action diffère selon la plateforme, mais en général il s'agit de cliquer sur l'élément avec le bouton de droite de la souris. Sur les systèmes Macintosh avec un seul bouton, un menu contextuel peut être ouvert soit en maintenant le bouton de la souris enfoncé, soit en appuyant sur la touche Control lors du clic sur le bouton. Sous Windows, le menu contextuel peut également être ouvert à l'aide de la touche menu sur le clavier (Il s'agit de la touche figurant sur de nombreux claviers à côté de la touche Ctrl de droite avec une image de menu) ou en appuyant sur Shift+F10. Pour cette raison, il ne faut pas supposer que l'utilisateur a forcément utilisé la souris pour ouvrir le menu contextuel.</p> - -<h5 id="La_m.C3.A9thode_openPopup" name="La_m.C3.A9thode_openPopup">La méthode openPopup</h5> - -<p>Quel que soit le type de popup, il peut être nécessaire de l'ouvrir programmatiquement. Pour ce faire, utilisez la méthode <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup</a></code></span> du popup. Cette méthode peut être utilisée pour tout type de popup, qu'il s'agisse d'un menupopup, d'un panel ou un tooltip, même ceux qui peuvent être ouverts par d'autres moyens, par exemple un popup attaché par l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>.</p> - -<p>La méthode <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup</a></code></span> peut recevoir six paramètres qui sont utilisés pour indiquer comment et où le popup doit être positionné. Ils seront décrits plus loin. La méthode <code>openPopup</code> est définie comme suit :</p> - -<pre>void openPopup(in DOMElement anchorElement, - in String position, - in long x, - in long y, - in boolean estMenuContextuel, - in boolean ecraserAttributs); -</pre> - -<p>Tout d'abord, un exemple :</p> - -<pre>un_popup.openPopup(ancre, "after_start", 0, 0, false, false); -</pre> - -<p>Cet exemple ouvrira un popup situé juste sous un autre élément référencé par « ancre ». Ceci émula la façon dont s'ouvre un menu, où « ancre » serait l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>. Il est possible d'utiliser la méthode <code>openPopup</code> avec un menu, cependant il est plus facile de définir simplement l'attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> du menu à <code>true</code>, ce qui gèrera le positionnement du menu à votre place. Notez que si l'attribut open s'applique au menu ou bouton parent, la méthode <code>openPopup</code> s'applique à l'élément menupopup.</p> - -<p>L'ancre d'un popup est le nœud élément à côté duquel le popup sera affiché. Par exemple, pour qu'un popup apparaisse à côté d'un bouton, passez une référence au bouton comme premier paramètre de la méthode <code>openPopup</code>. Dans cet exemple, le popup sera ouvert relativement à l'élément du document.</p> - -<pre>un_popup.openPopup(document.documentElement, "end_before", 0, 0, false, false); -</pre> - -<p>Le second paramètre d'openPopup est la <code>position</code> par rapport à l'ancre, qui indique de quel côté de celle-ci le popup sera positionné. Par exemple, la valeur « end_before » utilisée dans l'exemple précédent indique de placer le côté gauche du popup le long du bord droit de l'élément d'ancrage, avec les deux bords supérieurs alignés. Cela peut être compliqué à comprendre, consultez alors <a href="fr/XUL/Guide_des_popups/Positionnement">Positionnement d'un popup</a> qui décrit ce processus plus en détail et fournit des images montrant les valeurs possibles et la façon dont serait aligné un popup pour chacune des valeurs.</p> - -<p>Les troisième et quatrième paramètres d'openPopup sont des décalages <code>x</code> et <code>y</code>. Après le positionnement initial du popup, il est possible de l'ajuster en spécifiant des valeurs non nulles pour ces décalages. Ceci permet de contrôler précisément le popup tout en étant toujours ancré à un élément particulier. Des valeurs positives peuvent être utilisées pour ajuster le popup vers la droite ou vers le bas et des valeurs négatives pour l'ajuster vers la gauche ou le haut.</p> - -<p>Dans l'exemple qui suit, le popup est ancré sous un élément, tout en étant décalé de 10 pixels vers la droite et de 2 pixels vers le haut.</p> - -<pre>un_popup.openPopup(ancre, "after_start", 10, -2, false, false); -</pre> - -<p>Notez que l'ancre et les décalages spécifient uniquement la position lors de l'ouverture du popup. Si l'ancre est déplacée ou supprimée tandis que le popup est ouvert, le popup ne suivra pas. Cependant, il est possible de déplacer un popup pendant qu'il est ouvert, consultez <a href="fr/XUL/Guide_des_popups/D%c3%a9placement_et_redimensionnement">Déplacement et redimensionnement d'un popup</a>.</p> - -<p>Le cinquième paramètre d'openPopup, <code>isContextMenu</code>, indique si le popup est ouvert comme un menu contextuel. Passez <code>true</code> si c'est le cas et <code>false</code> dans le cas contraire. Le valeur à passer devrait être évidente selon l'endroit dont vous appelez openPopup. Notez que le même menu peut être ouvert des deux manières, ce paramètre n'influe donc pas sur la manière dont le popup apparaît. Ce qu'il modifie est la manière dont le focus et la sélection du menu sont gérés. Tant que vous passez la bonne valeur par rapport à la situation, il n'est pas très important de connaître les différences particulières entre les deux cas.</p> - -<p>Cependant, vous pouvez voir l'effet de ce paramètre en utilisant les marque-pages de Firefox. Essayez d'ouvrir un sous-menu des marque-pages et notez comme la sélection change toujours lorsque la souris est déplacé vers d'autres menus, et la manière dont le sous-menu est fermé lorsque la souris le quitte. Ouvrez à présent un menu contextuel sur le même marque-page et remarquez que les autres menus ne sont pas affectés par le mouvement de la souris. C'est cette différence qui est gérée par le paramètre isContextMenu.</p> - -<p>Enfin, le dernier paramètre de la méthode <code>openPopup</code>, <code>ecraserAttributs</code> indique si les attributs placés sur l'élément popup écrasent les paramètres fournis. Ceci permet à un popup d'utiliser un comportement particulier de positionnement avec les attributs <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> et <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code> à la place. Plus de détails sur ces attributs peuvent être trouvés dans la section <a href="fr/XUL/Guide_des_popups/Positionnement">Positionnement d'un popup</a>.</p> - -<h5 id="Popups_non_ancr.C3.A9s_avec_openPopup" name="Popups_non_ancr.C3.A9s_avec_openPopup">Popups non ancrés avec openPopup</h5> - -<p>Si le premier paramètre de la méthode <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup</a></code></span> vaut <code>null</code>, un popup non ancré est créé. Dans ce cas, le deuxième argument de positionnement n'est pas utilisé et une chaîne vide peut être utilisée. Voici un exemple :</p> - -<pre>un_popup.openPopup(null, "", 60, 50, false, false); -</pre> - -<p>Un popup non ancré utilise les décalages x et y, dans ce cas 60 et 50 sont des décalages depuis le coin de la fenêtre ou du cadre. De cette manière, un popup peut être positionné relativement à la fenêtre plutôt qu'à un nœud spécifique. Par exemple, il peut être intéressant d'ouvrir un popup à la position courante de la souris au moment du clic. Voici un exemple de gestionnaire d'évènement de clic de souris :</p> - -<pre>function mouseClicked(event) -{ - var panel = document.getElementById("un-panel"); - panel.openPopup(null, "", event.clientX, event.clientY, false, false); -} -</pre> - -<h5 id="La_m.C3.A9thode_openPopupAtScreen" name="La_m.C3.A9thode_openPopupAtScreen">La méthode openPopupAtScreen</h5> - -<p>Une seconde méthode, <span id="m-openPopupAtScreen"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopupAtScreen">openPopupAtScreen</a></code></span>, peut être utilisée pour ouvrir un popup et le placer à des coordonnées précise sur l'écran. Dans ce cas, le popup n'est pas ancré à un élément et apparaît simplement à l'emplacement spécifié par les paramètres <code>x</code> et <code>y</code> passés à cette méthode.</p> - -<pre>void openPopupAtScreen(in long x, in long y, in boolean estMenuContextuel); -</pre> - -<p>Le paramètre <code>ecraserAttributs</code> indique qu'un menu contextuel est ouvert et fonctionne de la même façon que pour la méthode <code>openPopup</code>. Dans l'exemple qui suit, le popup est ouvert à la position horizontale 100 et à la position verticale 200 :</p> - -<pre>popup.openPopupAtScreen(100, 200, false); -</pre> - -<p>Notez que si les coordonnées fournies auraient conduit à un popup situé partiellement ou totalement hors de l'écran, celui-ci sera déplacé de manière à être totalement visible, et pourra être redimensionné si nécessaire.</p> - -<h4 id="Fermeture_d.27un_popup_avec_la_m.C3.A9thode_hidePopup" name="Fermeture_d.27un_popup_avec_la_m.C3.A9thode_hidePopup">Fermeture d'un popup avec la méthode hidePopup</h4> - -<p>Un menu popup est fermé par l'utilisateur en appuyant sur la touche Échap ou en cliquant quelque part en dehors du popup.</p> - -<p>Pour fermer des menupopups utilisant les balises <code>menu</code>, <code>button</code> et <code>toolbarbutton</code>, consultez <a href="#Fermeture_d.27un_menu">Fermeture d'un menu</a> plus haut.</p> - -<p>Pour fermer un menu depuis un script utilisez sa méthode <span id="m-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/hidePopup">hidePopup</a></code></span>. Elle ne prend aucun paramètre.</p> - -<pre>popup.hidePopup(); -</pre> - -<h4 id="D.C3.A9terminer_si_un_popup_est_ouvert" name="D.C3.A9terminer_si_un_popup_est_ouvert">Déterminer si un popup est ouvert</h4> - -<p>Pour les menus, il est possible de vérifier la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> de l'élément menu, button ou toolbarbutton. Si celle-ci vaut <code>true</code>, le menu est ouvert.</p> - -<p>Pour les autres types de popups, la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/state">state</a></span></code> peut être examinée à cette fin. Elle est disponible pour tous les types de popups, qu'il s'agisse de menus, panels ou de tooltips. Lorsqu'un menu est fermé, la propriété <code>state</code> aura la valeur <code>closed</code>, tandis que pour un popup visible, elle aura la valeur <code>open</code>. Cette propriété est en lecture seule et s'applique aux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/panel" title="panel">panel</a></code> ou <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code>.</p> - -<p>La propriété <code>state</code> peut également avoir deux autres valeurs, utilisées lorsqu'un popup est en train de passer de l'état ouvert à l'état fermé et vice versa. Lorsqu'un popup est en train de s'ouvrir, la propriété <code>state</code> a une valeur de <code>showing</code> tandis qu'elle aura une valeur <code>hiding</code> au cours de de sa fermeture. La première se rencontrera au cours de l'évènement <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popupshowing">popupshowing</a>, tandis que la seconde se rencontrera au cours de l'évènement <a href="fr/XUL/Guide_des_popups/%c3%89v%c3%a8nements_des_popups#L.27.C3.A9v.C3.A8nement_popuphiding_event">popuphiding</a>.</p> - -<p>Par exemple, la propriété <code>state</code> pourrait être utilisée pour déterminer si un <code>panel</code> est déjà ouvert. Si c'est le cas, vous pouvez vouloir éviter de manipuler l'interface utilisateur de la fenêtre principale, étant donné que l'utilisateur ne sera plus directement en train d'interagir avec elle.</p> - -<div class="noinclude"> </div> diff --git a/files/fr/archive/mozilla/xul/guide_des_popups/panels/index.html b/files/fr/archive/mozilla/xul/guide_des_popups/panels/index.html deleted file mode 100644 index 8ebe7d2ea8..0000000000 --- a/files/fr/archive/mozilla/xul/guide_des_popups/panels/index.html +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Panneaux (panels) -slug: Archive/Mozilla/XUL/Guide_des_popups/Panels -tags: - - Guide Popup XUL - - XUL -translation_of: Archive/Mozilla/XUL/PopupGuide/Panels ---- -<p>Un panneau est une fenêtre contextuelle pouvant gérer n'importe quel type de contenu. On l'utilise notamment comme support d'affichage temporaire pour la sélection ou la saisie de données.</p> - -<h2 id="L.27.C3.A9l.C3.A9ment_panel" name="L.27.C3.A9l.C3.A9ment_panel">L'élément panel</h2> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/panel" title="panel">panel</a></code> sert à créer des panneaux permettant d'afficher une série d'éléments quelconques, placés comme enfants de l'élément "panel". Par exemple, le "panel" suivant affichera une boîte de texte pour entrer un nom. Notez que le panneau n'est pas placé dans un fichier distinct et est placé à l'intérieur d'une autre fenêtre.</p> - -<pre class="line-numbers language-html"><code class="language-html"><span class="prolog token"><?xml-stylesheet href="chrome://global/skin" type="text/css"?></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>window</span> <span class="attr-name token">xmlns</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>button</span> <span class="attr-name token">label</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Details<span class="punctuation token">"</span></span> <span class="attr-name token">type</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>panel<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>panel</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search-panel<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>label</span> <span class="attr-name token">control</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>name<span class="punctuation token">"</span></span> <span class="attr-name token">value</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Name:<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>textbox</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>name<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"></</span>panel</span><span class="punctuation token">></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"></</span>button</span><span class="punctuation token">></span></span> - -<span class="tag token"><span class="tag token"><span class="punctuation token"></</span>window</span><span class="punctuation token">></span></span></code></pre> - -<p>De nombreux panneaux seront associés à un bouton, comme dans cet exemple. Lorsque vous appuyez sur le bouton, le panneau est ouvert. En cliquant à l'extérieur du panneau ou en appuyant sur "Escape" (échappe), le panneau se ferme. Vous pouvez également placer un bouton de fermeture dans le panneau qui le fermera avec un script, si vous le souhaitez. Lorsque vous voulez associer un panneau à un bouton, placez l'élément <panel> directement à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> . Vous devez aussi déterminer un attribut "type" avec la valeur "panel", ou le bouton se comportera comme un bouton régulier.</p> - -<p>Le panneau contextuel apparaît par défaut dans le coin en haut à gauche, juste sous le bord inférieur du bouton, comme le ferait un menu. Toutefois, la position peut être modifiée. Pour plus d'informations sur la position du panneau contextuel, voir <a href="https://developer.mozilla.org/en/XUL/PopupGuide/Positioning" title="en/XUL/PopupGuide/Positioning">Positioning Popups</a> (en).</p> - -<p>Seuls les boutons (et les boutons de la barre d'outils) ont ce comportement automatique d'ouverture de la fenêtre contextuelle lorsqu'ils sont pressés. Pour d'autres types d'éléments, vous devrez utiliser une technique différente comme dans l'exemple suivant :</p> - -<pre class="line-numbers language-html"><code class="language-html"><span class="tag token"><span class="tag token">label</span> <span class="attr-name token">value</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Search<span class="punctuation token">"</span></span> <span class="attr-name token">popup</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search-panel<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>panel</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search-panel<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>label</span> <span class="attr-name token">control</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search<span class="punctuation token">"</span></span> <span class="attr-name token">value</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Terms:<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>textbox</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"></</span>panel</span><span class="punctuation token">></span></span></code></pre> - -<p><img alt="Image:Popupguide-panel.png" class="internal" src="https://developer.mozilla.org/@api/deki/files/304/=Popupguide-panel.png"></p> - -<p>Pour attacher un panneau à un élément qui n'est pas un bouton, par exemple pour qu'il s'ouvre lors de l'appui sur une étiquette, utilisez l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>. Celui-ci doit être défini comme l'id d'un "panel" au sein du même document. Lors d'un clic gauche sur l'élément portant l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, le panneau correspondant s'affichera. Par exemple, pour attacher le panneau contextuel défini plus haut à une étiquette, utilisez le code qui suit :</p> - -<pre><label value="Rechercher" popup="search-panel"/> -</pre> - -<p>Le résultat est un bouton de recherche ouvrant un panneau permettant d'entrer des termes de recherche. Celui-ci apparaîtra avec son coin supérieur gauche à la position de la souris. Dans ce cas, il serait sans doute préférable qu'il apparaisse plutôt en dessous de l'étiquette. L'attribut <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code> peut être utilisé afin de contrôler le placement du panneau contextuel. Voici un exemple complet :</p> - -<pre><panel id="search-panel" position="after_start"> - <label control="search" value="Termes :"/> - <textbox id="search"/> -</panel> - -<label value="Recherche" popup="search-panel"/> -</pre> - -<p>L'attribut <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code> a été ajouté à l'élément "panel" avec la valeur « <code>after_start</code> ». Le résultat en est que le panel n'est plus affiché là où l'on a cliqué, mais le long du bord inférieur de l'étiquette. Pour plus d'informations concernant cet attribut et les autres valeurs possibles, consultez <a href="fr/XUL/Guide_des_popups/Positionnement">Positionnement des popups (en)</a>.</p> - -<p>Il est également possible d'ouvrir un panneau comme un menu contextuel à l'aide de l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code> à la place de l'attribut "popup". Celui-ci fonctionne de la même manière qu'un menu contextuel, à part qu'on utilise un élément "panel" à la place d'un élément "menupopup". Consultez <a href="fr/XUL/Guide_des_popups/Menus_contextuels">Menus contextuels (en)</a> pour plus de détails à ce sujet.</p> - -<h2 id="Ouverture_d.27un_panel_par_script" name="Ouverture_d.27un_panel_par_script">Ouverture d'un panneau par script</h2> - -<p>Un panneau, comme toutes les fenêtres contextuelles, dispose d'une méthode <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup</a></code></span> pouvant être utilisée pour son ouverture à partir d'un script. Par exemple, le code suivant ouvrirait un panneau sous un bouton :</p> - -<pre class="line-numbers language-html"><code class="language-html">panel.openPopup(button, "after_start", 0, 0, false, false);</code></pre> - -<p>De manière similaire, la méthode <span id="m-openPopupAtScreen"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopupAtScreen">openPopupAtScreen</a></code></span> ouvrira un panneau à une position précise de l'écran. Pour plus de détails concernant ces deux méthodes, consultez <a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Guide_des_popups/Ouverture_et_fermeture">Ouverture et fermeture de fenêtres contextuelles</a>.</p> - -<h2 id="Fermeture_d.27un_panel" name="Fermeture_d.27un_panel">Fermeture d'un panneau</h2> - -<p>Un panneau est fermé automatiquement lorsque l'utilisateur clique en dehors de celui-ci. Il est cependant courant d'avoir un élément comme un bouton de fermeture dans le panneau. Par exemple, dans le panneau de recherche présenté plus haut, nous pourrions ajouter un bouton fermant le panneau lorsqu'il est utilisé :</p> - -<pre class="line-numbers language-html"><code class="language-html"><span class="tag token"><span class="tag token"><span class="punctuation token"><</span>script</span><span class="punctuation token">></span></span><span class="language-javascript script token"> -<span class="keyword token">function</span> <span class="function token">doSearch</span><span class="punctuation token">(</span><span class="punctuation token">)</span> <span class="punctuation token">{</span> - document<span class="punctuation token">.</span><span class="function token">getElementById</span><span class="punctuation token">(</span><span class="string token">"search-panel"</span><span class="punctuation token">)</span><span class="punctuation token">.</span><span class="function token">hidePopup</span><span class="punctuation token">(</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="punctuation token">}</span> -</span><span class="tag token"><span class="tag token"><span class="punctuation token"></</span>script</span><span class="punctuation token">></span></span> - -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>toolbarbutton</span> <span class="attr-name token">label</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Rechercher<span class="punctuation token">"</span></span> <span class="attr-name token">type</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>panel<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>panel</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search-panel<span class="punctuation token">"</span></span> <span class="attr-name token">position</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>after_start<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>textbox</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>search<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"><</span>button</span> <span class="attr-name token">label</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>Rechercher<span class="punctuation token">"</span></span> <span class="attr-name token">oncommand</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>doSearch();<span class="punctuation token">"</span></span><span class="punctuation token">/></span></span> - <span class="tag token"><span class="tag token"><span class="punctuation token"></</span>panel</span><span class="punctuation token">></span></span> -<span class="tag token"><span class="tag token"><span class="punctuation token"></</span>toolbarbutton</span><span class="punctuation token">></span></span></code></pre> - -<p>Dans cet exemple, la fonction <code>doSearch</code> est appelée lors d'un clic sur le bouton "Rechercher". La fonction identifie le panneau contextuel et appelle sa méthode <span id="m-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/hidePopup">hidePopup</a></code></span>. Naturellement, cette fonction devrait également comprendre des instructions pour lancer l'opération de recherche proprement dite.</p> - -<h3 id="L.27attribut_noautohide" name="L.27attribut_noautohide">Interdiction de fermeture automatique des panneaux</h3> - -<p>Un panneau contextuel est fermé par un clic de l'utilisateur en-dehors de celui-ci ou l'appui sur la touche Échap. C'est la manière habituelle, pour un utilisateur, d'annuler l'opération. Il peut également être utile de placer un bouton d'annulation ou de fermeture dans le panneau, en particulier si celui-ci est grand et contient un grand nombre de contrôles.</p> - -<p>Cependant parfois, vous voudrez peut-être que le panneau reste ouvert même si l'utilisateur clique en dehors de celui-ci. C'est notamment utile pour créer des panneaux d'outils flottants. Pour ce faire, positionnez son attribut <code id="a-noautohide"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/noautohide">noautohide</a></code> sur <code>"true" (vrai)</code>.</p> - -<pre><panel id="search-panel" noautohide="true"> - <textbox id="search"/> - <button label="Rechercher" oncommand="doSearch();"/> - <button label="Annuler" oncommand="this.parentNode.hidePopup();"/> -</panel> -</pre> - -<p>Comme le panneau ne peut plus être fermé en cliquant ailleurs, il doit toujours fournir un moyen de le faire. Dans cet exemple, on a ajouté un bouton Annuler.</p> - -<h2 id="Le_focus_dans_les_panels" name="Le_focus_dans_les_panels">Focus sur les panneaux</h2> - -<p>Les éléments se trouvant dans des panneaux peuvent recevoir le focus de la souris, et l'élément ayant le focus peut changer en appuyant sur la touche Tab. Lors de l'ouverture d'un panneau contextuel, si un élément de la fenêtre principale a le focus, il le perd et reçoit un évènement <code>blur</code>. Bien qu'aucun élément du panneau ne reçoive le focus par défaut, l'utilisateur peut le donner à son premier élément en appuyant sur la touche Tab. Si vous désirez qu'il se trouve sur un élément particulier par défaut, lors de l'ouverture de panneau, modifiez le focus dans le gestionnaire d'évènement <code>popupshown</code>. Par exemple, pour que la boîte de texte de l'exemple précédent reçoive le focus initial :</p> - -<pre><panel id="search-panel" onpopupshown="document.getElementById('search').focus()"> -</pre> - -<p>Pour désactiver l'ajustement du focus à l'ouverture d'un panneau, définissez l'attribut <code id="a-noautofocus"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/noautofocus">noautofocus</a></code> à <code>true</code> :</p> - -<pre><panel noautofocus="true"> -</pre> - -<p>Dans ce cas, le focus restera sur l'élément de la fenêtre principale qui avait le focus à l'ouverture du panneau. Notez que cela maintient également le focus à l'intérieur du panneau quand celui-ci est fermé.</p> - -<p>Lors de la fermeture d'un panneau, l'élément au sein de celui-ci, qui avait éventuellement le focus, le perd. L'élément qui avait le focus avant l'ouverture de la fenêtre contextuelle, quel qu'il soit, le récupère. Vous pouvez empêcher la suppression du focus avec l'attribut <code id="a-noautofocus"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/noautofocus">noautofocus</a></code> défini à true. De plus, l'attribut XULAttr("norestorefocus") }} positionné sur true empêche le retour du focus sur l'élément qui l'avait avant. Normalement, seul ce dernier sera défini si besoin.</p> - -<p>Ce processus de perte du focus à l'ouverture et à la fermeture d'un popup se déroule après le déclenchement des évènements <code>popupshowing</code> ou <code>popuphiding</code>, ce qui signifie que si ces évènements sont annulés, le focus ne sera pas perdu.</p> - -<div class="headingWithIndicator"> - <h1 id="Letting_panels_be_dragged_by_grabbing_the_background">Letting panels be dragged by grabbing the background</h1> - <span class="indicatorInHeadline minVer geckoMinVerMethod">Requires Gecko 7.0(Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)</span> -</div> (faire glisser les panneaux sur l'arrière-plan) - -<p>À partir de Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), vous pouvez utiliser l'attribut <code id="a-backdrag"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/backdrag">backdrag</a></code> pour créer des panneaux que l'utilisateur peut faire glisser (cliquer/glisser) n'importe où sur l'arrière-plan. C'est un simple attribut booléen, avec lequel vous pouvez activer cette fonctionnalité comme ceci :</p> - -<pre class="line-numbers language-html"><code class="language-html"><span class="tag token"><span class="tag token">panel</span> <span class="attr-name token">backdrag</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>true<span class="punctuation token">"</span></span><span class="punctuation token">></span></span></code></pre> diff --git a/files/fr/archive/mozilla/xul/hbox/index.html b/files/fr/archive/mozilla/xul/hbox/index.html deleted file mode 100644 index f0168f08d0..0000000000 --- a/files/fr/archive/mozilla/xul/hbox/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: hbox -slug: Archive/Mozilla/XUL/hbox -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/hbox ---- -<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>Un élément conteneur pouvant contenir un nombre illimité d'éléments enfants. C'est l'équivalent de l'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code></code>. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Le_mod%c3%a8le_de_bo%c3%aete">Tutoriel XUL</a>. </p> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<pre><!-- Deux boutons à droite --> -<hbox> - <spacer flex="1"/> - <button label="Connection"/> - <button label="Ping" /> -</hbox> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code> -</dd></dl> diff --git a/files/fr/archive/mozilla/xul/icônes_de_fenêtre/index.html b/files/fr/archive/mozilla/xul/icônes_de_fenêtre/index.html deleted file mode 100644 index f851d2c685..0000000000 --- a/files/fr/archive/mozilla/xul/icônes_de_fenêtre/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Icônes de fenêtre -slug: Archive/Mozilla/XUL/Icônes_de_fenêtre -tags: - - API_du_toolkit - - Extensions - - XPInstall - - XUL -translation_of: Archive/Mozilla/XUL/Window_icons ---- -<p> -</p><p>À partir de <a href="fr/Firefox_1.5">Firefox 1.5</a>, Thunderbird 1.5 et XULRunner 1.8, il est possible de spécifier une icône pour une fenêtre XUL en plaçant des fichiers nommés <tt>mafenetre.ico</tt> (pour Windows) et <tt>mafenetre.xpm</tt> (Linux), où <code>mafenetre</code> est l'<code>id</code> de l'élément <code><window></code> de la fenêtre à laquelle vous voulez attacher l'icône, dans le sous-dossier <tt>chrome/icons/default</tt> de votre <a href="fr/Bundles">paquet installable</a>. -</p><p>Ces icônes prendront le pas sur les fichiers d'icônes globaux, qui sont situés dans <tt><i>app_dir</i>/chrome/icons/default</tt>. -</p> -<h3 id="Anciennes_versions"> Anciennes versions </h3> -<p>Pour gérer les anciennes applications comme Firefox 1.0, vous devrez copier manuellement les icônes dans <tt><i>app_dir</i>/chrome/icons/default</tt> au premier démarrage (<a class="external" href="http://forums.mozillazine.org/viewtopic.php?p=1243796#1243796">exemple de code</a>). -</p> diff --git a/files/fr/archive/mozilla/xul/index.html b/files/fr/archive/mozilla/xul/index.html deleted file mode 100644 index 14c9dad0bd..0000000000 --- a/files/fr/archive/mozilla/xul/index.html +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: XUL -slug: Archive/Mozilla/XUL -tags: - - XUL -translation_of: Archive/Mozilla/XUL ---- -<div class="callout-box"><strong><a href="/fr/Tutoriel_XUL" title="fr/Tutoriel_XUL">Tutoriel XUL</a></strong><br> -Ce tutoriel vous guidera dans vos premiers pas avec XUL. Il est tiré de la version anglaise de XULPlanet.</div> - -<div><strong>XUL</strong> est le langage d'interface utilisateur pour Mozilla basé sur <a href="/fr/XML" title="fr/XML">XML</a>. Il permet de construire des applications multiplatesformes riches en fonctionnalités, pouvant être ou non connectées à Internet. Ces applications peuvent facilement être personnalisées au niveau du texte, des graphiques et de leur mise en page et peuvent ainsi être facilement rhabillées selon leur destination et être fournies en plusieurs langues. Les développeurs Web qui sont déjà familiarisés avec le <a href="/fr/DHTML" title="fr/DHTML">HTML dynamique</a> peuvent apprendre le XUL rapidement et être opérationnels immédiatement.</div> - -<p>Vous pouvez essayer une démonstration XUL grâce à <a class="external" href="http://www.hevanet.com/acorbin/xul/top.xul">cette table périodique des éléments XUL</a>.</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation"><a href="/Special:Tags?tag=XUL&language=fr" title="Special:Tags?tag=XUL&language=fr">Documentation</a></h4> - - <dl> - <dt><a href="/fr/Référence_XUL" title="fr/Référence_XUL">Référence des éléments XUL</a></dt> - <dd><small>Consultez également la <a class="external" href="http://www.xulfr.org/wiki/Reference/Xul">documentation en français sur xulfr</a> ainsi que la documentation de MDC sur <a href="/fr/Système_de_préférences" title="fr/Système_de_préférences">prefwindow</a>.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Les_contrôles_XUL" title="fr/Les_contrôles_XUL">Les contrôles XUL</a></dt> - <dd><small>Une liste rapide de tous les contrôles XUL disponibles.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Vulgarisation_XUL" title="fr/Vulgarisation XUL">Vulgarisation XUL</a></dt> - <dd><small>Un tutoriel clair sur le développement de modules complémentaire Mozilla.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Les_joies_de_XUL" title="fr/Les_joies_de_XUL">Présentation de XUL</a></dt> - <dd><small>Décrit les fonctionnalités et composants clés de XUL.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XUL/Guide_des_popups" title="fr/XUL/Guide_des_popups">Guide sur les menus et popups</a></dt> - <dd><small>Un guide sur l'utilisation des menus et panneaux popup.</small></dd> - </dl> - - <dl> - <dt><a class="external" href="http://xulfr.org/xulplanet/htw/">Comment réussir vos gabarits</a></dt> - <dd><small>Un guide détaillé sur les gabarits XUL (templates), qui sont un moyen de générer du contenu depuis une source de données. (à migrer vers <a href="/fr/XUL/Réussir_vos_gabarits" title="fr/XUL/Réussir_vos_gabarits">XUL:Réussir vos gabarits</a>)</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Améliorations_XUL_dans_Firefox_3" title="fr/Améliorations_XUL_dans_Firefox_3">Adaptation des applications XUL pour Firefox 3.0</a></dt> - <dd><small>Une liste des changements dans <a href="/fr/Firefox_3_pour_les_développeurs" title="fr/Firefox_3_pour_les_développeurs">Firefox 3</a> qui affectent les développeurs XUL.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Firefox_2_pour_les_développeurs#Pour_les_d.C3.A9veloppeurs_XUL_et_les_d.C3.A9veloppeurs_d.27extensions" title="fr/Firefox_2_pour_les_développeurs#Pour_les_d.C3.A9veloppeurs_XUL_et_les_d.C3.A9veloppeurs_d.27extensions">Adaptation des applications XUL pour Firefox 2.0</a></dt> - <dd><small>Une liste des changements dans <a href="/fr/Firefox_2_pour_les_développeurs" title="fr/Firefox_2_pour_les_développeurs">Firefox 2</a> qui affectent les développeurs XUL.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Adaptation_des_applications_XUL_pour_Firefox_1.5" title="fr/Adaptation_des_applications_XUL_pour_Firefox_1.5">Adaptation des applications XUL pour Firefox 1.5</a></dt> - <dd><small>Une liste des changements dans <a href="/fr/Firefox_1.5_pour_les_développeurs" title="fr/Firefox_1.5_pour_les_développeurs">Firefox 1.5</a> qui affectent les développeurs XUL.</small></dd> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XUL&language=fr" title="Special:Tags?tag=XUL&language=fr">Tous les articles…</a></span></p> - - <dl> - </dl> - </td> - <td> - <h4 id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p></p><ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-xul"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xul"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xul/feeds"> Flux de syndication</a></li> -</ul><p></p> - - <ul> - <li><a class="external" href="http://xulfr.org/forums/">Les forums de xulfr</a></li> - <li><a class="link-irc" href="irc://irc.mozilla.org/xulfr">Le canal IRC #xulfr</a></li> - </ul> - - <h4 id="Outils" name="Outils">Outils</h4> - - <ul> - <li><a class="external" href="http://developer.mozilla.org/en/docs/XUL_Explorer">XUL Explorer</a> (un IDE léger pour XUL)</li> - <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">L'extension Extension developer</a> (comprenant un éditeur XUL natif)</li> - <li><a class="external" href="http://www.extensionsmirror.nl/index.php?showtopic=751">Panneau latéral XULRef</a></li> - <li><a class="external" href="http://www.getfirebug.com/">Firebug</a></li> - <li><a href="/fr/Inspecteur_DOM" title="fr/Inspecteur_DOM">Inspecteur DOM</a></li> - <li><a class="external" href="http://www.spket.com/">Spket IDE</a>, un IDE pour XUL/XBL</li> - </ul> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XUL:Outils&language=fr" title="Special:Tags?tag=XUL:Outils&language=fr">Tous les outils…</a></span></p> - - <h4 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a>, <a href="/fr/XBL" title="fr/XBL">XBL</a>, <a href="/fr/CSS" title="fr/CSS">CSS</a>, <a href="/fr/RDF" title="fr/RDF">RDF</a>, <a href="/fr/Extensions" title="fr/Extensions">Extensions</a>, <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Categories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/mozilla/xul/introduction_à_xul/index.html b/files/fr/archive/mozilla/xul/introduction_à_xul/index.html deleted file mode 100644 index 27d8f9b784..0000000000 --- a/files/fr/archive/mozilla/xul/introduction_à_xul/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Introduction à XUL -slug: Archive/Mozilla/XUL/Introduction_à_XUL -tags: - - Aide_pour_les_éditeurs_de_MDC - - Traduction_en_cours - - XUL -translation_of: Archive/Mozilla/XUL/Introduction_to_XUL ---- -<h2 id="Introduction" name="Introduction">Introduction</h2> - -<p>Mozilla possède des "chromes" configurables et téléchargeables, ce qui veut dire que la position et même la présence ou l'absence d'un contrôle dans la fenêtre principale n'est pas figé dans l'application, mais chargé à partir de fichier d'interface IU (IU = Interface utilisateur). En effet, la plupart des fenêtres (principale et/ou dialogue) de Mozilla sont décrites en utilisant ce mécanisme. <a href="/fr/XUL" title="fr/XUL">XUL</a>, pour "<em>XML User Interface Language</em>" (Langage d'Interface Utilisateur format XML), est le nom pour le langage dans lequel ces descriptions d'interface sont faites.</p> - -<p>Les fichiers de "chrome" sont affichés et gérés par le même moteur que celui qui affiche les pages HTML dans le navigateur. Les description d'IU font très bon ménage avec le HTML 4. Le XUL est une application de XML. En effet, c'<em>est</em> juste du XML avec des éléments spécifiques qui peuvent être implémentés dans du HTML.</p> - -<h2 id="Termes" name="Termes">Termes</h2> - -<p>"XPFE" est le terme qu'utilise l'organisation Mozilla pour décrire la <em>Cross Platform Front End</em> du Navigateur de Mozilla, <em>car X et C semblent être semblables si on les tape longtemps et fortement avec un marteau</em> <span style="font-size: xx-small;">(humour américain...)</span>. Le but est de construire des applications cross-platform comme des navigateurs et des clients de courrier électronique à partir d'un kit d'outils créés pour cet usage. L'intention n'est pas d'implanter un framework générique pour application toutes plateformes confondues. Cela a déjà été fait, et au prix d'un grand travail. Nous voulons fournir un sous-ensemble de fonctionnalités inter-plateformes approprié pour construire des applications réseau comme les navigateurs, améliorant les fonctionnalités inter-plateformes déjà inclues dans Gecko, le moteur de rendu HTML de Mozilla.</p> - -<p>Le terme de "cross-platform UI" est quelque peu trompeur. Les créateurs d'interface devront être capable de créer des IU qui marcheront sur des multiples plate-formes. Mais des descriptions claires d'UI, qui prennent en considération de nombreuses plateformes, diffèrent sur l'idée de la place correcte des divers contrôles comme les boutons de dialogue qui nécessitent des spécifications par rapport à chaque système. Un spécification XUL est seulement compatible à hauteur d'un "degree". Les designers d'UI ainsi que les ingénieurs doivent maintenir séparément les versions spécifiques à chaque plateforme.</p> - -<p>"XPToolkit" est plutôt synonyme de XPFE. Même si l'ancien terme parait plus expressif que l'autre, et pourtant ce n'est pas son remplaçant ; personne ne sais pourquoi il existe les deux.</p> - -<p>"XUL" déjà présenté, est une application du XML utilisé pour décrire la présentation de la plupart des fenêtres dans le navigateur Mozilla, incluant aussi la fenêtre principale, la fenêtre du navigateur.</p> - -<h2 id="Scope" name="Scope">Portée</h2> - -<p>Cet article n'est pas une tentative d'expliquer les exigences systèmes. Nous n'avons pas de document actuel sur les "exigences" . <a class="external" href="http://www.mozilla.org/xpfe/xptoolkit/../aom/AOM.html">XPToolkit Architecture</a> est un meilleur moyen pour comprendre de telles choses. Cet article contient une courte introduction à l'architecture Mozilla <em>front-end</em> , en se concentrant sur la tache de construire des <em>UIs</em>. Il est, comme toujours, incomplet.</p> - -<p>Les applications Mozilla seront construites de "petits" composants comme des boutons "dialogue" et des dossiers de boite de réception mail, que l'on appelle couramment "<a href="/en/XUL/Widget_Cheatsheet" title="en/XUL/Widget Cheatsheet">widgets</a>." Avec un widget, le dessin et les interactions utilisateur sont complètement sous le contrôle d'un widget indépendant, et faites quand le widget est construit. Le placement relatif des widgets, leurs interactions entre les uns les autres, et en option une partie de leur configuration, sera contrôlé par un <em>UI layout</em> spécifié dans un script dont la structure est définie <span class="short_text" id="result_box"><span style="background-color: #ebeff9;" title="in this and related documents">dans les documents connexes et présents</span></span>.</p> - -<p>Les widgets sont des morceaux of the application largely self-contained, generally corresponding to a rectangle of window real estate. Widgets will generally live grouped in separate, dynamically loaded libraries. A widget may expect to own a piece of a window (a toolbar or toolbar set), or it may be expected to work within or without a window (menubars, depending on the platform). It may not be a part of the application UI at all.</p> - -<p>Widgets will have predefined behaviour, set at compilation. Buttons will respond to the mouse; toolbars will act as containers for buttons. The effect a widget will have on its application will be defined as a combination of predefined application behaviour and linkage between the widgets. This linkage can be accomplished by including JavaScript in the XUL, or by application code which walks the content model after it has been built from XUL, and hooks up event listeners. Generally a real application will use some combination of the two.</p> - -<p>Applications, for instance, will have preconceived notions of what to do when they receive an "open file" command. An "open" button is simply a button. It will send its command to the application for processing, generally using some simple JavaScript for linkage.</p> - -<p>We are at first primarily concerned with the obvious UI components: toolbars, menus and dialogs. Conceptually, the XUL language will allow someone with a text editor, given a package of components which can work together, the ability to put together an application by specifying something like this (for an application on an OS using menubars across the top of its applications' windows):</p> - -<pre class="eval">main window containing - menubar area at top across width of window containing - menubar (and its contents) - toolbar area below menubar across width of window containing - main toolbar (and its contents) - application-specific content area below toolbar area -</pre> diff --git a/files/fr/archive/mozilla/xul/label/index.html b/files/fr/archive/mozilla/xul/label/index.html deleted file mode 100644 index fab098ae82..0000000000 --- a/files/fr/archive/mozilla/xul/label/index.html +++ /dev/null @@ -1,183 +0,0 @@ ---- -title: label -slug: Archive/Mozilla/XUL/label -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/label ---- -<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 fournit un label pour un élément de contrôle. Si l'utilisateur clique sur le label, le focus se placera sur le contrôle associé, tel que spécifié avec l'attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code>. -</p><p>Pour plus d'informations, consultez le <a href="fr/Tutoriel_XUL/Ajouter_des_libell%c3%a9s_et_des_images">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-control">control</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-href">href</a>, <a href="#a-label.value">value</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessKey">accessKey</a>, <a href="#p-accessibleType">accessibleType</a>, <a href="#p-control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-header">header</a>, <a href="#s-indent">indent</a>, <a href="#s-monospace">monospace</a>, <a href="#s-plain">plain</a>, <a href="#s-small-margin">small-margin</a>, <a href="#s-text-link">text-link</a> </dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_label.png"></div> -<pre class="eval"><label value="Email address" control="email"/> -<textbox id="email"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-control"> - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-href"> - -</div> -<div id="a-label.value"> - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<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-control"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</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-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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<p>Les classes suivantes peuvent être utilisées pour styler l'élément. Ces classes doivent être utilisées plutôt que de changer directement le style de l'élément, car elles s'intègreront plus naturellement dans le thème sélectionné par l'utilisateur. -</p><dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/header">header</a></code></dt> - <dd>A class used for headings. Typically, this will cause the text to appear bold.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/indent">indent</a></code></dt> - <dd>This class causes the text to be indented on its left side.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/monospace">monospace</a></code></dt> - <dd>This class causes the text to be displayed in a monospace font.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/plain">plain</a></code></dt> - <dd>This class causes the element to be displayed with no border or margin.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/small-margin">small-margin</a></code></dt> - <dd>This class causes the text to be displayed with a smaller margin.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/text-link">text-link</a></code></dt> - <dd>Labels with this class may be focused and the click handler run or the address in the <a href="/en/XUL/Attribute/href" title="en/XUL/Attribute/href">href attribute</a> opened on a mouse click or Enter key press. Labels will appear like a link (blue and underlined).</dd> -</dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> -</dd></dl> -<dl><dt> Attributs -</dt><dd> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dd></dl> -<dl><dt> Interfaces </dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULLabelElement">nsIDOMXULLabelElement</a> -</dd></dl> -<h3 id="Notes_d.27utilisation" name="Notes_d.27utilisation"> Notes d'utilisation </h3> -<p>N'oubliez pas que l'élément label a un attribut « value », contrairement au HTML où les boutons et cases à cocher utilisent label="valeur" comme attribut. -</p> -<pre><label label="Une légende"/> <-- incorrect --> -<label value="Une légende"/> - -<label value="Cliquez sur le bouton"/> -<button label="Un bouton"/> -<checkbox label="Une décision" value="1"/> -</pre> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/les_contrôles_xul/index.html b/files/fr/archive/mozilla/xul/les_contrôles_xul/index.html deleted file mode 100644 index 0277692977..0000000000 --- a/files/fr/archive/mozilla/xul/les_contrôles_xul/index.html +++ /dev/null @@ -1,550 +0,0 @@ ---- -title: Les contrôles XUL -slug: Archive/Mozilla/XUL/Les_contrôles_XUL -tags: - - XUL -translation_of: Archive/Mozilla/XUL/XUL_controls ---- -<p>Le tableau suivant propose le listing des contrôles utilisateurs mis à disposition par <a href="/fr/XUL" title="fr/XUL">XUL</a>. Reportez-vous à la section <a href="/fr/Tutoriel_XUL" title="fr/Tutoriel_XUL">Tutoriel XUL</a> pour un guide pas-à-pas sur leurs utilisations et <a href="/fr/Référence_XUL" title="fr/Référence_XUL">Référence XUL</a> pour les informations de référence.</p> - -<table class="standard-table"> - <tbody> - <tr> - <td><strong><button></strong> - - <p>Un bouton pouvant être pressé par l'utilisateur.</p> - - <pre class="eval"> -<button label="Save" accesskey="S"/> -</pre> - - <p> </p> - - <ul> - <li><a href="/fr/XUL_Tutorial/Adding_Buttons" title="fr/XUL_Tutorial/Adding_Buttons">Plus d'information sur l'élément bouton</a>.</li> - <li><a href="/fr/XUL/button" title="fr/XUL/button">Référence de la balise Button</a></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-button.png" class="internal" src="/@api/deki/files/1257/=Controlsguide-button.png"></td> - </tr> - <tr> - <td><strong><button type="menu"></strong> - <p>Un bouton ayant un menu déroulant attaché. Appuyez sur le bouton pour ouvrir le menu.</p> - - <pre class="eval"> -<button type="menu" label="View"> - <menupopup> - <menuitem label="List"/> - <menuitem label="Details"/> - </menupopup> -</button> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/More_Button_Features#Button_with_menupopup" title="fr/XUL_Tutorial/More_Button_Features#Button_with_menupopup">Plus d'information à propos de ce type d'élement bouton</a>.</li> - <li><a href="/fr/XUL/button" title="fr/XUL/button">Référence de la balise Button</a></li> - <li>Eléments connexes : <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-button-menu.png" class="internal" src="/@api/deki/files/1256/=Controlsguide-button-menu.png"></td> - </tr> - <tr> - <td><strong><button type="menu-button"></strong> - <p>Un bouton associé à un bouton-flèche qui ouvre un menu déroulant. Le bouton-flèche est séparé du bouton principal. Contrairement au le type '<code>menu</code>', des actions différentes peuvent être effectués en cliquant sur le bouton ou sur le bouton-flèche.</p> - - <pre class="eval"> -<button type="menu-button" label="New"> - <menupopup> - <menuitem label="New Document"/> - <menuitem label="New Image"/> - </menupopup> -</button> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/More_Button_Features#Button_with_menupopup" title="fr/XUL_Tutorial/More_Button_Features#Button_with_menupopup">Plus d'information à propos de ce type d'élément bouton</a>.</li> - <li><a href="/fr/XUL/button" title="fr/XUL/button">Référence de la balise Button</a></li> - <li>Eléments connexes : <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-button-menu-button.gif"></td> - </tr> - <tr> - <td><strong><checkbox></strong> - <p>Un contrôle pouvant être coché ou non ; typiquement utilisé pour créer des options pouvant être activées ou désactivées.</p> - - <pre class="eval"> -<checkbox label="Show Toolbar Labels" checked="true"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Input_Controls#Checkboxes_and_Radio_Elements" title="fr/XUL_Tutorial/Input_Controls#Checkboxes_and_Radio_Elements">Plus d'information à propos de cette case à cocher</a>.</li> - <li><a href="/fr/XUL/checkbox" title="fr/XUL/checkbox">Référence à la balise Checkbox</a></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-checkbox.png" class="internal" src="/@api/deki/files/1258/=Controlsguide-checkbox.png"></td> - </tr> - <tr> - <td><strong><colorpicker></strong> - <p>Un sélectionneur de couleurs pouvant être utilisé pour sélectionner une couleur.</p> - - <pre class="eval"> -<colorpicker color="#FF0000"/> -</pre> - - <ul> - <li><a href="/fr/XUL/colorpicker" title="fr/XUL/colorpicker">Colorpicker Reference</a></li> - </ul> - </td> - <td><span class="comment">Image:Controlsguide-colorpicker.png</span></td> - </tr> - <tr> - <td><strong><colorpicker type="button"></strong> - <p>Un bouton qui affiche la couleur sélectionnée. Lorsqu'on clique sur le bouton, un sélecteur de couleurs spécialisé s'affiche.</p> - - <pre class="eval"> -<colorpicker type="button" color="#CC0080"/> -</pre> - - <ul> - <li><a href="/fr/XUL/colorpicker" title="fr/XUL/colorpicker">Colorpicker Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-colorpicker-button.png" class="internal" src="/@api/deki/files/1259/=Controlsguide-colorpicker-button.png"></td> - </tr> - <tr> - <td><strong><datepicker></strong> - - - <p>Une série de boîtes de texte qui peuvent être utilisées pour saisir une date.</p> - - <pre class="eval"> -<datepicker value="2007/03/26"/> -</pre> - - <ul> - <li><a href="/fr/XUL/datepicker" title="fr/XUL/datepicker">Datepicker Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-datepicker.png" class="internal" src="/@api/deki/files/1261/=Controlsguide-datepicker.png"></td> - </tr> - <tr> - <td><strong><datepicker type="grid"></strong> - - - <p>Un sélecteur de date qui affiche un calendrier pour la sélection.</p> - - <pre class="eval"> -<datepicker type="grid" value="2007/02/20"/> -</pre> - - <ul> - <li><a href="/fr/XUL/datepicker" title="fr/XUL/datepicker">Datepicker Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlsguide-datepicker-grid.png" class="internal" src="/@api/deki/files/1260/=Controlsguide-datepicker-grid.png"></td> - </tr> - <tr> - <td><strong><datepicker type="popup" ></strong> - - - <p>Un sélecteur de date qui affiche une série de boîtes de texte pour la saisie et un bouton pour afficher un sélecteur de date sous forme de calendrier.</p> - - <pre class="eval"> -<datepicker type="popup" value="2008/08/24"/> -</pre> - - <ul> - <li><a href="/fr/XUL/datepicker" title="fr/XUL/datepicker">Datepicker Reference</a></li> - </ul> - </td> - <td> </td> - </tr> - <tr> - <td><strong><description></strong> - <p>L'élément description permet d'ajouter un texte descriptif.</p> - - <pre class="eval"> -<description> - Sélectionner l'heure du début de l'évènement -</description> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Adding_Labels_and_Images#Description_Element" title="fr/XUL_Tutorial/Adding_Labels_and_Images#Description_Element">Plus d'information à propos de l'élément description</a>.</li> - <li><a href="/fr/XUL/description" title="fr/XUL/description">Description Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-description.png" class="internal" src="/@api/deki/files/1235/=Controlguide-description.png"></td> - </tr> - <tr> - <td><strong><groupbox></strong> - <p>Un élément groupbox regroupe plusieurs contrôles d'interface usager et affiche une étiquette à l'aide de l'élément caption.</p> - - <pre class="eval"> -<groupbox> - <caption label="Network"/> -</groupbox> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Groupboxes" title="fr/XUL_Tutorial/Groupboxes">Plus d'information à propos de l'élément groupbox</a>.</li> - <li><a href="/fr/XUL/groupbox" title="fr/XUL/groupbox">Groupbox Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-groupbox.png" class="internal" src="/@api/deki/files/1236/=Controlguide-groupbox.png"></td> - </tr> - <tr> - <td><strong><image></strong> - <p>Une image spécifiée par une URL.</p> - - <pre class="eval"> -<image src="start.png"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Adding_Labels_and_Images#Images" title="fr/XUL_Tutorial/Adding_Labels_and_Images#Images">Plus d'information à propos de l'élément image</a>.</li> - <li><a href="/fr/XUL/image" title="fr/XUL/image">Image Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-image.png" class="internal" src="/@api/deki/files/1237/=Controlguide-image.png"></td> - </tr> - <tr> - <td><strong><label></strong> - <p>L'élément label permet d'ajouter une étiquette à côté d'un champ de saisie.</p> - - <pre class="eval"> -<label control="volume" value="Volume:"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Adding_Labels_and_Images#Label_Element" title="fr/XUL_Tutorial/Adding_Labels_and_Images#Label_Element">Plus d'information à propos de l'élément label</a>.</li> - <li><a href="/fr/XUL/label" title="fr/XUL/label">Label Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-label.png" class="internal" src="/@api/deki/files/1238/=Controlguide-label.png"></td> - </tr> - <tr> - <td><strong><listbox></strong> - <p>Une liste permet la sélection d'items textuels.</p> - - <pre class="eval"> -<listbox> - <listitem label="Chocolat"/> - <listitem label="Bonbon"/> -</listbox> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/List_Controls#List_Boxes" title="fr/XUL_Tutorial/List_Controls#List_Boxes">Plus d'information à propos de l'élément listbox</a>.</li> - <li><a href="/fr/XUL/listbox" title="fr/XUL/listbox">Listbox Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/listcols" title="listcols">listcols</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/listcol" title="listcol">listcol</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/listhead" title="listhead">listhead</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/listheader" title="listheader">listheader</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-listbox.png" class="internal" src="/@api/deki/files/1239/=Controlguide-listbox.png"></td> - </tr> - <tr> - <td><strong><menulist></strong> - <p>Une zone combinée est un contrôle texte attaché à une liste déroulante. La valeur est sélectionnée à l'aide de la liste déroulante. Aussi connu sous les noms de menulist, combobox et <select> en HTML.</p> - - <pre class="eval"> -<menulist> - <menupopup> - <menuitem label="Lions" value="l"/> - <menuitem label="Tigres" value="t"/> - <menuitem label="Ours" value="o"/> - </menupopup> -</menulist> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/List_Controls#Drop-down_Lists" title="fr/XUL_Tutorial/List_Controls#Drop-down_Lists">Plus d'information à propos de l'élément menulist</a>.</li> - <li><a href="/fr/XUL/menulist" title="fr/XUL/menulist">Menulist Reference</a></li> - <li>Éléments reliés: <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-menulist.png" class="internal" src="/@api/deki/files/1241/=Controlguide-menulist.png"></td> - </tr> - <tr> - <td><strong><menulist editable="true"></strong> - <p>Une zone combinée éditable est comme une zone combinée standard, excepté que la valeur actuellement sélectionnée est affichée dans une zone de saisie où l'on peut sélectionner directement une valeur, ou l'on peut entrer des valeurs absentes de la liste.</p> - - <pre class="eval"> -<menulist editable="true"> - <menupopup> - <menuitem label="Elephants" value="Elephants"/> - <menuitem label="Kangaroos" value="Kangaroos"/> - <menuitem label="Bats" value="Bats"/> - </menupopup> -</menulist> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/List_Controls#Editable_menulist" title="fr/XUL_Tutorial/List_Controls#Editable_menulist">Plus d'informations à propos de l'élément menulist editable.</a></li> - <li><a href="/fr/XUL/menulist" title="fr/XUL/menulist">Menulist Reference</a></li> - <li>Éléments reliés: <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-menulist-editable.png" class="internal" src="/@api/deki/files/1240/=Controlguide-menulist-editable.png"></td> - </tr> - <tr> - <td><strong><progressmeter></strong> - <p>Une barre de progression est utilisée pour montrer la progression d'une tâche lente.</p> - - <pre class="eval"> -<progressmeter value="40"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Progress_Meters" title="fr/XUL_Tutorial/Progress_Meters">Plus d'informations à propos de l'élément progressmeter.</a></li> - <li><a href="/fr/XUL/progressmeter" title="fr/XUL/progressmeter">Progressmeter Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-progressmeter.png" class="internal" src="/@api/deki/files/1242/=Controlguide-progressmeter.png"></td> - </tr> - <tr> - <td><strong><radio></strong> - <p>Un bouton radio est utilisé pour sélectionner uniquement une seule valeur d'une liste d'options à la fois.</p> - - <pre class="eval"> -<radiogroup> - <radio label="Light" value="light"/> - <radio label="Heavy" value="heavy"/> -</radiogroup> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Input_Controls#Checkboxes_and_Radio_Buttons" title="fr/XUL_Tutorial/Input_Controls#Checkboxes_and_Radio_Buttons">Plus d'informations à propos de l'élément radio.</a></li> - <li><a href="/fr/XUL/radio" title="fr/XUL/radio">Radio Reference</a></li> - <li>Éléments reliés: <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-radio.png" class="internal" src="/@api/deki/files/1243/=Controlguide-radio.png"></td> - </tr> - <tr> - <td><strong><richlistbox></strong> - <p>The richlistbox displays a list of items where one or more may selected. Unlike the listbox which is designed to display only text, the richlistbox may display any type of content.</p> - - <pre class="eval"> -<richlistbox> - <richlistitem> - <image src="happy.png"/> - </richlistitem> - <richlistitem> - <image src="sad.png"/> - </richlistitem> - <richlistitem> - <image src="angry.png"/> - </richlistitem> -</richlistbox> -</pre> - - <ul> - <li><a href="/fr/XUL/richlistbox" title="fr/XUL/richlistbox">Richlistbox Reference</a></li> - <li>Éléments reliés: <code><a href="/fr/docs/Mozilla/Tech/XUL/richlistitem" title="richlistitem">richlistitem</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-richlistbox.png" class="internal" src="/@api/deki/files/1244/=Controlguide-richlistbox.png"></td> - </tr> - <tr> - <td><strong><scale></strong> - - - <p>A scale displays a bar with a thumb that may be slid across the bar to select between a range of values.</p> - - <pre class="eval"> -<scale min="1" max="10"/> -</pre> - - <ul> - <li><a href="/fr/XUL/scale" title="fr/XUL/scale">Scale Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-scale.png" class="internal" src="/@api/deki/files/1246/=Controlguide-scale.png"></td> - </tr> - <tr> - <td><strong><textbox></strong> - <p>A textbox which allows a single line of text to be entered.</p> - - <pre class="eval"> -<textbox value="firefox"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Input_Controls#Text_Entry_Fields" title="fr/XUL_Tutorial/Input_Controls#Text_Entry_Fields">More information about the textbox element</a>.</li> - <li><a href="/fr/XUL/textbox" title="fr/XUL/textbox">Textbox Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-textbox.png" class="internal" src="/@api/deki/files/1251/=Controlguide-textbox.png"></td> - </tr> - <tr> - <td><strong><textbox multiline="true"></strong> - <p>A textbox which allows multiple lines of text to be entered.</p> - - <pre class="eval"> -<textbox multiline="true"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Input_Controls#Multiline_textbox" title="fr/XUL_Tutorial/Input_Controls#Multiline_textbox">More information about the multiple line textbox element</a>.</li> - <li><a href="/fr/XUL/textbox" title="fr/XUL/textbox">Textbox Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-textbox-multiline.png" class="internal" src="/@api/deki/files/1247/=Controlguide-textbox-multiline.png"></td> - </tr> - <tr> - <td><strong><textbox type="autocomplete"></strong> - <p>A textbox which provides a dropdown showing matches that would complete what the user types. The user can select one to have it filled into the textbox.</p> - - <pre class="eval"> -<textbox type="autocomplete" autocompletesearch="history"/> -</pre> - - <ul> - <li><a href="/fr/XUL/textbox" title="fr/XUL/textbox">Textbox Reference</a></li> - </ul> - </td> - <td> </td> - </tr> - <tr> - <td><strong><textbox type="number"></strong> - - - <p>A textbox for entering numbers. Two arrow buttons are displayed for cycling through values.</p> - - <pre class="eval"> -<textbox type="number" min="1" max="20"/> -</pre> - - <ul> - <li><a href="/fr/XUL/textbox" title="fr/XUL/textbox">Textbox Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-textbox-number.png" class="internal" src="/@api/deki/files/1249/=Controlguide-textbox-number.png"></td> - </tr> - <tr> - <td><strong><textbox type="password"></strong> - <p>A textbox that hides the characters typed, used for entering passwords.</p> - - <pre class="eval"> -<textbox type="password"/> -</pre> - - <ul> - <li><a href="/fr/XUL/textbox" title="fr/XUL/textbox">Textbox Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-textbox-password.png" class="internal" src="/@api/deki/files/1250/=Controlguide-textbox-password.png"></td> - </tr> - <tr> - <td><strong><timepicker></strong> - - - <p>A timepicker displays a set of textboxes for entering a time.</p> - - <pre class="eval"> -<timepicker value="12:05"/> -</pre> - - <ul> - <li><a href="/fr/XUL/timepicker" title="fr/XUL/timepicker">Timepicker Reference</a></li> - </ul> - </td> - <td><img alt="Image:Controlguide-timepicker.png" class="internal" src="/@api/deki/files/1253/=Controlguide-timepicker.png"></td> - </tr> - <tr> - <td><strong><toolbarbutton></strong> - <p>A button that is displayed on a toolbar.</p> - - <pre class="eval"> -<toolbarbutton label="Reload"/> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Toolbars" title="fr/XUL_Tutorial/Toolbars">More information about the toolbarbutton element</a>.</li> - <li><a href="/fr/XUL/toolbarbutton" title="fr/XUL/toolbarbutton">Toolbarbutton Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-toolbarbutton.png" class="internal" src="/@api/deki/files/1254/=Controlguide-toolbarbutton.png"></td> - </tr> - <tr> - <td><strong><toolbarbutton type="menu"></strong> - <p>A button that is displayed on a toolbar with a drop down menu attached to it.</p> - - <pre class="eval"> -<toolbarbutton type="menu" label="Show"> - <menupopup> - <menuitem label="Toolbars"/> - <menuitem label="Status Bar"/> - </menupopup> -</toolbarbutton> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Toolbars" title="fr/XUL_Tutorial/Toolbars">More information about this type of menu toolbarbutton element</a>.</li> - <li><a href="/fr/XUL/toolbarbutton" title="fr/XUL/toolbarbutton">Toolbarbutton Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code></li> - </ul> - </td> - <td> </td> - </tr> - <tr> - <td><strong><toolbarbutton type="menu-button"></strong> - <p>A button on a toolbar that that has a separate arrow button with a menu attached to it. Unlike with the '<code>menu</code>' type, a separate action may be performed when the main part of the button is pressed.</p> - - <pre class="eval"> -<toolbarbutton type="menu-button" label="Open"> - <menupopup> - <menuitem label="Open Changed Files"/> - <menuitem label="Open All"/> - </menupopup> -</toolbarbutton> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Toolbars" title="fr/XUL_Tutorial/Toolbars">More information about this type of menu toolbarbutton element</a>.</li> - <li><a href="/fr/XUL/toolbarbutton" title="fr/XUL/toolbarbutton">Toolbarbutton Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code></li> - </ul> - </td> - <td> </td> - </tr> - <tr> - <td><strong><tree></strong> - <p>A tree displays a hierarchy of items in multiple columns.</p> - - <pre class="eval"> -<tree> - <treecols> - <treecol label="Name" flex="1"/> - <treecol label="Size" flex="1"/> - </treecols> - <treechildren> - <treeitem> - <treerow> - <treecell label="Popcorn"/> - <treecell label="Large"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="Root Beer"/> - <treecell label="Small"/> - </treerow> - </treeitem> - </treechildren> -</tree> -</pre> - - <ul> - <li><a href="/fr/XUL_Tutorial/Trees" title="fr/XUL_Tutorial/Trees">More information about the tree element</a>.</li> - <li><a href="/fr/XUL/tree" title="fr/XUL/tree">Tree Reference</a></li> - <li>Related Elements: <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code></li> - </ul> - </td> - <td><img alt="Image:Controlguide-tree.png" class="internal" src="/@api/deki/files/1255/=Controlguide-tree.png"></td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/mozilla/xul/les_joies_de_xul/index.html b/files/fr/archive/mozilla/xul/les_joies_de_xul/index.html deleted file mode 100644 index 0d713c2334..0000000000 --- a/files/fr/archive/mozilla/xul/les_joies_de_xul/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: Les joies de XUL -slug: Archive/Mozilla/XUL/Les_joies_de_XUL -tags: - - XUL -translation_of: Archive/Mozilla/XUL/The_Joy_of_XUL ---- -<p>Public visé : Les développeurs d'application et les chefs développeurs qui cherchent à mieux comprendre XUL et pourquoi il est à la base de la plate-forme Mozilla.</p> - -<h3 id="Introduction" name="Introduction">Introduction</h3> - -<p><a href="/fr/XUL" title="fr/XUL">XUL</a> (prononcez « zoul ») est le langage d'interface utilisateur de Mozilla basé sur XML permettant de développer des applications multiplate-formes riches en fonctionnalités et pouvant tourner connectée ou non à Internet. Ces applications sont facilement modifiables avec des textes, graphismes, et mises en page alternatifs, de telle manière qu'elles peuvent être facilement marquées ou localisées pour différents marchés. Les développeurs Web déjà familiers avec le HTML Dynamique (<a href="/fr/DHTML" title="fr/DHTML">DHTML</a>) pourront développer tout des suite des applications .</p> - -<p>Ce document décrira les irrésistibles raisons pour les développeurs d'application de choisir XUL et la technologie Mozilla pour développer des applications multiplate-formes. Cette même enquête donnera des explications suffisantes des motivations de Mozilla dans le développement XUL et pourquoi la plate-forme de Mozilla est basée dessus. Les fonctionnalités clé et les avantages de XUL seront explorés suivis d'un tour d'horizon des technologies soutenues par Mozilla. Enfin, une petite étude de cas d'un logiciel calendrier écrit avec XUL montrera les avantages de développer une application avec Mozilla.</p> - -<h3 id="Fonctionnalit.C3.A9s_cl.C3.A9s_et_avantages" name="Fonctionnalit.C3.A9s_cl.C3.A9s_et_avantages">Fonctionnalités clés et avantages</h3> - -<table class="standard-table"> - <tbody> - <tr> - <td>Langage de balisage puissant basé sur les widgets</td> - <td>Le but de XUL est de construire des applications multiplate-formes, a contrario du DHTML qui est conçu pour développer des pages Web. C'est pour cela que XUL est orienté vers des artefacts présents dans les applications comme les fenêtres, les labels et les boutons, au lieu d'être orienté vers les pages, niveaux de titre, et liens hypertextes. - <p>En fait, beaucoup de développeurs investissent des efforts considérables pour obtenir un résultat comparable dans leurs applications Web DHTML au prix de la complexité, des performances, et du respect des standards.</p> - </td> - </tr> - <tr> - <td>Basé sur des standards existants</td> - <td>XUL est un langage basé sur le standard XML 1.0 du W3C. Les applications écrites en XUL aussi sont basées sur d'autres standards du W3C tels que HTML 4.0; les Feuilles de Style en Cascade (CSS) 1 et 2; le modèle de document objet (DOM) niveaux 1 et 2; JavaScript 1.5, incluant ECMA-262 Edition 3 (ECMAscript); XML 1.0. - <p>Mozilla.org va plus loin en cherchant à obtenir une standardisation du W3C pour l'eXtensible Binding Language (XBL) (voir <a href="#Technologies_support.C3.A9es">Technologies supportées</a>, ci-dessous).</p> - </td> - </tr> - <tr> - <td>Portabilité de la plate-forme</td> - <td> - <p>À l'instar du HTML, XUL est conçu pour être indépendant de la plate-forme, rendant ainsi les applications facilement portables à tous les systèmes d'exploitation sur lesquels Mozilla tourne. Si l'on considère le large éventail de plate-formes qui supportent actuellement Mozilla, cela peut être une des caractéristiques intéressantes de XUL en tant que technologie pour développer des applications.</p> - - <p>Puisque XUL donne une abstraction des composants de l'interface utilisateur, il tient la promesse d'écrire une fois, exécuter partout (NdT : write-once, run anywhere pour les anglophones). L'interface de toutes les applications phares de Mozilla (navigateur, client de messagerie, carnet d'adresse, etc.) est écrite en XUL avec un seul code fonctionnant sur toutes les plate-formes Mozilla.</p> - </td> - </tr> - <tr> - <td>Séparation de l'aspect et de la logique de l'application</td> - <td>L'un des inconvénients majeurs de la plupart des application Web est le lien étroit entre les éléments de l'interface et la logique de l'application. Cela pose un problème qui n'est pas insignifiant lorsque que l'on travaille en équipe, parce que les compétences requises pour développer ces deux aspects appartiennent souvent à des personnes différentes. - <p>XUL donne une séparation clair entre la définition de l'application et la logique de programmation ("contenu" constitué de XUL, XBL, et JavaScript), la présentation (« skin » constitué de CSS et d'images), et les labels spécifiques au langage (« locale » constitué de DTDs, paquets de chaînes de caractères dans des fichiers <code>.properties</code>). La mise en page et l'apparence des applications XUL peuvent être transformées indépendamment de la définition de l'application et de sa logique. Encore mieux, l'application peut être localisée en différentes langues et régions indépendamment de sa logique ou de sa présentation.</p> - - <p>Ce degré de séparation permet d'avoir des applications plus faciles à maintenir par les programmeurs et rapidement modifiables pour les designers et les localisateurs.</p> - - <p>La superposition de ces deux activités indépendantes est plus facilement coordonnée qu'avec des applications basées sur du HTML, avec un impact moindre sur la stabilité générale et la qualité du système.</p> - </td> - </tr> - <tr> - <td>Modification, localisation ou marquage faciles</td> - <td>Un autre bénéfice très pratique de la séparation entre ce que XUL fournit et la logique, la présentation, et le « texte du langage » est la facilité d'adaptation pour différents clients ou groupes d'utilisateurs. - <p>Un développeur peut maintenir une base de code primaire pour son application et adapter le logo et l'appellation pour chacun de ses clients en distribuant plusieurs <em>skins</em>. Une application qui est écrite et déployée avec une interface utilisateur en anglais peut être traduite en français pour le même client. Bien que ces changements soit extensifs et affectent la plus grande partie (sinon la totalité) de l'application, ils sont aussi isolés les uns des autres par la définition même de XUL et le partage de la logique de l'application entre toutes les versions personnalisées.</p> - </td> - </tr> - </tbody> -</table> - -<h3 id="Technologies_support.C3.A9es" name="Technologies_support.C3.A9es">Technologies supportées</h3> - -<p>Il y a beaucoup d'autres technologies introduites par Mozilla qui complètent XUL pour développer des applications web multiplate-formes.</p> - -<table class="standard-table"> - <tbody> - <tr> - <td><a href="/fr/XBL" title="fr/XBL">XBL</a></td> - <td> - <p>L'eXtensible Bindings Language (XBL) est un langage de balisage qui définit de nouveaux éléments spéciaux, ou <em>bindings</em> pour les widgets XUL. Avec XBL, les développeurs peuvent définir du contenu nouveau pour les widgets XUL, ajouter des gestionnaires d'événement additionnel à un widget XUL, et ajouter aussi de nouvelles propriétés et méthodes d'interface. En bref, XBL octroie au développeur la capacité d'étendre XUL en modifiant des balises existantes ou en créant ses propres balises.</p> - - <p>En utilisant XBL, les développeurs peuvent facilement façonner des interfaces utilisateur de widgets personnalisées, comme des compteurs de progression, des menus pop-up fantaisistes, et même des barres d'outils et des formulaires de recherche. Ces composants personnalisés sont utilisable dans les applications XUL en spécifiant la balise personnalisée et les attributs qui y sont associés.</p> - </td> - </tr> - <tr> - <td><a href="/fr/Overlays_XUL" title="fr/Overlays_XUL">Overlays</a></td> - <td>Les overlays sont des fichiers XUL utilisés pour décrire un contenu supplémentaire pour l'interface utilisateur. Ils sont un mécanisme général pour ajouter des composants additionnels à l'interface, remplacer des portions de code XUL, sans avoir à modifier toute l'interface, et réutiliser des parties spécifiques de l'interface utilisateur. - <p>Ils fournissent un mécanisme puissant de personnalisation et d'extension des applications existantes parce qu'ils fonctionnent de deux manières complémentaires mais très différentes. Dans un sens, les overlays sont identiques aux fichiers <code>include</code> qu' on trouve dans d'autres langages parce qu'une application peut spécifier qu'un overlay est présent dans sa définition. Mais les overlays peuvent également être spécifié extérieurement, permettant à un concepteur de le superposer à une application sans modifier le code source original.</p> - - <p>En pratique, cela permet aux développeurs de maintenir un code unique pour une application donnée, puis d'y appliquer une marque particulière ou pour inclure des fonctionnalités spécifiques pour un client particulier, le tout dans un code complètement indépendant. Cela conduit à une solution globale qui est plus facile et moins coûteux de maintenir à long terme.</p> - - <p>Un bénéfice supplémentaires des overlays pour les développeurs de logiciels qui désirent ajouter des fonctionnalités aux logiciels Mozilla qu'ils désirent garder sous licence propriétaire. La Netscape Public License (NPL) et la Mozilla Public License (MPL) exige des développeurs qui modifie le code original (le code source fournit pas Mozilla) de fournir le code source de ces modifications à leurs clients. Les overlays peuvent être utilisés pour ajouter des fonctionnalités aux logiciels Mozilla sans contaminer le code source libre original avec des portions de code propriétaire.</p> - </td> - </tr> - <tr> - <td><a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a>/<a href="/fr/XPConnect" title="fr/XPConnect">XPConnect</a></td> - <td>XPCOM et XPConnect sont des technologies complémentaires qui permettent l'intégration de bibliothèques externes dans les applications XUL. - <p>XPCOM, qui signifie Cross Platform Component Object Model, est un framework d'écriture de logiciels multiplate-forme et modulaires. Les composants XPCOM peuvent être écrit en C, C++ et JavaScript, et ils peuvent être utilisés avecs C, C++, JavaScript, <a href="/fr/Python" title="fr/Python">Python</a>, Java et Perl.</p> - - <p>XPConnect est une technologie qui autorise des interactions entre XPCOM et JavaScript. XPConnect permet aux objets JavaScript d'accéder de façon transparente aux objets XPCOM et de les manipuler. Elle permet également aux objets JavaScript de présenter des interfaces conformes à XPCOM qui pourront être appelées par des objets XPCOM.</p> - - <p>Ensemble, XPCOM et XPConnect permettent aux développeurs de créer des applications XUL qui applications exigent la puissance de traitement brut de langages compilés (C/C++) ou l'accès au système d'exploitation sous-jacent.</p> - </td> - </tr> - <tr> - <td><a href="/fr/XPInstall" title="fr/XPInstall">XPInstall</a></td> - <td>XPInstall, l'utilitaire d'installation multiplate-forme de Mozilla, fournit un moyen standard d'empaquetage des composants d'un application XUL avec un script d'installation que Mozilla peut télécharger et exécuter. - <p>XPInstall permet aux utilisateurs d'installer sans effort une nouvelle applications XUL depuis Internet ou depuis des serveurs intranet d'entreprises. Pour installer une nouvelle application, l'utilisateur n'a besoin que de cliquer sur un lien hypertexte dans une page Web ou dans un courriel et d'accepter l'installation du nouveau paquetage.</p> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">todo: describe cool toolkit and xul runner features</span></p> - -<h3 id=".C3.89tude_de_cas__Un_logiciel_de_calendrier_pour_Mozilla" name=".C3.89tude_de_cas_:_Un_logiciel_de_calendrier_pour_Mozilla">Étude de cas : Un logiciel de calendrier pour Mozilla</h3> - -<p>This mini case study describes how OEone Corporation (<a class="external" href="http://www.oeone.com" rel="freelink">http://www.oeone.com</a>) integrated its Calendar application with the core Mozilla product. The Calendar application is comprised of a XUL front end and an XPCOM component that leverages libical, a native library written in C, for date operations and calendar data storage. The Calendar was initially developed exclusively for Linux but was successfully ported to both Macintosh and Windows within a week.</p> - -<p><em>XUL provides a rich set of UI components.</em> The user interface for the Calendar is written entirely in XUL, JavaScript, and CSS, which is a testament to the power and flexibility of this application building framework. It uses simple XUL components like boxes, grids, and stacks to compose views for the weeks, days, and months. The initial implementation of Calendar did not exploit XBL because the developers involved were not experienced with this complementary technology. But future plans for the Calendar include converting many of these UI components to XBL widgets to further simplify their implementation.</p> - -<p><em>XPCOM/XPConnect enables integration of native code.</em> A fully-featured open source calendar library, libical (<a class="external" href="http://www.softwarestudio.org/libical/" rel="freelink">http://www.softwarestudio.org/libical/</a>), was harvested for the Calendar project. Libical is an Open Source implementation of the IETF's iCalendar Calendaring and Scheduling protocols. (<a class="external" href="http://tools.ietf.org/html/rfc2445" title="http://tools.ietf.org/html/rfc2445">RFC 2445</a>, 2446, and 2447). It parses iCal components and provides a C API for manipulating the component properties, parameters, and subcomponents. The library was initially integrated by writing an XPCOM wrapper to adapt its interface. To improve performance a greater proportion of application logic was migrated from JavaScript to the XPCOM component.</p> - -<p><em>Separation of presentation from logic makes applications resilient to change.</em> The original UI implementation made extensive use of graphics for rendering the month and week views. Later, as the developers learned more about XUL and the implementation of the basic components matured, better ways were identified to simplify the composition of the UI. This lead to increased screen drawing performance and reduced memory and disk footprint requirements of the application. The UI for the month and week views was practically rewritten while the application logic remained virtually unchanged.</p> - -<p><em>Porting XUL applications to other platforms is trivial.</em> The Calendar originated as a Linux application with no consideration given to porting it to other platforms. But later, when the original developer (OEone Corporation) contributed the source to the Mozilla project, the Calendar had to be migrated to the Windows and Macintosh platforms. The UI for the XUL application required zero porting effort because it worked with almost no alteration on both new platforms. Similarly, since the UI code is written in JavaScript, the interaction logic worked with no effort. However, since the libical library is written in C, more significant effort was required to migrate this component to the other platforms.</p> - -<p>Fortunately an implementation of the libical library was already available for Macintosh so, with the cross platform nature of XPCOM, a Macintosh calendar implementation was working within a few days. However, there was no existing Win32 port available, so developers had to undertake a porting effort to migrate libical to Windows. Within a week this too was complete and Mozilla had a working calendar for all three primary platforms: Linux, Macintosh, and Windows.</p> - -<p><em>XPInstall is easy for developers and for users.</em> The Calendar is not a planned deliverable for the Mozilla 1.0 release, and therefore is not included as a standard component in regular nightly and milestone release builds. Developers who are equipped with the software and knowledge required to compile Mozilla can set an optional environment variable and build the Calendar themselves. But many Mozilla users who want to try out the Calendar can't afford this luxury. Using XPInstall it was easy for the developers to package a version of Calendar that could be installed directly over the Internet by clicking a link.</p> - -<h3 id="Conclusion" name="Conclusion">Conclusion</h3> - -<p>Mozilla, grâce à XUL, fournit une technologie irrésistible pour le développement d'applications multiplate-forme avec une même interface utilisateur riche et une expérience utilisateur identique aux applications natives. Les designers ayant l'expérience de la conception d'applications Web basées sur les technologies standard du W3C peuvent tirer parti de cette expérience directement du navigateur au bureau.</p> - -<p>Avant qu'Internet ne devienne le moyen privilégié de distribution des applications aux utilisateurs utilisant des architectures matérielles et logicielles disparates, ce problème était réglé à l'aide d'outils client-serveur multiplate-forme. Mais ces offres, invariablement propriétaires, coûtaient très cher en développeurs et le montant des licences vous liait solidement pour un certain temps au vendeur. Mozilla fournit <strong>much of the same value</strong> que ces outils multiplate-forme, mais avec des licences libres.</p> - -<p><strong>As a rapidly maturing cross platform technology</strong>, XUL peut combler un vide intéressant pour des technologies telles que Java J2EE et Microsoft. Net qui sont axés sur l'activation de l'accès au réseau pour les objets distribués. La logique d'application dynamique peut bénéficier largement d'un niveau de présentation de l'interface utilisateur qui est basée sur des normes, des scripts, extensibles et de même distribuables sur Internet.</p> - -<p>XUL réduit la distinction entre les applications de bureau et le navigateur Internet, car il est bien implanté dans deux mondes. Certaines applications Web bénéficieront d'une migration vers XUL du fait de l'accroissement des capacités de l'interface utilisateur, d'une implémentation cohérente de la spécification à travers les plate-formes supportées et de l'accès aux ressources natives telles que les bibliothèques partagées et les fichiers locaux du système.</p> - -<p>Que vous désiriez migrer une application Web existante vers une application desktop, que cherchiez une technologie qui vous permettra facilement de porter vos applications sur différentes plate-formes ou que vous vouliez intégrer vos propres fonctionnalités au navigateur, XUL mérite d'être sérieusement considéré.</p> - -<h3 id="R.C3.A9f.C3.A9rences" name="R.C3.A9f.C3.A9rences">Références</h3> - -<ol> - <li>Documentation <a href="/fr/XUL" title="fr/XUL">XUL</a> sur MDC, comprenant <a href="/fr/Tutoriel_XUL" title="fr/Tutoriel_XUL">Tutoriel XUL</a> et la <a href="/fr/Référence_XUL" title="fr/Référence_XUL">Référence XUL</a></li> - <li><a href="/fr/Overlays_XUL" title="fr/Overlays_XUL">Overlays XUL</a></li> - <li>Documentation <a href="/fr/XBL" title="fr/XBL">XBL</a>: <a href="/en/XUL_Tutorial/Introduction_to_XBL">XBL introduction</a>, <a href="/en/XBL/XBL_1.0_Reference">XBL reference</a></li> - <li>Documentation <a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a></li> - <li>Documentation <a href="/fr/XPConnect" title="fr/XPConnect">XPConnect</a> (Composants scriptables). Voir également <a class="external" href="http://www.mozilla.org/scriptable/">XPConnect (Scriptable Components) (en)</a></li> - <li>Documentation sur les <a href="/fr/Extensions" title="fr/Extensions">Extensions</a>, comprenant un tutoriel de prise en main <a href="/fr/Construire_une_extension" title="fr/Construire_une_extension">Construire une extension</a></li> - <li><a class="external" href="http://www.mozilla.org/projects/calendar/">Projet Calendar sur Mozilla .org (en)</a></li> -</ol> diff --git a/files/fr/archive/mozilla/xul/listbox/index.html b/files/fr/archive/mozilla/xul/listbox/index.html deleted file mode 100644 index 7f793d544a..0000000000 --- a/files/fr/archive/mozilla/xul/listbox/index.html +++ /dev/null @@ -1,276 +0,0 @@ ---- -title: listbox -slug: Archive/Mozilla/XUL/listbox -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/listbox ---- -<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 dont l'un ou plusieurs d'entre-eux peuvent être sélectionnés. Une listbox peut contenir plusieurs colonnes. Différentes méthodes permettent aux éléments de la liste d'êtres récupérés et modifiés. -</p><p>Vous pouvez spécifier le nombre de lignes à afficher dans la liste à l'aide de l'attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code>. Les lignes supplémentaires peuvent être consultées avec une barre de défilement. Une listbox est supposée contenir des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code>. Toutes les lignes dans la listbox ont la même hauteur, qui est la hauteur du plus grand élément de la liste. Si vous désirez créer une liste dont les hauteurs de lignes sont variables, ou avec du contenu non textuel, utilisez plutôt l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/richlistbox" title="richlistbox">richlistbox</a></code>. -</p><p>Consultez le <a href="fr/Tutoriel_XUL/Les_contr%c3%b4les_de_listes">Tutoriel XUL</a> pour plus d'informations. </p> -<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-listBoxObject">listBoxObject</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-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-suppressOnSelect">suppressOnSelect</a>, <a href="#m-timedSelect">timedSelect</a>, <a href="#m-toggleItemSelection">toggleItemSelection</a> -</dd></dl> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<div class="float-right"><img alt="Image:XUL_ref_listbox.png"></div> -<pre> <listbox id="theList"> - <listitem label="Rubis"/> - <listitem label="Émeraude"/> - <listitem label="Saphir" selected="true"/> - <listitem label="Diamant"/> - </listbox> -</pre> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</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><magic name="\"PAGENAME\"/"></magic></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><magic name="\"PAGENAME\"/">Des cellules individuelles peuvent être sélectionnées.</magic><magic name="\"PAGENAME\"/"> Des lignes sont sélectionnées, cependant, l'indicateur de sélection n'est visible que sur le texte de la colonne principale.</magic></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-listBoxObject"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/listBoxObject">listBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIListBoxObject">nsIListBoxObject</a></i> -</dd><dd> L'objet <code>nsIListBoxObject</code> derrière la liste de sélection. Cette propriété est en lecture seule. La plupart des fonctionnalités de la liste de sélection sont déjà disponibles directement dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>, il sera donc rarement nécessaire d'utiliser cet objet de boîte directement. -</dd></dl> - -</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><magic name="\"PAGENAME\"/"></magic></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> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listcol" title="listcol">listcol</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listcols" title="listcols">listcols</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listhead" title="listhead">listhead</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listheader" title="listheader">listheader</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULMultiSelectControlElement">nsIDOMXULMultiSelectControlElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/listitem/index.html b/files/fr/archive/mozilla/xul/listitem/index.html deleted file mode 100644 index cf28e6472b..0000000000 --- a/files/fr/archive/mozilla/xul/listitem/index.html +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: listitem -slug: Archive/Mozilla/XUL/listitem -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/listitem ---- -<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>Une ligne unique dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>. Le texte de la ligne est généralement spécifié soit en utilisant des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code>, soit en plaçant un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> directement sur l'élément listitem. Par défaut, contient un seul élément listcell du type et de la classe appropriées pour le listitem. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Les_contr%c3%b4les_de_listes">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-checked">checked</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-current">current</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-preference">preference</a>, <a href="#a-selected">selected</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-listitem.type">type</a>, <a href="#a-value">value</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessKey">accessKey</a>, <a href="#p-accessible">accessible</a>, <a href="#p-checked">checked</a>, <a href="#p-control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-current">current</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-listitem-iconic">listitem-iconic</a> </dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_listbox.png"></div> -<pre> <listbox id="laListe"> - <listitem label="Rubis"/> - <listitem label="Émeraude"/> - <listitem label="Saphir" selected="true"/> - <listitem label="Diamant"/> - </listbox> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-checked"> - -<dl> - <dt> - <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code></dt> - <dd> - Type : - <i> - booléen</i> - </dd> - <dd> - Indique si l'élément est coché ou non.</dd> - <dd> - Utilisez <code>hasAttribute()</code> pour déterminer si cet attribut est défini plutôt que <code>getAttribute()</code>.<br> - Pour les boutons, l'attribut <code>type</code> doit etre mis à <code>checkbox</code> ou à <code>radio</code> pour qu'un effet soit perceptible.</dd> -</dl> -</div> -<div id="a-command"> - -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-current"> - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</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-selected"> - -<dl><dt> <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedItem">selectedItem</a></span></code> de l'élément conteneur. -</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-listitem.type"> - -</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-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-accessible"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-checked"></div> -<div id="p-control"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</dd></dl> - -</div> -<div id="p-current"></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-image"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> - -</div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-selected"> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<p>Les classes suivantes peuvent être utilisées pour styler l'élément. Il convient de les utiliser plutôt que de changer le style de l'élément directement afin de s'intégrer plus naturellement dans le thème choisi par l'utilisateur. -</p><dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/listitem-iconic">listitem-iconic</a></code></dt> - <dd>Use this class to have an image appear on the <code><a href="/en-US/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code>. Specify the image using the <code id="a-image"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/image">image</a></code> attribute.</dd> -</dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listcol" title="listcol">listcol</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listcols" title="listcols">listcols</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listhead" title="listhead">listhead</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/listheader" title="listheader">listheader</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/menu/index.html b/files/fr/archive/mozilla/xul/menu/index.html deleted file mode 100644 index 2a78b15497..0000000000 --- a/files/fr/archive/mozilla/xul/menu/index.html +++ /dev/null @@ -1,196 +0,0 @@ ---- -title: menu -slug: Archive/Mozilla/XUL/menu -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menu ---- -<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>Un élément, tout à fait semblable à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, qui est placé dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>. Lorsque l'utilisateur clique sur l'élément <code>menu</code>, le <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> enfant du menu sera affiché. Cet élément est également utilisé pour créer des sous-menus. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-acceltext">acceltext</a>, <a href="#a-accesskey">accesskey</a>, <a href="#a-allowevents">allowevents</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-menuactive">menuactive</a>, <a href="#a-open">open</a>, <a href="#a-sizetopopup">sizetopopup</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-accessKey">accessKey</a>, <a href="#p-command">command</a>, <a href="#p-menuitem.control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-itemCount">itemCount</a>, <a href="#p-label">label</a>, <a href="#p-labelElement">labelElement</a>, <a href="#p-menupopup">menupopup</a>, <a href="#p-menu.open">open</a>, <a href="#p-parentContainer">parentContainer</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-appendItem">appendItem</a>, <a href="#m-getIndexOfItem">getIndexOfItem</a>, <a href="#m-getItemAtIndex">getItemAtIndex</a>, <a href="#m-insertItemAt">insertItemAt</a>, <a href="#m-removeItemAt">removeItemAt</a> -</dd></dl> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<pre> <menubar id="sample-menubar"> - <menu id="file-menu" label="Fichier"> - <menupopup id="file-popup"> - <menuitem label="Nouveau"/> - <menuitem label="Ouvrir"/> - <menuitem label="Enregistrer"/> - <menuseparator/> - <menuitem label="Quitter"/> - </menupopup> - </menu> - <menu id="edit-menu" label="Édition"> - <menupopup id="edit-popup"> - <menuitem label="Annuler"/> - <menuitem label="Rétablir"/> - </menupopup> - </menu> - </menubar> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-acceltext"> - -<dl> - <dt> - <code id="a-acceltext"><a href="http://api/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code></dt> - <dd> - Type : <i>chaîne de caractères</i></dd> - <dd> - Texte qui apparaîtra à côté du label d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut <code>key</code>. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (<code>menubar</code>).</dd> -</dl> -</div> -<div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-allowevents"> - -<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-menuactive"> - -</div> -<div id="a-open"> - -<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. -</dd></dl> - - -</div> -<div id="a-sizetopopup"> - -</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-menuitem.control"></div> -<div id="p-itemCount"></div> -<div id="p-menupopup"></div> -<div id="p-menu.open"></div> -<div id="p-parentContainer"></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> - - - - - - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULContainerElement">nsIDOMXULContainerElement</a>, <a href="fr/NsIDOMXULContainerItemElement">nsIDOMXULContainerItemElement</a>, <a href="fr/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> -</dd></dl> diff --git a/files/fr/archive/mozilla/xul/menubar/index.html b/files/fr/archive/mozilla/xul/menubar/index.html deleted file mode 100644 index 2d8a8d5660..0000000000 --- a/files/fr/archive/mozilla/xul/menubar/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: menubar -slug: Archive/Mozilla/XUL/menubar -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menubar ---- -<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>Un conteneur généralement destiné à des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>. Sur les ordinateurs Macintosh, la barre de menus est affichée en haut de l'écran, et tous les éléments non liés à un menu dans l'élément <code>menubar</code> seront ignorés. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-grippyhidden">grippyhidden</a>, <a href="#a-statusbar">statusbar</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-statusbar">statusbar</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_menu.png"></div> -<pre><menubar id="sample-menubar"> - <menu id="action-menu" label="Action"> - <menupopup id="action-popup"> - <menuitem label="Nouvelle"/> - <menuitem label="Enregistrer" disabled="true"/> - <menuitem label="Fermer"/> - <menuseparator/> - <menuitem label="Quitter"/> - </menupopup> - </menu> - <menu id="edit-menu" label="Édition"> - <menupopup id="edit-popup"> - <menuitem label="Annuler"/> - <menuitem label="Rétablir"/> - </menupopup> - </menu> -</menubar> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-grippyhidden"> - -</div> -<div id="a-statusbar"> - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<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-statusbar"></div> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/menuitem/index.html b/files/fr/archive/mozilla/xul/menuitem/index.html deleted file mode 100644 index 813096fdc4..0000000000 --- a/files/fr/archive/mozilla/xul/menuitem/index.html +++ /dev/null @@ -1,293 +0,0 @@ ---- -title: menuitem -slug: Archive/Mozilla/XUL/menuitem -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menuitem ---- -<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>Un choix particulier dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Il agit de manière semblable à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, mais est affiché dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-acceltext">acceltext</a>, <a href="#a-accesskey">accesskey</a>, <a href="#a-allowevents">allowevents</a>, <a href="#a-autocheck">autocheck</a>, <a href="#a-checked">checked</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-description">description</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-menuitem.key">key</a>, <a href="#a-label">label</a>, <a href="#a-menuitem.name">name</a>, <a href="#a-selected">selected</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-menuitem.type">type</a>, <a href="#a-validate">validate</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-accessKey">accessKey</a>, <a href="#p-command">command</a>, <a href="#p-menuitem.control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-labelElement">labelElement</a>, <a href="#p-parentContainer">parentContainer</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-menuitem-iconic">menuitem-iconic</a>, <a href="#s-menuitem-non-iconic">menuitem-non-iconic</a> -</dd></dl> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<pre><menu id="edit-menu" label="Edit"> - <menupopup id="edit-popup"> - <menuitem label="Undo"/> - <menuitem label="Redo"/> - </menupopup> -</menu> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-acceltext"> - -<dl> - <dt> - <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code></dt> - <dd> - Type : <i>chaîne de caractères</i></dd> - <dd> - Texte qui apparaîtra à côté du label d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut <code>key</code>. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (<code>menubar</code>).</dd> -</dl> -</div> -<div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-allowevents"> - -<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même. -</dd></dl> - - -</div> -<div id="a-autocheck"> - -</div> -<div id="a-checked"> - -<dl> - <dt> - <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code></dt> - <dd> - Type : - <i> - booléen</i> - </dd> - <dd> - Indique si l'élément est coché ou non.</dd> - <dd> - Utilisez <code>hasAttribute()</code> pour déterminer si cet attribut est défini plutôt que <code>getAttribute()</code>.<br> - Pour les boutons, l'attribut <code>type</code> doit etre mis à <code>checkbox</code> ou à <code>radio</code> pour qu'un effet soit perceptible.</dd> -</dl> -</div> - -<div class="note"><b>Note :</b> si l'attribut <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code> est défini à <code>true</code>, et que sa valeur est rendue persistante avec l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, Mozilla ne pourra pas conserver cette valeur lorsque l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> est désélectionné suite au <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=15232" title="persist should be able to remove an attribute from an element">bug 15232</a>. Pour contourner ceci, définissez l'attribut <code id="a-autocheck"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/autocheck">autocheck</a></code> à <code>false</code>, puis définissez programmatiquement l'attribut <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code> lorsque l'utilisateur clique sur l'élément, et définissez-le à <code>false</code> au lieu de retirer l'attribut (c'est-à-dire qu'il faut faire <code>menuitem.setAttribute("checked", "false")</code> au lieu de <code>menuitem.removeAttribute("checked"))</code> lorsque l'utilisateur désélectionne le <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, car une valeur à <code>false</code> masquera correctement la marque cochée et conservera son état invisible.</div> -<div id="a-command"> - -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-description"> - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-menuitem.key"> - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-menuitem.name"> - -</div> -<div id="a-selected"> - -<dl><dt> <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedItem">selectedItem</a></span></code> de l'élément conteneur. -</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-menuitem.type"> - -</div> -<div id="a-validate"> - -</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> -<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-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-command"></div> -<div id="p-menuitem.control"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</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-image"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> - -</div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-labelElement"></div> -<div id="p-parentContainer"></div> -<div id="p-selected"> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</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> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/menuitem-iconic">menuitem-iconic</a></code></dt> - <dd>Use this class to have an image appear on the <code><a href="/en-US/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. Specify the image using the <code id="a-image"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/image">image</a></code> attribute.</dd> -</dl> -<dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/menuitem-non-iconic">menuitem-non-iconic</a></code></dt> - <dd>Normally, <code><a href="/en-US/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>s have a margin to the left for an image or checkmark. This class may be used to remove this margin so that the menuitem appears on the left edge of the menupopup.</dd> -</dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> </dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULContainerItemElement">nsIDOMXULContainerItemElement</a>, <a href="fr/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/menulist/index.html b/files/fr/archive/mozilla/xul/menulist/index.html deleted file mode 100644 index 1f88ef35db..0000000000 --- a/files/fr/archive/mozilla/xul/menulist/index.html +++ /dev/null @@ -1,276 +0,0 @@ ---- -title: menulist -slug: Archive/Mozilla/XUL/menulist -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menulist ---- -<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>Un élément pouvant être utilisé pour des listes de choix déroulantes. L'utilisateur peut sélectionner l'un des éléments affichés dans la liste <code>menulist</code>. Le choix actuellement sélectionné est affiché sur l'élément <code>menulist</code> lui-même. Pour créer la liste déroulante, ajoutez un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> dans l'élément <code>menulist</code>, avec les différents choix comme éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. L'évènement <code>command</code> peut être utilisé pour exécuter du code lorsque la sélection change dans la liste. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Les_contr%c3%b4les_de_listes">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-crop">crop</a>, <a href="#a-disableautoselect">disableautoselect</a>, <a href="#a-disabled">disabled</a>, <a href="#a-editable">editable</a>, <a href="#a-focused">focused</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-oncommand">oncommand</a>, <a href="#a-open">open</a>, <a href="#a-preference">preference</a>, <a href="#a-readonly">readonly</a>, <a href="#a-sizetopopup">sizetopopup</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-crop">crop</a>, <a href="#p-description">description</a>, <a href="#p-disableautoselect">disableautoselect</a>, <a href="#p-disabled">disabled</a>, <a href="#p-editable">editable</a>, <a href="#p-editor">editor</a>, <a href="#p-menulist.image">image</a>, <a href="#p-menulist.inputField">inputField</a>, <a href="#p-itemCount">itemCount</a>, <a href="#p-label">label</a>, <a href="#p-menuBoxObject">menuBoxObject</a>, <a href="#p-menupopup">menupopup</a>, <a href="#p-open">open</a>, <a href="#p-selectedIndex">selectedIndex</a>, <a href="#p-selectedItem">selectedItem</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-menulist.appendItem">appendItem</a>, <a href="#m-contains">contains</a>, <a href="#m-getIndexOfItem">getIndexOfItem</a>, <a href="#m-getItemAtIndex">getItemAtIndex</a>, <a href="#m-insertItemAt">insertItemAt</a>, <a href="#m-removeAllItems">removeAllItems</a>, <a href="#m-removeItemAt">removeItemAt</a>, <a href="#m-menulist.select">select</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre> <menulist> - <menupopup> - <menuitem label="option 1" value="1"/> - <menuitem label="option 2" value="2"/> - <menuitem label="option 3" value="3"/> - <menuitem label="option 4" value="4"/> - </menupopup> - </menulist> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-disableautoselect"> - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-editable"> - -</div> -<div id="a-focused"> - -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-oncommand"> - -<dl><dt> <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Ce gestionnaire d'évènement est appelé lorsque la commande est activée. Cela se produit quand un utilisateur sélectionne un élément de menu ou active un raccourci clavier attaché à la commande. -</dd></dl> - - -</div> -<div id="a-open"> - -<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. -</dd></dl> - - -</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-readonly"> - -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</dd></dl> - - -</div> -<div id="a-sizetopopup"> - -</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-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</dd></dl> - -</div> -<div id="p-description"></div> -<div id="p-disableautoselect"></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-editable"></div> -<div id="p-editor"></div> -<div id="p-menulist.image"></div> -<div id="p-menulist.inputField"></div> -<div id="p-itemCount"></div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-menuBoxObject"></div> -<div id="p-menupopup"></div> -<div id="p-open"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/open">open</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code>. -</dd></dl> - -</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-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> - - - - - - - - - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULMenuListElement">nsIDOMXULMenuListElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/menupopup/index.html b/files/fr/archive/mozilla/xul/menupopup/index.html deleted file mode 100644 index b71b919590..0000000000 --- a/files/fr/archive/mozilla/xul/menupopup/index.html +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: menupopup -slug: Archive/Mozilla/XUL/menupopup -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menupopup ---- -<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>Un conteneur utilisé pour afficher le contenu d'un menu popup. Lorsqu'un menupopup est ouvert, il flotte par dessus la fenêtre et peut s'étendre en dehors de celle-ci. Les menupopups peuvent être utilisés de plusieurs manières : -</p> -<ol><li> On peut les placer dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> ou <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> avec l'attribut <a href="#a-type">type</a> défini à « menu » pour créer un popup qui s'ouvrira lors d'un clic sur le bouton ou menu. -</li><li> On peut les attacher à n'importe quel élément à l'aide de l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>. Lors d'un clic gauche sur l'élément, le menupopup sera affiché. -</li><li> On peut les attacher à n'importe quel élément à l'aide de l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>. Lors de l'ouverture d'un menu contextuel, le menupopup sera affiché. Un menu contextuel peut être ouvert par un clic droit sur l'élément ou l'appui sur la touche menu du clavier. </li></ol> -<p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-ignorekeys">ignorekeys</a>, <a href="#a-popup.left">left</a>, <a href="#a-onpopuphidden">onpopuphidden</a>, <a href="#a-onpopuphiding">onpopuphiding</a>, <a href="#a-onpopupshowing">onpopupshowing</a>, <a href="#a-onpopupshown">onpopupshown</a>, <a href="#a-popup.position">position</a>, <a href="#a-popup.top">top</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-popupBoxObject">popupBoxObject</a>, <a href="#p-popup">popup</a>, <a href="#p-state">state</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-hidePopup">hidePopup</a>, <a href="#m-moveTo">moveTo</a>, <a href="#m-openPopup">openPopup</a>, <a href="#m-openPopupAtScreen">openPopupAtScreen</a>, <a href="#m-showPopup">showPopup</a>, <a href="#m-sizeTo">sizeTo</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>L'exemple suivant montre l'attachement d'un menupopup à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>. -</p> -<pre><menulist> - <menupopup> - <menuitem label="Mozilla" value="http://mozilla.org"/> - <menuitem label="Slashdot" value="http://slashdot.org"/> - <menuitem label="Sourceforge" value="http://sf.net"/> - <menuitem label="Freshmeat" value="http://freshmeat.net"/> - </menupopup> -</menulist> -</pre> -<p>L'exemple qui suit montre l'utilisation d'un menupopup comme menu contextuel d'un élément. Lors d'un clic droit sur le label, le menu sera affiché. -</p> -<div class="float-right"><img alt="Image:XUL_ref_popup.png"></div> -<pre><menupopup id="clipmenu"> - <menuitem label="Couper"/> - <menuitem label="Copier"/> - <menuitem label="Coller"/> -</menupopup> -<label value="Clic droit pour ouvrir un popup" context="clipmenu"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-ignorekeys"> - -</div> -<div id="a-popup.left"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.left">left</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position horizontale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-onpopuphidden"> - -<dl><dt> <code id="a-onpopuphidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphidden">onpopuphidden</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après qu'il a été caché. <span class="comment"><a class=" external" href="http://www.langue-fr.net/index/A/apres-que.htm" rel="freelink">http://www.langue-fr.net/index/A/apres-que.htm</a></span> -</dd></dl> - - -</div> -<div id="a-onpopuphiding"> - -<dl><dt> <code id="a-onpopuphiding"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphiding">onpopuphiding</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué. -</dd></dl> - - -</div> -<div id="a-onpopupshowing"> - -<dl><dt> <code id="a-onpopupshowing"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshowing">onpopupshowing</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> 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 <code>false</code>, le popup ne s'affichera pas. -</dd></dl> - - -</div> -<div id="a-onpopupshown"> - -<dl><dt> <code id="a-onpopupshown"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshown">onpopupshown</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement <code>onload</code> est envoyé à une fenêtre à son ouverture. -</dd></dl> - - -</div> -<div id="a-popup.position"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.position">position</a> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'attribut <code>position</code> 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. -</dd></dl> -<ul><li> <code>after_start</code> : Le popup apparait en dessous l'élément avec le coin supérieur gauche du popup aligné avec le coin inférieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. Cette valeur est typiquement uilisée pour les menus déroulants. -</li><li> <code>after_end</code> : Le popup apparait en dessous l'élément avec le coin supérieur droit du popup aligné avec le coin inférieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_start</code> : Le popup apparait au dessus de l'élément avec le coin inférieur gauche du popup aligné avec le coin supérieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_end</code> : Le popup apparait au dessus de l'élément avec le coin inférieur droit du popup aligné avec le coin supérieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_after</code> : Le popup apparait à la droite de l'élément avec le coin inférieur gauche du popup aligné avec le coin inférieur droit de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_before</code> : Le popup apparait à la droite de l'élément avec le coin supérieur gauche du popup aligné avec le coin supérieur droit de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_after</code> : Le popup apparait à la gauche de l'élément avec le coin inférieur droit du popup aligné avec le coin inférieur gauche de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_before</code> : Le popup apparait à la gauche de l'élément avec le coin supérieur droit du popup aligné avec le coin supérieur gauche de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>overlap</code> : Le popup apparait par dessus l'élément avec les coins supérieurs gauches alignés. -</li><li> <code>at_pointer</code> : Le popup apparait à la position du pointeur de la souris. -</li><li> <code>after_pointer</code> : Le popup apparait à la même position horizontale que le pointeur de la souris, mais verticalement, il est placé juste sous l'élément. -</li></ul> - - -</div> -<div id="a-popup.top"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.top">top</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position verticale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> - - -</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-popupBoxObject"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/popupBoxObject">popupBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a></i> -</dd><dd> Cette propriété en lecture seule conserve le <a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a> 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. -</dd></dl> - -</div> -<div id="p-position"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/position">position</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Obtient et définit la valeur de l'attribut <a href="fr/XUL/Attributs/popup.position">position</a>. -</dd></dl> - -</div> -<div id="p-state"> -<dl><dt> <code><span><a href="http://api/fr/docs/XUL/Propri%C3%A9t%C3%A9s/state">state</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Cette propriété en lecture seule indique si le popup est ouvert ou non. Quatre valeurs sont possibles : -</dd></dl> -<ul><li> <code>closed</code> : Le popup est fermé et non visible. -</li><li> <code>open</code> : Le popup est ouvert et visible sur l'écran. -</li><li> <code>showing</code> : Une requête a été faite pour ouvrir le popup, mais il n'a pas encore été affiché. Cet état se produit durant l'évènement <code>popupshowing</code>. -</li><li> <code>hiding</code> : Le popup est sur le point d'être masqué. Cet état se produit durant l'évènement <code>popuphiding</code>. -</li></ul> - -</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-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/hidePopup">hidePopup()</a></code></span></dt> -<dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Ferme le popup immédiatement. -</dd></dl> -<dl><dt> <span id="m-moveTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/moveTo">moveTo( x, y )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Déplace le popup vers un nouvel emplacement. -</dd></dl> -<dl><dt> <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopup">openPopup( anchor , position , x , y , isContextMenu, attributesOverride )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique. -</p><p>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 <code>anchor</code> et définissez la <code>position</code> par une chaîne indiquant la manière dont le popup doit être ancré. -</p><p>Les valeurs possibles pour le paramètre <code>position</code> sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer -</p><p>Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup. -</p><p>Si le paramètre <code>attributesOverride</code> vaut <code>true</code>, l'attribut <code>position</code> sur le nœud popup a priorité sur la valeur du paramètre <code>position</code>. Si <code>attributesOverride</code> vaut <code>false</code>, l'attribut n'est utilisé que si le paramètre <code>position</code> est vide. -</p><p>Pour un popup ancré, les paramètres <code>x</code> et <code>y</code> peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS). -</p><p>Les popups non ancrés peuvent être créés en fournissant <code>null</code> comme paramètre <code>anchor</code>. Un popup non ancré apparait à la position spécifiée par <code>x</code> et <code>y</code> relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres <code>position</code> et <code>attributesOverride</code> sont ignorés. -</p> -<dl><dt> <span id="m-openPopupAtScreen"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopupAtScreen">openPopupAtScreen( x, y, isContextMenu )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup à une position spécifique sur l'écran spécifiée par <code>x</code> et <code>y</code>. 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 <code>x</code> et <code>y</code> sont mesurées en pixels CSS. -</p> -<dl><dt> <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup( element, x, y, popupType, anchor, align )</a></code></span> <span style="border: 1px solid #9898F0; background-color: #DDDDFF; font-size: 9px; vertical-align: text-top;">Déprécié dans Mozilla 1.9</span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> 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 <var>x</var> ou <var>y</var> sont définies par une valeur, le popup apparaîtra aux coordonnées (<var>x</var>,<var>y</var>) de l'écran. Si <var>x</var> et <var>y</var> sont définies à <code>-1</code>, le popup sera positionné par rapport à l'<var>element</var> 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 <var>anchor</var> et <var>align</var> peuvent être utilisés pour contrôler plus avant l'endroit où apparaîtra le popup par rapport à l'élément. Le paramètre <var>anchor</var> correspond à l'attribut <code id="a-popupanchor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupanchor">popupanchor</a></code> de l'élément et le paramètre <var>align</var> correspond à l'attribut <code id="a-popupalign"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupalign">popupalign</a></code>. Les paramètres <var>anchor</var> et <var>align</var> sont ignorés si ni <var>x</var> ni <var>y</var> ne valent <code>-1</code>. -</dd></dl> -<dl><dd> 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/boxObject">boxObject</a></span></code>.screenX et <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/boxObject">boxObject</a></span></code>.screenY, et utilisez celles-ci comme paramètres <var>x</var> et <var>y</var> en y ajoutant les décalages souhaités. -</dd></dl> -<dl><dd> Le paramètre <var>popupType</var> doit être une des chaînes <code>popup</code>, <code>context</code> ou <code>tooltip</code>. 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. -</dd></dl> -<dl><dt> <span id="m-sizeTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/sizeTo">sizeTo( <i>largeur</i>, <i>hauteur</i> )</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Modifie la taille actuelle de la fenêtre popup avec les nouvelles dimensions <var>largeur</var> et <var>hauteur</var>. -</dd></dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments </dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> </dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULPopupElement">nsIDOMXULPopupElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/menuseparator/index.html b/files/fr/archive/mozilla/xul/menuseparator/index.html deleted file mode 100644 index 59a1fe1dda..0000000000 --- a/files/fr/archive/mozilla/xul/menuseparator/index.html +++ /dev/null @@ -1,242 +0,0 @@ ---- -title: menuseparator -slug: Archive/Mozilla/XUL/menuseparator -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/menuseparator ---- -<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>Utilisé pour créer un séparateur entre des éléments de menu. Typiquement affiché sous la forme d'une fine ligne. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-acceltext">acceltext</a>, <a href="#a-accesskey">accesskey</a>, <a href="#a-allowevents">allowevents</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-selected">selected</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-accessKey">accessKey</a>, <a href="#p-command">command</a>, <a href="#p-menuitem.control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-labelElement">labelElement</a>, <a href="#p-parentContainer">parentContainer</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre><menu label="Aide"> - <menupopup> - <menuitem label="Rubriques d'aide"/> - <menuseparator/> - <menuitem label="Notes de version"/> - </menupopup> -</menu> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-acceltext"> - -<dl> - <dt> - <code id="a-acceltext"><a href="http://api/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code></dt> - <dd> - Type : <i>chaîne de caractères</i></dd> - <dd> - Texte qui apparaîtra à côté du label d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut <code>key</code>. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (<code>menubar</code>).</dd> -</dl> -</div> -<div id="a-accesskey"> - -<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> -<dd> Type : <i>caractère</i> -</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> -<h4 id="Exemple" name="Exemple"> Exemple </h4> -<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> -<pre><vbox> - <label value="Entrez votre nom" accesskey="e" control="myName"/> - <textbox id="myName"/> - <button label="Annuler" accesskey="n"/> - <button label="OK" accesskey="O"/> -</vbox> -</pre> -<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> -<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> -</p> -</div> -<div id="a-allowevents"> - -<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même. -</dd></dl> - - -</div> -<div id="a-command"> - -<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> -</dt><dd> Type : <i>id d'élément</i> -</dd><dd> Défini à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> observé par l'élément. -</dd></dl> - - -</div> -<div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-selected"> - -<dl><dt> <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedItem">selectedItem</a></span></code> de l'élément conteneur. -</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-accessKey"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-command"></div> -<div id="p-menuitem.control"></div> -<div id="p-crop"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</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-image"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> - -</div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-labelElement"></div> -<div id="p-parentContainer"></div> -<div id="p-selected"> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULContainerItemElement">nsIDOMXULContainerItemElement</a>, <a href="fr/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/modification_dynamique_d'interfaces_utilisateur_en_xul/index.html b/files/fr/archive/mozilla/xul/modification_dynamique_d'interfaces_utilisateur_en_xul/index.html deleted file mode 100644 index 5275b8d97f..0000000000 --- a/files/fr/archive/mozilla/xul/modification_dynamique_d'interfaces_utilisateur_en_xul/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Modification dynamique d'interfaces utilisateur en XUL -slug: Archive/Mozilla/XUL/Modification_dynamique_d'interfaces_utilisateur_en_XUL -tags: - - DOM - - Extensions - - NeedsUpdate - - XUL -translation_of: Archive/Mozilla/XUL/Dynamically_modifying_XUL-based_user_interface ---- -<p>Cet article traite de la manipulation d'interfaces en <a href="fr/XUL">XUL</a>, à l'aide du <a href="fr/DOM">DOM</a> et d'autres API. Il explique le concept des<em>documents</em> DOM, présente quelques exemples simples d'appels DOM utilisés pour effectuer des manipulations basiques sur un document, et ensuite la façon de travailler avec du<em>contenu <a href="fr/XBL">XBL</a> anonyme</em> à l'aide de méthodes spécifiques à Mozilla.</p> - -<p>Il est écrit pour des développeurs XUL débutants et de niveau moyen. Nous supposons que le lecteur a des connaissances de base à la fois en XUL et en JavaScript. Il peut également être intéressant de consulter quelques documents d'introduction relatifs au DOM, comme l'article <a href="fr/%c3%80_propos_du_Document_Object_Model">À propos du Document Object Model</a> ou la <a href="fr/R%c3%a9f%c3%a9rence_du_DOM_Gecko/Introduction">page d'introduction</a> de la <a href="fr/R%c3%a9f%c3%a9rence_du_DOM_Gecko">Référence du DOM Gecko</a>.</p> - -<h3 id="Introduction" name="Introduction">Introduction</h3> - -<p>Comme vous le savez, <a href="fr/XUL">XUL</a> est un langage <a href="fr/XML">XML</a> utilisé dans plusieurs applications basées sur Mozilla, comme Firefox et Thunderbird, pour décrire l'interface utilisateur. Dans les applications XUL, <a href="fr/JavaScript">JavaScript</a> définit le comportement, à l'aide des <a href="fr/R%c3%a9f%c3%a9rence_du_DOM_Gecko">API DOM</a> pour accéder au document XUL.</p> - -<p>En quoi consistent ces API DOM ?</p> - -<p>Ce sont les interfaces utilisées dans toute interaction entre un script et un document. Si vous avez écrit n'importe quel script interagissant avec un document XUL (ou HTML), vous avez déjà utilisé des appels DOM. La méthode DOM la plus connue est probablement <code><a href="fr/DOM/document.getElementById">document.getElementById</a>()</code>, qui renvoie un élément depuis son <code>id</code>. Vous avez peut-être utilisé d'autres appels, comme <code><a href="fr/DOM/element.setAttribute">element.setAttribute</a>()</code>, ou, si vous avez écrit une extension, la méthode <code><a href="fr/DOM/element.addEventListener">addEventListener</a>()</code>. Toutes celles-ci sont définies dans le DOM.</p> - -<p>D'autres méthodes DOM permettent également de créer, déplacer ou supprimer des éléments d'un document. Celles-ci seront présentées dans une section ultérieure. Pour l'instant, préoccupons-nous de ce qu'est un<em>document</em> .</p> - -<h3 id="D.C3.A9finition_d.27un_document" name="D.C3.A9finition_d.27un_document">Définition d'un document</h3> - -<p>Un document est une structure de données manipulée à l'aide des API DOM. Une structure logique de tout élément est un arbre, dont les nœuds sont les éléments, attributes, instructions de traitement, commentaires, etc. Utilisez l'outil <a href="fr/Inspecteur_DOM">Inspecteur DOM</a> pour voir la représentation sous forme d'arbre de n'importe quel document. <span class="comment">Todo: simple example of a XUL document and a tree</span></p> - -<p>Vous pouvez penser à un document comme à une représentation en mémoire de HTML valide ou de XML bien formé (en ce compris du XUL).</p> - -<p>Il est important de se souvenir de différentes pages Web (et même différentes instances de la même page Web) correspondent à différents documents. Chaque fenêtre XUL possède son propre document distinct, et il peut même y avoir un certain nombre de documents différents dans une même fenêtre, lorsqu'uil y a des élements <code><iframe></code>, <code><browser></code>, ou encore <code><tabbrowser></code>. Vous devez vous assurer de toujours manipuler le bon document. (Consultez <a href="fr/Travailler_avec_des_fen%c3%aatres_dans_le_chrome">Travailler avec des fenêtres dans le chrome</a> pour en savoir plus.) Lorsque votre script est inclus à l'aide d'une balise <code><script></code>, la propriété <code>document</code> référence le document DOM dont le script fait partie.</p> - -<h3 id="Exemples__utilisation_de_m.C3.A9thodes_DOM" name="Exemples_:_utilisation_de_m.C3.A9thodes_DOM">Exemples : utilisation de méthodes DOM</h3> - -<p>Cette section présente l'utilisation des méthodes DOM <code>appendChild()</code>, <code>createElement()</code>, <code>insertBefore()</code>, et <code>removeChild()</code>.</p> - -<h4 id="Suppression_de_tous_les_enfants_d.27un_.C3.A9l.C3.A9ment" name="Suppression_de_tous_les_enfants_d.27un_.C3.A9l.C3.A9ment">Suppression de tous les enfants d'un élément</h4> - -<p>Cet exemple supprime tous les enfants d'un élément dont l'id est <code>"unCertainElement"</code> du document courant, en appelant la méthode <code>removeChild()</code> pour supprimer le premier enfant et ce jusqu'à ce que plus aucun d'entre-eux ne reste.</p> - -<p>Notez que <code>hasChildNodes()</code> et <code>firstChild</code> font également partie de l'API DOM.</p> - -<pre class="eval">var element = document.getElementById("unCertainElement"); -while(element.hasChildNodes()) - element.removeChild(element.firstChild); -</pre> - -<h4 id="Insertion_d.27.C3.A9l.C3.A9ments_de_menu_dans_un_menu" name="Insertion_d.27.C3.A9l.C3.A9ments_de_menu_dans_un_menu">Insertion d'éléments de menu dans un menu</h4> - -<p>Cet exemple ajoute deux nouveaux élements de menu à un <code><menupopup></code>, au début et à la fin de celui-ci. Il utilise la méthode <code>document.createElementNS()</code> pour créer les éléments, et <code>insertBefore()</code> avec <code>appendChild()</code> pour insérer les éléments créés dans le document.</p> - -<p>Notes :</p> - -<ul> - <li><code>document.createElementNS()</code> crée un élément, mais ne le place nulle part dans le document. Il faut utiliser d'autres méthodes DOM, comme <code>appendChild()</code> pour insérer l'élément nouvellement créé dans le document.</li> - <li><code>appendChild()</code> ajoute le nœud après tous les autres nœuds, tandis que <code>insertBefore()</code> l'insère avant le nœud référencé dans son second paramètre.</li> -</ul> - -<pre class="eval">function createMenuItem(aLabel) { - const XUL_NS = "<a class="external" href="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" rel="freelink">http://www.mozilla.org/keymaster/gat...re.is.only.xul</a>"; - var item = document.createElementNS(XUL_NS, "menuitem"); // crée un nouvel élément de menu XUL - item.setAttribute("label", aLabel); - return item; -} -var popup = document.getElementById("myPopup"); // un élément <menupopup> -var first = createMenuItem("Premier choix"); -var last = createMenuItem("Dernier choix"); -popup.insertBefore(first, popup.firstChild); -popup.appendChild(last); -</pre> - -<p>Il est également possible d'utiliser <code>appendChild()</code> et <code>insertBefore()</code> pour déplacer des éléments existants. Par exemple, vous pouvez déplacer l'élément nommé « First item » vers la fin du menu en ajoutant cette ligne à la fin du bout de code ci-dessus :</p> - -<pre class="eval">popup.appendChild(first); -</pre> - -<p>Cette instruction supprimerait le nœud de sa position courante dans le document et le réinsèrerait à la fin du menu.</p> - -<h3 id="Contenu_anonyme_.28XBL.29" name="Contenu_anonyme_.28XBL.29">Contenu anonyme (XBL)</h3> - -<p><a href="fr/XBL">XBL</a> est le langage utilisé dans Mozilla pour définir de nouveaux éléments d'interface. Ces outils définis en XBL peuvent choisir de définir un certain contenu qui sera inséré dans l'élément conteneur lorsque la liaison (binding) est attachée. Ce contenu, appelé<em>contenu anonyme</em> , n'est pas accessible à travers les méthodes DOM normales.</p> - -<p>Il est nécessaire d'utiliser les méthodes de l'interface <code><a href="fr/NsIDOMDocumentXBL">nsIDOMDocumentXBL</a></code> à la place. Par exemple :</p> - -<pre class="eval">// récupère le premier enfant anonyme du nœud donné -document.getAnonymousNodes(node)[0]; - -// renvoie une NodeList d'éléments anonymes dont l'attribut anonid vaut el1 -document.getAnonymousElementByAttribute(node, "anonid", "el1"); -</pre> - -<p>Une fois que vous avez une référence à un nœud anonyme, vous pouvez utiliser les méthodes DOM normales pour naviguer et manipuler les autres nœuds de cette liaison XBL.</p> - -<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3> - -<ul> - <li><a href="fr/Tutoriel_XUL/Modification_d'une_interface_XUL">Tutoriel XUL:Modification d'une interface XUL</a></li> -</ul> diff --git a/files/fr/archive/mozilla/xul/modifications_xul_pour_firefox_1.5/index.html b/files/fr/archive/mozilla/xul/modifications_xul_pour_firefox_1.5/index.html deleted file mode 100644 index 851dd7ae7a..0000000000 --- a/files/fr/archive/mozilla/xul/modifications_xul_pour_firefox_1.5/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Modifications XUL pour Firefox 1.5 -slug: Archive/Mozilla/XUL/Modifications_XUL_pour_Firefox_1.5 -tags: - - XUL -translation_of: Archive/Mozilla/XUL/XUL_Changes_for_Firefox_1.5 ---- -<p> -</p><p>Cette page répertorie les modifications les plus remarquables au <a href="fr/XUL">XUL</a> dans <a href="fr/Firefox_1.5">Firefox 1.5</a> (<a href="fr/Gecko">Gecko</a> 1.8). Pour les autres changements à connaître, voir <a href="fr/Adaptation_des_applications_XUL_pour_Firefox_1.5">Adaptation des applications XUL pour Firefox 1.5</a>. -</p> -<h3 id="<scrollcorner>"> <code><scrollcorner></code> </h3> -<p>Un nouvel élément <scrollcorner> sert à créer une petite boîte à l'intersection entre les ascenseurs horizontal et vertical. -</p> -<h3 id="<richlistbox>_et_<richlistitem>"> <code><richlistbox></code> et <code><richlistitem></code> </h3> -<p>Les éléments <richlistbox> et <richlistitem> sont utilisés pour la création de liste avec du contenu arbitraire. Cet élément fonctionne de manière similaire à <listbox> qui est principalement dédié aux listes de texte. Le <richlistbox> supporte presque la même API que le <listbox> et des items uniques créés avec l'élément <richlistitem> peuvent y être sélectionnés. Consultez <a href="fr/XUL/Richlistbox">XUL:Richlistbox</a> pour plus d'information. -</p> -<h3 id="Système_de_préférences"> Système de préférences </h3> -<p>Plusieurs éléments ont été ajoutés pour la création de fenêtre de gestion des préférences. Ces fenêtres sont des types spéciaux de boîtes de dialogues supportant plusieurs panneaux qui peuvent être contenus dans le même fichier ou des fichiers séparés. Une série d'icônes apparaîtront en haut de la boîte de dialogue pour permettre à l'utilisateur de changer de panneaux. En plus de ces nouveaux éléments, quelques attributs supplémentaires pour des éléments existants ont été ajoutés pour rendre plus simple la configuration de préférences sans avoir à utiliser de code. Pour plus d'information, consultez <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>. -</p> -<h3 id="bfcache"> <code>bfcache</code> </h3> -<p>Mozilla <a href="fr/Utilisation_du_cache_de_Firefox_1.5">mémorise maintenant les résultats</a> du DOM d'une page, afin de ne pas avoir à recharger la page en navigant vers l'arrière ou vers l'avant, ce qui rend la navigation beaucoup plus efficace. Les évènements <code>pageshow</code> et <code>pagehide</code> sont utilisés lors du basculement vers une page dans le cache, tandis que les évènements <code>load</code> et <code>unload</code> servent uniquement lorsqu'une page est chargée ou déchargée. -</p><p>Pour plus d'information, consultez <a href="fr/Utilisation_du_cache_de_Firefox_1.5">Utilisation du cache de Firefox 1.5 </a> -</p> -<h3 id="tabIndex"> <code>tabIndex</code> </h3> -<p>La propriété <code>tabIndex</code> s'applique maintenant à plus d'éléments. -</p> -<h3 id="<radiogroup>"> <code><radiogroup></code> </h3> -<p>L'affectation de la propriété <code>value</code> sur un élément <radiogroup> sélectionne directement l'élément <radio> du groupe ayant la valeur correspondante. -</p> -<h3 id="Boîte_de_dialogue_propriété_defaultButton"> Boîte de dialogue : propriété <code>defaultButton</code> </h3> -<p>La liaison <code><dialog></code> supporte maintenant la propriété <code>defaultButton</code>. L'affectation de cette propriété modifie le bouton par défaut de la boîte de dialogue. Il peut être défini soit à l'un des boutons de la liaison <code><dialog></code> (en utilisant leurs noms) ou soit à <code>none</code> auquel cas aucun bouton ne sera défini par défaut. -</p> -<h3 id="Bouton_propriété_icon"> Bouton : propriété <code>icon</code> </h3> -<p>La propriété <code>icon</code> d'un bouton peut servir à définir un stock d'icônes prédéfinies sur un bouton et utilisées sur certaines plateformes. Par exemple, <code><button icon="help"></code> va créer un bouton avec une icône d'aide. Les systèmes GNOME utilisent habituellement cette pratique où les valeurs possibles sont : -</p><p><code>accept</code>, <code>cancel</code>, <code>help</code>, <code>open</code>, <code>save</code>, <code>find</code>, <code>clear</code>, <code>yes</code>, <code>no</code>, <code>apply</code>, <code>close</code>, <code>print</code>, <code>add</code>, <code>remove</code>, <code>refresh</code>, <code>go-forward</code>, <code>go-back</code>, <code>properties</code>, <code>select-font</code>, <code>select-color</code>, <code>network</code>. -</p> -<h3 id="<menulist>"> <code><menulist></code> </h3> -<p>Les items dans un <menulist> supporte l'attribut <code>description</code> permettant d'inclure du texte descriptif à côté du libellé d'un item. Les méthodes <code>appendItem</code> et <code>insertItemAt</code> utilisées pour pour la création d'items dans un menulist prennent un argument supplémentaire pour cette description. -</p> -<h3 id="<stringbundle>"> <code><stringbundle></code> </h3> -<p>L'élément <stringbundle> a une propriété <code>strings</code> servant à récupérer une énumération de toutes les chaînes de caractères dans le bundle. -</p> -<h3 id="Onglets_repositionnables"> Onglets repositionnables </h3> -<p>L'utilisateur peut maintenant réarranger les onglets de navigation en les faisant glisser. -</p> -<h3 id="<tabbox>"> <code><tabbox></code> </h3> -<p>L'élément <code><tabbox></code> supporte maintenant l'attribut <code>selectedIndex</code> pour définir l'onglet sélectionné par défaut. -</p> -<h3 id="Chargement_dynamique_des_overlays"> Chargement dynamique des overlays </h3> -<p>XUL supporte maintenant le chargement dynamique des <a href="fr/XUL_Overlays">overlays</a> grâce à la fonction <code><a href="fr/Document.loadOverlay">document.loadOverlay</a></code>. -</p> -<div class="originaldocinfo"> -<h3 id="Informations_sur_le_document_d'origine"> Informations sur le document d'origine </h3> -<ul><li> Auteur(s) : Neil Deakin -</li><li> Traducteur(s) : Alain B. -</li></ul> -</div> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/blur/index.html b/files/fr/archive/mozilla/xul/méthodes/blur/index.html deleted file mode 100644 index c8078d98c9..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/blur/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: blur -slug: Archive/Mozilla/XUL/Méthodes/blur -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/blur ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-blur"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/blur">blur()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Si le focus est sur l'élément, il sera retiré. Le focus n'est placé automatiquement sur aucun autre élément. Utilisé essentiellement pour appeler le gestionnaire d'évènement <code>onblur</code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/click/index.html b/files/fr/archive/mozilla/xul/méthodes/click/index.html deleted file mode 100644 index ef23173bfb..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/click/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: click -slug: Archive/Mozilla/XUL/Méthodes/click -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/click ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-click"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/click">click()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Appelle le gestionnaire d'évènement <code>onclick</code> pour l'élément. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/decrease/index.html b/files/fr/archive/mozilla/xul/méthodes/decrease/index.html deleted file mode 100644 index 7e3bc38bfd..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/decrease/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: decrease -slug: Archive/Mozilla/XUL/Méthodes/decrease -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/decrease ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<div class="noinclude"> - <dl> - <dd> - Méthode de : <code><a href="/fr/docs/Mozilla/Tech/XUL/scale" title="scale">scale</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code></dd> - </dl> -</div> -<dl> - <dt> - <span id="m-decrease"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/decrease">decrease()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Diminue la valeur de<magic name="\"PAGENAME\"/"> la boîte numérique l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/méthodes/decreasepage/index.html b/files/fr/archive/mozilla/xul/méthodes/decreasepage/index.html deleted file mode 100644 index 3d83d6c860..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/decreasepage/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: decreasePage -slug: Archive/Mozilla/XUL/Méthodes/decreasePage -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/decreasePage ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-decreasePage"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/decreasePage">decreasePage()</a></code></span></dt><div class="noinclude"> -<dd> Méthode de : <code><a href="/fr/docs/Mozilla/Tech/XUL/scale" title="scale">scale</a></code></dd></div> -<dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Diminue la valeur de l'échelle de la valeur de <code>pageIncrement</code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/docommand/index.html b/files/fr/archive/mozilla/xul/méthodes/docommand/index.html deleted file mode 100644 index 362e53a578..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/docommand/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: doCommand -slug: Archive/Mozilla/XUL/Méthodes/doCommand -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/doCommand ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur renvoyée</i> -</dd><dd> Exécute l'évènement <code>command</code> pour l'élément. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/focus/index.html b/files/fr/archive/mozilla/xul/méthodes/focus/index.html deleted file mode 100644 index 9f936eba19..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/focus/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: focus -slug: Archive/Mozilla/XUL/Méthodes/focus -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/focus ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-focus"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/focus">focus()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Assigne le focus à l'élément, si celui-ci peut l'accepter. Le gestionnaire d'évènement <code>onfocus</code> est appelé. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/getelementsbyattribute/index.html b/files/fr/archive/mozilla/xul/méthodes/getelementsbyattribute/index.html deleted file mode 100644 index 1eceb74073..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/getelementsbyattribute/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: getElementsByAttribute -slug: Archive/Mozilla/XUL/Méthodes/getElementsByAttribute -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/getElementsByAttribute ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttribute">getElementsByAttribute( attrib, value )</a></code></span> -</dt><dd> Type de retour : <i>liste de nœuds DOM (NodeList)</i> -</dd><dd> Renvoie un tableau contenant tous les éléments enfants de l'élément disposant de l'attribut donné comme premier paramètre avec la valeur donnée comme second paramètre. Si le second paramètre est « * », l'attribut peut avoir n'importe quelle valeur. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/getrowcount/index.html b/files/fr/archive/mozilla/xul/méthodes/getrowcount/index.html deleted file mode 100644 index 3ffe5f059b..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/getrowcount/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: getRowCount -slug: Archive/Mozilla/XUL/Méthodes/getRowCount -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/getRowCount ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-getRowCount"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/hasuservalue/index.html b/files/fr/archive/mozilla/xul/méthodes/hasuservalue/index.html deleted file mode 100644 index e0c2b8202f..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/hasuservalue/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: hasUserValue -slug: Archive/Mozilla/XUL/Méthodes/hasUserValue -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/hasUserValue ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-hasUserValue"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/hasUserValue">hasUserValue()</a></code></span> -</dt><dd> Type de retour : <i>booléen</i> -</dd><dd> Renvoie <code>true</code> si la préférence a été modifiée par rapport à sa valeur par défaut. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/hidepopup/index.html b/files/fr/archive/mozilla/xul/méthodes/hidepopup/index.html deleted file mode 100644 index d900d650db..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/hidepopup/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: hidePopup -slug: Archive/Mozilla/XUL/Méthodes/hidePopup -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/hidePopup ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/hidePopup">hidePopup()</a></code></span></dt><div class="noinclude"> -<dd> Méthode de : <code><a href="/fr/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code></dd></div> -<dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Ferme le popup immédiatement. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/increase/index.html b/files/fr/archive/mozilla/xul/méthodes/increase/index.html deleted file mode 100644 index c2308982af..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/increase/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: increase -slug: Archive/Mozilla/XUL/Méthodes/increase -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/increase ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<div class="noinclude"> - <dl> - <dd> - Méthode de : <code><a href="/fr/docs/Mozilla/Tech/XUL/scale" title="scale">scale</a></code> <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code></dd> - </dl> -</div> -<dl> - <dt> - <span id="m-increase"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/increase">increase()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Augmente la valeur de <magic name="\"PAGENAME\"/">la boîte numérique, XUL:scale = l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> -<p> </p> -<div class="noinclude"> - </div> diff --git a/files/fr/archive/mozilla/xul/méthodes/increasepage/index.html b/files/fr/archive/mozilla/xul/méthodes/increasepage/index.html deleted file mode 100644 index 9d3cbac780..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/increasepage/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: increasePage -slug: Archive/Mozilla/XUL/Méthodes/increasePage -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/increasePage ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-increasePage"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/increasePage">increasePage()</a></code></span></dt><div class="noinclude"> -<dd> Méthode de : <code><a href="/fr/docs/Mozilla/Tech/XUL/scale" title="scale">scale</a></code></dd></div> -<dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Augmente la valeur de l'échelle de la valeur de <code>pageIncrement</code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/index.html b/files/fr/archive/mozilla/xul/méthodes/index.html deleted file mode 100644 index 72e3cb3146..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/index.html +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Méthodes -slug: Archive/Mozilla/XUL/Méthodes -tags: - - Aide_pour_les_éditeurs_de_MDC - - Méthodes_XUL - - Traduction_en_cours -translation_of: Archive/Mozilla/XUL/Method ---- -<p><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></p> -<ul> - <li><a href="/fr/docs/XUL/Method/acceptDialog">acceptDialog</a></li> - <li><a href="/fr/docs/XUL/Method/addItemToSelection">addItemToSelection</a></li> - <li><a href="/fr/docs/XUL/Method/addPane">addPane</a></li> - <li><a href="/fr/docs/XUL/Method/addProgressListener">addProgressListener</a></li> - <li><a href="/fr/docs/XUL/Method/addSession">addSession</a></li> - <li><a href="/fr/docs/XUL/Method/addTab">addTab</a></li> - <li><a href="/fr/docs/XUL/Method/AddTabsProgressListener">addTabsProgressListener</a></li> - <li><a href="/fr/docs/XUL/Method/advance">advance</a></li> - <li><a href="/fr/docs/XUL/Method/advanceSelectedTab">advanceSelectedTab</a></li> - <li><a href="/fr/docs/XUL/Method/appendCustomToolbar">appendCustomToolbar</a></li> - <li><a href="/fr/docs/XUL/Method/appendGroup">appendGroup</a></li> - <li><a href="/fr/docs/XUL/Method/appendItem">appendItem</a></li> - <li><a href="/fr/docs/XUL/Method/appendNotification">appendNotification</a></li> - <li><a href="/fr/docs/XUL/Method/blur">blur</a></li> - <li><a href="/fr/docs/XUL/Method/cancel">cancel</a></li> - <li><a href="/fr/docs/XUL/Method/cancelDialog">cancelDialog</a></li> - <li><a href="/fr/docs/XUL/Method/centerWindowOnScreen">centerWindowOnScreen</a></li> - <li><a href="/fr/docs/XUL/Method/checkAdjacentElement">checkAdjacentElement</a></li> - <li><a href="/fr/docs/XUL/Method/clearResults">clearResults</a></li> - <li><a href="/fr/docs/XUL/Method/clearSelection">clearSelection</a></li> - <li><a href="/fr/docs/XUL/Method/click">click</a></li> - <li><a href="/fr/docs/XUL/Method/close">close</a></li> - <li><a href="/fr/docs/XUL/Method/collapseToolbar">collapseToolbar</a></li> - <li><a href="/fr/docs/XUL/Method/contains">contains</a></li> - <li><a href="/fr/docs/XUL/Method/decrease">decrease</a></li> - <li><a href="/fr/docs/XUL/Method/decreasePage">decreasePage</a></li> - <li><a href="/fr/docs/XUL/Method/doCommand">doCommand</a></li> - <li><a href="/fr/docs/XUL/Method/ensureElementIsVisible">ensureElementIsVisible</a></li> - <li><a href="/fr/docs/XUL/Method/ensureIndexIsVisible">ensureIndexIsVisible</a></li> - <li><a href="/fr/docs/XUL/Method/ensureSelectedElementIsVisible">ensureSelectedElementIsVisible</a></li> - <li><a href="/fr/docs/XUL/Method/expandToolbar">expandToolbar</a></li> - <li><a href="/fr/docs/XUL/Method/extra1">extra1</a></li> - <li><a href="/fr/docs/XUL/Method/extra2">extra2</a></li> - <li><a href="/fr/docs/XUL/Method/focus">focus</a></li> - <li><a href="/fr/docs/XUL/Method/getBrowserAtIndex">getBrowserAtIndex</a></li> - <li><a href="/fr/docs/XUL/Method/getBrowserForDocument">getBrowserForDocument</a></li> - <li><a href="/fr/docs/XUL/Method/getBrowserForTab">getBrowserForTab</a></li> - <li><a href="/fr/docs/XUL/Method/getBrowserIndexForDocument">getBrowserIndexForDocument</a></li> - <li><a href="/fr/docs/XUL/Method/getButton">getButton</a></li> - <li><a href="/fr/docs/XUL/Method/getDefaultSession">getDefaultSession</a></li> - <li><a href="/fr/docs/XUL/Method/getEditor">getEditor</a></li> - <li><a href="/fr/docs/XUL/Method/getElementsByAttribute">getElementsByAttribute</a></li> - <li><a href="/fr/docs/XUL/Method/getElementsByAttributeNS">getElementsByAttributeNS</a></li> - <li><a href="/fr/docs/XUL/Method/getFormattedString">getFormattedString</a></li> - <li><a href="/fr/docs/XUL/Method/getHTMLEditor">getHTMLEditor</a></li> - <li><a href="/fr/docs/XUL/Method/getIndexOfFirstVisibleRow">getIndexOfFirstVisibleRow</a></li> - <li><a href="/fr/docs/XUL/Method/getIndexOfItem">getIndexOfItem</a></li> - <li><a href="/fr/docs/XUL/Method/getItemAtIndex">getItemAtIndex</a></li> - <li><a href="/fr/docs/XUL/Method/getNextItem">getNextItem</a></li> - <li><a href="/fr/docs/XUL/Method/getNotificationBox">getNotificationBox</a></li> - <li><a href="/fr/docs/XUL/Method/getNotificationWithValue">getNotificationWithValue</a></li> - <li><a href="/fr/docs/XUL/Method/getNumberOfVisibleRows">getNumberOfVisibleRows</a></li> - <li><a href="/fr/docs/XUL/Method/getPageById">getPageById</a></li> - <li><a href="/fr/docs/XUL/Method/getPreviousItem">getPreviousItem</a></li> - <li><a href="/fr/docs/XUL/Method/getResultAt">getResultAt</a></li> - <li><a href="/fr/docs/XUL/Method/getResultCount">getResultCount</a></li> - <li><a href="/fr/docs/XUL/Method/getResultValueAt">getResultValueAt</a></li> - <li><a href="/fr/docs/XUL/Method/getRowCount">getRowCount</a></li> - <li><a href="/fr/docs/XUL/Method/getSearchAt">getSearchAt</a></li> - <li><a href="/fr/docs/XUL/Method/getSelectedItem">getSelectedItem</a></li> - <li><a href="/fr/docs/XUL/Method/getSession">getSession</a></li> - <li><a href="/fr/docs/XUL/Method/getSessionByName">getSessionByName</a></li> - <li><a href="/fr/docs/XUL/Method/getSessionResultAt">getSessionResultAt</a></li> - <li><a href="/fr/docs/XUL/Method/getSessionStatusAt">getSessionStatusAt</a></li> - <li><a href="/fr/docs/XUL/Method/getSessionValueAt">getSessionValueAt</a></li> - <li><a href="/fr/docs/XUL/Method/getString">getString</a></li> - <li><a href="/fr/docs/XUL/Method/goBack">goBack</a></li> - <li><a href="/fr/docs/XUL/Method/goBackGroup">goBackGroup</a></li> - <li><a href="/fr/docs/XUL/Method/goDown">goDown</a></li> - <li><a href="/fr/docs/XUL/Method/goForward">goForward</a></li> - <li><a href="/fr/docs/XUL/Method/goForwardGroup">goForwardGroup</a></li> - <li><a href="/fr/docs/XUL/Method/goHome">goHome</a></li> - <li><a href="/fr/docs/XUL/Method/goTo">goTo</a></li> - <li><a href="/fr/docs/XUL/Method/gotoIndex">gotoIndex</a></li> - <li><a href="/fr/docs/XUL/Method/goUp">goUp</a></li> - <li><a href="/fr/docs/XUL/Method/hidePopup">hidePopup</a></li> - <li><a href="/fr/docs/XUL/Method/increase">increase</a></li> - <li><a href="/fr/docs/XUL/Method/increasePage">increasePage</a></li> - <li><a href="/fr/docs/XUL/Method/insertItem">insertItem</a></li> - <li><a href="/fr/docs/XUL/Method/insertItemAt">insertItemAt</a></li> - <li><a href="/fr/docs/XUL/Method/invertSelection">invertSelection</a></li> - <li><a href="/fr/docs/XUL/Method/loadGroup">loadGroup</a></li> - <li><a href="/fr/docs/XUL/Method/loadOneTab">loadOneTab</a></li> - <li><a href="/fr/docs/XUL/Method/loadTabs">loadTabs</a></li> - <li><a href="/fr/docs/XUL/Method/loadURI">loadURI</a></li> - <li><a href="/fr/docs/XUL/Method/loadURIWithFlags">loadURIWithFlags</a></li> - <li><a href="/fr/docs/XUL/Method/makeEditable">makeEditable</a></li> - <li><a href="/fr/docs/XUL/Method/moveByOffset">moveByOffset</a></li> - <li><a href="/fr/docs/XUL/Method/moveTo">moveTo</a></li> - <li><a href="/fr/docs/XUL/Method/moveToAlertPosition">moveToAlertPosition</a></li> - <li><a href="/fr/docs/XUL/Method/onSearchComplete">onSearchComplete</a></li> - <li><a href="/fr/docs/XUL/Method/onTextEntered">onTextEntered</a></li> - <li><a href="/fr/docs/XUL/Method/onTextReverted">onTextReverted</a></li> - <li><a href="/fr/docs/XUL/Method/openPopup">openPopup</a></li> - <li><a href="/fr/docs/XUL/Method/openPopupAtScreen">openPopupAtScreen</a></li> - <li><a href="/fr/docs/XUL/Method/openSubDialog">openSubDialog</a></li> - <li><a href="/fr/docs/XUL/Method/openWindow">openWindow</a></li> - <li><a href="/fr/docs/XUL/Method/preferenceForElement">preferenceForElement</a></li> - <li><a href="/fr/docs/XUL/Method/reload">reload</a></li> - <li><a href="/fr/docs/XUL/Method/reloadAllTabs">reloadAllTabs</a></li> - <li><a href="/fr/docs/XUL/Method/reloadTab">reloadTab</a></li> - <li><a href="/fr/docs/XUL/Method/reloadWithFlags">reloadWithFlags</a></li> - <li><a href="/fr/docs/XUL/Method/removeAllItems">removeAllItems</a></li> - <li><a href="/fr/docs/XUL/Method/removeAllNotifications">removeAllNotifications</a></li> - <li><a href="/fr/docs/XUL/Method/removeAllTabsBut">removeAllTabsBut</a></li> - <li><a href="/fr/docs/XUL/Method/removeCurrentNotification">removeCurrentNotification</a></li> - <li><a href="/fr/docs/XUL/Method/removeCurrentTab">removeCurrentTab</a></li> - <li><a href="/fr/docs/XUL/Method/removeItemAt">removeItemAt</a></li> - <li><a href="/fr/docs/XUL/Method/removeItemFromSelection">removeItemFromSelection</a></li> - <li><a href="/fr/docs/XUL/Method/removeNotification">removeNotification</a></li> - <li><a href="/fr/docs/XUL/Method/removeProgressListener">removeProgressListener</a></li> - <li><a href="/fr/docs/XUL/Method/removeSession">removeSession</a></li> - <li><a href="/fr/docs/XUL/Method/removeTab">removeTab</a></li> - <li><a href="/fr/docs/XUL/Method/RemoveTabsProgressListener">removeTabsProgressListener</a></li> - <li><a href="/fr/docs/XUL/Method/removeTransientNotifications">removeTransientNotifications</a></li> - <li><a href="/fr/docs/XUL/Method/replaceGroup">replaceGroup</a></li> - <li><a href="/fr/docs/XUL/Method/reset">reset</a></li> - <li><a href="/fr/docs/XUL/Method/rewind">rewind</a></li> - <li><a href="/fr/docs/XUL/Method/scrollByIndex">scrollByIndex</a></li> - <li><a href="/fr/docs/XUL/Method/scrollByPixels">scrollByPixels</a></li> - <li><a href="/fr/docs/XUL/Method/scrollToIndex">scrollToIndex</a></li> - <li><a href="/fr/docs/XUL/Method/select">select</a></li> - <li><a href="/fr/docs/XUL/Method/selectAll">selectAll</a></li> - <li><a href="/fr/docs/XUL/Method/selectItem">selectItem</a></li> - <li><a href="/fr/docs/XUL/Method/selectItemRange">selectItemRange</a></li> - <li><a href="/fr/docs/XUL/Method/selectTabAtIndex">selectTabAtIndex</a></li> - <li><a href="/fr/docs/XUL/Method/setSelectionRange">setSelectionRange</a></li> - <li><a href="/fr/docs/XUL/Method/showPane">showPane</a></li> - <li><a href="/fr/docs/XUL/Method/showPopup">showPopup</a></li> - <li><a href="/fr/docs/XUL/Method/sizeTo">sizeTo</a></li> - <li><a href="/fr/docs/XUL/Method/startEditing">startEditing</a></li> - <li><a href="/fr/docs/XUL/Method/stop">stop</a></li> - <li><a href="/fr/docs/XUL/Method/stopEditing">stopEditing</a></li> - <li><a href="/fr/docs/XUL/Method/SwapDocShells">swapDocShells</a></li> - <li><a href="/fr/docs/XUL/Method/syncSessions">syncSessions</a></li> - <li><a href="/fr/docs/XUL/Method/timedSelect">timedSelect</a></li> - <li><a href="/fr/docs/XUL/Method/toggleItemSelection">toggleItemSelection</a></li> -</ul> -<h3 id="Related_DOM_element_methods" name="Related_DOM_element_methods">Related DOM element methods</h3> -<ul> - <li><a href="/fr/docs/DOM/element.addEventListener">DOM:element.addEventListener</a></li> - <li><a href="/fr/docs/DOM/Node.appendChild">DOM:element.appendChild</a></li> - <li><a href="/fr/docs/DOM/Node.compareDocumentPosition">DOM:element.compareDocumentPosition</a></li> - <li><a href="/fr/docs/DOM/element.dispatchEvent">DOM:element.dispatchEvent</a></li> - <li><a href="/fr/docs/DOM/element.getAttribute">DOM:element.getAttribute</a></li> - <li><a href="/fr/docs/DOM/element.getAttributeNode">DOM:element.getAttributeNode</a></li> - <li><a href="/fr/docs/DOM/element.getAttributeNodeNS">DOM:element.getAttributeNodeNS</a></li> - <li><a href="/fr/docs/DOM/element.getAttributeNS">DOM:element.getAttributeNS</a></li> - <li><a href="/fr/docs/DOM/element.getElementsByTagName">DOM:element.getElementsByTagName</a></li> - <li><a href="/fr/docs/DOM/element.getElementsByTagNameNS">DOM:element.getElementsByTagNameNS</a></li> - <li><a href="/fr/docs/DOM/Node.getFeature">DOM:element.getFeature</a> <span class="inlineIndicator todo todoInline"><strong>FIXME:</strong> <em>brokenLink</em></span></li> - <li><a href="/fr/docs/DOM/Node.getUserData">DOM:element.getUserData</a></li> - <li><a href="/fr/docs/DOM/element.hasAttribute">DOM:element.hasAttribute</a></li> - <li><a href="/fr/docs/DOM/element.hasAttributeNS">DOM:element.hasAttributeNS</a></li> - <li><a href="/fr/docs/DOM/Node.hasAttributes">DOM:element.hasAttributes</a></li> - <li><a href="/fr/docs/DOM/Node.hasChildNodes">DOM:element.hasChildNodes</a></li> - <li><a href="/fr/docs/DOM/Node.insertBefore">DOM:element.insertBefore</a></li> - <li><a href="/fr/docs/DOM/Node.isEqualNode">DOM:element.isEqualNode</a></li> - <li><a href="/fr/docs/DOM/Node.isSameNode">DOM:element.isSameNode</a></li> - <li><a href="/fr/docs/DOM/Node.isSupported">DOM:element.isSupported</a></li> - <li><a href="/fr/docs/DOM/Node.lookupNamespaceURI">DOM:element.lookupNamespaceURI</a></li> - <li><a href="/fr/docs/DOM/Node.lookupPrefix">DOM:element.lookupPrefix</a></li> - <li><a href="/fr/docs/DOM/Node.normalize">DOM:element.normalize</a></li> - <li><a href="/fr/docs/DOM/element.removeAttribute">DOM:element.removeAttribute</a></li> - <li><a href="/fr/docs/DOM/element.removeAttributeNode">DOM:element.removeAttributeNode</a></li> - <li><a href="/fr/docs/DOM/element.removeAttributeNS">DOM:element.removeAttributeNS</a></li> - <li><a href="/fr/docs/DOM/Node.removeChild">DOM:element.removeChild</a></li> - <li><a href="/fr/docs/DOM/element.removeEventListener">DOM:element.removeEventListener</a></li> - <li><a href="/fr/docs/DOM/Node.replaceChild">DOM:element.replaceChild</a></li> - <li><a href="/fr/docs/DOM/element.setAttribute">DOM:element.setAttribute</a></li> - <li><a href="/fr/docs/DOM/element.setAttributeNode">DOM:element.setAttributeNode</a></li> - <li><a href="/fr/docs/DOM/element.setAttributeNodeNS">DOM:element.setAttributeNodeNS</a></li> - <li><a href="/fr/docs/DOM/element.setAttributeNS">DOM:element.setAttributeNS</a></li> - <li><a href="/fr/docs/DOM/Node.setUserData">DOM:element.setUserData</a></li> -</ul> diff --git a/files/fr/archive/mozilla/xul/méthodes/moveto/index.html b/files/fr/archive/mozilla/xul/méthodes/moveto/index.html deleted file mode 100644 index af8c9b8a47..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/moveto/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: moveTo -slug: Archive/Mozilla/XUL/Méthodes/moveTo -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/moveTo ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-moveTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/moveTo">moveTo( x, y )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Déplace le popup vers un nouvel emplacement. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/openpopup/index.html b/files/fr/archive/mozilla/xul/méthodes/openpopup/index.html deleted file mode 100644 index 0dbebe88b9..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/openpopup/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: openPopup -slug: Archive/Mozilla/XUL/Méthodes/openPopup -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/openPopup ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup( anchor , position , x , y , isContextMenu, attributesOverride )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique. -</p><p>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 <code>anchor</code> et définissez la <code>position</code> par une chaîne indiquant la manière dont le popup doit être ancré. -</p><p>Les valeurs possibles pour le paramètre <code>position</code> sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer -</p><p>Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup. -</p><p>Si le paramètre <code>attributesOverride</code> vaut <code>true</code>, l'attribut <code>position</code> sur le nœud popup a priorité sur la valeur du paramètre <code>position</code>. Si <code>attributesOverride</code> vaut <code>false</code>, l'attribut n'est utilisé que si le paramètre <code>position</code> est vide. -</p><p>Pour un popup ancré, les paramètres <code>x</code> et <code>y</code> peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS). -</p><p>Les popups non ancrés peuvent être créés en fournissant <code>null</code> comme paramètre <code>anchor</code>. Un popup non ancré apparait à la position spécifiée par <code>x</code> et <code>y</code> relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres <code>position</code> et <code>attributesOverride</code> sont ignorés. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/openpopupatscreen/index.html b/files/fr/archive/mozilla/xul/méthodes/openpopupatscreen/index.html deleted file mode 100644 index 56e83bb9c6..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/openpopupatscreen/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: openPopupAtScreen -slug: Archive/Mozilla/XUL/Méthodes/openPopupAtScreen -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/openPopupAtScreen ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-openPopupAtScreen"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopupAtScreen">openPopupAtScreen( x, y, isContextMenu )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup à une position spécifique sur l'écran spécifiée par <code>x</code> et <code>y</code>. 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 <code>x</code> et <code>y</code> sont mesurées en pixels CSS. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/reset/index.html b/files/fr/archive/mozilla/xul/méthodes/reset/index.html deleted file mode 100644 index 2e573454aa..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/reset/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: reset -slug: Archive/Mozilla/XUL/Méthodes/reset -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/reset ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-reset"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/reset">reset()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur renvoyée</i> -</dd><dd> Réinitialise la préférence à sa valeur par défaut. -</dd><dd> Pour un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, la liste de transactions d'annulation est également vidée (Gecko 1.9). -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/select/index.html b/files/fr/archive/mozilla/xul/méthodes/select/index.html deleted file mode 100644 index 79d85de4e9..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/select/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: select -slug: Archive/Mozilla/XUL/Méthodes/select -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/select ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-select"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/select">select()</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Sélectionne l'intégralité du texte d'une boîte texte. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/selectall/index.html b/files/fr/archive/mozilla/xul/méthodes/selectall/index.html deleted file mode 100644 index ff10b60952..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/selectall/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selectAll -slug: Archive/Mozilla/XUL/Méthodes/selectAll -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/selectAll ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-selectAll"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/selectitem/index.html b/files/fr/archive/mozilla/xul/méthodes/selectitem/index.html deleted file mode 100644 index 2131fd8738..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/selectitem/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selectItem -slug: Archive/Mozilla/XUL/Méthodes/selectItem -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/selectItem ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-selectItem"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/selectitemrange/index.html b/files/fr/archive/mozilla/xul/méthodes/selectitemrange/index.html deleted file mode 100644 index 36913d700c..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/selectitemrange/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selectItemRange -slug: Archive/Mozilla/XUL/Méthodes/selectItemRange -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/selectItemRange ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-selectItemRange"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/setselectionrange/index.html b/files/fr/archive/mozilla/xul/méthodes/setselectionrange/index.html deleted file mode 100644 index 6a527b231f..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/setselectionrange/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: setSelectionRange -slug: Archive/Mozilla/XUL/Méthodes/setSelectionRange -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/setSelectionRange ---- -<p><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span> -</p> -<dl><dt> <span id="m-setSelectionRange"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/setSelectionRange">setSelectionRange( début, fin )</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Cette méthode sélectionne une portion de texte dans une zone de texte (<i>textbox</i> ou <i>textarea</i>) où l'argument <var>début</var> est le premier caractère de la sélection et l'argument <var>fin</var> le dernier caractère de la sélection. </dd><dd> Renseigner les deux arguments avec la même valeur équivaut à déplacer le curseur d'écriture sans rien sélectionner. -</dd></dl> -<p><br> -<span class="comment">Interwiki Language Links</span> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/showpane/index.html b/files/fr/archive/mozilla/xul/méthodes/showpane/index.html deleted file mode 100644 index fdb76134d5..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/showpane/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: showPane -slug: Archive/Mozilla/XUL/Méthodes/showPane -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/showPane ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-showPane"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/showPane">showPane( <i>prefpane</i> )</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Bascule vers un panneau en particulier. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/showpopup/index.html b/files/fr/archive/mozilla/xul/méthodes/showpopup/index.html deleted file mode 100644 index f320227bdb..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/showpopup/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: showPopup -slug: Archive/Mozilla/XUL/Méthodes/showPopup -tags: - - Méthodes_XUL - - NeedsRewrite - - NeedsTechnicalReview -translation_of: Archive/Mozilla/XUL/Method/showPopup ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/showPopup">showPopup( element, x, y, popupType, anchor, align )</a></code></span> <span style="border: 1px solid #9898F0; background-color: #DDDDFF; font-size: 9px; vertical-align: text-top;">Déprécié dans Mozilla 1.9</span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> 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 <var>x</var> ou <var>y</var> sont définies par une valeur, le popup apparaîtra aux coordonnées (<var>x</var>,<var>y</var>) de l'écran. Si <var>x</var> et <var>y</var> sont définies à <code>-1</code>, le popup sera positionné par rapport à l'<var>element</var> 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 <var>anchor</var> et <var>align</var> peuvent être utilisés pour contrôler plus avant l'endroit où apparaîtra le popup par rapport à l'élément. Le paramètre <var>anchor</var> correspond à l'attribut <code id="a-popupanchor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupanchor">popupanchor</a></code> de l'élément et le paramètre <var>align</var> correspond à l'attribut <code id="a-popupalign"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupalign">popupalign</a></code>. Les paramètres <var>anchor</var> et <var>align</var> sont ignorés si ni <var>x</var> ni <var>y</var> ne valent <code>-1</code>. -</dd></dl> -<dl><dd> 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>.screenX et <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>.screenY, et utilisez celles-ci comme paramètres <var>x</var> et <var>y</var> en y ajoutant les décalages souhaités. -</dd></dl> -<dl><dd> Le paramètre <var>popupType</var> doit être une des chaînes <code>popup</code>, <code>context</code> ou <code>tooltip</code>. 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. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/sizeto/index.html b/files/fr/archive/mozilla/xul/méthodes/sizeto/index.html deleted file mode 100644 index 162f0dab6a..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/sizeto/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: sizeTo -slug: Archive/Mozilla/XUL/Méthodes/sizeTo -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/sizeTo ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-sizeTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/sizeTo">sizeTo( <i>largeur</i>, <i>hauteur</i> )</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Modifie la taille actuelle de la fenêtre popup avec les nouvelles dimensions <var>largeur</var> et <var>hauteur</var>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/stop/index.html b/files/fr/archive/mozilla/xul/méthodes/stop/index.html deleted file mode 100644 index 673344cdcf..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/stop/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: stop -slug: Archive/Mozilla/XUL/Méthodes/stop -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/stop ---- -<div class="noinclude"> -<p><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span> -</p> -</div> -<dl><dt> <span id="m-stop"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/stop">stop()</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Équivalent au clic sur le bouton <i>Stop</i>, cette méthode arrête le chargement en cours du document. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/syncsessions/index.html b/files/fr/archive/mozilla/xul/méthodes/syncsessions/index.html deleted file mode 100644 index de76541536..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/syncsessions/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: syncSessions -slug: Archive/Mozilla/XUL/Méthodes/syncSessions -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/syncSessions ---- -<div class="noinclude"> -<p><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span> -</p> -</div> -<dl><dt> <span id="m-syncSessions"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/syncSessions">syncSessions( autoCompleteElement )</a></code></span> -</dt><dd> Type retourné : <i>???</i> -</dd><dd> Copie les sessions depuis un autre élément autocomplété. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/timedselect/index.html b/files/fr/archive/mozilla/xul/méthodes/timedselect/index.html deleted file mode 100644 index 2a30e67317..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/timedselect/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: timedSelect -slug: Archive/Mozilla/XUL/Méthodes/timedSelect -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/timedSelect ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-timedSelect"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/méthodes/toggleitemselection/index.html b/files/fr/archive/mozilla/xul/méthodes/toggleitemselection/index.html deleted file mode 100644 index d6dac62e00..0000000000 --- a/files/fr/archive/mozilla/xul/méthodes/toggleitemselection/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: toggleItemSelection -slug: Archive/Mozilla/XUL/Méthodes/toggleItemSelection -tags: - - Méthodes_XUL -translation_of: Archive/Mozilla/XUL/Method/toggleItemSelection ---- -<div class="noinclude"><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <span id="m-toggleItemSelection"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/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> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/panel/index.html b/files/fr/archive/mozilla/xul/panel/index.html deleted file mode 100644 index 64daec52df..0000000000 --- a/files/fr/archive/mozilla/xul/panel/index.html +++ /dev/null @@ -1,222 +0,0 @@ ---- -title: panel -slug: Archive/Mozilla/XUL/panel -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/panel ---- -<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>Un <code>panel</code> est une fenêtre popup pouvant contenir n'importe quel type de contenu. Il n'a aucune décoration de fenêtre. Lorsqu'il est ouvert, il flotte par dessus la fenêtre et peut déborder même de la fenêtre principale. Typiquement, il sera attaché à un élément à l'aide de l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> afin d'apparaitre lorsque l'on clique avec le bouton de gauche de la souris sur l'élément. Un <code>panel</code> peut également être ouvert via un script à l'aide de la méthode <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/openPopup">openPopup</a></code></span>. -</p><p>Le <code>panel</code> sera fermé lorsque l'utilisateur cliquera en dehors de celui-ci ou que sa méthode <span id="m-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/hidePopup">hidePopup</a></code></span> sera appelée. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-popup.left">left</a>, <a href="#a-noautofocus">noautofocus</a>, <a href="#a-onpopuphidden">onpopuphidden</a>, <a href="#a-onpopuphiding">onpopuphiding</a>, <a href="#a-onpopupshowing">onpopupshowing</a>, <a href="#a-onpopupshown">onpopupshown</a>, <a href="#a-popup.position">position</a>, <a href="#a-popup.top">top</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessible">accessible</a>, <a href="#p-popupBoxObject">popupBoxObject</a>, <a href="#p-popup">popup</a>, <a href="#p-state">state</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-hidePopup">hidePopup</a>, <a href="#m-moveTo">moveTo</a>, <a href="#m-openPopup">openPopup</a>, <a href="#m-openPopupAtScreen">openPopupAtScreen</a>, <a href="#m-sizeTo">sizeTo</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>L'exemple qui suit montre comment un <code>panel</code> peut être attaché à un label. -</p> -<pre><panel id="thepanel"> - <hbox align="start"> - <image src="warning.png"/> - <vbox> - <description value="Vous avez 6 nouveaux messages."/> - <hbox> - <button label="Lire le courrier"/> - <button label="Nouveau message"/> - </hbox> - </vbox> - </hbox> -</panel> -<description value="6 nouveaux messages" popup="thepanel"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-popup.left"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.left">left</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position horizontale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-noautofocus"> - -<dl><dt> <a href="fr/XUL/Attributs/noautofocus">noautofocus</a> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si mis à <code>false</code>, la valeur par défaut, l'élément ayant actuellement le focus le perdra si le popup est ouvert ou fermé. Si mis à <code>true</code>, le focus ne sera pas modifié. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-onpopuphidden"> - -<dl><dt> <code id="a-onpopuphidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphidden">onpopuphidden</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après qu'il a été caché. <span class="comment"><a class=" external" href="http://www.langue-fr.net/index/A/apres-que.htm" rel="freelink">http://www.langue-fr.net/index/A/apres-que.htm</a></span> -</dd></dl> - - -</div> -<div id="a-onpopuphiding"> - -<dl><dt> <code id="a-onpopuphiding"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphiding">onpopuphiding</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué. -</dd></dl> - - -</div> -<div id="a-onpopupshowing"> - -<dl><dt> <code id="a-onpopupshowing"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshowing">onpopupshowing</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> 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 <code>false</code>, le popup ne s'affichera pas. -</dd></dl> - - -</div> -<div id="a-onpopupshown"> - -<dl><dt> <code id="a-onpopupshown"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshown">onpopupshown</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement <code>onload</code> est envoyé à une fenêtre à son ouverture. -</dd></dl> - - -</div> -<div id="a-popup.position"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.position">position</a> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'attribut <code>position</code> 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. -</dd></dl> -<ul><li> <code>after_start</code> : Le popup apparait en dessous l'élément avec le coin supérieur gauche du popup aligné avec le coin inférieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. Cette valeur est typiquement uilisée pour les menus déroulants. -</li><li> <code>after_end</code> : Le popup apparait en dessous l'élément avec le coin supérieur droit du popup aligné avec le coin inférieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_start</code> : Le popup apparait au dessus de l'élément avec le coin inférieur gauche du popup aligné avec le coin supérieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_end</code> : Le popup apparait au dessus de l'élément avec le coin inférieur droit du popup aligné avec le coin supérieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_after</code> : Le popup apparait à la droite de l'élément avec le coin inférieur gauche du popup aligné avec le coin inférieur droit de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_before</code> : Le popup apparait à la droite de l'élément avec le coin supérieur gauche du popup aligné avec le coin supérieur droit de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_after</code> : Le popup apparait à la gauche de l'élément avec le coin inférieur droit du popup aligné avec le coin inférieur gauche de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_before</code> : Le popup apparait à la gauche de l'élément avec le coin supérieur droit du popup aligné avec le coin supérieur gauche de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>overlap</code> : Le popup apparait par dessus l'élément avec les coins supérieurs gauches alignés. -</li><li> <code>at_pointer</code> : Le popup apparait à la position du pointeur de la souris. -</li><li> <code>after_pointer</code> : Le popup apparait à la même position horizontale que le pointeur de la souris, mais verticalement, il est placé juste sous l'élément. -</li></ul> - - -</div> -<div id="a-popup.top"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.top">top</a> -</dt><dd> Type : <i>entier</i> -</dd><dd> Remplace la position verticale du popup spécifiée par la méthode <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup</a></code></span>. -</dd></dl> -<p><br> -</p> - - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-accessible"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-popupBoxObject"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/popupBoxObject">popupBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a></i> -</dd><dd> Cette propriété en lecture seule conserve le <a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a> 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. -</dd></dl> - -</div> -<div id="p-position"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/position">position</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Obtient et définit la valeur de l'attribut <a href="fr/XUL/Attributs/popup.position">position</a>. -</dd></dl> - -</div> -<div id="p-state"> -<dl><dt> <code><span><a href="http://api/fr/docs/XUL/Propri%C3%A9t%C3%A9s/state">state</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Cette propriété en lecture seule indique si le popup est ouvert ou non. Quatre valeurs sont possibles : -</dd></dl> -<ul><li> <code>closed</code> : Le popup est fermé et non visible. -</li><li> <code>open</code> : Le popup est ouvert et visible sur l'écran. -</li><li> <code>showing</code> : Une requête a été faite pour ouvrir le popup, mais il n'a pas encore été affiché. Cet état se produit durant l'évènement <code>popupshowing</code>. -</li><li> <code>hiding</code> : Le popup est sur le point d'être masqué. Cet état se produit durant l'évènement <code>popuphiding</code>. -</li></ul> - -</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-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/hidePopup">hidePopup()</a></code></span></dt> -<dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Ferme le popup immédiatement. -</dd></dl> -<dl><dt> <span id="m-moveTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/moveTo">moveTo( x, y )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Déplace le popup vers un nouvel emplacement. -</dd></dl> -<dl><dt> <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopup">openPopup( anchor , position , x , y , isContextMenu, attributesOverride )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique. -</p><p>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 <code>anchor</code> et définissez la <code>position</code> par une chaîne indiquant la manière dont le popup doit être ancré. -</p><p>Les valeurs possibles pour le paramètre <code>position</code> sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer -</p><p>Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup. -</p><p>Si le paramètre <code>attributesOverride</code> vaut <code>true</code>, l'attribut <code>position</code> sur le nœud popup a priorité sur la valeur du paramètre <code>position</code>. Si <code>attributesOverride</code> vaut <code>false</code>, l'attribut n'est utilisé que si le paramètre <code>position</code> est vide. -</p><p>Pour un popup ancré, les paramètres <code>x</code> et <code>y</code> peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS). -</p><p>Les popups non ancrés peuvent être créés en fournissant <code>null</code> comme paramètre <code>anchor</code>. Un popup non ancré apparait à la position spécifiée par <code>x</code> et <code>y</code> relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres <code>position</code> et <code>attributesOverride</code> sont ignorés. -</p> -<dl><dt> <span id="m-openPopupAtScreen"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopupAtScreen">openPopupAtScreen( x, y, isContextMenu )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup à une position spécifique sur l'écran spécifiée par <code>x</code> et <code>y</code>. 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 <code>x</code> et <code>y</code> sont mesurées en pixels CSS. -</p> -<dl><dt> <span id="m-sizeTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/sizeTo">sizeTo( <i>largeur</i>, <i>hauteur</i> )</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Modifie la taille actuelle de la fenêtre popup avec les nouvelles dimensions <var>largeur</var> et <var>hauteur</var>. -</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/NsIDOMXULPopupElement">nsIDOMXULPopupElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/popup/index.html b/files/fr/archive/mozilla/xul/popup/index.html deleted file mode 100644 index 4ee85f8e85..0000000000 --- a/files/fr/archive/mozilla/xul/popup/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: popup -slug: Archive/Mozilla/XUL/popup -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/popup ---- -<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>L'élément <code>popup</code> est équivalent à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> qu'il vaut mieux utiliser. Consultez la documentation sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> pour plus d'informations. -</p><p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/preference/index.html b/files/fr/archive/mozilla/xul/preference/index.html deleted file mode 100644 index ba56b6bb08..0000000000 --- a/files/fr/archive/mozilla/xul/preference/index.html +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: preference -slug: Archive/Mozilla/XUL/preference -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/preference ---- -<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>Déclare une préférence qui peut être ajustée dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code>. Cet élément doit être placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code>. Chaque élément <code>preference</code> correspond à une préférence qui est stockée dans le fichier de préférences de l'utilisateur. Il est possible de connecter un élément d'interface utilisateur comme une case à cocher à un élément de préférence à l'aide de l'attribut <code id="a-preference"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference">preference</a></code> de l'élément d'interface utilisateur. -</p><p>Pour plus d'informations, consultez l'article <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-instantApply">instantApply</a>, <a href="#a-inverted">inverted</a>, <a href="#a-preference.name">name</a>, <a href="#a-onchange">onchange</a>, <a href="#a-readonly">readonly</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-preference.type">type</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-disabled">disabled</a>, <a href="#p-inverted">inverted</a>, <a href="#p-locked">locked</a>, <a href="#p-name">name</a>, <a href="#p-preference.preferences">preferences</a>, <a href="#p-readonly">readonly</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-type">type</a>, <a href="#p-value">value</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-hasUserValue">hasUserValue</a>, <a href="#m-reset">reset</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-instantApply"> - -<dl><dt> <code id="a-instantApply"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/instantApply">instantApply</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si sa valeur est <code>true</code>, la préférence sera modifiée dès que l'élément d'interface utilisateur est modifié. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-inverted"> - -<dl><dt> <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les préférences booléennes, l'indication de cet attribut à <code>true</code> indique que la valeur de la préférence est l'inverse de celle de l'élément d'interface utilisateur qui y est attaché. Par exemple, elle fait en sorte que cocher une case désactive la préférence associée au lieu de l'activer. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-preference.name"> - -<dl><dt> <a href="fr/XUL/Attributs/preference.name">name</a> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le nom de la préférence à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>. -</dd></dl> - - -</div> -<div id="a-onchange"> - -<dl><dt> <code id="a-onchange"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onchange">onchange</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Le code figurant dans l'attribut <code>onchange</code> est appelé lorsque la valeur de l'élément est modifiée. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-readonly"> - -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</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-preference.type"> - -<dl> <dt><a href="/fr/XUL/Attributs/preference.type" title="fr/XUL/Attributs/preference.type">type</a></dt> <dd>Type : <em>une des valeurs ci-dessous</em></dd> <dd>Le type de préférence qui doit être une des valeurs suivantes.</dd> -</dl> -<ul> <li><code>bool</code> : Un booléen défini à <code>true</code> ou <code>false</code>. Habituellement, on connectera un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code> à ce type de préférence.</li> <li><code>int</code> : Un entier</li> <li><code>string</code> : Une chaîne de caractères</li> <li><code>unichar</code> : Une chaîne de caractères Unicode</li> <li><code>wstring</code> : Une chaîne localisée. Dans cette situation, la préférence enregistrera le chemin vers un fichier de propriétés contenant la valeur réelle de la préférence.</li> <li><code>file</code> : Un fichier. Le chemin vers le fichier sera stocké dans la préférence.</li> -</ul> - - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><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-inverted"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/inverted">inverted</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-locked"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/locked">locked</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si définie à <code>true</code>, la préférence a été verrouillée et désactivée dans la configuration système, ce qui empêche de changer sa valeur. Cette propriété est en lecture seule. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-name"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/name">name</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le nom de la préférence (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>) à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-preference.preferences"> -<dl><dt> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preference.preferences">preferences</a> -</dt><dd> Type : <i>élément</i> -</dd><dd> Référence à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> conteneur. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-readonly"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readonly">readonly</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd> - <dd> - <div class="note"> - Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div> - </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-type"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/type">type</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</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> -<dl><dt> <span id="m-hasUserValue"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/hasUserValue">hasUserValue()</a></code></span> -</dt><dd> Type de retour : <i>booléen</i> -</dd><dd> Renvoie <code>true</code> si la préférence a été modifiée par rapport à sa valeur par défaut. -</dd></dl> -<p><br> -</p> -<dl><dt> <span id="m-reset"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/reset">reset()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur renvoyée</i> -</dd><dd> Réinitialise la préférence à sa valeur par défaut. -</dd><dd> Pour un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, la liste de transactions d'annulation est également vidée (Gecko 1.9). -</dd></dl> -<p><br> -</p> -<span class="lang lang-fr" lang="fr"> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire -</p> -<div class="noinclude"> -</div> -</span> diff --git a/files/fr/archive/mozilla/xul/preferences/index.html b/files/fr/archive/mozilla/xul/preferences/index.html deleted file mode 100644 index ac1884d0eb..0000000000 --- a/files/fr/archive/mozilla/xul/preferences/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: preferences -slug: Archive/Mozilla/XUL/preferences -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/preferences ---- -<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>Utilisé pour regrouper un ensemble d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>. -</p><p>Pour plus d'informations, consultez l'article <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>. -</p> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(example needed) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/prefpane/index.html b/files/fr/archive/mozilla/xul/prefpane/index.html deleted file mode 100644 index eb01688a7a..0000000000 --- a/files/fr/archive/mozilla/xul/prefpane/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: prefpane -slug: Archive/Mozilla/XUL/prefpane -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/prefpane ---- -<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>Un seul panneau de préférences dans une <code><a href="/fr/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>. Un <code>prefpane</code> est constitué de deux parties, les descriptions de préférences qui spécifient l'ensemble des préférences à modifier, et l'interface utilisateur permettant d'ajuster ces préférences. La première est spécifiée à l'aide d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> tandis que la seconde peut être spécifiée avec d'autres éléments XUL. -</p><p>Chacune de ces parties peut être spécifiée directement comme enfant de l'élément <code>prefpane</code>, ou l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code> peut être utilisé pour placer un panneau dans un fichier séparé. Dans ce dernier cas, le fichier séparé doit utiliser une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code> comme racine, étant donné qu'il sera chargé comme overlay de la fenêtre de préférences principale. -</p><p>Pour plus d'informations, consultez l'article <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-helpURI">helpURI</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-onpaneload">onpaneload</a>, <a href="#a-prefpane.selected">selected</a>, <a href="#a-prefpane.src">src</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-preferenceElements">preferenceElements</a>, <a href="#p-preferences">preferences</a>, <a href="#p-selected">selected</a>, <a href="#p-src">src</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-preferenceForElement">preferenceForElement</a> </dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-helpURI"> - -<dl> - <dt> - <code id="a-helpURI"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/helpURI">helpURI</a></code></dt> - <dd> - Type : <i>URI</i></dd> - <dd> - L'URI de la page d'aide associée avec un panneau de préférences. Celle-ci sera ouverte dans une fenêtre d'aide lors de l'appui sur le bouton d'aide.</dd> -</dl> -</div> -<div id="a-image"> - -<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> -</dt><dd> Type : <i>URL d'une image</i> -</dd><dd> L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> et <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> - - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-onpaneload"> - -<dl> - <dt> - <code id="a-onpaneload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpaneload">onpaneload</a></code></dt> - <dd> - Type : <i>code de script</i></dd> - <dd> - Le code défini ici est appelé après le chargement du panneau, de manière similaire à l'évènement <code>load</code> pour une fenêtre.</dd> -</dl> -</div> -<div id="a-prefpane.selected"> - -<dl> - <dt> - <a href="fr/XUL/Attributs/prefpane.selected">selected</a></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Cet attribut sera défini à <code>true</code> pour l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> actuellement sélectionné. Pour changer le panneau sélectionné, utilisez la méthode <span id="m-showPane"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPane">showPane</a></code></span> de <code><a href="/fr/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>.</dd> -</dl> - -</div> -<div id="a-prefpane.src"> - -<dl> - <dt> - <a href="fr/XUL/Attributs/prefpane.src">src</a></dt> - <dd> - Type : <i>URL d'un overlay</i></dd> - <dd> - L'URL du contenu du panneau de préférences. Si cet attribut n'est pas spécifié, le contenu de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> sera utilisé.</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-image"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> - -</div> -<div id="p-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-preferenceElements"></div> -<div id="p-preferences"></div> -<div id="p-selected"> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</dd> -</dl></div> -<div id="p-src"></div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p> -<span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/prefwindow/index.html b/files/fr/archive/mozilla/xul/prefwindow/index.html deleted file mode 100644 index 970f7c07a7..0000000000 --- a/files/fr/archive/mozilla/xul/prefwindow/index.html +++ /dev/null @@ -1,144 +0,0 @@ ---- -title: prefwindow -slug: Archive/Mozilla/XUL/prefwindow -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/prefwindow ---- -<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>Une fenêtre spécialisée utilisée pour les dialogues de préférences. Cet élément devrait être utilisé à la place de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> et contenir un ou plusieurs éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code>. Une rangée de boutons apparait dans tout le dialogue de préférences, un par <code>prefpane</code>. Chaque panneau servira généralement à regrouper un ensemble de préférences liées. Si il n'y a qu'un <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code>, la zone de navigation n'apparaitra pas. -</p><p>Sur les plateformes où la convention est d'appliquer les changements immédiatement, les préférences sont ajustées dès que l'élément d'interface utilisateur a changé. Sur les autres plateformes, les préférences ne sont pas appliquées tant que le dialogue n'est pas fermé. -</p><p>Il est possible d'ouvrir une fenêtre de préférences à l'aide de la méthode <code>openDialog</code> d'une fenêtre comme pour d'autres dialogues. L'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> d'un panneau particulier peut être passé comme quatrième paramètre de <code>openDialog</code> pour ouvrir un panneau particulier par défaut. Il est également possible de définir l'attribut <code id="a-lastSelected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/lastSelected">lastSelected</a></code> sur la balise <code>prefwindow</code> en lui donnant l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du panneau avec lequel démarrer. Cet attribut n'est normalement pas défini, comme il sera positionné automatiquement afin que le panneau par défaut soit le dernier que celui qui était affiché la dernière fois que le dialogue a été fermé. -</p><p>Pour plus d'informations, consultez l'article <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-buttonalign">buttonalign</a>, <a href="#a-buttondir">buttondir</a>, <a href="#a-buttonorient">buttonorient</a>, <a href="#a-buttonpack">buttonpack</a>, <a href="#a-buttons">buttons</a>, <a href="#a-defaultButton">defaultButton</a>, <a href="#a-lastSelected">lastSelected</a>, <a href="#a-onbeforeaccept">onbeforeaccept</a>, <a href="#a-ondialogaccept">ondialogaccept</a>, <a href="#a-ondialogcancel">ondialogcancel</a>, <a href="#a-ondialogdisclosure">ondialogdisclosure</a>, <a href="#a-ondialoghelp">ondialoghelp</a>, <a href="#a-onpanelload">onpanelload</a>, <a href="#a-title">title</a>, <a href="#a-type">type</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-buttons">buttons</a>, <a href="#p-currentPane">currentPane</a>, <a href="#p-defaultButton">defaultButton</a>, <a href="#p-lastSelected">lastSelected</a>, <a href="#p-preferencePanes">preferencePanes</a>, <a href="#p-type">type</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-acceptDialog">acceptDialog</a>, <a href="#m-addPane">addPane</a>, <a href="#m-cancelDialog">cancelDialog</a>, <a href="#m-centerWindowOnScreen">centerWindowOnScreen</a>, <a href="#m-getButton">getButton</a>, <a href="#m-openSubDialog">openSubDialog</a>, <a href="#m-openWindow">openWindow</a>, <a href="#m-showPane">showPane</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre class="eval"> <prefwindow xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - <prefpane id="saveoptions" label="Backups"> - <preferences> - <preference id="pref-backup" name="myapp.mybackups" type="bool"/> - <preference id="pref-backupduration" name="myapp.mybackups.duration" type="int"/> - </preferences> - <checkbox label="Automatically Save Backups" preference="pref-backup"/> - <textbox label="Duration:" preference="pref-backupduration"/> - </prefpane> - </prefwindow> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-buttonalign"> - -</div> -<div id="a-buttondir"> - -</div> -<div id="a-buttonorient"> - -</div> -<div id="a-buttonpack"> - -</div> -<div id="a-buttons"> - -</div> -<div id="a-defaultButton"> - -</div> -<div id="a-lastSelected"> - -</div> -<div id="a-onbeforeaccept"> - -</div> -<div id="a-ondialogaccept"> - -</div> -<div id="a-ondialogcancel"> - -</div> -<div id="a-ondialogdisclosure"> - -</div> -<div id="a-ondialoghelp"> - -</div> -<div id="a-onpanelload"> - -</div> -<div id="a-title"> - -<dl><dt> <code id="a-title"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/title">title</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le texte qui doit apparaître dans la barre de titre de la fenêtre ou boîte de dialogue. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-type"> - -<p> </p> -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-buttons"></div> -<div id="p-currentPane"></div> -<div id="p-defaultButton"></div> -<div id="p-lastSelected"></div> -<div id="p-preferencePanes"></div> -<div id="p-type"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/type">type</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</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-showPane"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPane">showPane( <i>prefpane</i> )</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Bascule vers un panneau en particulier. -</dd></dl> -<p><br> -</p> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/accessible/index.html b/files/fr/archive/mozilla/xul/propriétés/accessible/index.html deleted file mode 100644 index 8a78202c56..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/accessible/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: accessible -slug: Archive/Mozilla/XUL/Propriétés/accessible -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/accessible ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/accessibletype/index.html b/files/fr/archive/mozilla/xul/propriétés/accessibletype/index.html deleted file mode 100644 index 5a9527e78d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/accessibletype/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: accessibleType -slug: Archive/Mozilla/XUL/Propriétés/accessibleType -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/accessibleType ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -<p>Les valeurs possibles sont : -</p> -<table> -<tbody><tr><th>Constante</th><th>Valeur -</th></tr><tr><td>XULAlert</td><td>1001 -</td></tr><tr><td>XULButton</td><td>1002 -</td></tr><tr><td>XULCheckbox</td><td>1003 -</td></tr><tr><td>XULColorPicker</td><td>1004 -</td></tr><tr><td>XULColorPickerTile</td><td>1005 -</td></tr><tr><td>XULCombobox</td><td>1006 -</td></tr><tr><td>XULDropmarker</td><td>1007 -</td></tr><tr><td>XULGroupbox</td><td>1008 -</td></tr><tr><td>XULImage</td><td>1009 -</td></tr><tr><td>XULLink</td><td>100A -</td></tr><tr><td>XULListbox</td><td>100B -</td></tr><tr><td>XULListCell</td><td>1026 -</td></tr><tr><td>XULListHead</td><td>1024 -</td></tr><tr><td>XULListHeader</td><td>1025 -</td></tr><tr><td>XULListitem</td><td>100C -</td></tr><tr><td>XULMenubar</td><td>100D -</td></tr><tr><td>XULMenuitem</td><td>100E -</td></tr><tr><td>XULMenupopup</td><td>100F -</td></tr><tr><td>XULMenuSeparator</td><td>1010 -</td></tr><tr><td>XULPane</td><td>1011 -</td></tr><tr><td>XULProgressMeter</td><td>1012 -</td></tr><tr><td>XULScale</td><td>1013 -</td></tr><tr><td>XULStatusBar</td><td>1014 -</td></tr><tr><td>XULRadioButton</td><td>1015 -</td></tr><tr><td>XULRadioGroup</td><td>1016 -</td></tr><tr><td>XULTab</td><td>1017 -</td></tr><tr><td>XULTabBox</td><td>1018 -</td></tr><tr><td>XULTabs</td><td>1019 -</td></tr><tr><td>XULText</td><td>101A -</td></tr><tr><td>XULTextBox</td><td>101B -</td></tr><tr><td>XULThumb</td><td>101C -</td></tr><tr><td>XULTree</td><td>101D -</td></tr><tr><td>XULTreeColumns</td><td>101E -</td></tr><tr><td>XULTreeColumnItem</td><td>101F -</td></tr><tr><td>XULToolbar</td><td>1020 -</td></tr><tr><td>XULToolbarSeparator</td><td>1021 -</td></tr><tr><td>XULTooltip</td><td>1022 -</td></tr><tr><td>XULToolbarButton</td><td>1023 -</td></tr></tbody></table> -<p></div> -</p></div> diff --git a/files/fr/archive/mozilla/xul/propriétés/accesskey/index.html b/files/fr/archive/mozilla/xul/propriétés/accesskey/index.html deleted file mode 100644 index 18c8cb6110..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/accesskey/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: accessKey -slug: Archive/Mozilla/XUL/Propriétés/accessKey -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/accessKey ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/accessKey">accessKey</a></span></code> -</dt><dd> Type : <i>caractère</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/align/index.html b/files/fr/archive/mozilla/xul/propriétés/align/index.html deleted file mode 100644 index ade556771a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/align/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: align -slug: Archive/Mozilla/XUL/Propriétés/align -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/align ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/allowevents/index.html b/files/fr/archive/mozilla/xul/propriétés/allowevents/index.html deleted file mode 100644 index 3a89398e48..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/allowevents/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: allowEvents -slug: Archive/Mozilla/XUL/Propriétés/allowEvents -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/allowEvents ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/amindicator/index.html b/files/fr/archive/mozilla/xul/propriétés/amindicator/index.html deleted file mode 100644 index 3118629abd..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/amindicator/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: amIndicator -slug: Archive/Mozilla/XUL/Propriétés/amIndicator -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/amIndicator ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/amIndicator">amIndicator</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> La valeur chaîne affichée pour les heures entre minuit et midi, par défaut « AM ». Cette valeur est déterminée selon la locale de l'utilisateur. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/boxobject/index.html b/files/fr/archive/mozilla/xul/propriétés/boxobject/index.html deleted file mode 100644 index 68284b25f9..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/boxobject/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: boxObject -slug: Archive/Mozilla/XUL/Propriétés/boxObject -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/boxObject ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIBoxObject">nsIBoxObject</a></i> -</dd><dd> Cette propriété est disponible pour les éléments dérivés de boîtes, ce qui est le cas de la plupart des éléments XUL visibles. L'objet boxObject pour les éléments non-XUL peut être obtenu à l'aide de la méthode <a href="fr/DOM/document.getBoxObjectFor">getBoxObjectFor</a>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/builder/index.html b/files/fr/archive/mozilla/xul/propriétés/builder/index.html deleted file mode 100644 index 78acdbec0d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/builder/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: builder -slug: Archive/Mozilla/XUL/Propriétés/builder -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/builder ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIXULTemplateBuilder">nsIXULTemplateBuilder</a></i> -</dd><dd> Pour le contenu généré depuis un template, il s'agit de l'objet <a href="fr/XPCOM">XPCOM</a> responsable de la génération du contenu. Pour les scripts il est uniquement nécessaire dans le cas où vous voulez forcer le contenu du template à être régénéré. Vous pouvez en avoir besoin si vous avez ajusté les règles manuellement. Pour reconstruire le contenu, appelez la méthode <code>rebuild</code> du builder. -</dd></dl> -<dl><dd> Par exemple, à partir d'une référence à un arbre <code>myTree</code>, ce code reconstruira son contenu : <code>myTree.builder.rebuild();</code> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/classname/index.html b/files/fr/archive/mozilla/xul/propriétés/classname/index.html deleted file mode 100644 index af031bec76..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/classname/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: className -slug: Archive/Mozilla/XUL/Propriétés/className -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/className ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/collapsed/index.html b/files/fr/archive/mozilla/xul/propriétés/collapsed/index.html deleted file mode 100644 index 95dd04a07a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/collapsed/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: collapsed -slug: Archive/Mozilla/XUL/Propriétés/collapsed -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/collapsed ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/contextmenu/index.html b/files/fr/archive/mozilla/xul/propriétés/contextmenu/index.html deleted file mode 100644 index 611425d9c8..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/contextmenu/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: contextMenu -slug: Archive/Mozilla/XUL/Propriétés/contextMenu -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/contextMenu ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code> -</dt><dd> Type : <i>id d'élément popup</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/controllers/index.html b/files/fr/archive/mozilla/xul/propriétés/controllers/index.html deleted file mode 100644 index 28ca9b2f5e..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/controllers/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: controllers -slug: Archive/Mozilla/XUL/Propriétés/controllers -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/controllers ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIControllers">nsIControllers</a></i> -</dd><dd> Une liste de contrôleurs attachés à l'élément. Les contrôleurs servent à répondre à des commandes. Le répartiteur de commandes du document identifiera les contrôleurs pour gérer une commande à l'aide de la liste de l'élément ayant le focus. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/crop/index.html b/files/fr/archive/mozilla/xul/propriétés/crop/index.html deleted file mode 100644 index 01aa418b56..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/crop/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: crop -slug: Archive/Mozilla/XUL/Propriétés/crop -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/crop ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/crop">crop</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/currentitem/index.html b/files/fr/archive/mozilla/xul/propriétés/currentitem/index.html deleted file mode 100644 index 66ca8b4596..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/currentitem/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: currentItem -slug: Archive/Mozilla/XUL/Propriétés/currentItem -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/currentItem ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/database/index.html b/files/fr/archive/mozilla/xul/propriétés/database/index.html deleted file mode 100644 index a8ef04ee8b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/database/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: database -slug: Archive/Mozilla/XUL/Propriétés/database -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/database ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIRDFCompositeDataSource">nsIRDFCompositeDataSource</a></i> -</dd><dd> Renvoie la source de données composite créée lorsque toutes les sources de données de l'élément sont combinées. Défini à <code>null</code> pour les éléments qui n'ont pas d'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/datasources/index.html b/files/fr/archive/mozilla/xul/propriétés/datasources/index.html deleted file mode 100644 index 567dd397fe..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/datasources/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: datasources -slug: Archive/Mozilla/XUL/Propriétés/datasources -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/datasources ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code> -</dt><dd> Type : <i>liste d'URIs de sources de données séparée par des espaces</i> -</dd><dd> Lit et définit la valeur de l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>. Dans les nouvelles versions de Mozilla (>1.7), les sources de données seront rechargées et le gabarit reconstruit. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/date/index.html b/files/fr/archive/mozilla/xul/propriétés/date/index.html deleted file mode 100644 index b82437977f..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/date/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: date -slug: Archive/Mozilla/XUL/Propriétés/date -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/date ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/date">date</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Le jour du mois actuellement sélectionné, entre 1 et 31. Modifiez cette propriété pour changer la date sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/dateleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/dateleadingzero/index.html deleted file mode 100644 index 2de143aeaa..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/dateleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: dateLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/dateLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/dateLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dateLeadingZero">dateLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché avant la date lorsqu'elle est inférieure à 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/datepicker.open/index.html b/files/fr/archive/mozilla/xul/propriétés/datepicker.open/index.html deleted file mode 100644 index bd302b35f1..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/datepicker.open/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: datepicker.open -slug: Archive/Mozilla/XUL/Propriétés/datepicker.open -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/datepicker.open ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Pour les sélecteurs de date de type popup, spécifie si celui-ci est ouvert. Définissez cette propriété pour ouvrir ou fermer le popup. Pour les autres types de sélecteurs de date, cette propriété est toujours à <code>false</code>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/datepicker.value/index.html b/files/fr/archive/mozilla/xul/propriétés/datepicker.value/index.html deleted file mode 100644 index 0342ffd158..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/datepicker.value/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: datepicker.value -slug: Archive/Mozilla/XUL/Propriétés/datepicker.value -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/datepicker.value ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/value">value</a></span></code></dt> - <dd> - Type : <i>chaîne</i></dd> - <dd> - La date actuellement sélectionnée au format AAAA/MM/JJ. Contrairement à la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/month">month</a></span></code>, les mois varient ici dans l'intervalle 01 à 12. Définissez cette propriété pour changer la date sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/datevalue/index.html b/files/fr/archive/mozilla/xul/propriétés/datevalue/index.html deleted file mode 100644 index 4872d60184..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/datevalue/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: dateValue -slug: Archive/Mozilla/XUL/Propriétés/dateValue -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/dateValue ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dateValue">dateValue</a></span></code></dt> - <dd> - Type : <i>Date</i></dd> - <dd> - La date actuellement entrée ou sélectionnée dans le sélecteur de date sous la forme d'un objet <code>Date</code>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/defaultvalue/index.html b/files/fr/archive/mozilla/xul/propriétés/defaultvalue/index.html deleted file mode 100644 index cd6be12cb3..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/defaultvalue/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: defaultValue -slug: Archive/Mozilla/XUL/Propriétés/defaultValue -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/defaultValue ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/defaultValue">defaultValue</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Définit et obtient la valeur par défaut d'une boîte de texte. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/dir/index.html b/files/fr/archive/mozilla/xul/propriétés/dir/index.html deleted file mode 100644 index 440727c354..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/dir/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: dir -slug: Archive/Mozilla/XUL/Propriétés/dir -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/dir ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/disabled/index.html b/files/fr/archive/mozilla/xul/propriétés/disabled/index.html deleted file mode 100644 index 03a25bf5ba..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/disabled/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: disabled -slug: Archive/Mozilla/XUL/Propriétés/disabled -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/disabled ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/flex/index.html b/files/fr/archive/mozilla/xul/propriétés/flex/index.html deleted file mode 100644 index 5514de566a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/flex/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: flex -slug: Archive/Mozilla/XUL/Propriétés/flex -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/flex ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/height/index.html b/files/fr/archive/mozilla/xul/propriétés/height/index.html deleted file mode 100644 index db9a532281..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/height/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: height -slug: Archive/Mozilla/XUL/Propriétés/height -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/height ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/hidden/index.html b/files/fr/archive/mozilla/xul/propriétés/hidden/index.html deleted file mode 100644 index d05bc8715b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/hidden/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: hidden -slug: Archive/Mozilla/XUL/Propriétés/hidden -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/hidden ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/hideseconds/index.html b/files/fr/archive/mozilla/xul/propriétés/hideseconds/index.html deleted file mode 100644 index f5711a3e24..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/hideseconds/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: hideSeconds -slug: Archive/Mozilla/XUL/Propriétés/hideSeconds -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/hideSeconds ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hideSeconds">hideSeconds</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Indique si le champ des secondes doit être masqué.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/hour/index.html b/files/fr/archive/mozilla/xul/propriétés/hour/index.html deleted file mode 100644 index 0b8d5607d6..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/hour/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: hour -slug: Archive/Mozilla/XUL/Propriétés/hour -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/hour ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hour">hour</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - La valeur de l'heure actuellement sélectionnée entre 0 et 23. Modifiez cette propriété pour changer l'heure sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/hourleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/hourleadingzero/index.html deleted file mode 100644 index 88ac335836..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/hourleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: hourLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/hourLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/hourLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hourLeadingZero">hourLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant l'heure lorsque celle-ci est inférieure à 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/id/index.html b/files/fr/archive/mozilla/xul/propriétés/id/index.html deleted file mode 100644 index d5e6613076..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/id/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: id -slug: Archive/Mozilla/XUL/Propriétés/id -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/id ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code> -</dt><dd> Type : <i>id d'élément, doit être unique dans la fenêtre</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/image/index.html b/files/fr/archive/mozilla/xul/propriétés/image/index.html deleted file mode 100644 index b180fa1bff..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/image/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: image -slug: Archive/Mozilla/XUL/Propriétés/image -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/image ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/image">image</a></span></code> -</dt><dd> Type : <i>URL d'image</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/increment/index.html b/files/fr/archive/mozilla/xul/propriétés/increment/index.html deleted file mode 100644 index ee048522a2..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/increment/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: increment -slug: Archive/Mozilla/XUL/Propriétés/increment -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/increment ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/increment">increment</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Obtient et définit la valeur de l'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/index.html b/files/fr/archive/mozilla/xul/propriétés/index.html deleted file mode 100644 index 046b0478cc..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/index.html +++ /dev/null @@ -1,224 +0,0 @@ ---- -title: Propriétés -slug: Archive/Mozilla/XUL/Propriétés -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property ---- -<p><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span> -</p> -<ul><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/accessible">accessible</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/accessKey">accessKey</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/align">align</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/allowEvents">allowEvents</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/alwaysOpenPopup">alwaysOpenPopup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/appLocale">appLocale</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/autoCheck">autoCheck</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/autoFill">autoFill</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/autoFillAfterMatch">autoFillAfterMatch</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/boxObject">boxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/browsers">browsers</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/builder">builder</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/builderView">builderView</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/buttons">buttons</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/canAdvance">canAdvance</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/canGoBack">canGoBack</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/canGoForward">canGoForward</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/canRewind">canRewind</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/checked">checked</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/checkState">checkState</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/child">child</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/children">children</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/className">className</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/collapsed">collapsed</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/color">color</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/columns">columns</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/command">command</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/commandManager">commandManager</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/completeDefaultIndex">completeDefaultIndex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/container">container</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentDocument">contentDocument</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentTitle">contentTitle</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentView">contentView</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentViewerEdit">contentViewerEdit</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentViewerFile">contentViewerFile</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contentWindow">contentWindow</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/contextMenu">contextMenu</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/control">control</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/controller">controller</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/controllers">controllers</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/crop">crop</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/current">current</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentIndex">currentIndex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentItem">currentItem</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentPage">currentPage</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentPane">currentPane</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentSet">currentSet</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/currentURI">currentURI</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/customToolbarCount">customToolbarCount</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/database">database</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/datasources">datasources</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/defaultButton">defaultButton</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/defaultValue">defaultValue</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/description">description</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/dir">dir</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/disableAutocomplete">disableAutocomplete</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/disableAutoComplete">disableAutoComplete</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/disableautoselect">disableautoselect</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/disabled">disabled</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/disableKeyNavigation">disableKeyNavigation</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/dlgType">dlgType</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/docShell">docShell</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/documentCharsetInfo">documentCharsetInfo</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/editable">editable</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/editingColumn">editingColumn</a></span></code> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/editingRow">editingRow</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/editingSession">editingSession</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/editortype">editortype</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/enableColumnDrag">enableColumnDrag</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/eventNode">eventNode</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/firstOrdinalColumn">firstOrdinalColumn</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/firstPermanentChild">firstPermanentChild</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/flex">flex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/focused">focused</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/focusedItem">focusedItem</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/forceComplete">forceComplete</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/group">group</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/handleCtrlPageUpDown">handleCtrlPageUpDown</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/handleCtrlTab">handleCtrlTab</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/height">height</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/hidden">hidden</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/homePage">homePage</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/id">id</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/ignoreBlurWhileSearching">ignoreBlurWhileSearching</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/image">image</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/inputField">inputField</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/inverted">inverted</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/isSearching">isSearching</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/isWaiting">isWaiting</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/label">label</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/lastSelected">lastSelected</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/left">left</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/linkedPanel">linkedPanel</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/listBoxObject">listBoxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/locked">locked</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/markupDocumentViewer">markupDocumentViewer</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/maxHeight">maxHeight</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/maxLength">maxLength</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/maxRows">maxRows</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/maxWidth">maxWidth</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/menu">menu</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu.open">menu.open</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/menuBoxObject">menuBoxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/menupopup">menupopup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/minHeight">minHeight</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/minResultsForPopup">minResultsForPopup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/minWidth">minWidth</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/mode">mode</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/name">name</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/next">next</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/noMatch">noMatch</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/object">object</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/observes">observes</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/onFirstPage">onFirstPage</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/onLastPage">onLastPage</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/open">open</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/ordinal">ordinal</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/orient">orient</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/pack">pack</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/pageCount">pageCount</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/pageid">pageid</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/pageIndex">pageIndex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/pageStep">pageStep</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/palette">palette</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/persist">persist</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/popup">popup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/popupBoxObject">popupBoxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/popupOpen">popupOpen</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/position">position</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/predicate">predicate</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preferenceElements">preferenceElements</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preferencePanes">preferencePanes</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preferences">preferences</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/radioGroup">radioGroup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/readonly">readonly</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/ref">ref</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/resource">resource</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/resultsPopup">resultsPopup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/scrollBoxObject">scrollBoxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/searchCount">searchCount</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/searchLabel">searchLabel</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/searchParam">searchParam</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/searchSessions">searchSessions</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/securityUI">securityUI</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selType">selType</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selected">selected</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedBrowser">selectedBrowser</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedCount">selectedCount</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedIndex">selectedIndex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedItem">selectedItem</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedItems">selectedItems</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedPanel">selectedPanel</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectedTab">selectedTab</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectionEnd">selectionEnd</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selectionStart">selectionStart</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selstyle">selstyle</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/selType">selType</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/sessionCount">sessionCount</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/sessionHistory">sessionHistory</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/showCommentColumn">showCommentColumn</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/showPopup">showPopup</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/size">size</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/src">src</a> -</li><li> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/state">state</a></span></code> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/statusbar">statusbar</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/statusText">statusText</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/stringBundle">stringBundle</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/strings">strings</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/style">style</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/subject">subject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/suppressOnSelect">suppressOnSelect</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tabContainer">tabContainer</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tabIndex">tabIndex</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tabs">tabs</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tabScrolling">tabScrolling</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tag">tag</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/textLength">textLength</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/textValue">textValue</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/timeout">timeout</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/title">title</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/toolbarName">toolbarName</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/toolbarset">toolbarset</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tooltip">tooltip</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/tooltipText">tooltipText</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/top">top</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/treeBoxObject">treeBoxObject</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/type">type</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/uri">uri</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/userAction">userAction</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/value">value</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/view">view</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/webBrowserFind">webBrowsereFind</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/webNavigation">webNavigation</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/webProgress">webProgress</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/width">width</a> -</li><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/wizardPages">wizardPages</a> -</li></ul> -<h3 id="Propri.C3.A9t.C3.A9s_de_DOM_element_li.C3.A9es" name="Propri.C3.A9t.C3.A9s_de_DOM_element_li.C3.A9es"> Propriétés de DOM element liées </h3> -<ul><li> <a href="fr/DOM/element.attributes">DOM:element.attributes</a> -</li><li> <a href="fr/DOM/element.childNodes">DOM:element.childNodes</a> -</li><li> <a href="fr/DOM/element.cloneNode">DOM:element.cloneNode</a> -</li><li> <a href="fr/DOM/element.firstChild">DOM:element.firstChild</a> -</li><li> <a href="fr/DOM/element.lastChild">DOM:element.lastChild</a> -</li><li> <a href="fr/DOM/element.localName">DOM:element.localName</a> -</li><li> <a href="fr/DOM/element.namespaceURI">DOM:element.namespaceURI</a> -</li><li> <a href="fr/DOM/element.nextSibling">DOM:element.nextSibling</a> -</li><li> <a href="fr/DOM/element.nodeName">DOM:element.nodeName</a> -</li><li> <a href="fr/DOM/element.nodeType">DOM:element.nodeType</a> -</li><li> <a href="fr/DOM/element.nodeValue">DOM:element.nodeValue</a> -</li><li> <a href="fr/DOM/element.ownerDocument">DOM:element.ownerDocument</a> -</li><li> <a href="fr/DOM/element.parentNode">DOM:element.parentNode</a> -</li><li> <a href="fr/DOM/element.prefix">DOM:element.prefix</a> -</li><li> <a href="fr/DOM/element.previousSibling">DOM:element.previousSibling</a> -</li><li> <a href="fr/DOM/element.tagName">DOM:element.tagName</a> -</li></ul> diff --git a/files/fr/archive/mozilla/xul/propriétés/inverted/index.html b/files/fr/archive/mozilla/xul/propriétés/inverted/index.html deleted file mode 100644 index 658135805f..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/inverted/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: inverted -slug: Archive/Mozilla/XUL/Propriétés/inverted -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/inverted ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/inverted">inverted</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/is24hourclock/index.html b/files/fr/archive/mozilla/xul/propriétés/is24hourclock/index.html deleted file mode 100644 index 74e27b6c04..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/is24hourclock/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: is24HourClock -slug: Archive/Mozilla/XUL/Propriétés/is24HourClock -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/is24HourClock ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/is24HourClock">is24HourClock</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si l'heure est affichée à l'aide d'une horloge à 24 ou 12 heures. Avec une horloge à 12 heures, un champ supplémentaire permet à l'utilisateur de choisir entre AM et PM.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/ispm/index.html b/files/fr/archive/mozilla/xul/propriétés/ispm/index.html deleted file mode 100644 index 37be41eafc..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/ispm/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: isPM -slug: Archive/Mozilla/XUL/Propriétés/isPM -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/isPM ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/isPM">isPM</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si cette propriété est à <code>false</code>, l'heure est entre 0 et 11. Si elle est à <code>true</code>, l'heure est supérieure ou égale à 12.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/label/index.html b/files/fr/archive/mozilla/xul/propriétés/label/index.html deleted file mode 100644 index c913db90bc..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/label/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: label -slug: Archive/Mozilla/XUL/Propriétés/label -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/label ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/left/index.html b/files/fr/archive/mozilla/xul/propriétés/left/index.html deleted file mode 100644 index eca1301f70..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/left/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: left -slug: Archive/Mozilla/XUL/Propriétés/left -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/left ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/listboxobject/index.html b/files/fr/archive/mozilla/xul/propriétés/listboxobject/index.html deleted file mode 100644 index 4d5b75170a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/listboxobject/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: listBoxObject -slug: Archive/Mozilla/XUL/Propriétés/listBoxObject -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/listBoxObject ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/listBoxObject">listBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIListBoxObject">nsIListBoxObject</a></i> -</dd><dd> L'objet <code>nsIListBoxObject</code> derrière la liste de sélection. Cette propriété est en lecture seule. La plupart des fonctionnalités de la liste de sélection sont déjà disponibles directement dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>, il sera donc rarement nécessaire d'utiliser cet objet de boîte directement. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/locked/index.html b/files/fr/archive/mozilla/xul/propriétés/locked/index.html deleted file mode 100644 index 5c097897c0..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/locked/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: locked -slug: Archive/Mozilla/XUL/Propriétés/locked -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/locked ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/locked">locked</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si définie à <code>true</code>, la préférence a été verrouillée et désactivée dans la configuration système, ce qui empêche de changer sa valeur. Cette propriété est en lecture seule. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/max/index.html b/files/fr/archive/mozilla/xul/propriétés/max/index.html deleted file mode 100644 index d8fd66793d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/max/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: max -slug: Archive/Mozilla/XUL/Propriétés/max -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/max ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/max">max</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/maxheight/index.html b/files/fr/archive/mozilla/xul/propriétés/maxheight/index.html deleted file mode 100644 index 5a36481266..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/maxheight/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: maxHeight -slug: Archive/Mozilla/XUL/Propriétés/maxHeight -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/maxHeight ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/maxwidth/index.html b/files/fr/archive/mozilla/xul/propriétés/maxwidth/index.html deleted file mode 100644 index 48d245dac9..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/maxwidth/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: maxWidth -slug: Archive/Mozilla/XUL/Propriétés/maxWidth -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/maxWidth ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/menu/index.html b/files/fr/archive/mozilla/xul/propriétés/menu/index.html deleted file mode 100644 index a9dbbade7f..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/menu/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: menu -slug: Archive/Mozilla/XUL/Propriétés/menu -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/menu ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code> -</dt><dd> Type : <i>id d'élément popup</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/min/index.html b/files/fr/archive/mozilla/xul/propriétés/min/index.html deleted file mode 100644 index cc96380d54..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/min/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: min -slug: Archive/Mozilla/XUL/Propriétés/min -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/min ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/min">min</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/minheight/index.html b/files/fr/archive/mozilla/xul/propriétés/minheight/index.html deleted file mode 100644 index fc67f0823a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/minheight/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: minHeight -slug: Archive/Mozilla/XUL/Propriétés/minHeight -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/minHeight ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/minute/index.html b/files/fr/archive/mozilla/xul/propriétés/minute/index.html deleted file mode 100644 index f9a70a888a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/minute/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: minute -slug: Archive/Mozilla/XUL/Propriétés/minute -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/minute ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minute">minute</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Les minutes de l'heure actuellement sélectionnée entre 0 et 59. Modifiez cette propriété pour changer la minute sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/minuteleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/minuteleadingzero/index.html deleted file mode 100644 index 47911a397d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/minuteleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: minuteLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/minuteLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/minuteLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minuteLeadingZero">minuteLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant la valeur des minutes lorsque celle-ci est inférieure à 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/minwidth/index.html b/files/fr/archive/mozilla/xul/propriétés/minwidth/index.html deleted file mode 100644 index 384dc60350..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/minwidth/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: minWidth -slug: Archive/Mozilla/XUL/Propriétés/minWidth -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/minWidth ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code> -</dt><dd> Type : <i>integer</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/month/index.html b/files/fr/archive/mozilla/xul/propriétés/month/index.html deleted file mode 100644 index 2bca180dc7..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/month/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: month -slug: Archive/Mozilla/XUL/Propriétés/month -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/month ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/month">month</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Le mois actuellement sélectionné entre 0 (janvier) et 11 (décembre). Définissez cette propriété pour changer le mois sélectionné.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/monthleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/monthleadingzero/index.html deleted file mode 100644 index 942edc6094..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/monthleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: monthLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/monthLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/monthLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/monthLeadingZero">monthLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché devant le mois s'il est inférieur à 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/name/index.html b/files/fr/archive/mozilla/xul/propriétés/name/index.html deleted file mode 100644 index 879ae4a5a0..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/name/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: name -slug: Archive/Mozilla/XUL/Propriétés/name -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/name ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/name">name</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le nom de la préférence (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>) à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/observes/index.html b/files/fr/archive/mozilla/xul/propriétés/observes/index.html deleted file mode 100644 index 642fd59922..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/observes/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: observes -slug: Archive/Mozilla/XUL/Propriétés/observes -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/observes ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code> -</dt><dd> Type : <i>id d'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code></i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/open/index.html b/files/fr/archive/mozilla/xul/propriétés/open/index.html deleted file mode 100644 index 4d8deac2fb..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/open/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: open -slug: Archive/Mozilla/XUL/Propriétés/open -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/open ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/open">open</a></span></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/ordinal/index.html b/files/fr/archive/mozilla/xul/propriétés/ordinal/index.html deleted file mode 100644 index df77eb113a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/ordinal/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: ordinal -slug: Archive/Mozilla/XUL/Propriétés/ordinal -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/ordinal ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/orient/index.html b/files/fr/archive/mozilla/xul/propriétés/orient/index.html deleted file mode 100644 index f965b07278..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/orient/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: orient -slug: Archive/Mozilla/XUL/Propriétés/orient -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/orient ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/pack/index.html b/files/fr/archive/mozilla/xul/propriétés/pack/index.html deleted file mode 100644 index fd555d4c49..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/pack/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: pack -slug: Archive/Mozilla/XUL/Propriétés/pack -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/pack ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/pageincrement/index.html b/files/fr/archive/mozilla/xul/propriétés/pageincrement/index.html deleted file mode 100644 index 17ccd723cd..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/pageincrement/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: pageIncrement -slug: Archive/Mozilla/XUL/Propriétés/pageIncrement -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/pageIncrement ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pageIncrement">pageIncrement</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-pageincrement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pageincrement">pageincrement</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/persist/index.html b/files/fr/archive/mozilla/xul/propriétés/persist/index.html deleted file mode 100644 index bdc1c330db..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/persist/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: persist -slug: Archive/Mozilla/XUL/Propriétés/persist -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/persist ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code> -</dt><dd> Type : <i>liste de noms d'attributs séparés par des espaces</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/pmindicator/index.html b/files/fr/archive/mozilla/xul/propriétés/pmindicator/index.html deleted file mode 100644 index e35b07ba7b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/pmindicator/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: pmIndicator -slug: Archive/Mozilla/XUL/Propriétés/pmIndicator -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/pmIndicator ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pmIndicator">pmIndicator</a></span></code></dt> - <dd> - Type : <i>chaîne</i></dd> - <dd> - La valeur chaîne affichée pour les heures entre midi et minuit, par défaut « PM ». Cette valeur est déterminée selon la locale de l'utilisateur.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/popupboxobject/index.html b/files/fr/archive/mozilla/xul/propriétés/popupboxobject/index.html deleted file mode 100644 index 73c7b44900..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/popupboxobject/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: popupBoxObject -slug: Archive/Mozilla/XUL/Propriétés/popupBoxObject -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/popupBoxObject ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/popupBoxObject">popupBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a></i> -</dd><dd> Cette propriété en lecture seule conserve le <a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a> 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. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/position/index.html b/files/fr/archive/mozilla/xul/propriétés/position/index.html deleted file mode 100644 index a48b08003e..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/position/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: position -slug: Archive/Mozilla/XUL/Propriétés/position -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/position ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/position">position</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Obtient et définit la valeur de l'attribut <a href="fr/XUL/Attributs/popup.position">position</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/preference.preferences/index.html b/files/fr/archive/mozilla/xul/propriétés/preference.preferences/index.html deleted file mode 100644 index 04e39427d6..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/preference.preferences/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: preference.preferences -slug: Archive/Mozilla/XUL/Propriétés/preference.preferences -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/preference.preferences ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preference.preferences">preferences</a> -</dt><dd> Type : <i>élément</i> -</dd><dd> Référence à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> conteneur. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/readonly/index.html b/files/fr/archive/mozilla/xul/propriétés/readonly/index.html deleted file mode 100644 index f6fd6c6c5a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/readonly/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: readonly -slug: Archive/Mozilla/XUL/Propriétés/readOnly -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/readOnly ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/readonly">readonly</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd> - <dd> - <div class="note"> - Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div> - </dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/ref/index.html b/files/fr/archive/mozilla/xul/propriétés/ref/index.html deleted file mode 100644 index 68f38ce84b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/ref/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: ref -slug: Archive/Mozilla/XUL/Propriétés/ref -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/ref ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code> -</dt><dd> Type : <i>URI d'une ressource RDF</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/resource/index.html b/files/fr/archive/mozilla/xul/propriétés/resource/index.html deleted file mode 100644 index d791d97a80..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/resource/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: resource -slug: Archive/Mozilla/XUL/Propriétés/resource -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/resource ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIRDFResource">nsIRDFResource</a></i> -</dd><dd> Renvoie une ressource RDF avec la valeur de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> de l'élément. Si cet élément <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> n'est pas spécifié, l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sera utilisé à la place. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/second/index.html b/files/fr/archive/mozilla/xul/propriétés/second/index.html deleted file mode 100644 index ae2c271580..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/second/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: second -slug: Archive/Mozilla/XUL/Propriétés/second -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/second ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/second">second</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - La valeur des secondes de l'heure actuellement sélectionnée, entre 0 et 59. Modifiez cette propriété pour changer la seconde sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/secondleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/secondleadingzero/index.html deleted file mode 100644 index 72d843df5d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/secondleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: secondLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/secondLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/secondLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/secondLeadingZero">secondLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant la valeur des secondes si celle-ci est inférieure à 10.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/selected/index.html b/files/fr/archive/mozilla/xul/propriétés/selected/index.html deleted file mode 100644 index 680f617876..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/selected/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selected -slug: Archive/Mozilla/XUL/Propriétés/selected -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/selected ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/selectedindex/index.html b/files/fr/archive/mozilla/xul/propriétés/selectedindex/index.html deleted file mode 100644 index 6d9e555cf2..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/selectedindex/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selectedIndex -slug: Archive/Mozilla/XUL/Propriétés/selectedIndex -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/selectedIndex ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/selecteditem/index.html b/files/fr/archive/mozilla/xul/propriétés/selecteditem/index.html deleted file mode 100644 index 221bd2cf1a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/selecteditem/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: selectedItem -slug: Archive/Mozilla/XUL/Propriétés/selectedItem -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/selectedItem ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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étés/selectedIndex">selectedIndex</a></span></code>, ou par l'utilisateur. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/seltype/index.html b/files/fr/archive/mozilla/xul/propriétés/seltype/index.html deleted file mode 100644 index 7c2cb97223..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/seltype/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: selType -slug: Archive/Mozilla/XUL/Propriétés/selType -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/selType ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selType">selType</a></span></code><magic name="\"PAGENAME\"/"></magic></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 class="noinclude"> - </div> diff --git a/files/fr/archive/mozilla/xul/propriétés/state/index.html b/files/fr/archive/mozilla/xul/propriétés/state/index.html deleted file mode 100644 index 0539f20aea..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/state/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: state -slug: Archive/Mozilla/XUL/Propriétés/state -tags: - - Attributs_XUL - - Référence_XUL -translation_of: Archive/Mozilla/XUL/Property/state ---- -<div class="noinclude"><span class="breadcrumbs xulRefAttr_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="http://api/fr/docs/XUL/Propriétés/state">state</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Cette propriété en lecture seule indique si le popup est ouvert ou non. Quatre valeurs sont possibles : -</dd></dl> -<ul><li> <code>closed</code> : Le popup est fermé et non visible. -</li><li> <code>open</code> : Le popup est ouvert et visible sur l'écran. -</li><li> <code>showing</code> : Une requête a été faite pour ouvrir le popup, mais il n'a pas encore été affiché. Cet état se produit durant l'évènement <code>popupshowing</code>. -</li><li> <code>hiding</code> : Le popup est sur le point d'être masqué. Cet état se produit durant l'évènement <code>popuphiding</code>. -</li></ul> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/statustext/index.html b/files/fr/archive/mozilla/xul/propriétés/statustext/index.html deleted file mode 100644 index e8d0c5f93c..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/statustext/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: statusText -slug: Archive/Mozilla/XUL/Propriétés/statusText -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/statusText ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/style/index.html b/files/fr/archive/mozilla/xul/propriétés/style/index.html deleted file mode 100644 index 2ac332eb3b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/style/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: style -slug: Archive/Mozilla/XUL/Propriétés/style -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/style ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code> -</dt><dd> Type : <i>style CSS inline</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/suppressonselect/index.html b/files/fr/archive/mozilla/xul/propriétés/suppressonselect/index.html deleted file mode 100644 index fb43cec3fe..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/suppressonselect/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: suppressOnSelect -slug: Archive/Mozilla/XUL/Propriétés/suppressOnSelect -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/suppressOnSelect ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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> diff --git a/files/fr/archive/mozilla/xul/propriétés/tabindex/index.html b/files/fr/archive/mozilla/xul/propriétés/tabindex/index.html deleted file mode 100644 index cb59c74840..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/tabindex/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: tabIndex -slug: Archive/Mozilla/XUL/Propriétés/tabIndex -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/tabIndex ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/timepicker.value/index.html b/files/fr/archive/mozilla/xul/propriétés/timepicker.value/index.html deleted file mode 100644 index 2629a7774d..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/timepicker.value/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: timepicker.value -slug: Archive/Mozilla/XUL/Propriétés/timepicker.value -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/timepicker.value ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/value">value</a></span></code></dt> - <dd> - Type : <i>chaîne</i></dd> - <dd> - L'heure actuellement entrée sous la forme HH:MM:SS. Modifiez cette propriété pour changer cette heure.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/tooltip/index.html b/files/fr/archive/mozilla/xul/propriétés/tooltip/index.html deleted file mode 100644 index 0b2a5e95e3..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/tooltip/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: tooltip -slug: Archive/Mozilla/XUL/Propriétés/tooltip -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/tooltip ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code> -</dt><dd> Type : <i>id d'élément tooltip</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/tooltiptext/index.html b/files/fr/archive/mozilla/xul/propriétés/tooltiptext/index.html deleted file mode 100644 index 0ad5b618ee..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/tooltiptext/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: tooltipText -slug: Archive/Mozilla/XUL/Propriétés/tooltipText -tags: - - Propriétés_XUL - - XUL -translation_of: Archive/Mozilla/XUL/Property/tooltipText ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code></dt> - <dd> - Type : - <i> - chaîne de caractères</i> - </dd> - <dd> - Obtient et définit la valeur de l'attribut <code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>.</dd> -</dl> -<div class="noinclude"> - </div> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/propriétés/top/index.html b/files/fr/archive/mozilla/xul/propriétés/top/index.html deleted file mode 100644 index 204e928123..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/top/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: top -slug: Archive/Mozilla/XUL/Propriétés/top -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/top ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/type/index.html b/files/fr/archive/mozilla/xul/propriétés/type/index.html deleted file mode 100644 index 450c40e124..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/type/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: type -slug: Archive/Mozilla/XUL/Propriétés/type -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/type ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/type">type</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code>. -</dd></dl> -<div class="noinclude"> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h3> -<ul><li> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/textbox.type">textbox.type</a> -</li></ul> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/value/index.html b/files/fr/archive/mozilla/xul/propriétés/value/index.html deleted file mode 100644 index ff5257202b..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/value/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: value -slug: Archive/Mozilla/XUL/Propriétés/value -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/value ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/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 class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/width/index.html b/files/fr/archive/mozilla/xul/propriétés/width/index.html deleted file mode 100644 index 9b58bd9c1a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/width/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: width -slug: Archive/Mozilla/XUL/Propriétés/width -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/width ---- -<div class="noinclude"><span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code>. -</dd></dl> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/propriétés/year/index.html b/files/fr/archive/mozilla/xul/propriétés/year/index.html deleted file mode 100644 index 0c01e08e7a..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/year/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: year -slug: Archive/Mozilla/XUL/Propriétés/year -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/year ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/year">year</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - L'année actuellement sélectionnée entre 1 et 9999. Définissez cette propriété pour changer la date sélectionnée.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/propriétés/yearleadingzero/index.html b/files/fr/archive/mozilla/xul/propriétés/yearleadingzero/index.html deleted file mode 100644 index ef949e53e4..0000000000 --- a/files/fr/archive/mozilla/xul/propriétés/yearleadingzero/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: yearLeadingZero -slug: Archive/Mozilla/XUL/Propriétés/yearLeadingZero -tags: - - Propriétés_XUL -translation_of: Archive/Mozilla/XUL/Property/yearLeadingZero ---- -<div class="noinclude"> - <span class="breadcrumbs XULRefProp_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="Référence_XUL">Accueil de la référence XUL</a></span></div> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/yearLeadingZero">yearLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro doit être affiché devant l'année si elle est inférieure à 1000.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/recommandations_accessibilité_pour_xul/index.html b/files/fr/archive/mozilla/xul/recommandations_accessibilité_pour_xul/index.html deleted file mode 100644 index 000f7b13c8..0000000000 --- a/files/fr/archive/mozilla/xul/recommandations_accessibilité_pour_xul/index.html +++ /dev/null @@ -1,484 +0,0 @@ ---- -title: Recommandations d'accessibilité pour XUL -slug: Archive/Mozilla/XUL/Recommandations_accessibilité_pour_XUL -tags: - - Accessibilité - - XUL -translation_of: Archive/Mozilla/XUL/XUL_accessibility_guidelines ---- -<h2 id="Introduction" name="Introduction">Introduction</h2> - -<p>Bienvenue dans les recommandations d'accessibilité pour XUL. En suivant ces principes et pratiques, vous pourrez écrire des applications XUL de manière à ce que tous les utilisateurs, même ceux souffrant de handicaps physiques, sensoriels ou communicatifs puissent l'utiliser et l'apprécier. L'accessibilité n'a rien de difficile, mais nécessite une compréhension basique des différents types de handicaps, des technologies assistives courantes et des fonctionnalités spéciales d'accessibilité fournies par le langage XUL. Plus que tout, l'accessibilité a besoin d'un effort conscient de votre part, et d'un désir d'intégrer tout le monde.</p> - -<p>Nous espérons que ces recommandations seront suffisamment claires et détaillées pour que tout le monde — même ceux qui n'ont aucune expérience dans le domaine de l'accessibilité — puisse les comprendre. Il existe également une communauté de développeurs spécialisés dans l'accessibilité au sein du projet Mozilla qui n'hésiteront pas à vous aider pour toutes les inquiétudes et questions suscitées par le fait de rendre vos applications XUL entièrement accessibles.</p> - -<table class="standard-table"> - <caption>Pour en savoir plus</caption> - <tbody> - <tr> - <th>Accessibilité</th> - <th>Fonctionnalités de la plateforme</th> - <th>Communauté Mozilla</th> - </tr> - <tr> - <td><a class="external" href="http://www.mozilla.org/access/today">Software Accessibility - Where Are We Today?</a> Introduction à l'accessibilité, aux technologies assistives et ressources concernant Mozilla. - <p><a class="external" href="http://webaim.org/intro/">Introduction to Web Accessibility</a>. Aperçu de l'accessibilité Web de WebAIM.</p> - - <p><a class="external" href="http://diveintoaccessibility.org/">Dive Into Accessibility</a>. Livre téléchargeable sur l'accessibilité Web avec astuces et mises en situation.</p> - - <p><a class="external" href="http://kb.mozillazine.org/Assistive_technology_compatibility">Technology Compatibility</a>. Liste de technologies assistives courantes et de leurs niveaux de compatibilité respectifs avec XUL.</p> - <a class="link-irc" href="irc://irc.freenode.net/#accessibility">#accessibility</a>. Canal IRC sur l'accessibilité pour des discussions générales autour de l'accessibilité sur Internet. Utile lors de conférences.</td> - <td><a class="external" href="http://www.apple.com/accessibility/">Apple Accessibility</a>. Portail d'accessibilité d'Apple. - <p><a class="external" href="http://larswiki.atrc.utoronto.ca/wiki">LARS (Linux Accessibility Resource Site)</a>. Portail sur l'accessibilité générale sous Linux.</p> - <a class="external" href="http://www.microsoft.com/enable/">Microsoft Accessibility</a>. Portail pour l'accessibilité chez Microsoft.</td> - <td><a href="/fr/Accessibilité" title="fr/Accessibilité">Accessibilité - MDC</a>. Centre d'accessibilité sur le Mozilla Developer Center. - <p><a class="external" href="http://groups.google.com/group/mozilla.support.accessibility">mozilla.support.accessibility</a>. Newsgroup sur l'accessibilité dans Mozilla.</p> - <a class="link-irc" href="irc://irc.mozilla.org/#accessibility">#accessibility</a>. Canal sur l'accessibilité sur le serveur IRC de Mozilla.</td> - </tr> - </tbody> -</table> - -<p> </p> - -<h2 id="Recommandations" name="Recommandations">Recommandations</h2> - -<h3 id="Acc.C3.A8s_au_clavier" name="Acc.C3.A8s_au_clavier">Accès au clavier</h3> - -<p>L'accès au clavier est important pour les utilisateurs ne pouvant pas utiliser de souris. Beaucoup d'utilisateurs de lecteurs d'écran et de handicapés physiques s'appuient sur le clavier comme outil d'entrée principal. Ces utilisateurs ont besoin d'un contrôle au clavier aisé, prévisible et bien documenté.</p> - -<h4 id="Ordre_de_tabulation" name="Ordre_de_tabulation">Ordre de tabulation</h4> - -<p><strong>Fournissez un ordre de tabulation logique</strong> et assurez-vous que les utilisateurs puissent naviguer parmi tout le contenu à l'aide d'un clavier. Par défaut, l'ordre de tabulation est déterminé par l'ordre des éléments dans le code sous-jacent. Il peut également être redéfini programmatiquement à l'aide de l'attribut <code>tabindex</code> si nécessaire, mais cela doit se faire avec modération et être testé en profondeur lorsqu'on l'utilise. L'ordre de navigation doit être logique, généralement de gauche à droite et de haut en bas. L'ordre de navigation peut varier selon la nature de l'application ou le sens de lecture de la langue utilisée.</p> - -<p>Assurez-vous que l'ordre de tabulation est logique et que l'on puisse accéder à tous les éléments interactifs simplement sans utiliser de souris. Vous devriez arriver à effectuer toutes les tâches possibles, que ce soit directement dans l'application ou depuis des éléments du menu ou de menus contextuels.</p> - -<h4 id="Arbres" name="Arbres">Arbres</h4> - -<p><strong>Fournissez une manière alternative d'effectuer les opérations inaccessibles</strong>. Le sélecteur de colonne et les en-têtes de colonne dans les arbres XUL ne sont pas accessibles au clavier, pour respecter le comportement standard des arbres sur la plupart des systèmes d'exploitations actuels. Il est donc nécessaire de fournir une alternative accessible au clavier pour accéder à ces fonctions.</p> - -<div class="float-right"><img alt="Aperçu du menu Affichage de la gestion des marque-pages de Firefox." class="internal" src="/@api/deki/files/1326/=XUL_a11y_treesort.png"></div> - -<p>Un exemple d'arbre plus accessible est visible dans le gestionnaire de marque-pages de Firefox. Celui-ci permet aux utilisateurs de trier les marque-pages selon une certaine colonne d'information et de choisir les colonnes à afficher. Comme les en-têtes de colonne et le sélecteur de colonne, dans le coin supérieur droit de l'arbre, ne peuvent pas recevoir le focus, ils ne sont pas accessibles au clavier. Dans le gestionnaire de marque-pages, cette fonctionnalité est rendue accessible au clavier via le menu Affichage.</p> - -<h4 id="Boutons_de_barres_d.27outils" name="Boutons_de_barres_d.27outils">Boutons de barres d'outils</h4> - -<p>Par défaut, les boutons de barres d'outils ne peuvent pas recevoir le focus depuis le clavier. La manière conseillée de remédier à ce problème est de <strong>dupliquer toute fonctionnalité associée avec une barre d'outils ailleurs dans l'application</strong>, via un élément de menu principal ou contextuel par exemple. Dans les cas où cette duplication n'est pas possible (comme dans une fenêtre sans barre de menus), il est possible de permettre aux boutons de barres d'outils d'obtenir le focus en ajoutant la règle CSS spéciale <em>-moz-user-focus: normal</em>. (La fenêtre d'aperçu avant impression de Firefox utilise cette technique de secours.) Cela ne doit se faire qu'en dernier ressort, et être cohérent au sein d'une même fenêtre (c'est-à-dire que soit tous les boutons sont accessibles au clavier, soit aucun ne l'est).</p> - -<h4 id="Raccourcis_clavier" name="Raccourcis_clavier">Raccourcis clavier</h4> - -<p>Les raccourcis clavier sont très utiles pour les utilisateurs devant naviguer au clavier. Il existe de nombreuses manières d'en fournir. Celles-ci sont bien documentées dans le <a href="/fr/Tutoriel_XUL/Raccourcis_clavier" title="fr/Tutoriel_XUL/Raccourcis_clavier">Tutoriel XUL:Raccourcis clavier</a>.</p> - -<p><strong>Il convient de faire particulièrement attention lors du choix des raccourcis clavier.</strong> Lors de la création d'une extension (que ce soit pour Firefox ou une autre application XUL), assurez-vous que les raccourcis clavier que vous définissez n'interfèrent pas avec ceux déjà définis par l'application de base. Reportez-vous aux ressources suivantes lors de la définition de raccourcis clavier.</p> - -<div style="max-width: 35em;"> -<table class="standard-table"> - <caption>En savoir plus</caption> - <tbody> - <tr> - <th>Raccourcis clavier et touches d'accès rapides</th> - </tr> - <tr> - <td><a class="external" href="http://www.mozilla.org/access/keyboard/">Mozilla Keyboard Planning FAQ and Cross Reference</a>. Un excellent guide pour déterminer les combinaisons de touches non utilisées et les problèmes dépendant de la plateforme. - <p><a class="external" href="http://www.mozilla.org/docs/end-user/moz_shortcuts.html">Mozilla Keyboard Shortcuts</a>. Une liste complète des raccourcis clavier des diverses applications Mozilla.</p> - <a class="external" href="http://www.mozilla.org/access/keyboard/accesskey">Mozilla's accesskey FAQ</a>. Une courte référence sur l'utilisation de l'attribut accesskey.</td> - </tr> - </tbody> -</table> -</div> - -<h4 id="Menus_contextuels" name="Menus_contextuels">Menus contextuels</h4> - -<p>Le menu contextuel est le petit menu activé par un clic droit de la souris sur une zone de contenu ou un élément (ou à l'aide de <code>Shift + F10</code> ou <code>VK_APPS</code> sous Windows et <code>Ctrl + Click</code> ou <code>Ctrl + Espace</code> sur un Mac). <strong>Utilisez le gestionnaire d'évènement <em>oncontextmenu</em> ou l'attribut <em>context</em> pour créer des menus contextuels.</strong> Ne les codez pas pour s'ouvrir spécifiquement lors d'un clic-droit. L'évènement <code>oncontextmenu</code> et l'attribut <code>context</code> fonctionnent avec les déclencheurs de menus spécifiques à chaque plateforme, que ce soient les touches du clavier ou les clics de souris appropriés.</p> - -<h4 id="Scripts_d.C3.A9pendant_de_la_souris" name="Scripts_d.C3.A9pendant_de_la_souris">Scripts dépendant de la souris</h4> - -<p>Les fonctions associées aux évènements souris comme <em>onmouseover</em>, <em>onmousemove</em> et <em>ondrag</em> peuvent uniquement être activés à l'aide de la souris. Fournissez des points d'accès alternatifs au clavier pour ces fonctions. Envisagez d'utiliser des éléments de menus contextuels ou d'autres éléments XUL parallèlement aux raccourcis clavier.</p> - -<h4 id="D.C3.A9filement" name="D.C3.A9filement">Défilement</h4> - -<p><strong>Assurez-vous que le défilement est possible au clavier.</strong> Beaucoup d'éléments XUL peuvent être rendus défilables à l'aide de CSS. D'autres éléments, comme <code>arrowscrollbox</code> et <code>listbox</code>, sont conçus pour défiler automatiquement. En règle générale, les éléments prévus pour défiler sont inaccessibles si l'utilisateur ne peut pas faire défiler tout le contenu à l'aide du clavier. L'élément <code>arrowscrollbox</code>, par exemple, ne peut pas recevoir le focus ni défiler à l'aide du clavier. Un élément <code>listbox</code>, par contre, peut recevoir le focus et son contenu peut défiler. À peu près tous les éléments XUL peuvent être rendus défilables en définissant un style "overflow: auto" ou "overflow: scroll". Cette flexibilité doit être utilisée de manière réfléchie.</p> - -<h4 id="Maintien_du_focus" name="Maintien_du_focus">Maintien du focus</h4> - -<p>L'utilisateur doit typiquement pouvoir contrôler l'endroit où se trouve le focus actuel. <strong>Évitez de changer le focus automatiquement</strong>. Cependant, désactiver, masquer ou détruire l'élément qui a le focus (ou l'un de ses éléments parents) peut provoquer la perte du focus. Pour empêcher cela, <strong>déplacez le focus à l'élément suivant avant de désactiver, masquer ou détruire l'élément qui a le focus</strong>.</p> - -<p>L'exemple qui suit montre une fonction JavaScript qui peut être appelée avant de détruire un élément pour vérifier s'il a le focus et le déplacer si nécessaire.</p> - -<pre>function moveFocus(element) -{ - if(element == document.commandDispatcher.focusedElement) - { - document.commandDispatcher.advanceFocus(); - return true; - } - - return false; -} -</pre> - -<p><br> - Les changements de focus inattendus peuvent embrouiller ou désorienter les utilisateurs. Un exemple récurrent concerne les numéros de téléphones à entrer dans des champs de formulaire. Les numéros de téléphone aux États-Unis sont souvent affichés dans un format XXX-XXX-XXXX ou (XXX) XXX-XXXX. Pour conserver ce format, certains formulaires contiennent trois champs différents. Le problème se pose lorsqu'un développeur décide d'ajouter une fonctionnalité sautant vers le second champ du formulaire dès que 3 chiffres ont été entrés dans le premier champ de formulaire. Ce comportement se répète pour le champ suivant du formulaire. Les utilisateurs qui ont l'habitude de se déplacer eux-mêmes dans les champs de formulaire se retrouvent souvent à répéter l'opération de passage au champ suivant et passent donc au dessus d'un des champs du formulaire.</p> - -<h4 id="Focus_initial_dans_un_dialogue" name="Focus_initial_dans_un_dialogue">Focus initial dans un dialogue</h4> - -<p>Le focus initial dans une fenêtre de dialogue XUL (c'est-à-dire le focus à l'ouverture de la fenêtre) devrait toujours se trouver sur un contrôle spécifique et non sur le dialogue lui-même. Dans un dialogue comportant des onglets, le focus doit généralement commencer au premier contrôle de l'onglet sélectionné. Dans tous les autres dialogues, le focus doit commencer au premier contrôle (bien qu'il puisse s'agir de n'importe quel autre contrôle s'il y a une bonne raison de le faire, du moment que ce n'est pas le dialogue lui-même).</p> - -<h4 id="Test_de_l.27acc.C3.A8s_au_clavier" name="Test_de_l.27acc.C3.A8s_au_clavier">Test de l'accès au clavier</h4> - -<p>Pour tester l'accessibilité au clavier <strong>débranchez ou désactivez simplement votre souris</strong> et essayez d'utiliser votre application uniquement avec le clavier. Vérifiez que l'ordre de tabulation est logique. Assurez-vous de pouvoir accéder à toutes les fonctions soit directement, soit par des moyens alternatifs comme des choix de menus ou des menus contextuels. Assurez-vous également que l'utilisateur puisse lire tout le contenu.</p> - -<h3 id="Informations_assistives" name="Informations_assistives">Informations assistives</h3> - -<p>Les utilisateurs de technologies assistives ont souvent besoin d'un balisage supplémentaire pour comprendre des significations et associations qui peuvent être intuitives pour les utilisateurs valides. Ce balisage supplémentaire est appelé <em>information assistive.</em> Il est aisé de fournir ces informations, mais on l'oublie souvent car elles ne produisent que très peu de changements visuels, voire aucun.</p> - -<h4 id="Texte_alternatif" name="Texte_alternatif">Texte alternatif</h4> - -<p><strong>Fournissez un texte alternatif pour les images significatives</strong>. Il n'est pas nécessaire d'ajouter un texte alternatif lorsqu'une image assure une fonction purement décorative. Utilisez l'attribut <code>alt</code> pour décrire les images HTML et l'attribut <code>tooltiptext</code> pour les éléments XUL utilisant des images (c'est-à-dire les éléments image et les boutons avec images). Pour les boutons de barres d'outils avec images, on recommande d'utiliser à la fois une étiquette textuelle dans l'attribut <em>label</em> et un texte alternatif pour l'image dans l'attribut <em>tooltiptext</em>. Voyez les exemples de code ci-dessous.</p> - -<pre><image src="stop.png" tooltiptext="Stop" /> - -<html:img src="stop.jpg" alt="Stop" /> -<html:img src="image_decorative.jpg" alt="" /> <!-- En HTML, l'attribut alt est obligatoire. --> - -<toolbarbutton label="Stop" image="stop.png" tooltiptext="Arrêter le chargement de la page" /> -</pre> - -<h4 id="Titres" name="Titres">Titres</h4> - -<p><strong>Fournissez des titres uniques</strong> aux éléments conteneurs des fenêtres, assistants et dialogues. Les titres fournissent aux utilisateurs les informations les informations les plus basiques concernant l'application. Le titre est souvent la première chose qui est prononcée par un lecteur d'écran lorsqu'une application est ouverte ou activée. Les utilisateurs peuvent également se référer au titre pour comprendre où ils se situent. Les titres sont affichés dans la barre supérieure d'une application. Voyez les exemples de code ci-dessous.</p> - -<pre><dialog id="print_dialog" title="Imprimer" ...> -<window id="mywindow" title="Mon application" ...> -<wizard id="reg_window" title="Enregistrer le logiciel" ...> -</pre> - -<h4 id="Labels_de_formulaires" name="Labels_de_formulaires">Labels de formulaires</h4> - -<p>Les labels ne sont pas automatiquement associés aux éléments de formulaires. <strong>Utilisez l'attribut <a href="/fr/XUL/label#a-control" title="fr/XUL/label#a-control">control</a></strong> pour lier une étiquette texte (d'un élément label ou de description) à un élément de formulaire. Les lecteurs d'écran liront alors le label lors du remplissage d'un champ de forumlaire.</p> - -<pre><label control="login-username" value="Utilisateur :"/> -<textbox id="login-username"/> - -<description control="login-password">Mot de passe :</description> -<textbox id="login-password" type="password"/> -</pre> - -<p>Les formulaires plus grand peuvent être difficiles à mettre en page et à structurer. Bien qu'il y ait toujours de nombreuses manières de structurer un formulaire visuellement, <strong>fournissez toujours un label texte pour chaque élément de formulaire</strong>. Il ne faut pas utiliser des éléments de formulaire pour en décrire d'autres.</p> - -<div class="float-right"><img alt="Capture d'écran du panneau Vie privé des options de Firefox." class="internal" src="/@api/deki/files/1325/=XUL_a11y_privacy.png"></div> - -<p>Lorsque des éléments de formulaire sont intégrés dans un groupbox avec une étiquette, les technologies assistives comme les lecteurs d'écran liront cette étiquette suivie du label de l'élément de formulaire. Par exemple, dans la section Vie privée des options, il y a trois groupes appelés <em>Historique</em>, <em>Cookies</em> et <em>Vie privée</em>. Si l'utilisateur se déplace avec la tabulation vers le bouton « Exceptions... », il entendra « cookies {pause} exceptions {pause} bouton. » L'élément suivant dira « cookies {pause} les conserver jusqu'à {pause} leur expiration {pause} un sur trois {pause} liste déroulante ». Si le lecteur d'écran lisait uniquement le label, l'utilisateur devrait deviner à quoi se référait le bouton « exceptions » ou la liste déroulante « les conserver jusqu'à ».</p> - -<p>Les groupes de contrôles sont essentiels pour les boutons radios ou groupes de cases à cocher concernant un thème similaire (c'est-à-dire où il faut cocher toutes celles qui s'appliquent). Si vous trouvez que des groupes de contrôles imbriqués sont peu agréables visuellement, utilisez CSS pour cacher la bordure du groupe interne afin qu'il reste visible dans le code pour servir aux utilisateurs de technologies assistives.</p> - -<p>Les formulaires complexes ont souvent besoin d'un système d'étiquetage plus avancé que ce qui est possible avec les attributs XUL standards. Par exemple, le premier élément du panneau Vie privée des options de Firefox (montré et décrit plus haut) est <code>[case à cocher] Se souvenir des pages visitées lors des [textbox] derniers jours</code>. La difficulté ici provient du fait que le label correct pour la case à cocher (« Se souvenir des pages visitées lors des x derniers jours ») est composé de trois pièces différentes, dont la seconde est la valeur actuellement entrée dans la boîte de texte. Le label correct pour la boîte de texte est en fait le même, mais on ne voudrait pas que les technologies assistives le lisent ou le montrent deux fois de suite. Ce qu'il faut, c'est une manière de spécifier dans le code source que la case à cocher, le champ d'édition et les labels textuels autour font tous partie d'une seule entité, et qu'ils s'étiquettent en quelque sorte l'un l'autre.</p> - -<p>Pour résoudre ce problème, on entourera d'abord tous ces contrôles dans un seul élément conteneur, comme (dans ce cas-ci) un <code>hbox</code>. On importe ensuite ce qu'on appelle « l'Accessible, Adaptable Applications Module » (du groupe WAI-ARIA du WC3) en ajoutant <em><span class="nowiki">xmlns:aaa="http://www.w3.org/2005/07/aaa"</span></em> comme attribut sur l'élément conteneur. Ceci nous permet d'utiliser l'attribut <em>labelledby</em> (notez le double L — aaa utilise l'orthographe anglaise du Royaume-Uni) pour spécifier que la case à cocher et la boîte de texte sont toutes deux décrites par l'ensemble du groupe de composants. Dans XUL, cela ressemblera à ce qui suit.</p> - -<pre><hbox id="historyBox" xmlns:aaa="http://www.w3.org/2005/07/aaa"> - <checkbox id="rememberHistoryDays" aaa:labelledby="historyBox" label="Se souvenir des pages visitées lors des"/> - <textbox id="historyDays" aaa:labelledby="historyBox"/> - <label>derniers jours.</label> -</hbox> -</pre> - -<h4 id="Test_des_informations_assistives" name="Test_des_informations_assistives">Test des informations assistives</h4> - -<p>La meilleure manière de tester est pour de nombreuses raisons de faire le test avec un lecteur d'écran, car la navigation au clavier et la structure sémantique sous-jacente de l'interface utilisateur peuvent être testées simultanément. C'est un excellent indicateur concernant l'accessibilité d'une interface utilisateur, mais en aucun cas un test complet. En fin de compte, pour les applications qui doivent être entièrement accessibles, il est préférable que l'application soit testée par un large panel d'utilisateurs disposant de différentes configurations logicielles et de différentes technologies assistives.</p> - -<p>Si vous ne disposez pas d'un logiciel lecteur d'écran (et ne connaissez personne dont c'est le cas), votre meilleure option est de vérifier attentivement le code source pour vous assurer que toutes les règles ci-dessus ont été suivies, et ensuite que les utilisateurs ont un moyen de vous contacter en retour sur l'accessibilité (et d'autres aspects) de votre application.</p> - -<h3 id="Affichage" name="Affichage">Affichage</h3> - -<p>On entend souvent que « la présentation fait tout ». Bien qu'il soit vrai que la présentation est quelque chose d'essentiel, les documents doivent également être structurés de manière à ce que l'utilisateur puisse appeler des préférences d'affichage qui peuvent être nécessaires pour l'accessibilité. La présentation doit aussi être flexible pour s'adapter au redimensionnement des fenêtres et polices. Les applications coopératives s'adaptent bien à l'environnement de l'utilisateur.</p> - -<h4 id="Param.C3.A8tres_par_d.C3.A9faut_du_syst.C3.A8me" name="Param.C3.A8tres_par_d.C3.A9faut_du_syst.C3.A8me">Paramètres par défaut du système</h4> - -<p><strong>Respectez les réglages par défaut du système</strong>. Beaucoup d'utilisateurs configurent leur ordinateur pour utiliser des polices plus grandes et/ou des thèmes de couleur particuliers. Par défaut, les menus XUL, labels et autres contrôles obtiennent leur police, taille et paramètres de couleur des réglages de l'utilisateur spécifiés par le système d'exploitation. Respectez ces réglages à moins d'avoir une raison particulière et inévitable de les changer. Le cas échéant, utilisez CSS pour dimensionner les éléments par rapport à leurs tailles par défaut (par exemple, utilisez des tailles en <code>%</code> ou <code>em</code> plutôt que des tailles spécifiques en points ou en pixels).</p> - -<h4 id="Couleurs" name="Couleurs">Couleurs</h4> - -<p>La couleur est un outil important. Des couleurs différentes peuvent donner des significations différentes aux objets et au texte. Cependant, <strong>la couleur seule est inadéquate</strong> pour communiquer un sens ou une information particulière à l'utilisateur. Certains, principalement ceux qui sont aveugles ou ne voient pas les couleurs, n'arriveront pas à discerner certaines couleurs. Certains utilisateurs peuvent modifier le schéma de couleurs par défaut de votre application. La couleur doit uniquement être utilisée pour souligner la signification d'un objet ou d'un texte après avoir donné cette signification à l'utilisateur d'une autre manière.</p> - -<h4 id="Tailles_flexibles" name="Tailles_flexibles">Tailles flexibles</h4> - -<p>Un des avantages d'XUL est que l'apparence visuelle est très facile à contrôler. Sur le Web, la mise en page est souvent contrainte dans une taille spécifique. Avec XUL, vous pouvez permettre aux éléments de s'étendre lorsque la fenêtre de l'application est redimensionnée. Utilisez l'attribut <code>flex</code> pour fournir cette fonctionnalité.</p> - -<h4 id="Test_de_l.27affichage" name="Test_de_l.27affichage">Test de l'affichage</h4> - -<p>Vérifiez que votre application est fonctionnelle et que son apparence est plaisante en utilisant des polices et couleurs définies par l'utilisateur. Pour cela, changez les paramètres d'affichage du système en un thème accessible (comme le thème Contraste élevé sous Windows, disponible par <code>Alt-Gauche + Maj-Gauche + Impr. Écran</code>). Assurez-vous que le texte est mis en évidence correctement que que la couleur n'est pas utilisée comme seule manière de communiquer une signification. Assurez-vous également que lorsque les fenêtres sont redimensionnées, votre application s'adapte de bonne grâce.</p> - -<h3 id="Interaction_entre_l.27homme_et_la_machine" name="Interaction_entre_l.27homme_et_la_machine">Interaction entre l'homme et la machine</h3> - -<p>Lorsque vous utilisez une application, vous vous attendez à disposer d'un certain contrôle et d'un retour sur ce qui se passe. Fournissez aux utilisateurs des instructions et indications claires, et permettez-leur de corriger leurs erreurs. Certains utilisateurs handicapés ont des difficultés lorsqu'on leur demande une réponse rapide. Donnez-leur un temps adéquat pour effectuer leurs tâches.</p> - -<h4 id="Instructions" name="Instructions">Instructions</h4> - -<p>Fournissez une documentation d'aide aux utilisateurs. Même des applications très simples devraient contenir un document d'aide ou un manuel de référence pour l'utilisateur. Décrivez les raccourcis claver et toutes autres considérations concernant l'accessibilité. Les utilisateurs doivent avoir la possibilité de consulter une description complète de toutes les fonctionnalités majeures d'une application. Fournissez également des détails sur l'utilisation de la documentation d'aide lorsqu'elle est longue ou complexe.</p> - -<h4 id="Avertissements" name="Avertissements">Avertissements</h4> - -<p>Utilisez des avertissements accessibles pour présenter des informations importantes à l'utilisateur. Utilisez des scripts ou l'élément <a href="/fr/XUL/notificationbox" title="fr/XUL/notificationbox">notificationbox</a> pour déclencher des alertes.</p> - -<p>Évitez d'utiliser uniquement des alertes audio ou visuelles pour signaler des évènements urgents. Les utilisateurs qui ont réduit ou coupé le son, ou qui sont sourds ou malentendants ne pourront pas reconnaître des alertes uniquement sonores. Les utilisateurs souffrant de déficiences visuelles ne verront pas non plus les alertes qui sont purement visuelles (à moins que celles-ci soient présentées dans un texte fonctionnel également accessible à un lecteur d'écran).</p> - -<h4 id=".C3.89l.C3.A9ments_interactifs" name=".C3.89l.C3.A9ments_interactifs">Éléments interactifs</h4> - -<p><strong>Évitez les petites cibles</strong>, qui sont difficiles à voir et à atteindre avec un clic de souris. Vérifiez que la mise en page et le contraste sont suffisants pour distinguer les éléments interactifs les un des autres et par rapport aux parties statiques de l'application.</p> - -<h4 id="R.C3.A9cup.C3.A9ration_en_cas_d.27erreur" name="R.C3.A9cup.C3.A9ration_en_cas_d.27erreur">Récupération en cas d'erreur</h4> - -<p>Lorsque l'utilisateur provoque une erreur dans une application, <strong>permettez une récupération aisée</strong>. Par exemple, si l'utilisateur entre des lettres là où un nombre est attendu dans un formulaire, cela ne doit pas faire planter l'application. L'utilisateur doit être averti du problème et pouvoir corriger l'erreur.</p> - -<h4 id="Temps_de_r.C3.A9ponse" name="Temps_de_r.C3.A9ponse">Temps de réponse</h4> - -<p>Le cas échéant, <strong>avertissez l'utilisateur des limites de temps</strong> et permettez-lui d'ajuster la limite ou de demander plus de temps. Un des miracles de la technologie moderne est qu'elle permet aux personnes souffrant même des plus sévères limitations physiques d'utiliser des ordinateurs. Certains utilisent des contrôles à la bouche ou des périphériques de détection de mouvements comme des capteurs oculaires pour entrer des informations. Ce processus peut être lent. D'autres utilisateurs ont simplement besoin de temps pour comprendre ce qui se produit dans l'application.</p> - -<h4 id="Test_de_l.27interaction_homme_machine" name="Test_de_l.27interaction_homme_machine">Test de l'interaction homme machine</h4> - -<p>Assurez-vous que la documentation d'aide est à jour. Vérifiez que les avertissements sont affichés à l'aides des éléments XUL appropriés. Assurez-vous que l'utilisateur est informé de toutes ses erreurs et que des instructions et la possibilité d'effectuer à nouveau l'opération correcte sont fournies. Assurez-vous également que les utilisateurs ont le contrôle de leur temps de réponse.</p> - -<h3 id="M.C3.A9dias" name="M.C3.A9dias">Médias</h3> - -<h4 id="Audio" name="Audio">Audio</h4> - -<p>Des fichiers audio d'information comme des podcasts peuvent être rendus accessibles en fournissant une transcription mot-à-mot. Les transcriptions doivent identifier correctement les intervenants et décrire les autres sons significatifs comme les rires ou les chansons. Ces transcriptions peuvent prendre du temps à réaliser, mais c'est la seule manière de rendre du contenu sonore accessible.</p> - -<h4 id="Vid.C3.A9os" name="Vid.C3.A9os">Vidéos</h4> - -<p>Un fichier vidéo peut être rendu accessible en ajoutant des sous-titres synchronisés. La plupart des formats vidéo fournissent un moyen d'afficher des sous-titres. Les vidéos devraient également être accompagnées de transcriptions descriptives. En général, ces deux opérations vont ensemble, une fois que vous avez l'une, il est facile de produire l'autre.</p> - -<table class="standard-table"> - <caption>En savoir plus</caption> - <tbody> - <tr> - <th>Sous-titrage</th> - </tr> - <tr> - <td><a class="external" href="http://webaim.org/techniques/captions/">Article de WebAIM : Web Captioning Overview</a><br> - <br> - <a class="external" href="http://webaim.org/resources/captioning/">WebAIM : Captioning Resources</a></td> - </tr> - </tbody> -</table> - -<h4 id="Animations" name="Animations">Animations</h4> - -<p>Les animations, le mouvement et les sons peuvent être dérangeantes pour certains utilisateurs souffrants de troubles de l'attention. Fournissez un mécanisme pour désactiver les médias et les mouvements.</p> - -<p>Les tremblements ou clignotements ne sont pas uniquement ennuyeux pour tout le monde, mais à une vitesse de plus de 3 cycles par seconde, ils peuvent provoquer un malaise chez les utilisateurs souffrant d'épilepsie photosensible. Si des tremblement ou clignotements sont nécessaires, avertissez l'utilisateur au préalable avant de les provoquer.</p> - -<h4 id="Test_de_m.C3.A9dias" name="Test_de_m.C3.A9dias">Test de médias</h4> - -<p>Assurez-vous que des alternatives aux médias sont disponibles dans un format accessible.</p> - -<h3 id="Autres_probl.C3.A8mes" name="Autres_probl.C3.A8mes">Autres problèmes</h3> - -<h4 id="Contr.C3.B4les_personnalis.C3.A9s" name="Contr.C3.B4les_personnalis.C3.A9s">Contrôles personnalisés</h4> - -<p>Évitez de recréer des fonctionnalités qui existent déjà. Assurez-vous que vos composants personnalisés sont construits en pensant à l'accessibilité. Utilisez les <a class="external" href="http://www.w3.org/TR/CSS21/ui.html#system-colors">couleurs système CSS</a> pour vous assurer que les nouveaux contrôles interagiront bien avec les autres contrôles ainsi qu'avec les thèmes et couleurs définis par l'utilisateur.</p> - -<table class="standard-table"> - <caption>En savoir plus</caption> - <tbody> - <tr> - <th>Contrôles personnalisés accessibles</th> - </tr> - <tr> - <td><a href="/fr/ARIA/Applications_riches_Internet_accessibles" title="fr/ARIA/Applications_riches_Internet_accessibles">ARIA : Applications riches Internet accessibles</a><br> - <br> - <a href="/fr/Réalisation_de_composants_personnalisés_accessibles_en_XUL" title="fr/Réalisation_de_composants_personnalisés_accessibles_en_XUL">Réalisation de composants personnalisés accessibles en XUL</a></td> - </tr> - </tbody> -</table> - -<h2 id="Liste_de_contr.C3.B4le_d.27accessibilit.C3.A9_pour_XUL" name="Liste_de_contr.C3.B4le_d.27accessibilit.C3.A9_pour_XUL">Liste de contrôle d'accessibilité pour XUL</h2> - -<p>Utilisez la liste de contrôle suivante pour vérifier rapidement l'accessibilité d'une nouvelle application XUL, ou comme point de départ pour régler les problèmes d'accessibilité dans une application existante.</p> - -<h3 id="Acc.C3.A8s_au_clavier_2" name="Acc.C3.A8s_au_clavier_2">Accès au clavier</h3> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Ordre de tabulation</th> - <td>Un ordre de tabulation logique est fourni.</td> - <td>L'ordre de tabulation saute de manière inattendue.</td> - </tr> - <tr> - <th scope="row">Arbres</th> - <td>Un accès au clavier est fourni pour les fonctions inaccessibles comme le sélecteur de colonnes ou le tri par colonnes.</td> - <td>Aucun accès au clavier n'est fourni pour le choix des colonnes ou d'autres fonctionnalités.</td> - </tr> - <tr> - <th scope="row">Boutons de barres d'outils</th> - <td>Des alternatives au clavier sont fournies pour les fonctionnalités des boutons de barres d'outils.</td> - <td>Aucune alternative au clavier n'est fournie pour les fonctionnalités des boutons de barres d'outils.</td> - </tr> - <tr> - <th scope="row">Raccourcis clavier</th> - <td>Des raccourcis clavier sont présents pour les fonctionnalités importantes</td> - <td>Aucun raccourci clavier n'est fourni.</td> - </tr> - <tr> - <th scope="row">Menus contextuels</th> - <td>Les menus contextuels sont déclenchés par le gestionnaire d'évènement <em>oncontextmenu</em>.</td> - <td>Les menus contextuels sont déclenchés directement par un clic droit de la souris ou un autre déclencheur spécifique.</td> - </tr> - <tr> - <th scope="row">Scripts dépendants de la souris</th> - <td>Toutes les opérations à la souris ont des équivalents accessibles au clavier.</td> - <td>Certaines opérations ne peuvent être réalisées qu'avec une souris.</td> - </tr> - <tr> - <th scope="row">Défilement</th> - <td>Tous les éléments défilables peuvent être contrôlés au clavier.</td> - <td>Le défilement ne peut pas se faire au clavier.</td> - </tr> - <tr> - <th scope="row">Focus</th> - <td>Le focus clavier est conservé et ne se déplace pas de manière inattendue.</td> - <td>Le focus se déplace ou est désactivé de manière inattendue.</td> - </tr> - </tbody> -</table> - -<h3 id="Informations_assistives_2" name="Informations_assistives_2">Informations assistives</h3> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Texte alternatif</th> - <td>Un texte alternatif est fourni pour les images significatives.</td> - <td>Le texte alternatif est manquant sur des images significatives, o n'est pas approprié pour la fonction d'une image.</td> - </tr> - <tr> - <th scope="row">Titres</th> - <td>Toutes les fenêtres, y compris les dialogues et les assistants, ont un titre descriptif.</td> - <td>Des fenêtres n'ont pas de titre ou un titre incorrect.</td> - </tr> - <tr> - <th scope="row">Labels de formulaires</th> - <td>Chaque élément de formulaire a un label associé et les boutons radios sont intégrés dans un groupbox.</td> - <td>Des éléments de formulaire n'ont pas de label ou ces labels ne sont pas connectés programmatiquement, ou des boutons radios ne font pas partie d'un groupbox.</td> - </tr> - </tbody> -</table> - -<h3 id="Affichage_2" name="Affichage_2">Affichage</h3> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Réglages par défaut du système</th> - <td>Les paramètres systèmes sont respectés.</td> - <td>Les paramètres systèmes ne sont pas respectés.</td> - </tr> - <tr> - <th scope="row">Couleurs</th> - <td>La couleur seule n'est pas utilisée pour donner une signification, et le contraste entre le texte et la couleur de fond est suffisant.</td> - <td>La couleur seule est utilisée pour donner une signification, ou le contraste entre le texte et la couleur de fond est insuffisant.</td> - </tr> - <tr> - <th scope="row">Flexibilité</th> - <td>Les éléments visuels et leurs conteneurs se redimensionnent.</td> - <td>Les éléments visuels et leurs conteneurs ne se redimensionnent pas.</td> - </tr> - </tbody> -</table> - -<h3 id="Interaction_homme-machine" name="Interaction_homme-machine">Interaction homme-machine</h3> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Instructions</th> - <td>Une documentation d'aide est fournie, avec une description des raccourcis clavier.</td> - <td>Aucune documentation d'aide n'est fournie, ou celle-ci est incomplète.</td> - </tr> - <tr> - <th scope="row">Avertissements</th> - <td>Les alertes sont affichées à l'aide de la fonction de script <code>alert()</code> ou l'élément <code>notificationbox</code>.</td> - <td>Les alertes sont uniquement visuelles ou audifives, ou utilisent une autre méthode que la fonction de script <code>alert()</code> ou l'élément <code>notificationbox</code>.</td> - </tr> - <tr> - <th scope="row">Éléments interactifs</th> - <td>Les éléments interactifs sont suffisamment grands et visibles.</td> - <td>Les éléments interactifs sont trop petits ou insuffisamment contrastés par rapport aux autres parties de l'application.</td> - </tr> - <tr> - <th scope="row">Récupération en cas d'erreur</th> - <td>Des avertissements sont affichés lorsque l'utilisateur commet une erreur. Il reçoit ensuite la possibilité et des instructions pour la corriger.</td> - <td>Aucun message d'erreur n'existe, ou des instructions inadéquates sont fournies.</td> - </tr> - <tr> - <th scope="row">Temps de réponse</th> - <td>L'utilisateur est informé des limites des temps et a le contrôle de cette limite lorsque c'est possible.</td> - <td>L'utilisateur n'est pas informé des limites de temps et/ou n'a aucun contrôle sur celles-ci.</td> - </tr> - </tbody> -</table> - -<h3 id="M.C3.A9dias_2" name="M.C3.A9dias_2">Médias</h3> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Audio</th> - <td>Des transcriptions sont fournies pour les pistes sonores.</td> - <td>Aucune transcription n'est fournie.</td> - </tr> - <tr> - <th scope="row">Vidéos</th> - <td>Les vidéos sont sous-titrées et une transcription est fournie.</td> - <td>Aucun sous-titre ou transcription n'est fourni.</td> - </tr> - <tr> - <th scope="row">Animations</th> - <td>L'utilisateur peut contrôler les animations et est prévenu lorsque le contenu va clignoter.</td> - <td>Il n'existe pas de contrôle pour les animations ni d'avertissements pour les clignotements.</td> - </tr> - </tbody> -</table> - -<h3 id="Autres" name="Autres">Autres</h3> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th scope="col">Point à vérifier</th> - <th scope="col">Correct</th> - <th scope="col">Incorrect</th> - </tr> - <tr> - <th scope="row">Contrôles personnalisés</th> - <td>Les contrôles personnalisés sont accessibles.</td> - <td>Les contrôles personnalisés ne sont pas accessibles.</td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/mozilla/xul/richlistbox/index.html b/files/fr/archive/mozilla/xul/richlistbox/index.html deleted file mode 100644 index db0f4dacc7..0000000000 --- a/files/fr/archive/mozilla/xul/richlistbox/index.html +++ /dev/null @@ -1,268 +0,0 @@ ---- -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"><richlistbox> - <richlistitem> - <description>Une description XUL !</description> - </richlistitem> - <richlistitem> - <button label="Un bouton XUL"/> - </richlistitem> -</richlistbox> -</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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</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><magic name="\"PAGENAME\"/"></magic></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><magic name="\"PAGENAME\"/">Des cellules individuelles peuvent être sélectionnées.</magic><magic name="\"PAGENAME\"/"> Des lignes sont sélectionnées, cependant, l'indicateur de sélection n'est visible que sur le texte de la colonne principale.</magic></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><magic name="\"PAGENAME\"/"></magic></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> diff --git a/files/fr/archive/mozilla/xul/richlistitem/index.html b/files/fr/archive/mozilla/xul/richlistitem/index.html deleted file mode 100644 index ee24a5cf8e..0000000000 --- a/files/fr/archive/mozilla/xul/richlistitem/index.html +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: richlistitem -slug: Archive/Mozilla/XUL/richlistitem -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/richlistitem ---- -<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>Un élément individuel dans une <code><a href="/fr/docs/Mozilla/Tech/XUL/richlistbox" title="richlistbox">richlistbox</a></code>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-selected">selected</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-accessible">accessible</a>, <a href="#p-control">control</a>, <a href="#p-disabled">disabled</a>, <a href="#p-label">label</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-selected"> - -<dl><dt> <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selectedItem">selectedItem</a></span></code> de l'élément conteneur. -</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-accessible"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-control"></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-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-selected"> - -<dl> -<dt><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/selected">selected</a></span></code> </dt> -<dd>Type : <i>booléen</i></dd> -<dd>La valeur de cette propriété est <code>true</code> si cet élément est sélectionné, ou <code>false</code> s'il ne l'est pas. Cette propriété est en lecture seule.</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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<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/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/référence_xul/index.html b/files/fr/archive/mozilla/xul/référence_xul/index.html deleted file mode 100644 index 0ab0677e2f..0000000000 --- a/files/fr/archive/mozilla/xul/référence_xul/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: Référence XUL -slug: Archive/Mozilla/XUL/Référence_XUL -tags: - - Aide_pour_les_éditeurs_de_MDC - - Référence_XUL - - Traduction_en_cours - - XUL -translation_of: Archive/Mozilla/XUL/XUL_Reference ---- -<p>« <a href="/en-US/docs/XUL" title="en-US/XUL">XUL Reference</a> «Consultez également la <a class="external" href="http://xulfr.org/wiki/Reference/Xul">Référence XUL</a> du wiki XULfr.org.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th colspan="3">Tous les éléments XUL</th> - </tr> - <tr> - <td> - <p><a href="/fr/docs/XUL/action" title="fr/docs/XUL/action">action</a> <small>(<a href="/en/XUL/action">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/action">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/arrowscrollbox" title="fr/docs/XUL/arrowscrollbox">arrowscrollbox</a> <small>(<a href="/en/XUL/arrowscrollbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/arrowscrollbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/assign" title="fr/docs/XUL/assign">assign</a> <small>(<a href="/en/XUL/assign">en</a>)</small><br> - <a href="/fr/docs/XUL/bbox" title="fr/docs/XUL/bbox">bbox</a> <small>(<a href="/en/XUL/bbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/bbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/binding" title="fr/docs/XUL/binding">binding</a> <small>(<a href="/en/XUL/binding">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/binding">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/bindings" title="fr/docs/XUL/bindings">bindings</a> <small>(<a href="/en/XUL/bindings">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/bindings">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/box" title="fr/docs/XUL/box">box</a> <small>(<a href="/en/XUL/box">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/box">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/broadcaster" title="fr/docs/XUL/broadcaster">broadcaster</a> <small>(<a href="/en/XUL/broadcaster">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/broadcaster">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/broadcasterset" title="fr/docs/XUL/broadcasterset">broadcasterset</a> <small>(<a href="/en/XUL/broadcasterset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/broadcasterset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/button" title="fr/docs/XUL/button">button</a> <small>(<a href="/en/XUL/button">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/button">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/browser" title="fr/docs/XUL/browser">browser</a> <small>(, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/browser">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/checkbox" title="fr/docs/XUL/checkbox">checkbox</a> <small>(<a href="/en/XUL/checkbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/checkbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/caption" title="fr/docs/XUL/caption">caption</a> <small>(<a href="/en/XUL/caption">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/caption">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/colorpicker" title="fr/docs/XUL/colorpicker">colorpicker</a> <small>(<a href="/en/XUL/colorpicker">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/colorpicker">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/column" title="fr/docs/XUL/column">column</a> <small>(<a href="/en/XUL/column">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/column">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/columns" title="fr/docs/XUL/columns">columns</a> <small>(<a href="/en/XUL/columns">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/columns">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/commandset" title="fr/docs/XUL/commandset">commandset</a> <small>(<a href="/en/XUL/commandset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/commandset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/command" title="fr/docs/XUL/command">command</a> <small>(<a href="/en/XUL/command">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/command">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/conditions" title="fr/docs/XUL/conditions">conditions</a> <small>(<a href="/en/XUL/conditions">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/conditions">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/content" title="fr/docs/XUL/content">content</a> <small>(<a href="/en/XUL/content">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/content">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/datepicker" title="fr/docs/XUL/datepicker">datepicker</a><br> - <a href="/fr/docs/XUL/deck" title="fr/docs/XUL/deck">deck</a> <small>(<a href="/en/XUL/deck">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/deck">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/description" title="fr/docs/XUL/description">description</a> <small>(<a href="/en/XUL/description">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/description">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/dialog" title="fr/docs/XUL/dialog">dialog</a> <small>(<a href="/en/XUL/dialog">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/dialog">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/dialogheader" title="fr/docs/XUL/dialogheader">dialogheader</a> <small>(<a href="/en/XUL/arrowscrollbox">en</a>)</small><br> - <a href="/fr/docs/XUL/dropmarker" title="fr/docs/XUL/dropmarker">dropmarker</a><br> - <a href="/fr/docs/XUL/editor" title="fr/docs/XUL/editor">editor</a> <small>(<a href="/en/XUL/editor">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/editor">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/grid" title="fr/docs/XUL/grid">grid</a> <small>(<a href="/en/XUL/grid">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/grid">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/Grippy" title="/fr/docs/XUL/Grippy">grippy</a> <small>(<a href="/en/XUL/grippy'">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/grippy">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/groupbox" title="fr/docs/XUL/groupbox">groupbox</a> <small>(<a href="/en/XUL/groupbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/groupbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/hbox" title="fr/docs/XUL/hbox">hbox</a> <small>(<a href="/en/XUL/hbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/hbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/iframe" title="fr/docs/XUL/iframe">iframe</a> <small>(<a href="/en/XUL/iframe">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/iframe">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/image" title="fr/docs/XUL/image">image</a> <small>(<a href="/en/XUL/image">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/image">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/key" title="fr/docs/XUL/key">key</a> <small>(<a href="/en/XUL/key">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/key">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/keyset" title="fr/docs/XUL/keyset">keyset</a> <small>(<a href="/en/XUL:keyset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/keyset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/label" title="fr/docs/XUL/label">label</a> <small>(<a href="/en/XUL/label">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/label">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listbox" title="fr/docs/XUL/listbox">listbox</a> <small>(<a href="/en/XUL/listbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listcell" title="fr/docs/XUL/listcell">listcell</a> <small>(<a href="/en/XUL/listcell">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listcell">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listcol" title="fr/docs/XUL/listcol">listcol</a> <small>(<a href="/en/XUL/listcol">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listcol">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listcols" title="fr/docs/XUL/listcols">listcols</a> <small>(<a href="/en/XUL/listcols">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listcols">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listhead" title="fr/docs/XUL/listhead">listhead</a> <small>(<a href="/en/XUL/listhead">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listhead">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/listheader" title="fr/docs/XUL/listheader">listheader</a> <small>(<a href="/en/XUL/listheader">en</a>)</small><br> - <a href="/fr/docs/XUL/listitem" title="fr/docs/XUL/listitem">listitem</a> <small>(<a href="/en/XUL/listitem">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/listitem">xulfr</a>)</small></p> - </td> - <td> - <p><a href="/fr/docs/XUL/member" title="fr/docs/XUL/member">member</a> <small>(<a href="/en/XUL/member">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/member">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menu" title="fr/docs/XUL/menu">menu</a> <small>(<a href="/en/XUL/menu">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menu">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menubar" title="fr/docs/XUL/menubar">menubar</a> <small>(<a href="/en/XUL/menubar">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menubar">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menuitem" title="fr/docs/XUL/menuitem">menuitem</a> <small>(<a href="/en/XUL/menuitem">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menuitem">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menulist" title="fr/docs/XUL/menulist">menulist</a> <small>(<a href="/en/XUL/menulist">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menulist">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menupopup" title="fr/docs/XUL/menupopup">menupopup</a> <small>(<a href="/en/XUL/menupopup">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menupopup">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/menuseparator" title="fr/docs/XUL/menuseparator">menuseparator</a> <small>(<a href="/en/XUL/menuseparator">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/menuseparator">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/notification" title="fr/docs/XUL/notification">notification</a> <small>(<a href="/en/XUL/notification">en</a>)</small><br> - <a href="/fr/docs/XUL/notificationbox" title="fr/docs/XUL/notificationbox">notificationbox</a> <small>(<a href="/en/XUL/notificationbox">en</a>)</small><br> - <a href="/fr/docs/XUL/observes" title="fr/docs/XUL/observes">observes</a> <small>(<a href="/en/XUL/observes">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/observes">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/overlay" title="fr/docs/XUL/overlay">overlay</a> <small>(<a href="/en/XUL/overlay">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/overlay">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/page" title="fr/docs/XUL/page">page</a> <small>(<a href="/en/XUL/page">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/page">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/panel" title="fr/docs/XUL/panel">panel</a><br> - <a href="/fr/docs/XUL/param" title="fr/docs/XUL/param">param</a> <small>(<a href="/en/XUL/param">en</a>)</small><br> - <a href="/fr/docs/XUL/popup" title="fr/docs/XUL/popup">popup</a> <small>(<a href="/en/XUL/popup">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/popup">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/popupset" title="fr/docs/XUL/popupset">popupset</a> <small>(<a href="/en/XUL/popupset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/popupset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/preference" title="fr/docs/XUL/preference">preference</a><br> - <a href="/fr/docs/XUL/preferences" title="fr/docs/XUL/preferences">preferences</a><br> - <a href="/fr/docs/XUL/prefpane" title="fr/docs/XUL/prefpane">prefpane</a><br> - <a href="/fr/docs/XUL/prefwindow" title="fr/docs/XUL/prefwindow">prefwindow</a><br> - <a href="/fr/docs/XUL/progressmeter" title="fr/docs/XUL/progressmeter">progressmeter</a> <small>(<a href="/en/XUL/progressmeter">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/progressmeter">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/query" title="fr/docs/XUL/query">query</a> <small>(<a href="/en/XUL/query">en</a>)</small><br> - <a href="/fr/docs/XUL/queryset" title="fr/docs/XUL/queryset">queryset</a> <small>(<a href="/en/XUL/queryset">en</a>)</small><br> - <a href="/fr/docs/XUL/radio" title="fr/docs/XUL/radio">radio</a> <small>(<a href="/en/XUL/radio">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/radio">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/radiogroup" title="fr/docs/XUL/radiogroup">radiogroup</a> <small>(<a href="/en/XUL/radiogroup">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/radiogroup">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/resizer" title="fr/docs/XUL/resizer">resizer</a> <small>(<a href="/en/XUL/resizer">en</a>)</small><br> - <a href="/fr/docs/XUL/richlistbox" title="fr/docs/XUL/richlistbox">richlistbox</a><br> - <a href="/fr/docs/XUL/richlistitem" title="fr/docs/XUL/richlistitem">richlistitem</a><br> - <a href="/fr/docs/XUL/row" title="fr/docs/XUL/row">row</a> <small>(<a href="/en/XUL/row">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/row">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/rows" title="fr/docs/XUL/rows">rows</a> <small>(<a href="/en/XUL/rows">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/rows">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/rule" title="fr/docs/XUL/rule">rule</a> <small>(<a href="/en/XUL/rule">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/rule">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/scale" title="fr/docs/XUL/scale">scale</a><br> - <a href="/fr/docs/XUL/script" title="fr/docs/XUL/script">script</a> <small>(<a href="/en/XUL/script">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/script">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/scrollbar" title="fr/docs/XUL/scrollbar">scrollbar</a> <small>(<a href="/en/XUL/scrollbar">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/scrollbar">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/scrollbox" title="fr/docs/XUL/scrollbox">scrollbox</a> <small>(<a href="/en/XUL/scrollbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/scrollbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/scrollcorner" title="fr/docs/XUL/scrollcorner">scrollcorner</a> <small>(<a href="/en/XUL/scrollcorner">en</a>)</small><br> - <a href="/fr/docs/XUL/separator" title="fr/docs/XUL/separator">separator</a> <small>(<a href="/en/XUL/separator">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/separator">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/spacer" title="fr/docs/XUL/spacer">spacer</a> <small>(<a href="/en/XUL/spacer">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/spacer">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/spinbuttons" title="fr/docs/XUL/spinbuttons">spinbuttons</a><br> - <a href="/fr/docs/XUL/splitter" title="fr/docs/XUL/splitter">splitter</a> <small>(<a href="/en/XUL/splitter">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/splitter">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/stack" title="fr/docs/XUL/stack">stack</a> <small>(<a href="/en/XUL/stack">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/stack">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/statusbar" title="fr/docs/XUL/statusbar">statusbar</a> <small>(<a href="/en/XUL/statusbar">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/statusbar">xulfr</a>)</small></p> - </td> - <td> - <p><a href="/fr/docs/XUL/statusbarpanel" title="fr/docs/XUL/statusbarpanel">statusbarpanel</a> <small>(<a href="/en/XUL/statusbarpanel">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/statusbarpanel">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/stringbundle" title="fr/docs/XUL/stringbundle">stringbundle</a> <small>(<a href="/en/XUL/stringbundle">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/stringbundle">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/stringbundleset" title="fr/docs/XUL/stringbundleset">stringbundleset</a> <small>(<a href="/en/XUL/stringbundleset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/stringbundleset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tab" title="fr/docs/XUL/tab">tab</a> <small>(<a href="/en/XUL/tab">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tab">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tabbrowser" title="fr/docs/XUL/tabbrowser">tabbrowser</a> <small>(<a href="/en/XUL/tabbrowser">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tabbrowser">xulfr</a>)</small> (Firefox uniquement<br> - à partir de Firefox 3/Gecko 1.9)<br> - <a href="/fr/docs/XUL/tabbox" title="fr/docs/XUL/tabbox">tabbox</a> <small>(<a href="/en/XUL/tabbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tabbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tabpanel" title="fr/docs/XUL/tabpanel">tabpanel</a> <small>(<a href="/en/XUL/tabpanel">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tabpanel">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tabpanels" title="fr/docs/XUL/tabpanels">tabpanels</a> <small>(<a href="/en/XUL/tabpanels">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tabpanels">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tabs" title="fr/docs/XUL/tabs">tabs</a> <small>(<a href="/en/XUL/tabs">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tabs">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/template" title="fr/docs/XUL/template">template</a> <small>(<a href="/en/XUL/template">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/template">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/textnode" title="fr/docs/XUL/textnode">textnode</a> <small>(<a href="/en/XUL/textnode">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/textnode">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/textbox" title="fr/docs/XUL/textbox">textbox</a> <small>(<a href="/en/XUL/textbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/textbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/textbox_(autocomplétion_de_Firefox)" title="fr/docs/XUL/textbox_(autocomplétion_de_Firefox)">textbox (autocomplétion de Firefox)</a> <small>(<a href="/en/XUL/textbox_(Firefox_autocomplete)">en</a>)</small><br> - <a href="/fr/docs/XUL/textbox_(autocomplétion_de_Mozilla)" title="fr/docs/XUL/textbox_(autocomplétion_de_Mozilla)">textbox (autocomplétion de Mozilla)</a> <small>(<a href="/en/XUL/textbox_(Mozilla_autocomplete)">en</a>)</small><br> - <a href="/fr/docs/XUL/timepicker" title="fr/docs/XUL/timepicker">timepicker</a><br> - <a href="/fr/docs/XUL/titlebar" title="fr/docs/XUL/titlebar">titlebar</a> <small>(<a href="/en/XUL/titlebar">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/titlebar">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbar" title="fr/docs/XUL/toolbar">toolbar</a> <small>(<a href="/en/XUL/toolbar">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbar">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbarbutton" title="fr/docs/XUL/toolbarbutton">toolbarbutton</a> <small>(<a href="/en/XUL/toolbarbutton">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbarbutton">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbargrippy" title="fr/docs/XUL/toolbargrippy">toolbargrippy</a> <small>(<a href="/en/XUL/toolbargrippy">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbargrippy">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbaritem" title="fr/docs/XUL/toolbaritem">toolbaritem</a> <small>(<a href="/en/XUL/toolbaritem">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbaritem">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbarpalette" title="fr/docs/XUL/toolbarpalette">toolbarpalette</a> <small>(<a href="/en/XUL/toolbarpalette">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbarpalette">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbarseparator" title="fr/docs/XUL/toolbarseparator">toolbarseparator</a> <small>(<a href="/en/XUL/toolbarseparator">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbarseparator">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbarset" title="fr/docs/XUL/toolbarset">toolbarset</a> <small>(<a href="/en/XUL/toolbarset">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbarset">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/toolbarspacer" title="fr/docs/XUL/toolbarspacer">toolbarspacer</a> <small>({<a href="/en/XUL/toolbarspacer">en</a>)</small><br> - <a href="/fr/docs/XUL/toolbarspring" title="fr/docs/XUL/toolbarspring">toolbarspring</a> <small>(<a href="/en/XUL/toolbarspring">en</a>)</small><br> - <a href="/fr/docs/XUL/toolbox" title="fr/docs/XUL/toolbox">toolbox</a> <small>(<a href="/en/XUL/toolbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/toolbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tooltip" title="fr/docs/XUL/tooltip">tooltip</a> <small>({<a href="/en/XUL/tooltip">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tooltip">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/tree" title="fr/docs/XUL/tree">tree</a> <small>(<a href="/en/XUL/tree">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/tree">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treecell" title="fr/docs/XUL/treecell">treecell</a> <small>({<a href="/en/XUL/treecel">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treecel">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treechildren" title="fr/docs/XUL/treechildren">treechildren</a> <small>(<a href="/en/XUL/treechildren">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treechildren">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treecol" title="fr/docs/XUL/treecol">treecol</a> <small>(<a href="/en/XUL/treecol">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treecol">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treecols" title="fr/docs/XUL/treecols">treecols</a> <small>(<a href="/en/XUL/treecols">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treecols">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treeitem" title="fr/docs/XUL/treeitem">treeitem</a> <small>({<a href="/en/XUL/treeitem">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treeitem">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treerow" title="fr/docs/XUL/treerow">treerow</a> <small>(<a href="/en/XUL/treerow">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treerow">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/treeseparator" title="fr/docs/XUL/treeseparator">treeseparator</a> <small>(<a href="/en/XUL/treeseparator">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/treeseparator">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/triple" title="fr/docs/XUL/triple">triple</a> <small>({<a href="/en/XUL/triple">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/triple">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/vbox" title="fr/docs/XUL/vbox">vbox</a> <small>(<a href="/en/XUL/vbox">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/vbox">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/where" title="fr/docs/XUL/where">where</a> <small>(<a href="/en/XUL/where">en</a>)</small><br> - <a href="/fr/docs/XUL/window" title="fr/docs/XUL/window">window</a> <small>(<a href="/en/XUL/window">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/window">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/wizard" title="fr/docs/XUL/wizard">wizard</a> <small>(<a href="/en/XUL/wizard">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/wizard">xulfr</a>)</small><br> - <a href="/fr/docs/XUL/wizardpage" title="fr/docs/XUL/wizardpage">wizardpage</a> <small>(<a href="/en/XUL/wizardpage">en</a>, <a class="external" href="http://xulfr.org/wiki/Reference/Xul/wizardpage">xulfr</a>)</small></p> - </td> - </tr> - </tbody> -</table> - -<h3 id="Autres_listes_sur_XUL" name="Autres_listes_sur_XUL">Autres listes sur XUL</h3> - -<ul> - <li><a href="/fr/docs/XUL/Attributs" title="fr/docs/XUL/Attributs">Tous les attributs</a></li> - <li><a href="/fr/docs/XUL/Propriétés" title="fr/docs/XUL/Propriétés">Toutes les propriétés</a></li> - <li><a href="/fr/docs/XUL/Méthodes" title="fr/docs/XUL/Méthodes">Toutes les méthodes</a></li> - <li><a href="/fr/Attributs_des_éléments_XUL" title="fr/Attributs_des_éléments_XUL">Attributs définis pour tous les éléments XUL</a></li> - <li><a href="/fr/docs/XUL/Évènements" title="fr/docs/XUL/Évènements">Gestionnaires d'évènements</a> <small>(à traduire de <a href="/en/XUL/Events">en:XUL:Events</a>)</small></li> - <li><a href="/fr/docs/XUL/Balisage_obsolète//ancien" title="fr/docs/XUL/Balisage_obsolète//ancien">Balisage obsolète/ancien</a> <small>(à traduire de <a href="/en/Deprecated/Defunct_Markup">en:Deprecated/Defunct Markup</a>)</small></li> -</ul> diff --git a/files/fr/archive/mozilla/xul/scale/index.html b/files/fr/archive/mozilla/xul/scale/index.html deleted file mode 100644 index a4ae7e44e9..0000000000 --- a/files/fr/archive/mozilla/xul/scale/index.html +++ /dev/null @@ -1,255 +0,0 @@ ---- -title: scale -slug: Archive/Mozilla/XUL/scale -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/scale ---- -<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>Un élément <code>scale</code> (parfois appelé <i>slider</i>) permet à l'utilisateur de sélectionner une valeur dans un intervalle. Une barre affichée horizontalement ou verticalement lui permet de choisir une valeur en glissant une poignée sur la barre. -</p><p>Utilisez l'attribut <code>orient</code> pour spécifier l'orientation de l'échelle. La valeur par défaut est <tt>horizontal</tt> qui affiche une barre horizontale. Les valeurs inférieures sont à gauche et les valeurs supérieurs à droite. Pour utiliser une échelle verticale, définissez l'attribut <code>orient</code> à <tt>vertical</tt>. -</p><p>L'utilisateur peut utiliser les touches fléchées du clavier pour incrémenter ou décrémenter la valeur d'une unité, ou les touches <kbd>PagePréc</kbd> et <kbd>PageSuiv</kbd> pour incrémenter ou décrémenter la valeur d'une page, telle que spécifiée par l'attribut <code>pageincrement</code>. Les touches <kbd>Origine</kbd> et <kbd>Fin</kbd> définissent respectivement la valeur au minimum et au maximum. Un évènement <code>change</code> sera déclenché par l'élément chaque fois que sa valeur est modifiée. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-dir">dir</a>, <a href="#a-disabled">disabled</a>, <a href="#a-increment">increment</a>, <a href="#a-max">max</a>, <a href="#a-min">min</a>, <a href="#a-pageincrement">pageincrement</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-disabled">disabled</a>, <a href="#p-max">max</a>, <a href="#p-min">min</a>, <a href="#p-increment">increment</a>, <a href="#p-pageIncrement">pageIncrement</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a>, </dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-decrease">decrease</a>, <a href="#m-decreasePage">decreasePage</a>, <a href="#m-increase">increase</a>, <a href="#m-increasePage">increasePage</a>, -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>Échelle horizontale : -</p> -<pre><scale min="1" max="10"/> -</pre> -<p><img alt="Image:Controlguide-scale.png"> -</p><p>Échelle verticale : -</p> -<pre><scale min="1" max="10" orient="vertical"/> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-dir"> - -<dl> - <dt> - <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code></dt> - <dd> - Type : - <i> - une des valeurs ci-dessous</i> - </dd> - <dd> - La direction dans laquelle les éléments enfants de l'élément seront placés.</dd> -</dl> -<ul> - <li><code>normal</code> : <magic name="\"PAGENAME\"/">Les valeurs de l'échelle sont triées de gauche à droite (pour les échelles horizontales) ou de haut en bas (pour les échelles verticales)., Les éléments sont placés de gauche à droite ou de haut en bas dans l'ordre dans lequel ils apparaissent dans le code XUL.)</magic></li> - <li><code>reverse</code> : Les valeurs de l'échelle sont triées de droite à gauche (pour les échelles horizontales) ou de bas en haut (pour les échelles verticales)., Les éléments sont placés de droite à gauche ou de bas en haut. C'est le contraire de l'ordre dans lequel ils apparaissent dans le code XUL.)</li> -</ul> - -<p> </p> -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-increment"> - -<dl> - <dt> - <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La quantité dont l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> (pour les boîtes numériques et les échelles) or <code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code><magic name="\"PAGENAME\"/"> (pour les barres de défilement) </magic> change lorsque l'on clique sur les flèches. La valeur par défaut est 1.</dd> -</dl> -</div> -<div id="a-min"> - -<dl> - <dt> - <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur minimum que peut prendre l'élément. La valeur par défaut est 0.</dd> -</dl> -</div> -<div id="a-max"> - -<dl> - <dt> - <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur maximum que peut prendre l'élément scale ou number box. La valeur par défaut est <code>100</code> pour les éléments scale et <code>Infinity</code> pour les boîtes numériques</dd> -</dl> -</div> -<div id="a-pageincrement"> - -<dl> - <dt> - <code id="a-pageincrement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pageincrement">pageincrement</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La quantité de laquelle la valeur de l'attribut <code>curpos</code> ou <code>value</code> change lorsque l'utilisateur clique dans la colonne de la barre de défilement (la zone dans laquelle le curseur de la barre se déplace), ou lorsque les touches <kbd>PgUp</kbd> ou <kbd>PgDown</kbd> sont utilisées. La valeur par défaut est 10.</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-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-increment"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/increment">increment</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Obtient et définit la valeur de l'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code>.</dd> -</dl></div> -<div id="p-min"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/min">min</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-max"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/max">max</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-pageIncrement"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/pageIncrement">pageIncrement</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-pageincrement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pageincrement">pageincrement</a></code>. -</dd></dl> -<p><br> -</p> - -</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> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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-decrease"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/decrease">decrease()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Diminue la valeur de<magic name="\"PAGENAME\"/"> la boîte numérique l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> -<dl><dt> <span id="m-decreasePage"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/decreasePage">decreasePage()</a></code></span></dt> -<dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Diminue la valeur de l'échelle de la valeur de <code>pageIncrement</code>. -</dd></dl> -<p><br> -</p> -<dl> - <dt> - <span id="m-increase"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/increase">increase()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Augmente la valeur de <magic name="\"PAGENAME\"/">la boîte numérique, XUL:scale = l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> -<p> </p> - - -<dl><dt> <span id="m-increasePage"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/increasePage">increasePage()</a></code></span></dt> -<dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Augmente la valeur de l'échelle de la valeur de <code>pageIncrement</code>. -</dd></dl> -<p><br> -</p> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIDOMXULControlElement">nsIDOMXULControlElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/spacer/index.html b/files/fr/archive/mozilla/xul/spacer/index.html deleted file mode 100644 index 259c7f355f..0000000000 --- a/files/fr/archive/mozilla/xul/spacer/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: spacer -slug: Archive/Mozilla/XUL/spacer -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/spacer ---- -<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>Un élément qui occupe de l'espace mais n'affiche rien. On l'utilise généralement pour occuper de la place dans un conteneur. Si l'on ne spécifie pas de taille ou de flexibilité à cet élément, le spacer n'occupe aucune place. Si vous voulez créer un léger espacement, pensez à utiliser plutôt un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/separator" title="separator">separator</a></code>. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Utilisation_des_spacers">Tutoriel XUL</a>. -</p> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre class="eval"><box> - <button label="Gauche"/> - <spacer flex="1"/> - <button label="Droite"/> -</box> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt>Éléments -</dt><dd><code><a href="/fr/docs/Mozilla/Tech/XUL/separator" title="separator">separator</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/splitter" title="splitter">splitter</a></code> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/spinbuttons/index.html b/files/fr/archive/mozilla/xul/spinbuttons/index.html deleted file mode 100644 index e493ea9919..0000000000 --- a/files/fr/archive/mozilla/xul/spinbuttons/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: spinbuttons -slug: Archive/Mozilla/XUL/spinbuttons -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/spinbuttons ---- -<p> -</p> -<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><br> -Les <code>spinbuttons</code> sont constitués de deux flèches, une pour augmenter une valeur et une autre pour la diminuer. Ils ne sont pas utilisés comme des éléments distincts, mais en combinaison avec d'autres éléments pour créer un contrôle dont la valeur peut être augmentée et diminuée. -</p><p>Par exemple, on utilise les <code>spinbuttons</code> pour les boîtes texte (<code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>) de type numérique, ainsi qu'avec les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/timepicker" title="timepicker">timepicker</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/datepicker" title="datepicker">datepicker</a></code>. -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/stack/index.html b/files/fr/archive/mozilla/xul/stack/index.html deleted file mode 100644 index ac42647df3..0000000000 --- a/files/fr/archive/mozilla/xul/stack/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: stack -slug: Archive/Mozilla/XUL/stack -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/stack ---- -<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>Un élément qui affiche ses enfants en pile les uns au dessus des autres. Le premier élément est placé en bas et chacun des enfants successifs est placé au dessus du précédent. Tous les éléments sont affichés en une fois. Des éléments enfants peuvent également être placés à des positions absolues dans la pile. -</p><p>Les attributs <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> et <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code> sur un enfant de l'élément <code>stack</code> spécifient la position de cet élément. </p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Piles_et_Paquets">Tutoriel XUL</a>. -</p> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p><a href="fr/XUL/deck">deck</a> -</p> diff --git a/files/fr/archive/mozilla/xul/tabpanels/index.html b/files/fr/archive/mozilla/xul/tabpanels/index.html deleted file mode 100644 index 9c55a5f6dc..0000000000 --- a/files/fr/archive/mozilla/xul/tabpanels/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: tabpanels -slug: Archive/Mozilla/XUL/tabpanels -translation_of: Archive/Mozilla/XUL/tabpanels ---- -<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>Conteneur pour maintenir l'ensemble des pages dans <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. <code>tabpanels</code> doit être placé dans <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> bien qu'il n'a pas besoin d'être un enfant direct. Les enfants de <code>tabpanels</code> deviennent les panneaux de <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Dans la plupart des cas vous pouvez utilisez <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code>, mais ils peuvent être des éléments quelconques. En cliquant sur le premier onglet, le premier panneau sera affiché. En cliquant sur le deuxième onglet, le deuxième panneau sera affiché et ainsi de suite. Il devrait y avoir le même nombre de panneaux que d'onglets. Les panneaux ne doivent jamais être cachés; le masquage d'un onglet suffit pour rendre son panneau inaccessible.</p> - -<p>Plus d'informations sont disponibles dans le <a href="/en/XUL_Tutorial/Tabboxes" title="/fr/XUL_Tutorial/Tabboxes"> tutoriel XUL </a>.</p> - -<dl> - <dt>Attributs</dt> - <dd><a href="#a-selectedIndex">selectedIndex</a></dd> -</dl> - -<dl> - <dt>Propriétés</dt> - <dd><a href="#p-selectedIndex">selectedIndex</a>, <a href="#p-selectedPanel">selectedPanel</a></dd> -</dl> - -<h3 id="Examples" name="Examples">Exemples</h3> - -<p>(Exemple nécessaire)</p> - -<h3 id="Attributes" name="Attributes">Attributs</h3> - -<div id="a-selectedIndex"> - -</div> <table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Properties" name="Properties">Propriétés</h3> - -<p> </p><div id="p-accessible"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> - -</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-selectedPanel"></div> - -<h3 id="Methods" name="Methods">Méthodes</h3> - -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Related" name="Related">Voir également</h3> - -<dl> - <dt>Elements</dt> - <dd><code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code>.</dd> -</dl> diff --git a/files/fr/archive/mozilla/xul/textbox/index.html b/files/fr/archive/mozilla/xul/textbox/index.html deleted file mode 100644 index 7511b915f2..0000000000 --- a/files/fr/archive/mozilla/xul/textbox/index.html +++ /dev/null @@ -1,348 +0,0 @@ ---- -title: textbox -slug: Archive/Mozilla/XUL/textbox -tags: - - Méthodes_XUL - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/textbox ---- -<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>Un champ dans lequel l'utilisateur peut entrer du texte. Il est similaire à l'élément HTML <code>input</code>. Par défaut, une seule ligne de texte est affichée. L'attribut <code id="a-multiline"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/multiline">multiline</a></code> peut être spécifié pour afficher un champ multiligne. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Les_champs_de_saisie">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-cols">cols</a>, <a href="#a-decimalplaces">decimalplaces</a>, <a href="#a-disabled">disabled</a>, <a href="#a-textbox.empty">empty</a>, <a href="#a-emptytext">emptytext</a>, <a href="#a-hidespinbuttons">hidespinbuttons</a>, <a href="#a-increment">increment</a>, <a href="#a-textbox.label">label</a>, <a href="#a-max">max</a>, <a href="#a-maxlength">maxlength</a>, <a href="#a-min">min</a>, <a href="#a-multiline">multiline</a>, <a href="#a-newlines">newlines</a>, <a href="#a-textbox.onchange">onchange</a>, <a href="#a-oninput">oninput</a>, <a href="#a-preference">preference</a>, <a href="#a-readonly">readonly</a>, <a href="#a-rows">rows</a>, <a href="#a-size">size</a>, <a href="#a-spellcheck">spellcheck</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-timeout">timeout</a>, <a href="#a-textbox.type">type</a>, <a href="#a-textbox.value">value</a>, <a href="#a-wrap">wrap</a>, <a href="#a-wraparound">wraparound</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-clickSelectsAll">clickSelectsAll</a>, <a href="#p-decimalPlaces">decimalPlaces</a>, <a href="#p-decimalSymbol">decimalSymbol</a>, <a href="#p-defaultValue">defaultValue</a>, <a href="#p-disabled">disabled</a>, <a href="#p-editor">editor</a>, <a href="#p-emptyText">emptyText</a>, <a href="#p-increment">increment</a>, <a href="#p-inputField">inputField</a>, <a href="#p-textbox.label">label</a>, <a href="#p-max">max</a>, <a href="#p-maxLength">maxLength</a>, <a href="#p-min">min</a>, <a href="#p-readOnly">readOnly</a>, <a href="#p-selectionEnd">selectionEnd</a>, <a href="#p-selectionStart">selectionStart</a>, <a href="#p-size">size</a>, <a href="#p-spinButtons">spinButtons</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-textLength">textLength</a>, <a href="#p-timeout">timeout</a>, <a href="#p-type">type</a>, <a href="#p-textbox.value">value</a>, <a href="#p-valueNumber">valueNumber</a>, <a href="#p-wrapAround">wrapAround</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-decrease">decrease</a>, <a href="#m-increase">increase</a>, <a href="#m-reset">reset</a>, <a href="#m-select">select</a>, <a href="#m-setSelectionRange">setSelectionRange</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-plain">plain</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_textbox.png"></div> -<pre><vbox> -<label control="your-name" value="Enter your name:"/> -<textbox id="your-name" value="John"/> -</vbox> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-cols"> - -</div> -<div id="a-decimalplaces"> - -</div> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-textbox.empty"> - -</div> -<div id="a-emptytext"> - -</div> -<div id="a-hidespinbuttons"> - -</div> -<div id="a-increment"> - -<dl> - <dt> - <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La quantité dont l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> (pour les boîtes numériques et les échelles) or <code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code><magic name="\"PAGENAME\"/"> (pour les barres de défilement) </magic> change lorsque l'on clique sur les flèches. La valeur par défaut est 1.</dd> -</dl> -</div> -<div id="a-textbox.label"> - -</div> -<div id="a-max"> - -<dl> - <dt> - <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur maximum que peut prendre l'élément scale ou number box. La valeur par défaut est <code>100</code> pour les éléments scale et <code>Infinity</code> pour les boîtes numériques</dd> -</dl> -</div> -<div id="a-maxlength"> - -</div> -<div id="a-min"> - -<dl> - <dt> - <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code></dt> - <dd> - Type : - <i> - entier</i> - </dd> - <dd> - La valeur minimum que peut prendre l'élément. La valeur par défaut est 0.</dd> -</dl> -</div> -<div id="a-multiline"> - -</div> -<div id="a-newlines"> - -</div> -<div id="a-textbox.onchange"> - -</div> -<div id="a-oninput"> - -</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-readonly"> - -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</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-size"> - -</div> -<div id="a-spellcheck"> - -</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-timeout"> - -</div> -<div id="a-textbox.type"> - -</div> -<div id="a-textbox.value"> - -</div> -<div id="a-wrap"> - -</div> -<div id="a-wraparound"> - -</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-clickSelectsAll"></div> -<div id="p-decimalPlaces"></div> -<div id="p-decimalSymbol"></div> -<div id="p-defaultValue"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/defaultValue">defaultValue</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Définit et obtient la valeur par défaut d'une boîte de texte. -</dd></dl> -<p><br> -</p> - -</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-editor"></div> -<div id="p-emptyText"></div> -<div id="p-increment"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/increment">increment</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Obtient et définit la valeur de l'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code>.</dd> -</dl></div> -<div id="p-inputField"></div> -<div id="p-textbox.label"></div> -<div id="p-max"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/max">max</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-maxLength"></div> -<div id="p-min"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/min">min</a></span></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code>. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-readOnly"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readonly">readonly</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd> - <dd> - <div class="note"> - Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div> - </dd> -</dl></div> -<div id="p-selectionEnd"></div> -<div id="p-selectionStart"></div> -<div id="p-size"></div> -<div id="p-spinButtons"></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-textLength"></div> -<div id="p-timeout"></div> -<div id="p-type"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/type">type</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code>. -</dd></dl> - -</div> -<div id="p-textbox.value"></div> -<div id="p-valueNumber"></div> -<div id="p-wrapAround"></div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<dl> - <dt> - <span id="m-decrease"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/decrease">decrease()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Diminue la valeur de<magic name="\"PAGENAME\"/"> la boîte numérique l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> -<dl> - <dt> - <span id="m-increase"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/increase">increase()</a></code></span></dt> - <dd> - Type de retour : - <i> - aucune valeur de retour</i> - </dd> - <dd> - Augmente la valeur de <magic name="\"PAGENAME\"/">la boîte numérique, XUL:scale = l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.</dd> -</dl> -<p> </p> - - -<dl><dt> <span id="m-reset"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/reset">reset()</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur renvoyée</i> -</dd><dd> Réinitialise la préférence à sa valeur par défaut. -</dd><dd> Pour un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, la liste de transactions d'annulation est également vidée (Gecko 1.9). -</dd></dl> -<p><br> -</p> -<dl><dt> <span id="m-select"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/select">select()</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Sélectionne l'intégralité du texte d'une boîte texte. -</dd></dl> -<p><br> -</p> -<p><span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/fr/docs/R%C3%A9f%C3%A9rence_XUL" title="/fr/docs/Référence_XUL">Accueil de la référence XUL</a></span> -</p> -<dl><dt> <span id="m-setSelectionRange"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/setSelectionRange">setSelectionRange( début, fin )</a></code></span> -</dt><dd> Type retourné : <i>aucune valeur retournée</i> -</dd><dd> Cette méthode sélectionne une portion de texte dans une zone de texte (<i>textbox</i> ou <i>textarea</i>) où l'argument <var>début</var> est le premier caractère de la sélection et l'argument <var>fin</var> le dernier caractère de la sélection. </dd><dd> Renseigner les deux arguments avec la même valeur équivaut à déplacer le curseur d'écriture sans rien sélectionner. -</dd></dl> -<p><br> -<span class="comment">Interwiki Language Links</span> -</p> -<span class="lang lang-fr" lang="fr"> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<p>Les classes suivantes peuvent être utilisées pour styler l'élément. Ces classes devraient être utilisées au lieu de changer le style de l'élément directement, car elles s'accorderont plus naturellement avec le thème sélectionné par l'utilisateur. -</p><dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/plain">plain</a></code></dt> - <dd>This class causes the element to be displayed with no border or margin.</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/NsIDOMXULTextboxElement">nsIDOMXULTextboxElement</a> -</dd></dl> -<div class="noinclude"> -</div> -</span> diff --git a/files/fr/archive/mozilla/xul/timepicker/index.html b/files/fr/archive/mozilla/xul/timepicker/index.html deleted file mode 100644 index 7dda702b6b..0000000000 --- a/files/fr/archive/mozilla/xul/timepicker/index.html +++ /dev/null @@ -1,264 +0,0 @@ ---- -title: timepicker -slug: Archive/Mozilla/XUL/timepicker -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/timepicker ---- -<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>L'élément <code>timepicker</code> est utilisé pour permettre à l'utilisateur d'entrer une heure. Il contient trois champs pour entrer les heures, les minutes et les secondes. Des boutons fléchés à côté de ces champs permettent d'ajuster les valeurs à la souris. Une quatrième boîte de texte apparaît pour les horloges à 12 heures, permettant de sélectionner AM ou PM. -</p><p>Pour spécifier la valeur initiale, utilisez l'attribut <code>value</code> sous une forme HH:MM:SS ou HH:MM. La valeur peut être obtenue et modifiée à l'aide des propriétés <code>value</code> ou <code>dateValue</code>. La première spécifie l'heure sous la forme d'une chaîne de la forme HH:MM:SS tandis que la seconde le fait sous la forme d'un objet <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Date">Date</a>. En outre, les propriétés <code>hour</code>, <code>minute</code> et <code>second</code> peuvent être utilisées pour obtenir ou modifier chaque composante individuellement. -</p><p><br> -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-hideseconds">hideseconds</a>, <a href="#a-increment">increment</a>, <a href="#a-readonly">readonly</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-amIndicator">amIndicator</a>, <a href="#p-dateValue">dateValue</a>, <a href="#p-disabled">disabled</a>, <a href="#p-hideSeconds">hideSeconds</a>, <a href="#p-hour">hour</a>, <a href="#p-hourLeadingZero">hourLeadingZero</a>, <a href="#p-increment">increment</a>, <a href="#p-is24HourClock">is24HourClock</a>, <a href="#p-isPM">isPM</a>, <a href="#p-minute">minute</a>, <a href="#p-minuteLeadingZero">minuteLeadingZero</a>, <a href="#p-pmIndicator">pmIndicator</a>, <a href="#p-readOnly">readOnly</a>, <a href="#p-second">second</a>, <a href="#p-secondLeadingZero">secondLeadingZero</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre><timepicker value="12:05"/> -</pre> -<p><img alt="Image:Controlguide-timepicker.png"> -</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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-hideseconds"> - -<dl> - <dt> - <code id="a-hideseconds"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hideseconds">hideseconds</a></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Indique si le champ des secondes doit être masqué.</dd> -</dl> -</div> -<div id="a-readonly"> - -<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script. -</dd></dl> - - -</div> -<div id="a-timepicker.increment"> - -<dl> - <dt> - <a href="fr/XUL/Attributs/timepicker.increment">increment</a></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Indique le nombre de minutes à passer chaque fois que les flèches sont actionnées. Cet attribut est à utiliser en combinaison avec une définition de <code>hideseconds</code> à <code>true</code>.</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-timepicker.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> - La valeur initiale du sélecteur de date au format HH:MM:SS ou HH:MM.</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-amIndicator"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/amIndicator">amIndicator</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> La valeur chaîne affichée pour les heures entre minuit et midi, par défaut « AM ». Cette valeur est déterminée selon la locale de l'utilisateur. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-dateValue"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/dateValue">dateValue</a></span></code></dt> - <dd> - Type : <i>Date</i></dd> - <dd> - La date actuellement entrée ou sélectionnée dans le sélecteur de date sous la forme d'un objet <code>Date</code>.</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-hideSeconds"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/hideSeconds">hideSeconds</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Indique si le champ des secondes doit être masqué.</dd> -</dl></div> -<div id="p-hour"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/hour">hour</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - La valeur de l'heure actuellement sélectionnée entre 0 et 23. Modifiez cette propriété pour changer l'heure sélectionnée.</dd> -</dl></div> -<div id="p-hourLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/hourLeadingZero">hourLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant l'heure lorsque celle-ci est inférieure à 10.</dd> -</dl></div> -<div id="p-increment"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/increment">increment</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Obtient et définit la valeur de l'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code>.</dd> -</dl></div> -<div id="p-is24HourClock"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/is24HourClock">is24HourClock</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si l'heure est affichée à l'aide d'une horloge à 24 ou 12 heures. Avec une horloge à 12 heures, un champ supplémentaire permet à l'utilisateur de choisir entre AM et PM.</dd> -</dl></div> -<div id="p-isPM"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/isPM">isPM</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si cette propriété est à <code>false</code>, l'heure est entre 0 et 11. Si elle est à <code>true</code>, l'heure est supérieure ou égale à 12.</dd> -</dl></div> -<div id="p-minute"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/minute">minute</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - Les minutes de l'heure actuellement sélectionnée entre 0 et 59. Modifiez cette propriété pour changer la minute sélectionnée.</dd> -</dl></div> -<div id="p-minuteLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/minuteLeadingZero">minuteLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant la valeur des minutes lorsque celle-ci est inférieure à 10.</dd> -</dl></div> -<div id="p-pmIndicator"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/pmIndicator">pmIndicator</a></span></code></dt> - <dd> - Type : <i>chaîne</i></dd> - <dd> - La valeur chaîne affichée pour les heures entre midi et minuit, par défaut « PM ». Cette valeur est déterminée selon la locale de l'utilisateur.</dd> -</dl></div> -<div id="p-readOnly"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readonly">readonly</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd> - <dd> - <div class="note"> - Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div> - </dd> -</dl></div> -<div id="p-second"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/second">second</a></span></code></dt> - <dd> - Type : <i>entier</i></dd> - <dd> - La valeur des secondes de l'heure actuellement sélectionnée, entre 0 et 59. Modifiez cette propriété pour changer la seconde sélectionnée.</dd> -</dl></div> -<div id="p-secondLeadingZero"> -<dl> - <dt> - <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/secondLeadingZero">secondLeadingZero</a></span></code></dt> - <dd> - Type : <i>booléen</i></dd> - <dd> - Une valeur en lecture seule indiquant si un zéro initial doit être affiché avant la valeur des secondes si celle-ci est inférieure à 10.</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-timepicker.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> - L'heure actuellement entrée sous la forme HH:MM:SS. Modifiez cette propriété pour changer cette heure.</dd> -</dl></div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIDOMXULControlElement">nsIDOMXULControlElement</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/toolbars/création_de_boutons_de_barre_d'outils/index.html b/files/fr/archive/mozilla/xul/toolbars/création_de_boutons_de_barre_d'outils/index.html deleted file mode 100644 index 0b38c79357..0000000000 --- a/files/fr/archive/mozilla/xul/toolbars/création_de_boutons_de_barre_d'outils/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: Création de boutons de barre d'outils -slug: Archive/Mozilla/XUL/Toolbars/Création_de_boutons_de_barre_d'outils -tags: - - Extensions -translation_of: Archive/Mozilla/XUL/Toolbars/Creating_toolbar_buttons ---- -<p> </p> -<p>Cet article explique comment ajouter un bouton à la barre d'outils d'une application (comme Firefox, Thunderbird, Nvu, etc.) en utilisant la technique des <a href="fr/Overlays_XUL">overlays</a>. Cet article s'adresse aux développeurs d'<a href="fr/Extensions">extensions</a> connaissant les bases de <a href="fr/XUL">XUL</a> et <a href="fr/CSS">CSS</a>.</p> -<p>Le lecteur est supposé être familiarisé avec les bases de la création d'extensions pour Firefox et avoir fait fonctionner <a href="fr/Construire_une_extension">sa première extension</a>. Un tutoriel vous guidant à travers le processus depuis le début est <a href="fr/Boutons_de_barre_d'outils_personnalis%c3%a9s">également disponible</a>.</p> -<p> </p> -<h3 id="Cr.C3.A9ation_d.27un_overlay" name="Cr.C3.A9ation_d.27un_overlay">Création d'un overlay</h3> -<p>Avant tout, vous devez créer un overlay pour le document qui contient la barre d'outils que vous souhaitez améliorer. Le but de ce tutoriel n'est pas d'expliquer les overlays — vous pouvez trouver de précieuses informations à ce sujet dans le Tutoriel XUL.</p> -<p>Pour créer un overlay sur un document, vous devez connaître son URI. Vous trouverez en bas de cette page la <a href="#Liste_des_fen.C3.AAtres_o.C3.B9_les_overlays_de_la_barre_d.27outils_sont_fr.C3.A9quents">liste des documents où les overlays sont créés le plus fréquemment</a>.</p> -<div class="note"> - Note : certains placent un overlay sur - <i> - <a class="external" rel="freelink">chrome://messenger/content/mailWindowOverlay.xul</a></i> - . Cela devrait faire apparaitre le bouton sur toutes les fenêtres auxquelles mailWindowOverlay.xul s'applique (c'est-à-dire la fenêtre principale et la fenêtre de messages). Cela doit être vérifié.</div> -<h3 id="Ajout_d.27un_bouton_.C3.A0_la_barre_d.27outils" name="Ajout_d.27un_bouton_.C3.A0_la_barre_d.27outils">Ajout d'un bouton à la barre d'outils</h3> -<p>Les applications toolkit ont une barre d'outils personnalisable. La méthode la plus pratique dans une extension est donc d'ajouter les boutons de la barre d'outils dans la palette plutôt que de les ajouter directement dans la barre d'outils. Cette dernière option est possible mais peu recommandée et plus difficile à mettre en œuvre.</p> -<p>L'ajout d'un bouton à la palette de la barre d'outils est très simple. Il suffit d'ajouter ce code à l'overlay :</p> -<pre> -<toolbarpalette id="BrowserToolbarPalette"> - <toolbarbutton id="myextension-button" class="toolbarbutton-1" - label="&toolbarbutton.label;" tooltiptext="&toolbarbutton.tooltip;" - oncommand="MyExtension.onToolbarButtonCommand(event);"/> -</toolbarpalette> -</pre> -<p>Notes :</p> -<ul> - <li>L'id de palette (BrowserToolbarPalette dans l'exemple) dépend de la fenêtre dans laquelle vous désirez ajouter un bouton. Voir ci-dessous la <a href="#Liste_des_fen.C3.AAtres_o.C3.B9_les_overlays_de_la_barre_d.27outils_sont_fr.C3.A9quents">liste des ID de palette les plus communément utilisées</a>.</li> - <li><code>class="toolbarbutton-1"</code> permet au bouton de la barre d'outils d'apparaitre correctement en mode icône et texte.</li> - <li>Il faut également indiquer la commande qui doit être exécutée dans l'attribut <code>oncommand</code>. Si vous avez besoin de prendre en charge le clic du milieu (roulette), vous devez ajouter la prise en charge <code>onclick</code> et vérifier <code>event.button</code>.</li> -</ul> -<pre>onclick: function(event) { - switch(event.button) { - case 0: - // Clic gauche - break; - case 1: - // Clic milieu - break; - case 2: - // Clic droit - break; - } -} -</pre> -<p>Pour ajouter plus de boutons, il suffit de mettre d'autres éléments <code><toolbarbutton></code> dans l'élément <code><toolbarpalette></code>. Placez les éléments autres que des boutons de barre d'outils dans un élément <code><toolbaritem></code>.</p> -<h3 id="Application_d.27un_style_sur_le_bouton" name="Application_d.27un_style_sur_le_bouton">Application d'un style sur le bouton</h3> -<p>Le plus souvent, les boutons ont des icônes. Pour attacher une image à un bouton, on utilise une des fonctionnalités standard de Mozilla pour le personnaliser. Si vous n'êtes pas familier avec celle-ci, lisez <a class="external" href="http://www.borngeek.com/firefox/toolbar-tutorial/ch_5.html">la section skinning de l'excellent Toolbar Tutorial de Jonah Bishop</a> (en anglais). Bien que l'article décrive la création d'une barre d'outils complètement personnalisée plutôt que d'un simple bouton, il contient une très bonne explication des techniques que nous allons employer.</p> -<h3 id="Taille_des_ic.C3.B4nes" name="Taille_des_ic.C3.B4nes">Taille des icônes</h3> -<p>Les boutons pour la barre d'outils peuvent avoir deux tailles différentes — grande et petite. Ceci implique que vous allez devoir fournir de icônes différentes pour chaque bouton de votre barre d'outils. Vous trouverez ci-dessous les dimensions des icônes dans diverses applications (n'hésitez pas à en ajouter d'autres) :</p> -<p><tr> <td>Firefox 1.0 (Winstripe)</td> <td>24x24</td> <td>16x16</td> </tr> <tr> <td>Thunderbird 1.0 (Qute)</td> <td>24x24</td> <td>16x16</td> </tr> </table></p> -<h3 id="Feuille_de_style" name="Feuille_de_style">Feuille de style</h3> -<p>Pour paramétrer l'image de votre bouton de barre d'outils, utilisez les règles CSS suivantes :</p> -<pre>/* skin/toolbar-button.css */ - -#myextension-button { - list-style-image: url("chrome://myextension/skin/btn_large.png"); -} - -toolbar[iconsize="small"] #myextension-button { - list-style-image: url("chrome://myextension/skin/btn_small.png"); -} -</pre> -<h3 id="Appliquer_la_feuille_de_style" name="Appliquer_la_feuille_de_style">Appliquer la feuille de style</h3> -<p>Souvenez-vous d'associer la feuille de style que vous avez créée à la fois à l'overlay et à la fenêtre de personnalisation de la barre d'outils.</p> -<pre><?xml-stylesheet href="chrome://myextension/skin/toolbar-button.css" type="text/css"?> -</pre> -<p>Pour l'associer à la fenêtre de personnalisation (<code><a class="external" rel="freelink">chrome://global/content/customizeToolbar.xul</a></code>), vous pouvez utiliser <tt>skin/contents.rdf</tt>, comme ceci :</p> -<pre><?xml version="1.0"?> -<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:chrome="http://www.mozilla.org/rdf/chrome#"> - - <Seq about="urn:mozilla:skin:root"> - <li resource="urn:mozilla:skin:classic/1.0"/> - </Seq> - - <Description about="urn:mozilla:skin:classic/1.0"> - <chrome:packages> - <Seq about="urn:mozilla:skin:classic/1.0:packages"> - <li resource="urn:mozilla:skin:classic/1.0:myextension"/> - </Seq> - </chrome:packages> - </Description> - - <Seq about="urn:mozilla:stylesheets"> - <li resource="chrome://global/content/customizeToolbar.xul"/> - </Seq> - - <Seq about="chrome://global/content/customizeToolbar.xul"> - <li>chrome://myextension/skin/toolbar-button.css</li> - </Seq> -</RDF> -</pre> -<p>Les extensions pour Firefox et Thunderbird 1.5 doivent plutôt utiliser quelque chose de semblable à ceci dans le <a href="fr/Chrome.manifest">chrome.manifest</a> :</p> -<pre class="eval">skin myextension classic/1.0 chrome/skin/ -style <a class="external" rel="freelink">chrome://global/content/customizeToolbar.xul</a> <a class="external" rel="freelink">chrome://myextension/skin/toolbar-button.css</a> -</pre> -<h3 id="Erreurs_fr.C3.A9quentes" name="Erreurs_fr.C3.A9quentes">Erreurs fréquentes</h3> -<p>Voici une liste des erreurs fréquemment commises par les auteurs d'extensions, avec leurs symptômes et leurs solutions.</p> -<p><b>Problème :</b> un assemblage de tous les boutons standards est dessiné à la place de votre propre icône.</p> -<p><b>Cause :</b> feuille de style mal formée ou non appliquée.</p> -<p><b>Solution :</b> vérifiez votre feuille de style, vérifiez si votre <code>content.rdf</code> (ou <code>chrome.manifest</code>) est correct, assurez-vous que vous n'avez pas oublié d'appliquer la feuille de style à <code>customizeToolbar.xul</code>.</p> -<h3 id="Liste_des_fen.C3.AAtres_o.C3.B9_les_overlays_de_la_barre_d.27outils_sont_fr.C3.A9quents" name="Liste_des_fen.C3.AAtres_o.C3.B9_les_overlays_de_la_barre_d.27outils_sont_fr.C3.A9quents">Liste des fenêtres où les overlays de la barre d'outils sont fréquents</h3> -<table class="standard-table"> - <tbody> - <tr> - <td class="header">Application (nom du thème)</th> - <pre class="eval"> - <td class="header">Taille de la grande icône</th> - <td class="header">Taille de la petite icône</th> -</pre> - </td> - </tr> - </tbody> -</table> -<p>URL Applications et fenêtres modifiées Id de la palette <small><a class="external" rel="freelink">chrome://browser/content/browser.xul</a></small>Firefox - Fenêtre principaleBrowserToolbarPalette <small><a class="external" rel="freelink">chrome://messenger/content/messenger.xul</a></small>Thunderbird - Fenêtre principaleMailToolbarPalette <small><a class="external" rel="freelink">chrome://messenger/content/</a> messengercompose/messengercompose.xul</small>Thunderbird - Fenêtre de rédaction MsgComposeToolbarPalette <small><a class="external" rel="freelink">chrome://messenger/content/addressbo...ddressbook.xul</a></small>Thunderbird - Carnet d'adressesAddressBookToolbarPalette <small><a class="external" rel="freelink">chrome://editor/content/editor.xul</a></small>Nvu - Fenêtre principaleNvuToolbarPalette <small><a class="external" rel="freelink">chrome://calendar/content/calendar.xul</a></small>Sunbird - Fenêtre principalecalendarToolbarPalette</p> -<h3 id="Plus_d.27informations" name="Plus_d.27informations">Plus d'informations</h3> -<ul> - <li>La référence XulPlanet.com : <a class="external" href="http://xulplanet.com/references/elemref/ref_toolbarbutton.html"><code><toolbarbutton></code></a>, <a class="external" href="http://xulplanet.com/references/elemref/ref_toolbaritem.html"><code><toolbaritem></code></a>.</li> - <li><a class="external" href="http://forums.mozillazine.org/viewtopic.php?t=220220">How to adjust toolbarbutton's label position</a></li> - <li><a class="external" href="http://forums.mozillazine.org/viewtopic.php?t=189667">Une discussion sur le forum de MozillaZine (en)</a> à propos de l'ajout d'une entrée dans la barre d'outils (et pas seulement dans la palette de personnalisation) juste après l'installation de l'extension. Notez qu'il n'est pas recommandé de le faire.</li> - <li>Il existe <a href="fr/Bouton_de_barre_d'outils_personnalis%c3%a9/SeaMonkey">une autre page</a> sur MDC avec des information sur l'ajout de boutons à diverses fenêtres dans SeaMonkey. On peut également y trouver des informations utiles sur les overlays pour ChatZilla.</li> -</ul> diff --git a/files/fr/archive/mozilla/xul/toolbars/index.html b/files/fr/archive/mozilla/xul/toolbars/index.html deleted file mode 100644 index 7e4f743d2a..0000000000 --- a/files/fr/archive/mozilla/xul/toolbars/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Toolbars -slug: Archive/Mozilla/XUL/Toolbars -tags: - - TopicStub -translation_of: Archive/Mozilla/XUL/Toolbars ---- -<p>Les barres d'outils, implémentées à l'aide de l'élément XUL <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>, sont des conteneurs pour les boutons de la barre d'outils et d'autres objets d'interface utilisateur. Les articles suivants fournissent des détails sur l'implémentation et l'utilisation des barres d'outils.</p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation" name="Documentation">Documentation</h2> - - <dl> - <dt><a href="/en-US/docs/XUL/School_tutorial/Adding_Toolbars_and_Toolbar_Buttons" title="XUL/School_tutorial/Adding Toolbars and Toolbar Buttons">XUL School: Ajout de barres d'outils et de boutons de barre d'outils</a></dt> - <dd>Un didacticiel utile pour créer des barres d'outils et des boutons de barre d'outils.</dd> - <dt><a href="/en-US/docs/XUL/Toolbars/Toolbar_customization_events" title="XUL/Toolbars/Toolbar customization events">Événements de personnalisation de la barre d'outils</a></dt> - <dd>Un aperçu des événements envoyés lors de la personnalisation de la barre d'outils; vous pouvez les utiliser pour être informé des modifications apportées aux barres d'outils.</dd> - <dt><a href="/en-US/docs/XUL/Toolbars/Creating_toolbar_buttons" title="XUL/Toolbars/Creating toolbar buttons">Création de boutons de barre d'outils</a></dt> - <dd>Comment utiliser les superpositions pour ajouter des boutons de barre d'outils aux applications Mozilla.</dd> - <dt><a href="/en-US/docs/XUL/Toolbars/Custom_toolbar_button" title="XUL/Toolbars/Custom toolbar button">Bouton de la barre d'outils personnalisée</a></dt> - <dd>Un autre exemple de création d'un bouton de barre d'outils, avec un exemple d'extension que vous pouvez télécharger et essayer.</dd> - <dt><a href="/en-US/docs/Code_snippets/Toolbar" title="Code snippets/Toolbar">Extraits de code: barre d'outils</a></dt> - <dd>Extraits de code utiles lorsque vous utilisez des barres d'outils.</dd> - <dt></dt> - </dl> - - <p><span class="alllinks"><a href="/en-US/docs/tag/Extensions" title="Tags:Toolbars">Afficher toutes les pages marquées avec "Barres d'outils"...</a></span></p> - </td> - <td> - <h2 class="Community" id="Community" name="Community">Communauté</h2> - - <ul> - <li>Afficher les forums de développement d'extensions Mozilla ... - <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-extensions">Liste de diffusion</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.extensions">newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.extensions/feeds">Flux de syndication</a></li> - </ul> - </li> - <li><a class="link-irc" href="irc://irc.mozilla.org/extdev">#extdev Canal IRC</a></li> - <li><a href="http://forums.mozillazine.org/?c=11">Forum MozillaZine</a></li> - <li><a href="/devnews/index.php/categories/about-addons" title="https://developer.mozilla.org/editor/fckeditor/core/editor/devnews/index.php/categories/about-addons/">à propos:addons newsletter</a></li> - <li><a href="/web-tech" title="https://developer.mozilla.org/editor/fckeditor/core/editor/web-tech/">Mozilla's Web-Tech blog</a></li> - <li><a href="http://mozdev.org/mailman/listinfo/project_owners">mozdev projets propriétaires</a></li> - <li><a href="http://planet.mozilla.org/" title="http://planet.mozilla.org/">Planète Mozilla</a></li> - <li><a href="/en-US/docs/Extensions/Community" title="Extensions/Community">Autres liens communautaires...</a></li> - </ul> - - <h2 class="Tools" id="Tools" name="Tools">Outils</h2> - - <ul> - <li><a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/6622" rel="external nofollow" title="https://addons.mozilla.org/en-US/firefox/addon/6622">L'inspecteur DOM</a> édite le DOM en direct (Firefox et Thunderbird)</li> - <li><a class="link-https" href="https://builder.mozillalabs.com/" title="https://builder.mozillalabs.com/">Mozilla Labs Add-on Builder</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/7434/" rel="external nofollow" title="https://addons.mozilla.org/en-US/firefox/addon/7434/">Extension Developer's Extension</a> a suite of development tools</li> - <li><a href="http://www.gijsk.com/" rel="external nofollow" title="http://www.gijsk.com/">Chrome List</a> view files in chrome:// (<a href="http://addons.mozilla.org/en-US/firefox/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/en-US/firefox/addon/4453">Firefox</a>, <a href="http://addons.mozilla.org/en-US/thunderbird/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/en-US/thunderbird/addon/4453">Thunderbird</a>)</li> - <li><a href="http://ted.mielczarek.org/code/mozilla/extensionwiz/" rel="external nofollow" title="http://ted.mielczarek.org/code/mozilla/extensionwiz/">Extension Wizard</a> a web-based extension skeleton generator (Firefox and Thunderbird)</li> - </ul> - - <p>... <a href="/en-US/docs/Setting_up_extension_development_environment#Development_extensions" title="Setting up extension development environment#Development extensions">plus d'outils</a> ...</p> - - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Rubriques connexes</h2> - - <ul> - <li><a href="/en-US/docs/XUL" title="XUL">XUL</a>, <a href="/en-US/docs/Themes" title="Themes">Thèmes</a>, <a href="/en-US/docs/Developer_Guide" title="Developing_Mozilla">Développement de Mozilla</a></li> - </ul> - </td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/mozilla/xul/toolbox/index.html b/files/fr/archive/mozilla/xul/toolbox/index.html deleted file mode 100644 index 459d64989d..0000000000 --- a/files/fr/archive/mozilla/xul/toolbox/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: toolbox -slug: Archive/Mozilla/XUL/toolbox -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/toolbox ---- -<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>Un conteneur pour les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>. C'est un type de boîte dont l'orientation par défaut est verticale. Si un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code> est placé dans un <code>toolbox</code>, une poignée (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grippy" title="grippy">grippy</a></code>) est affichée sur son bord gauche ou supérieur. L'utilisateur peut cliquer sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/grippy" title="grippy">grippy</a></code> pour réduire l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>. Si plusieurs barres d'outils sont placées dans le même <code>toolbox</code>, elles seront toutes réduites dans la même ligne. Le navigateur Firefox n'a pas ces contrôles <code>grippy</code>, les barres d'outils ne peuvent donc pas y être réduites. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barre_d'outils">Tutoriel XUL</a>. </p> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessible">accessible</a>, <a href="#p-customToolbarCount">customToolbarCount</a>, <a href="#p-palette">palette</a>, <a href="#p-toolbarset">toolbarset</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-appendCustomToolbar">appendCustomToolbar</a>, <a href="#m-collapseToolbar">collapseToolbar</a>, <a href="#m-expandToolbar">expandToolbar</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<p> -</p><div id="p-accessible"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessible">accessible</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIAccessible">nsIAccessible</a></i> -</dd><dd> Renvoie l'objet d'accessibilité pour l'élément. -</dd></dl> -<p><br> -</p> - -</div> -<div id="p-customToolbarCount"></div> -<div id="p-palette"></div> -<div id="p-toolbarset"></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> - - - - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarbutton" title="toolbarbutton">toolbarbutton</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbargrippy" title="toolbargrippy">toolbargrippy</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbaritem" title="toolbaritem">toolbaritem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarpalette" title="toolbarpalette">toolbarpalette</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarseparator" title="toolbarseparator">toolbarseparator</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarset" title="toolbarset">toolbarset</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarspacer" title="toolbarspacer">toolbarspacer</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbarspring" title="toolbarspring">toolbarspring</a></code> -</dd></dl> -<dl><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/tooltip/index.html b/files/fr/archive/mozilla/xul/tooltip/index.html deleted file mode 100644 index abc9a0ffbd..0000000000 --- a/files/fr/archive/mozilla/xul/tooltip/index.html +++ /dev/null @@ -1,225 +0,0 @@ ---- -title: tooltip -slug: Archive/Mozilla/XUL/tooltip -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/tooltip ---- -<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 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 <code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code> à l'élément. </p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Menus_surgissants">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-crop">crop</a>, <a href="#a-default">default</a>, <a href="#a-label">label</a>, <a href="#a-noautohide">noautohide</a>, <a href="#a-onpopuphidden">onpopuphidden</a>, <a href="#a-onpopuphiding">onpopuphiding</a>, <a href="#a-onpopupshowing">onpopupshowing</a>, <a href="#a-onpopupshown">onpopupshown</a>, <a href="#a-popup.position">position</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-label">label</a>, <a href="#p-popupBoxObject">popupBoxObject</a>, <a href="#p-position">position</a>, <a href="#p-state">state</a> -</dd></dl> -<dl><dt> Méthodes -</dt><dd> <a href="#m-hidePopup">hidePopup</a>, <a href="#m-moveTo">moveTo</a>, <a href="#m-openPopup">openPopup</a>, <a href="#m-openPopupAtScreen">openPopupAtScreen</a>, <a href="#m-showPopup">showPopup</a>, <a href="#m-sizeTo">sizeTo</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:XUL_ref_tooltip.png"></div> -<pre><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> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-default"> - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-noautohide"> - -</div> -<div id="a-onpopuphidden"> - -<dl><dt> <code id="a-onpopuphidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphidden">onpopuphidden</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après qu'il a été caché. <span class="comment"><a class=" external" href="http://www.langue-fr.net/index/A/apres-que.htm" rel="freelink">http://www.langue-fr.net/index/A/apres-que.htm</a></span> -</dd></dl> - - -</div> -<div id="a-onpopuphiding"> - -<dl><dt> <code id="a-onpopuphiding"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopuphiding">onpopuphiding</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué. -</dd></dl> - - -</div> -<div id="a-onpopupshowing"> - -<dl><dt> <code id="a-onpopupshowing"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshowing">onpopupshowing</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> 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 <code>false</code>, le popup ne s'affichera pas. -</dd></dl> - - -</div> -<div id="a-onpopupshown"> - -<dl><dt> <code id="a-onpopupshown"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshown">onpopupshown</a></code> -</dt><dd> Type : <i>code de script</i> -</dd><dd> Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement <code>onload</code> est envoyé à une fenêtre à son ouverture. -</dd></dl> - - -</div> -<div id="a-popup.position"> - -<dl><dt> <a href="fr/XUL/Attributs/popup.position">position</a> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'attribut <code>position</code> 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. -</dd></dl> -<ul><li> <code>after_start</code> : Le popup apparait en dessous l'élément avec le coin supérieur gauche du popup aligné avec le coin inférieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. Cette valeur est typiquement uilisée pour les menus déroulants. -</li><li> <code>after_end</code> : Le popup apparait en dessous l'élément avec le coin supérieur droit du popup aligné avec le coin inférieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_start</code> : Le popup apparait au dessus de l'élément avec le coin inférieur gauche du popup aligné avec le coin supérieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. -</li><li> <code>before_end</code> : Le popup apparait au dessus de l'élément avec le coin inférieur droit du popup aligné avec le coin supérieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_after</code> : Le popup apparait à la droite de l'élément avec le coin inférieur gauche du popup aligné avec le coin inférieur droit de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>end_before</code> : Le popup apparait à la droite de l'élément avec le coin supérieur gauche du popup aligné avec le coin supérieur droit de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_after</code> : Le popup apparait à la gauche de l'élément avec le coin inférieur droit du popup aligné avec le coin inférieur gauche de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>start_before</code> : Le popup apparait à la gauche de l'élément avec le coin supérieur droit du popup aligné avec le coin supérieur gauche de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -</li><li> <code>overlap</code> : Le popup apparait par dessus l'élément avec les coins supérieurs gauches alignés. -</li><li> <code>at_pointer</code> : Le popup apparait à la position du pointeur de la souris. -</li><li> <code>after_pointer</code> : Le popup apparait à la même position horizontale que le pointeur de la souris, mais verticalement, il est placé juste sous l'élément. -</li></ul> - - -</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-label"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/label">label</a></span></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</dd></dl> - -</div> -<div id="p-popupBoxObject"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/popupBoxObject">popupBoxObject</a></span></code> -</dt><dd> Type : <i><a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a></i> -</dd><dd> Cette propriété en lecture seule conserve le <a href="fr/NsIPopupBoxObject">nsIPopupBoxObject</a> 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. -</dd></dl> - -</div> -<div id="p-position"> -<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/position">position</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Obtient et définit la valeur de l'attribut <a href="fr/XUL/Attributs/popup.position">position</a>. -</dd></dl> - -</div> -<div id="p-state"> -<dl><dt> <code><span><a href="http://api/fr/docs/XUL/Propri%C3%A9t%C3%A9s/state">state</a></span></code> -</dt><dd> Type : <i>chaîne</i> -</dd><dd> Cette propriété en lecture seule indique si le popup est ouvert ou non. Quatre valeurs sont possibles : -</dd></dl> -<ul><li> <code>closed</code> : Le popup est fermé et non visible. -</li><li> <code>open</code> : Le popup est ouvert et visible sur l'écran. -</li><li> <code>showing</code> : Une requête a été faite pour ouvrir le popup, mais il n'a pas encore été affiché. Cet état se produit durant l'évènement <code>popupshowing</code>. -</li><li> <code>hiding</code> : Le popup est sur le point d'être masqué. Cet état se produit durant l'évènement <code>popuphiding</code>. -</li></ul> - -</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-hidePopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/hidePopup">hidePopup()</a></code></span></dt> -<dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Ferme le popup immédiatement. -</dd></dl> -<dl><dt> <span id="m-moveTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/moveTo">moveTo( x, y )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd><dd> Déplace le popup vers un nouvel emplacement. -</dd></dl> -<dl><dt> <span id="m-openPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopup">openPopup( anchor , position , x , y , isContextMenu, attributesOverride )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique. -</p><p>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 <code>anchor</code> et définissez la <code>position</code> par une chaîne indiquant la manière dont le popup doit être ancré. -</p><p>Les valeurs possibles pour le paramètre <code>position</code> sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer -</p><p>Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup. -</p><p>Si le paramètre <code>attributesOverride</code> vaut <code>true</code>, l'attribut <code>position</code> sur le nœud popup a priorité sur la valeur du paramètre <code>position</code>. Si <code>attributesOverride</code> vaut <code>false</code>, l'attribut n'est utilisé que si le paramètre <code>position</code> est vide. -</p><p>Pour un popup ancré, les paramètres <code>x</code> et <code>y</code> peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS). -</p><p>Les popups non ancrés peuvent être créés en fournissant <code>null</code> comme paramètre <code>anchor</code>. Un popup non ancré apparait à la position spécifiée par <code>x</code> et <code>y</code> relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres <code>position</code> et <code>attributesOverride</code> sont ignorés. -</p> -<dl><dt> <span id="m-openPopupAtScreen"><code><a href="http://api/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/openPopupAtScreen">openPopupAtScreen( x, y, isContextMenu )</a></code></span> -</dt><dd> Type de retour : <i>pas de valeur de retour</i> -</dd></dl> -<p>Ouvre le popup à une position spécifique sur l'écran spécifiée par <code>x</code> et <code>y</code>. 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 <code>x</code> et <code>y</code> sont mesurées en pixels CSS. -</p> -<dl><dt> <span id="m-showPopup"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup( element, x, y, popupType, anchor, align )</a></code></span> <span style="border: 1px solid #9898F0; background-color: #DDDDFF; font-size: 9px; vertical-align: text-top;">Déprécié dans Mozilla 1.9</span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> 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 <var>x</var> ou <var>y</var> sont définies par une valeur, le popup apparaîtra aux coordonnées (<var>x</var>,<var>y</var>) de l'écran. Si <var>x</var> et <var>y</var> sont définies à <code>-1</code>, le popup sera positionné par rapport à l'<var>element</var> 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 <var>anchor</var> et <var>align</var> peuvent être utilisés pour contrôler plus avant l'endroit où apparaîtra le popup par rapport à l'élément. Le paramètre <var>anchor</var> correspond à l'attribut <code id="a-popupanchor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupanchor">popupanchor</a></code> de l'élément et le paramètre <var>align</var> correspond à l'attribut <code id="a-popupalign"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popupalign">popupalign</a></code>. Les paramètres <var>anchor</var> et <var>align</var> sont ignorés si ni <var>x</var> ni <var>y</var> ne valent <code>-1</code>. -</dd></dl> -<dl><dd> 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 <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/boxObject">boxObject</a></span></code>.screenX et <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/boxObject">boxObject</a></span></code>.screenY, et utilisez celles-ci comme paramètres <var>x</var> et <var>y</var> en y ajoutant les décalages souhaités. -</dd></dl> -<dl><dd> Le paramètre <var>popupType</var> doit être une des chaînes <code>popup</code>, <code>context</code> ou <code>tooltip</code>. 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. -</dd></dl> -<dl><dt> <span id="m-sizeTo"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/sizeTo">sizeTo( <i>largeur</i>, <i>hauteur</i> )</a></code></span> -</dt><dd> Type de retour : <i>aucune valeur de retour</i> -</dd><dd> Modifie la taille actuelle de la fenêtre popup avec les nouvelles dimensions <var>largeur</var> et <var>hauteur</var>. -</dd></dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<p>À faire -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/tree/index.html b/files/fr/archive/mozilla/xul/tree/index.html deleted file mode 100644 index 22056c4d02..0000000000 --- a/files/fr/archive/mozilla/xul/tree/index.html +++ /dev/null @@ -1,313 +0,0 @@ ---- -title: tree -slug: Archive/Mozilla/XUL/tree -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/tree ---- -<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>Représente un arbre, un conteneur pouvant être utilisé pour un ensemble de lignes d'éléments tabulaires ou hiérarchiques. L'arbre peut contenir un nombre quelconque de lignes et de colonnes. Chaque ligne de l'arbre peut contenir des lignes filles qui seront affichées avec un décalage par rapport à leur parent. Contrairement aux autres éléments, les données à afficher à l'intérieur de l'arbre ne sont pas spécifiées à l'aide de balises, mais sont déterminées par un objet de vue. L'objet de vue implémente l'interface <a href="fr/NsITreeView">nsITreeView</a>. La vue est interrogée pour les données à afficher dans l'arbre. Les arbres sont utilisées de différentes manières, comme montré dans la table ci-dessous. La deuxième colonne liste les interfaces disponibles via la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/view">view</a></span></code> de l'arbre. La troisième colonne indique si l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> est utilisé. -</p><p>Si vous désirez que l'arbre puisse défiler horizontalement, définissez simplement l'attribut <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> pour chaque colonne de sorte que l'arbre soit plus large que son objet conteneur. -</p> -<table class="fullwidth-table"> -<tbody><tr> -<th>Type d'arbre</th> -<th>Interfaces de la vue</th> -<th>A des nœuds DOM ?</th> -<th>Description</th> -</tr> -<tr> -<td>Arbre de contenu</td> -<td><a href="fr/NsITreeView">nsITreeView</a>, <a href="fr/NsITreeContentView">nsITreeContentView</a></td> -<td>Oui</td> -<td>Cet arbre dispose d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> placés au sein de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>. Dans cette situation, une vue de contenu (qui implémente l'interface <a href="fr/NsITreeContentView">nsITreeContentView</a>) qui est un type de vue plus spécialisé, utilise les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et leurs descendants pour déterminer les données à afficher dans l'arbre. Toutefois, les éléments treeitem ne sont pas affichés directement ; ils ne sont utilisés que comme données pour la vue de contenu. La vue de contenu mettra cependant automatiquement à jour l'arbre si les éléments treeitem sont modifiés.</td> -</tr> -<tr> -<td>Arbre RDF</td> -<td><a href="fr/NsITreeView">nsITreeView</a>, <a href="fr/NsIXULTreeBuilder">nsIXULTreeBuilder</a></td> -<td>Non</td> -<td>Cet arbre est généré depuis une source de données RDF. Il est utilisé lorsqu'un arbre a un attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, ainsi que la valeur <code>dont-build-content</code> dans son attribut <code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>. Pour cet arbre, les données viennent directement de la source de données RDF. Aucun élément DOM <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> n'est créé. Même si le template utilise des éléments treeitem pour définir le contenu, aucun nœud DOM correspondant ne sera créé. C'est le type à utiliser pour les arbres générés par RDF avec beaucoup de lignes.</td> -</tr> -<tr> -<td>Arbre de contenu RDF</td> -<td><a href="fr/NsITreeView">nsITreeView</a>, <a href="fr/NsIXULTreeBuilder">nsIXULTreeBuilder</a>, <a href="fr/NsITreeContentView">nsITreeContentView</a></td> -<td>Oui</td> -<td>Cet arbre est généré depuis une source de données RDF. Il est similaire au type précédent, mais est utilisé lorsque l'arbre n'a pas la valeur <code>dont-build-content</code> dans son attribut <code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>. Des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> sont créés dans le DOM, afin de pouvoir y accéder à l'aide de fonctions RDF ou DOM. Ce type convient aux arbres générés par RDF qui n'ont pas beaucoup de lignes.</td> -</tr> -<tr> -<td>Vue d'arbre personnalisée</td> -<td><a href="fr/NsITreeView">nsITreeView</a></td> -<td>Non</td> -<td>Pour ce type d'arbre, vous implémentez vous-même l'interface <a href="fr/NsITreeView">nsITreeView</a>. Les données de l'arbre sont obtenues depuis cette vue personnalisée. La vue personnalisée doit être attachée à l'arbre à l'aide de la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/view">view</a></span></code>.</td> -</tr> -</tbody></table> -<p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. Consultez également <a href="fr/Changements_dans_les_contr%c3%b4les_d'arbres">Changements dans les contrôles d'arbres</a>. -</p> -<table style="border: solid #ccc 1px; background: #EEE; padding: 0px 10px 0px 10px; margin: 0px 0px 10px 10px;"> -<tbody><tr><td><b><a href="fr/Recommandations_d'accessibilit%c3%a9_pour_XUL#Arbres">Recommandations d'accessibilité liées</a></b><small> -<ul><li> Fournissez un accès alternatif (par exemple via des menus) aux sélecteurs de colonnes et pour les actions sur les en-têtes comme les tris (ceux-ci ne sont pas accessible au clavier par défaut). -</li></ul> -</small></td></tr></tbody></table> -<dl><dt> Attributs -</dt><dd> <a href="#a-disableKeyNavigation">disableKeyNavigation</a>, <a href="#a-disabled">disabled</a>, <a href="#a-tree.editable">editable</a>, <a href="#a-enableColumnDrag">enableColumnDrag</a>, <a href="#a-flags">flags</a>, <a href="#a-hidecolumnpicker">hidecolumnpicker</a>, <a href="#a-tree.onselect">onselect</a>, <a href="#a-rows">rows</a>, <a href="#a-seltype">seltype</a>, <a href="#a-statedatasource">statedatasource</a>, <a href="#a-tabindex">tabindex</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-builderView">builderView</a>, <a href="#p-columns">columns</a>, <a href="#p-contentView">contentView</a>, <a href="#p-currentIndex">currentIndex</a>, <a href="#p-disableKeyNavigation">disableKeyNavigation</a>, <a href="#p-disabled">disabled</a>, <a href="#p-editingColumn">editingColumn</a>, <a href="#p-editingRow">editingRow</a>, <a href="#p-enableColumnDrag">enableColumnDrag</a>, <a href="#p-firstOrdinalColumn">firstOrdinalColumn</a>, <a href="#p-tree.inputField">inputField</a>, <a href="#p-selType">selType</a>, <a href="#p-selstyle">selstyle</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-treeBoxObject">treeBoxObject</a>, <a href="#p-view">view</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre><tree flex="1"> - - <treecols> - <treecol id="sender" label="Expéditeur" flex="1"/> - <treecol id="subject" label="Sujet" flex="2"/> - </treecols> - - <treechildren> - <treeitem> - <treerow> - <treecell label="pat@example.com"/> - <treecell label="Plans top secrets"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="mel@example.com"/> - <treecell label="Allons manger quelque part"/> - </treerow> - </treeitem> - </treechildren> - -</tree> -</pre> -<div><img alt="Image:trees1.png"></div> -<p>Un arbre avec des éléments imbriqués : -</p> -<code><pre><tree id="myTree" flex="1" hidecolumnpicker="false" seltype="single" class="tree"> - <treecols id="myTree2-treeCols"> - <treecol id="myTree2-treeCol0" primary="true" flex="2" label="Colonne A" - persist="width" ordinal="1"/> - <splitter class="tree-splitter" ordinal="2"/> - <treecol id="myTree2-treeCol1" flex="1" label="Colonne B" - persist="width" ordinal="3"/> - </treecols> - <treechildren> - <treeitem> - <treerow> - <treecell label="1"/> - <treecell label="a"/> - </treerow> - </treeitem> - <!-- Assurez-vous de mettre container="true" --> - <treeitem container="true" open="true"> - <treerow> - <treecell label="2"/> - <treecell label="b"/> - </treerow> - <treechildren> - <treeitem> - <treerow> - <treecell label="2a"/> - <treecell label="ba"/> - </treerow> - </treeitem> - </treechildren> - </treeitem> - </treechildren> -</tree> -</pre></code> -<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><!-- La case à cocher active/désactive le bouton --> -<checkbox label="Enable button" - onclick="document.getElementById('buttRemove').disabled = this.checked"/> -<button id="buttRemove" label="Remove All" disabled="true"/> -</pre> -</div> -<div id="a-disableKeyNavigation"> - -</div> -<div id="a-tree.editable"> - -</div> -<div id="a-enableColumnDrag"> - -</div> -<div id="a-flags"> - -<dl><dt> <code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code> -</dt><dd> Type : <i>liste de valeurs (voir ci-dessous) séparées par des espaces</i> -</dd><dd> Un ensemble de drapeaux destinés à différentes utilisations. Deux sont définis, et peuvent être la valeur de cet attribut. -</dd></dl> -<ul><li> <code>dont-test-empty</code> : pour le contenu généré par des templates, le constructeur ne vérifiera pas qu'un conteneur est vide. -</li><li> <code>dont-build-content</code> : peut être utilisé sur un arbre pour idniquer que les éléments de contenu ne doivent pas être générés. Cela améliorera les performances, mais vous ne pourrez pas utiliser les fonctions DOM pour obtenir les lignes de l'arbre. -</li></ul> -<p><br> -</p> - - -</div> -<div id="a-hidecolumnpicker"> - -</div> -<div id="a-tree.onselect"> - -</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><magic name="\"PAGENAME\"/"></magic></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><magic name="\"PAGENAME\"/">Des cellules individuelles peuvent être sélectionnées.</magic><magic name="\"PAGENAME\"/"> Des lignes sont sélectionnées, cependant, l'indicateur de sélection n'est visible que sur le texte de la colonne principale.</magic></p> -</div> -<div id="a-statedatasource"> - -</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> - -<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-builderView"></div> -<div id="p-columns"></div> -<div id="p-contentView"></div> -<div id="p-currentIndex"></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-editingColumn"></div> -<div id="p-editingRow"></div> -<div id="p-enableColumnDrag"></div> -<div id="p-firstOrdinalColumn"></div> -<div id="p-tree.inputField"></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><magic name="\"PAGENAME\"/"></magic></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-selstyle"></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-treeBoxObject"></div> -<div id="p-view"></div> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - - - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULTreeElement">nsIDOMXULTreeElement</a>, <a href="fr/NsIDOMXULMultiSelectControlElement">nsIDOMXULMultiSelectControlElement</a> -</dd></dl> -<h3 id="Exemples_de_scripts" name="Exemples_de_scripts"> Exemples de scripts </h3> -<p>Pour alterner les couleurs de fond pour chaque ligne, utilisez des règles de styles comme les souvantes : <small>pma at daffodil dot uk dot com</small> -</p> -<code><pre>treechildren::-moz-tree-row(selected) { background-color: #FFFFAA; } -treechildren::-moz-tree-row(odd) { background-color: #EEEEEE; } -treechildren::-moz-tree-row(odd, selected) { background-color: #FFFFAA; } -treechildren::-moz-tree-cell-text(selected) { color: #000000; } -treechildren::-moz-tree-cell-text(odd, selected) { color: #000000; } -</pre></code> -<p>Si vous utilisez une vie d'arbre de contenu, utilisez le code suivant pour obtenir la valeur de l'attribut id de chacune des lignes sélectionnées de l'arbre : <small>tcooper_mont at yahoo dot com</small> -</p> -<code><pre>var rangeCount = tree.view.selection.getRangeCount(); -for (var i = 0; i < rangeCount; i++) -{ - var start = {}; - var end = {}; - tree.view.selection.getRangeAt(i, start, end); - for (var c = start.value; c <= end.value; c++) { - idList.push(tree.view.getItemAtIndex(c).firstChild.id); - } -} -</pre></code> -<p>Le code qui soit renvoie un tableau des indices de lignes pour lesquelles la valeur est cochée dans une colonne de type checkbox : -<small>jfabre at ismans dot fr</small> -</p> -<code><pre>function getCellChecked(tree, columnid) -{ - var arr = []; - var column = tree.columns.getNamedColumn(columnid); - for (var i = 0; i < tree.view.rowCount; i++) { - if (tree.view.getCellValue(i, column) == 'true') - arr.push(i); - } - return arr; -} -</pre></code> -<p>Pour obtenir la valeur textuelle d'une colonne particulière (par exemple la colonne age) de la ligne ayant actuellement le focus dans l'arbre : -</p> -<code><pre>var t = document.getElementById('mytree'); -document.title = t.view.getCellText(t.currentIndex, t.columns.getNamedColumn('age')); -</pre></code> diff --git a/files/fr/archive/mozilla/xul/treecell/index.html b/files/fr/archive/mozilla/xul/treecell/index.html deleted file mode 100644 index b54c0485bd..0000000000 --- a/files/fr/archive/mozilla/xul/treecell/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: treecell -slug: Archive/Mozilla/XUL/treecell -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treecell ---- -<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>Une cellule unique dans un arbre (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>). Cet élément doit être placé dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code>. Le texte de la cellule peut être défini à l'aide de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-treecell.editable">editable</a>, <a href="#a-label">label</a>, <a href="#a-treecell.mode">mode</a>, <a href="#a-properties">properties</a>, <a href="#a-ref">ref</a>, <a href="#a-treecell.src">src</a>, <a href="#a-value">value</a> -</dd></dl> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-treecell.editable"> - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-treecell.mode"> - -</div> -<div id="a-properties"> - -<dl><dt> <code id="a-properties"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/properties">properties</a></code> -</dt><dd> Type : <i>liste de noms de propriétés séparés par des espaces</i> -</dd><dd> Définit les propriétés de l'élément, qui peuvent être utilisées pour le styler. Pour plus d'informations, consultez <a href="fr/Tutoriel_XUL/Styler_un_arbre">Styler un arbre</a>. -</dd></dl> - - -</div> -<div id="a-ref"> - -<dl><dt> <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> -</dt><dd> Type : <i>URI d'une ressource RDF</i> -</dd><dd> Pour les éléments générés par des templates, cet attribut est utilisé pour indiquer le nœud racine RDF où la génération de contenu commence. Ceci correspondra à la valeur d'un attribut <code>about</code> sur un conteneur RDF. Cet attribut doit être placé en même temps que l'attribut <code>datasources</code>. -</dd></dl> - - -</div> -<div id="a-treecell.src"> - -</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> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a> <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treechildren/index.html b/files/fr/archive/mozilla/xul/treechildren/index.html deleted file mode 100644 index a0e1d2a21a..0000000000 --- a/files/fr/archive/mozilla/xul/treechildren/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: treechildren -slug: Archive/Mozilla/XUL/treechildren -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treechildren ---- -<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 le corps d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. Pour les arbres de contenu, celui-ci sera placé dans cet élément. Cet élément est également utilisé pour définir des lignes de contenu dans l'arbre. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-alternatingbackground">alternatingbackground</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) </p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<div id="a-alternatingbackground"> - -</div> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treecol/index.html b/files/fr/archive/mozilla/xul/treecol/index.html deleted file mode 100644 index 4073cfd1ce..0000000000 --- a/files/fr/archive/mozilla/xul/treecol/index.html +++ /dev/null @@ -1,187 +0,0 @@ ---- -title: treecol -slug: Archive/Mozilla/XUL/treecol -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treecol ---- -<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>Une colonne dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. Cet élément affiche l'en-tête de colonne et conserve la taille et d'autres informations sur la colonne. VOus pouvez également placer des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/splitter" title="splitter">splitter</a></code> entre les colonnes pour permettre leur redimensionnement. Placez toujours un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur un élément <code>treecol</code> pour vous assurer que son positionnement sera géré correctement. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-crop">crop</a>, <a href="#a-cycler">cycler</a>, <a href="#a-dragging">dragging</a>, <a href="#a-treecol.editable">editable</a>, <a href="#a-fixed">fixed</a>, <a href="#a-hidden">hidden</a>, <a href="#a-hideheader">hideheader</a>, <a href="#a-ignoreincolumnpicker">ignoreincolumnpicker</a>, <a href="#a-label">label</a>, <a href="#a-primary">primary</a>, <a href="#a-sort">sort</a>, <a href="#a-sortActive">sortActive</a>, <a href="#a-sortDirection">sortDirection</a>, <a href="#a-treecol.src">src</a>, <a href="#a-treecol.type">type</a>, <a href="#a-treecol.width">width</a> -</dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a> -</dd></dl> -<dl><dt> Classes de style -</dt><dd> <a href="#s-treecol-image">treecol-image</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<div class="float-right"><img alt="Image:Xul_tree_col_checked.png"></div> -<p>Cet exemple montre une case à cocher dans la première colonne, et utilise le style présenté plus bas. -</p> -<pre><tree flex="1"> - - <treecols> - <treecol label="Actif" type="checkbox" editable="true"/> - <treecol label="Nom" flex="1" /> - </treecols> - - <treechildren> - <treeitem> - <treerow> - <treecell value="true"/> - <treecell label="Alice"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell value="false"/> - <treecell label="Bob"/> - </treerow> - </treeitem> - </treechildren> - -</tree> -</pre> -<p>Pour rendre la case à cocher visible sur certaines plateformes, les styles suivants doivent être ajoutés à la feuille de style (voir <a href="fr/XUL/Attribute/treecol.type">treecol.type</a>). Dans Firefox 2.x et 3.x, tous les systèmes autres que Mac OS X utilisent déjà ces styles par défaut. Si vous visez Firefox sous Mac OS X, assurez-vous d'utiliser ces styles tout en fournissant votre propre image de case à cocher. Notez que <code><a class=" external" rel="freelink">chrome://global/skin/checkbox/cbox-check.gif</a></code> <i>est</i> disponible dans SeaMonkey sous Mac OS X. -</p> -<pre>treechildren::-moz-tree-checkbox { - /* cases à cocher non cochées dans des treecells. Ce style DOIT être avant treechildren::-moz-tree-checkbox(checked), autrement il n'aura aucun effet. */ - list-style-image: none; -} - -treechildren::-moz-tree-checkbox(checked){ - /* style pour les cases cochées. cbox-check.gif n'est pas disponible dans Firefox 1, 2 et 3 sous Mac OS X, vous devrez donc spécifier l'URL d'une image - dans votre extension ou ailleurs. */ - list-style-image: url("chrome://global/skin/checkbox/cbox-check.gif"); -} -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-crop"> - -<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> 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 <code>crop</code>. 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. -</dd></dl> -<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. -</li><li> <code>end</code> : Le texte sera tronqué du côté droit. -</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. -</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. -</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. -</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. -</li></ul> - - -</div> -<div id="a-cycler"> - -</div> -<div id="a-dragging"> - -</div> -<div id="a-treecol.editable"> - -</div> -<div id="a-fixed"> - -</div> -<div id="a-hidden"> - -<dl><dt> <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Si défini à <code>true</code>, l'élément n'est pas affiché. Cet attribut est similaire à la valeur « <code>none</code> » de la propriété CSS <code>display</code>. -</dd></dl> - - -</div> -<div id="a-hideheader"> - -</div> -<div id="a-ignoreincolumnpicker"> - -</div> -<div id="a-label"> - -<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. -</dd></dl> - - -</div> -<div id="a-primary"> - -</div> -<div id="a-sort"> - -</div> -<div id="a-sortActive"> - -</div> -<div id="a-sortDirection"> - -<dl><dt> <code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> Cet attribut indique la direction dans laquelle le contenu généré par un template est trié. Utilisez l'attribut <code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code> pour spécifier la clé de tri. -</dd></dl> -<ul><li> <code>ascending</code> : les données sont triées dans l'ordre croissant. -</li><li> <code>descending</code>: les données sont triées dans l'ordre décroissant. -</li><li> <code>natural</code> : les données sont triées dans l'ordre naturel, ce qui veut dire l'ordre dans lequel elles sont stockées. -</li></ul> -<p><br> -</p> - - -</div> -<div id="a-treecol.src"> - -</div> -<div id="a-treecol.type"> - -</div> -<div id="a-treecol.width"> - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<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> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Classes_de_style" name="Classes_de_style"> Classes de style </h3> -<p>La classe suivante peut être utilisée pour styler l'élément. Cette classe doit être utilisée plutôt que de changer le style de l'élément directement, car elle s'adaptera plus naturellement au thème sélectionné par l'utilisateur. -</p><dl> - <dt> - <code><a href="https://developer.mozilla.org/en-US/docs/XUL/Style/treecol-image">treecol-image</a></code></dt> - <dd> - Use this class to have an image appear on the <a href="/en/XUL/treecol" title="en/XUL/treecol">tree column</a> header. Specify the image using the <code id="a-src"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/src">src</a></code> attribute.</dd> -</dl> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treecols/index.html b/files/fr/archive/mozilla/xul/treecols/index.html deleted file mode 100644 index 439ef88631..0000000000 --- a/files/fr/archive/mozilla/xul/treecols/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: treecols -slug: Archive/Mozilla/XUL/treecols -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treecols ---- -<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>Un groupe d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code>. Il doit y avoir un et un seul élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code> dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-pickertooltiptext">pickertooltiptext</a> </dd></dl> -<dl><dt> Propriétés -</dt><dd> <a href="#p-accessibleType">accessibleType</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<div id="a-pickertooltiptext"> - -</div> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<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> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd><dt> Interfaces -</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treeitem/index.html b/files/fr/archive/mozilla/xul/treeitem/index.html deleted file mode 100644 index d52ffb8260..0000000000 --- a/files/fr/archive/mozilla/xul/treeitem/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: treeitem -slug: Archive/Mozilla/XUL/treeitem -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treeitem ---- -<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>Un <code>treeitem</code> doit être placé dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> et contenir des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code>. L'utilisateur peut cliquer sur l'élément <code>treeitem</code> pour sélectionner la ligne de l'arbre. L'élément <code>treeitem</code> contient une seule ligne et tout ce qui apparait à l'utilisateur comme les descendants de cette ligne. -</p><p>Dans une condition de template, utilisez un <code>treeitem</code> plutôt qu'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> lorsque le paramètre <code>dont-build-content</code> est spécifié. Définissez l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> au nom de variable à lier à un nœud de contenu lors de la correspondance. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-container">container</a>, <a href="#a-empty">empty</a>, <a href="#a-treeitem.label">label</a>, <a href="#a-open">open</a>, <a href="#a-uri">uri</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-container"> - -<dl><dt> <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Défini à true si l'élément doit agir comme un conteneur pouvant avoir des éléments enfants. Ceci peut être utilisé pour des dossiers. Cet attribut sera défini par le constructeur de template si nécessaire. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-empty"> - -<dl><dt> <code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Défini à <code>true</code> si l'élément est un conteneur qui ne contient aucun enfant. Il sera défini par le constructeur de template si nécessaire. -</dd></dl> - - -</div> -<div id="a-treeitem.label"> - -</div> -<div id="a-open"> - -<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. -</dd></dl> - - -</div> -<div id="a-uri"> - -<dl><dt> <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Pour du contenu généré par un template, l'attribut doit être placé sur l'élément où la génération de contenu doit commencer. Donc, il doit être placé sur un élément qui est le descendant d'un template. La valeur doit être définie à <code>rdf:*</code>. -</dd></dl> -<dl><dd> Les éléments qui apparaissent à l'intérieur de l'élément portant cet attribut seront répétés pour chaque nœud dans la source de données RDF. Les éléments qui sont à l'extérieur n'apparaîtront qu'une seule fois. -</dd></dl> -<p><br> -</p> - - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treerow">treerow</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treerow/index.html b/files/fr/archive/mozilla/xul/treerow/index.html deleted file mode 100644 index d14176ddcc..0000000000 --- a/files/fr/archive/mozilla/xul/treerow/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: treerow -slug: Archive/Mozilla/XUL/treerow -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treerow ---- -<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>Une ligne unique dans un arbre (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>). Cet élément doit être placé dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code>. Les enfants de <code>treerow</code> doivent être des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code>. Si des lignes filles sont nécessaires, il convient de les placer dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> au sein de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> parent. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Arbres">Tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-properties">properties</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<div id="a-properties"> - -<dl><dt> <code id="a-properties"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/properties">properties</a></code> -</dt><dd> Type : <i>liste de noms de propriétés séparés par des espaces</i> -</dd><dd> Définit les propriétés de l'élément, qui peuvent être utilisées pour le styler. Pour plus d'informations, consultez <a href="fr/Tutoriel_XUL/Styler_un_arbre">Styler un arbre</a>. -</dd></dl> - - -</div> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treecell">treecell</a> et <a href="fr/XUL/treeseparator">treeseparator</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/treeseparator/index.html b/files/fr/archive/mozilla/xul/treeseparator/index.html deleted file mode 100644 index 7e6af95185..0000000000 --- a/files/fr/archive/mozilla/xul/treeseparator/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: treeseparator -slug: Archive/Mozilla/XUL/treeseparator -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/treeseparator ---- -<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>Utilisé pour placer une nouvelle ligne séparatrice dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-properties">properties</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<p>(exemple nécessaire) -</p> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<div id="a-properties"> - -<dl><dt> <code id="a-properties"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/properties">properties</a></code> -</dt><dd> Type : <i>liste de noms de propriétés séparés par des espaces</i> -</dd><dd> Définit les propriétés de l'élément, qui peuvent être utilisées pour le styler. Pour plus d'informations, consultez <a href="fr/Tutoriel_XUL/Styler_un_arbre">Styler un arbre</a>. -</dd></dl> - - -</div> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <a href="fr/XUL/tree">tree</a>, <a href="fr/XUL/treecols">treecols</a>, <a href="fr/XUL/treecol">treecol</a>, <a href="fr/XUL/treechildren">treechildren</a>, <a href="fr/XUL/treeitem">treeitem</a>, <a href="fr/XUL/treerow">treerow</a> et <a href="fr/XUL/treecell">treecell</a>. -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_d'éléments_html/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_d'éléments_html/index.html deleted file mode 100644 index 6dfeea624f..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_d'éléments_html/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Ajout d'éléments HTML -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajout_d'éléments_HTML -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_HTML_Elements ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Indicateurs_de_progression" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Utilisation_des_spacers">Suivant »</a></p> -</div> - -<p>Maintenant que nous avons ajouté quelques boutons, ajoutons d'autres éléments.</p> - -<h3 id="Ajout_d.27.C3.A9l.C3.A9ments_HTML_dans_une_fen.C3.AAtre" name="Ajout_d.27.C3.A9l.C3.A9ments_HTML_dans_une_fen.C3.AAtre">Ajout d'éléments HTML dans une fenêtre</h3> - -<p>En plus de tous les éléments XUL déjà disponibles, vous pouvez également ajouter des éléments HTML directement dans un fichier XUL. En réalité, vous pouvez ajouter n'importe quel élément HTML dans des fichiers XUL, ce qui signifie que des applets Java ou des tableaux peuvent être placés directement dans une fenêtre. Vous devriez proscrire l'emploi de ces éléments HTML dans vos fichiers XUL dès que vous le pouvez (il existe plusieurs raisons à cela, et la principale concerne <a href="/fr/Tutoriel_XUL/Détails_sur_le_modèle_de_boîte" title="fr/Tutoriel_XUL/Détails_sur_le_modèle_de_boîte">la mise en page</a> qui sera décrite plus tard). Cette section va néanmoins décrire comment les employer. Souvenez-vous que le langage XML est sensible à la casse, et que de ce fait vous devrez taper les balises et les attributs en minuscules.</p> - -<h4 id="Espace_de_nommage_XHTML" name="Espace_de_nommage_XHTML">Espace de nommage XHTML</h4> - -<p>Afin de pouvoir utiliser des éléments HTML dans un fichier XUL, vous devez déclarer l'espace de nommage XHTML correspondant (NdT : namespace). De cette façon, Mozilla peut faire la distinction entre les balises de HTML de celles de XUL. L'attribut ci-dessous doit être ajouté à la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> du fichier XUL, ou à l'élément HTML le plus extérieur.</p> - -<pre class="eval"><span class="nowiki">xmlns:html="http://www.w3.org/1999/xhtml"</span> -</pre> - -<p>Il s'agit d'une déclaration HTML comme celle que nous avons utilisée pour déclarer XUL. Pour fonctionner, elle doit être saisie exactement comme indiquée ci-dessus.</p> - -<div class="note">Notez qu'en réalité, Mozilla ne télécharge pas cette URL, mais il la reconnaît comme étant une déclaration HTML.</div> - -<div class="highlight"> -<p>Voici un exemple qui peut être ajouté à notre fenêtre de <em>Recherche de fichiers</em> :</p> - -<pre class="eval"><?xml version="1.0" encoding="ISO-8859-1"?> -<?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> -<window - id="findfile-window" - title="Recherche de fichiers" - orient="horizontal" - <span class="highlightred"><span class="nowiki">xmlns:html="http://www.w3.org/1999/xhtml"</span></span> - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> -</pre> - -<p>Ensuite, vous pouvez employer des balises HTML comme vous le feriez normalement, en gardant à l'esprit ceci :</p> - -<ul> - <li>Vous devez ajouter un préfixe <code>html:</code> au début de chaque balise, en supposant que vous ayez déclaré l'espace de nommage HTML comme ci-dessus.</li> - <li>Vous devez taper les balises en minuscules.</li> - <li>Des guillemets doivent être placés autour de toutes les valeurs d'attributs.</li> - <li>XML impose qu'une barre oblique (slash) termine chaque balise qui n'ont aucun contenu. Les exemples ci-dessous vont vous l'expliciter.</li> -</ul> - -<h4 id="Utilisation_d.27.C3.A9l.C3.A9ments_HTML" name="Utilisation_d.27.C3.A9l.C3.A9ments_HTML">Utilisation d'éléments HTML</h4> - -<p>Vous pouvez utiliser n'importe quelle balise HTML bien que certaines comme <code>head</code> et <code>body</code> ne soient d'aucune utilité. Des exemples d'emploi des éléments HTML sont montrés ci-dessous :</p> - -<pre><html:img src="banner.jpg"/> - -<html:input type="checkbox" value="true"/> - -<html:table> - <html:tr> - <html:td> - Un tableau simple - </html:td> - </html:tr> -</html:table> -</pre> - -<p>Ces exemples vont créer une image à partir du fichier 'banner.jpg', une case à cocher et un tableau avec une unique cellule. Vous devriez toujours employer des éléments XUL s'ils sont disponibles et vous ne devriez pas employer des tableaux pour la mise en page sous XUL (des éléments XUL permettent de le faire).</p> - -<div class="note">Notez que le préfixe html: a été ajouté au début de chaque balise, pour que Mozilla sache qu'il s'agit d'une balise HTML et non d'une balise XUL. Si vous oubliez un préfixe html:, le navigateur croira qu'il s'agit d'un élément XUL et il n'affichera probablement rien car les balises <code>img</code>, <code>input</code>, <code>table</code>, etc. ne sont pas des balises XUL valides.</div> - -<p>En XUL, vous pouvez ajouter des libellés avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> ou <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>. Vous devriez utiliser ces éléments dès que vous le pouvez. Vous pouvez également ajouter des libellés à des contrôles soit en utilisant la balise HTML <code>label</code>, soit en mettant simplement le texte dans un autre élément bloc HTML (tel que <code>p</code> ou <code>div</code>) comme dans l'exemple ci-dessous.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_1.xul">Voir</a></p> - -<pre><html:p> - Rechercher : - <html:input id="find-text"/> - <button id="okbutton" label="OK"/> -</html:p> -</pre> - -<p>Ce code va afficher le texte 'Rechercher :', suivi d'un champ de saisie de texte et d'un bouton « OK ». Notez que le bouton XUL peut apparaître dans un bloc de balise HTML, comme c'est le cas ici. Du texte ne sera affiché que s'il est placé à l'intérieur de balises HTML qui sont normalement employées pour afficher du texte (comme une balise <code>p</code>). Tout texte placé en dehors de balises ne sera pas affiché, sauf si l'élément XUL contenant le texte le permet (l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> par exemple).</p> - -<p>Les exemples suivants vont vous aider.</p> - -<h3 id="Exemple_d.27.C3.A9l.C3.A9ments_HTML" name="Exemple_d.27.C3.A9l.C3.A9ments_HTML">Exemple d'éléments HTML</h3> - -<p>Les exemples suivants illustrent l'ajout de balises HTML dans une fenêtre. Dans chaque cas, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> et d'autres informations basiques ont été retirés pour plus de clarté.</p> - -<h4 id="Une_bo.C3.AEte_de_dialogue_avec_une_case_.C3.A0_cocher" name="Une_bo.C3.AEte_de_dialogue_avec_une_case_.C3.A0_cocher">Une boîte de dialogue avec une case à cocher</h4> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_2.xul">Voir</a></p> - -<pre><html:p> - Cliquez sur la boîte ci-dessous pour mémoriser cette décision. - <html:p> - <html:input id="rtd" type="checkbox"/> - <html:label for="rtd">Mémoriser cette décision</html:label> - </html:p> -</html:p> -</pre> - -<div class="float-right"><img alt="Image:xultu_htmlelem1.png" class="internal" src="/@api/deki/files/1523/=Xultu_htmlelem1.png"></div> - -<p>Dans ce cas, une première balise <code>p</code> a été utilisée pour placer du texte et une autre a été utilisée pour séparer le texte en plusieurs lignes. (NdT : selon la norme XHTML, une balise <code>p</code> ne peut pas inclure une autre balise <code>p</code>, l'exemple est donc en principe erroné.)</p> - -<h4 id="Texte_en_dehors_de_blocs_HTML" name="Texte_en_dehors_de_blocs_HTML">Texte en dehors de blocs HTML</h4> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_htmlelem_3.xul">Voir</a></p> - -<pre><html:div> - Voulez-vous sauvegarder les documents suivants ? - <html:hr/> -</html:div> -Rapport de dépense 1 que j'ai fait l'été dernier -<button id="yes" label="Oui"/> -<button id="no" label="Non"/> -</pre> - -<div class="float-right"><img alt="Image:xultu_htmlelem2.png" class="internal" src="/@api/deki/files/1524/=Xultu_htmlelem2.png"></div> - -<p>Comme vous pouvez le voir sur cette image, le texte placé à l'intérieur des balises <code>div</code> a été affiché mais l'autre texte ('Rapport de dépense 1' et 'que j'ai fait l'été dernier') ne l'a pas été. Ceci est dû au fait qu'il n'y a pas d'éléments HTML ou XUL entourant le texte à afficher et capables de le faire. Pour rendre ce texte apparent, vous devez le placer à l'intérieur de balises <code>div</code>, ou l'inclure dans une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code>.</p> - -<h4 id="Les_.C3.A9l.C3.A9ments_HTML_invalides" name="Les_.C3.A9l.C3.A9ments_HTML_invalides">Les éléments HTML invalides</h4> - -<pre><html:po>Cas 1</html:po> -<div>Cas 2</div> -<html:description value="Cas 3"/> -</pre> - -<p>Aucun des trois cas ci-dessus ne s'affichera pour les raisons suivantes :</p> - -<dl> - <dt>Cas 1 </dt> - <dd><code>po</code> n'est pas une balise HTML valide et Mozilla n'a aucune idée de ce qu'il faut en faire.</dd> - <dt>Cas 2 </dt> - <dd><code>div</code> est une balise valide mais seulement en HTML. Pour qu'elle fonctionne, vous devez ajouter le qualificateur 'html:'.</dd> - <dt>Cas 3 </dt> - <dd>un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> est valide en XUL mais pas en HTML. Il ne devrait pas avoir de qualificateur 'html:'.</dd> -</dl> - -<hr> -<p>Dans la page suivante, nous apprendrons comment ajouter de l'espace entre les éléments.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Indicateurs_de_progression" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Utilisation_des_spacers">Suivant »</a></p> -</div> -<span class="comment">Interwiki</span></div> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaire_d_évènements/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaire_d_évènements/index.html deleted file mode 100644 index 9eab0ef687..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaire_d_évènements/index.html +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: Ajout de gestionnaire d'évènements -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajout_de_gestionnaire_d_évènements -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Event_Handlers_to_XBL-defined_Elements ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_méthodes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Héritage_XBL">Suivant »</a></p> -</div> - -<p>Nous allons voir comment ajouter des gestionnaires d'événements aux éléments XBL.</p> - -<h3 id="Les_gestionnaires_d.27.C3.A9v.C3.A9nements" name="Les_gestionnaires_d.27.C3.A9v.C3.A9nements">Les gestionnaires d'événements</h3> - -<p>Comme vous pouvez le prévoir, des clics de souris, des touches pressées et d'autres événements sont passés à chacun des éléments à l'intérieur du contenu. Cependant, vous voudrez maîtriser les événements et les gérer à votre façon. Vous pouvez ajouter des gestionnaires d'événements aux éléments au sein du contenu si besoin. Le dernier exemple de la section précédente en faisait une démonstration. Dans cet exemple, des gestionnaires <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> avaient été ajoutés sur quelques boutons.</p> - -<h4 id="Gestionnaires_d.27.C3.A9v.C3.A9nements" name="Gestionnaires_d.27.C3.A9v.C3.A9nements">Gestionnaires d'événements</h4> - -<p>Toutefois, vous pouvez vouloir ajouter un gestionnaire d'événement à tout le contenu, ce qui représente tous les éléments définis au sein de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#content">content</a></code>. Cela pourrait être utile pour maîtriser les événements de sélection et de désélection. Pour définir un gestionnaire d'événement, utilisez l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#handler">handler</a></code>. Chacun de ces éléments décrit l'action d'un seul gestionnaire d'événement. Vous pouvez utiliser plus d'un gestionnaire si nécessaire. Si un événement ne correspond pas à l'un des événements <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#handler">handler</a></code>, il est passé simplement dans le contenu comme d'habitude.</p> - -<p>La syntaxe générale du gestionnaire est la suivante :</p> - -<pre><binding id="nom-liaison"> - <handlers> - <handler event="nom-evenement" action="script"/> - </handlers> -</binding> -</pre> - -<p>Placez tous vos gestionnaires dans l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#handlers">handlers</a></code>. Chaque élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#handler">handler</a></code> définit l'action prise pour un événement particulier grâce à son attribut <code>event</code>. Les événements valides sont ceux supportés par XUL et JavaScript, tels que 'click' et 'focus'. Utilisez le nom de l'événement sans son préfixe 'on'.</p> - -<p>La principale raison nécessitant la déclaration de gestionnaires est la modification des propriétés personnalisées lorsqu'un événement se produit. Par exemple, une case à cocher personnalisée pourrait avoir une propriété <code>checked</code> qui doit être modifée lorsque l'utilisateur clique sur la case à cocher :</p> - -<pre><handlers> - <handler event="mouseup" action="this.checked=!this.checked"/> -</handlers> -</pre> - -<p>Lorsque l'utilisateur clique et relâche le bouton de la souris au dessus de la case à cocher, l'événement 'mouseup' lui est envoyé, et le gestionnaire défini ici est appelé, entraînant le renversement de l'état de la propriété <code>checked</code>. De même, vous pouvez modifier une propriété lorsque l'élément est sélectionné. Vous devrez ajouter des gestionnaires pour ajuster les propriétés lors de sollicitations de la souris ou du clavier.</p> - -<h4 id="Gestionnaire_d.27.C3.A9v.C3.A9nements_de_souris" name="Gestionnaire_d.27.C3.A9v.C3.A9nements_de_souris">Gestionnaire d'événements de souris</h4> - -<p>Pour des événements concernant la souris, vous pouvez utiliser l'attribut <code>button</code> pour que le gestionnaire n'accepte que les événements qui correspondent à un certain bouton. Sans cet attribut, le gestionnaire intercepterait tous les événements concernant la souris sans se soucier du bouton qui a été pressé. L'attribut <code>button</code> doit être défini à '0' pour le bouton gauche de la souris, '1' pour le bouton du milieu de la souris ou '2' pour le bouton droit de la souris.</p> - -<pre><handlers> - <handler event="click" button="0" action="alert('Le bouton gauche est pressé');"/> - <handler event="mouseup" button="1" action="alert('Le bouton du milieu est pressé')"/> - <handler event="click" button="2" action="alert('Le bouton droit est pressé');"/> -</handlers> -</pre> - -<h4 id="Gestionnaire_d.27.C3.A9v.C3.A9nements_clavier" name="Gestionnaire_d.27.C3.A9v.C3.A9nements_clavier">Gestionnaire d'événements clavier</h4> - -<p>Pour les événements provenant des touches du clavier, vous pouvez utiliser plusieurs attributs similaires à ceux de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> pour les faire correspondre à une touche spécifique et seulement lorsque certaines touches alternatives sont pressées. L'exemple précédent pourrait être complété de telle sorte que la propriété <code>checked</code> de la case à cocher soit modifiée lorsque la barre d'espacement est pressée.</p> - -<pre><handlers> - <handler event="keypress" key=" " action="this.checked=!checked"/> -</handlers> -</pre> - -<p>Vous pouvez aussi utiliser l'attribut <code>keycode</code> pour tester les touches non imprimables. La section sur les <a href="/fr/Tutoriel_XUL/Raccourcis_clavier" title="fr/Tutoriel_XUL/Raccourcis_clavier">raccourcis clavier</a> fournit plus d'informations. Les touches alternatives peuvent être vérifiées en ajoutant un attribut <code>modifiers</code>. Il peut être défini avec l'une des valeurs suivante :</p> - -<dl> - <dt>'alt' </dt> - <dd>L'utilisateur doit presser la touche <code>Alt</code>.</dd> - <dt>'control' </dt> - <dd>L'utilisateur doit presser la touche <code>Ctrl</code>.</dd> - <dt>'meta' </dt> - <dd>L'utilisateur doit presser la touche <code>Meta</code>.</dd> - <dt>'shift' </dt> - <dd>L'utilisateur doit presser la touche <code>Maj</code>.</dd> - <dt>'accel' </dt> - <dd>L'utilisateur doit presser la touche alternative spéciale qui est habituellement utilisée pour les raccourcis clavier sur sa plateforme.</dd> -</dl> - -<p>S'il est déclaré, le gestionnaire est appelé uniquement lorsque la touche alternative est pressée. Vous pouvez combiner plusieurs touches modificatrices en les séparant par des espaces.</p> - -<p>La syntaxe alternative suivante peut être utilisée lorsque le code dans un gestionnaire est plus complexe :</p> - -<pre><binding id="nom-liaison"> - <handlers> - <handler event="nom-evenement"> - -- le code du gestionnaire vient ici -- - </handler> - </handlers> -</binding> -</pre> - -<h3 id="Exemple_de_gestionnaires" name="Exemple_de_gestionnaires">Exemple de gestionnaires</h3> - -<p>L'exemple suivant ajoute des gestionnaires de touches pour créer un presse-papiers local très primitif :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblevents_1.xml.txt">Source</a></p> - -<pre><binding id="clipbox"> - <content> - <xul:textbox/> - </content> - <implementation> - <field name="clipboard"/> - </implementation> - <handlers> - <handler event="keypress" key="x" modifiers="control" - action="this.clipboard=document.getAnonymousNodes(this)[0].value; document.getAnonymousNodes(this)[0].value='';"/> - <handler event="keypress" key="c" modifiers="control" - action="this.clipboard=document.getAnonymousNodes(this)[0].value;"/> - <handler event="keypress" key="v" modifiers="control" - action="document.getAnonymousNodes(this)[0].value=this.clipboard ? this.clipboard : '';"/> - </handlers> -</binding> -</pre> - -<p>Le contenu est un champ de saisie simple. Un champ <code>clipboard</code> lui a été ajouté pour stocker le contenu du presse-papiers. Il signifie que les opérations de presse-papiers sont limitées à ce seul champ de saisie. Le tampon sera propre à ce champ.</p> - -<p>Trois gestionnaires ont été ajoutés, un pour couper, un pour copier et l'autre pour coller. Chacun d'eux a sa propre combinaison de touche appelante. Le premier gestionnaire est l'opération <em>Couper</em> et est appelé lorsque la touche <code>Ctrl</code> est pressée suivie de la touche <code>x</code>. Le script à l'intérieur de l'attribut <code>action</code> est utilisé pour couper le texte du champ de saisie et pour le mettre dans le champ du presse-papiers. Pour faire simple, le texte entier est coupé et pas seulement le texte sélectionné. Le code fonctionne comme suit :</p> - -<ol> - <li> - <pre>this.clipboard=document.getAnonymousNodes(this)[0].value;</pre> - On récupère le premier élément du tableau de contenu anonyme qui donne une référence à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> qui s'avère être le premier (et le seul) élément au sein de l'élément <code>content</code>. On récupère la propriété <code>value</code> qui fournira le texte du champ de saisie. Elle est ainsi assignée au champ du presse-papiers. Le résultat est que le texte qui se trouve dans la champ de saisie est copié dans ce presse-papiers spécial.</li> - <li> - <pre>document.getAnonymousNodes(this)[0].value=''</pre> - On assigne ainsi au texte de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> une chaîne de caractères vide. Elle efface le texte dans le champ de saisie.</li> -</ol> - -<p>Une opération de copie est similaire mais n'efface pas le texte. Le collage est l'opération inverse si ce n'est que la valeur du champ de saisie est assignée à partir de la valeur du champ du presse-papiers. Si nous étions en train de créer une réelle implémentation de ces raccourcis clavier de presse-papiers, nous utiliserions probablement l'interface réelle du presse-papiers et nous gèrerions également la sélection courante.</p> - -<hr> -<p>Dans la prochaine section, nous verrons comment étendre les définitions XBL existantes.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_méthodes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Héritage_XBL">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaires_d'évènements/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaires_d'évènements/index.html deleted file mode 100644 index df33636311..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_gestionnaires_d'évènements/index.html +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Ajout de gestionnaires d'évènements -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajout_de_gestionnaires_d'évènements -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Event_Handlers ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Menus_défilants" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_sur_les_gestionnaires_d'évènements">Suivant »</a></p> -</div> - -<p>La boîte de dialogue de recherche de fichiers est tout à fait correcte à ce stade. Nous ne l'avons pas beaucoup optimisée mais nous avons facilement créé une interface utilisateur. Dans ce qui suit, nous allons montrer comment lui ajouter des scripts.</p> - -<h3 id="Utilisation_de_scripts" name="Utilisation_de_scripts">Utilisation de scripts</h3> - -<p>Pour rendre la boîte de dialogue de recherche de fichiers fonctionnelle, nous avons besoin d'ajouter des scripts qui vont s'exécuter quand l'utilisateur interagira avec le dialogue. Nous voudrions ajouter un script pour gérer le bouton « Rechercher », le bouton « Annuler » et pour gérer chaque commande du menu. Nous écrirons ces scripts en utilisant des fonctions <a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a> de la même manière qu'en <a href="/fr/HTML" title="fr/HTML">HTML</a>.</p> - -<p>Vous pouvez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/script" title="script">script</a></code> pour inclure des scripts dans des fichiers XUL. Vous pouvez aussi inclure le script directement dans le fichier XUL entre les balises <code><a href="/fr/docs/Mozilla/Tech/XUL/script" title="script">script</a></code> ouvrante et fermante, mais il est préférable de placer le code dans un fichier séparé. Votre fenêtre XUL se chargera un peu plus rapidement. Nous utiliserons alors l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code> pour lier un fichier de script externe.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> - -<p>Ajoutons un script au dialogue de recherche de fichiers. Bien que le nom du fichier de script n'ait pas d'importance, il est courant de lui donner le même nom que celui du fichier XUL, avec l'extension 'js'. Dans ce cas, on utilisera 'findfile.js'. Ajoutez la ligne ci-dessous juste après la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> ouvrante et AVANT tout autre élément.</p> - -<pre class="eval"><span class="highlightred"><script src="findfile.js"/></span> -</pre> - -<p>Nous créerons le fichier de script plus tard, quand nous connaîtrons son contenu. Nous y définirons des fonctions que nous pourrons appeler dans des gestionnaires d'événements.</p> -</div> - -<p>Nous pouvons inclure de multiples scripts dans un fichier XUL en utilisant de multiples balises <code><a href="/fr/docs/Mozilla/Tech/XUL/script" title="script">script</a></code>, chacune pointant vers un script différent. Nous pouvons utiliser des URLs relatives ou absolues. Par exemple, nous pouvons utiliser des URLs sous les formes suivantes :</p> - -<pre class="eval"><script src="findfile.js"/> -<script src="<a class="external" rel="freelink">chrome://findfiles/content/help.js</a>"/> -<script src="<span class="nowiki">http://www.example.com/js/items.js</span>"/> -</pre> - -<p>Ce tutoriel n'a pas pour but de décrire comment écrire du JavaScript. C'est un sujet vaste et il existe déjà beaucoup de documentation le traitant.</p> - -<div class="note">Par défaut, la console JavaScript n'affiche que les erreurs provenant des contenus Web. Pour voir les erreurs JavaScript du chrome, il est nécessaire de modifier la préférence <code>javascript.options.showInConsole</code> à 'true'. Vous pouvez également faire du débogage en modifiant la préférence <code>javascript.options.strict</code>. En la définissant à 'true', les erreurs causés par des codes non standard, mal écrits, ou syntaxiquement erronés seront affichés dans la console d'erreurs.</div> - -<h3 id="R.C3.A9ponse_aux_.C3.A9v.C3.A9nements" name="R.C3.A9ponse_aux_.C3.A9v.C3.A9nements">Réponse aux événements</h3> - -<p>Le script contiendra le code qui répondra aux différents événements déclenchés par l'utilisateur ou par d'autres situations. Il existe environ une trentaine d'événements pouvant être gérés de différentes manières. Un événement classique est le bouton de souris ou la touche pressée par l'utilisateur. Chaque élément XUL a la capacité de déclencher certains événements dans des situations différentes. Quelques déclenchements d'événements sont spécifiques à certains éléments.</p> - -<p>Chaque événement a un nom, par exemple, 'mousemove' est le nom de l'événement qui est déclenché quand l'utilisateur passe la souris au-dessus d'un élément d'interface utilisateur. XUL utilise le mécanisme d'événement défini par le <a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2/events/Overview.html">DOM Events</a> (Version traduite). Quand survient une action devant déclencher un événement, telle que le déplacement de la souris par l'utilisateur, un objet 'event' correspondant à ce type d'événement est créé. Des propriétés sont assignées à cet objet event telles que la position de la souris, la touche pressée, etc.</p> - -<p>L'événement est ensuite envoyé au XUL par phases.</p> - -<ul> - <li>Dans la phase de capture, l'événement est d'abord envoyé à la fenêtre, puis au document, suivi par chaque ancêtre de l'élément XUL visé, jusqu'à ce qu'il l'atteigne.</li> - <li>Dans la phase de ciblage, l'événement est envoyé à l'élément XUL cible.</li> - <li>Pendant la phase de diffusion, l'événement est envoyé à chaque élément dans l'autre sens jusqu'à ce qu'il atteigne à nouveau la fenêtre.</li> -</ul> - -<p>Vous pouvez réagir à un événement pendant la phase de capture ou de diffusion. Une fois que l'événement a terminé de se propager, l'action correspondant au comportement natif de l'élément est déclenchée.</p> - -<p>Par exemple, quand la souris passe sur un bouton inclus dans une boîte, un événement 'mousemove' est généré et envoyé d'abord à la fenêtre, puis au document et ensuite à la boîte. Cela complète la phase de capture. Ensuite, l'événement 'mousemove' est envoyé au bouton. Enfin la phase de diffusion se traduit par le renvoi de l'événement vers la boîte, puis le document et enfin la fenêtre. La phase de diffusion est par essence l'inverse de la phase de capture. Notez que certains événements ne passent pas par la phase de diffusion.</p> - -<p>Vous pouvez attacher des scrutateurs à chaque élément pour être à l'écoute des événements pendant chaque étape de leur propagation. Étant donné qu'un simple événement est passé à tous les ancêtres, vous pouvez attacher un scrutateur à un élément spécifique ou à un élément supérieur dans la hiérarchie. Naturellement, un événement attaché à un élément parent recevra une notification de tous les éléments qu'il contient, alors qu'un événement attaché à un bouton recevra seulement des événements concernant ce bouton. C'est utile si vous désirez gérer plusieurs éléments avec un code identique ou similaire.</p> - -<p><span class="comment">Une fois que vous gérez un événement, sans vous souciez du stade de sa propagation, vous voudrez probablement le stopper avant qu'il ne soit envoyé à d'autres éléments, ce qui, en substance, signifie que vous voulez interrompre les phases de capture et de diffusion. Il existe plusieurs façons d'y parvenir, en fonction de la manière avec laquelle vous avez attaché le scrutateur d'événement à un élément.</span></p> - -<p>L'événement le plus utilisé est l'événement 'command'. L'événement 'command' est déclenché quand l'utilisateur active un élément, par exemple en pressant un bouton, en cochant une case ou en sélectionnant une entrée d'un menu. L'événement 'command' est pratique car il gère automatiquement les différentes méthodes d'activation d'un élément. Par exemple, l'événement 'command' se produira indifféremment si l'utilisateur utilise sa souris pour cliquer le bouton ou s'il presse la touche <code>Entrée</code>.</p> - -<p>Il y a deux manières d'attacher un scrutateur d'événement à un élément. Premièrement, en utilisant un attribut avec un script comme valeur. Deuxièmement, en appelant la méthode <code>addEventListener</code> d'un élément. La première manière peut seulement gérer les événements en phase de diffusion mais est plus simple à écrire. La seconde peut gérer les événements sur chaque phase et peut aussi être utilisée pour attacher plusieurs scrutateurs pour un événement à un élément. L'utilisation de la « forme par attribut » est une manière plus commune pour la plupart des événements.</p> - -<h3 id="Scrutateurs_d.27.C3.A9v.C3.A9nements_par_attributs" name="Scrutateurs_d.27.C3.A9v.C3.A9nements_par_attributs">Scrutateurs d'événements par attributs</h3> - -<p>Pour utiliser la forme par attribut, placez un attribut sur un élément à l'endroit que vous voulez, son nom devra être le nom de l'événement précédé par le mot « on ». Par exemple, l'attribut correspondant à l'événement 'command' est <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code>. La valeur de l'attribut devra être le code à exécuter quand l'événement se produira. Typiquement, ce code sera court et appellera une fonction définie dans un script séparé. Voici un exemple de réponse lorsqu'un bouton est pressé :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_1.xul">Voir</a></p> - -<pre><button label="OK" oncommand="alert('Le bouton a été pressé !');"/></pre> - -<p>Puisque l'événement 'command' va se diffuser, il est également possible de placer le scrutateur d'événement sur un élément conteneur. Dans l'exemple ci-dessous, le scrutateur a été placé sur une boîte et il recevra les événements pour tous ses éléments.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_2.xul">Voir</a></p> - -<pre><vbox oncommand="alert(event.target.tagName);"> - <button label="OK"/> - <checkbox label="Voir les images"/> -</vbox> -</pre> - -<p>Dans cet exemple, l'événement 'command' va se diffuser du bouton ou de la case à cocher jusqu'à la boîte, où il sera traité. Si un second scrutateur (l'attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code>) était placé sur le bouton, son code serait appelé en premier, suivi par le gestionnaire de la boîte. L'objet event est transmis aux gestionnaires d'événements comme un argument implicite nommé 'event'. Il est utilisé pour obtenir des informations spécifiques à propos de l'événement. Une des plus utilisées est la propriété 'target' (cible) de l'événement, qui cible l'élément à partir duquel l'événement s'est produit. Dans l'exemple, nous affichons une alerte contenant le nom de l'élément cible. La cible est très utile lors de l'utilisation d'un événement en diffusion dans le cas où vous auriez une série de boutons gérée par un même script.</p> - -<p>Vous noterez que la syntaxe de l'attribut est identique à celle utilisée pour les événements dans les documents HTML. En fait, HTML et XUL partagent le même mécanisme d'événement. Une différence importante est que l'événement 'click' (ou l'attribut <code id="a-onclick"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onclick">onclick</a></code>) est utilisé en HTML pour répondre aux boutons, alors qu'on devra utiliser l'événement 'command' en XUL. XUL possède un événement 'click', mais il répond uniquement aux clics de souris, pas à l'utilisation du clavier. Ainsi, l'événement 'click' devra être évité en XUL, sauf si vous avez une raison d'avoir un élément uniquement géré avec la souris. De plus, tandis que l'événement 'command' ne sera pas envoyé si un élément est désactivé, l'événement 'click' sera envoyé sans tenir compte de l'état activé ou non de l'élément.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers_2" name="Notre_exemple_de_recherche_de_fichiers_2">Notre exemple de recherche de fichiers</h4> - -<p>Un gestionnaire <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> peut être placé sur les boutons « Rechercher » et « Annuler » dans le dialogue de recherche de fichiers. L'appui sur le bouton « Rechercher » devrait démarrer la recherche. Comme nous n'implémenterons pas cette partie, nous l'omettrons. En revanche, l'appui sur le bouton « Annuler » devrait fermer la fenêtre. Le code ci-dessous montre comment le faire. Pendant que nous y sommes, ajoutons le même code à l'item de menu « Fermer ».</p> - -<pre class="eval"><menuitem label="Fermer" accesskey="c" <span class="highlightred">oncommand="window.close();"</span>/> -... - -<button id="cancel-button" label="Annuler" - <span class="highlightred">oncommand="window.close();</span>"/> -</pre> -Deux gestionnaires ont été ajoutés ici. L'attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> a été ajouté à l'item de menu « Fermer ». En utilisant ce gestionnaire, l'utilisateur pourra fermer la fenêtre en cliquant sur l'item de menu ou en le sélectionnant par le clavier. Le gestionnaire <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> a également été ajouté au bouton « Annuler ».</div> - -<h3 id="Scrutateurs_d.27.C3.A9v.C3.A9nements_DOM" name="Scrutateurs_d.27.C3.A9v.C3.A9nements_DOM">Scrutateurs d'événements DOM</h3> - -<p>La seconde façon d'ajouter un gestionnaire d'événement est d'appeler la méthode <code>addEventListener</code> d'un élément. Celle-ci vous permet d'attacher dynamiquement un scrutateur d'événement et de scruter les événements durant la phase de capture. La syntaxe est la suivante :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_events_3.xul">Voir</a></p> - -<pre><button id="okbutton" label="OK"/> - -<script> -function buttonPressed(event) { - alert('Le bouton a été pressé !'); -} - -var button = document.getElementById("okbutton"); -button.addEventListener('command', buttonPressed, true); -</script> -</pre> - -<p>La fonction <code><a href="/fr/DOM/document.getElementById" title="fr/DOM/document.getElementById">getElementById()</a></code> retourne l'élément ayant un identifiant id, dans notre cas, le bouton. La fonction <code><a href="/fr/DOM/element.addEventListener" title="fr/DOM/element.addEventListener">addEventListener()</a></code> est appelée pour ajouter un nouveau scrutateur d'événement en phase de capture. Le premier argument est le nom de l'événement à scruter. Le deuxième argument est la fonction du scrutateur d'événement qui sera appelée quand l'événement se produira. Enfin, le dernier argument devra être 'true' pour les scrutateurs en phase de capture. Vous pouvez également scruter durant la phase de diffusion en donnant la valeur 'false' au dernier argument. La fonction scrutateur d'événement passée comme deuxième argument devra avoir un argument, l'objet 'event', comme vous le voyez dans la déclaration de la fonction buttonPressed ci-dessus.</p> - -<hr> -<div class="highlight"> -<p>Le dialogue de recherche de fichiers à ce stade : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-events.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-events.xul">Voir</a></p> -</div> - -<p>Dans la prochaine section, nous aborderons plus en détail l'objet <code>event</code>.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Menus_défilants" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_sur_les_gestionnaires_d'évènements">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_méthodes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_méthodes/index.html deleted file mode 100644 index c0adc86eaa..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_méthodes/index.html +++ /dev/null @@ -1,194 +0,0 @@ ---- -title: Ajout de méthodes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajout_de_méthodes -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Methods_to_XBL-defined_Elements ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_propriétés" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaire_d'évènements">Suivant »</a></p> -</div> - -<p>Nous allons voir comment ajouter des méthodes personnalisées aux éléments définis en <a href="/fr/XBL" title="fr/XBL">XBL</a>.</p> - -<h3 id="Les_m.C3.A9thodes" name="Les_m.C3.A9thodes">Les méthodes</h3> - -<p>En plus d'ajouter des propriétés de script à l'élément défini en XBL, vous pouvez aussi y ajouter des méthodes. Ces méthodes peuvent être appelées à partir d'un script. Les méthodes sont des fonctions d'objets, comme <code>window.open()</code>. Vous pouvez définir des méthodes personnalisées pour vos éléments en utilisant l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#method">method</a></code>. La syntaxe générale des méthodes est définie comme suit :</p> - -<pre><implementation> - <method name="method-name"> - <parameter name="parameter-name1"/> - <parameter name="parameter-name2"/> - . - . - . - <body> - -- le script de la méthode vient ici -- - </body> - </method> -</implementation> -</pre> - -<p>Une déclaration de méthode se fait au travers de l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#implementation">implementation</a></code>, comme pour les champs et les propriétés. L'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#method">method</a></code> contient deux types d'éléments fils, les éléments <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#parameter">parameter</a></code> qui décrivent les paramètres de la méthode et <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#body">body</a></code> qui contient le script de la méthode.</p> - -<p>La valeur de l'attribut <code>name</code> devient le nom de la méthode. De même, les attributs <code>name</code> des éléments <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#parameter">parameter</a></code> deviennent les noms de chaque paramètre. Chaque élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#parameter">parameter</a></code> est utilisé pour déclarer l'un des paramètres pour la méthode. Par exemple, si la méthode a trois paramètres, il y aura trois éléments <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#parameter">parameter</a></code>. Si vous n'avez pas besoin d'en avoir, la méthode n'aura pas de balise <code>parameter</code>.</p> - -<p>L'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#body">body</a></code> contient le script qui est exécuté lorsque la méthode est appelée. Les noms des paramètres sont définis comme des variables dans le script comme s'ils étaient passés en paramètre. Par exemple, la fonction JavaScript suivante serait écrite en tant que méthode XBL comme ceci :</p> - -<pre class="eval">function getMaximum(num1,num2) -{ - if (num1<=num2) return num2; - else return num1; -} - -<strong>XBL:</strong> - -<method name="getMaximum"> - <parameter name="num1"/> - <parameter name="num2"/> - <body> - if (num1&lt;=num2) return num2; - else return num1; - </body> -</method> -</pre> - -<p>Cette fonction, <code>getMaximum</code>, retourne la plus grande des valeurs passées chacune comme un paramètre dans la méthode. Notez que le symbole inférieur doit être un caractère d'échappement parce qu'autrement il ressemblerait au commencement d'une balise. Vous pouvez aussi utiliser une section CDATA pour échapper le bloc entier de code. Vous pouvez appeler la méthode en utilisant un code comme <code>element.getMaximum(5,10)</code> où <code>element</code> est une référence à un élément défini par l'élément XBL contenant la méthode <code>getMaximum</code> (L'élément de liaison).</p> - -<p>La balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#parameter">parameter</a></code> vous permet de définir des paramètres pour une méthode. Comme Mozilla utilise JavaScript pour son langage de script, et que JavaScript est un langage non typé, vous n'avez pas besoin de spécifier le type des paramètres. Cependant, dans le futur, d'autres langages devraient être utilisés avec XBL.</p> - -<h3 id="Acc.C3.A8s_au_contenu_anonyme" name="Acc.C3.A8s_au_contenu_anonyme">Accès au contenu anonyme</h3> - -<p>Il peut y avoir des fois où vous voulez modifier certains aspects des éléments définis dans l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#content">content</a></code>, que ce soit à partir d'une méthode <code>body</code> ou d'ailleurs. Ces éléments sont créés anonymement et ne sont pas accessibles à partir des fonctions habituelles du DOM (Modèle Objet de Document). Elles sont cachées de telle sorte que les développeurs n'aient pas besoin de savoir comment l'élément est implémenté pour l'utiliser. Cependant, il existe un moyen spécial pour obtenir ce contenu anonyme.</p> - -<p>Les éléments auxquels un comportement XBL est attaché ont une propriété spéciale qui contient un tableau des éléments fils anonymes. Chaque élément du tableau stocke chaque élément fils direct de l'élément XBL défini. Cette propriété spéciale ne peut pas être accessible directement. À la place, vous devez appeler la méthode <code>getAnonymousNodes</code> du document.</p> - -<pre>var value=document.getAnonymousNodes(element);</pre> - -<p>Ici, 'element' devrait être une référence à l'élément dont vous voulez obtenir le contenu anonyme. La fonction retourne un tableau d'éléments qui est le contenu anonyme. Pour obtenir des éléments en-dessous de celui-ci, vous pouvez utiliser les fonctions habituelles du DOM (Modèle Objet de Document) car elles ne sont pas cachées. Notez qu'il est possible pour un élément XBL lié d'être placé à l'intérieur d'un autre, auquel cas vous devrez utiliser une nouvelle fois la fonction <code>getAnonymousNodes</code>.</p> - -<p>L'exemple suivant crée une rangée de boutons :</p> - -<pre><binding id="buttonrow"> - <content> - <button label="Oui"/> - <button label="Non"/> - <button label="Trier par"/> - </content> -</binding> -</pre> - -<p>Pour vous référer à chaque bouton, vous pouvez utiliser la fonction <code>getAnonymousNodes</code>, en lui passant une référence à l'élément auquel la liaison est attachée, en tant que paramètre. Dans le tableau renvoyé, le premier bouton est stocké dans le premier item du tableau (<code>getAnonymousNodes(element)[0]</code>), le deuxième bouton est stocké dans le deuxième item du tableau et le troisième est stocké dans le troisième item du tableau. Pour coder à l'intérieur d'une méthode de liaison, vous pouvez passer <code>this</code> comme paramètre à <code>getAnonymousNodes</code>.</p> - -<p>Le prochain exemple peut être utilisé pour créer un texte avec un libellé. La méthode <code>showTitle</code> sert à montrer ou à cacher un libellé. Elle fonctionne en obtenant une référence à l'élément titre en utilisant le tableau anonyme et en changeant sa visibilité.</p> - -<pre class="eval"><strong>XUL:</strong> - -<box id="num" class="labeledbutton" title="Plusieurs choses :" value="52"/> - -<button label="Montrer" oncommand="document.getElementById('num').showTitle(true)"/> -<button label="Cacher" oncommand="document.getElementById('num').showTitle(false)"/> - -<strong>XBL:</strong> - -<binding id="labeledbutton"> - <content> - <xul:label xbl:inherits="value=title"/> - <xul:label xbl:inherits="value"/> - </content> - <implementation> - <method name="showTitle"> - <parameter name="state"/> - <body> - if (state) document.getAnonymousNodes(this)[0]. - setAttribute("style","visibility: visible"); - else document.getAnonymousNodes(this)[0]. - setAttribute("style","visibility: collapse"); - </body> - </method> - </implementation> -</binding> -</pre> - -<p>Les deux boutons ajoutés dans le contenu XUL ont des gestionnaires <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> qui sont utilisés pour changer la visibilité du libellé. Chacun d'eux appelle la méthode <code>showTitle</code>. Cette méthode vérifie le paramètre <code>state</code> pour voir si l'élément sera caché ou montré. Dans un cas comme dans l'autre, elle récupère le premier élément du tableau anonyme. Celui-ci se rapporte au premier fils de l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#content">content</a></code> qui ici est le premier élément <code>label</code> de l'élément graphique. La visibilité est changée en modifiant le style de l'élément.</p> - -<h3 id="Acc.C3.A8s_depuis_l.27int.C3.A9rieur_du_contenu_anonyme" name="Acc.C3.A8s_depuis_l.27int.C3.A9rieur_du_contenu_anonyme">Accès depuis l'intérieur du contenu anonyme</h3> - -<p>Pour aller dans l'autre sens, et obtenir l'élément XUL liée depuis l'intérieur du contenu anonyme, utilisez la propriété <a href="/fr/DOM/element.parentNode" title="fr/DOM/element.parentNode">parentNode</a> du DOM (Modèle Objet de Document). Elle permet d'obtenir l'élément parent d'un élément. Par exemple, nous pourrions déplacer les boutons 'Montrer' et 'Cacher' dans le fichier XBL et faire la chose suivante :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblmethods_1.xml.txt">Source</a></p> - -<pre><binding id="labeledbutton"> - <content> - <xul:label xbl:inherits="value=title"/> - <xul:label xbl:inherits="value"/> - <xul:button label="Montrer" oncommand="parentNode.showTitle(true);"/> - <xul:button label="Cacher" oncommand="parentNode.showTitle(false);"/> - </content> - <implementation> - <method name="showTitle"> - <parameter name="state"/> - <body> - if (state) document.getAnonymousNodes(this)[0].setAttribute("style","visibility: visible"); - else document.getAnonymousNodes(this)[0].setAttribute("style","visibility: collapse"); - </body> - </method> - </implementation> -</binding> -</pre> - -<p>Les gestionnaires <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> obtiennent ici d'abord une référence à leur élément parent. Il ne s'agit pas de l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#content">content</a></code> mais de l'élément XUL auquel l'élément XBL est lié (Dans cet exemple, c'est la boîte avec la classe 'labeledbutton'). Ainsi, la méthode <code>showTitle</code> est appelée, et fonctionne comme avant.</p> - -<p>Les propriétés et méthodes personnalisées sont ajoutées seulement à l'élément XUL externe auquel l'élément XBL est lié. Aucun des éléments déclarés au sein de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#content">content</a></code> n'ont ces propriétés ou méthodes. C'est pourquoi nous devons obtenir l'élément parent d'abord.</p> - -<p>Les fils d'un élément placés dans le fichier XUL peuvent être récupérés par la voie normale et ne bougent pas même si vous utilisez la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#children">children</a></code>. Par exemple :</p> - -<pre class="eval"><strong>XUL:</strong> - -<box id="outer" class="container"> - <button label="Un"/> - <button label="Deux"/> - <button label="Trois"/> - <button label="Quatre"/> -</box> - -<strong>XBL:</strong> - -<binding id="labeledbutton"> - <content> - <description value="Une pile :"/> - <stack> - <children/> - </stack> - </content> -</binding> -</pre> - -<p>Si vous utilisez les fonctions du DOM (Modèle Objet de Document) telles que <code><a href="/fr/DOM/element.childNodes" title="fr/DOM/element.childNodes">childNodes</a></code> pour obtenir les fils d'un élément, vous verrez que la boîte XUL qui a l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> 'outer', a 4 fils. Ceux-ci correspondent à ses 4 boutons, même si ces boutons sont dessinés à l'intérieur de la pile (<code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>). La pile n'a qu'un seul fils, l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#children">children</a></code> lui-même. La longueur du tableau anonyme de la boîte externe est de deux, le premier élément étant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> et le second étant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>.</p> - -<h3 id="Constructeurs_et_Destructeurs" name="Constructeurs_et_Destructeurs">Constructeurs et Destructeurs</h3> - -<p>XBL supporte deux méthodes spéciales créées avec des balises séparées, <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#constructor">constructor</a></code> et <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#destructor">destructor</a></code>. Un constructeur est appelé chaque fois qu'une liaison est attachée à un élément. Il est utilisé pour initialiser le contenu tel que le chargement de préférences ou l'initialisation des valeurs par défaut de champs. Le destructeur est appelé lorsqu'une liaison est enlevée d'un élément. Il peut s'avérer utile pour sauvegarder des informations.</p> - -<p>Il y a deux points à savoir lorsqu'une liaison est attachée à un élément. Le premier se produit lorsqu'une fenêtre est affichée. Tous les constructeurs des éléments qui ont un contenu XBL attaché seront invoqués. L'ordre dans lequel ils sont appelés ne devrait pas être pris en compte, car ils sont chargés à partir divers fichiers. Le gestionnaire de chargement de la fenêtre (<code id="a-onload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onload">onload</a></code>) n'est pas appelé tant que toutes les liaisons n'ont pas été attachées et leurs constructeurs exécutés. Le second point quand une liaison est attachée, est lorsque vous changez la propriété de style <a href="/fr/docs/Web/CSS/-moz-binding" title="La propriété -moz-binding, utilisée par les applications Mozilla, permet d'attacher une liaison (binding) XBL à un élément DOM."><code>-moz-binding</code></a> d'un élément. Après que son destructeur ait été appelé, la liaison existante sera enlevée. Ainsi, la nouvelle liaison sera ajoutée à sa place et son constructeur sera invoqué.</p> - -<p>Le script pour un constructeur ou un destructeur devrait être placé directement à l'intérieur de la balise appropriée. Il ne doit y avoir qu'un seul de chaque par liaison et ils ne prennent aucun argument. Voici quelques exemples :</p> - -<pre><constructor> - if (this.childNodes[0].getAttribute("open") == "true"){ - this.loadChildren(); - } -</constructor> - -<destructor action="saveMyself(this);"/> -</pre> - -<hr> -<p>La prochaine section montre comment ajouter des gestionnaires d'événements aux éléments XBL définis.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_propriétés" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaire_d'évènements">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_propriétés/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_propriétés/index.html deleted file mode 100644 index 0294706900..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajout_de_propriétés/index.html +++ /dev/null @@ -1,168 +0,0 @@ ---- -title: Ajout de propriétés -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajout_de_propriétés -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Properties_to_XBL-defined_Elements ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Héritage_d'attributs_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_méthodes">Suivant »</a></p> -</div> - -<p>Nous allons voir comment ajouter des propriétés personnalisées aux éléments XBL (eXtended Binding Language).</p> - -<h3 id="L.27interface_XBL" name="L.27interface_XBL">L'interface XBL</h3> - -<p><a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a> et le <a href="/fr/DOM" title="fr/DOM">DOM</a> fournissent un moyen pour obtenir et définir les propriétés des éléments. Avec XBL, vous pouvez définir vos propres propriétés pour les éléments que vous créez. Vous pouvez aussi ajouter des méthodes qui peuvent être appelées. De cette façon, tout ce dont vous avez besoin est d'obtenir une référence à l'élément (en utilisant <code><a href="/fr/DOM/document.getElementById" title="fr/DOM/document.getElementById">getElementById</a></code> ou une fonction similaire) et ainsi obtenir ou modifier ses propriétés additionnelles et appeler ses méthodes.</p> - -<p>Il y a trois types d'items que vous pouvez ajouter.</p> - -<ul> - <li>Les <em>champs</em> sont utilisés pour contenir une valeur simple.</li> - <li>Les <em>propriétés</em> peuvent aussi être utilisées pour contenir une valeur mais elles peuvent aussi contenir du code pouvant être exécuté lorsqu'une tentative est faite pour récupérer ou modifier la valeur.</li> - <li>Les <em>méthodes</em> sont des fonctions qui peuvent être exécutées.</li> -</ul> - -<p>Chacun des trois est défini dans un élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#implementation">implementation</a></code>, qui doit être un fils de l'élément de liaison <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#binding">binding</a></code>. À l'intérieur de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#implementation">implementation</a></code>, vous définirez pour chacun d'eux un élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code>, un élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#property">property</a></code> et un élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#method">method</a></code> selon ce que vous voulez. La syntaxe générale est celle-ci :</p> - -<pre><binding id="nom-élément"> - <content> - -- le contenu vient ici -- - </content> - <implementation> - <field name="nom-champ-1"/> - <field name="nom-champ-2"/> - <field name="nom-champ-3"/> - - <property name="nom-propriété-1"/> - <property name="nom-propriété-2"/> - <property name="nom-propriété-3"/> - . - . - . - <method name="nom-méthode-1"> - -- le contenu vient ici -- - </method> - . - . - . - </implementation> -</binding> -</pre> - -<h3 id="Les_champs" name="Les_champs">Les champs</h3> - -<p>Chaque champ est défini en utilisant l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code>. Souvent, les champs correspondent à un attribut placé sur l'élément comme <code>label</code> ou <code>disabled</code>, mais ils ne le devraient pas.</p> - -<p>L'attribut <code>name</code> de <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code> est utilisé pour indiquer le nom du champ. Vous pouvez utiliser le nom dans un script pour obtenir et déterminer une valeur. L'exemple ci-dessous crée un bouton qui génère et stocke un nombre aléatoire. Vous pouvez rechercher ce même nombre plusieurs fois en obtenant la propriété <code>number</code> du bouton. Le plus gros du travail ici est fait par les gestionnaires <code>oncommand</code>. Plus tard, nous verrons comment transformer cela en XBL.</p> - -<pre class="eval"><strong>XUL:</strong> - -<box id="random-box" class="randomizer"/> - -<button label="Générer" - oncommand="document.getElementById('random-box').number=Math.random();"/> -<button label="Voir" - oncommand="alert(document.getElementById('random-box').number)"/> - -<strong>XBL:</strong> - -<binding id="randomizer"> - <implementation> - <field name="number"/> - </implementation> -</binding> -</pre> - -<p>Un champ <code>number</code> mémorisant le nombre aléatoire a été défini dans la liaison. Les deux boutons spéciaux définissent et obtiennent la valeur de ce champ. La syntaxe est très similaire pour obtenir et définir les propriétés des éléments HTML. Dans cet exemple, aucun contenu n'a été placé à l'intérieur que ce soit la boîte XUL ou sa définition dans XBL, ce qui est parfaitement valide.</p> - -<p>Cet exemple n'est pas tout à fait correct car il n'y a pas de valeur par défaut assignée dans le champ. Pour en mettre une, ajoutez la valeur par défaut dans le contenu de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code>. Par exemple :</p> - -<pre><field name="number"> - 25 -</field> -</pre> - -<p>Ici, la valeur '25' sera affectée comme valeur par défaut du champ "number". En fait, vous pourriez aussi insérer un script au sein de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code> pour calculer la valeur par défaut. Cela pourrait être nécessaire si la valeur a besoin d'être calculée. Par exemple, le champ suivant donne une valeur par défaut égale à l'heure courante :</p> - -<pre><field name="currentTime"> - new Date().getTime(); -</field> -</pre> - -<h3 id="Les_propri.C3.A9t.C3.A9s" name="Les_propri.C3.A9t.C3.A9s">Les propriétés</h3> - -<p>Parfois vous voulez valider la donnée qui est assignée à une propriété. Ou bien, vous souhaitez que la valeur soit calculée dynamiquement lorsqu'on le lui demande. Par exemple, si vous souhaitez une propriété qui prenne en compte l'heure courante, vous voudrez que sa valeur soit générée au besoin. Dans ces cas là, vous avez besoin d'utiliser une balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#property">property</a></code> à la place de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code>. Sa syntaxe est similaire mais comporte des particularités supplémentaires.</p> - -<h4 id="Attributs_onget_et_onset" name="Attributs_onget_et_onset">Attributs onget et onset</h4> - -<p>Vous pouvez utiliser les attributs <code>onget</code> et <code>onset</code> pour que le code soit exécuté lorsque la propriété est lue ou modifiée. Ajoutez les à l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#property">property</a></code> et définissez leur valeur dans un script qui, au choix, obtient ou déclare la valeur de la propriété.</p> - -<p>Par exemple, vous pouvez assigner un script à la valeur de <code>onget</code> pour calculer le temps courant. Chaque fois qu'un script tente d'accéder à la valeur de la propriété, le script <code>onget</code> sera appelé pour fournir la valeur. Le script devra retourner la valeur qui devrait être traitée comme étant la valeur de la propriété.</p> - -<p>Le gestionnaire <code>onset</code> est similaire mais est appelé chaque fois qu'un script tente d'assigner une nouvelle valeur à la propriété. Ce script devrait stocker la valeur quelque part, ou la valider. Par exemple, certaines propriétés pourraient juste être capables de stocker des nombres. Les tentatives pour assigner des caractères alphabétiques à ce genre de propriétés ne devraient pas fonctionner.</p> - -<pre><property name="size" - onget="return 77;" - onset="alert('Modifié en :'+val); return val;"/> -</pre> - -<p>Cette propriété retournera toujours '77' lorsqu'elle sera récupérée. Lorsqu'elle sera affectée, un message d'alerte s'affichera et indiquera la valeur à assigner à la propriété. La variable spéciale <code>val</code> contient cette valeur. Utilisez-la pour la valider ou la stocker. La propriété <code>onset</code> devrait aussi retourner la nouvelle valeur.</p> - -<p>Ce qui suit décrit le comportement d'un cas typique :</p> - -<p>Il y a deux éléments, l'un appelé "banana" et l'autre "orange". Chacun d'eux a une propriété spécifique appelée 'size'. Lorsque la ligne de script suivante est exécutée :</p> - -<pre>banana.size = orange.size; -</pre> - -<ol> - <li>Le script <code>onget</code> est appelé pour la propriété "size" de "orange". Il calcule la valeur et la retourne.</li> - <li>Le gestionnaire <code>onset</code> de la propriété "size" de "banana" est appelé. Ce script utilise la valeur passée dans la variable <code>val</code> et l'assigne à la propriété "size" de "banana" de façon quelconque.</li> -</ol> - -<p>Notez que contrairement à un champ, une propriété ne contient pas de valeur. Tenter de définir une propriété qui n'a pas de gestionnaire <code>onset</code> provoquera une erreur. Vous utiliserez souvent un champ séparé pour mémoriser la valeur actuelle de la propriété. Il est aussi commun que les propriétés correspondent à un attribut dans l'élément défini XBL. L'exemple suivant fait correspondre une propriété à un attribut sur un élément.</p> - -<pre><property name="size" - onget="return this.getAttribute('size');" - onset="return this.setAttribute('size',val);" -/> -</pre> - -<p>Chaque fois qu'un script tente d'obtenir la valeur de la propriété, elle est récupérée d'un attribut de même nom de l'élément XUL. Chaque fois qu'un script tente de définir la valeur de la propriété, elle est affectée à l'attribut 'size' de l'élément. C'est pratique parce qu'ainsi vous pouvez modifier la propriété ou l'attribut et tous les deux auront la même valeur.</p> - -<h4 id=".C3.89l.C3.A9ments_getter_et_setter" name=".C3.89l.C3.A9ments_getter_et_setter">Éléments <code>getter</code> et <code>setter</code></h4> - -<p>Vous pouvez utiliser une syntaxe alternative pour les attributs <code>onget</code> et <code>onset</code> pouvant être utile pour des scripts plus longs. Vous pouvez remplacer l'attribut <code>onget</code> par l'élément fils nommé <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#getter">getter</a></code>. De même, vous pouvez remplacer l'attribut <code>onset</code> par l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#setter">setter</a></code>. L'exemple ci-dessous le montre :</p> - -<pre><property name="number"> - <getter> - return this.getAttribute('number'); - </getter> - <setter> - var v = parseInt(val,10); - if (!isNaN(v)) return this.setAttribute('number',''+v); - else return this.getAttribute('number');" - </setter> -</property> -</pre> - -<p>La propriété dans cet exemple ne pourra contenir que des valeurs d'entiers. Si d'autres caractères sont entrés, ils sont supprimés. S'il n'y a aucun chiffre, la valeur n'est pas modifiée. Ces opérations sont effectuées dans le code au sein de l'élément <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#setter">setter</a></code>. La valeur réelle de la propriété est stockée dans l'attribut <code>number</code>.</p> - -<p>Vous pouvez utilisez l'une ou l'autre syntaxe pour créer des gestionnaires de lecture et d'affectation.</p> - -<h4 id="Attribut_readonly" name="Attribut_readonly">Attribut <code>readonly</code></h4> - -<p>Vous pouvez rendre un champ ou une propriété en lecture seule en ajoutant un attribut <code>readonly</code> à la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#field">field</a></code> ou à la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#property">property</a></code>, et en le déclarant à 'true'. Toute tentative d'affecter une valeur à une propriété en lecture seule échouera.</p> - -<hr> -<p>La prochaine section montre comment ajouter des méthodes aux éléments définis en XBL.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Héritage_d'attributs_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_méthodes">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_boutons/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_boutons/index.html deleted file mode 100644 index 33d1b2f376..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_boutons/index.html +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: Ajouter des boutons -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajouter_des_boutons -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Buttons ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Créer_une_fenêtre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_libellés_et_des_images">Suivant »</a></p> -</div> - -<p>Dans cette section, nous regarderons comment ajouter quelques boutons simples dans une fenêtre.</p> - -<h3 id="Ajouter_des_boutons_dans_une_fen.C3.AAtre" name="Ajouter_des_boutons_dans_une_fen.C3.AAtre">Ajouter des boutons dans une fenêtre</h3> - -<p>La fenêtre que nous avons créée jusqu'ici était vide, aussi n'est-elle pas encore très intéressante. Dans cette section, nous y ajouterons deux boutons, un bouton de recherche et un bouton d'annulation. Nous apprendrons également une manière simple de les positionner dans la fenêtre.</p> - -<p>Comme pour HTML, XUL dispose d'un certain nombre de balises qui peuvent être utilisées pour créer des éléments d'interface utilisateur. Le plus basique d'entre eux est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Cet élément sert à créer de simples boutons.</p> - -<p>L'élément bouton a deux propriétés principales : un libellé <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et une image <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. Vous avez besoin soit de l'un, soit de l'autre, soit des deux en même temps. Ainsi, un bouton peut avoir seulement un libellé, seulement une image ou un libellé et une image à la fois. Les boutons sont souvent utilisés dans une boîte de dialogue pour valider ou annuler, par exemple.</p> - -<h3 id="Syntaxe_des_boutons" name="Syntaxe_des_boutons">Syntaxe des boutons</h3> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> a la syntaxe suivante :</p> - -<pre><button - id="identifier" - class="dialog" - label="OK" - image="images/image.jpg" - disabled="true" - accesskey="t"/> -</pre> - -<p>Les attributs sont définis comme suit, et ils sont tous optionnels :</p> - -<dl> - <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> - <dd>Identifiant unique vous permettant d'identifier le bouton. Vous verrez cet attribut sur tous les éléments XUL. Vous pouvez l'utiliser pour vous référer au bouton dans une feuille de style ou dans un script. Cependant, vous devriez ajouter cet attribut à presque tous les éléments. Notez que pour des raisons de simplicité, il n'est pas toujours spécifié dans les exemples de ce tutoriel.</dd> - <dt><code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code> </dt> - <dd>La classe de style du bouton. Elle fonctionne de la même manière qu'en HTML. Elle indique l'aspect du bouton dans la fenêtre. Dans le cas présent, la valeur 'dialog' est utilisée. Dans la plupart des cas, vous n'emploierez pas de classe pour un bouton.</dd> - <dt><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> </dt> - <dd>Le libellé qui apparaîtra sur le bouton. Par exemple : 'OK' ou 'Annuler'. S'il est omis, aucun texte n'apparaît.</dd> - <dt><code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code> </dt> - <dd>L'URL de l'image qui apparaît sur le bouton. Si cet attribut est omis, aucune image n'apparaîtra. Vous pouvez également indiquer l'image dans une feuille de style en utilisant la propriété <code><a href="/fr/CSS/list-style-image" title="fr/CSS/list-style-image">list-style-image</a></code>.</dd> - <dt><code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> </dt> - <dd>Si cet attribut prend la valeur <code>true</code>, le bouton est désactivé. Celui-ci est habituellement dessiné avec le texte écrit en gris. Si le bouton est désactivé, la fonction du bouton ne peut pas être exécutée. Si cet attribut est omis, le bouton est activé. Vous pouvez commuter l'état d'activation du bouton en utilisant Javascript.</dd> - <dt><code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> </dt> - <dd>Cet attribut doit spécifier une lettre qui est employée comme raccourci clavier. Cette lettre doit apparaître, généralement soulignée, dans le libellé. Quand l'utilisateur presse la touche <code>alt</code> (ou une touche équivalente, qui varie en fonction de la plate-forme) et la touche de raccourci, à partir de n'importe où dans la fenêtre, le focus sera mis sur le bouton.</dd> -</dl> - -<div class="note">Notez qu'un bouton supporte plus d'attributs que ceux énumérés ci-dessus. Les autres seront abordés plus tard.</div> - -<h3 id="Quelques_exemples_de_boutons.C2.A0" name="Quelques_exemples_de_boutons.C2.A0:">Quelques exemples de boutons :</h3> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_buttons_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_buttons_1.xul">Voir</a></p> - -<pre class="eval"><button label="Normal"/> -<button label="Désactivé" disabled="true"/> -</pre> - -<div class="float-right"><img alt="Image:xultu_buttons1.png" class="internal" src="/@api/deki/files/1508/=Xultu_buttons1.png"></div> - -<p>Les exemples ci-dessus produiront des boutons comme dans la capture. Le premier bouton est un bouton normal. Le second bouton est désactivé, aussi apparaît-il grisé.</p> - -<p>Nous commencerons par créer un bouton simple de recherche qui permettra de lancer la recherche de fichiers. Le code de l'exemple ci-dessous nous montre comment faire :</p> - -<pre class="eval"><button id="find-button" label="Rechercher"/> -</pre> - -<div class="note">Notez que Firefox ne vous permet pas d'ouvrir des fenêtres chrome à partir de pages Web. Aussi les liens « voir » dans le tutoriel s'ouvriront dans une fenêtre normale de navigation. À cause de cela, les boutons apparaîtront agrandis le long de la fenêtre. Vous pouvez ajouter <code>align="start"</code> sur l'élément <code>window</code> pour éviter cette déformation.</div> - -<div class="highlight"> -<h3 id="L.27exemple_findfile.xul" name="L.27exemple_findfile.xul">L'exemple findfile.xul</h3> - -<p>Ajoutons ce code au fichier <code>findfile.xul</code> que nous avons créé dans la section précédente. Le code doit être inséré entre les balises <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Le code à ajouter est mis en rouge ci-dessous :</p> - -<pre class="eval"><?xml version="1.0"?> -<?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> -<window id="findfile-window" - title="Recherche de fichiers" - orient="horizontal" - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - - <span class="highlightred"><button id="find-button" label="Rechercher"/></span> - <span class="highlightred"><button id="cancel-button" label="Annuler"/></span> - -</window> -</pre> - -<div class="float-right"><img alt="Image:buttons2.png"></div> -Vous noterez que le bouton 'Annuler' a été également ajouté. La fenêtre a une orientation horizontale de sorte que les deux boutons apparaissent l'un à côté de l'autre. Si vous ouvrez le fichier dans Mozilla, vous devriez obtenir quelque chose de similaire à l'image montrée ici.</div> - -<div class="note">Notez que nous ne devrions pas mettre le texte des libellés directement dans le fichier XUL. Nous devrions plutôt employer des <a href="/fr/Tutoriel_XUL/Localisation" title="fr/Tutoriel_XUL/Localisation">entités de sorte que le texte puisse être facilement traduit</a>.</div> - -<p><span class="comment">PAS SUR MDC L'exemple de la boîte de recherche&nbsp;: <a href='exemples/findfile/findfile-buttons.xul.txt'>Source</a> <a href="exemples/findfile/findfile-buttons.xul" onclick="window.open(this.href,'xulff','chrome,resizable'); return false;">Voir</a></span></p> - -<hr> -<p>Dans la section suivante, nous découvrirons comment ajouter des libellés et des images dans une fenêtre XUL.</p> - -<p><br> - </p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Créer_une_fenêtre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_libellés_et_des_images">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_feuilles_de_style/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_feuilles_de_style/index.html deleted file mode 100644 index e357b89163..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_feuilles_de_style/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Ajouter des feuilles de style -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajouter_des_feuilles_de_style -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Style_Sheets ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Données_persistantes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Styler_un_arbre">Suivant »</a></p> -</div> -<p>Jusqu'à présent, nous avons à peine modifier l'aspect visuel des éléments que nous avons créés. XUL utilise CSS (Cascading Style Sheets) pour personnaliser les éléments.</p> -<h3 id="Feuilles_de_styles" name="Feuilles_de_styles">Feuilles de styles</h3> -<p>Une feuille de styles est un fichier qui contient des informations de style pour les éléments. Les styles ont été conçus au départ pour des éléments HTML mais ils peuvent également être appliqués à <a href="/fr/Référence_XUL" title="fr/Référence_XUL">des éléments XUL</a> ou à n'importe quels éléments <a href="/fr/XML" title="fr/XML">XML</a>. La feuille de styles contient des informations telles que les polices, couleurs, bordures et taille des éléments.</p> -<p>Mozilla applique une feuille de styles par défaut pour chaque fenêtre XUL. Dans la plupart des cas, il sera suffisant de laisser les valeurs par défaut telles quelles. Toutefois, vous pouvez fournir une feuille de styles personnalisée. En général vous associerez une seule feuille de styles à chaque fichier XUL.</p> -<p>Vous pouvez placer une feuille de styles où vous le désirez. Si votre fichier XUL se trouve sur un serveur distant et doit être accédé via une URL HTTP, vous pouvez également stocker la feuille de styles à distance. Si vous créez un paquetage XUL destiné à faire partie du système chrome, vous avez deux choix. Premièrement, vous pouvez placer la feuille de styles dans le même répertoire que le fichier XUL. Cette méthode a l'inconvénient d'interdire le changement du thème graphique de votre application. La seconde méthode consiste à placer vos fichiers à l'intérieur d'un thème.</p> -<div class="highlight">Imaginons que nous construisions la boîte de dialogue de recherche de fichiers pour permettre le choix d'un thème. Comme la fenêtre peut être appelée par l'URL '<a class=" external" rel="freelink">chrome://findfile/content/findfile.xul</a>', la feuille de styles sera enregistrée dans '<a class=" external" rel="freelink">chrome://findfile/skin/findfile.css</a>'.</div> -<p>Tous les exemples XUL ont utilisé une feuille de styles jusqu'à présent. La seconde ligne a toujours été :</p> -<pre><?xml-stylesheet href="chrome://global/skin/" type="text/css"?></pre> -<p>Cette ligne indique que nous voulons utiliser le style fourni par <code><a class=" external" rel="freelink">chrome://global/skin/</a></code>. Sous Mozilla, elle sera traduit par le fichier global.css qui contient les informations du style par défaut pour les éléments XUL. Si vous enlevez cette ligne, les éléments fonctionneront, toutefois ils apparaîtront dans un style plus simple. La feuille de styles utilise diverses polices, couleurs et bordures pour rendre l'apparence des éléments plus appropriée.</p> -<h3 id="Modifier_les_styles" name="Modifier_les_styles">Modifier les styles</h3> -<p>Il arrivera toutefois que l'apparence par défaut des éléments ne soit pas celle désirée. Dans ces cas, nous devons ajouter notre propre feuille de styles. Jusqu'à présent, nous avons appliqué différents styles en utilisant l'attribut <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> sur des éléments. Bien que ce soit une technique fonctionnelle, elle n'est pas la meilleure. Il est de loin préférable de créer une feuille de styles séparée. La raison est que des styles ou des thèmes différents peuvent êtres appliqués très facilement.</p> -<p>Il peut y avoir des cas où l'utilisation de l'attribut <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> est acceptable. Un bon exemple serait lorsqu'un script modifie le style d'un élément, ou quand une différence d'agencement pourrait modifier la signification de l'élément. Cependant vous devriez l'éviter autant que possible.</p> -<p>Pour des fichiers installés, vous aurez à créer ou à modifier un fichier manifeste et installer le thème.</p> -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> -<p>Modifions la boîte de dialogue de recherche de fichiers pour que son style provienne d'un fichier style séparé. Tout d'abord, voici les lignes modifiées de findfile.xul :</p> -<pre class="eval"><span class="highlightred"><?xml-stylesheet href="<a class=" external" rel="freelink">chrome://global/skin/</a>" type="text/css"?></span> -<?xml-stylesheet href="findfile.css" type="text/css"?> - ... -<span class="highlightred"><spacer class="titlespace"/></span> - <groupbox orient="horizontal"> - <span class="nowiki"><caption label="Critères de recherche"/></span> - - <menulist id="searchtype"> - <menupopup> - <menuitem label="Nom"/> - <menuitem label="Taille"/> - <menuitem label="Date de modification"/> - </menupopup> - </menulist> - <span class="highlightred"><spacer class="springspace"/></span> - <menulist id="searchmode"> - <menupopup> - <menuitem label="Est"/> - <menuitem label="N'est pas"/> - </menupopup> - </menulist> - - <span class="highlightred"><spacer class="springspace"/> <menulist id="find-text" flex="1"</span> - editable="true" - datasources="<a class=" external" rel="freelink">file:///mozilla/recents.rdf</a>" - ref="<span class="nowiki">http://www.xulplanet.com/rdf/recent/all</span>"/> - ... -<span class="highlightred"><spacer class="titlespace"/> <hbox> <progressmeter id="progmeter" value="50%" style="display:none;"/></span> -</pre> -<p>La nouvelle ligne <code>xml-stylesheet</code> est utilisée afin d'importer la feuille de styles. Elle contiendra les styles au lieu de les avoir directement dans le fichier XUL. Vous pouvez inclure un nombre indéterminé de feuilles de styles de la même façon. Ici la feuille de styles est placée dans le même répertoire que findfile.xul.</p> -<p>Certains des styles dans le code ci-dessus ont été enlevés. La propriété <code>display</code> du <code><a href="/fr/docs/Mozilla/Tech/XUL/progressmeter" title="progressmeter">progressmeter</a></code> ne l'a pas été. Elle sera modifiée par un script donc, le style a été maintenu, car la barre de progression n'a pas à être visible au lancement. Vous pouvez toujours mettre le style dans une feuille de styles séparée si vous le souhaitez vraiment. Une classe a été ajoutée aux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> pour qu'ils puissent être appelés.</p> -<p>Une feuille de styles a également besoin d'être créée. Créez un fichier findfile.css dans le même répertoire que le fichier XUL (Il devrait normalement être mis dans un thème séparé). Dans ce fichier, nous allons ajouter la déclaration de styles, comme indiqué ci-dessous :</p> -<pre>#find-text { - min-width: 15em; -} - -#progmeter { - margin: 4px; -} - -.springspace { - width: 10px; -} - -.titlespace { - height: 10px; -} -</pre> -<p>Remarquez que ces styles sont équivalents aux styles que nous avions précédemment. Cependant, il est beaucoup plus facile pour quelqu'un de changer l'apparence de la boîte de dialogue de recherche de fichiers maintenant car il est possible d'ajouter ou modifier la déclaration de styles en modifiant le fichier ou en changeant le thème. Si l'utilisateur change le thème, les fichiers dans un répertoire autre que celui par défaut seront utilisés.</p> -</div> -<h3 id="Importer_des_feuilles_de_styles" name="Importer_des_feuilles_de_styles">Importer des feuilles de styles</h3> -<p>Nous avons déjà vu comment importer des feuilles de styles. Un exemple est montré ci-dessous :</p> -<pre><?xml-stylesheet href="chrome://bookmarks/skin/" type="text/css"?></pre> -<p>Cette ligne peut être la première d'une fenêtre 'bookmarks'. Elle importe la feuille de style bookmarks, qui est 'bookmarks.css'. Le système de thème de Mozilla est assez intelligent pour savoir quelle feuille de styles utiliser, car le nom spécifique du fichier n'a pas été indiqué ici. Nous avons fait une chose similaire avec la feuille de styles globale (<a class=" external" rel="freelink">chrome://global/skin</a>).</p> -<p>Une feuille de styles peut importer des styles d'une autre feuille en utilisant la directive <code>import</code>. Normalement, vous n'importerez qu'une seule feuille de styles de chaque fichier XUL. La feuille de styles globale peut être importée à partir de celle associée avec le fichier XUL. Ceci peut être fait grâce au code ci-dessous, vous permettant de retirer l'import du fichier XUL :</p> -<pre class="eval"><strong>Importation de styles à partir de XUL :</strong> -<?xml-stylesheet href="<a class=" external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> - -<strong>Importation de styles à partir de CSS :</strong> -@import url(<a class=" external" rel="freelink">chrome://global/skin/</a>); -</pre> -<p>La seconde syntaxe est préférable car elle réduit le nombre de dépendances à l'intérieur du fichier XUL lui-même.</p> -<div class="highlight"> -<p>Retirez l'importation de la feuille de styles globale dans findfile.xul et ajoutez l'importation dans findfile.css.</p> -</div> -<p>Tous les éléments peuvent être décorés à l'aide de <a href="/fr/CSS" title="fr/CSS">CSS</a>. Vous pouvez utiliser des sélecteurs pour sélectionner l'élément que vous souhaitez styler (Le sélecteur est la partie avant l'accolade dans une règle de style). La liste suivante résume quelques-uns des sélecteurs disponibles :</p> -<dl> <dt><code>button</code> </dt> <dd>Désigne toutes les balises <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>.</dd> <dt><code>#special-button</code> </dt> <dd>Désigne les éléments avec un <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de 'special-button'</dd> <dt><code>.bigbuttons</code> </dt> <dd>Désigne tous les éléments avec une classe 'bigbuttons'</dd> <dt><code>button.bigbuttons</code> </dt> <dd>Désigne tous les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> avec une classe à 'bigbuttons'</dd> <dt><code>toolbar > button</code> </dt> <dd>Désigne tous les boutons directement insérés dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>.</dd> <dt><code>toolbar > button.bigbuttons</code> </dt> <dd>Désigne tous les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> avec une classe 'bigbuttons', directement insérés dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code>.</dd> <dt><code>button.bugbuttons:hover</code> </dt> <dd>Désigne tous les éléments <code>button</code> avec une classe 'bigbuttons' mais seulement lorsque la souris se trouve au dessus d'eux.</dd> <dt><code>button#special-button:active</code> </dt> <dd>Désigne tous les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> avec un <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> 'special-button' mais seulement lorsqu'ils sont actifs (en train d'être cliqués).</dd> <dt><code>box[orient="horizontal"]</code> </dt> <dd>Désigne tous les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> avec un attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> réglé sur 'horizontal'.</dd> -</dl> -<p>Vous pouvez combiner ces règles comme vous le désirez. C'est toujours une bonne idée d'être aussi précis que possible lorsque vous spécifiez ce qui doit être décoré et comment. C'est bien plus efficace et réduit également les risques de décorer un mauvais élément.</p> -<div class="highlight"> -<p><span id="La_bo%C3%AEte_de_dialogue_de_recherche_de_fichiers_%C3%A0_ce_stade"><a id="La_bo%C3%AEte_de_dialogue_de_recherche_de_fichiers_%C3%A0_ce_stade"></a><strong>La boîte de dialogue de recherche de fichiers à ce stade</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-style.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-style.xul">Voir</a></p> -</div> -<hr> -<p>Dans la prochaine section, nous verrons comment appliquer des styles aux arbres.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Données_persistantes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Styler_un_arbre">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_libellés_et_des_images/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_libellés_et_des_images/index.html deleted file mode 100644 index 691fda155e..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_des_libellés_et_des_images/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Ajouter des libellés et des images -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajouter_des_libellés_et_des_images -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_Labels_and_Images ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_boutons" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_champs_de_saisie">Suivant »</a></p> -</div> -<p>Cette section décrit la façon d'ajouter des libellés et des images dans une fenêtre. En complément, nous verront comment inclure des éléments dans des groupes.</p> -<h3 id=".C3.89l.C3.A9ments_de_texte" name=".C3.89l.C3.A9ments_de_texte">Éléments de texte</h3> -<p>Vous ne pouvez pas écrire du texte directement dans un fichier XUL sans le placer entre des balises, et espérer qu'il s'affiche. Vous avez deux éléments XUL à votre disposition pour cela.</p> -<h4 id=".C3.89l.C3.A9ment_label" name=".C3.89l.C3.A9ment_label">Élément <code>label</code></h4> -<p>La façon la plus basique pour inclure du texte dans une fenêtre est d'utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>. Il sert à placer un libellé à côté d'un contrôle, tel qu'un bouton. Voici un exemple :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_1.xul">Voir</a></p> -<pre><label value="ceci est du texte"/></pre> -<p>L'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> sert à spécifier le texte à afficher. Le texte ne sera pas coupé, et donc apparaîtra sur une seule ligne. Il s'agit de la syntaxe la plus courante pour des libellés.</p> -<p>Si le texte doit être coupé, vous pouvez placer son contenu à l'intérieur de balises ouvrantes et fermantes comme dans l'exemple suivant :</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span> :</p> -<pre><label>Ceci est un texte plus long qui peut être coupé sur plusieurs lignes.</label></pre> -<p>Comme en HTML, les césures de ligne et espaces supplémentaires sont réduits à un simple espace. Plus tard, nous verrons <a href="/fr/Tutoriel_XUL/Positionnement_des_éléments" title="fr/Tutoriel_XUL/Positionnement_des_éléments">comment imposer la largeur des éléments</a> pour que la césure se voit plus facilement.</p> -<h4 id="Attribut_XULAttrcontrol" name="Attribut_XULAttrcontrol">Attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code></h4> -<p>Vous pouvez utiliser l'attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code> pour définir quel contrôle est associé au libellé. Lorsque l'utilisateur clique sur le libellé associé, le contrôle obtient le focus. Cette association est également importante pour l'<a href="/fr/Accessibilité" title="fr/Accessibilité">accessibilité</a>, permettant aux lecteurs vocaux de lire le libellé du contrôle que l'utilisateur a tabulé. Définissez la valeur de l'attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code> avec l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément obtiendra le focus.</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_3.xul">Voir</a></p> -<pre><label value="Cliquez ici" control="open-button" /> -<button id="open-button" label="Ouvrir"/> -</pre> -<p>Dans l'exemple du dessus, en cliquant sur le libellé, le focus sera mis sur le bouton.</p> -<h4 id=".C3.89l.C3.A9ment_description" name=".C3.89l.C3.A9ment_description">Élément <code>description</code></h4> -<p>Pour du texte descriptif non associé avec un contrôle particulier, vous pouvez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code>. Cet élément est utile pour du texte informatif placé en haut d'une boîte de dialogue ou d'un groupe de contrôles par exemple. Comme pour l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>, vous pouvez soit utiliser l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> pour une seule ligne de texte, soit placer le contenu du texte dans des balises ouvrantes et fermantes <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> pour des blocs de texte plus long. L'usage veut que la syntaxe avec attribut serve pour les libellés et que celle avec le contenu de texte serve pour des descriptions.</p> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_textimage_2.xul">Voir</a></p> -<pre><description> - Cette longue section de texte est affichée. -</description> -</pre> -<p>Intrinsèquement, les deux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> sont les mêmes. Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> sont généralement utilisés pour des libellés, tels que ceux des champs de saisie. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> est généralement employé pour d'autres textes descriptifs telle qu'une information placée en haut d'une boîte de dialogue.</p> -<h3 id="Les_images" name="Les_images">Les images</h3> -<p>Comme en HTML, XUL a un élément pour afficher des images à l'intérieur d'une fenêtre. Cet élément est nommé naturellement <code><a href="/fr/docs/Mozilla/Tech/XUL/image" title="image">image</a></code>. Notez que le nom de la balise est différent de celle en HTML (<code>image</code> au lieu de <code>img</code>). Vous pouvez utiliser l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code> pour indiquer l'URL de l'image. L'exemple suivant le montre :</p> -<pre><image src="images/banner.jpg" /> -</pre> -<p>Bien que vous pouvez utiliser cette syntaxe, il est préférable d'utiliser une feuille de styles pour spécifier une URL. Une section ultérieure vous décriera comment <a href="/fr/Tutoriel_XUL/Ajouter_des_feuilles_de_style" title="fr/Tutoriel_XUL/Ajouter_des_feuilles_de_style">utiliser des feuilles de styles</a>, mais l'exemple ci-dessous vous permettra d'appréhender le sujet. Vous pouvez utiliser le style CSS <code><a href="/fr/CSS/list-style-image" title="fr/CSS/list-style-image">list-style-image</a></code> pour définir l'URL de l'image. Voici des exemples :</p> -<pre class="eval"><strong>XUL:</strong> - <image id="image1"/> - <image id="search"/> -</pre> -<pre class="eval"><strong>Style Sheet:</strong> - #image1 { - list-style-image: url("<a class="external" rel="freelink">chrome://findfile/skin/banner.jpg</a>"); - } - - #search { - list-style-image: url("<span class="nowiki">http://example.com/images/search.png</span>"); - } -</pre> -<p>Ces images proviennent du répertoire chrome, dans le thème du paquetage findfile. Comme les images varient selon le thème graphique, vous devez normalement mettre les images dans le répertoire skin.</p> -<hr> -<p>Dans la section suivante, nous apprendrons comment ajouter des contrôles de saisie à une fenêtre.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_boutons" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_champs_de_saisie">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_plus_d'éléments/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_plus_d'éléments/index.html deleted file mode 100644 index d7ca633691..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/ajouter_plus_d'éléments/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Ajouter plus d'éléments -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Ajouter_plus_d'éléments -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Adding_More_Elements ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_boîtes_de_groupe" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Piles_et_Paquets">Suivant »</a></p> -</div> -<p>Nous allons conclure ce chapitre en ajoutant des boîtes sur notre fenêtre de recherche de fichiers.</p> -<div class="highlight"> - <h3 id="Ajout_d.27.C3.A9l.C3.A9ments_.C3.A0_notre_exemple_de_recherche_de_fichiers" name="Ajout_d.27.C3.A9l.C3.A9ments_.C3.A0_notre_exemple_de_recherche_de_fichiers">Ajout d'éléments à notre exemple de recherche de fichiers</h3> - <p>Nous allons ajouter maintenant des éléments à notre boîte de dialogue de recherche de fichiers. Premièrement, nous allons ajouter la possiblité de faire une recherche sur d'autres informations, comme la taille et la date du fichier.</p> - <pre class="eval"><hbox> - <span class="highlightred"><menulist id="searchtype"> <menupopup> <menuitem label="Nom"/> <menuitem label="Taille"/> <menuitem label="Date de modification"/> </menupopup> </menulist> <spacer style="width: 10px;"/> <menulist id="searchmode"> <menupopup> <menuitem label="Est"/> <menuitem label="N'est pas"/> </menupopup> </menulist> <spacer style="width: 10px;"/></span> - <textbox id="find-text" flex="1" style="min-width: 15em;"/> -</hbox> -</pre> - <div class="float-right"> - <img alt="Image:xultu_boxfinal1.png" class="internal" src="/@api/deki/files/1502/=Xultu_boxfinal1.png"></div> - <p>Deux <a href="/fr/Tutoriel_XUL/Les_contrôles_de_listes#Zones_de_listes_d.C3.A9roulantes" title="fr/Tutoriel_XUL/Les_contrôles_de_listes#Zones_de_listes_d.C3.A9roulantes">listes déroulantes</a> ont été ajoutées à la boîte de dialogue. Un espacement (<code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code>) a été inséré entre chaque élément pour les séparer. Ces espacements ont une taille explicite de 10 pixels chacun. Vous noterez que si la fenêtre est redimensionnée, le champ de saisie s'agrandit mais pas les autres composants. Vous noterez également que le libellé a été enlevé.</p> - <p>Si vous redimensionnez la fenêtre verticalement, les éléments ne changeront pas de taille. C'est parce qu'ils sont à l'intérieur de boîtes horizontales. Ce serait mieux si les boutons « Rechercher » et « Annuler » restaient toujours en bas de la fenêtre. Il est facile de le faire en ajoutant un <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> entre les deux boîtes horizontales.</p> - <pre class="eval"><span class="highlightred"><spacer style="height: 10px"/></span> -<hbox> - <menulist id="searchtype"> - <menupopup> - <menuitem label="Nom"/> - <menuitem label="Taille"/> - <menuitem label="Date de modification"/> - </menupopup> - </menulist> - <spacer style="width: 10px;"/> - <menulist id="searchmode"> - <menupopup> - <menuitem label="Est"/> - <menuitem label="N'est pas"/> - </menupopup> - </menulist> - <spacer style="width: 10px;"/> - <textbox id="find-text" flex="1" style="min-width: 15em;"/> -</hbox> - -<span class="highlightred"><spacer style="height: 10px" flex="1"/></span> - -<hbox> -</pre> - <p>Maintenant, quand la boîte de dialogue est redimensionnée, les deux boutons resteront en place tout en bas de la boîte de dialogue. Le premier <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> ajoute un espacement entre le titre du libellé et les éléments des critères de recherche.</p> - <p>Il serait plus joli d'avoir une bordure autour des critères de recherche. Il y a deux moyens pour le faire. Vous pouvez utiliser la propriété CSS <code>border</code> ou vous pouvez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code>. La première méthode nécessite que nous appliquions le style sur la boîte elle-même. Nous utiliserons plutôt l'autre méthode. Un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> a l'avantage de dessiner une boîte avec un joli effet d'incrustation, en adéquation avec le thème courant.</p> - <p>Changeons maintenant la boîte <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> en <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> :</p> - <pre class="eval"><span class="highlightred"><groupbox orient="horizontal"></span> - <span class="highlightred"><span class="nowiki"><caption label="Critères de recherche"/></span></span> - <menulist id="searchtype"> - . - . - . - <spacer style="width: 10px;"/> - <textbox id="find-text" flex="1" style="min-width: 15em;"/> -<span class="highlightred"></groupbox></span> -</pre> - <p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxfinal.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxfinal.xul">Voir</a></p> - <p><img alt="Image:xultu_boxfinal2.png" class="internal" src="/@api/deki/files/1503/=Xultu_boxfinal2.png"></p> - <p>Il reste d'autres problèmes cosmétiques. Nous pourrions avoir un <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> qui s'étend verticalement vers le bas de la boîte. Mais aussi, nous pourrions modifier quelques marges afin de mieux positionner les éléments.</p> -</div> -<hr> -<p>Nous verrons dans la suite comment créer des piles.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_boîtes_de_groupe" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Piles_et_Paquets">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/arbres/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/arbres/index.html deleted file mode 100644 index e566557c9a..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/arbres/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Arbres -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Arbres -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Trees ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemple_de_glisser-déposer" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Autres_caractéristiques_des_arbres">Suivant »</a></p> -</div> -<p>XUL fournit un moyen de créer des listes tabulaires ou hiérarchiques en utilisant un arbre.</p> -<h3 id="L.27.C3.A9l.C3.A9ment_XULElemtree" name="L.27.C3.A9l.C3.A9ment_XULElemtree">L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code></h3> -<p>Un des éléments les plus complexes de XUL est l'arbre. Un arbre peut être utilisé pour afficher des lignes de texte en colonnes. Il peut servir pour des listes tabulaires ou arrangées hiérarchiquement. Un arbre permet également à l'utilisateur de réarranger, redimensionner et masquer individuellement certaines colonnes. Les messages dans une application courrier ou les marque-pages dans Mozilla sont des exemples d'utilisation d'arbres.</p> -<p>D'une certaine manière, un arbre a des similitudes avec une boîte de liste <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>. Tous deux peuvent être utilisés pour créer des tableaux de données avec des lignes et des colonnes multiples, et ils peuvent contenir des en-têtes de colonnes. Les arbres supportent également les lignes imbriquées, alors que les boîtes de liste ne le peuvent pas. Toutefois, les boîtes de liste peuvent contenir n'importe quel type de contenu, alors que les arbres ne peuvent contenir que du texte et des images (par le biais de fonctionnalités avancées, des barres de progression et cases à cocher peuvent également être mis dans un arbre).</p> -<p>Un arbre comporte deux parties : un ensemble de colonnes et le corps de l'arbre.</p> -<ul> <li>L'ensemble de colonnes est défini avec plusieurs éléments XUL <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code>, un pour chaque colonne. Chaque colonne apparaîtra comme un en-tête en haut de l'arbre.</li> <li>La seconde partie, le corps de l'arbre, contient les données apparaissant dans l'arbre. Il est créé grâce à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>.</li> -</ul> -<p>L'arbre est un élément XUL particulier dans le sens où son corps est constitué d'un seul composant graphique qui dessine toutes les données dans l'arbre. Cette définition contraste avec la boîte de liste où des balises individuelles <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code> sont utilisées pour spécifier chaque ligne dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>. Dans un arbre, toutes les données à afficher sont fournies par un objet séparé, appelé la vue d'arbre. Lorsqu'une cellule doit être affichée, le composant graphique de l'arbre fait appel à cet objet de vue d'arbre pour déterminer ce qui doit être affiché, et le dessine ensuite dans l'arbre. L'arbre est suffisamment intelligent pour ne solliciter les informations de la vue que pour les lignes qui ont besoin d'être affichées. Ainsi, l'affichage est optimisé par le chargement des données le nécessitant réellement. Par exemple, un arbre peut contenir des milliers de lignes, la plupart d'entre elles étant en dehors du cadre de l'arbre, cachées à la vue. Ainsi, l'arbre peut contenir un grand nombre de lignes sans rien perdre en performance. Bien entendu, ceci est indépendant de la performance de l'objet de vue lui-même.</p> -<p>L'objet vue d'arbre implémente l'interface <a href="/fr/NsITreeView" title="fr/NsITreeView">nsITreeView</a>. Cette interface contient trente propriétés et fonctions que vous pourrez implémenter. Ces fonctions seront appelées par l'arbre, au besoin, pour récupérer les données et les états de l'arbre. Par exemple, la fonction <code>getCellText()</code> sera appelée pour obtenir le libellé d'une cellule particulière dans l'arbre.</p> -<p>L'utilisation d'une vue a l'avantage de vous permettre de stocker vos données d'une façon plus adaptée à l'arbre, ou de charger les données sur demande seulement lorsque les lignes sont affichées. Elle offre une plus grande souplesse dans l'utilisation des arbres.</p> -<p>Naturellement, devoir implémenter une vue d'arbre avec une trentaine de propriétés et méthodes peut être très encombrant, surtout pour des arbres simples. Fort heureusement, XUL fournit un ensemble d'implémentations natives réalisant le gros du travail pour vous. Pour la plupart des arbres, surtout lorsque vous débutez, vous utiliserez un de ces types natifs. Cependant, vous pouvez créer également une vue d'arbre entièrement de A à Z. Dans ce cas, vous devrez stocker vos données dans un tableau ou une structure JavaScript, ou les charger à partir d'un fichier XML.</p> -<p>Comme le corps de l'arbre dans sa totalité est un unique élément graphique, vous ne pouvez pas modifier le style des lignes ou des cellules individuellement de manière classique. En fait, il n'existe pas d'éléments affichant des cellules individuelles comme il en existe avec les boîtes de liste. À la place, tout l'affichage est effectué par le corps de l'arbre grâce aux données fournies par la vue de l'arbre. Ce point important peut dérouter bien des développeurs XUL. Pour modifier l'apparence d'une cellule d'un arbre, la vue doit associer un jeu de mots clefs pour une ligne et une cellule. Une syntaxe CSS spéciale est employée entre les composants de styles du corps d'un arbre grâce à ces mots clefs. Dans un sens, le mécanisme est similaire aux classes CSS. L'application d'un style à un arbre sera détaillée dans <a href="/fr/Tutoriel_XUL/Styler_un_arbre" title="fr/Tutoriel_XUL/Styler_un_arbre">une section ultérieure</a>.</p> -<h3 id="Les_.C3.A9l.C3.A9ments_d.27arbre" name="Les_.C3.A9l.C3.A9ments_d.27arbre">Les éléments d'arbre</h3> -<p>Les arbres sont créés avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> qui sera décrit dans les prochaines sections. Il existe également deux éléments définissant l'affichage des colonnes dans l'arbre.</p> -<dl> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> </dt> <dd>L'élément entourant d'un arbre</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code> </dt> <dd>L'élément initialisant une série de <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code></dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> </dt> <dd>Cet élément déclare une colonne d'arbre. Avec l'utilisation de cet élément, vous pouvez spécifier des informations supplémentaires sur le tri des données en colonne ou encore la possibilité ou non pour l'utilisateur de redimensionner les colonnes. Vous devez toujours placer un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur une colonne, car Mozilla utilise cet identifiant pour les colonnes à réarranger ou à masquer. Il n'est plus nécessaire sous les versions 1.8 et suivantes de Mozilla, mais c'est une bonne habitude à conserver.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> </dt> <dd>Cet élément contient le corps principal de l'arbre, là où les lignes individuelles de données seront affichées</dd> -</dl> -<p>Voici un exemple d'arbre avec deux colonnes :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_trees_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_trees_1.xul">Voir</a></p> -<pre><tree flex="1"> - - <treecols> - <treecol id="nameColumn" label="Nom" flex="1"/> - <treecol id="addressColumn" label="Adresse" flex="2"/> - </treecols> - - <treechildren/> - -</tree> -</pre> -<p>Tout d'abord, l'ensemble du tableau est entouré avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. Il déclare un élément qui servira de tableau ou d'arbre. Comme avec les tables HTML, les données d'un arbre sont toujours organisées en lignes. Les colonnes sont spécifiées grâce à la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code>.</p> -<p>Vous pouvez mettre dans un arbre autant de colonnes que vous le souhaitez. Comme pour les boîtes de listes, une ligne d'en-tête apparaîtra avec les libellés des colonnes. Un menu déroulant apparaîtra dans le coin supérieur droit de l'arbre et permettra à l'utilisateur d'afficher ou de masquer les colonnes individuellement. Chaque colonne est créée avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code>. Vous pouvez définir le libellé d'en-tête en utilisant l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. Vous pouvez également rendre vos colonnes flexibles si votre arbre l'est aussi, ainsi les colonnes s'ajusteront en fonction de l'arbre. Dans cet exemple, la seconde colonne sera deux fois plus large que la première. Toutes les colonnes doivent être définies à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecols" title="treecols">treecols</a></code>.</p> -<p>Dans ce cas, nous n'avons pas indiqué à la vue les données de l'arbre, seuls les en-têtes de colonnes et un arbre vide seront visibles. Vous pouvez redimensionner la fenêtre, mais rien n'apparaîtra puisqu'il n'y a aucune donnée à afficher. Puisque la flexibilité de l'arbre a été spécifiée, son corps s'ajustera à l'espace disponible. La flexibilité d'un arbre est couramment appliquée, car les données de l'arbre sont souvent les informations les plus significatives affichées, donc il est logique que l'arbre puisse ajuster sa dimension. Toutefois, vous pouvez spécifier un nombre de lignes à afficher dans l'arbre en affectant l'attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. Notez que cet attribut indique le nombre de lignes qui seront affichées dans l'interface utilisateur et non le nombre de lignes de données. Le nombre total de lignes de données est fourni par la vue d'arbre. S'il y a trop de lignes de données à afficher dans l'arbre, une barre de défilement apparaîtra pour permettre à l'utilisateur de visualiser le reste. Si vous ne spécifiez aucun attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code>, la valeur par défaut sera '0' signifiant qu'aucune ligne ne s'affichera. Dans ce cas, vous devrez rendre votre arbre flexible. Si votre arbre est flexible, il n'a pas besoin d'un attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code> puisqu'il s'ajustera toujours à l'espace disponible.</p> -<h3 id="Le_contenu_de_la_vue_d.27arbre" name="Le_contenu_de_la_vue_d.27arbre">Le contenu de la vue d'arbre</h3> -<p>Nous avons vu que les données à afficher dans un arbre proviennent d'une vue et non de balises XUL, en passant par une construction interne de la vue d'arbre à partir des balises XUL. Ce mécanisme peut paraître légèrement confus. Retenez simplement que la construction des vues d'arbre emploie une série de balises servant à définir l'information sur les données dans l'arbre. Les éléments suivants sont utilisés :</p> -<dl> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> </dt> <dd>Il contient une unique ligne de niveau supérieur et tous ses descendants. Il sert également d'item pouvant être sélectionné par l'utilisateur. La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> entoure toute une ligne en permettant de la sélectionner entièrement.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code> </dt> <dd>Une seule ligne d'un arbre devant être placée à l'intérieur d'une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code>.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> </dt> <dd>Une seule cellule d'un arbre. Cet élément est placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code>.</dd> -</dl> -<p>Par convention, ces balises peuvent être placées directement à l'intérieur de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>, imbriquées dans l'ordre mentionné ci-dessus. Ces balises définissent les données à afficher dans le corps de l'arbre. Dans ce cas, l'arbre utilise la construction interne de la vue d'arbre, appelée le contenu de la vue d'arbre, qui utilise les libellés et les valeurs spécifiés sur ces éléments comme données pour l'arbre. Lorsque l'arbre a besoin d'afficher une ligne, il demande à la vue d'arbre le libellé de la cellule en appelant la fonction <code>getCellText()</code> de la vue qui, dans la continuité, obtient la donnée de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> correspondant.</p> -<p>Cependant, les trois éléments listés ci-dessus ne sont pas affichés directement. Ils ne sont utilisés que comme source de données pour la vue. Ainsi, seuls des attributs utiles sont appliqués sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et les éléments associés. Par exemple, vous ne pouvez pas modifier l'apparence des lignes d'un arbre en utilisant un attribut <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> ou d'autres propriétés CSS, et les fonctionnalités existantes pour les boîtes, telles que la flexibilité et l'orientation, ne peuvent pas être employées.</p> -<p>En fait, à part quelques attributs spécifiques aux arbres, les seuls qui auront un effet sont l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> pour définir un texte libellé d'une cellule et l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code> pour définir une image. Toutefois, dans les sections ultérieures, nous verrons des moyens spéciaux de modifier le style d'un arbre et d'appliquer d'autres fonctionnalités.</p> -<p>De même, les événements ne sont pas générés par un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et ses enfants ; en revanche, ils seront générés par l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>.</p> -<p>Le fait que les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> soient si différents des autres éléments XUL est une source classique de confusion pour les développeurs XUL. Essentiellement, le contenu de la vue d'arbre est une vue où les données des cellules sont fournies à partir des balises placées à l'intérieur de l'arbre. Naturellement, si vous utilisez un type différent de vue, les données seront fournies par une autre source, et il n'y aura aucun élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> du tout.</p> -<p>Commençons par regarder comment créer un arbre simple avec des colonnes multiples en utilisant la vue d'arbre de contenu. Il pourrait servir à créer une liste de messages mél (mails). Il y aura plusieurs colonnes, telles que l'expéditeur et le sujet.</p> -<h4 id="Exemple_avec_treechildren" name="Exemple_avec_treechildren">Exemple avec <code>treechildren</code></h4> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_trees_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_trees_2.xul">Voir</a></p> -<p><img alt="Image:xultu_trees1.png" class="internal" src="/@api/deki/files/1565/=Xultu_trees1.png"></p> -<pre><tree flex="1"> - - <treecols> - <treecol id="sender" label="Expéditeur" flex="1"/> - <treecol id="subject" label="Sujet" flex="2"/> - </treecols> - - <treechildren> - <treeitem> - <treerow> - <treecell label="joe@somewhere.com"/> - <treecell label="Plans Top secret"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="mel@whereever.com"/> - <treecell label="Invitation à déjeuner"/> - </treerow> - </treeitem> - </treechildren> - -</tree> -</pre> -<p>Comme vous pouvez le voir sur cette image, l'arbre a été créé avec deux lignes de données.</p> -<p>Cet arbre a deux colonnes dont la seconde occupe plus de place que la première. Vous rendrez généralement les colonnes flexibles. Vous pouvez également imposer les largeurs grâce à l'attribut <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code>. Vous devez inclure le même nombre d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> qu'il y a de colonnes dans l'arbre. Dans le cas contraire, des choses étranges pourraient se produire.</p> -<p>Les en-têtes sont créés automatiquement. Le bouton situé dans le coin supérieur droit sert à afficher ou à masquer les colonnes. Vous pouvez placer un attribut <code id="a-hidecolumnpicker"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidecolumnpicker">hidecolumnpicker</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> et le définir à 'true' si vous désirez masquer ce bouton. Si ce bouton est masqué, l'utilisateur ne sera pas en mesure de masquer des colonnes.</p> -<p>Assurez-vous d'avoir défini un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur chaque colonne, sinon les actions de masquage et d'affichage ne fonctionneront pas avec toutes les versions de Mozilla.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> entoure toutes les lignes. Les lignes individuelles à l'intérieur du corps peuvent contenir d'autres lignes. Pour l'arbre le plus simple, chaque ligne est créée avec les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code>. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code> entoure toutes les cellules d'une ligne, tandis que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> entoure une ligne et tous ses enfants. Les arbres avec des lignes imbriquées seront décrits dans la section suivante.</p> -<p>Dans les cellules, vous placerez les cellules individuelles. Elles sont créées avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code>. Vous pouvez définir un texte dans une cellule en utilisant l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. Le premier élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> d'une ligne détermine le contenu qui apparaîtra dans la première colonne, le deuxième élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> détermine le contenu qui apparaîtra dans la deuxième colonne, et ainsi de suite.</p> -<p>L'utilisateur peut sélectionner les items de l'arbre en cliquant sur eux avec la souris, ou en mettant en surbrillance avec le clavier. Il peut en sélectionner plusieurs en maintenant la touche <code>Maj</code> ou <code>Ctrl</code> appuyée et en cliquant sur d'autres lignes. Pour désactiver la sélection multiple, placez un attribut <code id="a-seltype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/seltype">seltype</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> avec la valeur 'single'. Ainsi, l'utilisateur ne pourra sélectionner qu'une seule ligne à la fois.</p> -<div class="highlight"> -<h3 id="Ajout_d.27un_arbre_sur_notre_exemple_de_recherche_de_fichiers" name="Ajout_d.27un_arbre_sur_notre_exemple_de_recherche_de_fichiers">Ajout d'un arbre sur notre exemple de recherche de fichiers</h3> -<p>Ajoutons un arbre à notre exemple de recherche de fichiers dans lequel les résultats de la recherche seront affichés. L'arbre utilisera une vue de contenu d'arbre. Le code suivant doit être ajouté à la place de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>.</p> -<p>Exemple : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-trees.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-trees.xul">Voir</a></p> -<pre class="eval"><span class="highlightred"><tree flex="1"><br> <treecols><br> <treecol id="name" label="Nom de fichier" flex="1"/><br> <treecol id="location" label="Emplacement" flex="2"/><br> <treecol id="size" label="Taille" flex="1"/><br> </treecols><br><br> <treechildren><br> <treeitem><br> <treerow><br> <treecell label="mozilla"/><br> <treecell label="/usr/local"/><br> <treecell label="2520 bytes"/><br> </treerow><br> </treeitem><br> </treechildren><br></tree></span> - -<splitter collapse="before" resizeafter="grow"/> -</pre> -<p>Nous avons ajouté un arbre avec les trois colonnes 'Nom de fichier', 'Emplacement' et 'Taille'. La deuxième colonne sera deux fois plus large grâce à une flexibilité plus grande. Une seule ligne a été ajoutée pour les besoins de la démonstration de l'apparence du tableau avec une ligne. Dans une implémentation réelle, les lignes seront ajoutées par un script à l'issue de la recherche, ou une vue personnalisée sera créée pour contenir les données.</p> -</div> -<hr> -<p>Nous verrons ensuite comment créer des arbres plus complexes.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemple_de_glisser-déposer" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Autres_caractéristiques_des_arbres">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/arbres_et_gabarits/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/arbres_et_gabarits/index.html deleted file mode 100644 index 34bbdd2a6c..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/arbres_et_gabarits/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Arbres et Gabarits -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Arbres_et_Gabarits -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Trees_and_Templates ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemples_de_syntaxe_de_gabarits" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Sources_de_données_RDF">Suivant »</a></p> -</div> -<p>Nous allons voir maintenant comment utiliser un gabarit avec un arbre.</p> -<h3 id="Ajout_de_sources_de_donn.C3.A9es_aux_arbres" name="Ajout_de_sources_de_donn.C3.A9es_aux_arbres">Ajout de sources de données aux arbres</h3> -<p>Avec un arbre, vous utiliserez souvent un gabarit pour construire son contenu, pour manipuler un grand volume de données hiérarchisées. L'utilisation d'un gabarit avec un arbre est très proche au niveau de la syntaxe aux autres éléments. Vous avez besoin d'ajouter un attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code> et <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> à la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>, ce qui spécifie la source des données et le nœud racine à afficher. De nombreuses règles peuvent être utilisées pour indiquer différents contenus pour différents types de données.</p> -<p>L'exemple suivant utilise l'historique comme source de données :</p> -<pre><tree datasources="rdf:history" ref="NC:HistoryByDate" - flags="dont-build-content"> -</pre> -<p>Comme il est décrit dans la section précédente, l'arbre peut utiliser un <em>constructeur</em> d'arbre pour la génération du gabarit à la place du constructeur normal de contenu. Les éléments ne seront pas créés pour chacune des lignes dans l'arbre, afin de le rendre plus performant. Lorsque l'attribut <code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code> a pour valeur 'dont-build-content', comme dans l'exemple ci-dessus, il indique que le constructeur de l'arbre doit être utilisé. Si l'attribut n'est pas renseigné, le constructeur de contenu sera utilisé. Vous pouvez voir la différences en utilisant l'inspecteur DOM de Mozilla sur un arbre avec, puis sans l'attribut.</p> -<p>Si vous utilisez le constructeur normal à la place, notez que le contenu ne sera pas construit avant qu'il soit nécessaire. Avec les arbres hiérarchiques, les enfants ne sont pas générés avant que le nœud parent ne soit ouvert par l'utilisateur.</p> -<p>Dans le gabarit, il n'y aura qu'une cellule <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> pour chaque colonne dans l'arbre. Les cellules devront avoir un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> afin de mettre un libellé à la cellule. Normalement, une propriété RDF se charge de récupérer le libellé à partir de la source de données.</p> -<h4 id="Exemple_d.27arbre_construit_par_un_gabarit" name="Exemple_d.27arbre_construit_par_un_gabarit">Exemple d'arbre construit par un gabarit</h4> -<p>L'exemple suivant montre un arbre construit à partir d'un gabarit, dans ce cas le système de fichier.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treetempl_1.xul.txt">Source</a></p> -<pre><tree id="my-tree" flex="1" - datasources="rdf:files" ref="file:///" flags="dont-build-content"> - <treecols> - <treecol id="Name" label="Nom" primary="true" flex="1"/> - <splitter/> - <treecol id="Date" label="Date" flex="1"/> - </treecols> - - <template> - <rule> - <treechildren> - <treeitem uri="rdf:*"> - <treerow> - <treecell label="rdf:http://home.netscape.com/NC-rdf#Name"/> - <treecell label="rdf:http://home.netscape.com/WEB-rdf#LastModifiedDate"/> - </treerow> - </treeitem> - </treechildren> - </rule> - </template> -</tree> -</pre> -<p>Ici, un arbre est créé avec deux colonnes, pour le nom et la date d'un fichier. L'arbre doit afficher une liste de fichiers situés dans le répertoire racine. Une seule règle est utilisée, mais vous pouvez en ajouter d'autres si vous en avez besoin. Comme avec les autres gabarits, l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> d'un élément indique où commencer pour générer du contenu. Les deux cellules puisent le nom et la date dans la source et place les valeurs dans le libellé de la cellule.</p> -<p>Cet exemple montre pourquoi l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> devient utile. Notez comment il a été placé dans le <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> dans l'exemple, même si ce n'est pas un descendant direct de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>. Nous avons besoin de mettre cet attribut seulement sur les éléments que nous voulons répéter pour chaque ressource. Comme nous ne voulons pas des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> multiples, l'attribut est placé ailleurs. Nous le mettons plutôt dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code>. En fait, les éléments à l'extérieur (ou au-dessus) de l'élément qui a l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> ne sont pas dupliqués tandis que les éléments avec l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> et les éléments à l'intérieur sont répétés pour chaque ressource.</p> -<div class="float-right"><img alt="Image:xultu_rdfoutl1.jpg" class=" internal" src="/@api/deki/files/1542/=Xultu_rdfoutl1.jpg"></div> -<p>Comme un constructeur d'arbre est utilisé et non un constructeur de contenu, la structure des éléments dans l'exemple ci-dessus doit être comme indiqué, avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> à l'intérieur de <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>. Bien que le constructeur d'arbres ne génère pas ces éléments, cette structure est nécessaire pour déterminer comment les générer correctement.</p> -<p>Notez dans l'image que des éléments fils additionnels ont été ajoutés automatiquement sous les éléments du niveau supérieur. XUL sait comment ajouter des éléments fils quand les modèles ou règles contiennent des éléments arbre ou menu. Il génère alors les éléments d'arbre imbriqués selon les données disponibles dans le RDF.</p> -<p>Une partie intéressante des sources de données RDF est que les valeurs sont déterminées seulement quand les données sont requises. Les valeurs qui sont plus profondes dans la hiérarchie de ressource ne sont pas déterminées jusqu'à ce que l'utilisateur atteigne ce nœud dans l'arbre. Ce mécanisme devient utile pour certaines sources où les données sont déterminées dynamiquement.</p> -<h3 id="Trier_les_colonnes" name="Trier_les_colonnes">Trier les colonnes</h3> -<p>Si vous essayez l'exemple précédent, vous pouvez noter que la liste de dossiers n'est pas triée. Les arbres qui produisent leurs données à partir d'une source ont la capacité facultative de trier leurs données. Vous pouvez trier de façon croissante ou décroissante sur n'importe quelle colonne. L'utilisateur peut changer la colonne de tri et la direction de tri en cliquant sur les en-têtes de colonne. Ce dispositif de tri n'est pas disponible pour des arbres dont le contenu est statique, bien que vous puissiez écrire un script pour trier ces données.</p> -<p>Le tri implique trois attributs, qui doivent être placés sur les colonnes. Le premier attribut, <code id="a-sort"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sort">sort</a></code>, doit être placé sur une propriété de RDF qui est employée alors comme critère de tri. Habituellement, c'est la même que celle utilisée pour le libellé de la cellule de cette colonne. Si vous le placez sur une colonne, les données seront triées dans cette colonne. L'utilisateur peut changer la direction de tri en cliquant sur l'en-tête de colonne. Si vous ne placez pas l'attribut <code id="a-sort"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sort">sort</a></code> sur une colonne, les données ne pourront pas être triées par cette colonne.</p> -<p>L'attribut <code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code> (notez la casse mixte) est utilisé pour définir la direction dans laquelle la colonne sera triée par défaut. Trois valeurs sont possibles :</p> -<dl> <dt>ascending </dt> <dd>les données sont affichées par ordre croissant.</dd> <dt>descending </dt> <dd>les données sont affichées par ordre décroissant.</dd> <dt>natural </dt> <dd>les données sont affichées dans le sens "naturel", c'est-à-dire l'ordre dans lequel elles sont apparaissent dans la source RDF.</dd> -</dl> -<p>Le dernier attribut, <code id="a-sortActive"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortActive">sortActive</a></code>, doit être défini à 'true' sur une seule colonne, celle qui sera triée par défaut.</p> -<p>Bien que le tri fonctionnera correctement avec seulement ces attributs, vous pouvez également utiliser la classe de style <code>sortDirectionIndicator</code> sur une colonne qui peut être triée. Un petit triangle apparaîtra dans l'en-tête de colonne et indiquera le sens du tri. Sans cela, l'utilisateur pourra toujours trier les colonnes mais il n'aura pas d'indication sur la colonne triée.</p> -<p>L'exemple suivant modifie les colonnes de l'exemple précédent pour inclure les fonctionnalités supplémentaires :</p> -<pre><treecols> - <treecol id="Name" label="Nom" flex="1" primary="true" - class="sortDirectionIndicator" sortActive="true" - sortDirection="ascending" - sort="rdf:http://home.netscape.com/NC-rdf#Name"/> - <splitter/> - <treecol id="Date" label="Date" flex="1" class="sortDirectionIndicator" - sort="rdf:http://home.netscape.com/WEB-rdf#LastModifiedDate"/> -</treecols> -</pre> -<h3 id="L.27.C3.A9tat_persistant_des_colonnes" name="L.27.C3.A9tat_persistant_des_colonnes">L'état persistant des colonnes</h3> -<p>Une chose supplémentaire que vous voudrez faire est de rendre persistant la colonne qui est actuellement triée, ainsi cet état est mémorisé entre chaque session. Pour ce faire, nous utilisons l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> sur chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code>. Il peut être utile de rendre persistant cinq attributs : la taille de la colonne, l'ordre des colonne, la visibilité de la colonne, quelle colonne est actuellement triée et dans quel ordre. L'exemple suivant montre une simple colonne :</p> -<pre><treecol id="Date" label="Date" flex="1" - class="sortDirectionIndicator" - persist="width ordinal hidden sortActive sortDirection" - sort="rdf:http://home.netscape.com/WEB-rdf#LastModifiedDate"/> -</pre> -<p>D'autres détails sur l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> seront décrits dans <a href="/fr/Tutoriel_XUL/Données_persistantes" title="fr/Tutoriel_XUL/Données_persistantes">une section ultérieure</a>.</p> -<h3 id="Attributs_suppl.C3.A9mentaires_pour_les_r.C3.A8gles" name="Attributs_suppl.C3.A9mentaires_pour_les_r.C3.A8gles">Attributs supplémentaires pour les règles</h3> -<p>Deux attributs supplémentaires peuvent être ajoutés sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>, lui permettant d'appliquer des correspondances dans certaines circonstances. Les deux sont des booléens.</p> -<dl> <dt><code id="a-iscontainer"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/iscontainer">iscontainer</a></code> </dt> <dd>Si cet attribut est mis à 'true', alors la règle s'appliquera sur toutes les ressources qui peuvent avoir des enfants. Par exemple, nous pouvons appliquer cette règle pour récupérer les dossiers des marque-pages. Il est utile car la source de données n'a pas besoin d'inclure un attribut spécial pour l'indiquer.</dd> <dt><code id="a-isempty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/isempty">isempty</a></code> </dt> <dd>Si cet attribut est mis à 'true', alors la règle s'appliquera sur toutes les ressources qui n'ont pas d'enfants.</dd> -</dl> -<p>Une ressource pourrait être un conteneur et être vide en même temps. Toutefois, c'est différent pour une ressource qui n'est pas un conteneur. Par exemple, un dossier de marque-pages est un conteneur mais il peut avoir ou ne pas avoir d'enfants. Cependant, un simple marque-page ou un séparateur n'est pas un conteneur.</p> -<p>Vous pouvez combiner ces deux éléments avec d'autres attributs de critères pour des règles plus spécifiques.</p> -<hr> -<p>Dans la section suivante, nous verrons quelques unes des sources de données fournies par Mozilla.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemples_de_syntaxe_de_gabarits" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Sources_de_données_RDF">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/assistant_avançé/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/assistant_avançé/index.html deleted file mode 100644 index 1c1073bd15..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/assistant_avançé/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Assistant avançé -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Assistant_avançé -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/More_Wizards ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Création_d'un_assistant" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Overlays">Suivant »</a></p> -</div> -<p>Cette section décrit quelques fonctionnalités supplémentaires sur les assistants.</p> -<h3 id="Une_navigation_plus_complexe" name="Une_navigation_plus_complexe">Une navigation plus complexe</h3> -<p>Normalement, un assistant affiche chaque page dans l'ordre où vous les placez dans le fichier XUL. Dans certains cas cependant, vous pouvez vouloir que les pages de l'assistant apparaissent en fonction des choix effectués par l'utilisateur sur les pages précédentes.</p> -<p>Dans ce cas, placez un attribut <code>pageid</code> sur chacune des pages. Un identifiant devra être placé sur chaque page. Ensuite, pour naviguer d'une page à l'autre, utilisez une des deux méthodes suivantes :</p> -<ol> <li>Affectez à l'attribut <code>next</code> de chaque page la valeur de l'identifiant de la page qui doit la suivre. Vous pouvez changer ces attributs comme vous le souhaitez pour naviguer vers d'autres pages.</li> <li>Appelez la méthode <code>goTo()</code> de l'assistant. Elle prend comme unique argument l'identifiant de la page suivante. Vous pouvez appeler cette méthode dans les gestionnaires <code>onpageadvanced</code> ou <code>onwizardnext</code>. Dans ce cas, n'oubliez pas de retourner la valeur 'false', car vous avez déjà changé la page par vous-même. Notez que la méthode <code>goTo()</code> charge une nouvelle page, par conséquent les événements liés sont lancés. Vous devez donc vous assurer d'avoir prévu ce cas.</li> -</ol> -<p>Par exemple, nous avons ici un ensemble de pages d'assistant (le contenu interne a été omis) :</p> -<pre><wizardpage pageid="type" next="font"> -<wizardpage pageid="font" next="done"> -<wizardpage pageid="color" next="done"> -<wizardpage pageid="done"> -</pre> -<ul> <li>L'assistant commence toujours à la première page, qui dans ce cas a l'identifiant de page 'type'. La page suivante ayant l'identifiant de page 'font', l'assistant affichera cette page juste après.</li> <li>Sur la page qui a l'identifiant 'font', nous voyons que la page suivante est celle identifiée 'done', cette page sera alors affichée ensuite.</li> <li>La page identifiée 'done' n'a pas d'attribut <code>next</code>, elle sera donc la dernière page.</li> -</ul> -<p>Un script ajustera la valeur de l'attribut <code>next</code> dès qu'il sera nécessaire d'aller sur la page identifiée 'color'.</p> -<h3 id="Fonctions_d.27assistant" name="Fonctions_d.27assistant">Fonctions d'assistant</h3> -<p>L'assistant fonctionne presque comme <a href="/fr/Tutoriel_XUL/Onglets" title="fr/Tutoriel_XUL/Onglets">un panneau d'onglets</a>, sauf que les onglets ne sont pas affichés et que l'utilisateur navigue entre les pages en utilisant les boutons de bas de page. Comme toutes les pages font parties d'un même fichier, toutes les valeurs des champs sur toutes les pages sont conservées. Par conséquent, il est inutile de sauvegarder ou charger ces informations entre les pages.</p> -<p>Cependant, vous pourriez vouloir faire quelques validations sur chaque champ de chaque page. Pour ce faire, utilisez les gestionnaires décrits dans la section précédente. Si un champ est invalide, vous pouvez afficher un message d'alerte. Dans certains cas, il serait plus judicieux de désactiver le bouton 'Suivant' jusqu'à ce qu'une valeur valide soit saisie.</p> -<p>L'assistant possède une propriété <code>canAdvance</code> qui, quand elle est mise a 'true', indique que le bouton 'Suivant' doit être actif. Si elle a la valeur 'false', le bouton 'Suivant' est désactivé. Vous pouvez changer cette propriété en fonction de la validité des données saisies.</p> -<p>Dans l'exemple suivant, l'utilisateur doit entrer un code secret dans le champ de saisie sur la première page de l'assistant. La fonction <code>checkCode()</code> est appelée dés que la première page est affichée comme indiqué par l'attribut <code>onpageshow</code>. Elle est aussi appelée dès qu'une touche est pressée dans le champ <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, pour déterminer si le bouton 'Suivant' doit être à nouveau actif.</p> -<h4 id="Exemple_d.27assistant" name="Exemple_d.27assistant">Exemple d'assistant</h4> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advwiz_1.xul.txt">Source</a></p> -<pre><?xml version="1.0"?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<wizard id="theWizard" title="Code secret de l'assistant" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<script> -function checkCode(){ - document.getElementById('theWizard').canAdvance = (document.getElementById('secretCode').value == "cabbage"); -} -</script> - - <wizardpage onpageshow="checkCode(); return true;"> - <label value="Saisir le code secret:"/> - <textbox id="secretCode" onkeyup="checkCode();"/> - </wizardpage> - - <wizardpage> - <label value="Le code est correct."/> - </wizardpage> - -</wizard> -</pre> -<p>Il existe aussi une propriété correspondante <code>canRewind</code> que vous pouvez utiliser pour activer ou désactiver le bouton 'Précédent'. Les deux propriétés sont ajustées automatiquement dès que vous changez de page. Par conséquent, le bouton 'Précédent' sera désactivé sur la première page, vous n'avez pas à le faire.</p> -<p>Une autre propriété utile de l'assistant est <code>currentPage</code> qui donne une référence à la page <code>wizardpage</code> actuellement affichée. Vous pouvez aussi changer la page courante en modifiant cette propriété. Si vous modifiez sa valeur, les différents événements de changement de page seront invoqués.</p> -<hr> -<p>Ensuite, nous allons voir comment utiliser les overlays pour gérer du contenu.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Création_d'un_assistant" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Overlays">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/autres_caractéristiques_des_arbres/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/autres_caractéristiques_des_arbres/index.html deleted file mode 100644 index 5852dbcfd7..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/autres_caractéristiques_des_arbres/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Autres caractéristiques des arbres -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Autres_caractéristiques_des_arbres -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/More_Tree_Features ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Sélection_dans_les_arbres">Suivant »</a></p> -</div> -<p>Nous allons voir ici des caractéristiques supplémentaires sur les arbres.</p> -<h3 id="Arbres_hi.C3.A9rarchiques" name="Arbres_hi.C3.A9rarchiques">Arbres hiérarchiques</h3> -<p>L'élement <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> est aussi utilisé pour créer des listes hiérarchiques, comme on en trouve dans un gestionnaire de fichiers ou dans les listes de marque-pages d'un navigateur. La vue d'arbre a plusieurs fonctions qui spécifient la hiérarchie des éléments dans un arbre. Chaque élément dans l'arbre possède un niveau commençant à 0. Les éléments les plus élevés dans l'arbre auront un niveau à 0, Les fils de ces éléments auront un niveau à 1, les fils en dessous auront un niveau à 2, et ainsi de suite. L'arbre demandera l'affichage pour le niveau de chaque élément afin de déterminer comment dessiner les rangées.</p> -<p>L'arbre dessinera les flèches d'ouverture et de fermeture pour ouvrir et fermer un élément parent ainsi que les lignes reliant les fils à leurs parents. L'arbre se chargera aussi de dessiner les rangées avec le niveau correct d'indentation. Cependant, la vue devra s'assurer de conserver l'état des niveaux de chaque ligne si nécessaire. Ce travail peut parfois être un peu délicat, mais heureusement, le module natif de vue d'arbre réalise tout le travail difficile pour nous.</p> -<p>Pour créer un ensemble de rangées imbriquées, tout ce que nous devons faire est d'ajouter un second <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> élément à l'intérieur du parent <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code>. Vous pouvez ensuite ajouter des éléments à l'intérieur pour spécifier les rangées filles d'un élément. Ne mettez pas d'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> à l'intérieur de <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code> car ceci ne marchera pas.</p> -<p>Vous pouvez répéter ce processus pour créer les arbres profondément imbriqués. Essentiellement, un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> peut contenir soit une simple ligne déclarée avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code>, soit un ensemble de lignes déclarées avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>.</p> -<p>Il y a deux autres choses à faire pour vous assurer que la hiérarchie fonctionne correctement. Premièrement, vous devez marquer l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> possédant des fils comme conteneur. Il vous suffit d'ajouter l'attribut <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> comme ceci :</p> -<pre><treeitem container="true"/></pre> -<p>Cet attribut permet à l'utilisateur de double-cliquer sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> pour déplier ou replier les lignes intérieures. Vous pouvez faire que les lignes filles soient initialement affichées en ajoutant l'attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code>. Quand l'utilisateur déplie ou replie le parent, la fonction <code>toggleOpenState</code> de la vue est appelée pour basculer l'item de l'état ouvert vers l'état fermé. Pour une vue d'arbre de type contenu, il sera ajouté un attribut <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> pour refleter l'état courant.</p> -<p>Le second changement vous impose de mettre l'attribut <code id="a-primary"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/primary">primary</a></code> sur la première colonne. Il fait apparaître un petit triangle ou un signe + devant les cellules dans cette colonne pour indiquer les cellules pouvant être dépliées. De plus, les lignes filles sont indentées. Notez aussi que l'utilisateur ne peut pas cacher cette colonne via le petit menu déroulant à droite des colonnes.</p> -<h4 id="Exemple_d.27arbre_hi.C3.A9rarchique" name="Exemple_d.27arbre_hi.C3.A9rarchique">Exemple d'arbre hiérarchique</h4> -<p>Voici un exemple simple :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advtrees_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advtrees_1.xul">Voir</a></p> -<div class="float-right"><img alt="Image:xultu_advtrees1.png" class=" internal" src="/@api/deki/files/1494/=Xultu_advtrees1.png"></div> -<pre><tree rows="6"> - <treecols> - <treecol id="firstname" label="Prénoms" primary="true" flex="3"/> - <treecol id="lastname" label="Noms" flex="7"/> - </treecols> - - <treechildren> - <treeitem container="true" open="true"> - <treerow> - <treecell label="Personnes"/> - </treerow> - - <treechildren> - <treeitem> - <treerow> - <treecell label="Bob"/> - <treecell label="Carpenter"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="Jerry"/> - <treecell label="Hodge"/> - </treerow> - </treeitem> - </treechildren> - </treeitem> - </treechildren> -</tree> -</pre> -<p>Cet exemple crée un arbre hiérarchique. Comme on peut le voir sur l'image, un petit signe plus ou moins (souvent appelé « twisty ») est apparu sur la première ligne, indiquant qu'elle contient des lignes filles. En double-cliquant sur la ligne, l'utilisateur ouvre ou ferme la liste. Les lignes filles sont indentées. Notez comment la ligne « Personnes » n'a besoin que d'une colonne.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> externe contient un seul élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code> et un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>. Le premier crée la donnée pour la ligne parente et le deuxième contient les items fils.</p> -<p>Vous pouvez imbriquer autant de lignes que vous le désirez. Souvenez-vous que vous devez utiliser l'attribut <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> sur les lignes qui ont des lignes filles. La simple présence de lignes filles n'est pas suffisante pour l'indiquer, car vous pourriez avoir un conteneur sans enfants mais qui devrait quand même être traité comme un conteneur. Par exemple, un répertoire sans fichier devrait être traité comme un conteneur alors qu'un fichier ne le devrait pas.</p> -<h3 id="Plus_sur_les_colonnes_d.27arbres" name="Plus_sur_les_colonnes_d.27arbres">Plus sur les colonnes d'arbres</h3> -<p><code id="a-enableColumnDrag"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/enableColumnDrag">enableColumnDrag</a></code> est un attribut supplémentaire que vous pouvez ajouter à l'arbre. S'il est mis à 'true', l'utilisateur peut alors déplacer les en-têtes de colonne afin de réarranger l'ordre des colonnes.</p> -<p>Un utilisateur peut également vouloir modifier la largeur des colonnes. Il vous suffit de placer un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/splitter" title="splitter">splitter</a></code> entre chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code>. Une petite encoche apparaissant entre chaque en-tête de colonne pourra être déplacée par l'utilisateur pour changer la largeur d'une colonne. Vous pouvez utiliser la classe de style 'tree-splitter' pour masquer l'encoche bien que la colonne puisse encore être retaillée.</p> -<p>Vous pouvez affecter une largeur minimale ou maximale à une colonne, en utilisant les attributs <code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code> et <code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code> sur les en-têtes de colonnes.</p> -<p>Vous pouvez mettre l'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> à 'true' pour cacher par défaut une colonne. L'utilisateur pourra afficher la colonne en la sélectionnant dans la liste déroulante au bout de la ligne des en-têtes de colonne.</p> -<h4 id="m.C3.A9morisation_de_l.27.C3.A9tat_des_colonnes" name="m.C3.A9morisation_de_l.27.C3.A9tat_des_colonnes">mémorisation de l'état des colonnes</h4> -<div class="float-right"><img alt="Image:xultu_advtrees2.png" class=" internal" src="/@api/deki/files/1495/=Xultu_advtrees2.png"></div> -<p>Comme avec tous les éléments XUL, l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> peut être utilisé pour sauvegarder l'état des colonnes entre chaque session. Ainsi, la façon dont l'utilisateur aura choisi l'affichage des colonnes sera automatiquement sauvegardé pour sa prochaine session. Vous pouvez sauvegarder plusieurs attributs, comme indiqué dans l'exemple ci-dessous :</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advtrees_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advtrees_2.xul">Voir</a></p> -<pre><tree enableColumnDrag="true" flex="1"> - <treecols> - <treecol id="runner" label="Coureur" flex="2" persist="width ordinal hidden"/> - <splitter class="tree-splitter"/> - <treecol id="city" label="Ville" flex="2" persist="width ordinal hidden"/> - <splitter class="tree-splitter"/> - <treecol id="starttime" label="Heure de départ" flex="1" persist="width ordinal hidden"/> - <splitter class="tree-splitter"/> - <treecol id="endtime" label="Heure d'arrivée" flex="1" persist="width ordinal hidden"/> - </treecols> - - <treechildren> - <treeitem> - <treerow> - <treecell label="Joshua Granville"/> - <treecell label="Vancouver"/> - <treecell label="7:06:00"/> - <treecell label="9:10:26"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="Robert Valhalla"/> - <treecell label="Seattle"/> - <treecell label="7:08:00"/> - <treecell label="9:15:51"/> - </treerow> - </treeitem> - </treechildren> -</tree> -</pre> -<p>Trois attributs des colonnes doivent être persistants,</p> -<ul> <li>l'attribut <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> pour sauver les largeurs de colonnes,</li> <li>l'attribut <code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code> contenant la position de la colonne,</li> <li>et l'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> indiquant si la colonne est visible ou invisible.</li> -</ul> -<hr> -<p>Dans la prochaine section, nous allons voir comment récupérer ou spécifier une sélection sur un arbre.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Sélection_dans_les_arbres">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_défilement/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_défilement/index.html deleted file mode 100644 index 16ab8ccae4..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_défilement/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Barres de défilement -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Barres_de_défilement -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Scroll_Bars ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Séparateurs" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Barre_d'outils">Suivant »</a></p> -</div> -<p>Maintenant, voyons comment ajouter des barres de défilement à une fenêtre.</p> -<h3 id="Ajout_de_barres_de_d.C3.A9filement" name="Ajout_de_barres_de_d.C3.A9filement">Ajout de barres de défilement</h3> -<p>Une barre de défilement est typiquement employée pour permettre à un utilisateur de parcourir un grand document. Vous pouvez aussi l'utiliser quand vous avez besoin de demander une valeur comprise entre un certain intervalle. Les barres de défilement peuvent être créées de différentes manières. Sous XUL, l'une d'entre elle nécessite l'emploi de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/scrollbar" title="scrollbar">scrollbar</a></code>. Certains éléments, comme des champs de saisie, vont également ajouter des barres de défilement si nécessaire lorsque leur contenu devient trop grand.</p> -<p>Dans cette section, nous verrons la création d'une barre de défilement seule. L'utilisateur choisira une valeur en déplaçant la barre de défilement. Vous n'utiliserez probablement pas très souvent cette méthode. Une barre de défilement est constituée de plusieurs partie, l'ascenseur, qui est la partie centrale de la barre, et les deux flèches boutons à chaque extrémités. Une barre de défilement crée tous ces éléments automatiquement.</p> -<p><img alt="Image:xultu_scroll1.jpg" class=" internal" src="/@api/deki/files/1543/=Xultu_scroll1.jpg"></p> -<p>La syntaxe d'une barre de défilement est la suivante :</p> -<pre><scrollbar - id="identifier" - orient="horizontal" - curpos="20" - maxpos="100" - increment="1" - pageincrement="10"/> -</pre> -<p>Les attributs sont les suivants :</p> -<dl> <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> <dd>L'identifiant unique de la barre de défilement.</dd> <dt><code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> </dt> <dd>Il spécifie l'orientation de la barre de défilement. Sa valeur par défaut 'horizontal' crée une barre qui s'étend de gauche vers la droite. Vous pouvez également spécifier 'vertical' qui crée une barre s'étendant du haut vers le bas.</dd> <dt><code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code> </dt> <dd>Il indique la position actuelle de l'ascenseur (le rectangle que vous pouvez déplacer). La valeur s'étend de '0' à la valeur de <code id="a-maxpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxpos">maxpos</a></code>. Cette valeur n'a pas besoin d'unité. La valeur par défaut est de '0'.</dd> <dt><code id="a-maxpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxpos">maxpos</a></code> </dt> <dd>Il indique la valeur de la position maximale de l'ascenseur. Il s'agit d'une valeur numérique qui n'a pas d'unité. La valeur par défaut est de '100'.</dd> <dt><code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code> </dt> <dd>Ici, le nombre spécifie de combien la valeur de <code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code> doit être changée quand l'utilisateur clique sur une des flèches de la barre de défilement. La valeur par défaut est de '1'.</dd> <dt><code id="a-pageincrement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pageincrement">pageincrement</a></code> </dt> <dd>Ici, le nombre spécifie de combien la valeur de <code id="a-curpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/curpos">curpos</a></code> doit être changée quand l'utilisateur clique sur la page à travers la barre de défilement, c'est à dire dans la zone entre l'ascenseur et les flèches. La valeur par défaut est de '10'.</dd> -</dl> -<p>L'exemple donné ci-dessus crée une barre de défilement qui s'étend des valeurs de '0' à '100'. La valeur de '100' peut être considérée comme le nombre de ligne d'une liste, mais elle peut représenter n'importe quoi d'autre. La valeur initiale de cet exemple est de '20'. Quand l'une des flèches de la barre de défilement est cliquée, la valeur incrémente ou décrémente de '1'. En cliquant à travers la barre de défilement, la valeur change de '10'.</p> -<p>Lorsque l'utilisateur clique sur l'une des flèches de la barre de défilement, l'ascenseur se déplace d'autant qu'indiqué par la valeur <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code>. Augmenter la valeur de cet attribut fera que la barre défilera plus vite à chaque clic. Les positions la plus à gauche et la plus élevée de l'ascenseur ont une valeur de '0', et celles la plus à droite et la plus basse ont une valeur donnée par <code id="a-maxpos"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxpos">maxpos</a></code>.</p> -<p>En ajustant les valeurs de la barre de défilement, vous pouvez positionner et contrôler le déplacement de l'ascenseur comme vous le souhaitez.</p> -<hr> -<p>Ensuite, nous verrons comment créer des barres d'outils.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Séparateurs" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Barre_d'outils">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_menus_simples/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_menus_simples/index.html deleted file mode 100644 index 31800f91cb..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/barres_de_menus_simples/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: Barres de menus simples -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Barres_de_menus_simples -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Simple_Menu_Bars ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Barre_d'outils" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_de_fonctionnalités_de_menu">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons voir comment créer une barre de menu avec des menus dessus.</p> - -<h3 id="Cr.C3.A9er_un_menu" name="Cr.C3.A9er_un_menu">Créer un menu</h3> - -<p>XUL dispose de plusieurs façons différentes de créer des menus. Le moyen le plus basique est d'ajouter une barre de menu avec une ligne de menus dessus comme sur de nombreuses applications. Vous pouvez aussi créer des menus surgissants. Les fonctionnalités de menu XUL se composent de différents éléments qui vous permettent de créer des barres de menus ou des menus surgissants. Les items des menus peuvent être personnalisés assez facilement. Nous avons déjà vu <a href="/fr/Tutoriel_XUL/Les_contrôles_de_listes#Zones_de_listes_d.C3.A9roulantes" title="fr/Tutoriel_XUL/Les_contrôles_de_listes#Zones_de_listes_d.C3.A9roulantes">en partie comment faire des menus</a> en utilisant <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>. Cette section sera construite là-dessus.</p> - -<p>Les barres de menu sont généralement créées de la même façon que les barres d'outils. La barre de menu peut-être placée dans une <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbox" title="toolbox">toolbox</a></code> et le menu fonctionne juste comme n'importe quel autre barre d'outils. XUL a quelques éléments spéciaux qui fournissent des fonctionnalités spéciales propres aux menus.</p> - -<p>Il y a cinq éléments associés à la création d'une barre de menu et de ses menus, qui sont expliqués brièvement ici et en détail après :</p> - -<dl> - <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code> </dt> - <dd>Le container de la ligne de menu.</dd> - <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> </dt> - <dd>En dépit du nom, il s'agit en fait seulement du titre du menu sur la barre de menu. Cet élément peut être placé sur une barre de menu ou séparément.</dd> - <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> </dt> - <dd>La boîte déroulante qui apparaît quand vous cliquez sur le titre du menu. Cette boîte contient la liste des commandes de menu.</dd> - <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> </dt> - <dd>Une commande individuelle sur un menu. Il est placé dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>.</dd> - <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> </dt> - <dd>Une barre de séparation sur un menu. Il est placé dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>.</dd> -</dl> - -<div class="note"> -<p>Vous pouvez personnaliser les menus sur la barre de menu comme vous le souhaitez pour toutes les plates-formes excepté pour le Macintosh. C'est parce que le Macintosh a son propre menu spécial en haut de l'écran contrôlé par le système. Bien que vous puissiez créer des menus personnalisés, toutes règles spéciales de style ou éléments non-menu que vous placez sur un menu peuvent ne pas être appliqués. Vous devez garder cette notion à l'esprit quand vous créez des menus.</p> -</div> - -<h4 id="Exemple_d.27une_simple_barre_de_menu" name="Exemple_d.27une_simple_barre_de_menu">Exemple d'une simple barre de menu</h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_menubar_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_menubar_1.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_menubar_1.png" class="internal" src="/@api/deki/files/1531/=Xultu_menubar_1.png"></div> - -<pre><toolbox flex="1"> - <menubar id="sample-menubar"> - <menu id="file-menu" label="Fichier"> - <menupopup id="file-popup"> - <menuitem label="Nouveau"/> - <menuitem label="Ouvrir"/> - <menuitem label="Enregistrer"/> - <menuseparator/> - <menuitem label="Quitter"/> - </menupopup> - </menu> - <menu id="edit-menu" label="Edition"> - <menupopup id="edit-popup"> - <menuitem label="Annuler"/> - <menuitem label="Refaire"/> - </menupopup> - </menu> - </menubar> -</toolbox> -</pre> - -<p>Ici, une simple barre de menu est créée en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>. Il va créer une ligne pour y placer des menus. Deux menus, Fichier et Edition ont été créés ici. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> crée le titre en haut du menu, qui apparaît sur la barre de menu. Les menus déroulants sont créés en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Le menu va s'ouvrir quand l'utilisateur cliquera sur le titre du menu parent. La taille du menu sera suffisamment large pour que les commandes tiennent à l'intérieur. Les commandes elles-mêmes sont créées en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. Chacune d'elles représente une unique commande dans le menu déroulant.</p> - -<p>Vous pouvez aussi créer des séparateurs sur les menus en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code>. Il est utilisé pour séparer des groupes d'items de menu.</p> - -<h4 id=".C3.89l.C3.A9ment_menubar" name=".C3.89l.C3.A9ment_menubar">Élément <code>menubar</code></h4> - -<p>La barre de menu est une boîte contenant des menus. Notez qu'elle a été placée dans une <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbox" title="toolbox">toolbox</a></code> flexible. La barre de menu n'a pas d'attributs spéciaux mais c'est un type de boîte. De ce fait, vous pouvez créer une barre de menu verticale en affectant la valeur 'vertical' à l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>.</p> - -<h4 id=".C3.89l.C3.A9ment_menu" name=".C3.89l.C3.A9ment_menu">Élément <code>menu</code></h4> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> fonctionne comme l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Il accepte certains attributs semblables plus quelques autres :</p> - -<dl> - <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> - <dd>L'identifiant unique du bouton de titre du menu.</dd> - <dt><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> </dt> - <dd>Le texte qui apparaît sur le menu, comme Fichier ou Edition.</dd> - <dt><code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> </dt> - <dd>Cet attribut booléen détermine si le menu est désactivé. Bien que ce soit permis, il est rarement utile de désactiver un menu entier. Cet attribut peut être mis à 'true' (vrai) ou 'false' (faux). Bien sûr, cette dernière valeur est celle par défaut.</dd> - <dt><code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> </dt> - <dd>Il s'agit de la touche que l'utilisateur peut presser pour activer le menu. Cette lettre est habituellement soulignée dans le titre du menu. Mozilla va regarder dans l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et ajouter un caractère <em>soulignement</em> au caractère spécifié ici. Pour cette raison, vous devez spécifier un caractère qui existe dans le texte (bien que la touche fonctionnera toujours si ce n'est pas le cas).</dd> -</dl> - -<div class="float-right"><img alt="Image:xultu_menubar_2.png" class="internal" src="/@api/deki/files/1532/=Xultu_menubar_2.png"></div> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> est normalement placé sur une barre de menu, bien que ce ne soit pas nécessaire. Cependant, il donnera une autre apparence. L'image montre à quoi l'exemple précédent ressemblerait sans la barre de menu.</p> - -<h4 id=".C3.89l.C3.A9ment_menupopup" name=".C3.89l.C3.A9ment_menupopup">Élément <code>menupopup</code></h4> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> crée la fenêtre déroulante contenant les commandes de menu. C'est un type de boîte qui est orienté verticalement par défaut. Vous pouvez passer en orientation horizontale si vous le voulez, les <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>s seront alors placés sur une même ligne. Normalement seuls les <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>s et les <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code>s sont placés dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Vous pouvez placer n'importe quel élément dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, cependant ils seront ignorés sur un Macintosh.</p> - -<h4 id=".C3.89l.C3.A9ment_menuitem" name=".C3.89l.C3.A9ment_menuitem">Élément <code>menuitem</code></h4> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> est comme l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> et comporte quelques attributs semblables.</p> - -<dl> - <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> - <dd>L'identifiant unique du bouton du menu.</dd> - <dt><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> </dt> - <dd>Le texte qui apparaît sur l'item de menu, comme Ouvrir ou Enregistrer.</dd> - <dt><code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> </dt> - <dd>Cet attribut booléen détermine si l'item de menu est désactivé. Cet attribut peut être mis à 'true' (vrai) ou 'false' (faux), qui est la valeur par défaut.</dd> - <dt><code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> </dt> - <dd>Il s'agit de la touche que l'utilisateur peut presser pour activer l'item de menu. Cette lettre est habituellement soulignée dans le libellé de l'item de menu. Mozilla va regarder dans l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et ajouter un caractère <em>soulignement</em> au caractère spécifié ici. Pour cette raison, vous devez spécifier un caractère qui existe dans le texte.</dd> - <dt><code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> </dt> - <dd>Cet attribut spécifie le texte de la touche de raccourci qui apparaît près du texte de la commande de menu. Cependant, il n'associe pas de touche d'action avec l'item de menu. Nous verrons comment faire cela plus tard.</dd> -</dl> - -<h4 id=".C3.89l.C3.A9ment_menuseparator" name=".C3.89l.C3.A9ment_menuseparator">Élément <code>menuseparator</code></h4> - -<p>Le <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> n'a pas d'attribut spécial. Il crée juste une barre horizontale entre les items de menu.</p> - -<hr> -<p>Nous allons maintenant voir quelques autres fonctions de menu.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Barre_d'outils" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_de_fonctionnalités_de_menu">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/boîte_de_dialogue_de_fichier/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/boîte_de_dialogue_de_fichier/index.html deleted file mode 100644 index 8e22677407..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/boîte_de_dialogue_de_fichier/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: Boîte de dialogue de fichier -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Boîte_de_dialogue_de_fichier -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Open_and_Save_Dialogs ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Créer_des_boîtes_de_dialogue" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Création_d'un_assistant">Suivant »</a></p> -</div> - -<p>Un type commun de boîtes de dialogue est celui avec lequel un utilisateur peut sélectionner un fichier à ouvrir où à enregistrer.</p> - -<h3 id="S.C3.A9lecteurs_de_fichiers" name="S.C3.A9lecteurs_de_fichiers">Sélecteurs de fichiers</h3> - -<p>Un sélecteur de fichiers est une boîte dialogue qui permet à l'utilisateur de sélectionner un fichier. Il est fréquemment utilisé pour les commandes de menu « Ouvrir... » ou « Enregistrer sous... », mais vous pouvez l'utiliser dès que l'utilisateur a besoin de sélectionner un fichier. L'appel à l'interface <a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a> <code><a href="/fr/NsIFilePicker" title="fr/NsIFilePicker">nsIFilePicker</a></code> est nécessaire pour implémenter un sélecteur de fichiers.</p> - -<div class="note">Notez que le sélecteur de fichiers ne fonctionne qu'avec des URLs chrome.</div> - -<p>Vous pouvez utiliser le sélecteur de fichiers dans l'un de ces trois modes :</p> - -<ul> - <li><code>Open</code> : Il est demandé à l'utilisateur de sélectionner un fichier à ouvrir.</li> - <li><code>GetFolder</code> : Il est demandé à l'utilisateur de sélectionner un répertoire/dossier.</li> - <li><code>Save</code> : Il est demandé à l'utilisateur de sélectionner le nom sous lequel sera sauvegardé le fichier.</li> -</ul> - -<p>L'apparence de la boîte de dialogue sera différente pour chaque type et variera selon la plateforme. Une fois que l'utilisateur aura sélectionné le fichier ou le répertoire/dossier, celui-ci pourra être lu ou enregistré.</p> - -<p>L'interface du sélecteur de fichiers <code><a href="/fr/NsIFilePicker" title="fr/NsIFilePicker">nsIFilePicker</a></code> est responsable de l'affichage de la boîte de dialogue dans l'un des trois modes. Vous pouvez définir plusieurs fonctionnalités de la boîte de dialogue en utilisant cette interface. Une fois que la boîte de dialogue est fermée, vous pouvez utiliser les fonctions de l'interface pour obtenir le fichier qui a été sélectionné.</p> - -<h4 id="Cr.C3.A9ation_d.27un_s.C3.A9lecteur_de_fichier" name="Cr.C3.A9ation_d.27un_s.C3.A9lecteur_de_fichier">Création d'un sélecteur de fichier</h4> - -<p>Pour commencer, vous devez créer un composant du sélecteur de fichiers et l'initialiser.</p> - -<pre>var nsIFilePicker = Components.interfaces.nsIFilePicker; -var fp = Components.classes["@mozilla.org/filepicker;1"].createInstance(nsIFilePicker); -fp.init(window, "Sélectionnez un fichier", nsIFilePicker.modeOpen); -</pre> - -<p>Tout d'abord, un nouvel objet sélecteur de fichiers est créé et stocké dans une variable <code>fp</code>. La fonction <code>init</code> est utilisée pour initialiser le sélecteur de fichiers. Cette fonction prend trois arguments : la fenêtre qui ouvre la boîte de dialogue, le titre de la boîte de dialogue et son mode. Ici, le mode est 'modeOpen' qui est utilisé pour une boîte de dialogue Ouvrir. Vous pouvez aussi utiliser 'modeGetFolder' et 'modeSave' pour les deux autres modes. Ces modes sont des constantes de l'interface <code>nsIFilePicker</code>.</p> - -<h4 id="R.C3.A9pertoire_par_d.C3.A9faut_et_filtres" name="R.C3.A9pertoire_par_d.C3.A9faut_et_filtres">Répertoire par défaut et filtres</h4> - -<p>Il y a deux fonctionnalités que vous pouvez définir pour la boîte de dialogue avant qu'elle ne soit affichée.</p> - -<ul> - <li>La première est le répertoire/dossier par défaut qui est affiché à l'ouverture de la boîte de dialogue.</li> - <li>La seconde est un filtre indiquant la liste des types de fichiers à afficher dans la boîte de dialogue. Elle pourrait être utilisée, par exemple, pour ne lister que les fichiers .html.</li> -</ul> - -<p>Vous pouvez définir le répertoire par défaut en renseignant la proprieté <code>displayDirectory</code> de l'objet du sélecteur de fichiers. Le répertoire doit être un objet <code><a href="/fr/NslLocalFile" title="fr/NslLocalFile">nslLocalFile</a></code>. Si vous ne le définissez pas, un répertoire par défaut sera sélectionné pour vous. Pour appliquer des filtres, appelez la fonction <code>appendFilters()</code> pour définir les types de fichiers que vous souhaitez voir s'afficher.</p> - -<pre>fp.appendFilters(nsIFilePicker.filterHTML | nsIFilePicker.filterImages); -fp.appendFilters(nsIFilePicker.filterText | nsIFilePicker.filterAll); -</pre> - -<ul> - <li>Le premier exemple ajoutera des filtres pour les fichiers HTML et les images. L'utilisateur ne pourra sélectionner que ces types de fichiers. La manière de procéder est spécifique à la plateforme. Sur quelques plateformes, chaque filtre sera séparé et l'utilisateur pourra choisir entre les fichiers HTML et les fichiers images.</li> - <li>Le second exemple ajoutera des filtres pour les fichiers textes et pour tous les fichiers. L'utilisateur a ainsi une option pour n'afficher que les fichiers textes ou tous les fichiers.</li> -</ul> - -<p>Vous pouvez aussi utiliser 'filterXML' et 'filterXUL' pour filtrer les fichiers XML et XUL. Si vous voulez filtrer des fichiers personnalisés, vous pouvez utiliser la fonction <code>appendFilter()</code> :</p> - -<pre>fp.appendFilter("Fichiers Audio","*.wav; *.mp3"); -</pre> - -<p>Cette ligne ajoutera un filtre pour les fichiers audio Wav et MP3. Le premier argument est le titre du type de fichier et le second est une liste de masques de fichiers séparés par un point virgule. Vous pouvez mettre autant de masques que vous le souhaitez. Vous pouvez appeler <code>appendFilter</code> autant de fois que nécessaire pour ajouter les filtres supplémentaires. L'ordre dans lequel vous les ajoutez détermine leur priorité. Habituellement, le premier ajouté est sélectionné par défaut.</p> - -<h4 id="Obtention_du_fichier_s.C3.A9lectionn.C3.A9" name="Obtention_du_fichier_s.C3.A9lectionn.C3.A9">Obtention du fichier sélectionné</h4> - -<p>Enfin, vous pouvez afficher la boîte de dialogue en appelant la fonction <code>show()</code>. Elle ne prend aucun argument mais retourne un code d'état qui indique ce que l'utilisateur a sélectionné. Notez que la fonction ne retourne aucune valeur tant que l'utilisateur n'a pas sélectionné un fichier. La fonction retourne une des trois constantes suivantes :</p> - -<dl> - <dt>'returnOK' </dt> - <dd> : l'utilisateur a sélectionné un fichier et a pressé le bouton « OK ». Le fichier que l'utilisateur a sélectionné sera stocké dans la propriété <code>file</code> du sélecteur de fichiers.</dd> - <dt>'returnCancel' </dt> - <dd> : l'utilisateur a pressé le bouton « Annuler ».</dd> - <dt>'returnReplace' </dt> - <dd> : dans le mode enregistrement, cette valeur de retour signifie que l'utilisateur a sélectionné un fichier à remplacer ('returnOK' sera retournée lorsque l'utilisateur aura rentré le nom d'un nouveau fichier).</dd> -</dl> - -<p>Vous devrez tester la valeur de retour et ensuite utiliser l'objet <code>file</code> du sélecteur de fichiers en utilisant la propriété <code>file</code>.</p> - -<pre>var res = fp.show(); -if (res == nsIFilePicker.returnOK){ - var thefile = fp.file; - // --- faire quelque chose avec le fichier ici --- -} -</pre> - -<hr> -<p>Par la suite, nous verrons comment créer un assistant.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Créer_des_boîtes_de_dialogue" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Création_d'un_assistant">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/broadcasters_et_observateurs/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/broadcasters_et_observateurs/index.html deleted file mode 100644 index dd1a8bbbae..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/broadcasters_et_observateurs/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Broadcasters et Observateurs -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Broadcasters_et_Observateurs -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Broadcasters_and_Observers ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Mise_à_jour_de_commandes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Document_Object_Model">Suivant »</a></p> -</div> -<p>Parfois, vous voulez que plusieurs éléments répondent à des événements ou changent d'état aisément. Pour cela, nous pouvons utiliser les « broadcasters » (diffuseurs).</p> -<h3 id="Commandes_de_transmission_d.27attributs" name="Commandes_de_transmission_d.27attributs">Commandes de transmission d'attributs</h3> -<p>Nous avons vu précédemment que les éléments tels que les boutons peuvent être ancrés à des commandes. De plus, si vous placez l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>, tous les éléments ancrés sur celui-ci seront eux aussi désactivés automatiquement. C'est une façon utile de diminuer la taille du code nécessaire. Cette technique fonctionne aussi pour les autres attributs. Par exemple, si vous placez un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>, chaque bouton attaché à la commande partagera ce libellé.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_1.xul">Voir</a></p> -<pre><command id="ma_commande" label="Ouvrir"/> - -<button command="ma_commande"/> -<checkbox label="Ouvrir une nouvelle fenêtre" command="ma_commande"/> -</pre> -<p>Dans cet exemple, le bouton n'a pas d'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>, néanmoins il est attaché à une commande qui en possède un. Le bouton va donc le partager avec la commande. La case à cocher a déjà un libellé, néanmoins, il va être surchargé par celui de la commande. Le résultat est que le bouton et la case à cocher auront le même libellé 'Ouvrir'.</p> -<p>Si vous modifiez l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> de la commande, les libellés du bouton et de la case à cocher changeront eux aussi. Nous avons vu une application similaire dans une section précédente où l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> était défini puis propagé aux autres éléments.</p> -<p>Cette transmission d'attribut est relativement utile pour plusieurs raisons. Par exemple, disons que nous voulons désactiver l'action « Page précédente » dans un navigateur. Nous aurions besoin de désactiver cette action dans le menu, dans la barre des tâches, le raccourci clavier (<code>Alt</code>+<code>Gauche</code> par ex.) et chaque commande « Page précédente » des menus déroulants. Écrire un script pour le faire n'est pas très simple. Le désavantage est de devoir prévoir tous les endroits où pourraient se trouver les boutons « Page précédente ». Si quelqu'un a ajouté un nouveau bouton « Page précédente » en utilisant une extension, il ne serait pas pris en compte. Il est plus pratique de désactiver simplement l'action « Page précédente » et que tous les éléments utilisant cette action se désactivent eux-mêmes. Nous pouvons utiliser la transmission d'attributs des commandes pour accomplir cela.</p> -<h3 id="Broadcasters" name="Broadcasters">Broadcasters</h3> -<p>Il y existe un élément similaire appelé <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code>. Les broadcasters supportent la transmission d'attributs de la même manière que les commandes. Ils fonctionnent de la même manière excepté le fait qu'une commande est utilisée pour les actions, alors qu'un broadcaster est utilisé pour contenir l'information d'un état. Par exemple, un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> serait utilisé pour une action comme « Page précédente », « Couper » ou « Supprimer ». Un <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code> serait utilisé pour contenir, par exemple, un drapeau indiquant si l'utilisateur est en ligne ou non. Dans le premier cas, les éléments du menu et de la barre des tâches nécessiteraient d'être désactivés lorsqu'il n'y a pas de page de retour, ou aucun texte à couper, à effacer. Dans le second cas, plusieurs éléments de l'interface auraient besoin d'être mis à jour lorsque l'utilisateur passerait du mode en ligne au mode hors ligne.</p> -<p>Le broadcaster le plus simple est défini ci-dessous. Vous devriez toujours utiliser un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> afin qu'il puisse être référencé à partir d'autres éléments.</p> -<pre><broadcasterset> - <broadcaster id="isOffline" label="Hors ligne"/> -</broadcasterset> -</pre> -<p>Tous les éléments qui « observent » le broadcaster seront modifiés automatiquement chaque fois que l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> du broadcaster change. Ces éléments auront comme résultat un nouveau libellé. Tout comme d'autres éléments non affichés, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcasterset" title="broadcasterset">broadcasterset</a></code> est un conteneur pour les broadcasters. Vous devez déclarer tous vos broadcasters dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcasterset" title="broadcasterset">broadcasterset</a></code> afin de les réunir.</p> -<h3 id="Cr.C3.A9ation_d.27.C3.A9l.C3.A9ments_observateurs" name="Cr.C3.A9ation_d.27.C3.A9l.C3.A9ments_observateurs">Création d'éléments observateurs</h3> -<p>Les éléments qui observent le broadcaster sont appelés observateurs car ils « observent » l'état du broadcaster. Pour qu'un élément devienne un observateur, ajoutez lui un attribut <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>. Il est analogue à l'attribut <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> utilisé pour attacher un élément à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>. Par exemple, pour qu'un bouton devienne un observateur du broadcaster décrit ci-dessus :</p> -<pre><button id="offline_button" observes="isOffline"/></pre> -<p>L'attribut <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code> a été placé sur le bouton et sa valeur a été affectée à la valeur de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du broadcaster à observer. Ici, le bouton va observer le broadcaster avec l'id 'isOffline' qui a été défini un peu plus haut dans le code. Si la valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> du broadcaster change, les observateurs mettront à jour leur valeur de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>.</p> -<p>Nous pourrions continuer avec d'autres éléments. Autant d'éléments que vous voulez peuvent observer le même broadcaster. Vous pouvez aussi n'avoir qu'un seul élément observateur, mais cela ne servirait pas à grand chose puisque la raison principale d'utiliser les broadcasters est d'avoir des attributs transmis à de multiples endroits. Vous ne devriez utiliser les broadcasters que lorsque vous avez besoin que plusieurs éléments aient à observer un attribut. D'autres observateurs sont décrits ci-dessous :</p> -<pre><broadcaster id="offline_command" label="Hors ligne" accesskey="f"/> - -<keyset> - <key id="goonline_key" observes="offline_command" modifiers="accel" key="O"/> -</keyset> -<menuitem id="offline_menuitem" observes="offline_command"/> -<toolbarbutton id="offline_toolbarbutton" observes="offline_command"/> -</pre> -<p>Dans cet exemple, <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et l'<code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> seront transmis par le broadcaster au raccourci clavier, à l'item de menu et au bouton de la barre d'outils. Le raccourci clavier n'utilisera aucun des attributs reçus, mais il sera désactivé lorsque le broadcaster le sera.</p> -<p>Vous pouvez utiliser un broadcaster pour observer n'importe quel attribut désiré. Les observateurs récupèreront les valeurs de chaque attribut, via les broadcasters, dès qu'ils changeront. Si jamais la valeur d'un seul attribut change, les observateurs seront avisés et ajusteront leurs propres attributs en conséquence. Les attributs des observateurs que le broadcaster ne possède pas lui-même ne sont pas modifiés. Les seuls attributs qui ne sont pas modifiés sont les attributs <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> et <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> ; ces attributs ne sont jamais partagés. Vous pouvez également utiliser vos propres attributs si vous le désirez.</p> -<p>Les broadcasters ne sont pas fréquemment utilisés, car les commandes peuvent en général convenir à la majorité des usages. Une chose à préciser est qu'il n'y a pas vraiment de différence entre l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> et l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code>. Ils font tous les deux la même chose. La différence est plutôt sémantique. Utilisez les commandes pour les actions et utilisez les broadcasters pour les états. En fait, chaque élément peut agir comme un broadcaster, tant que vous l'observez en utilisant l'attribut <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>.</p> -<h3 id="L.27.C3.A9l.C3.A9ment_Observes" name="L.27.C3.A9l.C3.A9ment_Observes">L'élément Observes</h3> -<p>Il existe un moyen de spécifier plus précisemment les attributs du broadcaster à observer. Cela implique un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code>. Tout comme son attribut l'indique, il vous permet d'indiquer à un élément qu'il est un observateur. L'élément <code>observes</code> doit être placé en tant qu'enfant de l'élément qui doit être l'observateur. Voici un exemple :</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_2.xul">Voir</a></p> -<pre><broadcasterset> - <broadcaster id="isOffline" label="Hors ligne" accesskey="f"/> -</broadcasterset> - -<button id="offline_button"> - <observes element="isOffline" attribute="label"/> -</button> -</pre> -<p>Deux attributs ont été ajoutés à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code>. Le premier, <code id="a-element"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/element">element</a></code>, spécifie l'identifiant du broadcaster à observer. Le second, <code id="a-attribute"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/attribute">attribute</a></code>, spécifie l'attribut à observer. Le résultat est que le bouton recevra son libellé du broadcaster, et quand l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sera modifié, le libellé du bouton sera changé. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code> ne change pas, contrairement à l'élément qui le contient, qui est dans ce cas un <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Notez que l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> n'est pas transmis au bouton, puisque il n'est pas observé. Si vous voulez que ce soit le cas, un autre élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code> devra être ajouté. Si vous n'utilisez aucun élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code>, et qu'à la place vous utilisez l'attribut <code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code> directement sur le bouton, tous les attributs seront observés.</p> -<h4 id=".C3.89v.C3.A9nement_broadcast" name=".C3.89v.C3.A9nement_broadcast">Événement broadcast</h4> -<p>Il existe un gestionnaire d'événements supplémentaire, <code id="a-onbroadcast"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onbroadcast">onbroadcast</a></code>, que nous pouvons placer sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code>. L'événement est appelé dès que l'observateur détecte un changement dans l'attribut du broadcaster qu'il observe. Un exemple est décrit ci-dessous :</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_broadob_3.xul">Voir</a></p> -<pre><broadcasterset> - <broadcaster id="colorChanger" style="color: black"/> -</broadcasterset> - -<button label="Test"> - <observes element="colorChanger" attribute="style" onbroadcast="alert('La couleur a changé');"/> -</button> - -<button label="Observer" - oncommand="document.getElementById('colorChanger').setAttribute('style','color: red');" -/> -</pre> -<p>Deux boutons ont été créés, un nommé 'Test' et l'autre 'Observateur'. Si vous cliquez sur le bouton « Test », rien ne se produit. En revanche, si vous cliquez sur le bouton « Observateur », deux choses surviennent. Premièrement, le texte du bouton devient rouge, deuxièmement, un message d'alerte apparaît avec le message 'La couleur a changé'.</p> -<p>Voilà ce qui se passe : le gestionnaire <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> du second bouton est appelé lorsque l'utilisateur appuie dessus. Le script dispose ici d'une référence au broadcaster et change le style de celui-ci afin qu'il ait une couleur (<code>color</code>) rouge. Le broadcaster n'est pas affecté par le changement de style car il n'est pas affiché à l'écran. Néanmoins, le premier bouton a un observateur qui tient compte du changement de style. Les attributs <code id="a-element"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/element">element</a></code> et <code id="a-attribute"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/attribute">attribute</a></code> sur la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/observes" title="observes">observes</a></code> détecte le changement de style. Le style est appliqué automatiquement au premier bouton.</p> -<p>Ensuite, puisque la transmission se fait, le gestionnaire d'événement <code id="a-onbroadcast"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onbroadcast">onbroadcast</a></code> est appelé. Il en résulte l'affichage d'un message d'alerte. Notez que la transmission ne se fait que si les attributs de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/broadcaster" title="broadcaster">broadcaster</a></code> sont modifiés. Changer le style du bouton directement ne déclenchera aucune diffusion d'événement et le message d'alerte ne s'affichera pas.</p> -<p>Si vous essayez de dupliquer le code du premier bouton (<code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>) plusieurs fois, vous verrez une série de messages d'alerte, un pour chaque bouton, car chaque bouton est un observateur et sera prévenu du changement de style.</p> -<hr> -<p>Nous verrons dans la section suivante l'utilisation du Modèle Objet de Document (<abbr title="Document Object Model">DOM</abbr>) avec les éléments XUL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Mise_à_jour_de_commandes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Document_Object_Model">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/cadres_de_contenu/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/cadres_de_contenu/index.html deleted file mode 100644 index d63d0e1d7c..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/cadres_de_contenu/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Cadres de contenu -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Cadres_de_contenu -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Content_Panels ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Grilles" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Séparateurs">Suivant »</a></p> -</div> - -<p>Dans cette section, nous regarderons comment ajouter des cadres qui peuvent afficher des pages HTML ou d'autres fichiers XUL.</p> - -<h3 id="Ajout_de_cadres_enfants" name="Ajout_de_cadres_enfants">Ajout de cadres enfants</h3> - -<p>Parfois, vous souhaitez qu'une partie d'un document soit chargée à partir d'une autre page. D'autres fois, vous voulez changer une partie de la fenêtre. Un bon exemple est un assistant qui vous guide pas-à-pas à travers un certain nombre d'écrans, en vous posant une série de questions. Chaque fois que l'utilisateur clique sur le bouton suivant, l'écran suivant de l'assistant est affiché.</p> - -<p>Vous pouvez créer une interface d'assistant en ouvrant une fenêtre différente pour chaque écran. Cette approche pose trois problèmes. Premièrement, chaque fenêtre peut apparaître à une position différente sur l'écran (bien qu'il existe une alternative à cela). Deuxièmement, les éléments tels que les boutons suivant ou précédent sont les mêmes tout au long de l'interface. Ce serait bien mieux si seul le contenu de l'assistant changeait. Troisièmement, il sera difficile de coordonner les scripts tournant dans les différentes fenêtres.</p> - -<div class="note">Notez que XUL a un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> qui peut être utilisé pour créer des assistants. Il sera décrit dans <a href="/fr/Tutoriel_XUL/Création_d'un_assistant" title="fr/Tutoriel_XUL/Création_d'un_assistant">une prochaine section</a>.</div> - -<p>Une meilleure approche est d'utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>, qui fonctionne comme l'élément HTML du même nom. Il crée un document séparé dans la fenêtre. Il a l'avantage de pouvoir être placé n'importe où et son contenu chargé à partir d'un fichier différent. Indiquez l'URL que vous souhaitez afficher dans le cadre avec l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code>. Cette URL peut pointer sur n'importe quelle sorte de fichiers, bien qu'elle pointe habituellement sur un fichier HTML ou un autre fichier XUL. Vous pouvez utiliser un script pour changer le contenu de ce cadre sans affecter la fenêtre principale.</p> - -<p>Dans la fenêtre du navigateur Mozilla, l'endroit où la page Web doit être affichée est créé en utilisant un cadre <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>. Lorsque l'utilisateur entre une URL ou clique sur un lien du document, la source du cadre est changée.</p> - -<h4 id="Exemple_iframe" name="Exemple_iframe">Exemple <code>iframe</code></h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_cpanels_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_cpanels_1.xul">Voir</a></p> - -<pre><toolbox> - <toolbar id="nav-toolbar"> - <toolbarbutton label="Précédent"/> - <toolbarbutton label="Suivant"/> - <textbox id="urlfield"/> - </toolbar> -</toolbox> - -<iframe id="content-body" src="http://www.mozilla-europe.org/fr/" flex="1"/> -</pre> - -<div class="float-right"><img alt="Image:xultu_cpanels1.png" class="internal" src="/@api/deki/files/1510/=Xultu_cpanels1.png"></div> - -<p>Ici, l'exemple crée une interface très simple pour un navigateur Web. Une boîte contenant deux éléments a été créée : un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbox" title="toolbox">toolbox</a></code> et un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>. Un bouton « Précédent », un bouton « Suivant » et un champ de saisie des URLs ont été ajoutés sur la barre d'outils. Les pages Web apparaissent à l'intérieur du cadre <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>. Dans ce cas, c'est la page d'accueil du site qui apparaîtra par défaut.</p> - -<p>Cet exemple n'est pas fonctionnellement complet. Par la suite, nous ajouterons un script qui changera l'attribut de <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code> au moment désiré, par exemple quand l'utilisateur appuie sur la touche <code>Entrée</code>.</p> - -<h3 id="Navigateurs" name="Navigateurs">Navigateurs</h3> - -<p>Il existe un second type de cadre de contenu, utilisant la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code>. Vous l'utiliserez quand vous voudrez créer un cadre qui montre le contenu comme un navigateur. En réalité, l'élément <code>iframe</code> peut aussi le faire, mais le navigateur (browser) possède certaines caractéristiques supplémentaires. Par exemple, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> conserve un historique pour utiliser les boutons « Précédent » et « Suivant ». Le navigateur peut aussi charger des pages avec des <code>referers</code> et d'autres états. La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> doit être utilisée essentiellement lorsque vous voulez créer une interface semblable au navigateur, mais l'<code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code> peut être utilisé lorsque vous avez juste besoin d'un cadre simple.</p> - -<p>Un élément similaire, <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code>, fournit la fonctionnalité du <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code>, mais fournit également une barre d'onglets pour basculer entre de multiples pages. C'est le composant graphique utilisé par le navigateur Mozilla pour son interface de navigation par onglets. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code> est en réalité implémenté comme un <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> contenant un ensemble d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code>. Ces deux types de navigateur offrent un contrôle similaire sur les pages à afficher.</p> - -<h4 id="Exemple_de_browser" name="Exemple_de_browser">Exemple de <code>browser</code></h4> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_cpanels_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_cpanels_2.xul">Voir</a>.</p> - -<pre><browser src="http://www.mozilla.org" flex="1"/></pre> - -<p>Comme avec l'<code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>, vous pouvez indiquer l'URL dans un navigateur utilisant l'attribut <code id="a-src"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/src">src</a></code>. Pour un <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code>, vous ne pouvez pas définir l'url directement comme ceci, étant donné qu'il n'affiche pas qu'une seule URL. À la place, vous devez utiliser un script et appeler la fonction <code>loadURI</code>.</p> - -<p>Il y a trois catégories de navigateurs, selon le genre de contenu que vous voulez afficher. Le type peut être indiqué en utilisant l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code>.</p> - -<p>Le premier type est le type par défaut utilisé si vous omettez cet attribut. Dans ce cas, le contenu chargé à l'intérieur du navigateur est traité comme s'il faisait partie de la même application et avait accès à la fenêtre extérieure. Cela signifie que lorsqu'un script chargé à l'intérieur du navigateur essaie d'obtenir la fenêtre la plus élevée, il obtiendra la fenêtre XUL extérieure.</p> - -<p>Ce comportement conviendrait pour un cadre XUL fils qui fait partie de votre application, mais il ne serait pas adapté pour un navigateur qui chargerait des pages Web. À la place, vous voudrez restreindre la page Web au seul accès de son contenu. Vous pouvez noter qu'une fenêtre de navigateur Mozilla possède du contenu XUL pour les barres d'outils et de statut et ainsi de suite avec un <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code> formant la zone principale. Cette zone interne affiche une page Web, mais celle-ci ne peut pas accéder au XUL l'entourant. C'est parce le second type de navigateur est utilisé en définissant l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> avec la valeur 'content'. Il empêche le contenu de remonter jusqu'à la fenêtre XUL. Un exemple :</p> - -<pre><browser src="http://www.mozilla.org" type="content" flex="1"/></pre> - -<div class="note">Il est important que vous définissiez l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> correctement si vous envisagez d'afficher des sites Web distants à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code>.</div> - -<p>Le <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code> définit le type 'content' automatiquement sur tous les onglets de navigation qu'il crée. Vous n'avez donc pas à le définir explicitement pour les onglets de navigation.</p> - -<p>Le troisième type sert lorsque votre fenêtre contient plusieurs éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code>, comme par exemple si vous aviez un panneau latéral affichant du contenu supplémentaire. Renseignez l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> principal avec la valeur 'content-primary' pour spécifier le contenu primaire. Il fonctionne comme avec la valeur 'content' excepté le fait que le contenu à l'intérieur est accessible en utilisant la propriété 'content' de la fenêtre XUL. L'accès au contenu du navigateur principal en utilisant un script s'en trouve simplifié. <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code> définit automatiquement l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> avec cette valeur 'content-primary' pour tous les navigateurs visibles, ce qui vous permet de cette manière de toujours pouvoir avoir accès au contenu visible.</p> - -<hr> -<p>Dans la section suivante, nous allons voir comment créer des séparateurs.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Grilles" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Séparateurs">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/caractéristiques_d'une_fenêtre/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/caractéristiques_d'une_fenêtre/index.html deleted file mode 100644 index 4f063b5790..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/caractéristiques_d'une_fenêtre/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Caractéristiques d'une fenêtre -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Caractéristiques_d'une_fenêtre -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Features_of_a_Window ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemple_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Créer_des_boîtes_de_dialogue">Suivant »</a></p> -</div> - -<p>Nous avons déjà vu quelques caractéristiques de fenêtres. Nous allons en aborder d'autres dans cette section.</p> - -<h3 id="Cr.C3.A9er_une_autre_fen.C3.AAtre" name="Cr.C3.A9er_une_autre_fen.C3.AAtre">Créer une autre fenêtre</h3> - -<p>Vous pouvez créer une seconde fenêtre pour votre application de la même manière que vous avez créé la première. Il suffit de créer un second fichier XUL contenant le code de la nouvelle fenêtre. Comme en HTML, vous pouvez utiliser la fonction <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">window.open()</a></code> pour ouvrir la seconde fenêtre. Cette fonction retournera une référence à la fenêtre nouvellement ouverte. Vous pouvez utiliser cette référence pour appeler des fonctions de l'autre fenêtre.</p> - -<p>La fonction <code>open</code> prend trois arguments. Le premier est l'URL du fichier que vous souhaitez ouvrir. Le deuxième est le nom interne de la fenêtre. Le troisième est une liste de drapeaux de paramètres d'affichage. Le drapeau <code>chrome</code> est important pour ouvrir la fenêtre comme un fichier <a href="/fr/DOM/window.open#Fonctionnalit.C3.A9s_de_barres_d.27outils_et_de_chrome" title="fr/DOM/window.open#Fonctionnalit.C3.A9s_de_barres_d.27outils_et_de_chrome">chrome</a>. Si vous n'ajoutez pas le drapeau <code>chrome</code>, le fichier sera ouvert dans une nouvelle fenêtre du navigateur.</p> - -<p>Par exemple :</p> - -<pre>var myWin = window.open("chrome://findfile/content/findfile.xul","findfile","chrome");</pre> - -<h3 id="Sp.C3.A9cifier_la_largeur_et_la_hauteur" name="Sp.C3.A9cifier_la_largeur_et_la_hauteur">Spécifier la largeur et la hauteur</h3> - -<p>Vous aurez noté que lorsque des éléments sont ajoutés à une fenêtre, la largeur de la fenêtre s'étend pour s'adapter aux nouveaux éléments. La fenêtre n'est en fait qu'une boîte flexible et qui prend par défaut une orientation verticale. Vous pouvez également spécifier la largeur et la hauteur directement dans la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Cela, bien sûr, oblige la fenêtre à prendre une taille spécifique. Si vous ôtez ces spécifications, la taille sera déterminée par les éléments qui la constituent.</p> - -<pre><window - id="findfile-window" - title="Recherche de fichiers" - width="400" - height="450" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> -</pre> - -<p>Dans cet exemple, la fenêtre sera ouverte avec une largeur de 400 pixels et une hauteur de 450 pixels. Même s'il n'y a pas assez d'éléments pour lui faire adopter cette taille, la fenêtre s'ouvrira toujours à cette taille et il y aura un espace vierge dans l'espace restant. S'il y a trop d'éléments, la fenêtre n'adaptera pas ses dimensions pour en tenir compte. L'utilisateur devra alors redimensionner la boîte de dialogue. Vous devez faire attention, lorsque vous spécifiez une largeur et une hauteur, à ce que la fenêtre ne soit ni trop petite, ni trop grande. Vous devez considérer les thèmes graphiques ou la langue propres à l'utilisateur.</p> - -<div class="note">Notez que vous devez spécifier à la fois la largeur <strong>et</strong> la hauteur. Si vous ne spécifiez qu'une des deux valeurs, l'autre sera mise à '0'. Pour que la fenêtre détermine sa taille automatiquement, omettez les toutes les deux.</div> - -<p>La largeur et la hauteur déterminent seulement la taille initiale de la fenêtre. L'utilisateur peut toujours redimensionner la fenêtre, à condition que celle-ci soit redimensionnable.</p> - -<h3 id="Autres_propri.C3.A9t.C3.A9s_de_fen.C3.AAtre" name="Autres_propri.C3.A9t.C3.A9s_de_fen.C3.AAtre">Autres propriétés de fenêtre</h3> - -<p>Les drapeaux ci-après peuvent être utilisés comme troisième argument de la fonction <code>window.open</code>. Votre système d'exploitation peut ne pas les supporter tous. Vous pouvez également utiliser un des drapeaux pré-existants, que vous devriez trouver dans une référence JavaScript. Vous pouvez désactiver une propriété en la réglant sur 'no', par exemple <code>dialog='no'</code>.</p> - -<dl> - <dt><code>alwaysLowered</code></dt> - <dd>La fenêtre apparaîtra toujours derrière les autres fenêtres.</dd> - <dt><code>alwaysRaised</code></dt> - <dd>La fenêtre apparaîtra toujours devant les autres fenêtres.</dd> - <dt><code>centerscreen</code></dt> - <dd>À son ouverture, la fenêtre sera centrée à l'écran.</dd> - <dt><code>dependent</code></dt> - <dd>La position de la fenêtre sera toujours relative à la fenêtre qui l'a ouverte. Si la position de la fenêtre initiale est modifiée, la seconde fenêtre bougera automatiquement de même manière.</dd> - <dt><code>dialog</code></dt> - <dd>la fenêtre est une boîte de dialogue pouvant apparaître différemment.</dd> - <dt><code>modal</code></dt> - <dd>La boite de dialogue est modale. La fenêtre qui a ouvert la fenêtre modale ne peut pas être utilisée tant que la fenêtre modale n'est pas fermée.</dd> - <dt><code>resizable</code></dt> - <dd>L'utilisateur peut redimensionner la fenêtre.</dd> -</dl> - -<p><small>Voir également <a href="/fr/DOM/window.open" title="fr/DOM/window.open">la référence DOM de window.open()</a>.</small></p> - -<hr> -<p>Nous allons voir ensuite comment ouvrir des boîtes de dialogue secondaires.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Exemple_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Créer_des_boîtes_de_dialogue">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/commandes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/commandes/index.html deleted file mode 100644 index baedcbfcdf..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/commandes/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Commandes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Commandes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Commands ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Focus_et_Selection" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Mise_à_jour_de_commandes">Suivant »</a></p> -</div> -<p>Une commande est une opération qui peut être invoquée.</p> -<h3 id="Les_.C3.A9l.C3.A9ments_de_commande" name="Les_.C3.A9l.C3.A9ments_de_commande">Les éléments de commande</h3> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> est utilisé pour créer des commandes qui pourront être utilisées pour exécuter des opérations. Vous n'avez pas besoin d'utiliser les commandes si vous avez juste à appeler un script pour manipuler des choses. Cependant, une commande a l'avantage de pouvoir être désactivée automatiquement quand c'est nécessaire, et de pouvoir être invoquée de l'extérieur sans avoir besoin de connaître les détails de son implémentation. Les commandes fournissent un moyen pour séparer de façon abstraite les opérations et le code. Elles deviennent très utiles pour les grosses applications.</p> -<p>Par exemple, pour implémenter les commandes de menus du presse-papiers, <em>couper</em>, <em>copier</em> et <em>coller</em>, vous pouvez utiliser les commandes. Si vous ne les utilisiez pas, vous devriez trouver quel champ a le focus, ensuite s'assurer que l'opération est valable pour cet élément. De plus, les commandes de menus devraient être activées ou désactivées selon que l'élément cible a du texte sélectionné ou pas, et pour les opérations de collage, si le presse-papiers contient quelque chose qui peut être collé. Comme vous pouvez le voir, cela devient compliqué. En utilisant les commandes, votre travail est simplifié.</p> -<p>Vous pouvez utiliser une commande pour n'importe quelle opération. Mozilla les utilise la plupart du temps pour les menus. De plus, les champs de saisie de texte et autres composants graphiques disposent de plusieurs commandes natives que vous pouvez invoquer. Vous devriez les utiliser quand les opérations dépendent de l'élément sélectionné.</p> -<p>Une commande est identifiée par son attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>. Mozilla utilise une convention : les id de commandes commencent par '<code>cmd_</code>'. Vous voudrez probablement utiliser le même identifiant que celui d'une commande déjà utilisée, cependant, pour vos propres commandes, vous pouvez utiliser n'importe quel id de commande souhaité. Pour éviter les conflits, il est préférable d'inclure le nom de l'application dans l'id de la commande. Un moyen simple d'utilisation des commandes est montré ci-après :</p> -<h4 id="Exemple.C2.A0_command_simple" name="Exemple.C2.A0:_command_simple">Exemple : <code>command</code> simple</h4> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_commands_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_commands_1.xul">Voir</a>.</p> -<pre><command id="cmd_openhelp" oncommand="alert('Aide !');"/> -<button label="Aide" command="cmd_openhelp"/> -</pre> -<p>Dans cet exemple, au lieu de placer l'attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, nous le plaçons sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>. Les deux sont alors liés en utilisant l'attribut <code id="a-command"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/command">command</a></code> qui a la valeur de l'id de la commande. Ainsi, quand le bouton est pressé, la commande '<code>cmd_openhelp</code>' est invoquée.</p> -<p>Cette approche présente deux avantages.</p> -<ul> <li>Premièrement, Elle déplace toutes les opérations dans des commandes qui peuvent être toutes regroupées dans une seule section de fichier XUL. Cela signifie que le code est au même endroit, n'est pas éparpillé dans tout le code de l'interface utilisateur.</li> <li>Le second avantage est que différents boutons et autres éléments de l'interface graphique peuvent être rattachés à une même commande. Par exemple, vous pouvez avoir un item de menu, un bouton d'une barre de boutons et un raccourci clavier pour effectuer la même opération. Plutôt que de répéter le code trois fois, vous pouvez rattacher ces trois éléments à la même commande. Normalement, vous rattacherez seulement les éléments pouvant générer un événement de commande.</li> -</ul> -<p>De plus,</p> -<ul> <li>si vous définissez l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> sur une commande, elle sera désactivée et ne pourra pas être invoquée.</li> <li>tous les boutons et les items de menus qui lui sont rattachés seront désactivés automatiquement.</li> <li>si vous réactivez la commande, les boutons deviendront de nouveau actifs.</li> -</ul> -<h4 id="Exemple.C2.A0_Activer.2FD.C3.A9sactiver_command" name="Exemple.C2.A0:_Activer.2FD.C3.A9sactiver_command">Exemple : Activer/Désactiver <code>command</code></h4> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_commands_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_commands_2.xul">Voir</a></p> -<pre><command id="cmd_openhelp" oncommand="alert('Aide');"/> -<button label="Aide" command="cmd_openhelp"/> -<button label="Plus d'aide" command="cmd_openhelp"/> - -<button label="Désactiver" oncommand="document.getElementById('cmd_openhelp').setAttribute('disabled','true');"/> -<button label="Activer" oncommand="document.getElementById('cmd_openhelp').removeAttribute('disabled');"/> -</pre> -<p>Dans cet exemple, les deux boutons utilisent la même commande. Quand le bouton « Désactiver » est pressé, la commande est désactivée en définissant son attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code>, et les deux boutons seront aussi désactivés.</p> -<p>Habituellement, un groupe de commandes se place à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/commandset" title="commandset">commandset</a></code>, près du début du fichier XUL, comme dans l'exemple suivant :</p> -<pre><commandset> - <command id="cmd_open" oncommand="alert('Ouvrir !');"/> - <command id="cmd_help" oncommand="alert('Aide !');"/> -</commandset> -</pre> -<p>Une commande est invoquée quand l'utilisateur active le bouton ou les autres éléments rattachés à la commande. Vous pouvez aussi invoquer une commande en appelant la méthode <code><span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand</a></code></span></code>, que ce soit de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> ou d'un élément rattaché à la commande, comme un bouton.</p> -<h3 id="Le_r.C3.A9partiteur_de_commandes" name="Le_r.C3.A9partiteur_de_commandes">Le répartiteur de commandes</h3> -<p>Vous pouvez aussi utiliser les commandes sans utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>, ou, au moins, sans ajouter un attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> sur la commande. Dans ce cas, la commande n'invoquera pas un script directement, mais recherchera plutôt un élément ou une fonction qui traitera la commande. Cette fonction peut être séparée du XUL lui-même, et peut être embarquée par un élément graphique en interne. Afin de trouver ce qui traitera la commande, XUL utilise un objet appelé répartiteur de commande (<abbr title="Note du traducteur">NdT</abbr> : command dispatcher). Cet objet localise le gestionnaire d'une commande. Le gestionnaire d'une commande est appelé contrôleur. Ainsi, quand une commande est invoquée, le répartiteur de commande localise un contrôleur qui traite la commande. Vous pouvez déduire que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/command" title="command">command</a></code> est un type de contrôleur pour une commande.</p> -<p>Le répartiteur de commandes localise un contrôleur en regardant l'élément sélectionné pour voir s'il a un contrôleur qui gère la commande. Les éléments XUL ont une propriété <code>controllers</code> qui est utilisée pour la vérification. Vous pouvez l'utiliser pour ajouter vos propres contrôleurs. Vous pourriez l'utiliser pour avoir une boîte de liste qui répond aux opérations de couper, copier et coller. Un exemple sera fourni plus tard. Par défaut, seuls les champs de saisie (<code>textbox</code>) ont un contrôleur fonctionnel. Ce contrôleur gère aussi bien les opérations de presse-papiers, sélection, défaire et refaire, que les opérations d'édition. Notez qu'un élément peut avoir plusieurs contrôleurs, qui seront alors tous pris en compte.</p> -<p>Si l'élément courant sélectionné n'a pas le contrôleur attendu, la fenêtre sera alors vérifiée. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> a aussi une propriété <code>controllers</code> que vous pouvez modifier comme bon vous semble. Si le focus est à l'intérieur d'un cadre frame, chaque cadre parent est également vérifié. Ainsi, les commandes fonctionneront même si le focus est à l'intérieur d'un cadre. Ce mécanisme fonctionne bien pour un navigateur ; les commandes d'édition invoquées à partir du menu principal fonctionneront à l'intérieur de la zone de contenu. Notez que HTML a aussi un système de commandes et de contrôleur, bien que vous ne puissiez pas l'utiliser sur des pages Web sans privilèges. Mais vous pouvez l'utiliser, par exemple, dans une extension du navigateur. Si la fenêtre ne fournit pas un contrôleur capable de gérer la commande, rien ne se passera.</p> -<p>Vous pouvez récupérer le répartiteur de commande en utilisant la propriété <code>commandDispatcher</code> de l'objet <code>document</code>, ou à partir des contrôleurs listés dans un élément ou la fenêtre. Le répartiteur de commande contient des méthodes pour récupérer les contrôleurs pour les commandes et pour récupérer et modifier le focus.</p> -<h4 id="Ajout_de_contr.C3.B4leurs" name="Ajout_de_contr.C3.B4leurs">Ajout de contrôleurs</h4> -<p>Vous pouvez implémenter vos propres contrôleurs pour répondre aux commandes. Vous pouvez tout aussi bien surcharger la gestion par défaut d'une commande en plaçant le contrôleur correctement. Un contrôleur doit implémenter quatre méthodes qui sont listées ci-dessous :</p> -<dl> <dt>supportsCommand (command) </dt> <dd>Cette méthode doit renvoyer 'true' si le contrôleur gère la commande. Si vous renvoyez 'false', la commande n'est pas gérée et le répartiteur de commande interrogera un autre contrôleur. Un contrôleur peut gérer plusieurs commandes.</dd> -</dl> -<dl> <dt>isCommandEnabled (command) </dt> <dd>Cette méthode doit renvoyer 'true' si la commande est activée, 'false' sinon. Les boutons correspondants seront désactivés automatiquement.</dd> -</dl> -<dl> <dt>doCommand (command) </dt> <dd>exécute la commande. C'est ici que vous mettrez le code pour gérer la commande.</dd> -</dl> -<dl> <dt>onEvent (event) </dt> <dd>Cette méthode gère un événement.</dd> -</dl> -<h4 id="Exemple.C2.A0_impl.C3.A9mentation_d.27un_contr.C3.B4leur" name="Exemple.C2.A0:_impl.C3.A9mentation_d.27un_contr.C3.B4leur">Exemple : implémentation d'un contrôleur</h4> -<p>Imaginons que nous voulions implémenter une boîte de liste (<code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>) qui gère la commande « Supprimer ». Quand un utilisateur sélectionne « Supprimer » dans le menu, la boîte de liste efface la ligne sélectionnée. Dans ce cas, vous avez juste à attacher un contrôleur à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> qui exécutera l'action correspondante dans sa méthode <code>doCommand</code>.</p> -<p>Essayez d'ouvrir l'exemple qui suit (<a href="https://developer.mozilla.org/samples/xultu/examples/commands.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/commands.xul">Voir</a>) dans une fenêtre du navigateur et sélectionnez des items de la liste. Vous noterez que la commande « Supprimer » du menu « Edition » du navigateur est activée et qu'elle effacera la ligne sélectionnée. L'exemple n'est cependant pas complet. Nous devrions nous assurer que la sélection et le focus soient ajustés comme il faut après l'effacement.</p> -<pre><window id="controller-example" title="Exemple de contrôleur" onload="init();" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<script> -function init() -{ - var list = document.getElementById("theList"); - - var listController = { - supportsCommand : function(cmd){ return (cmd == "cmd_delete"); }, - isCommandEnabled : function(cmd){ - if (cmd == "cmd_delete") return (list.selectedItem != null); - return false; - }, - doCommand : function(cmd){ - list.removeItemAt(list.selectedIndex); - }, - onEvent : function(evt){ } - }; - - list.controllers.appendController(listController); -} -</script> - -<listbox id="theList"> - <listitem label="Océan"/> - <listitem label="Désert"/> - <listitem label="Jungle"/> - <listitem label="Marécage"/> -</listbox> - -</window> -</pre> -<p>Le contrôleur <code>listController</code> implémente les quatre fonctions décrites plus haut. La méthode <code>supportsCommand</code> renvoie 'true' pour la commande 'cmd_delete', qui est le nom de la commande utilisée lorsque l'item de menu « Supprimer » est sélectionné. Pour les autres commandes, 'false' est renvoyé puisque le contrôleur ne gère aucune autre commande. Si vous voulez gérer d'autres commandes, vous devrez les tester ici, car il est fréquent d'un simple contrôleur gère de multiples commandes apparentées.</p> -<p>La méthode <code>isCommandEnabled</code> renvoie 'true' si la commande est activée. Dans le cas présent, nous vérifions s'il y a un item sélectionné dans la liste et renvoyons 'true' si c'est le cas. S'il n'y a pas de sélection, 'false' est renvoyé. Si vous effacez toutes les lignes dans l'exemple, la commande « Supprimer » deviendra inactive. Vous devrez cliquer sur la liste pour mettre à jour le menu dans cet exemple simple. La méthode <code>doCommand</code> sera appelée lorsque l'item de menu « Supprimer » sera sélectionné, et elle provoquera l'effacement de la ligne sélectionnée dans la liste. Rien ne doit se produire pour la méthode <code>onEvent</code>, aussi nous n'ajouterons pas de code pour celle-ci.</p> -<h4 id="Surcharger_un_contr.C3.B4leur_par_d.C3.A9faut" name="Surcharger_un_contr.C3.B4leur_par_d.C3.A9faut">Surcharger un contrôleur par défaut</h4> -<p>Nous attachons ce contrôleur à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> en appelant la méthode <code>appendController</code> des objets contrôleurs de la liste. L'objet <a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIControllers.html">controller</a> a un certain nombre de méthodes qui peuvent être utilisées pour manipuler les contrôleurs. Par exemple, il possède une méthode <code>insertControllersAt</code> qui insère un contrôleur dans un élément avant les autres. Elle peut être utile pour surcharger des commandes. Par exemple, le code suivant désactivera le collage du presse-papiers dans un champ de saisie.</p> -<pre>var tboxController = { - supportsCommand : function(cmd){ return (cmd == "cmd_paste"); }, - isCommandEnabled : function(cmd){ return false; }, - doCommand : function(cmd){ }, - onEvent : function(evt){ } -}; - -document.getElementById("tbox").controllers.insertControllerAt(0,tboxController); -</pre> -<p>Dans cet exemple, nous insérons le contrôleur à l'index '0', c'est-à-dire avant tous les autres. Le nouveau contrôleur supporte la commande 'cmd_paste' et indique qu'elle est désactivée. Le contrôleur par défaut de <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> ne sera jamais appelé parce que le répartiteur de commande trouve un contrôleur avant celui-ci, prenant en charge la commande en premier.</p> -<hr> -<p>Dans la section suivante, nous allons voir comment mettre à jour les commandes.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Focus_et_Selection" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Mise_à_jour_de_commandes">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/contenu_anonyme/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/contenu_anonyme/index.html deleted file mode 100644 index 92fc00f9e5..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/contenu_anonyme/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Contenu anonyme -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Contenu_anonyme -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Anonymous_Content ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Introduction_à_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Héritage_d'attributs_XBL">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons voir comment créer un contenu avec XBL (eXtended Binding Language).</p> - -<h3 id="Le_contenu_XBL" name="Le_contenu_XBL">Le contenu XBL</h3> - -<p>XBL peut être utilisé pour ajouter automatiquement un ensemble d'éléments à l'intérieur d'un autre élément. Le fichier XUL a uniquement besoin de spécifier l'élément externe tandis que l'élément interne est décrit dans un fichier XBL. C'est utile pour créer un élément graphique simple qui est construit à partir d'un ensemble d'autres éléments, mais qui peut être référencé comme un seul élément graphique. Des mécanismes sont fournis pour ajouter des attributs aux éléments internes qui étaient spécifiés dans l'élément externe.</p> - -<h4 id="Exemple_de_d.C3.A9claration_d.27une_barre_de_d.C3.A9filement" name="Exemple_de_d.C3.A9claration_d.27une_barre_de_d.C3.A9filement">Exemple de déclaration d'une barre de défilement</h4> - -<p>L'exemple ci-dessous montre comment une barre de défilement pourrait être déclarée (il a été un peu simplifié par rapport à la réalité) :</p> - -<pre><bindings xmlns="http://www.mozilla.org/xbl" - xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - <binding id="scrollbarBinding"> - <content> - <xul:scrollbarbutton type="decrement"/> - <xul:slider flex="1"> - <xul:thumb/> - </xul:slider> - <xul:scrollbarbutton type="increment"/> - </content> - </binding> -</bindings> -</pre> - -<p>Ce fichier contient une seule liaison, déclarée avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/binding" title="binding">binding</a></code>. L'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> doit être déclaré avec l'identifiant de la liaison. De cette façon il y est fait référence au travers de la propriété CSS <a href="/fr/docs/Web/CSS/-moz-binding" title="La propriété -moz-binding, utilisée par les applications Mozilla, permet d'attacher une liaison (binding) XBL à un élément DOM."><code>-moz-binding</code></a>.</p> - -<p>La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> est utilisée pour déclarer le contenu anonyme qui sera ajouté à la barre de défilement. Tous les éléments à l'intérieur de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> seront ajoutés au sein de l'élément auquel la liaison est liée. Cette liaison sera vraisemblablement liée à une barre de défilement, bien qu'elle puisse ne pas l'être. Chaque élément dont la propriété CSS <a href="/fr/docs/Web/CSS/-moz-binding" title="La propriété -moz-binding, utilisée par les applications Mozilla, permet d'attacher une liaison (binding) XBL à un élément DOM."><code>-moz-binding</code></a> est déclarée avec l'URL de la liaison, va l'utiliser.</p> - -<p>L'utilisation de la liaison ci-dessus a pour résultat que la ligne de XUL ci-dessous soit interprétée comme suit, en supposant que la barre de défilement est liée au XBL ci-dessus :</p> - -<pre class="eval"><scrollbar> - -<strong>devient :</strong> - -<scrollbar> - <xul:scrollbarbutton type="decrement"/> - <xul:slider flex="1"> - <xul:thumb/> - </xul:slider> - <xul:scrollbarbutton type="increment"/> -</scrollbar> -</pre> - -<p>Les éléments au sein de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> sont ajoutés anonymement à la barre de défilement. Bien que le contenu anonyme soit affiché à l'écran, vous ne pouvez pas y accéder à l'aide d'un script par la voie normale. Dans XUL, c'est comme s'il n'y avait qu'un seul élément, bien qu'il se compose en réalité de plusieurs éléments.</p> - -<p>Si vous observez une barre de défilement dans une fenêtre Mozilla, vous verrez qu'elle est composée d'un bouton en forme de flèche, d'une zone de coulissement, d'une poignée à l'intérieur et d'un second bouton en forme de flèche à la fin, ce sont les éléments qui apparaissent dans le contenu XBL ci-dessus. Ces éléments pourraient à leur tour être liés à d'autres liaisons qui utilisent les éléments XUL de base. Notez que les éléments de contenu ont besoin de l'espace de nommage de XUL (ils apparaissent précédés de <code>xul:</code>), parce que ce sont des éléments de XUL et qu'ils ne sont pas valides dans XBL. Cet espace de nommage a été déclaré dans la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code>. Si vous n'utilisez pas l'espace de nommage sur les éléments de XUL, Mozilla supposera que ce sont des éléments XBL et il ne les comprendra pas, et vos éléments ne fonctionneront pas correctement.</p> - -<h4 id="Exemple_d.27un_champ_de_saisie_de_nom_de_fichier" name="Exemple_d.27un_champ_de_saisie_de_nom_de_fichier">Exemple d'un champ de saisie de nom de fichier</h4> - -<p>Un autre exemple, cette fois pour un champ dans lequel vous pourriez entrer un nom de fichier :</p> - -<pre><binding id="fileentry"> - <content> - <textbox/> - <button label="Parcourir..."/> - </content> -</binding> -</pre> - -<p>L'attachement de cette liaison sur un élément lui fera contenir un champ de saisie de texte, suivi d'un bouton 'Parcourir...'. Ce contenu interne est créé anonymement et ne peut être vu en utilisant le DOM (Modèle Objet de Document).</p> - -<h3 id="Remplacement_de_l.27.C3.A9l.C3.A9ment_de_liaison" name="Remplacement_de_l.27.C3.A9l.C3.A9ment_de_liaison">Remplacement de l'élément de liaison</h3> - -<p>Le contenu anonyme est créé automatiquement chaque fois qu'une liaison est attachée à un élément. Si vous placez des éléments fils à l'intérieur du contenu XUL, ils vont écraser les éléments fournis par la liaison. Par exemple, prenez cet extrait XUL, en supposant qu'il soit lié à la barre de défilement XBL de tout à l'heure :</p> - -<pre><scrollbar/> - -<scrollbar> - <button label="Écraser"/> -</scrollbar> -</pre> - -<p>Puisque la première barre de défilement n'a pas de contenu qui lui est propre, celui-ci sera généré à partir de la définition de la liaison du fichier XBL. La seconde barre de défilement a son propre contenu donc elle l'utilisera à la place du contenu XBL, ce qui a pour résultat quelque chose qui ne ressemble plus à une barre de défilement. Notez que beaucoup d'éléments natifs de construction, comme les barres de défilement, ont leur définition XBL stockée dans des fichiers situés dans le répertoire "bindings" du paquetage toolkit.jar.</p> - -<p>Ce mécanisme s'applique seulement aux éléments définis à l'intérieur de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code>. Les propriétés, les méthodes et d'autres aspects d'XBL restent disponibles, que le contenu provienne d'XBL ou que XUL fournisse son propre contenu.</p> - -<h3 id="Utilisation_de_l.27.C3.A9l.C3.A9ment_children" name="Utilisation_de_l.27.C3.A9l.C3.A9ment_children">Utilisation de l'élément <code>children</code></h3> - -<p>Il peut y avoir des fois où vous souhaitez que soient montrés à la fois le contenu XBL et celui fournit par le fichier XUL. Il vous suffit d'utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. Les éléments fils dans XUL sont ajoutés en lieu et place de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. C'est pratique pour créer des éléments graphiques de menu personnalisés. Par exemple, une version simplifiée d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> éditable, pourrait être créée comme ceci :</p> - -<pre class="eval"><strong>XUL:</strong> - -<menu class="dropbox"> - <menupopup> - <menuitem label="1000"/> - <menuitem label="2000"/> - </menupopup> -</menu> - -<strong>CSS:</strong> - -menu.dropbox { - -moz-binding: url('<a class="external" rel="freelink">chrome://example/skin/example.xml#dropbox'</a>); -} - -<strong>XBL:</strong> - -<binding id="dropbox"> - <content> - <children/> - <xul:textbox flex="1"/> - <xul:button src="<a class="external" rel="freelink">chrome://global/skin/images/dropbox.jpg</a>"/> - </content> -</binding> -</pre> - -<p>Cet exemple crée un champ de saisie suivi d'un bouton. Le <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> sera ajouté au contenu à l'emplacement spécifié par l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. Notez que pour les fonctions du DOM, le contenu apparaîtra comme s'il était dans le fichier XUL, ainsi le menupopup sera un fils du menu. Le contenu XBL est caché ainsi le développeur d'une application sous XUL n'a même pas besoin de savoir qu'il est là.</p> - -<p>Le contenu résultant serait :</p> - -<pre><menu class="dropbox"> - <menupopup> - <menuitem label="1000"/> - <menuitem label="2000"/> - </menupopup> - <textbox flex="1"/> - <button src="chrome://global/skin/images/dropbox.jpg"/> -</menu> -</pre> - -<h4 id="Attribut_XULAttrincludes" name="Attribut_XULAttrincludes">Attribut <code id="a-includes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/includes">includes</a></code></h4> - -<p>Dans certains cas, vous souhaiterez n'inclure que des types de contenus spécifiques et non d'autres. Ou bien, vous souhaiterez placer différents types de contenus à différents endroits. L'attribut <code>includes</code> peut être utilisé pour n'autoriser que certains éléments à apparaître dans le contenu. Sa valeur doit être déclarée pour un simple nom de balise, ou pour une liste de balises séparées par des barres verticales (Le symbole <code>|</code>).</p> - -<pre><children includes="button"></pre> - -<p>Cette ligne va ajouter tous les boutons qui sont fils de l'élément lié en lieu et place de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. Les autres éléments ne correspondront pas avec cette balise. Vous pouvez placer plusieurs éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code> dans une liaison pour placer différents types de contenus à différents endroits. Si un élément dans XUL ne correspond pas aux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>, cet élément (et les autres n'y correspondant pas) sera utilisé à la place du contenu lié.</p> - -<p>Voici un autre exemple. Disons que nous voulions créer un élément graphique qui affiche une image avec un bouton de zoom "Agrandir" et un bouton de zoom "Réduire" de part et d'autre. Il pourrait être créé avec une boîte qui contiendrait l'image et deux boutons. L'élément image doit être placé à l'extérieur du fichier XBL car il sera différent selon l'usage.</p> - -<pre class="eval"><strong>XUL:</strong> - -<box class="zoombox"> - <image src="images/happy.jpg"/> - <image src="images/angry.jpg"/> -</box> - -<strong>XBL:</strong> - -<binding id="zoombox"> - <content> - <xul:box flex="1"> - <xul:button label="Agrandir"/> - <xul:box flex="1" style="border: 1px solid black"> - <children includes="image"/> - </xul:box> - <xul:button label="Réduire"/> - </xul:box> - </content> -</binding> -</pre> - -<p>Les fils explicites dans le fichier XUL seront placés à l'endroit où se trouve la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. Il y a deux images, ainsi toutes les deux seront ajoutées à côté de l'une et l'autre. Cela a pour conséquence un affichage équivalent au code suivant :</p> - -<pre><binding id="zoombox"> - <content> - <xul:box flex="1"> - <xul:button label="Agrandir"/> - <xul:box flex="1" style="border: 1px solid black"> - <image src="images/happy.jpg"/> - <image src="images/angry.jpg"/> - </xul:box> - <xul:button label="Réduire"/> - </xul:box> - </content> -</binding> -</pre> - -<p>D'un point de vue du DOM, les éléments fils sont toujours à leur emplacement original. En effet, la boîte XUL externe a deux fils qui sont les deux images. La boîte interne avec la bordure a un fils, la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>. C'est une distinction importante lorsqu'on utilise le DOM avec XBL. Elle s'applique également aux règles du sélecteur CSS.</p> - -<h3 id="Les_.C3.A9l.C3.A9ments_fils_multiples" name="Les_.C3.A9l.C3.A9ments_fils_multiples">Les éléments fils multiples</h3> - -<p>Vous pouvez également utiliser plusieurs éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code> et avoir certains éléments placés à un endroit et d'autres éléments placés à un autre. En ajoutant l'attribut <code id="a-includes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/includes">includes</a></code> contenant une liste de nom de balises séparés par des barres verticales, vous pouvez placer uniquement les éléments correspondants à cet endroit. Par exemple, le fichier XBL suivant va faire apparaître des libellés et des boutons à un endroit différent des autres éléments :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblcontent_1.xml.txt">Source</a></p> - -<pre><binding id="navbox"> - <content> - <xul:vbox> - <xul:label value="Libellés et boutons"/> - <children includes="label|button"/> - </xul:vbox> - <xul:vbox> - <xul:label value="Autres éléments"/> - <children/> - </xul:vbox> - </content> -</binding> -</pre> - -<p>Le premier élément <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code> n'inclut que les éléments <code>label</code> et <code>button</code>, comme indiqué dans son attribut <code>includes</code>. Le second élément <code><a href="/fr/docs/Mozilla/Tech/XUL/children" title="children">children</a></code>, parce qu'il n'a pas d'attribut <code>includes</code>, ajoute tous les éléments restants.</p> - -<hr> -<p>Dans la prochaine section, nous verrons comment des attributs peuvent être hérités dans le contenu anonyme.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Introduction_à_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Héritage_d'attributs_XBL">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_assistant/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_assistant/index.html deleted file mode 100644 index 8ca985799e..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_assistant/index.html +++ /dev/null @@ -1,141 +0,0 @@ ---- -title: Création d'un assistant -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Création_d'un_assistant -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Creating_a_Wizard ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Boîte_de_dialogue_de_fichier" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Assistant_avançé">Suivant »</a></p> -</div> - -<p>Beaucoup d'applications utilisent des assistants pour aider l'utilisateur dans des tâches complexes. XUL fournit un moyen de créer des assistants facilement.</p> - -<h3 id="L.27.C3.A9l.C3.A9ment_XULElemwizard" name="L.27.C3.A9l.C3.A9ment_XULElemwizard">L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code></h3> - -<p>Un assistant est un type spécial de boîte de dialogue, contenant un certain nombre de pages. Des boutons de navigation apparaissent en bas de la boîte de dialogue pour passer d'une page à l'autre. Les assistants sont habituellement utilisés pour aider l'utilisateur à effectuer des tâches complexes. Chaque page contient une seule question ou un ensemble de questions associées. À la dernière page, l'opération est effectuée.</p> - -<p>XUL fournit un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> qui peut être utilisé pour créer des assistants. Le contenu à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> inclut tout le contenu de chaque page. Les attributs placés sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> sont utilisés pour contrôler la navigation. Quand vous créez un assistant, utilisez la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> à la place de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>.</p> - -<div class="note">Notez que pour le moment les assistants ne fonctionnent correctement qu'à partir d'URLs chrome.</div> - -<p>Un assistant consiste en un ensemble de sections, bien que la mise en page exacte variera pour chaque plateforme. L'aspect visuel de l'assistant s'adaptera à la plateforme de l'utilisateur. Une mise en page type inclura un titre en haut, un ensemble de boutons de navigations en bas, et le contenu de la page entre les deux.</p> - -<p>Le titre du haut est créé en utilisant l'attribut <code id="a-title"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/title">title</a></code> comme on le ferait pour les fenêtres normales. Les boutons de navigation sont créés automatiquement. Les pages de l'assistant sont créées en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizardpage" title="wizardpage">wizardpage</a></code>. Vous pouvez y placer tout contenu que vous voulez.</p> - -<h4 id="Exemple_d.27assistant" name="Exemple_d.27assistant">Exemple d'assistant</h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_wizard_1.xul.txt">Source</a></p> - -<pre><?xml version="1.0" encoding="iso-8859-1"?> - -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<wizard id="example-window" title="Assistant de sélection de chien" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - - <wizardpage> - <description> - Cet assistant vous aidera à sélectionner le type de chien qui sera le mieux pour vous. - </description> - <label value="Pourquoi voulez vous un chien ?"/> - <menulist> - <menupopup> - <menuitem label="Pour faire peur aux gens"/> - <menuitem label="Pour se débarrasser d'un chat"/> - <menuitem label="J'ai besoin d'un meilleur ami"/> - </menupopup> - </menulist> - </wizardpage> - - <wizardpage description="Détails sur le chien"> - <label value="Fournissez plus de détails sur le chien que vous désirez :"/> - <radiogroup> - <caption label="Taille"/> - <radio value="small" label="Petit"/> - <radio value="large" label="Grand"/> - </radiogroup> - <radiogroup> - <caption label="Sexe"/> - <radio value="male" label="Male"/> - <radio value="female" label="Femelle"/> - </radiogroup> - </wizardpage> - -</wizard> -</pre> - -<div class="float-right"><img alt="Image:xultu_wizard1.jpg" class="internal" src="/@api/deki/files/1567/=Xultu_wizard1.jpg"></div> - -<p>L'assistant a deux pages, une qui a une liste déroulante et une autre qui a un ensemble de boutons radios. L'assistant sera formaté automatiquement, avec un titre en haut et un ensemble de boutons le long du bas de la fenêtre. L'utilisateur peut naviguer entre les pages de l'assistant avec les boutons 'Précédent' et 'Suivant'. Ces boutons s'activeront ou se désactiveront eux-mêmes aux moments appropriés. De plus, sur la dernière page, le bouton 'Terminer' apparaîtra. Tout ceci est automatique, aussi, vous n'avez rien à faire pour manipuler les pages.</p> - -<p>L'attribut <code id="a-description"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/description">description</a></code> peut être éventuellement placé sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizardpage" title="wizardpage">wizardpage</a></code> pour fournir un sous-titre pour la page concernée. Dans l'exemple du dessus, il est placé sur la seconde page, mais pas sur la première.</p> - -<h3 id="Gestion_des_changements_de_page" name="Gestion_des_changements_de_page">Gestion des changements de page</h3> - -<p>Généralement, vous souhaitez réaliser une action après que le bouton 'Terminer' ait été pressé. Vous pouvez mettre un attribut <code id="a-onwizardfinish"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onwizardfinish">onwizardfinish</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizard" title="wizard">wizard</a></code> pour accomplir cette tâche. Spécifiez-y un script qui exécutera ce que vous voulez et qui renverra 'true'. Le script peut être utilisé pour sauvegarder les informations que l'utilisateur a saisi dans l'assistant. Par exemple :</p> - -<pre><wizard id="example-window" title="Assistant de sélection de chien" - onwizardfinish="return saveDogInfo();" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> -</pre> - -<p>Quand l'utilisateur clique sur le bouton 'Terminer', la fonction <code>saveDogInfo</code> définie dans un script sera appelée pour sauvegarder les informations saisies. Si la fonction renvoie 'true', l'assistant se fermera. Si elle renvoie 'false', alors l'assistant ne se fermera pas, ce qui pourrait signifier par exemple que la fonction <code>saveDogInfo</code> a rencontré une saisie invalide.</p> - -<p>Il existe également les attributs similaires <code id="a-onwizardback"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onwizardback">onwizardback</a></code>, <code id="a-onwizardnext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onwizardnext">onwizardnext</a></code> et <code id="a-onwizardcancel"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onwizardcancel">onwizardcancel</a></code> qui sont appelés quand les boutons 'Précédent', 'Suivant' et 'Annuler' sont respectivement pressés. Ces fonctions sont appelées quelque soit la page en cours affichée.</p> - -<p>Pour appeler un code différent en fonction de la page où vous êtes, utilisez les attributs <code id="a-onpagerewound"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpagerewound">onpagerewound</a></code> ou <code id="a-onpageadvanced"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpageadvanced">onpageadvanced</a></code> sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizardpage" title="wizardpage">wizardpage</a></code>. Ils fonctionnent de manière similaire aux autres fonctions, excepté que vous pouvez utiliser un script différent pour chaque page. Cette méthode vous permet de valider les informations saisies sur chaque page avant que l'utilisateur ne continue.</p> - -<p>Une troisième méthode est l'utilisation des attributs <code id="a-onpagehide"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpagehide">onpagehide</a></code> et <code id="a-onpageshow"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpageshow">onpageshow</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/wizardpage" title="wizardpage">wizardpage</a></code>. Ils sont appelés lorsque la page est cachée ou affichée, indifféremment du bouton pressé (excepté quand le bouton 'Annuler' est pressé ; vous devez utiliser <code id="a-onwizardcancel"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onwizardcancel">onwizardcancel</a></code> pour le vérifier).</p> - -<p>Ces trois méthodes devraient fournir suffisamment de souplesse pour gérer la navigation comme vous le souhaitez. Ce qui suit est un résumé des fonctions d'attributs appelées quand l'utilisateur presse 'Suivant', dans l'ordre dans lequel elles sont vérifiées. Dés que l'une renvoie 'false', la navigation est annulée.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Attribut</th> - <th>Placé sur la balise</th> - <th>Quand est-il appelé ?</th> - </tr> - <tr> - <td>pagehide</td> - <td>wizardpage</td> - <td>Appelé sur la page que l'utilisateur quitte.</td> - </tr> - <tr> - <td>pageadvanced</td> - <td>wizardpage</td> - <td>Appelé sur la page que l'utilisateur quitte.</td> - </tr> - <tr> - <td>wizardnext</td> - <td>wizard</td> - <td>Appelé sur l'assistant.</td> - </tr> - <tr> - <td>pageshow</td> - <td>wizardpage</td> - <td>Appelé sur la page sur laquelle l'utilisateur entre.</td> - </tr> - </tbody> -</table> - -<p>Un processus similaire existe pour le bouton 'Précédent'.</p> - -<div class="note">À chaque fois que vous utiliserez une fonction dans un des événements ci-dessus, tel que pageadvanced, vous devrez utiliser <code>return NomFonct()</code> au lieu de simplement appeler <code>NomFonct()</code>. - -<pre><wizardpage pageadvanced='return NomFonct()'></wizardpage></pre> -</div> - -<hr> -<p>Dans la prochaine section, nous verrons des fonctionnalités supplémentaires sur les assistants.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Boîte_de_dialogue_de_fichier" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Assistant_avançé">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_programme_d'installation/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_programme_d'installation/index.html deleted file mode 100644 index c83ee8d774..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/création_d'un_programme_d'installation/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Création d'un programme d'installation -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Création_d'un_programme_d'installation -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Creating_an_Installer ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Overlays_inter-paquetage" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_scripts_d'installation">Suivant »</a></p> -</div> - -<div class="note">NdT : Attention, cette section décrit le mécanisme XPInstall propre à la suite Mozilla et à des versions anciennes de Mozilla Firefox. Pour les versions récentes de Mozilla Firefox, ce mode d'installation n'est plus le même, mais il n'est pas encore décrit dans ce tutoriel. Voir <a class="external" href="http://xulfr.org/wiki/ExtensionsFirefox">comment faire des extensions pour firefox</a> sur xulfr.org.</div> - -<p>Cette section va décrire le paquetage d'une application XUL dans un programme d'installation.</p> - -<h3 id="Paquetages_d.27installation_XPI" name="Paquetages_d.27installation_XPI">Paquetages d'installation XPI</h3> - -<p>Mozilla propose un mécanisme qui peut être utilisé pour empaqueter des fenêtres XUL, des scripts, des thèmes graphiques et d'autres fichiers dans un seul installateur. Il suffit de placer le fichier d'installation quelque part où les utilisateurs pourront le télécharger. Un simple script peut être utilisé pour assurer le téléchargement et l'installation du paquetage. Ce mécanisme est appelé <a href="/fr/XPInstall" title="fr/XPInstall">XPInstall</a> (Cross Platform Install).</p> - -<p>Les installateurs XPI sont empaquetés dans des fichiers JAR. À l'intérieur d'un fichier JAR, vous pouvez ajouter toutes sortes de fichiers que vous voulez voir installés. De plus, les installateurs doivent contenir un script (un fichier nommé install.js) qui décrit le processus d'installation. Ce script a accès à quelques fonctions d'installation qui peuvent être employées pour installer des fichiers et des composants.</p> - -<p>Les fichiers d'installation JAR ont typiquement l'extension .xpi (prononcez zippy) pour les distinguer des autres fichiers d'archives. Les installateurs seront habituellement utilisés pour installer des composants Mozilla tels que des thèmes graphiques, des extensions et d'autres paquetages.</p> - -<p>Il y a plusieurs étapes pour démarrer et installer les composants. Elles sont décrites pas à pas ci dessous :</p> - -<ol> - <li>Créer une page Web à partir de laquelle l'utilisateur peut charger l'application à installer. La page doit contenir un déclencheur d'installation qui est un petit script lançant l'installation.</li> - <li>Une boîte de dialogue présente à l'utilisateur le paquetage qui doit être installé. Il est possible pour le déclencheur de lancer de multiples installations. Dans ce cas, elles seront présentées dans une liste. L'utilisateur doit choisir de continuer ou d'annuler.</li> - <li>Si l'utilisateur choisit de continuer, le fichier d'installation XPI est téléchargé. Une barre de progression est affichée durant le processus.</li> - <li>Le fichier install.js est extrait de l'archive et exécuté. Le script va appeler les fonctions d'installation qui indiqueront quels fichiers de l'archive doivent être installés.</li> - <li>Une fois le script terminé, le nouveau paquetage a été installé. Si de multiples paquetages doivent être installés, leurs scripts se lanceront l'un après l'autre.</li> -</ol> - -<h3 id="D.C3.A9clencheurs_d.27installation" name="D.C3.A9clencheurs_d.27installation">Déclencheurs d'installation</h3> - -<p>Comme indiqué ci-dessus, le processus d'installation est lancé par un déclencheur d'installation. Il requiert l'utilisation de l'objet global spécial <code>InstallTrigger</code>. Il contient un certain nombre de méthodes qui peuvent être utilisées pour démarrer une installation. Vous pouvez utiliser cet objet dans un contenu local ou à distance, ce qui signifie qu'il est adapté pour un téléchargement à partir d'un site Web.</p> - -<p>Créons un exemple de déclencheur d'installation. Il nécessite l'utilisation de la fonction <code>InstallTrigger.install()</code>. Cette fonction a deux arguments, le premier est la liste des paquetages à installer, et le second est la référence à une fonction de rappel qui sera appelée lorsque l'installation est terminée. Voici un exemple :</p> - -<pre>function doneFn ( name , result ){ - alert("Le paquetage " + name + " a été installé avec un résultat de " + result); -} - -var xpi = new Object(); -xpi["Calendar"] = "calendar.xpi"; -InstallTrigger.install(xpi,doneFn); -</pre> - -<p>Premièrement, nous définissons la fonction <code>doneFn()</code> qui sera appelée lorsque l'installation est terminée. Bien entendu, vous pouvez nommer cette fonction comme vous le souhaitez. Cette fonction a deux arguments. Le premier argument est le nom du paquetage qui vient juste d'être installé. Celui ci est important si vous installez de multiples composants. Le second argument est un code de résultat. Un code de valeur '0' signifie que l'installation s'est terminée avec succès. Si le code de résultat n'est pas nul, une erreur a eu lieu et la valeur représente un code d'erreur. Ici, la fonction <code>doneFn()</code> affiche simplement une boîte d'alerte à l'utilisateur.</p> - -<p>Ensuite, nous créons un tableau xpi qui contient le nom ('Calendar') et l'URL ('calendar.xpi') du programme d'installation. Vous pouvez ajouter une ligne similaire pour chaque paquetage que vous souhaitez installer. Finalement, nous appelons la fonction d'installation.</p> - -<p>Lorsque cette portion de script sera exécutée, le fichier calendar.xpi sera installé.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> - -<p>Essayons ce script avec notre exemple de recherche de fichiers.</p> - -<pre>function doneFn ( name , result ){ - if (result) alert("L'erreur suivante a eu lieu: " + result); -} - -var xpi = new Object(); -xpi["Find Files"] = "findfile.xpi"; -InstallTrigger.install(xpi,doneFn); -</pre> -</div> - -<h3 id="L.27archive_XPI" name="L.27archive_XPI">L'archive XPI</h3> - -<div class="note"><strong>Note</strong> : Si vous créez une nouvelle <a href="/fr/XULRunner" title="fr/XULRunner">application XULRunner</a>, <a href="/fr/Extensions" title="fr/Extensions">extension</a>, ou <a href="/fr/Thèmes" title="fr/Thèmes">thème</a>, consultez la page <a href="/fr/Bundles" title="fr/Bundles">Bundles</a>.</div> - -<p>Le fichier d'installation XPI doit obligatoirement contenir au minimum un fichier appelé install.js qui est un fichier <a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a> exécuté lors de l'installation. Les autres fichiers sont les fichiers à installer. Ces derniers sont typiquement placés dans des répertoires de l'archive mais ils n'ont pas lieu de l'être. Pour des fichiers chrome, ils devraient être structurés comme le répertoire chrome.</p> - -<p>Souvent, les seuls fichiers trouvés dans une archive XPI sont le script d'installation (install.js) et un fichier JAR. Ce fichier JAR contient tous les fichiers utilisés par votre application. Les composants de Mozilla sont installés de cette manière.</p> - -<p>Parce que les fichiers XPI ne sont rien d'autres que des fichiers ZIP, vous pouvez les créer en utilisant un utilitaire zip (NdT : les fichiers JAR sont également des fichiers ZIP).</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers_2" name="Notre_exemple_de_recherche_de_fichiers_2">Notre exemple de recherche de fichiers</h4> - -<p>Pour notre exemple de recherche de fichiers, nous créerons une structure dans l'archive comme ce qui suit :</p> - -<pre>install.js -findfile - content - contents.rdf - findfile.xul - findfile.js - skin - contents.rdf - findfile.css - locale - contents.rdf - findfile.dtd -</pre> - -<p>Un répertoire a été ajouté pour chaque partie du paquetage, pour le contenu, pour le thème graphique et pour la localisation. Des fichiers 'contents.rdf' ont également été ajoutés car ils sont nécessaires pour l'enregistrement des fichiers chrome.</p> -</div> - -<hr> -<p>Dans la section suivante, nous aborderons le script d'installation.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Overlays_inter-paquetage" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_scripts_d'installation">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_des_boîtes_de_dialogue/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/créer_des_boîtes_de_dialogue/index.html deleted file mode 100644 index cc2a63e092..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_des_boîtes_de_dialogue/index.html +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: Créer des boîtes de dialogue -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Créer_des_boîtes_de_dialogue -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Creating_Dialogs ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Caractéristiques_d'une_fenêtre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Boîte_de_dialogue_de_fichier">Suivant »</a></p> -</div> - -<p>Une application XUL requiert souvent l'affichage de boîtes de dialogue. Cette section décrit comment les construire.</p> - -<h3 id="Cr.C3.A9ation_d.27une_bo.C3.AEte_de_dialogue" name="Cr.C3.A9ation_d.27une_bo.C3.AEte_de_dialogue">Création d'une boîte de dialogue</h3> - -<p>La fonction <code><a href="/fr/DOM/window.openDialog" title="fr/DOM/window.openDialog">openDialog()</a></code> est utilisée pour ouvrir une fenêtre. Une fonction apparentée est <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">open()</a></code>. Cette fonction a plusieurs différences importantes. Au lieu d'une fenêtre (window), elle affiche une boîte de dialogue (dialog), ce qui implique qu'elle demande quelque chose à l'utilisateur. Elle peut avoir des différences subtiles dans sa manière de fonctionner et d'apparaître à l'utilisateur suivant les différentes plateformes.</p> - -<p>De plus, la fonction <code>openDialog()</code> peut prendre des arguments additionnels en plus des trois premiers habituels. Ces arguments sont passés à la nouvelle boîte de dialogue et placés dans un tableau stocké dans la propriété <code id="a-arguments"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/arguments">arguments</a></code> de la nouvelle fenêtre. Vous pouvez passer autant d'arguments que nécessaire. C'est un moyen pratique de fournir des valeurs par défaut aux champs de la boîte de dialogue.</p> - -<pre>var somefile=document.getElementById('enterfile').value; - -window.openDialog("chrome://findfile/content/showdetails.xul","showmore", - "chrome",somefile); -</pre> - -<p>Dans cet exemple, la boîte de dialogue <code>showdetails.xul</code> sera affichée. L'argument 'somefile' provenant d'un élément d'id 'enterfile' lui est transmis. Dans un script utilisé par la boîte de dialogue, nous pouvons alors faire référence à l'argument en utilisant la propriété <code id="a-arguments"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/arguments">arguments</a></code> de la fenêtre. Par exemple :</p> - -<pre>var fl = window.arguments[0]; - -document.getElementById('thefile').value = fl; -</pre> - -<p>C'est un moyen efficace de passer des valeurs à la nouvelle fenêtre. Vous pouvez renvoyer des valeurs de la fenêtre ouverte vers la fenêtre originelle de deux manières. Première méthode : vous pouvez utiliser la propriété <a href="/fr/DOM/window.opener" title="fr/DOM/window.opener">window.opener</a> qui contient une référence à la fenêtre qui a ouvert la boîte de dialogue. Seconde méthode : vous pouvez passer une fonction ou un objet en argument, puis appeler la fonction ou modifier l'objet dans la boîte de dialogue ouverte.</p> - -<div class="note">Note : <code>openDialog()</code> nécessite un privilège UniversalBrowserWrite. Cela signifie que cette méthode ne fonctionnera pas sur des sites distants ; pour ces sites, utilisez la méthode <code>window.open()</code> à la place.</div> - -<h3 id="L.27.C3.A9l.C3.A9ment_XULElemdialog" name="L.27.C3.A9l.C3.A9ment_XULElemdialog">L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/dialog" title="dialog">dialog</a></code></h3> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/dialog" title="dialog">dialog</a></code> doit être utilisé à la place de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> lors de la création d'une boîte de dialogue. Il offre la possibilité de construire jusqu'à quatre boutons au bas de la boîte de dialogue, pour « OK », « Annuler », etc. Vous n'avez pas besoin d'inclure le code XUL pour chaque bouton mais vous devez fournir le code à exécuter quand l'utilisateur les presse. Ce mécanisme est nécessaire car les différentes plateformes ont un ordre d'affichage spécifique de ces boutons.</p> - -<h4 id="Exemple_de_bo.C3.AEte_de_dialogue" name="Exemple_de_bo.C3.AEte_de_dialogue">Exemple de boîte de dialogue</h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dialogs_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dialogs_1.xul">Voir</a></p> - -<pre><?xml version="1.0" encoding="iso-8859-1"?> -<?xml-stylesheet href="chrome://global/skin/global.css" type="text/css"?> - -<dialog id="donothing" title="Ne fait rien" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" - buttons="accept,cancel" - ondialogaccept="return doOK();" - ondialogcancel="return doCancel();"> - -<script> -function doOK(){ - alert("Vous avez appuyé sur OK !"); - return true; -} - -function doCancel(){ - alert("Vous avez appuyé sur Annuler !"); - return true; -} -</script> - -<description value="Veuillez sélectionner un bouton"/> - -</dialog> -</pre> - -<p>Vous pouvez placer tous les éléments que vous souhaitez dans une boîte de dialogue. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/dialog" title="dialog">dialog</a></code> a des attributs que les fenêtres n'ont pas. L'attribut <code id="a-buttons"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/buttons">buttons</a></code>, par exemple, est utilisé pour spécifier quels boutons doivent apparaître dans la boîte de dialogue. Les valeurs suivantes peuvent être utilisées en les séparant par des virgules :</p> - -<ul> - <li>'accept' - un bouton OK</li> - <li>'cancel' - un bouton Annuler</li> - <li>'help' - un bouton Aide</li> - <li>'disclosure' - un bouton d'information, utilisé pour montrer plus d'informations.</li> -</ul> - -<p>Vous pouvez exécuter du code lors de l'appui des boutons en utilisant les attributs <code id="a-ondialogaccept"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ondialogaccept">ondialogaccept</a></code>, <code id="a-ondialogcancel"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ondialogcancel">ondialogcancel</a></code>, <code id="a-ondialoghelp"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ondialoghelp">ondialoghelp</a></code> et <code id="a-ondialogdisclosure"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ondialogdisclosure">ondialogdisclosure</a></code>. Si vous essayez l'exemple ci-dessus, vous remarquerez que la fonction <code>doOK</code> est appelée quand le bouton 'OK' est pressé et que la fonction <code>doCancel</code> est appelée quand le bouton 'Annuler' est pressé.</p> - -<p>Les deux fonctions <code>doOK</code> et <code>doCancel</code> renvoient 'true', ce qui indique que la boîte de dialogue doit être fermée. Si la valeur 'false' était renvoyée, la boîte de dialogue resterait ouverte. Ce fonctionnement pourrait être utilisé dans le cas où une valeur invalide serait entrée dans un champ de la boîte de dialogue.</p> - -<p>Voici d'autres attributs utiles :</p> - -<ul> - <li><code><code id="a-buttonlabelaccept"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/buttonlabelaccept">buttonlabelaccept</a></code></code> - libellé devant apparaître sur le bouton d'acceptation (par ex. Sauvegarder)</li> - <li><code><code id="a-buttonaccesskeyaccept"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/buttonaccesskeyaccept">buttonaccesskeyaccept</a></code></code> - touche de raccourci pour le bouton d'acceptation (par ex. S)</li> - <li><code><code id="a-defaultButton"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/defaultButton">defaultButton</a></code></code> - le bouton activé lorsque la touche <code>Entrée</code> est appuyée</li> -</ul> - -<div class="note"><strong>Note </strong>: Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sont nécessaires pour les sites distants et ont probablement été omis dans les exemples précédents à cause du <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=224996" title="<dialog> buttons have no label in remote XUL">bug 224996</a>.</div> - -<h4 id="Exemple_de_dialogue_avec_plus_de_fonctionnalit.C3.A9s" name="Exemple_de_dialogue_avec_plus_de_fonctionnalit.C3.A9s">Exemple de dialogue avec plus de fonctionnalités</h4> - -<pre><?xml version="1.0" encoding="iso-8859-1?> -<?xml-stylesheet href="chrome://global/skin/global.css" type="text/css"?> - -<dialog id="myDialog" title="Mon dialogue" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" - onload="window.sizeToContent();" - buttons="accept,cancel" - buttonlabelaccept="Choix favori" - buttonaccesskeyaccept="S" - ondialogaccept="return doSave();" - buttonlabelcancel="Annuler" - buttonaccesskeycancel="n" - ondialogcancel="return doCancel();"> - -<script> -function doSave(){ - //faireTraitement() - return true; -} -function doCancel(){ - return true; -} -</script> - -<dialogheader title="Mon dialogue" description="Exemple de dialogue"/> -<groupbox flex="1"> - <caption label="Sélectionnez votre fruit préféré"/> - <radio id="orange" label="Des oranges car elles sont juteuses"/> - <radio id="violet" selected="true" label="Des frises à cause de leur couleur"/> - <radio id="yellow" label="Des bananes car elles sont déjà emballées"/> -</groupbox> - -</dialog> -</pre> - -<p>Les éléments correspondants aux boutons sont accessibles en JavaScript par le script suivants :</p> - -<pre>// le bouton d'acceptation -var acceptButt = document.documentElement.getButton("accept") -</pre> - -<h4 id="Autres_exemples" name="Autres_exemples">Autres exemples</h4> - -<p>D'autres exemples sont disponibles dans <a href="/fr/Extraits_de_code/Dialogues_et_invites" title="fr/Extraits_de_code/Dialogues_et_invites">Dialogues et invites</a>.</p> - -<hr> -<p>Dans la prochaine section, nous allons voir comment ouvrir des boîtes de dialogue de sélection de fichiers.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Caractéristiques_d'une_fenêtre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Boîte_de_dialogue_de_fichier">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_un_thème/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/créer_un_thème/index.html deleted file mode 100644 index 55430426d5..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_un_thème/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Créer un thème -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Créer_un_thème -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Creating_a_Skin ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Modification_du_thème_par_défaut" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Localisation">Suivant »</a></p> -</div> - -<div class="warning"> -<p>Cette documentation n'a pas été mise à jour pour Firefox Quantum. Il n'y aucune garantie que la modification du fichier <code>userChrome.css</code> fonctionne encore d'une version à l'autre de Firefox. Celle-ci pourrait également provoquer la survenue de bugs difficiles à diagnostiquer. <span class="short_text" id="result_box" lang="fr"><span>À utiliser à vos risques et périls !</span></span></p> -</div> - -<p>Cette section décrit comment créer un thème simple. Nous ne l'appliquerons qu'à la fenêtre de recherche de fichiers.</p> - -<h3 id="Un_th.C3.A8me_simple" name="Un_th.C3.A8me_simple">Un thème simple</h3> - -<p>L'image ci-dessous montre la boîte de dialogue de recherche de fichiers actuelle. Créons un thème que nous pourrons lui appliquer. Normalement, un thème doit s'appliquer à l'application entière, mais, pour plus de facilité, nous allons nous concentrer sur la boîte de dialogue de recherche de fichiers. Pour cette raison, nous n'allons modifier que le fichier 'findfile.css' plutôt que le fichier 'global.css'. Cette section suppose que vous démarriez avec le thème Classic. Si vous le souhaitez, faites une copie des fichiers utilisés par la boîte de dialogue de recherche de fichiers avant de les modifier.</p> - -<p><img alt="Image:xultu_cskin1.jpg" class="internal" src="/@api/deki/files/1513/=Xultu_cskin1.jpg"></p> - -<div class="note"><strong>Note du traducteur</strong> : Pour les versions récentes de mozilla (> 1.6) et de firefox (>0.8), avec le fichier findfile.css tel qu'il est, il se peut que vous n'obteniez pas un design identique à ce que montre l'image. En effet, dans le thème classic, des styles <code>-moz-appearance</code> ont été ajoutés depuis aux différents éléments, leur permettant d'avoir le même aspect que les éléments natifs de l'interface graphique utilisée (windows ou kde, macos, etc.). Ce style empêche certains styles d'être appliqués correctement. Pour pouvoir modifier complètement l'apparence des éléments utilisés dans notre exemple et afin de suivre le tutoriel, il a été rajouté le code suivant dans la feuille de styles de l'exemple : - -<pre class="brush: css">tab, button, menulist, menubar,menupopup,toolbar,tabpanels { - -moz-appearance:none; -} -</pre> -</div> - -<p>Vous devez créer un fichier 'findfile.css' dans un thème personnalisé, ou vous pouvez placer ce fichier temporairement dans le répertoire "content" et y faire référence en utilisant une directive de la feuille de styles. Vous pouvez modifier le fichier 'findfile.css' existant directement pour voir à quoi cela ressemble, ou vous pouvez créer un thème personnalisé et y faire un lien.</p> - -<h4 id="Cr.C3.A9ation_d.27un_paquetage_de_th.C3.A8me_personnalis.C3.A9" name="Cr.C3.A9ation_d.27un_paquetage_de_th.C3.A8me_personnalis.C3.A9">Création d'un paquetage de thème personnalisé</h4> - -<p>Pour créer un thème, faites ce qui suit : (si vous utilisez Firefox 1.5 ou supérieur, consultez plutôt <a href="/fr/Tutoriel_XUL/Les_fichiers_manifest" title="fr/Tutoriel_XUL/Les_fichiers_manifest">les fichiers manifest</a>)</p> - -<ol> - <li>Créez un répertoire quelque part où vous placerez les fichiers du thème.</li> - <li>Copiez un fichier manifeste (contents.rdf) du thème Classic ou Modern dans ce nouveau répertoire.</li> - <li>Modifiez les références dans le fichier manifeste à un nom personnalisé pour votre thème. Par exemple, changez les références de 'classic/1.0' vers 'blueswayedshoes/1.0'.</li> - <li>Ajoutez une ligne de la forme suivante au fichier 'chrome/installed-chrome.txt' :<br> - <code><a class="external" href="skin,install,url,file:///stuff/blueswayedshoes/" rel="freelink">skin,install,url,file:///stuff/blueswayedshoes/</a></code><br> - où la dernière partie pointe vers le répertoire que vous avez créé. Vérifiez bien que vous avez mis un slash à la fin.</li> -</ol> - -<p>Copiez le fichier 'findfile.css' original dans le nouveau répertoire. Nous l'utiliserons comme base pour le nouveau thème. Nous pourrons y faire référence par la suite en utilisant l'URL '<a class="external" rel="freelink">chrome://findfile/skin/findfile.css</a>'.</p> - -<h4 id="Ajout_de_r.C3.A8gles_de_styles" name="Ajout_de_r.C3.A8gles_de_styles">Ajout de règles de styles</h4> - -<p>Décidons d'abord quels types de changements nous voulons effectuer. Nous allons faire de simples changements de couleurs, modifier les styles des boutons et modifier un peu l'espacement. Commençons par les menus, les barres d'outils et le panneau global des onglets.</p> - -<p>L'ajout des règles de styles suivantes à 'findfile.css' provoquera les changements montrés dans l'image qui suit.</p> - -<pre class="brush: css">window > box { - background-color: #0088CC; -} - -menubar,menupopup,toolbar,tabpanels { - background-color: lightblue; - border-top: 1px solid white; - border-bottom: 1px solid #666666; - border-left: 1px solid white; - border-right: 1px solid #666666; -} - -caption { - background-color: lightblue; -} -</pre> - -<p><img alt="Image:xultu_cskin2.jpg" class="internal" src="/@api/deki/files/1514/=Xultu_cskin2.jpg"></p> - -<ul> - <li>La boîte intérieure de la fenêtre (qui entoure en fait tout le contenu de la fenêtre) a été changée pour avoir une couleur bleue.</li> - <li>Vous pouvez voir ce bleu derrière la bande des onglets et le long du bas de la fenêtre.</li> - <li>Les quatre éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbar" title="toolbar">toolbar</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code> apparaissent en bleu clair.</li> - <li>La bordure autour de ces quatre éléments a été modifiée pour donner une apparence 3D plus forte. Vous pouvez le voir si vous regardez attentivement.</li> - <li>La couleur de fond du <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code> a aussi été modifiée pour correspondre avec le fond.</li> -</ul> - -<p>La première règle au-dessus (pour <code>window > vbox</code>) spécifie que la boîte enfant de la fenêtre principale a une couleur différente. Ce n'est probablement pas la meilleure façon de procéder. Nous devrions plutôt modifier la fenêtre et plutôt utiliser une classe de style. C'est ce que nous allons faire. De cette manière, nous pourrons modifier le code XUL sans avoir besoin de conserver la boîte comme premier élément enfant de la fenêtre.</p> - -<pre class="eval"><strong>CSS:</strong> -.findfilesbox { - background-color: #0088CC; -} - -<strong>XUL:</strong> -<vbox <span class="highlightred">class="findfilesbox"</span> orient="vertical" flex="100%"> -<toolbox> -</pre> - -<h4 id="Arrondis_sur_les_onglets" name="Arrondis_sur_les_onglets">Arrondis sur les onglets</h4> - -<p>Ensuite, modifions les onglets. Nous allons rendre l'onglet sélectionné en gras et changer les arrondis sur les onglets.</p> - -<pre class="brush: css">tab:first-child { - -moz-border-radius: 4px 0px 0px 0px; -} - -tab:last-child { - -moz-border-radius: 0px 4px 0px 0px; -} - -tab[selected="true"] { - color: #000066; - font-weight: bold; - text-decoration: underline; -} -</pre> - -<div class="float-right"><img alt="Image:xultu_cskin3.jpg" class="internal" src="/@api/deki/files/1515/=Xultu_cskin3.jpg"></div> - -<p>Deux règles changent l'apparence normale de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code>. La première met un arrondi sur le premier onglet et la seconde met un arrondi sur le dernier. On utilise ici une règle de styles propre à Mozilla, <code><a href="/fr/CSS/-moz-border-radius" title="fr/CSS/-moz-border-radius">-moz-border-radius</a></code>, qui crée des coins arrondis. La bordure supérieure gauche du premier onglet et la bordure supérieure droite du second onglet sont arrondies de quatre pixels et les autres coins sont arrondis de zéro pixels, ce qui équivaut à aucun arrondi. Augmentez ces valeurs pour un arrondi plus prononcé et diminuez-les pour une apparence plus rectangulaire.</p> - -<p>La dernière règle ne s'applique qu'aux onglets qui ont leur attribut <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> à la valeur 'true'. Elle met le texte d'un onglet sélectionné en gras, souligné et bleu foncé. Notez dans l'image que ce style n'est appliqué qu'au premier onglet, puisqu'il est sélectionné.</p> - -<h4 id="Ajout_des_ic.C3.B4nes_de_barres_d.27outils" name="Ajout_des_ic.C3.B4nes_de_barres_d.27outils">Ajout des icônes de barres d'outils</h4> - -<p>Il est assez difficile de distinguer les boutons de la barre d'outils des commandes du menu. Nous pourrions ajouter des icônes aux boutons pour les rendre plus clairs. L'éditeur Mozilla Composer fournit des icônes pour les boutons ouvrir et sauvegarder que nous utilisons pour gagner du temps. Nous pouvons choisir l'image d'un bouton en utilisant la propriété CSS <code><a href="/fr/CSS/list-style-image" title="fr/CSS/list-style-image">list-style-image</a></code>.</p> - -<pre class="brush: css">#opensearch { - list-style-image: url("chrome://editor/skin/icons/btn1.gif"); - -moz-image-region: rect(48px 16px 64px 0); - -moz-box-orient: vertical; -} - -#savesearch { - list-style-image: url("chrome://editor/skin/icons/btn1.gif"); - -moz-image-region: rect(80px 16px 96px 0); - -moz-box-orient: vertical; -} -</pre> - -<div class="float-right"><img alt="Image:xultu_cskin4.jpg" class="internal" src="/@api/deki/files/1516/=Xultu_cskin4.jpg"></div> - -<p>Mozilla met à disposition une propriété de style spécifique, <code><a href="/fr/CSS/-moz-image-region" title="fr/CSS/-moz-image-region">-moz-image-region</a></code>, qui permet à un élément d'utiliser une partie d'une image. Vous pouvez vous la représenter comme un découpage de l'image. Vous mettez comme valeur de la propriété une position et une taille comprise dans une image et le bouton n'affichera que cette section de l'image. Cette technique vous permet d'utiliser la même image pour plusieurs boutons et de mettre une portion différente pour chacun d'entre eux. Quand vous avez beaucoup de boutons, avec chacun d'eux des états pour hover, active et disabled, elle fait gagner de l'espace qui serait sinon occupé par plusieurs images. Dans le code ci-dessus, nous utilisons la même image pour tous les boutons, mais nous mettons une portion différente de l'image pour chacun. Si vous regardez cette image (btn1.gif), vous remarquerez qu'elle contient une grille d'images plus petites, de 16 fois 16 pixels chacune.</p> - -<div class="note"><strong>Note du traducteur</strong> : étant donné que l'image en question fait partie de Mozilla Composer, si vous ouvrez l'exemple avec Firefox, vous ne verrez pas les images des boutons, car Mozilla Composer n'est livré qu'avec la suite Mozilla.</div> - -<p>La propriété <code><a href="/fr/CSS/-moz-box-orient" title="fr/CSS/-moz-box-orient">-moz-box-orient</a></code> est utilisée pour orienter le bouton verticalement, pour que l'image apparaisse au-dessus de son libellé. Cette propriété a la même signification que l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. Elle est pratique puisque le thème ne peut pas modifier le code XUL. La plupart des attributs de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> ont des propriétés CSS qui leur correspondent.</p> - -<h4 id="Autres_modifications" name="Autres_modifications">Autres modifications</h4> - -<p>Nous allons maintenant faire quelques changements aux boutons situés en bas de la boîte de dialogue, en réutilisant des icônes de Mozilla pour gagner du temps. Si vous créez votre propre thème, vous aurez besoin de créer de nouvelles icônes ou de copier les icônes dans de nouveaux fichiers. Si vous suivez l'exemple de cette section, copiez juste les fichiers vers votre nouveau thème et modifiez les URL en conséquence.</p> - -<pre class="brush: css">#find-button { - list-style-image: url("chrome://global/skin/checkbox/images/cbox-check.jpg"); - font-weight: bold; -} - -#cancel-button { - list-style-image: url("chrome://global/skin/icons/images/close-button.jpg"); -} - -button:hover { - color: #000066; -} -</pre> - -<div class="float-right"><img alt="Image:xultu_cskin5.jpg" class="internal" src="/@api/deki/files/1517/=Xultu_cskin5.jpg"></div> - -<p>Nous ajoutons des images aux boutons et mettons le texte du bouton « Rechercher » en gras pour indiquer que c'est le bouton par défaut. La dernière règle s'applique aux boutons quand la souris les survole (état hover). Nous mettons une couleur de texte bleu foncé dans ce cas. Finalement, quelques changements mineurs de l'espacement autour des éléments, par l'utilisation de marges :</p> - -<pre class="brush: css">tabbox { - margin: 4px; -} - -toolbarbutton { - margin-left: 3px; - margin-right: 3px; -} -</pre> - -<p>Après ces changements, la boîte de dialogue de recherche de fichiers apparaît maintenant comme ceci :</p> - -<p><img alt="Image:xultu_cskin-fin.jpg" class="internal" src="/@api/deki/files/1512/=Xultu_cskin-fin.jpg"></p> - -<p>Comme vous pouvez le voir, de simples changements des règles de styles apportent une apparence assez différente à la fenêtre de recherche de fichiers. Nous pourrions continuer en modifiant les menus, les poignées sur la barre d'outils et les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code>.</p> - -<h3 id="Cr.C3.A9ation_d.27un_th.C3.A8me_global" name="Cr.C3.A9ation_d.27un_th.C3.A8me_global">Création d'un thème global</h3> - -<p>Le thème créé ci-dessus est simple et ne s'applique qu'à la boîte de dialogue de recherche de fichiers. Certaines des modifications du thème pourraient être placées dans les feuilles de styles globales (situées dans le répertoire global du thème) pour s'appliquer à toutes les applications. Par exemple, il serait peu cohérent d'avoir des images différentes entre les cases à cocher de la fenêtre de recherche de fichiers et celles d'autres fenêtres. Ce changement devrait vraiment être intégré dans la feuille de styles globale.</p> - -<p>Essayez de déplacer les styles CSS de 'findfile.css' dans 'global.css' puis regardez les fenêtres de dialogue de Mozilla (Le visualisateur de cookie est un bon exemple). Vous remarquerez qu'elles ont adopté les règles que nous avons ajoutées. Certaines des règles entrent en conflit avec celles déjà dans les feuilles de styles globales. Par exemple, des règles sont déjà définies pour les boutons, les onglets, etc., et nous avons défini des règles additionnelles pour ces éléments. Quand vous modifiez le thème global, vous devez fusionner les changements avec les règles existantes.</p> - -<p>Pour une meilleure adaptation du thème graphique, il vaut mieux déclarer les règles de styles liées à l'apparence dans le répertoire global plutôt que dans des fichiers de styles séparés. Les couleurs, les polices de caractère et l'apparence générale des composants graphiques doivent y être inclus. Si vous modifiez la couleur d'un élément dans un fichier de thème local (comme 'findfile.css'), la fenêtre de dialogue peut paraître bizarre si l'utilisateur change son style global. N'espérez pas que l'utilisateur utilise le thème par défaut.</p> - -<div class="highlight"> -<p><span id="L'exemple_du_dialogue_de_recherche_de_fichier_avec_ce_th%C3%A8me"><a id="L'exemple_du_dialogue_de_recherche_de_fichier_avec_ce_th%C3%A8me"></a><strong>L'exemple du dialogue de recherche de fichier avec ce thème</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-cskin.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-cskin.xul">Voir</a></p> -</div> - -<hr> -<p>La section suivante explique comment rendre une application XUL localisable.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Modification_du_thème_par_défaut" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Localisation">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_une_fenêtre/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/créer_une_fenêtre/index.html deleted file mode 100644 index 3cff976726..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/créer_une_fenêtre/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Créer une fenêtre -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Créer_une_fenêtre -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Creating_a_Window ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_fichiers_manifest" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_boutons">Suivant »</a></p> -</div> - -<p>Nous allons créer un simple outil de recherche de fichiers tout au long de ce tutoriel. Avant tout, cependant, nous devons étudier la syntaxe de base d'un fichier XUL.</p> - -<h3 id="Cr.C3.A9ation_d.27un_fichier_XUL" name="Cr.C3.A9ation_d.27un_fichier_XUL">Création d'un fichier XUL</h3> - -<p>Un fichier XUL peut avoir n'importe quel nom mais il doit avoir l'extension <code>.xul</code>. Le fichier XUL le plus simple a la structure suivante :</p> - -<pre><?xml version="1.0" encoding="ISO-8859-1"?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<window - id="findfile-window" - title="Recherche de fichiers" - orient="horizontal" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> -... -</window> -</pre> - -<p>Cette fenêtre ne sert à rien puisqu'elle ne comporte pas d'élements d'interface utilisateur. Ceux ci seront ajoutés dans la section suivante. Voici l'analyse ligne par ligne du code ci-dessus :</p> - -<ol> - <li><strong><?xml version="1.0"?></strong><br> - Cette ligne déclare simplement qu'il s'agit d'un fichier XML. Vous devrez normalement ajouter cette ligne à l'identique au début de chaque fichier xul, tout comme vous mettriez la balise <code>HTML</code> au début d'un fichier HTML.</li> - <li><strong><?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?></strong><br> - Cette ligne est utilisée pour spécifier la feuille de style à utiliser pour le fichier. C'est la syntaxe que les fichiers XML emploient pour importer des feuilles de style. Dans ce cas, nous importons les styles trouvés dans le répertoire chrome <code>global/skin</code>. Nous n'avons pas indiqué de fichier spécifique ainsi Mozilla déterminera quels fichiers du dossier il emploiera. Ici, le fichier le plus important, <code>global.css</code>, est sélectionné. Ce fichier contient toutes les déclarations par défaut pour tous les éléments XUL. Puisque XML ne connaît pas la manière dont les éléments doivent être affichés, ce fichier s'en charge. De façon générale, vous mettrez cette ligne au debut de chaque fichier XUL. Vous pouvez également importer d'autres feuilles de style en utilisant la même syntaxe. Notez que vous devrez normalement importer la feuille de style globale à l'intérieur du fichier de votre propre feuille de style.</li> - <li><strong><window</strong><br> - Cette ligne déclare que vous allez décrire une fenêtre <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Chaque fenêtre d'interface utilisateur est décrit dans un fichier différent. Cette balise s'apparente à une balise HTML qui entoure l'ensemble d'un document HTML, sauf qu'elle décrit une interface utilisateur au lieu d'un document. <a href="/fr/XUL/window#Attributes" title="fr/XUL/window#Attributes">Plusieurs attributs</a> peuvent être placés dans la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> -- dans ce cas, ils sont au nombre de quatre. Dans cet exemple, chaque attribut est placé sur une ligne séparée bien que ce ne soit pas une obligation.</li> - <li><strong>id="findfile-window"</strong><br> - L'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> est utilisé comme un identifiant, de sorte que des scripts puissent y faire référence. Vous mettrez normalement un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur tous les éléments. Vous êtes libre de choisir n'importe quel nom, toutefois, il est préférable qu'il soit pertinent.</li> - <li><strong>title="Recherche de fichiers"</strong><br> - L'attribut <code id="a-title"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/title">title</a></code> décrit le texte qui apparaîtra dans la barre de titre de la fenêtre quand elle sera affichée. Dans le cas présent, le texte 'Recherche de fichiers' sera affiché.</li> - <li><strong>orient="horizontal"</strong><br> - L'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> spécifie l'arrangement des éléments de la fenêtre. La valeur 'horizontal' indique que les éléments doivent être placés horizontalement dans la fenêtre. Vous pouvez également utiliser la valeur 'vertical' signifiant que les éléments seront affichés en colonne. Comme c'est la valeur par défaut, vous pouvez omettre cet attribut si vous souhaitez avoir l'orientation verticale.</li> - <li><strong><span class="nowiki">xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"></span></strong><br> - Cette ligne déclare l'espace de nommage pour XUL que vous devrez mettre dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> pour indiquer que tous ses enfants sont du XUL. Notez que cette URL n'est jamais téléchargée réellement. Mozilla reconnaîtra cette URL en interne.</li> - <li><strong>...</strong><br> - Mettez ici les éléments (les boutons, les menus et les autres composants de l'interface utilisateur) à afficher dans la fenêtre. Nous en ajouterons quelques uns dans les prochaines sections.</li> - <li><strong></window></strong><br> - Et enfin, nous devons fermer la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> à la fin du fichier. - <h3 id="Ouverture_d.27une_fen.C3.AAtre" name="Ouverture_d.27une_fen.C3.AAtre">Ouverture d'une fenêtre</h3> - - <p>Afin d'ouvrir une fenêtre XUL, plusieurs méthodes peuvent être employées. Si vous n'êtes qu'à l'étape de développement, vous pouvez juste taper l'URL (commençant par chrome:, file: ou d'autre type d'URL) dans la barre d'adresses du navigateur Mozilla. Vous pouvez également double-cliquer sur le fichier dans votre gestionnaire de fichiers, en supposant que les fichiers XUL soient associés à Mozilla. La fenêtre XUL apparaîtra cependant dans la fenêtre de navigateur et non dans une nouvelle, mais c'est souvent suffisant durant les premières étapes de développement.</p> - - <p>La manière correcte, naturellement, est d'ouvrir la fenêtre en utilisant JavaScript. Aucune nouvelle syntaxe n'est nécessaire, vous pouvez employer la fonction <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">window.open()</a></code> comme pour tout document <a href="/fr/HTML" title="fr/HTML">HTML</a>. Cependant, une option additionnelle, appelée 'chrome' est nécessaire pour indiquer au navigateur que le document à ouvrir est un <a href="/fr/DOM/window.open#_Fonctionnalit.C3.A9s_relatives_.C3.A0_la_fen.C3.AAtre" title="fr/DOM/window.open#_Fonctionnalit.C3.A9s_relatives_.C3.A0_la_fen.C3.AAtre">chrome</a>. Celle-ci s'ouvrira sans barre d'outils, sans menu et sans aucun élément qu'une fenêtre de navigateur dispose normalement. La syntaxe est décrite ci-dessous :</p> - - <pre>window.open(url,windowname,flags); - -où l'argument flags contient "chrome" comme dans cet exemple : - -window.open("chrome://navigator/content/navigator.xul", "bmarks", "chrome,width=600,height=300");</pre> - - <div class="highlight"> - <h3 id="L.27exemple_findfile.xul" name="L.27exemple_findfile.xul">L'exemple findfile.xul</h3> - - <p>Commençons par créer le fichier de base pour la boîte de dialogue de recherche de fichiers. Créez un fichier appelé <code>findfile.xul</code> et mettez le dans le répertoire content spécifié dans le fichier <code>findfile.manifest</code> (nous l'avons créé dans la section précédente). Ajoutez au fichier le squelette XUL montré au début de cette page et sauvegardez le.</p> - - <p>Vous pouvez utiliser le paramètre en ligne de commande '-chrome' pour indiquer le fichier XUL à ouvrir au démarrage de mozilla. S'il n'est pas spécifié, la fenêtre par défaut s'ouvrira (habituellement la fenêtre de navigateur). Par exemple, nous pourrions ouvrir la boite de dialogue de recherche de fichiers avec l'une des commandes suivantes :</p> - - <pre>mozilla -chrome chrome://findfile/content/findfile.xul -mozilla -chrome resource:/chrome/findfile/content/findfile/findfile.xul -</pre> - Si vous utilisez cette commande en ligne (dans l'hypothèse que cela soit possible sur votre plateforme), la boite de dialogue de recherche de fichiers s'ouvrira par défaut au lieu de la fenêtre de navigateur de Mozilla. Naturellement, puisque nous n'avons pas mis d'éléments graphiques dans la fenêtre, vous ne verrez rien. Dans la section suivante, quelques éléments y seront ajoutés.</div> - - <p>Pour en voir quand même l'effet, la commande en ligne suivante ouvrira la fenêtre des marque-pages :</p> - - <pre class="eval">mozilla -chrome <a class="external" rel="freelink">chrome://communicator/content/bookma...rksManager.xul</a> - -<span class="highlightred">Si vous utilisez Firefox, essayez :</span> -firefox -chrome <a class="external" rel="freelink">chrome://browser/content/places/places.xul</a></pre> - - <p>L'option '-chrome' ne donne aucun privilège supplémentaire au fichier. Au lieu de cela, il entraine l'ouverture du fichier spécifié dans une fenêtre racine sans aucune interface chrome de navigation, comme la barre d'adresses ou le menu. Seules les URLs chrome ont des privilèges supplémentaires.</p> - - <div class="note"><a class="external" href="http://xulfr.org/outils/">L'Éditeur dynamique XUL</a> vous permet de taper du code XUL et de voir immédiatement le résultat dans Mozilla !</div> - - <h3 id="Probl.C3.A8mes" name="Probl.C3.A8mes">Problèmes</h3> - - <ul> - <li>Si la fenêtre XUL ne se montre pas sur le bureau mais a un icône sur la barre de tâches, vérifiez la déclaration xml-stylesheet. Assurez vous que vous avez inclus correctement la feuille de style :</li> - </ul> - - <pre class="eval"><?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> -</pre> - - <hr> - <p>Dans la section suivante, nous ajouterons des boutons dans la fenêtre.</p> - - <div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_fichiers_manifest" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_boutons">Suivant »</a></p> -</div> - </li> -</ol> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/document_object_model/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/document_object_model/index.html deleted file mode 100644 index 6b269306e4..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/document_object_model/index.html +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: Document Object Model -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Document_Object_Model -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Document_Object_Model ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Broadcasters_et_Observateurs" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Modification_d'une_interface_XUL">Suivant »</a></p> -</div> -<p>Le Document Object Model (DOM, modèle objet d'un document) peut être utilisé pour modifier les éléments XUL ou obtenir des informations à leur propos.</p> -<h3 id="Introduction_au_DOM" name="Introduction_au_DOM">Introduction au DOM</h3> -<p>Le <a href="/fr/DOM" title="fr/DOM">DOM</a> est utilisé pour stocker l'arbre des nœuds XUL. Quand un fichier XUL est chargé, les balises sont interprétées et converties dans une structure hiérarchique de nœuds du document, un pour chaque balise et bloc de texte. La structure DOM peut être examinée et modifiée en utilisant des méthodes dédiées. Des éléments XUL spécifiques fournissent également des fonctions additionnelles pouvant être utilisées.</p> -<p>Chaque fichier XUL chargé aura son propre document affiché dans une fenêtre ou un cadre. Bien qu'il ne puisse y avoir qu'un seul document associé à une fenêtre à un moment donné, vous pouvez charger des documents supplémentaires en utilisant plusieurs méthodes.</p> -<p>Dans Mozilla, on peut accéder au <a href="/fr/DOM" title="fr/DOM">DOM</a> et le manipuler en utilisant JavaScript. Les divers objets DOM possèdent des fonctions accessibles par script, pourtant, il est important de noter que le DOM est une <abbr title="Application programming interface">API</abbr> qui est accessible par JavaScript. JavaScript lui-même n'est jamais qu'un langage de script pouvant accéder à ces objets parce que Mozilla fournit ces objets à l'utilisation.</p> -<p>Dans <a href="/fr/JavaScript" title="fr/JavaScript">JavaScript</a>, il existe un unique objet global toujours disponible. Vous pouvez vous reférer aux propriétés et méthodes de l'objet global sans avoir à les qualifier avec un objet. Par exemple, si l'objet global possède une propriété <code>name</code>, vous pouvez changer le nom avec le code <code>name=7</code> sans avoir à spécifier l'objet à utiliser. Dans un contexte de navigateur, la fenêtre est l'objet global. Il en va de même pour XUL. Naturellement, l'objet global sera différent pour chaque fenêtre. Chaque cadre aura également un objet <code>window</code> séparé.</p> -<p>On se refère souvent à la fenêtre en utilisant <a href="/fr/DOM/window.window" title="fr/DOM/window.window">la propriété <code>window</code></a>, bien que ce soit optionnel. Quelquefois, cette pratique sert uniquement à clarifier la portée de la méthode à laquelle vous vous reférez. Par exemple, les deux lignes suivantes qui ouvrent une nouvelle fenêtre, sont fonctionnellement équivalentes :</p> -<pre>window.open("test.xul","_new"); -open("test.xul","_new"); -</pre> -<p>Lorsque vous déclarez une fonction ou une variable en tête de script, en dehors d'une fonction, vous êtes en train de déclarer une propriété de l'objet global. En XUL, chaque fonction que vous déclarez sera définie comme une propriété de l'objet <code>window</code>. Par exemple, le code suivant affichera deux fois le texte 'message' dans une <a href="/fr/DOM/window.alert" title="fr/DOM/window.alert">alerte</a>.</p> -<pre>function getText(){ - return "Message"; -} - -alert(getText()); -alert(window.getText()); -</pre> -<p>De fait, si vous vouler accéder à des variables ou appeler une fonction déclarée dans un script utilisé par une autre fenêtre, vous pouvez y accéder juste en utilisant l'objet <code><a href="/fr/DOM/window" title="fr/DOM/window">window</a></code> de l'autre fenêtre. Par exemple, si nous avions combiné les deux derniers exemples dans un seul fichier, nous pourrions appeler la fonction <code>getText</code> au sein de l'autre fenêtre (par ex. la fenêtre test.xul). Pour cela, nous pouvons faire la chose suivante :</p> -<pre>alert(window.opener.getText());</pre> -<p>Chaque fenêtre possède une propriété <code><a href="/fr/DOM/window.opener" title="fr/DOM/window.opener">opener</a></code> contenant l'objet <code>window</code> l'ayant ouverte. Dans cet exemple, nous récupérons la fenêtre responsable de l'ouverture et appelons la fonction <code>getText</code> déclarée dans un script situé dans celle-ci. Notez que nous qualifions la propriété avec l'identifiant <code>window</code> uniquement pour plus de clarté.</p> -<p>La méthode <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">open()</a></code> de la fenêtre retourne également une référence à la nouvelle fenêtre, donc vous pouvez appeler des fonctions de la nouvelle fenêtre à partir de l'ouvrante. Toutefois, il est important de noter que la méthode <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">open()</a></code> renvoie sa valeur de retour avant que la fenêtre soit complètement chargée, donc les fonctions ne seront pas forcément disponibles pour autant.</p> -<p>L'objet <code>window</code> n'est défini par aucune spéficication DOM, mais est quelquefois considéré, dans Mozilla, comme faisant partie du DOM niveau 0, un nom utilisé par des développeurs pour se reférer aux fonctions assimilées DOM avant que celles-ci ne soient ajoutées aux spécifications. Le document actuel affiché dans une fenêtre peut être récupéré en utilisant la propriété <code><a href="/fr/DOM/window.document" title="fr/DOM/window.document">document</a></code> du document. Depuis qu'elle est devenue la propriété de la fenêtre la plus couramment utilisée, la propriété <code>document</code> est habituellement utilisée sans le qualifieur <code><a href="/fr/DOM/window.document" title="fr/DOM/window.document">document</a></code>.</p> -<p>Mozilla founit divers objets de document en fonction de son type. Les trois documents principaux sont les <a class="external" href="http://www.xulplanet.com/references/objref/HTMLDocument.html">HTMLDocument</a>, <a class="external" href="http://www.xulplanet.com/references/objref/XMLDocument.html">XMLDocument</a> et <a class="external" href="http://www.xulplanet.com/references/objref/XULDocument.html">XULDocument</a>, respectivement pour les documents <a href="/fr/HTML" title="fr/HTML">HTML</a>, <a href="/fr/XML" title="fr/XML">XML</a> et <a href="/fr/XUL" title="fr/XUL">XUL</a>. Évidemment, c'est ce dernier type de document qui est utilisé pour le XUL. Les trois types de document sont très similaires. Concrètement, ils partagent tous la même implémentation de base. Mais il existe des fonctions spécifiques à chacun de ces documents.</p> -<h3 id="R.C3.A9cup.C3.A9rer_des_.C3.A9l.C3.A9ments" name="R.C3.A9cup.C3.A9rer_des_.C3.A9l.C3.A9ments">Récupérer des éléments</h3> -<p>La méthode la plus courante pour récupérer un élément dans un document est de lui affecter un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> et d'utiliser la méthode <code><a href="/fr/DOM/document.getElementById" title="fr/DOM/document.getElementById">getElementById()</a></code> du document. Nous avons ajouté l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> à un certain nombre d'éléments dans la boîte de recherche de fichiers. Par exemple, nous pouvons obtenir l'état de la case à cocher en utilisant le code ci-dessous :</p> -<pre>var state = document.getElementById('casecheck').checked;</pre> -<p>La valeur 'casecheck' correspond à l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de la case à cocher définissant la sensibilité à la casse. Une fois que nous savons si elle est cochée ou non, nous pouvons utiliser cette indication pour effectuer la recherche. Nous pourrions procéder de façon similaire pour l'autre case à cocher, ou n'importe quel autre élément qui a un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>. Nous aurons par exemple besoin de récupérer le texte dans le champ de saisie.</p> -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> -<p>Il n'est pas nécessaire d'afficher la barre de progression et l'arbre de données vide quand la boîte de dialogue pour la recherche de fichiers est affichée pour la première fois. Ceux-ci ont été ajoutées de façon à ce que nous puissions les voir. Retirons-les maintenant, et affichons-les seulement lorsque le bouton « Rechercher » sera pressé. Au départ, nous devons les rendre invisible. L'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> est utilisé pour contrôler la visibilité d'un élément.</p> -<p>Nous allons modifier la barre de progression de façon à ce qu'elle soit cachée au départ. Nous allons aussi lui ajouter un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> pour qu'un script puisse y faire référence pour pouvoir la cacher ou l'afficher. Profitons-en pour cacher aussi le séparateur et l'arbre des résultats, puisque nous n'en aurons besoin qu'après avoir effectué une recherche.</p> -<pre class="eval"><tree <span class="highlightred">id="results" hidden="true"</span> flex="1"> - . - . - . -<splitter <span class="highlightred">id="splitbar"</span> resizeafter="grow" <span class="highlightred">hidden="true"</span>/> - -<hbox> - - <progressmeter <span class="highlightred">id="progmeter"</span> value="50%" - style="margin: 4px;" <span class="highlightred">hidden="true"</span>/> -</pre> -<p>Nous avons ajouté l'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> et mis sa valeur à 'true'. L'élément est ainsi caché lors de sa première apparition.</p> -<p>Ensuite, ajoutons une fonction qui sera appelée quand le bouton « Rechercher » sera pressé. Nous mettrons les scripts dans le fichier séparé 'findfile.js'. Dans une section précédente, nous avons ajouté l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/script" title="script">script</a></code> dans le fichier XUL. Si vous ne l'avez pas encore fait, faites-le maintenant, comme ci-dessous. Nous ajouterons aussi un gestionnaire <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> au bouton « Rechercher ».</p> -<pre class="eval"><script src="findfile.js"/> - . - . - . -<button id="find-button" label="Rechercher" - <span class="highlightred">oncommand="doFind();"</span>/> -</pre> -<p>À présent, créez un autre fichier nommé 'findfile.js' dans le même répertoire que 'findfile.xul'. Nous ajouterons la fonction <code>doFind()</code> dans ce fichier. La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/script" title="script">script</a></code> de ce fichier XUL peut contenir du code. Cependant, pour diverses raisons, notamment pour de meilleures performances, vous devriez toujours mettre vos scripts dans des fichiers séparés, excepté pour les courts morceaux de code qui peuvent se trouver directement dans les gestionnaires d'événement.</p> -<pre class="eval">function doFind(){ - var meter = document.getElementById('progmeter'); - meter.hidden = false; -} -</pre> -<p>Cette fonction récupère d'abord une référence à la barre de progression en utilisant son <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, 'progmeter'. La seconde ligne du corps de la fonction change l'état de <code>hidden</code> pour rendre l'élément visible.</p> -<p>Finalement, ajoutons une boîte de dialogue qui affiche ce que nous sommes en train de rechercher. Évidemment nous n'en voudrons pas dans la version finale, mais ajoutons la maintenant pour nous assurer que quelque chose se produise.</p> -<pre class="eval">function doFind(){ - var meter=document.getElementById('progmeter'); - meter.hidden = false; - <span class="highlightred">var searchtext=document.getElementById('find-text').value; alert("Recherche de \"" + searchtext + "\"");</span> -} -</pre> -<p>Maintenant, avec cette boîte d'alerte placée ici, nous saurons ce qui se produit quand nous cliquons sur le bouton « Rechercher ». Nous pouvons ajouter du code pour obtenir aussi ce qui est sélectionné dans les listes déroulantes.</p> -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-dom.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-dom.xul">Voir</a></p> -</div> -<h3 id="Le_DOM_des_.C3.A9l.C3.A9ments_XUL" name="Le_DOM_des_.C3.A9l.C3.A9ments_XUL">Le DOM des éléments XUL</h3> -<p>Chaque élément XUL possède un lot d'attributs, un lot de propriétés et un lot d'enfants.</p> -<ul> <li>Les attributs sont déclarés dans la source, par exemple, <code>flex="1"</code> est un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> déclaré avec la valeur '1'.</li> <li>Les propriétés sont disponibles en JavaScript en utilisant la syntaxe du point. Par exemple, element.hidden se réfère à la propriété <code>hidden</code> d'un élément.</li> <li>Les enfants sont les balises filles de l'élément et seront imbriqués à l'intérieur de l'élément dans la source.</li> -</ul> -<p>Il est possible de manipuler dynamiquement les attributs, propriétés et enfants d'un élément en utilisant les méthodes du DOM.</p> -<p>Il est important de noter que les attributs et les propriétés sont deux choses différentes. Tout simplement car le fait qu'un attribut avec un nom donné existe ne signifie pas qu'il existe une propriété correspondante ayant le même nom. Pourtant, c'est souvent le cas. Par exemple, pour obtenir le <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> d'un élément, vous pouvez utiliser la propriété <code>flex</code>. Dans ce cas, le code implicite retourne simplement la valeur de l'attribut. Pour d'autres propriétés, XUL accomplira des calculs plus complexes.</p> -<p>Vous pouvez manipuler les attributs d'un élément en utilisant l'une des méthodes suivantes :</p> -<dl> <dt><a href="/fr/DOM/element.getAttribute" title="fr/DOM/element.getAttribute">getAttribute</a> ( nomAttribut ) </dt> <dd>Renvoie la valeur de l'attribut 'nomAttribut'</dd> <dt><a href="/fr/DOM/element.hasAttribute" title="fr/DOM/element.hasAttribute">hasAttribute</a> ( nomAttribut ) </dt> <dd>Renvoie 'true' si l'attribut de nom 'nomAttribut' a une valeur</dd> <dt><a href="/fr/DOM/element.setAttribute" title="fr/DOM/element.setAttribute">setAttribute</a> ( nomAttribut , valeurAdonner ) </dt> <dd>Fixe la valeur de l'attribut 'nomAttribut' à la valeur 'valeurAdonner'</dd> <dt><a href="/fr/DOM/element.removeAttribute" title="fr/DOM/element.removeAttribute">removeAttribute</a> ( nomAttribut ) </dt> <dd>Supprime l'attribut 'nomAttribut'</dd> -</dl> -<p>Ces fonctions vous permettent d'obtenir ou de modifier la valeur d'un attribut à tout moment. Par exemple, pour utiliser la valeur de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, vous pourriez utiliser le code suivant :</p> -<pre> var box = document.getElementById('uneboite'); - var flex = box.getAttribute("flex"); - - var box2 = document.getElementById('uneautreboite'); - box2.setAttribute("flex", "2"); -</pre> -<p>Pourtant, l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> a une propriété de script correspondante pouvant être utilisée à la place. Ce n'est pas plus efficace, mais c'est légèrement plus court à écrire. L'exemple suivant fait la même chose qu'au-dessus, en utilisant la propriété <code>flex</code> à la place :</p> -<pre> var box = document.getElementById('uneboite'); - var flex = box.flex; - - var box2 = document.getElementById('uneautreboite'); - box2.flex = 2; -</pre> -<p>Une fois que vous avez une référence à un élément, vous pouvez appeler les propriétés de cet élément. Par exemple, pour obtenir la propriété <code>hidden</code> d'un élément, vous pouvez utiliser la syntaxe <code><em>element</em>.hidden</code> où "element" est une référence à l'élément. Notez que la plupart des propriétés listées dans la référence est en corrélation avec les attributs communs des éléments. Il y a des différences, bien sûr, par exemple, alors que <code>getAttribute("hidden")</code> retournera la chaîne '"true"' pour un élément caché, la propriété <code>hidden</code> retournera une valeur 'true' booléenne. Dans ce cas, la conversion de type est faite pour vous, donc la propriété est plus commode.</p> -<p>Comme pour chaque document, l'objet "element" pour les éléments XUL n'est pas le même que pour des éléments <a href="/fr/HTML" title="fr/HTML">HTML</a> et <a href="/fr/XML" title="fr/XML">XML</a>. Chaque élément XUL implémente l'interface <a class="external" href="http://www.xulplanet.com/references/objref/XULElement.html">XULElement</a>. Un élément XUL est un élément déclaré avec l'espace de nommage (namespace) XUL. Ainsi, les éléments XUL auront cette interface même s'ils sont ajoutés à d'autres documents XML, et les éléments non-XUL ne l'auront pas. L'interface XULElement possède un certain nombre de propriétés et méthodes spécifiques aux éléments XUL, pour beaucoup héritées de l'interface générique des éléments DOM.</p> -<p>Un espace de nommage est un URI qui spécifie le type d'élément. Voici quelques exemples :</p> -<pre><button xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"/> -<button xmlns="http://www.w3.org/1999/xhtml"/> -<html:button xmlns:html="http://www.w3.org/1999/xhtml"/> -<html:button xmlns:html="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"/> -</pre> -<p>Les espaces de nommages sont spécifiés en utilisant l'attribut <code>xmlns</code>.</p> -<ul> <li>Le premier bouton est un élément XUL qui a été placé dans l'espace de nommage XUL.</li> <li>Le second élément est un élément XHTML auquel on a donner l'espace de nommage XHTML.</li> <li>Dans le troisième exemple, le préfixe "html" est donné à l'espace de nommage <span class="nowiki">'http://www.w3.org/1999/xhtml'</span>. Vous pouvez également utiliser la syntaxe en préfixe avec une colonne pour utiliser un espace de nommage spécifique. On y a recours lorsqu'on utilise plusieurs espaces de nommage dans un document et que l'on désire préciser quel espace de nommage est actuellement utilisé. Dans le cas présent, un bouton XHTML est créé.</li> <li>Le quatrième bouton est un peu confus, mais il faut préciser que c'est l'URI qui est important et non le préfixe. C'est une distinction importante. Le quatrième exemple est un bouton XUL, pas un bouton HTML, en dépit du préfixe attribué.</li> -</ul> -<p>C'est une distinction importante. En fait, le texte utilisé pour le préfixe n'est pas significatif lorsqu'il détermine quel type d'élément est utilisé.</p> -<p>Le DOM fournit un certain nombre de fonctions relatives aux espaces de nommage, similaires aux fonctions de base. Par exemple, la fonction <code><a href="/fr/DOM/element.getAttributeNS" title="fr/DOM/element.getAttributeNS">getAttributeNS()</a></code> est similaire à la fonction <code><a href="/fr/DOM/element.getAttribute" title="fr/DOM/element.getAttribute">getAttribute()</a></code>, excepté un argument supplémentaire pouvant être fourni pour spécifier un attribut dans un espace de nommage spécifique.</p> -<p>Quelques éléments XUL disposent de leurs propres propriétés qui leurs sont spécifiques. Reportez-vous à la <a href="/fr/Référence_XUL" title="fr/Référence_XUL">référence</a> pour un guide complet des attributs et propriétés disponibles pour un élément.</p> -<h3 id="Naviguer_dans_le_DOM" name="Naviguer_dans_le_DOM">Naviguer dans le DOM</h3> -<p>Le DOM est une structure en arbre composé d'un unique nœud racine avec ses enfants. Vous pouvez obtenir une référence au nœud racine en utilisant la propriété <code><a href="/fr/DOM/document.documentElement" title="fr/DOM/document.documentElement">documentElement</a></code> du document. Le nœud racine est toujours un élément, mais ce n'est pas le cas pour tous les nœuds de l'arbre. Un élément correspond à une balise dans la source XUL, mais vous pouvez également trouver des nœuds de texte, des nœuds de commentaire et quelques autres types dans un arbre de document. Dans le cas de XUL, l'élément racine sera la balise <code><code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code></code> dans le document XUL. Chaque nœud de l'arbre peut avoir des enfants et ces enfants peuvent avoir des nœuds fils à leur tour. Comme le DOM est une structure en arbre, vous pouvez naviguer au sein de cet arbre en utilisant une grande variété de propriétés. Quelques méthodes, parmi les plus communes, sont listées ci-après :</p> -<dl> <dt><a href="/fr/DOM/element.firstChild" title="fr/DOM/element.firstChild">firstChild</a> </dt> <dd>Référence au premier nœud fils d'un élément</dd> <dt><a href="/fr/DOM/element.lastChild" title="fr/DOM/element.lastChild">lastChild</a> </dt> <dd>Référence au dernier nœud fils d'un élément</dd> <dt><a href="/fr/DOM/element.childNodes" title="fr/DOM/element.childNodes">childNodes</a> </dt> <dd>Contient la liste des enfants d'un élément</dd> <dt><a href="/fr/DOM/element.parentNode" title="fr/DOM/element.parentNode">parentNode</a> </dt> <dd>Référence au père d'un nœud</dd> <dt><a href="/fr/DOM/element.nextSibling" title="fr/DOM/element.nextSibling">nextSibling</a> </dt> <dd>Référence au prochain nœud de même niveau</dd> <dt><a href="/fr/DOM/element.previousSibling" title="fr/DOM/element.previousSibling">previousSibling</a> </dt> <dd>Référence au nœud précédent de même niveau</dd> -</dl> -<p>Ces propriétés vous permettent de naviguer de diverses manières au sein d'un document. Par exemple, vous pouvez obtenir un premier enfant d'un élément en utilisant la propriété <code><a href="/fr/DOM/element.firstChild" title="fr/DOM/element.firstChild">firstChild</a></code> et ensuite, naviguer au sein de tous ses enfants en utilisant la propriété <code><a href="/fr/DOM/element.nextSibling" title="fr/DOM/element.nextSibling">nextSibling</a></code>. Ou vous pourriez accomplir la même chose en parcourant les items du tableau childNodes listant tous les enfants. Dans Mozilla, la dernière façon est plus efficace.</p> -<p>L'exemple suivant montre comment parcourir tous les enfants du n½ud racine :</p> -<pre>var childNodes = document.documentElement.childNodes; -for (var i = 0; i < childNodes.length; i++) { - var child = childNodes[i]; - // faire quelque chose avec child -} -</pre> -<p>La variable '<a href="/fr/DOM/element.childNodes" title="fr/DOM/element.childNodes">childNodes</a>' contiendra les enfants de l'élément racine du document. Nous pouvons donc utiliser une boucle <code>for</code> pour parcourir les enfants, en accédant à chaque item comme pour un tableau.</p> -<hr> -<p>Dans la prochaine section, nous découvrirons comment modifier le DOM.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Broadcasters_et_Observateurs" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Modification_d'une_interface_XUL">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/données_persistantes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/données_persistantes/index.html deleted file mode 100644 index 696401deaf..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/données_persistantes/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Données persistantes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Données_persistantes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Persistent_Data ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Règles_avançées" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajouter_des_feuilles_de_style">Suivant »</a></p> -</div> -<p>Cette section décrit comment sauvegarder l'état d'une fenêtre XUL.</p> -<h3 id="M.C3.A9morisation_d.27un_.C3.A9tat" name="M.C3.A9morisation_d.27un_.C3.A9tat">Mémorisation d'un état</h3> -<p>Lors de la création d'une application importante, il est fréquent de vouloir sauvegarder l'état d'une fenêtre tout au long des sessions. Par exemple, la fenêtre doit se souvenir quelles étaient les barres d'outils masquées après que l'utilisateur l'ait quitté.</p> -<p>Une possibilité serait d'écrire un script chargé de collecter l'information que vous voulez sauvegarder et de l'enregistrer dans un fichier. Toutefois, cette opération deviendrait pénible à chaque application. Heureusement, XUL propose un mécanisme pour sauvegarder les états d'une fenêtre.</p> -<p>L'information est collectée et stockée dans un fichier RDF (localstore.rdf) dans le même répertoire que les autres préférences de l'utilisateur. Ce fichier retient les états de chaque fenêtre. Cette méthode a l'avantage de fonctionner avec les profils utilisateurs de Mozilla, ainsi chaque utilisateur a ses propres paramètres.</p> -<p>XUL vous permet de sauvegarder l'état de n'importe quel élément. Typiquement, vous pouvez sauvegarder les états des barres d'outils, les positions des fenêtres et si certains panneaux sont affichés ou non, mais vous pouvez sauvegarder presque tout.</p> -<h4 id="Attribut_XULAttrpersist" name="Attribut_XULAttrpersist">Attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code></h4> -<p>Pour permettre la sauvegarde d'états, vous devez simplement ajouter l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> à l'élément qui contient la valeur que vous voulez sauvegarder. L'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> doit être affecté par une liste d'éléments séparés par des espaces. L'élément concerné doit également avoir un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> pour permettre de l'identifier.</p> -<p>Par exemple, pour sauvegarder la position d'une fenêtre, vous devrez procéder comme ceci :</p> -<pre><window - id="someWindow" - width="200" - height="300" - persist="width height" - . - . - . -</pre> -<p>Les deux attributs de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>, <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> et <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, seront sauvegardés. Vous pourriez ajouter à l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> des attributs supplémentaires à mémoriser tout en les séparant par un espace. Vous pouvez ajouter l'attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> à n'importe quel élément et mémoriser n'importe quel attribut. Vous pouvez utiliser des valeurs inhabituelles si vous ajustez les attributs par un script.</p> -<div class="highlight"> -<h4 id="Exemple_de_recherche_de_fichiers" name="Exemple_de_recherche_de_fichiers">Exemple de recherche de fichiers</h4> -<p>Ajoutons un attribut <code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code> à quelques éléments de notre boîte de dialogue de recherche de fichiers. Pour sauvegarder la position de la fenêtre, nous devons modifier l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> :</p> -<pre class="eval"><window - id="findfile-window" - title="Recherche de fichiers" - <span class="highlightred">persist="screenX screenY width height"</span> - orient="horizontal" - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> -</pre> -<p>Cette modification va sauvegarder la position x et y de la fenêtre, sa largeur et sa hauteur. Nous poursuivrons plus tard la mémorisation de l'état du séparateur. La mémorisation de l'onglet sélectionné n'aurait aucun sens.</p> -<p><span id="Exemple_de_recherche_de_fichiers"><a id="Exemple_de_recherche_de_fichiers"></a><strong>Exemple de recherche de fichiers</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-persist.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-persist.xul">Voir</a></p> -</div> -<hr> -<p>Dans la section suivante, nous verrons comment appliquer des feuilles de styles à des fichiers XUL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Règles_avançées" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajouter_des_feuilles_de_style">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_le_modèle_de_boîte/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_le_modèle_de_boîte/index.html deleted file mode 100644 index 974efe3272..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_le_modèle_de_boîte/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Détails sur le modèle de boîte -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Détails_sur_le_modèle_de_boîte -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Box_Model_Details ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Positionnement_des_éléments" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_boîtes_de_groupe">Suivant »</a></p> -</div> -<p>Nous avons déjà vu beaucoup de fonctionnalités sur le modèle de boîtes. Dans cette section, nous verrons quelques détails supplémentaires en nous appuyant sur des exemples.</p> -<h3 id="Plus_de_d.C3.A9tails_sur_la_mise_en_page" name="Plus_de_d.C3.A9tails_sur_la_mise_en_page">Plus de détails sur la mise en page</h3> -<p>Les propriétés de style comme <code id="a-min-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min-width">min-width</a></code> et <code id="a-max-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max-height">max-height</a></code> peuvent être appliquées à n'importe quels éléments. Nous les avons ajouté aux boutons et aux champs de saisie, mais nous pouvons aussi les ajouter aux éléments d'espacement ou aux boîtes. De même, l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> peut être appliqué à n'importe quel élément.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_1.xul">Voir</a></p> -<pre><hbox flex="1"> - <button label="Gauche" style="min-width: 100px;" flex="1"/> - <spacer flex="1"/> - <button label="Droite" style="min-width: 100px;" flex="1"/> -</hbox> -</pre> -<p>Dans l'exemple ci-dessus, les trois éléments se redimensionnent eux-mêmes car il sont tous flexibles. Les deux boutons ont une largeur minimum de 100 pixels. Les deux boutons ne seront jamais plus petits que cette taille mais ils pourront toujours s'élargir. Ici, la fenêtre doit apparaître avec une largeur d'un peu plus de 200 pixels. C'est suffisant pour les deux boutons. Car si les trois éléments sont flexibles, ils ne nécessitent pas pour autant plus de place, la flexibilité n'ajoute pas d'espace supplémentaire.</p> -<div class="float-right"><img alt="Image:xultu_boxdet1.png" class=" internal" src="/@api/deki/files/1497/=Xultu_boxdet1.png"></div> -<p>Comme il est montré dans l'image ci-dessus, il y a deux boutons qui s'étirent verticalement pour remplir leur élément conteneur, qui dans ce cas est le <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code>. L'attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code> contrôle ce comportement sur une boîte horizontale. Vous pouvez aussi empêcher cet étirement en précisant une hauteur maximale sur l'élément ou mieux, sur la boîte elle-même. Si une boîte a une hauteur maximale, les éléments qu'elle contient sont limités en hauteur par celle-ci. Cependant, le problème est que vous devez connaître au préalable la taille d'un élément pour pouvoir le spécifier à la boîte.</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_2.xul">Voir</a></p> -<pre><hbox flex="1" align="top"> - <button label="Gauche" style="min-width: 100px;" flex="1"/> - <spacer flex="1"/> - <button label="Droite" style="min-width: 100px;" flex="1"/> -</hbox> -</pre> -<h4 id="R.C3.A9sum.C3.A9_du_mod.C3.A8le_de_bo.C3.AEte" name="R.C3.A9sum.C3.A9_du_mod.C3.A8le_de_bo.C3.AEte">Résumé du modèle de boîte</h4> -<p>Pour parfaire une mise en page complexe, vous devrez généralement ajouter des boîtes imbriquées, spécifier une taille minimale et maximale pour quelques éléments, et rendre certains éléments flexibles. La meilleure interface est celle qui peut être affichée sans problème dans différentes tailles. Le modèle de boîte peut être difficile à appréhender si vous n'essayez pas différentes choses par vous-même.</p> -<p>Voici une courte description des deux types de boîtes :</p> -<p><strong>Boîtes horizontales</strong></p> -<ol> <li>Affichent chaque élément les uns à coté des autres horizontalement.</li> <li>Les éléments flexibles le sont horizontalement.</li> <li>Le groupement (NdT : attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>) contrôle le placement horizontal des éléments fils.</li> <li>L'alignement contrôle la manière dont les lignes d'éléments seront alignées verticalement.</li> -</ol> -<p><strong>Boîtes verticales</strong></p> -<ol> <li>Affichent chaque élément verticalement en colonnes.</li> <li>Les éléments flexibles le sont verticalement.</li> <li>Le groupement contrôle le placement vertical des éléments fils.</li> <li>L'alignement contrôle la manière dont les colonnes d'éléments seront alignées horizontalement.</li> -</ol> -<p>Vous pouvez mettre des boîtes n'importe où dans un fichier XUL, même dans un élément HTML comme une table. Cependant, l'affichage sera en partie dépendant de l'élément HTML. Cela signifie que l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> risque de ne pas réagir exactement comme vous le voudriez. Rappelez-vous que la flexibilité n'a de sens que pour les éléments qui sont directement à l'intérieur d'une boîte, ou d'un élément qui est assimilé à une boîte.</p> -<h3 id="Exemples_de_mise_en_page" name="Exemples_de_mise_en_page">Exemples de mise en page</h3> -<h4 id="1._Utiliser_les_spacers" name="1._Utiliser_les_spacers">1. Utiliser les spacers</h4> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_3.xul">Voir</a></p> -<pre><hbox> - <button label="Un"/> - <spacer style="width: 5px"/> - <button label="Deux"/> -</hbox> -</pre> -<p>Ici, un espacement est utilisé comme séparateur entre deux boutons, en précisant une largeur de 5 pixels. Vous pouvez aussi utiliser les marges de la propriété CSS <code>margin</code>.</p> -<h4 id="2._Centrer_des_boutons" name="2._Centrer_des_boutons">2. Centrer des boutons</h4> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_4.xul">Voir</a></p> -<pre><hbox pack="center" align="center" flex="1"> - <button label="Regardez Moi!"/> - <button label="Cliquez Moi!"/> -</hbox> -</pre> -<p>Cet exemple propose une boîte horizontale flexible contenant deux boutons. La boîte possède l'attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code> qui est utilisé pour centrer les boutons horizontalement. L'attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, quant à lui, aligne verticalement les boutons. Le résultat est que les boutons seront centrés dans la boîte dans les deux directions. Cet exemple fonctionnera aussi avec une boîte verticale, sauf que le second bouton sera alors sous le premier, au lieu d'être à coté de lui.</p> -<h4 id="3._Une_fen.C3.AAtre_de_recherche_dans_le_texte" name="3._Une_fen.C3.AAtre_de_recherche_dans_le_texte">3. Une fenêtre de recherche dans le texte</h4> -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxdet_5.xul">Voir</a></p> -<pre><?xml version="1.0" encoding="iso-8859-1" ?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<window id="findtext" title="Recherche dans un texte" orient="horizontal" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - - <vbox flex="3"> - <label control="t1" value="Mots clés :"/> - <textbox id="t1" style="min-width: 100px;" flex="1"/> - </vbox> - - <vbox style="min-width: 150px;" flex="1" align="start"> - <checkbox id="c1" label="Ignorer la casse"/> - <spacer flex="1" style="max-height: 30px;"/> - <button label="Rechercher"/> - </vbox> - -</window> -</pre> -<div class="float-right"><img alt="Image:xultu_boxdet-ex3.png" class=" internal" src="/@api/deki/files/1496/=Xultu_boxdet-ex3.png"></div> -<p>Ici, deux boîtes verticales sont créées, une pour le champ texte et l'autre pour la case à cocher et le bouton de recherche. La boîte de gauche a une flexibilité 3 fois plus grande que celle de droite donc elle prendra toujours 3 fois plus de place quand la taille de la fenêtre augmentera. La boîte de droite impose une largeur minimum de 150 pixels.</p> -<p>Le champ de saisie est flexible donc il s'ajustera à la taille de la fenêtre. Il impose aussi une largeur minimum de 100 pixels. La case à cocher apparaît dans la boîte de droite avec son libellé. Juste en dessous de la case à cocher, il y a un <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> (espacement). L'espacement s'agrandira ou se rétrécira mais n'excédera pas 30 pixels. Le résultat est que la case à cocher et le bouton de recherche seront séparés par un espace qui ne fera pas plus de 30 pixels.</p> -<p>La seconde boîte a un alignement de valeur 'start'. Les trois éléments fils seront par conséquent alignés sur le bord gauche. Si l'alignement n'était pas précisé, sa valeur par défaut serait 'stretch', ce qui aurait pour effet de positionner les éléments fils les uns à coté des autres horizontalement. Puisque nous ne voulons pas que le bouton de recherche change de taille, nous devons préciser un alignement.</p> -<hr> -<p>Dans la prochaine section, nous allons en apprendre un peu plus sur un type de boîte plus spécifique, le groupe de boîte.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Positionnement_des_éléments" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_boîtes_de_groupe">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_les_vues_d'arbres/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_les_vues_d'arbres/index.html deleted file mode 100644 index d9257abad2..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/détails_sur_les_vues_d'arbres/index.html +++ /dev/null @@ -1,298 +0,0 @@ ---- -title: Détails sur les vues d'arbres -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Détails_sur_les_vues_d'arbres -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Tree_View_Details ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Vues_d'arbre_personnalisées" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes_des_arbres">Suivant »</a></p> -</div> -<p>Cette section décrit quelques fonctionnalités supplémentaires des vues d'arbre.</p> -<h3 id="Cr.C3.A9ation_d.27une_vue_hi.C3.A9rarchique_personnalis.C3.A9e" name="Cr.C3.A9ation_d.27une_vue_hi.C3.A9rarchique_personnalis.C3.A9e">Création d'une vue hiérarchique personnalisée</h3> -<p>Dans la section précédente, nous avons créé une vue d'arbre simple qui était implémentée avec un minimum de fonctionnalités. À présent, regardons quelques fonctions supplémentaires que les vues peuvent implémenter. Ici, nous examinerons comment créer un ensemble hiérarchique d'items utilisant la vue. C'est un processus relativement astucieux qui implique de conserver une trace des items qui sont des enfants et une trace de l'état des lignes, ouvertes ou fermées.</p> -<h4 id="Imbrication_de_niveaux" name="Imbrication_de_niveaux">Imbrication de niveaux</h4> -<p>Chaque ligne dans l'arbre possède un niveau d'imbrication. Les lignes les plus hautes ont un niveau 0, les enfants de ces lignes ont un niveau 1, leurs enfants le niveau 2 et ainsi de suite. L'arbre interroge la vue pour chaque ligne en appelant sa méthode <code>getLevel()</code> pour connaître le niveau de cette ligne. La vue devra retourner 0 pour les premiers parents et des valeurs plus élevées pour les lignes intérieures. L'arbre utilisera cette information pour déterminer la structure hiérarchique de ces lignes.</p> -<p>En complément de la méthode <code>getLevel()</code>, la fonction <code>hasNextSibling()</code> retourne pour une ligne donnée la valeur 'true' si elle est suivie d'une autre ligne de même niveau qu'elle. Cette fonction est spécifiquement utilisée pour dessiner l'imbrication des lignes sur le côté de la vue de l'arbre.</p> -<p>La méthode <code>getParentIndex()</code> est supposée retourner la ligne parente d'une ligne donnée, c'est-à-dire : la ligne précédente qui a un niveau d'imbrication inférieur. Toutes ces méthodes doivent être implémentées par la vue pour que les enfants soient manipulés correctement.</p> -<h4 id="Conteneurs" name="Conteneurs">Conteneurs</h4> -<p>Trois autres fonctions, <code>isContainer</code>, <code>isContainerEmpty</code> et <code>isContainerOpen</code> sont utilisées pour manipuler un item parent dans l'arbre.</p> -<ul> - <li>La méthode <code>isContainer</code> doit retourner 'true' si une ligne est un conteneur pouvant contenir des enfants.</li> - <li>La méthode <code>isContainerEmpty</code> doit renvoyer 'true' si une ligne est un conteneur vide, par exemple, un répertoire/dossier qui ne contient aucun fichier.</li> - <li>La méthode <code>isContainerOpen</code> sert à déterminer quel item est ouvert ou fermé. La vue a besoin d'en conserver une trace. L'arbre appellera cette méthode pour déterminer quels conteneurs sont ouverts et lesquels sont fermés.</li> -</ul> -<p>Notez que l'arbre n'appellera ni <code>isContainerEmpty</code>, ni <code>isContainerOpen</code> pour les lignes qui ne sont pas conteneurs en se basant sur la valeur de retour de la méthode <code>isContainer</code>.</p> -<p>Un conteneur peut être affiché différemment d'un non-conteneur. Par exemple, un conteneur peut avoir un icône de dossier devant lui. Une feuille de styles peut être utilisée pour personnaliser l'aspect des items en se basant sur diverses propriétés telles que l'ouverture d'une ligne conteneur. La stylisation sera décrite dans <a href="/fr/Tutoriel_XUL/Styler_un_arbre" title="fr/Tutoriel_XUL/Styler_un_arbre">une prochaine section</a>. Un conteneur non vide sera agrémenté d'une poignée (<abbr title="Note du Traducteur">NdT&nbsp;:</abbr> "twisty", petit '+' ou '-' ou un triangle sur les Macintosh) permettant à l'utilisateur d'ouvrir ou de fermer la ligne pour voir les items enfants. Les conteneurs vides n'auront pas de poignées, mais seront toujours considérés comme des conteneurs.</p> -<p>Lorsque l'utilisateur clique sur la poignée pour ouvrir une ligne, l'arbre appellera la méthode <code>toggleOpenState()</code>. La vue met alors en œuvre les opérations nécessaires pour intégrer les lignes enfants et mettre à jour l'arbre avec les nouvelles lignes.</p> -<h4 id="R.C3.A9sum.C3.A9_des_m.C3.A9thodes" name="R.C3.A9sum.C3.A9_des_m.C3.A9thodes">Résumé des méthodes</h4> -<p>Voici un récapitulatif des méthodes nécessaires pour implémenter des vues hiérarchiques :</p> -<pre>getLevel(ligne) -hasNextSibling(ligne, apresIndex) -getParentIndex(ligne) -isContainer(ligne) -isContainerEmpty(ligne) -isContainerOpen(ligne) -toggleOpenClose(ligne) -</pre> -<p>L'argument <code>apresIndex</code> de la fonction <code>hasNextSibling</code> est utilisée pour une raison d'optimisation, afin de démarrer la recherche à partir de la prochaine ligne sœur (ligne de même niveau d'imbrication). Par exemple, l'appelant pourrait déjà connaître la position de la prochaine ligne sœur. Imaginez une situation où une ligne possède des sous-lignes et que ces sous-lignes aient des lignes enfants dont quelques-unes sont ouvertes. Dans ce cas, la détermination de l'index de la prochaine ligne sœur prendrait du temps dans certaines implémentations.</p> -<h4 id="Exemple_d.27une_vue_personnalis.C3.A9e_hi.C3.A9rarchique" name="Exemple_d.27une_vue_personnalis.C3.A9e_hi.C3.A9rarchique">Exemple d'une vue personnalisée hiérarchique</h4> -<p>Voyons tous ces points dans un exemple simple qui construit un arbre à partir d'un tableau. Cet arbre ne supporte qu'un niveau parent avec un seul niveau enfant, mais il est possible de l'étendre facilement avec d'autres niveaux. Nous l'examinerons portion par portion.</p> -<pre><window onload="init();" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<tree id="elementList" flex="1"> - <treecols> - <treecol id="element" label="Élément" primary="true" flex="1"/> - </treecols> - <treechildren/> -</tree> - -</window> -</pre> -<p>Nous utilisons un arbre simple qui ne contient pas de données dans <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>. La fonction <code>init</code> est appelée au chargement de la fenêtre pour initialiser l'arbre. Elle définit simplement la vue personnalisée en récupérant l'arbre et en définissant sa propriété <code>view</code>. Nous définirons <code>treeView</code> plus tard.</p> -<pre>function init() { - document.getElementById("elementList").view = treeView; -} -</pre> -<p>La vue d'arbre personnalisée aura besoin d'implémenter un certain nombre de méthodes dont les plus importantes seront examinées individuellement. Cet arbre supporte un seul niveau de parenté avec un niveau enfant interne, mais il peut être étendu pour intégrer sans trop d'effort des niveaux supplémentaires. Tout d'abord, nous définirons deux structures pour conserver les données de l'arbre, la première contiendra une carte relationnelle entre les parents et leurs éventuels enfants, et la seconde contiendra un tableau des lignes visibles. Souvenez-vous qu'une vue doit conserver elle-même une trace des lignes visibles.</p> -<pre>var treeView = { - childData : { - Solids: ["Argent", "Or", "Plomb"], - Liquids: ["Mercure"], - Gases: ["Hélium", "Azote"] - }, - - visibleData : [ - ["Solides", true, false], - ["Liquides", true, false], - ["Gaz", true, false] - ], -</pre> -<p>La structure <code>childData</code> contient un tableau des enfants pour chacun des trois nœuds parents. Le tableau <code>visibleData</code> commence avec seulement trois items visibles, les trois items de haut niveau. Des items seront ajoutés et supprimés depuis ce tableau quand les items sont ouverts ou fermés. Le principe est le suivant : lorsqu'une ligne parente est ouverte, ses enfants sont récupérés depuis la carte <code>childData</code> et insérés dans le tableau <code>visibleData</code>. Par exemple, si la ligne 'Liquides' est ouverte, son enfant unique dans le tableau <code>childData</code>, l'enfant 'Mercure', sera inséré dans le tableau <code>visibleData</code> après 'Liquides' mais avant 'Gaz'. La taille du tableau sera incrémentée de un. Les deux valeurs booléennes présentes dans chaque ligne dans la structure <code>visibleData</code> indiquent respectivement si une ligne est un conteneur et si elle est ouverte. Évidemment, le nouvel enfant inséré aura ces deux valeurs initialisées à 'false'.</p> -<h4 id="Impl.C3.A9mentation_de_l.27interface_de_vue_d.27arbre" name="Impl.C3.A9mentation_de_l.27interface_de_vue_d.27arbre">Implémentation de l'interface de vue d'arbre</h4> -<p>Ensuite, nous avons besoin d'implémenter l'interface de vue de l'arbre. Tout d'abord, les fonctions simples :</p> -<pre> treeBox: null, - selection: null, - - get rowCount() { return this.visibleData.length; }, - setTree: function(treeBox) { this.treeBox = treeBox; }, - getCellText: function(idx, column) { return this.visibleData[idx][0]; }, - isContainer: function(idx) { return this.visibleData[idx][1]; }, - isContainerOpen: function(idx) { return this.visibleData[idx][2]; }, - isContainerEmpty: function(idx) { return false; }, - isSeparator: function(idx) { return false; }, - isSorted: function() { return false; }, - isEditable: function(idx, column) { return false; }, -</pre> -<p>La fonction <code>rowCount</code> retournera la taille du tableau <code>visibleData</code>. Notez qu'elle devrait retourner le nombre courant de lignes <em>visibles</em>, pas le nombre <em>total</em> de lignes. Donc, au début, seulement trois items sont visibles et la valeur retournée par <code>rowCount</code> devrait être trois, même si six lignes sont cachées.</p> -<p>La fonction <code>setTree</code> sera appelée pour définir l'objet boîte de l'arbre. L'objet boîte de l'arbre est un type spécialisé d'objet boîte propre aux arbres qui sera examiné en détail dans la prochaine section. Il est utilisé pour aider à la représentation graphique de l'arbre. Dans cet exemple, nous avons seulement besoin d'une fonction de l'objet boîte capable de redessiner l'arbre quand des items sont ajoutés ou supprimés.</p> -<p>Les fonctions <code>getCellText</code>, <code>isContainer</code> et <code>isContainerOpen</code> retournent juste l'élément correspondant dans le tableau <code>visibleData</code>. Enfin, les fonctions restantes peuvent retourner 'false' puisque nous n'avons pas besoin de leurs fonctionnalités. Si nous avions eu des lignes parents sans enfant, nous aurions implémenté la fonction <code>isContainerEmpty</code> pour quelle retourne 'true' pour ces éléments.</p> -<pre> getParentIndex: function(idx) { - if (this.isContainer(idx)) return -1; - for (var t = idx - 1; t >= 0 ; t--) { - if (this.isContainer(t)) return t; - } - }, -</pre> -<p>La fonction <code>getParentIndex</code> sera nécessaire pour retourner l'index du parent d'un item donné. Dans notre exemple simple, il y a seulement deux niveaux d'imbrication, donc nous savons que les conteneurs n'ont pas de parents, la valeur '-1' est retournée pour ces items. Dans le cas contraire, nous devons parcourir les lignes en arrière pour rechercher celle qui est un conteneur. Ensuite, la fonction <code>getLevel</code>.</p> -<pre> getLevel: function(idx) { - if (this.isContainer(idx)) return 0; - return 1; - }, -</pre> -<p>La fonction <code>getLevel</code> est simple. Elle retourne juste '0' pour une ligne conteneur et '1' pour une ligne non-conteneur. Si nous voulions ajouter un niveau d'imbrication supplémentaire, ces lignes enfants auraient un niveau de '2'.</p> -<pre> hasNextSibling: function(idx, after) { - var thisLevel = this.getLevel(idx); - for (var t = idx + 1; t < this.visibleData.length; t++) { - var nextLevel = this.getLevel(t) - if (nextLevel == thisLevel) return true; - else if (nextLevel < thisLevel) return false; - } - }, -</pre> -<p>La fonction <code>hasNextSibling</code> doit retourner 'true' quand une ligne donnée est suivie d'une ligne de même niveau (une sœur). Le code ci-dessus utilise une méthode basique qui consiste à parcourir les lignes après celle donnée, en retournant 'true' si une ligne de même niveau est trouvée et 'false' si une ligne de niveau inférieur est rencontrée. Dans cet exemple simple, cette méthode est bonne, mais un arbre avec davantage de données aura besoin d'utiliser une méthode optimisée pour déterminer s'il existe une ligne suivante sœur.</p> -<h4 id="Ouverture_ou_fermeture_d.27une_ligne" name="Ouverture_ou_fermeture_d.27une_ligne">Ouverture ou fermeture d'une ligne</h4> -<p>La dernière fonction est <code>toggleOpenState</code>. C'est la plus complexe. Elle a besoin de modifier le tableau <code>visibleData</code> lorsqu'une ligne est ouverte ou fermée.</p> -<pre> toggleOpenState: function(idx) { - var item = this.visibleData[idx]; - if (!item[1]) return; - - if (item[2]) { - item[2] = false; - - var thisLevel = this.getLevel(idx); - var deletecount = 0; - for (var t = idx + 1; t < this.visibleData.length; t++) { - if (this.getLevel(t) > thisLevel) deletecount++; - else break; - } - if (deletecount) { - this.visibleData.splice(idx + 1, deletecount); - this.treeBox.rowCountChanged(idx + 1, -deletecount); - } - } - else { - item[2] = true; - - var label = this.visibleData[idx][0]; - var toinsert = this.childData[label]; - for (var i = 0; i < toinsert.length; i++) { - this.visibleData.splice(idx + i + 1, 0, [toinsert[i], false]); - } - this.treeBox.rowCountChanged(idx + 1, toinsert.length); - } - }, -</pre> -<p>D'abord nous vérifions si la ligne est un conteneur. Si elle ne l'est pas, la fonction retourne juste que les non-conteneurs ne peuvent pas être ouverts ou fermés. Comme le troisième élément du tableau (celui avec l'index 2) indique si une ligne est ouverte ou fermée, nous utilisons deux blocs de code, le premier pour fermer une ligne et le second pour ouvrir une ligne. Examinons chaque bloc de code, mais en commençant par le second, chargé d'ouvrir une ligne.</p> -<pre> item[2] = true; - - var label = this.visibleData[idx][0]; - var toinsert = this.childData[label]; - for (var i = 0; i < toinsert.length; i++) { - this.visibleData.splice(idx + i + 1, 0, [toinsert[i], false]); - } - this.treeBox.rowCountChanged(idx + 1, toinsert.length); -</pre> -<p>La première ligne de code définit la ligne item comme étant ouverte dans le tableau, ainsi le prochain appel de la fonction <code>toggleOpenState</code> saura qu'elle doit fermer la ligne. Ensuite, regardons les données pour la ligne dans la carte <code>childData</code>. Le résultat est que la variable 'toinsert' sera définie avec un des tableaux enfants, par exemple '["Argent", "Or", "Plomb"]' si la ligne 'Solides' est celle qu'on demande d'ouvrir. Ensuite, nous utilisons la fonction de tableau <code>splice</code> pour insérer une nouvelle ligne pour chaque item. Pour 'Solides', trois items seront insérés.</p> -<p>Enfin, la fonction de boîte d'arbre <code>rowCountChanged</code> a besoin d'être appelée. Rappelez-vous que l'objet <code>treeBox</code> est un objet de boîte d'arbre qui a été défini plus tôt par un appel de la fonction <code>setTree</code>. L'objet de boîte d'arbre sera créé par l'arbre pour vous et vous pourrez appeler ses fonctions. Dans ce cas, nous utilisons la fonction <code>rowCountChanged</code> pour informer l'arbre que quelques lignes de données ont été ajoutées. L'arbre redessinera son contenu avec pour résultat que les lignes enfants apparaîtront à l'intérieur du conteneur. Les autres fonctions implémentées ci-dessus, telles que <code>getLevel</code> et <code>isContainer</code>, sont utilisées par l'arbre pour déterminer son affichage.</p> -<p>La fonction <code>rowCountChanged</code> prend deux arguments, l'index de la ligne où doit se faire l'insertion et le nombre de lignes à insérer. Dans le code ci-dessus nous indiquons que la ligne de départ est la valeur de 'idx' + 1, elle sera la première ligne enfant sous le parent. L'arbre utilisera cette information et ajoutera l'espace nécessaire pour le nombre approprié de lignes en poussant les lignes suivantes vers le bas. Assurez-vous de fournir le nombre correct, ou l'arbre pourrait se redessiner incorrectement ou essayer de dessiner plus de lignes que nécessaire.</p> -<p>Le code suivant est utilisé pour supprimer des lignes quand une ligne est fermée.</p> -<pre> item[2] = false; - - var thisLevel = this.getLevel(idx); - var deletecount = 0; - for (var t = idx + 1; t < this.visibleData.length; t++) { - if (this.getLevel(t) > thisLevel) deletecount++; - else break; - } - if (deletecount) { - this.visibleData.splice(idx + 1, deletecount); - this.treeBox.rowCountChanged(idx + 1, -deletecount); - } -</pre> -<p>Premièrement, l'item est déclaré fermé dans le tableau. Ensuite, nous scannons les lignes suivantes jusqu'à ce que nous atteignions une ligne de même niveau. Toutes celles qui ont un niveau supérieur auront besoin d'être supprimées, mais une ligne de même niveau sera le prochain conteneur qui ne devra pas être supprimé.</p> -<p>Enfin, nous utilisons la fonction <code>splice</code> pour supprimer les lignes du tableau <code>visibleData</code> et appelons la fonction <code>rowCountChanged</code> pour redessiner l'arbre. Lors de la suppression des lignes, vous aurez besoin de fournir un chiffre négatif correspondant au nombre de lignes à supprimer.</p> -<h4 id="Exemple_en_entier" name="Exemple_en_entier">Exemple en entier</h4> -<p>Il existe plusieurs autres fonctions de vue pouvant être implémentées mais nous n'en avons pas l'utilité dans cet exemple, donc nous créons des fonctions qui ne font rien ici. Elles sont placées à la fin de notre exemple complet :</p> -<pre><?xml version="1.0" encoding="iso-8859-1?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<window onload="init();" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<tree id="elementList" flex="1"> - <treecols> - <treecol id="element" label="Élément" primary="true" flex="1"/> - </treecols> - <treechildren/> -</tree> - -<script> -<![CDATA[ - -var treeView = { - childData : { - Solids: ["Argent", "Or", "Plomb"], - Liquids: ["Mercure"], - Gases: ["Hélium", "Azote"] - }, - - visibleData : [ - ["Solides", true, false], - ["Liquides", true, false], - ["Gaz", true, false] - ], - - treeBox: null, - selection: null, - - get rowCount() { return this.visibleData.length; }, - setTree: function(treeBox) { this.treeBox = treeBox; }, - getCellText: function(idx, column) { return this.visibleData[idx][0]; }, - isContainer: function(idx) { return this.visibleData[idx][1]; }, - isContainerOpen: function(idx) { return this.visibleData[idx][2]; }, - isContainerEmpty: function(idx) { return false; }, - isSeparator: function(idx) { return false; }, - isSorted: function() { return false; }, - isEditable: function(idx, column) { return false; }, - - getParentIndex: function(idx) { - if (this.isContainer(idx)) return -1; - for (var t = idx - 1; t >= 0 ; t--) { - if (this.isContainer(t)) return t; - } - }, - getLevel: function(idx) { - if (this.isContainer(idx)) return 0; - return 1; - }, - hasNextSibling: function(idx, after) { - var thisLevel = this.getLevel(idx); - for (var t = idx + 1; t < this.visibleData.length; t++) { - var nextLevel = this.getLevel(t) - if (nextLevel == thisLevel) return true; - else if (nextLevel < thisLevel) return false; - } - }, - toggleOpenState: function(idx) { - var item = this.visibleData[idx]; - if (!item[1]) return; - - if (item[2]) { - item[2] = false; - - var thisLevel = this.getLevel(idx); - var deletecount = 0; - for (var t = idx + 1; t < this.visibleData.length; t++) { - if (this.getLevel(t) > thisLevel) deletecount++; - else break; - } - if (deletecount) { - this.visibleData.splice(idx + 1, deletecount); - this.treeBox.rowCountChanged(idx + 1, -deletecount); - } - } - else { - item[2] = true; - - var label = this.visibleData[idx][0]; - var toinsert = this.childData[label]; - for (var i = 0; i < toinsert.length; i++) { - this.visibleData.splice(idx + i + 1, 0, [toinsert[i], false]); - } - this.treeBox.rowCountChanged(idx + 1, toinsert.length); - } - }, - - getImageSrc: function(idx, column) {}, - getProgressMode : function(idx,column) {}, - getCellValue: function(idx, column) {}, - cycleHeader: function(col, elem) {}, - selectionChanged: function() {}, - cycleCell: function(idx, column) {}, - performAction: function(action) {}, - performActionOnCell: function(action, index, column) {}, - getRowProperties: function(idx, column, prop) {}, - getCellProperties: function(idx, column, prop) {}, - getColumnProperties: function(column, element, prop) {}, -}; - -function init() { - document.getElementById("elementList").view = treeView; -} - -]]></script> - -</window> -</pre> -<hr> -<p>Ensuite, nous verrons plus en détails l'objet de boîte d'arbre.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Vues_d'arbre_personnalisées" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes_des_arbres">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/exemple_xbl/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/exemple_xbl/index.html deleted file mode 100644 index b8b61c00ae..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/exemple_xbl/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Exemple XBL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Exemple_XBL -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XBL_Example ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Héritage_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Caractéristiques_d'une_fenêtre">Suivant »</a></p> -</div> - -<p>Cette section va décrire un exemple d'élément XBL.</p> - -<h3 id="Un_.C3.A9l.C3.A9ment_de_diaporama" name="Un_.C3.A9l.C3.A9ment_de_diaporama">Un élément de diaporama</h3> - -<p>Construisons un exemple complet d'un élément XBL. Il s'agira de créer un élément graphique qui stocke un paquet d'objets, en les affichant un par un. Des boutons de navigation situés sur le bas permettront à l'utilisateur d'afficher les objets les uns aprés les autres tandis qu'un élément graphique textuel entre les boutons affichera le numéro de la page courante. Vous pourriez mettre n'importe quoi dans les pages, cependant, cet élément graphique pourrait être utile pour afficher une série d'images. Nous l'appellerons <em>élément de diaporama</em>.</p> - -<h4 id="Contenu_du_diaporama" name="Contenu_du_diaporama">Contenu du diaporama</h4> - -<p>Tout d'abord, déterminons quels sont les éléments qui ont besoin d'aller dans le contenu XBL. Puisque nous voulons un changement de page, un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code> sera le plus approprié pour contenir les pages. Le contenu des pages sera spécifié dans le fichier XUL, et non dans XBL, mais nous aurons besoin de l'ajouter au sein du paquet (deck). La balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#children">children</a></code> devra être utilisée. En bas, nous aurons besoin d'un bouton pour aller à la page précédente, d'un élément graphique pour afficher la numéro de la page courante, et d'un bouton pour aller à la page suivante.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblex_1.xml.txt">Source</a></p> - -<pre><binding id="slideshow"> - <content> - <xul:vbox flex="1"> - <xul:deck xbl:inherits="selectedIndex" selectedIndex="0" flex="1"> - <children/> - </xul:deck> - <xul:hbox> - <xul:button xbl:inherits="label=previoustext"/> - <xul:label flex="1"/> - <xul:button xbl:inherits="label=nexttext"/> - </xul:hbox> - </xul:vbox> - </content> -</binding> -</pre> - -<p>Cette liaison crée la stucture de la présentation que nous souhaitons. L'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> a été ajouté à plusieurs éléments pour qu'ils s'étendent de la bonne manière. Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sur les deux boutons héritent des valeurs de l'élément qui leur est attaché. Ici, ils héritent de deux attributs personnalisés, <code>previoustext</code> et <code>nexttext</code>. Ils rendent le changement des libellés des boutons simple. Les fils de l'élément auquel l'élément XBL est relié seront placés au sein de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code>. L'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> est hérité par le paquet, ainsi nous pouvons déclarer la page initiale dans XUL.</p> - -<p>Le fichier XUL suivant produit le résultat affiché dans l'image.</p> - -<pre><box class="slideshow" previoustext="Précédent" nexttext="Suivant" flex="1"> - <button label="Bouton 1"/> - <checkbox label="Case à cocher 2"/> - <textbox/> -</box> -</pre> - -<p>Le style CSS utilisé ici est :</p> - -<pre>.slideshow { - -moz-binding: url("slideshow.xml#slideshow"); -} -</pre> - -<div class="float-right"><img alt="Image:xultu_xblex1.jpg" class="internal" src="/@api/deki/files/1568/=Xultu_xblex1.jpg"></div> - -<p>Le premier bouton, 'Bouton 1' a été utilisé comme première page du paquet. L'élément graphique <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> n'est pas apparu puisqu'aucun attribut <code>value</code> ne lui a été spécifié. Nous pourrions déclarer une valeur, mais elle sera plutôt calculée plus tard.</p> - -<h4 id="Propri.C3.A9t.C3.A9_page" name="Propri.C3.A9t.C3.A9_page">Propriété <code>page</code></h4> - -<p>Ensuite, une propriété contenant le numéro de la page courante est ajoutée. Pour lire cette propriété personnalisée, il est nécessaire de rechercher la valeur de l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> du paquet qui contient le numéro de la page affichée. De même, lorsqu'on modifiera cette propriété, il sera nécessaire de changer l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> du paquet. De plus, l'élément graphique textuel devra être mis à jour pour afficher le numéro de la page courante.</p> - -<pre><property name="page" - onget="return parseInt(document.getAnonymousNodes(this)[0].childNodes[0].getAttribute('selectedIndex'));" - onset="this.setPage(val);"/> -</pre> - -<p>La propriété <code>page</code> obtient sa valeur en observant le premier élément du tableau anonyme. Elle renvoie la boîte verticale, donc, pour obtenir le paquet, nous devons obtenir le premier nœud fils de la boîte. Le tableau anonyme n'est pas utilisé puisque le paquet n'est pas anonyme à partir de la boîte. Finalement, la valeur de l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> est récupérée. Pour spécifier la page, une méthode <code>setPage</code> qui sera définie plus tard est appelée.</p> - -<p>Un gestionnaire <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code> devra être ajouté aux boutons 'Précédent' et 'Suivant' pour que la page soit changée lorsque les boutons sont pressés. Nous pouvons changer facilement la page en utilisant la propriété personnalisée <code>page</code> qui vient d'être ajoutée :</p> - -<pre><xul:button xbl:inherits="label=previoustext" - oncommand="parentNode.parentNode.parentNode.page--;"/> -<xul:description flex="1"/> -<xul:button xbl:inherits="label=nexttext" - oncommand="parentNode.parentNode.parentNode.page++;"/> -</pre> - -<p>Étant donné que la propriété <code>page</code> est dans l'élément XUL externe, nous devons utiliser la propriété <code>parentNode</code> pour l'obtenir. La première propriété <code>parentNode</code> retourne l'élément parent du bouton qui est la boîte horizontale, la seconde son parent, la boîte verticale, et la dernière son parent qui est la boîte externe. La propriété <code>page</code> est incrémentée ou décrémentée. Elle va appeler le script <code>onget</code> pour obtenir la valeur, incrémentera ou décrémentera la valeur, et enfin appellera le gestionnaire <code>onset</code> pour enregistrer la valeur.</p> - -<h4 id="M.C3.A9thode_setPage" name="M.C3.A9thode_setPage">Méthode <code>setPage</code></h4> - -<p>Définissons à présent la méthode <code>setPage</code>. Elle prendra un paramètre, le numéro de page qui sert à spécifier la page. Il sera nécessaire de vérifier que le numéro de page n'est pas en dehors des limites et ensuite modifier les attributs <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> du paquet et l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> de l'élément graphique textuel.</p> - -<pre><method name="setPage"> - <parameter name="newidx"/> - <body> - <![CDATA[ - var thedeck=document.getAnonymousNodes(this)[0].childNodes[0]; - var totalpages=this.childNodes.length; - - if (newidx<0) return 0; - if (newidx>=totalpages) return totalpages; - thedeck.setAttribute("selectedIndex",newidx); - document.getAnonymousNodes(this)[0].childNodes[1].childNodes[1] - .setAttribute("value",(newidx+1)+" of "+totalpages); - return newidx; - ]]> - </body> -</method> -</pre> - -<p>Cette fonction est appelée <code>setPage</code> et prend un paramètre <code>newidx</code>. Le corps de la méthode a été encapsulé entre '<![CDATA[' et ']]>'. C'est le mécanisme général dans tous les fichiers XML qui peut être utilisé pour échapper tout le texte à l'intérieur. De cette manière, vous n'avez pas besoin d'échapper tous les signes "inférieur" et "supérieur" à l'intérieur.</p> - -<p>Décomposons le code morceau par morceau.</p> - -<dl> - <dt><code>var thedeck=document.getAnonymousNodes(this)[0].childNodes[0];</code></dt> - <dd>Récupère le premier élément du tableau de contenu anonyme qui sera la boîte verticale, puis obtient son premier fils qui sera le paquet <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code>.</dd> - <dt><code>var totalpages=this.childNodes.length;</code></dt> - <dd>Récupère le nombre de fils que détient la boîte qui est liée. Cela donnera le nombre total de pages qui s'y trouve.</dd> - <dt><code>if (newidx<0) return 0;</code></dt> - <dd>Si le nouvel index est avant la première page, ne pas changer la page et retourner '0'. La page ne devrait pas donner une valeur plus petite que la première page.</dd> - <dt><code>if (newidx>=totalpages) return totalpages;</code></dt> - <dd>Si le nouvel index est après la dernière page, ne pas changer la page et retourner le dernier index de page. La page ne devrait pas devenir celle qui est après la dernière.</dd> - <dt><code>thedeck.setAttribute("selectedIndex",newidx);</code></dt> - <dd>Changer l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code> du paquet. Cela entraîne l'affichage de la page demandée.</dd> - <dt><code>document.getAnonymousNodes(this)[0].childNodes[1].childNodes[1].setAttribute("value", (newidx+1)+" sur "+totalpages);</code></dt> - <dd>Cette ligne modifie l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> pour qu'il affiche l'index de la page courante. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> peut être récupéré en obtenant le premier élément du contenu anonyme (la boîte verticale), le second fils de cet élément (la boîte horizontale), et enfin le second élément de cette boîte. L'attribut <code>value</code> est modifié pour indiquer '1 sur 3' ou quelque chose de similaire. Notez que l'index est incrémenté de un parce que les indices commence à '0'.</dd> -</dl> - -<h4 id="Constructeur" name="Constructeur">Constructeur</h4> - -<p>Nous allons aussi avoir besoin d'un constructeur pour initialiser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> afin qu'il s'affiche correctement la première fois que la présentation est affichée. Nous utilisons un code similaire à la méthode ci-dessus pour déclarer le numéro de page. La référence à 'this.page' va appeler le script <code>onget</code> de la propriété <code>page</code> qui à son tour va recupérer la page initiale à partir de l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code>.</p> - -<pre><constructor> - var totalpages=this.childNodes.length; - document.getAnonymousNodes(this)[0].childNodes[1].childNodes[1] - .setAttribute("value",(this.page+1)+" of "+totalpages); -</constructor> -</pre> - -<h4 id="Fonctionnalit.C3.A9s_suppl.C3.A9mentaires" name="Fonctionnalit.C3.A9s_suppl.C3.A9mentaires">Fonctionnalités supplémentaires</h4> - -<p>Nous pouvons aussi ajouter quelques caractéristiques supplémentaires. Certains raccourcis claviers peuvent être utilisés pour les boutons 'Précédent' et 'Suivant', (disons l'effacement arrière et la touche Entrée). Des boutons 'Premier' et 'Dernier' peuvent être ajoutés pour aller à la première et à la dernière page. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> pourrait être transformé en un champ de saisie où l'utilisateur pourrait entrer la page à afficher, ou une fenêtre surgissante pourrait être ajoutée pour permettre la sélection de la page à partir d'un menu. Nous pourrions aussi ajouter une bordure autour de la boîte avec un style CSS pour la rendre plus jolie.</p> - -<h4 id="Le_code_final" name="Le_code_final">Le code final</h4> - -<p>Le code final est le suivant :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblex_2.xml.txt">Source</a></p> - -<pre><binding id="slideshow"> - <content> - <xul:vbox flex="1"> - <xul:deck xbl:inherits="selectedIndex" selectedIndex="0" flex="1"> - <children/> - </xul:deck> - <xul:hbox> - <xul:button xbl:inherits="label=previoustext" - oncommand="parentNode.parentNode.parentNode.page--;"/> - <xul:description flex="1"/> - <xul:button xbl:inherits="label=nexttext" - oncommand="parentNode.parentNode.parentNode.page++;"/> - </xul:hbox> - </xul:vbox> - </content> - - <implementation> - - <constructor> - var totalpages=this.childNodes.length; - document.getAnonymousNodes(this)[0].childNodes[1].childNodes[1] - .setAttribute("value",(this.page+1)+" sur "+totalpages); - </constructor> - - <property name="page" - onget="return parseInt(document.getAnonymousNodes(this)[0].childNodes[0].getAttribute('selectedIndex'));" - onset="this.setPage(val);"/> - - <method name="setPage"> - <parameter name="newidx"/> - <body> - <![CDATA[ - var thedeck=document.getAnonymousNodes(this)[0].childNodes[0]; - var totalpages=this.childNodes.length; - - if (newidx<0) return 0; - if (newidx>=totalpages) return totalpages; - thedeck.setAttribute("selectedIndex",newidx); - document.getAnonymousNodes(this)[0].childNodes[1].childNodes[1] - .setAttribute("value",(newidx+1)+" sur "+totalpages); - return newidx; - ]]> - </body> - </method> - </implementation> - -</binding> -</pre> - -<hr> -<p>Nous allons voir ensuite quelques propriétés additionnelles d'une fenêtre.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Héritage_XBL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Caractéristiques_d'une_fenêtre">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/exemples_xpcom/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/exemples_xpcom/index.html deleted file mode 100644 index 50bd44eb6e..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/exemples_xpcom/index.html +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Exemples XPCOM -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Exemples_XPCOM -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XPCOM_Examples ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Interfaces_XPCOM" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Arbres">Suivant »</a></p> -</div> - -<p>Cette section donne quelques exemples d'utilisation de la technologie XPCOM avec de nouvelles interfaces.</p> - -<h3 id="Gestion_de_Fen.C3.AAtres" name="Gestion_de_Fen.C3.AAtres">Gestion de Fenêtres</h3> - -<div class="note">Cet exemple contient une source de données RDF qui sera décrite dans <a href="/fr/Tutoriel_XUL/Gabarits" title="fr/Tutoriel_XUL/Gabarits">une prochaine section</a>. Vous devriez passer cet exemple pour l'instant, à moins d'en savoir suffisamment sur le sujet.</div> - -<h4 id="Cr.C3.A9ation_d.27un_menu_de_fen.C3.AAtre" name="Cr.C3.A9ation_d.27un_menu_de_fen.C3.AAtre">Création d'un menu de fenêtre</h4> - -<p>La liste des fenêtres Mozilla ouvertes peut être utilisée comme <a href="/fr/Tutoriel_XUL/Sources_de_données_RDF" title="fr/Tutoriel_XUL/Sources_de_données_RDF">une source de données RDF</a>. Elle vous permet de créer dans votre application un menu donnant la liste des fenêtres courantes ouvertes. La source de données correspondante est 'rdf:window-mediator' dont voici un exemple d'utilisation :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xpcomex_1.xul.txt">Source</a></p> - -<pre><toolbox> - <menubar id="windowlist-menubar"> - <menu label="Fenêtres"> - <menupopup id="window-menu" datasources="rdf:window-mediator" ref="NC:WindowMediatorRoot"> - <template> - <rule> - <menuitem uri="rdf:*" label="rdf:http://home.netscape.com/NC-rdf#Name"/> - </rule> - </template> - </menupopup> - </menu> - </menubar> -</toolbox> -</pre> - -<p>Un menu contenant la liste de toutes les fenêtres ouvertes sera créé. Essayez cet exemple en ouvrant plusieurs fenêtres, et vous les verrez toutes dans le menu.</p> - -<h4 id="Composant_mediator" name="Composant_mediator">Composant mediator</h4> - -<p>Cet exemple peut être amélioré de telle façon que lorsque l'on clique sur un élément du menu, la fenêtre correspondante soit affichée. Cette tâche sera rendue possible grâce au composant "window mediator" qui implémente l'interface <code>nsIWindowDataSource</code>. Le code suivant montre comment il fonctionne :</p> - -<pre>var wmdata = Components.classes["@mozilla.org/rdf/datasource;1?name=window-mediator"].getService(); -wmdata.QueryInterface(Components.interfaces.nsIWindowDataSource); -</pre> - -<p>Ce code récupère le composant "window mediator". Le composant utilisé ici est le même que celui qui gère la source de données RDF "Window-mediator". Vous pouvez également récupérer ce composant au travers du service RDF qui est un autre service de gestion des sources de données RDF.</p> - -<p>L'interface <a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIWindowDataSource.html">nsIWindowDataSource</a> possède une fonction <code>getWindowForResource</code> qui nous donne une fenêtre à partir d'une ressource. Dans un exemple précédent, nous avons généré une liste de fenêtres que nous avons ajoutée à un menu via une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code>. Celle-ci génère un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> pour chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. La valeur de cet attribut peut être utilisée comme ressource. Ainsi pour donner le focus à la fenêtre sélectionnée, nous pouvons procéder de la manière suivante :</p> - -<ol> - <li>Déterminer l'élément que l'utilisateur a sélectionné.</li> - <li>Récupérer la valeur de l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de cet élément.</li> - <li>Passer cette valeur à <code>getWindowForResource()</code> pour avoir l'objet "window".</li> - <li>Mettre le focus sur celle-ci.</li> -</ol> - -<p>L'exemple ci-dessous nous montre comment procéder :</p> - -<pre><toolbox> - <menubar id="windowlist-menubar"> - <menu label="Fenêtre" oncommand="switchFocus(event.target);"> - <menupopup id="window-menu" datasources="rdf:window-mediator" ref="NC:WindowMediatorRoot"> - <template> - <rule> - <menuitem uri="rdf:*" label="rdf:http://home.netscape.com/NC-rdf#Name"/> - </rule> - </template> - </menupopup> - </menu> - </menubar> -</toolbox> - -<script> -function switchFocus(elem) -{ - var mediator = Components.classes["@mozilla.org/rdf/datasource;1?name=window-mediator"].getService(); - mediator.QueryInterface(Components.interfaces.nsIWindowDataSource); - - var resource = elem.getAttribute('id'); - switchwindow = mediator.getWindowForResource(resource); - - if (switchwindow){ - switchwindow.focus(); - } -} -</script> -</pre> - -<p>Un gestionnaire de commande a été ajouté à l'élément menu. Ce gestionnaire appelle la fonction <code>switchFocus()</code> avec comme paramètre l'élément du menu que nous avons sélectionné. La fonction <code>switchFocus()</code> :</p> - -<ul> - <li>récupère d'abord une référence du composant qui implémente l'interface du "window mediator" (<abbr title="Note du Traducteur">NdT</abbr> : plus exactement <code>nsIWindowDataSource</code> ).</li> - <li>Puis nous récupérons l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément. Nous utilisons cette valeur comme ressource.</li> - <li>La ressource est passée en paramètre à la fonction <code>getWindowForResource()</code> qui renvoie la fenêtre correspondante. Cette fenêtre est stockée dans la variable <code>switchwindow</code> comme objet javascript window.</li> - <li>Par conséquent, toutes les fonctions de cet objet sont utilisables, comme la fonction <code>focus()</code>.</li> -</ul> - -<h3 id="Cookies" name="Cookies">Cookies</h3> - -<p>Maintenant, nous allons récupérer la liste des cookies sauvegardés par le navigateur. Nous allons utiliser le service "Cookie" qui implémente l'interface <code><a class="external" href="http://xulplanet.com/references/xpcomref/ifaces/nsICookieManager.html">nsICookieManager</a></code> utilisée pour énumérer tous les cookies. Voici un exemple qui alimente la liste d'un menu avec le nom de tous les cookies provenant du site MozillaZine.</p> - -<pre><script> - -function getCookies() -{ - var menu = document.getElementById("cookieMenu"); - menu.removeAllItems(); - - var cookieManager = Components.classes["@mozilla.org/cookiemanager;1"] - .getService(Components.interfaces.nsICookieManager); - - var iter = cookieManager.enumerator; - while (iter.hasMoreElements()){ - var cookie = iter.getNext(); - if (cookie instanceof Components.interfaces.nsICookie){ - if (cookie.host == "www.mozillazine.org") - menu.appendItem(cookie.name,cookie.value); - } - } -} -</script> - -<hbox> - <menulist id="cookieMenu" onpopupshowing="getCookies();"/> -</hbox> -</pre> - -<p>La fonction <code>getCookies()</code> sera appelée à chaque ouverture du menu, comme indiqué par l'attribut <code id="a-onpopupshowing"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onpopupshowing">onpopupshowing</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>. Les deux premières lignes de <code>getCookies()</code> récupèrent l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> et suppriment tous les items existants. En effet comme cette fonction est appelée à chaque fois que nous l'ouvrons, nous ne voulons pas garder les anciens éléments.</p> - -<p>Ensuite, le gestionnaire de cookie est récupéré. Celui-ci a une méthode qui renvoie un objet énumérateur implémentant <code><a href="/fr/NsISimpleEnumerator" title="fr/NsISimpleEnumerator">nsISimpleEnumerator</a></code>. Il nous permet de parcourir tous les cookies. Un énumérateur dispose d'une méthode <code>hasMoreElements()</code> retournant 'true' jusqu'à ce que le dernier cookie soit récupéré. La méthode <code>getNext()</code> renvoie un cookie et incrémente l'index de l'énumérateur. Comme l'énumérateur ne renvoie qu'un objet générique, nous devons lui indiquer que nous voulons utiliser l'interface <code><a class="external" href="http://xulplanet.com/references/xpcomref/ifaces/nsICookie.html">nsICookie</a></code>. Dans ce cas, l'opérateur <code>instanceof</code> permet d'accomplir cette vérification.</p> - -<p>Finalement, un élément est ajouté au menu pour chaque cookie ( <abbr title="Note du Traducteur">NdT</abbr> : dont le site hôte est "www.mozillazine.org"). Les propriétés hôte, nom et valeur du cookie sont alors utilisées. Les menus ont une fonction <code>appendItem()</code> qui ajoute un élément avec un libellé et une valeur.</p> - -<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3> - -<p>D'autres exemples sont disponibles ici :</p> - -<ul> - <li><a href="/fr/Extraits_de_code" title="fr/Extraits_de_code">Extraits de code</a></li> - <li><a class="external" href="http://kb.mozillazine.org/Category:XPCOM_example_code">Exemples de code XPCOM sur Mozillazine</a></li> -</ul> - -<hr> -<p>Dans la section suivante, nous allons voir comment utiliser le presse papier.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Interfaces_XPCOM" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Utilisation_du_presse_papiers">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/focus_et_selection/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/focus_et_selection/index.html deleted file mode 100644 index 84e67cec8b..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/focus_et_selection/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Focus et Selection -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Focus_et_Selection -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Focus_and_Selection ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Raccourcis_clavier" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Commandes">Suivant »</a></p> -</div> -<p>Cette section va décrire comment manipuler le focus et la sélection des éléments.</p> -<h3 id=".C3.89l.C3.A9ments_focalis.C3.A9s" name=".C3.89l.C3.A9ments_focalis.C3.A9s">Éléments focalisés</h3> -<p>L'élément focalisé est l'élément qui reçoit les événements entrants. S'il y a trois champs de saisie sur une fenêtre, celui qui détient le focus est celui dans lequel l'utilisateur peut taper du texte. Un seul élément à la fois peut détenir le focus.</p> -<p>L'utilisateur peut changer le focus en cliquant sur un élément avec la souris ou en appuyant sur la touche <code>Tab</code> (tabulation). Lorsque la touche tabulation est appuyée, le focus passe à l'élément suivant. Pour revenir en arrière, il suffit d'appuyer sur les touches <code>Maj</code> (shift) et <code>Tab</code> simultanément.</p> -<h4 id="R.C3.A9arrangement_de_l.27ordre_des_tabulations" name="R.C3.A9arrangement_de_l.27ordre_des_tabulations">Réarrangement de l'ordre des tabulations</h4> -<p>Vous pouvez changer l'ordre dans lequel les éléments seront focalisés quand l'utilisateur appuiera sur la touche <code>Tab</code> en ajoutant un attribut <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code> à un élément. Cet attribut doit être renseigné avec un nombre. Lorsque l'utilisateur appuiera sur la touche <code>Tab</code>, le focus sera donné à l'élément ayant l'index de tabulation consécutif le plus haut. Cela implique que vous pouvez ordonner les éléments en définissant des indices pour séquencer les éléments. Toutefois, vous n'aurez normalement pas à définir l'attribut <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code>. Dans ce cas, un appui sur la touche tabulation donnera le focus à l'élément suivant affiché. Vous avez seulement besoin de définir des indices de tabulation si vous voulez utiliser un ordre différent. Voici un exemple :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_1.xul">Voir</a></p> -<pre><button label="Bouton 1" tabindex="2"/> -<button label="Bouton 2" tabindex="1"/> -<button label="Bouton 3" tabindex="3"/> -</pre> -<h4 id="L.27.C3.A9v.C3.A9nement_focus" name="L.27.C3.A9v.C3.A9nement_focus">L'événement focus</h4> -<p>L'événement 'focus' est utilisé pour réagir lorsqu'un élément obtient le focus. L'événement 'blur' est utilisé pour réagir lorsqu'un un élément perd le focus. Vous pouvez réagir aux changements de focus en ajoutant un attribut <code><a href="/fr/DOM/element.onfocus" title="fr/DOM/element.onfocus">onfocus</a></code> ou <code><a href="/fr/DOM/element.onblur" title="fr/DOM/element.onblur">onblur</a></code> à un élément. Ils fonctionnent de la même façon que leurs homologues HTML. Vous pouvez utiliser ces événements pour mettre un élément en surbrillance ou afficher un texte dans la barre d'état. L'exemple suivant peut s'appliquer à une fonction de gestion des événements de focus.</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_2.xul">Voir</a></p> -<pre><script> - -function displayFocus(){ - var elem=document.getElementById('sbar'); - elem.setAttribute('value','Entrez votre numéro de téléphone.'); -} - -</script> - -<textbox id="tbox1"/> -<textbox id="tbox2" onfocus="displayFocus();"/> -<description id="sbar" value=""/> -</pre> -<p>Quand l'événement 'focus' est déclenché, il va appeler la fonction <code>displayFocus</code>. Cette fonction va changer la valeur du libellé texte. Nous pourrions développer cet exemple pour effacer le texte quand l'événement 'blur' a lieu. Généralement, vous utiliserez les événements focus et blur pour mettre à jour certaines parties de votre interface, quand l'utilisateur sélectionne des éléments. Par exemple, vous pouvez mettre à jour un total quand l'utilisateur entre des valeurs dans d'autres champs, ou utiliser les événements de focus pour vérifier certaines valeurs. N'affichez pas de messages d'alerte pendant un événement focus ou blur, car ils pourraient distraire l'utilisateur et ils dégradent le design de l'interface.</p> -<p>Vous pouvez aussi ajouter dynamiquement des gestionnaires d'événements en utilisant la fonction DOM <code><a href="/fr/DOM/element.addEventListener" title="fr/DOM/element.addEventListener">addEventListener</a></code>. Vous pouvez l'utiliser pour n'importe quel élément et type d'événement. Elle prend trois paramètres : le type d'événement, une fonction à exécuter quand l'événement est produit et un booléen indiquant la phase de capture de l'événement.</p> -<h4 id="Obtention_de_l.27.C3.A9l.C3.A9ment_actuellement_focalis.C3.A9" name="Obtention_de_l.27.C3.A9l.C3.A9ment_actuellement_focalis.C3.A9">Obtention de l'élément actuellement focalisé</h4> -<p>L'élément ayant le focus est pris en charge par un objet appelé « répartiteur de commandes », dont il ne peut y avoir qu'une instance par fenêtre. Le répartiteur de commandes garde la trace de l'objet qui a le focus pendant que l'utilisateur se sert de l'interface. Le répartiteur de commandes a d'autres rôles, qui seront abordés <a href="/fr/Tutoriel_XUL/Commandes" title="fr/Tutoriel_XUL/Commandes">plus tard dans la section des commandes</a>. Pour le moment, nous allons nous intéresser à quelques fonctions relatives au focus du répartiteur de commandes.</p> -<p>Vous pouvez récupérer le répartiteur de commandes d'une fenêtre en utilisant la propriété <code>commandDispatcher</code> du document. À partir de là, vous pouvez obtenir l'élément focalisé avec la propriété <code>focusedElement</code> du répartiteur. L'exemple ci-dessous illustre ce cas.</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_3.xul">Voir</a></p> -<pre><window id="focus-example" title="Exemple Focus" - onload="init();" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<script> -function init(){ - addEventListener("focus",setFocusedElement,true); -} - -function setFocusedElement(){ - var focused = document.commandDispatcher.focusedElement; - document.getElementById("focused").value = focused.tagName; -} -</script> - -<hbox> - <label control="username" value="Nom d'utilisateur:"/> - <textbox id="username"/> -</hbox> - -<button label="Bonjour"/> -<checkbox label="Se souvenir de ce choix"/> - -<label id="focused" value="-pas de focus-"/> - -</window> -</pre> -<p>Dans cet exemple, un gestionnaire d'événement de focus est attaché à la fenêtre. Nous voulons utiliser un gestionnaire de capture d'événements, donc la méthode <code><a href="/fr/DOM/element.addEventListener" title="fr/DOM/element.addEventListener">addEventListener</a></code> doit être utilisée. Elle associe un gestionnaire de capture d'événements à la fenêtre qui appellera la méthode <code>setFocusedElement</code>. Cette méthode récupère l'élément focalisé depuis le répartiteur de commandes et modifie un libellé avec le nom de sa balise. Quand l'élément focalisé change, le libellé montre le nom de l'élément.</p> -<p>Plusieurs choses sont à noter :</p> -<ul> <li>Premièrement, quand le champ de saisie est focalisé, le nom de la balise est 'html:input', et non 'textbox' comme on aurait pu s'y attendre. C'est parce que les champs de saisie XUL sont implémentés avec le composant HTML 'input', donc l'événement focus est en fait reçu pour cet élément.</li> <li>Deuxièmement, un clic sur le libellé du champ de saisie donne le focus au champ de saisie. C'est parce que le libellé possède un attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code> pointant vers l'id du champ de saisie.</li> <li>Enfin, l'autre libellé qui affiche la propriété nom n'a pas d'attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code>, donc un clic dessus n'affecte pas l'élément focalisé. Seuls les éléments focalisables peuvent être focalisés.</li> -</ul> -<h4 id="Rendre_un_libell.C3.A9_focalisable" name="Rendre_un_libell.C3.A9_focalisable">Rendre un libellé focalisable</h4> -<p>Si vous créez <a href="/fr/Tutoriel_XUL/Introduction_à_XBL" title="fr/Tutoriel_XUL/Introduction_à_XBL">des éléments personnalisés</a>, vous pouvez décider si un élément peut prendre le focus ou non. Il vous suffit d'utiliser la propriété de style spéciale <code>-moz-user-focus</code>. Cette propriété détermine si un élément peut être focalisé ou non. Par exemple, vous pouvez rendre un libellé focalisable, comme dans l'exemple ci-dessous.</p> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_4.xul">Voir</a></p> -<pre><label id="focused" style="-moz-user-focus: normal;" - onkeypress="alert('Étiquette focalisée');" value="Focalise moi"/> -</pre> -<p>La propriété de style est réglée à 'normal'. Vous pouvez aussi la définir à 'ignore' pour désactiver le focus pour un élément. Toutefois, elle ne doit pas être utilisée pour désactiver un élément ; l'attribut ou la propriété <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> doit être utilisée dans ce cas, car elle a été conçue pour. Dans l'exemple, une fois le libellé focalisé, il peut réagir aux événements du clavier. Évidemment, le libellé ne donne aucune indication sur son focus, car il n'est normalement pas prévue pour cet usage.</p> -<h4 id="Changer_le_focus" name="Changer_le_focus">Changer le focus</h4> -<p>Il existe plusieurs façons de changer d'élément focalisé. La plus simple est d'appeler la méthode <code><a href="/fr/DOM/element.focus" title="fr/DOM/element.focus">focus</a></code> de l'élément XUL que vous voulez focaliser. La méthode <code><a href="/fr/DOM/element.blur" title="fr/DOM/element.blur">blur</a></code> peut être employée afin d'enlever le focus d'un élément. L'exemple suivant met en pratique ces principes :</p> -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_focus_5.xul">Voir</a></p> -<pre><textbox id="addr"/> - -<button label="Focus" oncommand="document.getElementById('addr').focus()"/> -</pre> -<p>Vous pouvez aussi utiliser les méthodes <code>advanceFocus</code> et <code>rewindFocus</code> du répartiteur de commandes. Ces méthodes changent le focus respectivement vers l'élément suivant ou précédent de la séquence de tabulation. Elles correspondent aux actions réalisées lorsque l'utilisateur appuie sur <code>Tab</code> ou <code>Maj</code>+<code>Tab</code>.</p> -<p>Pour les champs de saisie, un attribut spécial, <code id="a-focused"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/focused">focused</a></code> est ajouté quand l'élément obtient le focus. Vous pouvez vérifier la présence de cet attribut pour déterminer si l'élément a le focus, soit depuis un script, soit depuis une feuille de styles. Il aura la valeur 'true' si le champ de saisie a le focus, et le cas échéant, l'attribut ne sera pas présent.</p> -<p>Supposons que vous souhaitez déplacer le focus vers le prochain emplacement connu par le navigateur. pour y arriver, un utilisateur va typiquement appuyer sur la touche <code>Tab</code>. Vous pouvez faire la même chose dès lors que vous disposez d'un document de navigation XUL en faisant :</p> -<pre> document.commandDispatcher.advanceFocus(); -</pre> -<p>En fait, l'objet <code>commandDispatcher</code> implémente simplement l'interface <a href="/fr/Interfaces" title="fr/Interfaces">nsIDOMXULCommandDispatcher</a>. D'autres fonctions peuvent également vous intéressez si vous manipulez des focus.</p> -<h4 id="Comportements_sp.C3.A9cifiques_de_plate-forme" name="Comportements_sp.C3.A9cifiques_de_plate-forme">Comportements spécifiques de plate-forme</h4> -<dl> <dt>Mac OS X </dt> <dd>Il existe une préférence appelée « Full Keyboard Access » (FKA - Accès au clavier complet). XUL respecte ce mécasnisme. Cela signifie que si la préférence FKA est sur 'off', seuls les champs de saisie, les listes et les arbres peuvent recevoir le focus au clavier, ainsi que vos scripts utilisant <code>focus()</code>.</dd> -</dl> -<h3 id="Gestion_des_modifications_de_texte" name="Gestion_des_modifications_de_texte">Gestion des modifications de texte</h3> -<p>Deux événements peuvent être utilisés lorsque l'utilisateur modifie la le contenu d'un champ de saisie. Naturellement, ces événements seront uniquement transmis au champ de saisie ayant le focus.</p> -<ul> <li>L'événement 'input' est transmis chaque fois que le contenu du champ est modifié. La nouvelle valeur sera différente de l'ancienne. Vous devriez utiliser cet événement au lieu d'utiliser les événements clavier, car certaines touches, par exemple <code>Maj</code>, ne modifient pas la valeur. De plus, l'événement 'input' ne se déclenche pas si une touche est enfoncée et s'il y a déjà plus de caractères dans le champ de saisie qu'il ne peut en contenir.</li> <li>L'événement 'change' est similaire dans le sens où il est transmis seulement lorsque le champ est modifié. Cependant, cet événement n'est déclenché qu'au moment où le champ de saisie perd le focus, et seulement si son contenu a été modifié.</li> -</ul> -<h3 id="S.C3.A9lection_de_texte" name="S.C3.A9lection_de_texte">Sélection de texte</h3> -<p>Lorsque vous travaillez avec un champ de saisie, vous pouvez récupérer uniquement le texte que l'utilisateur a sélectionné. Ou alors vous pouvez changer la sélection.</p> -<p>Les champs de saisie XUL offrent la possibilité de récupérer et de modifier une sélection. La plus simple et de sélectionner tout le texte du champ. Cela implique l'utilisation de la méthode <code>select</code> du champ de saisie.</p> -<pre>tbox.select();</pre> -<p>Toutefois, vous pouvez aussi sélectionner seulement une partie du texte. Il vous suffit d'utiliser la fonction <code>setSelectionRange</code>. Elle prend deux paramètres, le premier représente le caractère de départ et le second le caractère suivant le dernier que vous voulez sélectionner. Les valeurs commencent à zéro, donc le premier caractère est indicé à '0', le second à '1' et ainsi de suite.</p> -<pre>tbox.setSelectionRange(4,8);</pre> -<p>Cet exemple va sélectionner le cinquième caractère affiché, ainsi que le sixième, le septième et le huitième. S'il n'y avait que six caractères présents dans le champ, seuls le cinquième et le sixième auraient été sélectionnés. Aucune erreur ne serait signalée.</p> -<p>Si vous utilisez la même valeur pour les deux paramètres, le début et la fin de la sélection changent pour la même position. Le résultat revient à changer la position du curseur dans le champ de saisie. Par exemple, la ligne ci-dessous peut être utilisée pour ramener le curseur au début du texte.</p> -<pre>tbox.setSelectionRange(0,0);</pre> -<p>Vous pouvez récupérer la sélection en cours en utilisant les propriétés <code>selectionStart</code> et <code>selectionEnd</code>. Ces propriétés définissent respectivement le début et la fin de la sélection. Si les deux sont définies à la même valeur, aucun texte n'est sélectionné, mais les valeurs représentent la position du curseur. Une fois que vous avez les valeurs de début et de fin, vous pouvez récupérer la section de chaîne du texte.</p> -<p>Vous pouvez récupérer et modifier le contenu du champ de saisie en utilisant la propriété <code>value</code>.</p> -<p>Une autre propriété utile des champs de saisie est la propriété <code>textLength</code> qui contient le nombre total de caractères dans le champ.</p> -<hr> -<p>Dans la prochaine section, nous découvrirons comment utiliser les commandes.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Raccourcis_clavier" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Commandes">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/fonctions_additionnelles_d'installation/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/fonctions_additionnelles_d'installation/index.html deleted file mode 100644 index 693b2faeca..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/fonctions_additionnelles_d'installation/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Fonctions additionnelles d'installation -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Fonctions_additionnelles_d'installation -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Additional_Install_Features ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_scripts_d'installation" style="float: left;">« Précédent</a><br></p> -</div> - -<div class="note">NdT : Attention, cette section décrit le mécanisme XPInstall propre à la suite Mozilla et à des versions anciennes de Mozilla Firefox. Pour les versions récentes de Mozilla Firefox, ce mode d'installation n'est plus le même, mais il n'est pas encore décrit dans ce tutoriel. Voir <a class="external" href="http://xulfr.org/wiki/ExtensionsFirefox">comment faire des extensions pour firefox</a> sur xulfr.org.</div> - -<p>Cette section décrit quelques spécificités supplémentaires des programmes d'installation.</p> - -<h3 id="Manipulation_de_fichiers_lors_de_l.27installation" name="Manipulation_de_fichiers_lors_de_l.27installation">Manipulation de fichiers lors de l'installation</h3> - -<p>La <a href="/fr/Tutoriel_XUL/Les_scripts_d'installation" title="fr/Tutoriel_XUL/Les_scripts_d'installation">section précédente</a> décrivait un programme d'installation simple. Vous pouvez souhaiter réaliser quelques opérations plus élaborées pendant l'installation. Par exemple, vous voulez installer un paquetage seulement si certaines conditions sont réunies, comme d'avoir une librairie particulière installée.</p> - -<p>En complément de l'objet <code>Install</code>, l'objet <code>File</code> est également disponible pendant le script d'installation. Il fournit quelques fonctions qui peuvent être employées pour examiner et modifier des fichiers sur le disque. Vous pouvez les utiliser pour déplacer, copier ou effacer des fichiers avant ou après que les fichiers du paquetage soient installés. Par exemple, vous voulez peut être faire une sauvegarde de quelques fichiers d'abord.</p> - -<p>Le code ci dessous fera une copie du fichier "/bin/grep" dans le répertoire "/main".</p> - -<pre>var binFolder=getFolder("file:///","bin"); -var grep=getFolder(binFolder,"grep"); - -var mainFolder=getFolder("file:///","main"); - -File.copy(grep,mainFolder); -</pre> - -<ul> - <li>La première ligne va renseigner un pointeur sur le répertoire '/bin'. Le texte 'file:///' est une chaîne de caractères spéciale qui correspond à la racine du système de fichiers.</li> - <li>À partir de ce pointeur, nous récupérons le fichier 'grep' qui se trouve dans le répertoire 'bin'. Si ce fichier n'existe pas, une erreur sera signalée au processus d'installation.</li> - <li>Ensuite, nous pointons sur le répertoire 'main', toujours à partir de la racine du système de fichiers.</li> - <li>Finalement, nous appelons la fonction 'File.copy' qui copie le fichier source vers sa destination.</li> -</ul> - -<p><a class="external" href="http://www.xulplanet.com/references/elemref/ref_File.html">Des fonctions</a> existent également pour déplacer (<code>move()</code>), renommer (<code>rename()</code>) et exécuter (<code>execute()</code>) des fichiers. Ainsi, vous pouvez déplacer des fichiers qui peuvent se trouver en conflit avec votre paquetage.</p> - -<h3 id="Interception_des_erreurs" name="Interception_des_erreurs">Interception des erreurs</h3> - -<p>Vous voulez certainement intercepter d'éventuelles erreurs proprement. Elles peuvent se produire si un fichier ou un répertoire ne peut pas être trouvé, si la capacité du disque n'est pas suffisant ou pour toutes autres raisons.</p> - -<p>Il vous suffit d'appeler la fonction <code>getLastError()</code> pour déterminer si une erreur a été rencontrée. Si elle renvoie 'SUCCESS', aucune erreur ne s'est produite. Autrement, elle renvoie un nombre qui indique le code d'erreur. Vous pouvez appeler cette fonction en tout point de votre script d'installation pour déterminer si une erreur est survenue lors de la dernière opération effectuée.</p> - -<p>Si une erreur se produit, vous voulez sûrement interrompre l'installation. Vous pouvez également vouloir afficher un message d'erreur pour l'utilisateur. Par exemple, vous pourriez mettre le script suivant à la fin de votre script d'installation :</p> - -<pre>if (getLastError() == SUCCESS){ - performInstall(); -} -else { - cancelInstall(); -} -</pre> - -<p>Les codes d'erreurs susceptibles d'être renvoyés par la fonction <code>getLastError()</code> sont listés dans le fichier source de Mozilla <a class="external" href="http://lxr.mozilla.org/mozilla/source/xpinstall/src/nsInstall.h">nsInstall.h</a>. Pendant l'installation, un suivi d'événements contenant les opérations réalisées est créé. Il contiendra également toutes les erreurs qui se sont produites. Ces événements peuvent être trouvés dans le fichier 'install.log' dans le répertoire d'installation de Mozilla. Un bloc de texte sera ajouté à ce fichier à chaque installation effectuée.</p> - -<p>La fonction <code>logComment()</code> peut être utilisée pour écrire un texte dans ce fichier d'événements. Elle nécessite un seul argument qui est le contenu du texte.</p> - -<hr> -<p>Le Tutoriel XUL est terminé.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_scripts_d'installation" style="float: left;">« Précédent</a><br></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/gabarits/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/gabarits/index.html deleted file mode 100644 index 72a5b71bbc..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/gabarits/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Gabarits -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Gabarits -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Templates ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Introduction_à_RDF" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemples_de_syntaxe_de_gabarits">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons voir comment peupler des éléments avec des données.</p> - -<h3 id="Peuplement_des_.C3.A9l.C3.A9ments" name="Peuplement_des_.C3.A9l.C3.A9ments">Peuplement des éléments</h3> - -<p>XUL apporte une méthode permettant de créer des éléments à partir de données fournies par <abbr title="Resource Description Framework">RDF</abbr>, que ce soit à partir d'un fichier RDF ou à partir d'une source de données interne. Plusieurs sources de données sont déjà fournies avec Mozilla comme les marque-pages, l'historique et les messages mails. Plus de détails seront donnés dans <a href="/fr/Tutoriel_XUL/Sources_de_données_RDF" title="fr/Tutoriel_XUL/Sources_de_données_RDF">une prochaine section</a>.</p> - -<p>Habituellement, les éléments tels que les <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> seront peuplés avec des données. Cependant, vous pouvez utiliser d'autres éléments si vous le voulez, bien qu'ils soient utilisés pour des cas spécifiques. Néanmoins nous commencerons avec ces autres éléments parce que les arbres et menus nécessitent plus de code.</p> - -<p>Pour permettre la création d'éléments basés sur des données RDF, vous avez besoin de fournir un gabarit simple (<abbr title="Note du Traducteur">Ndt</abbr> : template) qui sera dupliqué pour chaque élément devant être créé. En gros, vous fournissez juste le premier élément et les suivants seront construits sur le même modèle.</p> - -<p>Le gabarit est créé en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code>. À l'intérieur de celui-ci, vous pouvez placer les éléments que vous voulez utiliser pour chaque élément construit. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code> doit être placé à l'intérieur du conteneur qui contiendra les éléments construits. Par exemple, si vous utilisez un arbre <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>, vous devez placer l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code> à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>.</p> - -<h4 id="Exemple_simple_de_gabarit" name="Exemple_simple_de_gabarit">Exemple simple de gabarit</h4> - -<p>C'est mieux d'expliquer avec un exemple. Prenons un exemple simple où nous voulons créer un bouton pour chaque marque-page principal. Mozilla fournit une source de données pour les marque-pages, pouvant être ainsi utilisée pour récupérer les données. Cet exemple ne récupérera que les marque-pages principaux (ou les dossiers des marque-pages) car nous allons créer des boutons. Pour les marque-pages fils, nous devrions utiliser un élément qui affiche une hiérarchie tel qu'un arbre ou un menu.</p> - -<div class="note">Cet exemple et tous les autres qui font référence à des sources de données RDF interne, et ils ne fonctionneront que si vous les chargez à partir d'une url chrome. Pour des raisons de sécurité, Mozilla ne permet pas d'y accéder à partir de fichiers extérieurs.</div> - -<p>Pour voir cet exemple, vous devrez créer un paquet chrome contenant le fichier à charger (vous pouvez le faire facilement, consultez <a href="/fr/Tutoriel_XUL/Les_fichiers_manifest" title="fr/Tutoriel_XUL/Les_fichiers_manifest">les fichiers manifest</a>). Vous pouvez alors entrer l'URL chrome dans le champ de saisie des URLs du navigateur.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_templates_1.xul.txt">Source</a></p> - -<pre><vbox datasources="rdf:bookmarks" ref="NC:BookmarksRoot" flex="1"> - <template> - <button uri="rdf:*" label="rdf:http://home.netscape.com/NC-rdf#Name"/> - </template> -</vbox> -</pre> - -<div class="float-right"><img alt="Image:xultu_templates1.jpg" class="internal" src="/@api/deki/files/1558/=Xultu_templates1.jpg"></div> - -<p>Ici une boîte verticale a été créée contenant une colonne de boutons, un pour chaque marque-page principal. Vous pouvez voir que le <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code> ne contient qu'un seul <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Cet unique bouton est utilisé comme modèle pour tout les autres boutons qu'il sera nécessaire de créer. Vous pouvez voir sur l'image qu'un ensemble de boutons a été créé, un pour chaque marque-page.</p> - -<p>Essayez d'ajouter un marque-page dans le navigateur pendant que vous avez cet exemple ouvert dans une fenêtre. Vous noterez que les boutons seront mis à jour instantanément (Vous devez donner le focus à la fenêtre pour voir le changement).</p> - -<h4 id="Conteneurs_et_sources_de_donn.C3.A9es" name="Conteneurs_et_sources_de_donn.C3.A9es">Conteneurs et sources de données</h4> - -<p>Le gabarit lui-même est placé à l'intérieur d'une boîte verticale. La boîte a deux attributs qui lui permet d'être utilisée pour les gabarits, indiquant d'où les données proviennent. Le premier attribut de la boîte est <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>. Il est utilisé pour déclarer la source de données RDF qui fournira les données pour créer les éléments. Dans le cas présent, 'rdf:bookmarks' est indiqué. Vous devinez probablement qu'il signifie qu'il faut utiliser la source de données des marque-pages. Cette source de données est fournie par Mozilla. Pour utiliser votre propre source de données, spécifiez l'URL d'un fichier RDF dans l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, comme le montre l'exemple suivant :</p> - -<pre><box datasources="chrome://zoo/content/animals.rdf" - ref="http://www.some-fictitious-zoo.com/all-animals"> -</pre> - -<p>Vous pouvez spécifier plusieurs sources de données à la fois, en les séparant avec un espace dans la valeur de l'attribut. Ainsi, l'affichage de données provenant de multiples sources est possible.</p> - -<p>L'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> indique l'endroit dans la source de données à partir duquel vous voulez récupérer les données. Dans le cas des marque-pages, la valeur 'NC:BookmarksRoot' est utilisée pour indiquer la racine de la hiérarchie des marque-pages. Les autres valeurs que vous pouvez indiquer dépendront de la source de données que vous utiliserez. Si vous utilisez votre propre fichier RDF, la valeur correspondra à la valeur d'un attribut <code id="a-about"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/about">about</a></code> d'un élément RDF <code>Bag</code>, <code>Seq</code> ou <code>Alt</code>.</p> - -<h4 id=".C3.80_l.27int.C3.A9rieur_d.27un_gabarit" name=".C3.80_l.27int.C3.A9rieur_d.27un_gabarit">À l'intérieur d'un gabarit</h4> - -<p>En ajoutant ces deux attributs à la boîte du dessus, vous permettez la génération d'éléments en utilisant le gabarit. Cependant, les éléments à l'intérieur du gabarit nécessite une déclaration différente. Vous noterez dans l'exemple du dessus que le bouton a un attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> et a une valeur inhabituelle pour l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>.</p> - -<p>Un attribut à l'intérieur d'un gabarit qui commence par 'rdf:' indique que la valeur doit être prise à partir de la source de données. Dans l'exemple plus haut, c'est le cas de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>. Le reste de la valeur réfère au nom de la propriété dans la source de données. Elle est construite en prenant l'URL de l'espace de nom utilisé par la source de données et en y ajoutant le nom de la propriété. Ici, nous utilisons seulement le nom du marque-page mais d'autres champs sont disponibles.</p> - -<p>L'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> des boutons est renseigné avec cet URI spécial parce que nous voulons que les libellés des boutons aient le nom des marque-pages. Nous pouvons mettre cet URI sur n'importe quel attribut de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, ou n'importe quel élément. Les valeurs de ces attributs sont remplacées par les données fournies par la source de données qui, ici, sont les marque-pages. Pour finir, les libellés des boutons sont définis par les noms des marque-pages.</p> - -<p>L'exemple du dessous montre comment nous pourrions assigner d'autres attributs d'un bouton à partir de la source de données. Bien sûr, cela implique que la source de données fournisse les ressources appropriées. Si une ressource particulière est inexistante, la valeur de l'attribut sera une chaîne vide.</p> - -<pre><button class="rdf:http://www.example.com/rdf#class" - uri="rdf:*" - label="rdf:http://www.example.com/rdf#name" - crop="rdf:http://www.example.com/rdf#crop"/> -</pre> - -<p>Comme vous pouvez le voir, vous pouvez générer dynamiquement une liste d'éléments avec les attributs fournis par une source de données séparée.</p> - -<p>L'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> est utilisé pour spécifier l'élément où la génération du contenu commencera. Le contenu extérieur ne sera généré qu'une seule fois, tandis que le contenu intérieur sera généré pour chaque ressource. Nous en verrons plus à ce propos quand nous créerons <a href="/fr/Tutoriel_XUL/Arbres_et_Gabarits" title="fr/Tutoriel_XUL/Arbres_et_Gabarits">des gabarits pour les arbres</a>.</p> - -<h4 id="Plus_d.27exemples" name="Plus_d.27exemples">Plus d'exemples</h4> - -<p>En ajoutant ces fonctionnalités au conteneur dans lequel est le gabarit, qui dans ce cas est une boîte, et aux éléments à l'intérieur du gabarit, nous pouvons générer de multiples listes de contenu à partir de données externes. Nous pouvons bien sûr mettre plus d'un élément à l'intérieur du gabarit, et ajouter une référence RDF spéciale dans les attributs sur n'importe quel élément. L'exemple suivant le montre :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_templates_2.xul.txt">Source</a></p> - -<pre><vbox datasources="rdf:bookmarks" ref="NC:BookmarksRoot" flex="1"> - <template> - <vbox uri="rdf:*"> - <button label="rdf:http://home.netscape.com/NC-rdf#Name"/> - <label value="rdf:http://home.netscape.com/NC-rdf#URL"/> - </vbox> - </template> -</vbox> -</pre> - -<p>Cet exemple crée une boîte verticale avec un bouton et un libellé pour chaque marque-page. Le bouton contiendra le nom du marque-page et le libellé contiendra l'URL.</p> - -<p>Les nouveaux éléments qui sont créés ne sont fonctionnellement pas différents de ceux que vous mettez directement dans le fichier XUL. L'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> est ajouté à tous les éléments créés au travers du gabarit, et il est assigné à la valeur qui identifie la ressource. Vous pouvez l'utiliser pour identifier la ressource.</p> - -<p>Vous pouvez aussi spécifier de multiples ressources dans le même attribut en les séparant avec un espace, comme dans l'exemple qui suit (<a class="external" href="http://xulfr.org/xulplanet/xultu/templateex.html">en savoir plus sur la syntaxe des ressources</a>).</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_templates_3.xul.txt">Source</a></p> - -<pre><vbox datasources="rdf:bookmarks" ref="NC:BookmarksRoot" - flex="1"> - <template> - <label uri="rdf:*" value="rdf:http://home.netscape.com/NC-rdf#Name rdf:http://home.netscape.com/NC-rdf#URL"/> - </template> -</vbox> -</pre> - -<h3 id="Comment_sont_construits_les_gabarits" name="Comment_sont_construits_les_gabarits">Comment sont construits les gabarits</h3> - -<p>Quand un élément a un attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, cela indique que l'élément est susceptible d'être généré à partir d'un gabarit. Notez que ce n'est pas la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code> qui détermine si le contenu sera généré, mais bien l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>. Quand cet attribut est présent, un objet que l'on appelle <em>un constructeur</em> est ajouté à l'élément. C'est cet objet qui est responsable de la génération du contenu à partir du gabarit. En javascript, vous pouvez accéder à l'objet constructeur par la propriété <code>builder</code>, bien qu'habituellement vous en aurez seulement besoin pour régénérer le contenu dans les situations où il ne le fait pas automatiquement.</p> - -<p>Il y a deux différents types de constructeur. Le premier est un <em>constructeur de contenu</em> utilisé dans la plupart des situations, et l'autre est <em>un constructeur d'arbres</em> utilisé uniquement avec les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>.</p> - -<h4 id="Constructeur_de_contenu" name="Constructeur_de_contenu">Constructeur de contenu</h4> - -<p>Le constructeur de contenu prend le contenu situé à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code> et le duplique pour chaque ligne. Par exemple, si l'utilisateur a dix marque-pages dans l'exemple du dessus, dix éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> seront créés et ajoutés en tant que fils à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code>. Si vous utilisez les fonctions DOM pour traverser l'arbre, vous trouverez ces éléments à ces emplacements et pourrez récupérer leurs propriétés. Ces éléments sont affichés, mais pas l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code>, bien qu'il existe encore dans l'arbre du document. De plus, l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de chaque libellé sera initialisé avec la ressource RDF de la ligne correspondante.</p> - -<p>Le constructeur de contenu démarre toujours à partir de l'élément qui à l'attribut <code>uri="rdf:*"</code>. Si l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> est placé à l'intérieur d'autres éléments, ces derniers ne seront créés qu'une seule fois. Dans l'exemple ci-dessous, un <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> sera créé et rempli avec un <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> pour chaque item.</p> - -<pre><template> - <hbox> - <label uri="rdf:*" value="rdf:http://home.netscape.com/NC-rdf#Name"/> - </hbox> -</template> -</pre> - -<p>S'il y a du contenu à l'intérieur de l'élément qui a l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code> mais en dehors de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/template" title="template">template</a></code>, ce contenu apparaîtra également. Ce faisant, vous pouvez mélanger du contenu statique et dynamique dans un gabarit.</p> - -<h4 id="Constructeur_d.27arbres" name="Constructeur_d.27arbres">Constructeur d'arbres</h4> - -<p>Le constructeur d'arbres, d'autre part, ne génère pas d'éléments DOM pour chaque ligne. À la place, il récupère les données directement à partir de la source de données RDF quand il en a besoin. Comme les arbres ont souvent besoins d'afficher des centaines de lignes de données, c'est plus efficace comme ceci. Créer un élément pour chaque cellule serait trop coûteux. Cependant, en contre partie, ces arbres ne peuvent afficher que du texte (<abbr title="Note du Traducteur">NdT</abbr> : ainsi que des images et des cases à cocher), et comme aucun élément n'est créé, vous ne pouvez pas utiliser les propriétés CSS de manière habituelle pour décorer les cellules de l'arbre.</p> - -<p>Le constructeur d'arbres est utilisé seulement pour les arbres. Les autres éléments n'utilisent que le constructeur de contenu. Ceci n'est pas un problème étant donné que les autres éléments comme les menus n'ont généralement pas besoin d'afficher beaucoup d'items. Il est possible également d'utiliser le constructeur de contenu pour les arbres, ainsi un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> et d'autres seront crées pour chaque ligne.</p> - -<h3 id="R.C3.A8gles" name="R.C3.A8gles">Règles</h3> - -<p>Dans l'image du précédent exemple, vous avez pu noter que le troisième bouton est simplement un bouton avec des tirets comme libellé. C'est un séparateur dans la liste des marque-pages. Au cas où nous l'utiliserions, la source de données RDF des marque-pages stocke les séparateurs comme si ils étaient des marque-pages normaux. Ce que nous voulons faire est d'ajouter un petit espace à la place d'un bouton pour les ressources "séparateur". Ce qui signifie que nous voulons avoir deux différents types de contenu à créer, un type pour les marque-pages normaux, et un autre type pour les séparateurs.</p> - -<p>Nous pouvons le faire en utilisant un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>. Nous définissons une règle pour chaque variation des éléments que nous avons à créer. Dans notre cas, nous aurons besoin d'une règle pour les marque-pages, et une règle pour les séparateurs. Les attributs placés sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> déterminent quelle règle s'applique sur quelle ressource RDF.</p> - -<p>Pour savoir quelle règle s'applique sur les données, chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> est analysé en séquence pour une vérification de concordance. De fait, l'ordre dans lequel vous définissez les règles est important. Les règles du début ont priorité sur les règles suivantes.</p> - -<h4 id="Exemple_de_r.C3.A8gles" name="Exemple_de_r.C3.A8gles">Exemple de règles</h4> - -<p>L'exemple suivant modifie l'exemple précédant avec deux règles.</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_templates_4.xul.txt">Source</a></p> - -<pre><window - id="example-window" - title="Liste des marque-pages" - xmlns:html="http://www.w3.org/1999/xhtml" - xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - - <vbox datasources="rdf:bookmarks" ref="NC:BookmarksRoot" flex="1"> - <template> - - <rule rdf:type="http://home.netscape.com/NC-rdf#BookmarkSeparator"> - <spacer uri="rdf:*" height="16"/> - </rule> - - <rule> - <button uri="rdf:*" label="rdf:http://home.netscape.com/NC-rdf#Name"/> - </rule> - - </template> - </vbox> - -</window> -</pre> - -<div class="float-right"><img alt="Image:xultu_templates2.jpg" class="internal" src="/@api/deki/files/1559/=Xultu_templates2.jpg"></div> - -<p>En utilisant deux règles, nous permettont au contenu du gabarit d'être généré sélectivement. Dans le premier <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>, les séparateurs de marque-pages sont sélectionnés, comme nous pouvons le voir par l'attribut <code>rdf:type</code>. Le second <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> n'ayant aucun attribut, il sélectionne tout le reste.</p> - -<p>Tous les attributs placés dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>, sont utilisés comme critère de sélection. Dans notre cas, la source de données des marque-pages fournit une propriété <code>rdf:type</code> pour distinguer les séparateurs. Cet attribut contient une valeur spéciale pour les séparateurs dans la source de données RDF. C'est ainsi qu'on peut les distinguer des marque-pages. Vous pouvez utiliser une technique similaire pour n'importe quel attribut que l'on peut mettre sur un élément RDF <code>Description</code>.</p> - -<p>La valeur spéciale d'URL donnée dans l'exemple du dessus pour la première règle, est utilisée pour les séparateurs. Elle signifie que les séparateurs s'appliqueront à la première règle en générant un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> d'une hauteur de 16 pixels. Les éléments qui ne sont pas des séparateurs ne correspondront pas à la première règle, et atterriront dans la deuxième règle. Celle-ci n'a aucun attribut. Elle correspond à n'importe quelle donnée. Ce qui bien sûr, est ce que nous voulons pour le reste des données.</p> - -<p>Vous avez dû noter que, parce que nous voulons un attribut provenant de l'espace de nommage du RDF (rdf:type), nous avions besoin d'ajouter la déclaration de cet espace de nommage dans la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Si nous n'avions pas fait cela, l'attribut serait attribué à l'espace de nommage XUL. Parce qu'il n'existe pas dans cet espace, la règle ne s'appliquerait pas. Si nous utilisons des attributs provenant de notre propre espace de nommage, vous devez ajouter la déclaration de votre espace de nommage pour qu'ils soient reconnus.</p> - -<p>Vous devez deviner ce qui arriverait si la seconde règle était enlevée. Le résultat serait alors un simple <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code>, sans aucun marque-page puisqu'ils ne correspondent à aucune règle.</p> - -<p>Dit plus simplement, une règle correspond si tous les attributs placés dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> correspondent aux attributs de la ressource RDF. Dans le cas d'un fichier RDF, les ressources seraient les éléments <code>Description</code>.</p> - -<p>Il y a cependant quelques petites exceptions. Vous ne pouvez pas faire la correspondance avec les attributs <code>XULAttr|id</code>, <code>rdf:property</code> ou <code>rdf:instanceOf</code>. Mais puisque vous utiliserez vos propres attributs dans votre propre espace de nommage, ces exceptions n'auront probablement pas d'importance de toute façon.</p> - -<p>Notez qu'un gabarit sans règle, comme dans le premier exemple, est équivalent fonctionnellement à un gabarit qui possède un seul <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> sans attribut.</p> - -<hr> -<p>Nous allons voir maintenant l'utilisation des gabarits avec les arbres.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Introduction_à_RDF" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemples_de_syntaxe_de_gabarits">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/grilles/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/grilles/index.html deleted file mode 100644 index ba5a11d3b6..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/grilles/index.html +++ /dev/null @@ -1,200 +0,0 @@ ---- -title: Grilles -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Grilles -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Grids ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Onglets" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Cadres_de_contenu">Suivant »</a></p> -</div> - -<p>XUL dispose d'une série d'éléments pour créer des grilles sous forme de tableaux.</p> - -<h3 id="Disposition_tabulaire_XUL" name="Disposition_tabulaire_XUL">Disposition tabulaire XUL</h3> - -<p>XUL dispose d'un jeu d'éléments pour la mise en page sous la forme d'une grille en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code>. Il a quelques similitudes avec la balise HTML <code>table</code>. La grille n'affiche rien du tout ; elle ne sert qu'à positionner d'autres éléments en ligne et en colonne.</p> - -<p>Une grille contient des éléments qui sont alignés comme avec des tableaux. À l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code>, vous déclarez deux choses : les colonnes et les lignes qui sont utilisées. À l'instar des tableaux HTML, vous pouvez mettre du contenu tels que des libellés et des boutons à l'intérieur des lignes. Toutefois, la grille permet un arrangement de votre contenu soit en ligne, soit en colonne. Il est fréquent de l'utiliser en ligne comme avec un tableau. Mais vous pouvez utiliser des colonnes pour définir la taille et l'apparence des colonnes dans une grille. Autrement, vous pouvez mettre du contenu à l'intérieur de colonnes, et utiliser les lignes pour définir l'apparence. Nous étudierons d'abord l'organisation des éléments en ligne.</p> - -<h4 id="D.C3.A9claration_d.27une_grille" name="D.C3.A9claration_d.27une_grille">Déclaration d'une grille</h4> - -<p>Pour déclarer une série de lignes, utilisez l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rows" title="rows">rows</a></code>, qui doit être un élément enfant de <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code>. À l'intérieur, vous devez ajouter les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code>, qui représentent chacun des lignes. À l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code>, vous devez mettre le contenu que vous souhaitez sur cette ligne.</p> - -<p>De la même façon, les colonnes sont déclarées avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/columns" title="columns">columns</a></code>, qui doit être un élément enfant de <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code>. À l'intérieur de cet élément viennent les éléments individuels <code><a href="/fr/docs/Mozilla/Tech/XUL/column" title="column">column</a></code>, un pour chaque colonne que vous voulez dans la grille.</p> - -<p>Un exemple sera plus clair :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_1.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_grids1.png" class="internal" src="/@api/deki/files/1520/=Xultu_grids1.png"></div> - -<pre><grid flex="1"> - - <columns> - <column flex="2"/> - <column flex="1"/> - </columns> - - <rows> - <row> - <button label="Lapin"/> - <button label="Éléphant"/> - </row> - <row> - <button label="Koala"/> - <button label="Gorille"/> - </row> - </rows> - -</grid> -</pre> - -<p>Deux lignes et deux colonnes ont été ajoutées dans une grille. Chaque colonne est déclarée avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/column" title="column">column</a></code>. Un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> a été assigné à chacune de ces colonnes. Chaque ligne contient deux éléments qui sont des boutons. Le premier élément de chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code> est placé dans la première colonne de la grille, et le second élément de chaque ligne est placé dans la seconde colonne.</p> - -<div class="note">Notez que vous n'avez pas d'élément pour définir une cellule (il n'y a pas d'équivalent à l'élément HTML <code>td</code>). Au lieu de cela, vous placez vos contenus de cellules directement dans les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code>.</div> - -<h4 id="Grille_avec_d.27autres_.C3.A9l.C3.A9ments" name="Grille_avec_d.27autres_.C3.A9l.C3.A9ments">Grille avec d'autres éléments</h4> - -<p>Bien entendu, vous pouvez utiliser n'importe quel autre élément que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Si vous voulez une cellule particulière contenant de multiples éléments, vous pouvez utiliser une boîte imbriquée <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> ou tout autre élément boîte. Une boîte <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> représente un seul élément, mais elle peut contenir autant d'éléments que vous le souhaitez. Par exemple :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_2.xul">Voir</a></p> - -<pre><grid flex="1"> - - <columns> - <column/> - <column flex="1"/> - </columns> - - <rows> - <row> - <label control="doctitle" value="Titre du document:"/> - <textbox id="doctitle" flex="1"/> - </row> - <row> - <label control="docpath" value="Répertoire:"/> - <hbox flex="1"> - <textbox id="docpath" flex="1"/> - <button label="Parcourir..."/> - </hbox> - </row> - </rows> - -</grid> -</pre> - -<div class="float-right"><img alt="Image:xultu_grids2.png" class="internal" src="/@api/deki/files/1521/=Xultu_grids2.png"></div> - -<p>Remarquez sur l'image ci-contre comment la première colonne contenant les libellés a seulement un unique élément pour chaque ligne. La seconde colonne contient sur sa seconde ligne une boîte qui elle-même contient deux éléments, <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Vous pouvez ajouter d'autres boîtes imbriquées ou une autre grille dans une simple cellule.</p> - -<p>Si vous redimensionnez la fenêtre du dernier exemple, vous verrez que les champs de saisie s'ajustent en conséquence, mais pas les autres éléments. En effet, des attributs <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> ont été ajoutés à ces champs de saisie et à la seconde colonne. La première colonne n'a pas besoin d'être flexible car les libellés n'ont pas besoin de changer de taille.</p> - -<p>La largeur initiale d'une colonne est déterminée par le plus large de ses éléments. De même, la hauteur d'une ligne est déterminée par la taille des éléments de cette ligne. Vous pouvez employer des propriétés CSS <code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, <code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code> et des propriétés similaires pour affiner les dimensions.</p> - -<h4 id="Organisation_en_colonnes" name="Organisation_en_colonnes">Organisation en colonnes</h4> - -<p>Vous pouvez également placer des éléments à l'intérieur des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/column" title="column">column</a></code> au lieu des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code>. En procédant de la sorte, les lignes sont ajoutées seulement pour définir leur nombre.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_3.xul">Voir</a></p> - -<pre><grid> - <rows> - <row/> - <row/> - <row/> - </rows> - - <columns> - <column> - <label control="first" value="Premier nom:"/> - <label control="middle" value="Nom central:"/> - <label control="last" value="Dernier nom:"/> - </column> - <column> - <textbox id="first"/> - <textbox id="middle"/> - <textbox id="last"/> - </column> - </columns> - -</grid> -</pre> - -<p>Cette grille a trois lignes et deux colonnes. Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code> servent juste à définir combien de lignes la grille contient. Vous pouvez ajouter un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> à une ligne pour la rendre flexible. Le contenu est placé dans chaque colonne. Le premier élément de chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/column" title="column">column</a></code> est placé sur la première ligne, le second élément sur la deuxième ligne et le troisième élément sur la troisième ligne.</p> - -<p>Si vous placez du contenu à la fois sur les colonnes et sur les lignes, le contenu de l'un va se superposer à l'autre, même s'il est aligné correctement dans la grille. Cet effet correspondrait à une grille d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>.</p> - -<p>L'ordre des éléments dans la grille détermine lequel est affiché au premier plan et lequel est affiché à l'arrière-plan. Si l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rows" title="rows">rows</a></code> est placé après l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/columns" title="columns">columns</a></code>, le contenu des lignes est affiché au premier plan. Si l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/columns" title="columns">columns</a></code> est placé après l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rows" title="rows">rows</a></code>, le contenu des colonnes est affiché au premier plan. De même, les événements tels que les clics de souris et les touches de clavier sont seulement envoyés aux objets de premier plan. C'est pour cela que les colonnes sont définies après les lignes dans l'exemple ci-dessus. Si les colonnes avaient été placées en premier, les lignes auraient capturées les événements et aucun texte n'aurait pu être saisi dans les champs de saisie.</p> - -<h4 id="Flexibilit.C3.A9_des_grilles" name="Flexibilit.C3.A9_des_grilles">Flexibilité des grilles</h4> - -<p>Un des avantages des grilles par rapport à une série de boîtes imbriquées est que vous pouvez créer des cellules qui sont flexibles aussi bien horizontalement que verticalement. Il vous suffit de mettre un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sur les lignes et colonnes concernées. L'exemple suivant en fait la démonstration :</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_4.xul">Voir</a></p> - -<pre><grid flex="1"> - <columns> - <column flex="5"/> - <column/> - <column/> - </columns> - <rows> - <row flex="10"> - <button label="Cerise"/> - <button label="Citron"/> - <button label="Raisin"/> - </row> - <row flex="1"> - <button label="Fraise"/> - <button label="Framboise"/> - <button label="Pêche"/> - </row> - </rows> -</grid> -</pre> - -<p>La première colonne et l'ensemble des lignes ont été rendus flexibles. Ainsi, chaque cellule de la première colonne est flexible horizontalement. De plus, chaque cellule est flexible verticalement car l'ensemble des lignes dispose de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. La cellule de la première colonne de la première ligne (le bouton 'Cerise') sera flexible horizontalement d'un facteur 5 et verticalement d'un facteur 10. La cellule suivante (le bouton 'Citron') ne sera flexible que verticalement.</p> - -<p>L'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> a également été ajouté à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code> afin que toute la grille soit flexible. Dans le cas contraire, elle ne s'agrandirait que dans une seule direction.</p> - -<h3 id=".C3.89tendre_une_colonne" name=".C3.89tendre_une_colonne">Étendre une colonne</h3> - -<p>Cela n'a aucun sens d'étendre une cellule sur un nombre particulier de colonnes ou de lignes multiples. Toutefois, il est possible de faire qu'une ligne ou qu'une colonne s'étende sur toute la largeur ou la hauteur de la grille. Il vous suffit d'ajouter un élément à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rows" title="rows">rows</a></code> qui ne soit pas à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/row" title="row">row</a></code>. Par exemple, vous pouvez utiliser un type de boîte et y placer d'autres éléments si vous voulez en utiliser plusieurs. Voici un exemple simple :</p> - -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_grids_5.xul">Voir</a></p> - -<pre><grid> - <columns> - <column flex="1"/> - <column flex="1"/> - </columns> - - <rows> - <row> - <label value="Nord Ouest"/> - <label value="Nord Est"/> - </row> - <button label="Équateur"/> - <row> - <label value="Sud Ouest"/> - <label value="Sud Est"/> - </row> - </rows> -</grid> -</pre> - -<p>Le bouton va s'étendre pour s'ajuster sur toute la largeur de la grille comme s'il n'était pas à l'intérieur d'une ligne de la grille. Vous pouvez utiliser une technique similaire pour ajouter un élément entre deux colonnes. Il s'étendra pour s'ajuster sur toute la hauteur de la grille. Vous pouvez combiner les deux si vous le souhaitez.</p> - -<hr> -<p>Dans la section suivante, nous verrons comment ajouter des panneaux de contenu.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Onglets" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Cadres_de_contenu">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_d'attributs_xbl/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_d'attributs_xbl/index.html deleted file mode 100644 index e7071aad31..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_d'attributs_xbl/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: Héritage d'attributs XBL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Héritage_d'attributs_XBL -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XBL_Attribute_Inheritance ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Contenu_anonyme" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_propriétés">Suivant »</a></p> -</div> -<p>Dans cette section, nous verrons comment les attributs peuvent être hérités.</p> -<h3 id="l.27h.C3.A9ritage_d.27attributs" name="l.27h.C3.A9ritage_d.27attributs">l'héritage d'attributs</h3> -<p><a href="/fr/XBL" title="fr/XBL">XBL</a> permet de construire des éléments graphiques composites tout en cachant leur implémentation réelle. Cependant, avec les fonctionnalités mentionnées jusque présent, le contenu anonyme est toujours créé de la même façon. Il serait utile de pouvoir ajouter des attributs aux éléments extérieurs pour modifier les éléments intérieurs. Par exemple :</p> -<pre class="eval"><strong>XUL:</strong> - -<searchbox/> - -<strong>XBL:</strong> - -<binding id="searchBinding"> - <content> - <xul:textbox/> - <xul:button label="Rechercher"/> - </content> -</binding> -</pre> -<p>Dans cet exemple, l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> est placé directement sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Le problème avec cette technique est que le libellé sera le même à chaque fois que la liaison sera utilisée. Dans ce cas, il serait préférable que l'attribut soit plutôt défini sur la balise <code>searchbox</code>. XBL fournit un attribut <code>inherits</code> permettant l'héritage des attributs de l'élément extérieur. Il devra être placé sur l'élément qui héritera de ces attributs, dans notre cas sur le bouton. Sa valeur devra être initialisée par une liste des noms des attributs à hériter, séparés par des virgules.</p> -<pre><xul:textbox xbl:inherits="flex"/> -<xul:button xbl:inherits="label"/> -</pre> -<p>Lorsque le contenu est généré, <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> obtient l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> à partir de <code>searchbox</code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> obtient l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> à partir de <code>searchbox</code>. Ils permettent à la flexibilité du champ de saisie et au libellé du bouton d'être différents à chaque utilisation de la liaison. De plus, le changement de la valeur des attributs de la balise <code>searchbox</code> avec un script mettra aussi à jour la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> et la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Vous pouvez ajouter un attribut <code>inherits</code> sur autant d'éléments que vous le souhaitez, pour hériter de n'importe quel nombre d'attributs.</p> -<p>Remarquez comment l'attribut <code>inherits</code> a été placé dans l'espace de nommage XBL, en utilisant le préfixe 'xbl:'. L'espace de nommage devrait être déclaré quelque part avant, généralement dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code>, comme dans l'exemple suivant :</p> -<pre><bindings xmlns:xbl="http://www.mozilla.org/xbl" - xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<xbl:binding id="buttonBinding"> - <xbl:content> - <xul:button label="OK" xbl:inherits="label"/> - </xbl:content> -</xbl:binding> -</pre> -<p>Dans cet exemple, le bouton hérite de l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code>, mais cet attribut a aussi une valeur assignée directement dans le XBL. Cette technique est utilisée pour définir une valeur par défaut si l'attribut n'est pas présent. Ce bouton héritera son attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> de l'élément extérieur. Cependant, si aucun <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> n'est présent, la valeur 'OK' par défaut lui sera donnée.</p> -<p>Il peut arriver que deux éléments générés aient besoin d'hériter d'un attribut qui a le même nom. Par exemple, pour créer un champ de saisie muni d'un libellé, contenant donc un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> et un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, le libellé (<code>label</code>) aura besoin d'hériter son texte à partir de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> et le champ de saisie (<code>textbox</code>) aura aussi besoin d'hériter sa valeur par défaut également à partir de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>. Pour résoudre cela, nous aurons besoin d'utiliser un attribut différent et le faire pointer sur le bon. L'exemple suivant montre comment procéder :</p> -<pre class="eval"><strong>XUL:</strong> - -<box class="labeledtextbox" title="Entrer du texte:" value="OK"/> - -<strong>CSS:</strong> - -box.labeledtextbox { - -moz-binding: url('<a class="external" rel="freelink">chrome://example/skin/example.xml#labeledtextbox'</a>); -} - -<strong>XBL:</strong> - -<binding id="labeledtextbox"> - <content> - <xul:label xbl:inherits="value=title"/> - <xul:textbox xbl:inherits="value"/> - </content> -</binding> -</pre> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> hérite directement de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>. Pour initialiser l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> du libellé, nous aurons besoin d'utiliser un nom différent d'attribut et le faire pointer vers le vrai attribut. L'attribut <code>inherits</code> sur la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code> obtient son attribut <code>title</code> à partir de l'élément extérieur et le fait pointer vers l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>. La syntaxe <attribut intérieur>=<attribut extérieur> est utilisée ici pour faire pointer un attribut vers un autre. Voici un autre exemple :</p> -<pre class="eval"><strong>XUL:</strong> - -<box class="okcancel" oktitle="OK" canceltitle="Annuler" image="happy.png"/> - -<strong>CSS:</strong> - -box.okcancel { - -moz-binding: url('<a class="external" rel="freelink">chrome://example/skin/example.xml#okcancel'</a>); -} - -<strong>XBL:</strong> - -<binding id="okcancel"> - <content> - <xul:button xbl:inherits="label=oktitle,image"/> - <xul:button xbl:inherits="label=canceltitle"/> - </content> -</binding> -</pre> -<p>La valeur de l'attribut <code>oktitle</code> est projetée vers l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> du premier bouton. L'attribut <code>canceltitle</code> est projeté vers l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> du second bouton. Le premier bouton hérite aussi de l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. Le résultat est le suivant :</p> -<pre><box class="okcancel" oktitle="OK" canceltitle="Annuler" image="happy.png"> - <button label="OK" image="happy.png"/> - <button label="Annuler"/> -</box> -</pre> -<p>Remarquez que les attributs sont dupliqués dans le contenu intérieur (anonyme). La modification des attributs de la boîte avec la classe 'okannuler' affectera automatiquement les valeurs des boutons. Vous avez probablement aussi remarqué que nous avons créé nos propres noms d'attribut. Ceci est valide en XUL.</p> -<hr> -<p>Dans la section suivante, nous regarderons l'ajout de propriétés, méthodes et événements à une liaison.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Contenu_anonyme" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_propriétés">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_xbl/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_xbl/index.html deleted file mode 100644 index a2edf8e9ba..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/héritage_xbl/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Héritage XBL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Héritage_XBL -tags: - - Tutoriel_XUL - - Tutoriels - - XBL - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XBL_Inheritance ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaire_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemple_XBL">Suivant »</a></p> -</div> - -<p>Dans cette section, nous verrons comment étendre des définitions <a href="/fr/XBL" title="fr/XBL">XBL</a> existantes.</p> - -<h3 id="H.C3.A9ritage" name="H.C3.A9ritage">Héritage</h3> - -<p>Parfois vous pouvez vouloir créer un élément graphique XBL qui est similaire à un élément existant. Par exemple, disons que vous souhaitez créer un bouton XBL avec une fenêtre surgissante. Une manière de faire pour le créer est de dupliquer le code XBL existant des boutons. Cependant, il serait préférable de simplement étendre ce code.</p> - -<p>N'importe quelle liaison peut être étendue avec une autre. La liaison fille peut ajouter des propriétés, des méthodes et des gestionnaires d'événements. La liaison fille aura toutes les caractéristiques qui la définissent en plus des caractéristiques de la liaison dont elle hérite (et celles dont cette liaison aura elle même hérité et ainsi de suite dans l'arbre).</p> - -<p>Pour étendre une liaison existante, ajoutez un attribut <code>extends</code> à l'intérieur de la balise <code><a href="/fr/docs/XBL/Référence_XBL_1.0/Éléments#binding">binding</a></code>. Par exemple, la liaison suivante crée un champ de saisie qui ajoute le texte '<span class="nowiki">http://www</span>' au début de sa valeur lorsque la touche F4 est pressée.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xblinherit_1.xml.txt">Source</a></p> - -<pre><binding id="textboxwithhttp" - extends="chrome://global/content/bindings/textbox.xml#textbox"> - <handlers> - <handler event="keypress" keycode="VK_F4"> - this.value="http://www"+value; - </handler> - </handlers> -</binding> -</pre> - -<p>L'élément XBL étend ici les fonctionnalités du champ de saisie XUL <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>. L'URL donnée dans l'attribut <code>extends</code> ci-dessus est l'URL de la liaison de la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>. Elle signifie que la liaison hérite de tous les contenu et comportement fournis par la liaison de <code>textbox</code>. En plus, nous ajoutons un gestionnaire qui répond à l'événement 'keypress'.</p> - -<h3 id="Champ_de_saisie_semi-automatique" name="Champ_de_saisie_semi-automatique">Champ de saisie semi-automatique</h3> - -<p>L'exemple ci-dessus est similaire au dispositif de saisie semi-automatique qui fonctionne sous Mozilla. Un champ de saisie qui supporte la saisie semi-automatique n'est qu'un champ de saisie basique étendu avec une liaison XBL.</p> - -<p>Le <a href="/fr/XUL/textbox_(autocomplétion_de_Firefox)" title="fr/XUL/textbox_(autocomplétion_de_Firefox)">champ de saisie semi-automatique</a> ajoute une gestion spéciale d'événement de telle sorte que lorsqu'une URL est tapée, un menu va surgir proposant des suites de saisies possibles. Vous pouvez aussi l'utiliser dans vos propres applications. Créez simplement un <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> avec deux attributs spéciaux.</p> - -<pre><textbox type="autocomplete" searchSessions="history"/></pre> - -<p>Déclarez l'attribut <code>type</code> à 'autocomplete' pour ajouter un dispositif de saisie semi-automatique à un champ de saisie existant. Déclarez <code>searchSessions</code> pour indiquer le type de données à surveiller. Dans ce cas, la valeur 'history' surveillant les URLs dans l'historique est utilisée (Vous pouvez aussi utiliser la valeur 'addrbook' pour surveiller les adresses dans le carnet d'adresses.)</p> - -<div class="note">Firefox utilise un mécanisme d'autocomplétion différent de celui de la suite Mozilla, consultez <a href="/fr/XUL/textbox_(autocomplétion_de_Firefox)" title="fr/XUL/textbox_(autocomplétion_de_Firefox)">XUL:textbox (autocomplétion de Firefox)</a>.</div> - -<hr> -<p>Dans la prochaine section, nous verrons un exemple d'élément graphique défini en XBL.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaire_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemple_XBL">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/index.html deleted file mode 100644 index 5924573c00..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: Tutoriel XUL -slug: Archive/Mozilla/XUL/Tutoriel_XUL -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial ---- -<p> </p> - -<p>Ce tutoriel décrit le langage <a href="/fr/docs/Mozilla/Tech/XUL/XUL">XUL</a> (<a href="/fr/docs/Mozilla/Tech/XUL/XML">XML</a> User-interface Language). Ce langage a été créé pour l'application Mozilla afin de décrire son interface utilisateur.</p> - -<h5 id="Introduction" name="Introduction">Introduction</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Introduction">Introduction</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/La_structure_XUL">La structure XUL</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/L'URL_Chrome">L'URL Chrome</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_fichiers_manifest">Les fichiers manifest</a></li> -</ul> - -<h5 id="Éléments_simples">Éléments simples</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cr%c3%a9er_une_fen%c3%aatre">Créer une fenêtre</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajouter_des_boutons">Ajouter des boutons</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajouter_des_libell%c3%a9s_et_des_images">Ajouter des libellés et des images</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_champs_de_saisie">Les champs de saisie</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_contr%c3%b4les_num%c3%a9riques">Les contrôles numériques</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_contr%c3%b4les_de_listes">Les contrôles de listes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Indicateurs_de_progression">Indicateurs de progression</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajout_d'%c3%a9l%c3%a9ments_HTML">Ajout d'éléments HTML</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Utilisation_des_spacers">Utilisation des spacers</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Plus_de_caract%c3%a9ristiques_sur_les_boutons">Plus de caractéristiques sur les boutons</a></li> -</ul> - -<h5 id="Le_modèle_de_boîte">Le modèle de boîte</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Le_mod%c3%a8le_de_bo%c3%aete">Le modèle de boîte</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Positionnement_des_%c3%a9l%c3%a9ments">Positionnement des éléments</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/D%c3%a9tails_sur_le_mod%c3%a8le_de_bo%c3%aete">Détails sur le modèle de boîte</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_bo%c3%aetes_de_groupe">Les boîtes de groupe</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajouter_plus_d'%c3%a9l%c3%a9ments">Ajouter plus d'éléments</a></li> -</ul> - -<h5 id="Éléments_communs">Éléments communs</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Piles_et_Paquets">Piles et Paquets</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Positionnement_dans_une_pile">Positionnement dans une pile</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Onglets">Onglets</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Grilles">Grilles</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cadres_de_contenu">Cadres de contenu</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/S%c3%a9parateurs">Séparateurs</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Barres_de_d%c3%a9filement">Barres de défilement</a></li> -</ul> - -<h5 id="Menus_et_barres_d'outils">Menus et barres d'outils</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Barre_d'outils">Barre d'outils</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Barres_de_menus_simples">Barres de menus simples</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Plus_de_fonctionnalit%c3%a9s_de_menu">Plus de fonctionnalités de menu</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Menus_surgissants">Menus surgissants</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Menus_d%c3%a9filants">Menus défilants</a></li> -</ul> - -<h5 id="Évènements_et_scripts">Évènements et scripts</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajout_de_gestionnaires_d'%c3%a9v%c3%a8nements">Ajout de gestionnaires d'évènements</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Plus_sur_les_gestionnaires_d'%c3%a9v%c3%a8nements">Plus sur les gestionnaires d'évènements</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Raccourcis_clavier">Raccourcis clavier</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Focus_et_Selection">Focus et Selection</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Commandes">Commandes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Mise_%c3%a0_jour_de_commandes">Mise à jour de commandes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Broadcasters_et_Observateurs">Broadcasters et Observateurs</a></li> -</ul> - -<h5 id="Modèle_Objet_de_Document_(DOM)">Modèle Objet de Document (DOM)</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Document_Object_Model">Document Object Model</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Modification_d'une_interface_XUL">Modification d'une interface XUL</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Manipulation_de_listes">Manipulation de listes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_objets_bo%c3%aetes">Les objets boîtes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Interfaces_XPCOM">Interfaces XPCOM</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Exemples_XPCOM">Exemples XPCOM</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Utilisation_du_presse_papiers">Utilisation du presse papiers</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Glisser-D%c3%a9poser">Glisser-Déposer</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Conteneur_JavaScript_pour_le_glisser-d%c3%a9poser">Conteneur JavaScript pour le glisser-déposer</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Exemple_de_glisser-d%c3%a9poser">Exemple de glisser-déposer</a></li> -</ul> - -<h5 id="Arbres" name="Arbres">Arbres</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Arbres">Arbres</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Autres_caract%c3%a9ristiques_des_arbres">Autres caractéristiques des arbres</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/S%c3%a9lection_dans_les_arbres">Sélection dans les arbres</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Vues_d'arbre_personnalis%c3%a9es">Vues d'arbre personnalisées</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/D%c3%a9tails_sur_les_vues_d'arbres">Détails sur les vues d'arbres</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_objets_bo%c3%aetes_des_arbres">Les objets boîtes des arbres</a></li> -</ul> - -<h5 id="RDF_et_templates">RDF et templates</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Introduction_%c3%a0_RDF">Introduction à RDF</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Gabarits">Gabarits</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Exemples_de_syntaxe_de_gabarits">Exemples de syntaxe de gabarits</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Arbres_et_Gabarits">Arbres et Gabarits</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Sources_de_donn%c3%a9es_RDF">Sources de données RDF</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/R%c3%a8gles_avan%c3%a7%c3%a9es">Règles avançées</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Donn%c3%a9es_persistantes">Données persistantes</a></li> -</ul> - -<h5 id="Thèmes_et_localisation">Thèmes et localisation</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajouter_des_feuilles_de_style">Ajouter des feuilles de style</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Styler_un_arbre">Styler un arbre</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Modification_du_th%c3%a8me_par_d%c3%a9faut">Modification du thème par défaut</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cr%c3%a9er_un_th%c3%a8me">Créer un thème</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Localisation">Localisation</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_fichiers_de_propri%c3%a9t%c3%a9s">Les fichiers de propriétés</a></li> -</ul> - -<h5 id="Liaisons_XBL" name="Liaisons_XBL">Liaisons XBL</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Introduction_%c3%a0_XBL">Introduction à XBL</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Contenu_anonyme">Contenu anonyme</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/H%c3%a9ritage_d'attributs_XBL">Héritage d'attributs XBL</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajout_de_propri%c3%a9t%c3%a9s">Ajout de propriétés</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajout_de_m%c3%a9thodes">Ajout de méthodes</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Ajout_de_gestionnaire_d'%c3%a9v%c3%a8nements">Ajout de gestionnaire d'évènements</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/H%c3%a9ritage_XBL">Héritage XBL</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Exemple_XBL">Exemple XBL</a></li> -</ul> - -<h5 id="Fenêtres_spécialisées">Fenêtres spécialisées</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Caract%c3%a9ristiques_d'une_fen%c3%aatre">Caractéristiques d'une fenêtre</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cr%c3%a9er_des_bo%c3%aetes_de_dialogue">Créer des boîtes de dialogue</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Bo%c3%aete_de_dialogue_de_fichier">Boîte de dialogue de fichier</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cr%c3%a9ation_d'un_assistant">Création d'un assistant</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Assistant_avan%c3%a7%c3%a9">Assistant avançé</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Overlays">Overlays</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Overlays_inter-paquetage">Overlays inter-paquetage</a></li> -</ul> - -<h5 id="Installation" name="Installation">Installation</h5> - -<ul> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Cr%c3%a9ation_d'un_programme_d'installation">Création d'un programme d'installation</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Les_scripts_d'installation">Les scripts d'installation</a></li> - <li><a href="/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Fonctions_additionnelles_d'installation">Fonctions additionnelles d'installation</a></li> -</ul> - -<div class="note"> -<p>Ce tutoriel XUL a été initialement créé par <a class="external" href="http://www.xulplanet.com/ndeakin/">Neil Deakin</a>. Il a généreusement accepté de l'inclure dans <a>MDC</a>.</p> -</div> - -<div class="originaldocinfo"> -<h5 id="Information_du_document_original" name="Information_du_document_original">Information du document original</h5> - -<ul> - <li>Auteur : <a class="external" href="http://www.xulplanet.com/ndeakin/">Neil Deakin</a></li> - <li>Copyright : © 1999-2005 XULPlanet.com</li> -</ul> -</div> - -<p><span class="comment">Interwiki Language Links</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/indicateurs_de_progression/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/indicateurs_de_progression/index.html deleted file mode 100644 index af289aeecf..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/indicateurs_de_progression/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Indicateurs de progression -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Indicateurs_de_progression -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Progress_Meters ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_contrôles_de_listes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_d'éléments_HTML">Suivant »</a></p> -</div> -<p>Dans cette section, nous étudierons la création d'indicateurs de progression.</p> -<h3 id="Ajout_d.27un_indicateur_de_progression" name="Ajout_d.27un_indicateur_de_progression">Ajout d'un indicateur de progression</h3> -<p>Un indicateur de progression est une barre qui indique l'état d'avancement d'une tâche. Typiquement, vous la voyez lors du téléchargement de fichiers ou quand une longue opération s'exécute. XUL a un élément qui peut être utilisé pour la création d'un indicateur de progression (NdT : <code><a href="/fr/docs/Mozilla/Tech/XUL/progressmeter" title="progressmeter">progressmeter</a></code>). Il y a deux types d'état pour un indicateur : déterminé et indéterminé.</p> -<p>Les indicateurs de progression déterminés sont utilisés quand vous connaissez la durée d'une opération. L'indicateur de progression va se remplir, et une fois plein, l'opération doit être terminée. Il peut être utilisé pour une boîte de dialogue de téléchargement lorsque la taille des fichiers est connue.</p> -<p>Les indicateurs de progression indéterminés sont utilisés quand vous ne connaissez pas la durée d'une opération. Une animation visuelle représentera cet indicateur, sous la forme d'un rectangle zébré ou un cylindre hachuré tournant, et elle sera dépendante de votre système d'exploitation et du thème graphique utilisé.</p> -<p>Indicateur de progression déterminé : </p> -<div class="float-right"><img alt="Image:xultu_prog-det.jpg" class=" internal" src="/@api/deki/files/1539/=Xultu_prog-det.jpg"></div> -<p>Indicateur de progression indéterminé : </p> -<div class="float-right"><img alt="Image:xultu_prog-udet.jpg" class=" internal" src="/@api/deki/files/1540/=Xultu_prog-udet.jpg"></div> -<p>Un indicateur de progression a la syntaxe suivante :</p> -<pre><progressmeter - id="identifier" - mode="determined" - value="0%"/> -</pre> -<p>Ses attributs sont les suivants :</p> -<dl> <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> <dd>L'identifiant unique de l'indicateur de progression.</dd> <dt><code id="a-mode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mode">mode</a></code> </dt> <dd>Le type d'indicateur de progression. Si sa valeur est 'determined', l'indicateur de progression est déterminé et se remplit au fur et à mesure de la tâche en cours. Si sa valeur est 'undetermined', l'indicateur de progression est indéterminé et vous ne connaissez pas la durée de la tâche en cours. La valeur par défaut est 'determined' si vous n'avez pas spécifié cet attribut.</dd> <dt><code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> </dt> <dd>La valeur courante de l'indicateur de progression. Vous ne devez utiliser cet attribut que pour un indicateur de progression déterminé. La valeur doit être un pourcentage compris entre '0%' et '100%'. La valeur sera changée par un script selon l'avancement de la tâche.</dd> -</dl> -<div class="highlight"> -<p>Ajoutons maintenant un indicateur de progression à notre boîte de dialogue 'Recherche de fichiers'. Nous devrions normalement mettre un indicateur de progression indéterminé car nous ne connaissons pas le nombre de fichiers recherchés ou combien de temps prendra la recherche. Toutefois, nous ajouterons un indicateur normal pour l'instant car un indicateur animé risque d'être perturbant lors du développement. L'indicateur de progression devrait normalement n'apparaître que lorsque la recherche est lancée. Nous ajouterons plus tard un script pour l'afficher ou non.</p> -<pre class="eval"><hbox> - - <span class="highlightred"><progressmeter value="50%" style="margin: 4px;"></span> - - <spacer flex="1"/> -</hbox> -</pre> -<div class="float-right"><img alt="Image:xultu_progress1.png" class=" internal" src="/@api/deki/files/1541/=Xultu_progress1.png"></div> -<p>La valeur a été mise à '50%' afin que vous puissiez voir la barre de progression dans la fenêtre. Une marge de 4 pixels a été définie pour séparer l'indicateur du bord de la fenêtre. Comme nous l'avons mentionné précédemment, nous voulons simplement que la barre de progression soit affichée pendant la recherche. Un script l'affichera et la masquera si nécéssaire.</p> -Exemple 'Recherche de fichiers' : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_find_progress.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_find_progress.xul">Voir</a></div> -<hr> -<p>Nous allons voir dans la prochaine section comment ajouter des éléments additionnels à une fenêtre en utilisant HTML.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_contrôles_de_listes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_d'éléments_HTML">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/interfaces_xpcom/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/interfaces_xpcom/index.html deleted file mode 100644 index 5f7b8e5f1b..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/interfaces_xpcom/index.html +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Interfaces XPCOM -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Interfaces_XPCOM -tags: - - Tutoriel_XUL - - Tutoriels - - 'XPCOM:Liaisons_de_langage' - - XPConnect - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XPCOM_Interfaces ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemples_XPCOM">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons faire une brève présentation de <abbr title="Cross-platform Component Object Model"><a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a></abbr> ("Modèle de composants objets multi plate-forme"), qui est le système d'objets utilisé par Mozilla.</p> - -<h3 id="Appel_des_objets_natifs" name="Appel_des_objets_natifs">Appel des objets natifs</h3> - -<p>En utilisant XUL, nous pouvons construire des interfaces utilisateurs complexes. En y joignant des scripts, on peut modifier l'interface et réaliser des actions. Cependant, il y a un certain nombre de choses qui ne peuvent pas être réalisées directement en javascript. Par exemple, si nous voulons créer une application gérant des courriels, nous avons besoin d'écrire des scripts permettant de se connecter au serveur de courriels, afin de les retirer ou d'en envoyer. Le langage Javascript ne permet pas de faire ce genre de choses.</p> - -<p>Le seul moyen pour le faire est d'écrire du code natif implémentant ces fonctionnalités avancées. Nous avons aussi besoin d'un moyen pour pouvoir appeler ce code natif aisément à partir de nos scripts. Mozilla fournit une telle possibilité en utilisant <abbr title="Cross-platform Component Object Model"><a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a></abbr>.</p> - -<div class="note">Mozilla fournit déjà plusieurs composants et interfaces XPCOM. Donc, dans la plupart des cas, il sera inutile d'écrire votre propre code natif. Après avoir lu cette section, vous pourrez rechercher des interfaces en utilisant <a class="external" href="http://xulplanet.com/references/xpcomref/">la référence XPCOM de XULPlanet</a>.</div> - -<h3 id=".C3.80_propos_d.27XPCOM" name=".C3.80_propos_d.27XPCOM">À propos d'XPCOM</h3> - -<p>Mozilla est construit à partir d'une multitude de composants, où chacun d'eux réalise une tâche précise. Par exemple, il y a un composant pour chaque menu, bouton et élément. Ces composants sont construits à partir de plusieurs définitions appelées <em>interfaces</em>.</p> - -<p>Une interface dans Mozilla est une définition d'un ensemble de fonctions que peuvent implémenter des composants. Les composants sont ce qui permet au code de Mozilla de réaliser des traitements. Chaque composant implémente les fonctions conforme à une interface. Un composant peut implémenter plusieurs interfaces. Et plusieurs composants peuvent implémenter la même interface.</p> - -<p>Prenons l'exemple d'un composant de fichier. Une interface sera créée décrivant les propriétés et les fonctions que l'on veut pouvoir appliquer sur un fichier. Les propriétés seront le nom du fichier, sa date de dernière modification ou sa taille. Les fonctions permettront d'effacer, de déplacer ou de copier le fichier.</p> - -<p>L'interface "Fichier" décrit uniquement les caractéristiques du fichier, elle ne les implémente pas. L'implémentation est laissé au composant. Celui-ci contiendra le code qui permettra de récupérer le nom du fichier, sa date, sa taille. Il contiendra également le code pour le copier ou le renommer.</p> - -<p>Nous n'avons pas à s'intéresser sur la manière dont l'implémentation est faite par le composant, du moment qu'il respecte l'interface correctement. Bien sûr, nous aurons une implémentation différente pour chaque plate-forme. Entre les versions Macintosh et Windows, les composants de fichier seront très différents. Cependant ils implémentent la même interface et par conséquent on peut accéder au composant en utilisant les fonctions de cette interface.</p> - -<p>Dans Mozilla, les interfaces sont préfixées par 'nsI' ou 'mozI' ainsi elles sont facilement reconnaissables. Par exemple, <code>nsIAddressBook</code> est l'interface qui interagit avec le carnet d'adresses, <code>nsISound</code> est celle utilisée pour écouter des fichiers et <code>nsILocalFile</code> pour manipuler des fichiers. Pour plus de détails, consultez <a href="/fr/Interfaces" title="fr/Interfaces">les interfaces</a> de Mozilla.</p> - -<p>Typiquement, les composants XPCOM sont implémentés nativement, ce qui signifie qu'ils font des choses que le langage Javascript ne peut pas réaliser. Par contre, on peut les appeler à partir de scripts. C'est ce que l'on va voir maintenant. Nous pouvons appeler n'importe laquelle des fonctions fournies par le composant telles que décrites par les interfaces qu'il implémente. Par exemple, si vous avez un composant à votre disposition, vous vérifiez alors s'il implémente l'interface <code>nsISound</code>, et si c'est le cas, vous pouvez jouer un son grâce lui.</p> - -<p>Le processus d'appel de composants XPCOM à partir d'un script se nomme <a href="/fr/XPConnect" title="fr/XPConnect">XPConnect</a> : une couche qui traduit les objets du script en objets natifs.</p> - -<h3 id="Cr.C3.A9ation_d.27objets_XPCOM" name="Cr.C3.A9ation_d.27objets_XPCOM">Création d'objets XPCOM</h3> - -<p>L'appel d'un composant XPCOM se fait en trois étapes :</p> - -<ol> - <li>Récupérer un composant.</li> - <li>Récupérer la partie du composant qui implémente l'interface que l'on veut utiliser.</li> - <li>Appeler la fonction que l'on a besoin.</li> -</ol> - -<p>Une fois que les deux premières étapes sont réalisées, nous pouvons effectuer la dernière autant de fois que nécessaire. Prenons le cas du renommage d'un fichier. La première étape est de récupérer le composant "fichier". Puis on interroge ledit composant pour récupérer la portion qui implémente l'interface <code>nsILocalFile</code>. Enfin, on appelle les fonctions fournies par l'interface. Cette interface est utilisée pour représenter un unique fichier.</p> - -<p>Nous avons vu que les noms d'interfaces commencent toujours par 'nsI' ou 'mozI'. Par contre, la désignation des composants utilise la syntaxe URI. Mozilla stocke une liste de tous les composants disponibles dans son propre registre. Un utilisateur peut installer de nouveaux composants si besoin est. Ce mécanisme fonctionne comme les plugins.</p> - -<p>Mozilla fournit un composant "fichier" c'est-à-dire implémentant <code><a href="/fr/NsILocalFile" title="fr/NsILocalFile">nsILocalFile</a></code>. Ce composant est désigné par la chaîne <a class="link-mailto" href="mailto:'@mozilla.org" rel="freelink">'@mozilla.org</a>/file/local;1'. Cette chaîne est appelée un contractID. La syntaxe d'un contractID est :</p> - -<pre>@<internetdomain>/module[/submodule[...]];<version>[?<name>=<value>[&<name>=<value>[...]]]</pre> - -<p>D'autres composants peuvent être appelés de la même manière.</p> - -<p>Le contractID du composant sert à obtenir le composant. Voici en Javascript le code correspondant :</p> - -<pre>var aFile = Components.classes["@mozilla.org/file/local;1"].createInstance();</pre> - -<p>Le composant "fichier" est récupéré et stocké dans la variable <code>aFile</code>. Dans l'exemple, <code>Components</code> fait référence à un objet global fournissant les fonctions relatives à certains composants. Ici la classe d'un composant est récupérée en utilisant la propriété <code>classes</code>. Cette propriété est un tableau de tous les composants disponibles. Pour obtenir un composant différent, il suffit de remplacer l'URI par celui du composant voulu. Finalement, une instance est créée avec la fonction <code>createInstance()</code>.</p> - -<p>Vous devez vérifier que la valeur de retour de <code>createInstance()</code> est différente de 'null', valeur qui indiquerait que le composant n'existe pas.</p> - -<p>Pour l'instant, nous avons seulement une référence sur le composant "fichier". Pour appeler ses fonctions, nous avons besoin de récupérer une de ces interfaces, dans notre cas <code><a href="/fr/NsILocalFile" title="fr/NsILocalFile">nsILocalFile</a></code>. Une seconde ligne est ajoutée à notre code comme suit :</p> - -<pre>var aFile = Components.classes["@mozilla.org/file/local;1"].createInstance(); -if (aFile) aFile.QueryInterface(Components.interfaces.nsILocalFile); -</pre> - -<p>La fonction <code>QueryInterface()</code> est fournie par tous les composants, elle permet d'obtenir une interface précise du composant. Elle prend un seul paramètre, le nom de l'interface souhaitée. La propriété <code>interfaces</code> de <code>Components</code> contient une liste de toutes les interfaces des composants. Ici on utilise l'interface <code>nsILocalFile</code> que l'on passe en paramètre à <code>QueryInterface()</code>. Ainsi <code>aFile</code> fera référence à la partie du composant qui implémente l'interface <code>nsILocalFile</code>.</p> - -<p>Ces deux lignes de Javascript peuvent être utilisées pour obtenir n'importe quelle interface de n'importe quel composant. Il suffit de remplacer le nom du composant et le nom de l'interface que vous voulez utiliser. Vous pouvez bien sûr choisir n'importe quel nom pour la variable. Par exemple si vous voulez utiliser l'interface pour le son, notre code pourrait être comme suit :</p> - -<pre>var sound = Components.classes["@mozilla.org/sound;1"].createInstance(); -if (sound) sound.QueryInterface(Components.interfaces.nsISound); -</pre> - -<p>Les interfaces XPCOM peuvent hériter d'autres interfaces. L'interface héritière possède ses propres fonctions mais aussi toutes celles des interfaces parentes. Ainsi toute interface hérite de l'interface principale <code>nsISupports</code> qui fournit la fonction <code>QueryInterface()</code>. Comme tout composant doit implémenter <code>nsISupports</code>, la fonction <code>QueryInterface()</code> est disponible sur tous les composants.</p> - -<p>Plusieurs composants peuvent implémenter la même interface. Typiquement ce sont des sous-classes de l'original mais pas nécessairement. N'importe quel composant peut implémenter les fonctionnalités de <code>nsILocalFile</code>. De plus, un composant peut implémenter plusieurs interfaces. C'est pour ces raisons que l'on doit procéder en deux étapes pour appeler les fonctions d'une interface.</p> - -<p>Cependant, il existe un raccourci pour réduire ces deux étapes en une seule ligne de code :</p> - -<pre>var aLocalFile = Components.classes["@mozilla.org/file/local;1"].createInstance(Components.interfaces.nsILocalFile); -</pre> - -<p>Ce code effectue la même action qu'avec les deux lignes, mais en une seule ligne. Il élimine le besoin de créer une instance et ensuite de l'interroger pour obtenir une interface précise, en deux étapes séparées.</p> - -<p>Un appel à <code>QueryInterface()</code> sur un objet qui ne fournit pas l'interface demandée lance une exception. Si vous n'êtes pas sûr que le composant supporte une interface, vous pouvez utiliser l'opérateur <code><a href="/fr/Référence_de_JavaScript_1.5_Core/Opérateurs/Opérateurs_spéciaux/L'opérateur_instanceof" title="fr/Référence_de_JavaScript_1.5_Core/Opérateurs/Opérateurs_spéciaux/L'opérateur_instanceof">instanceof</a></code> comme suit :</p> - -<pre>var aFile = Components.classes["@mozilla.org/file/local;1"].createInstance(); -if (aFile instanceof Components.interfaces.nsILocalFile){ - // faire quelque chose si il s'agit d'une instance du bon type -} -</pre> - -<p>L'opérateur <code>instanceof</code> renvoie 'true' si <code>aFile</code> implémente l'interface <code>nsILocalFile</code>, et il effectue également l'appel de la méthode <code>QueryInterface</code>, ce qui fournit par la suite un objet <code>nsILocalFile</code> aFile valide.</p> - -<h3 id="Appel_des_fonctions_de_l.27interface" name="Appel_des_fonctions_de_l.27interface">Appel des fonctions de l'interface</h3> - -<p>Maintenant que nous avons un objet qui fait référence à un composant avec l'interface <code>nsILocalFile</code>, nous pouvons appeler les fonctions de celle-ci à travers l'objet. La liste suivante montre quelques propriétés et méthodes de l'interface <code>nsILocalFile</code>.</p> - -<dl> - <dt><code>initWithPath</code> </dt> - <dd>Cette méthode est utilisée pour initialiser le chemin et le nom du fichier pour l'interface <code>nsILocalFile</code>. Le premier paramètre doit être le chemin du fichier, comme par exemple '/usr/local/mozilla'.</dd> - <dt><code>leafName</code> </dt> - <dd>Le nom du fichier sans son chemin complet.</dd> - <dt><code>fileSize</code> </dt> - <dd>La taille du fichier.</dd> - <dt><code>isDirectory()</code> </dt> - <dd>Renvoie 'true' si <code>nsILocalFile</code> représente un répertoire.</dd> - <dt><code>remove(recursif)</code> </dt> - <dd>Efface un fichier. Si le paramètre <code>recursif</code> est 'true', le répertoire et tous ses fichiers et sous-répertoires sont effacés.</dd> - <dt><code>copyTo ( repertoire, nouveauNom )</code> </dt> - <dd>Copie un fichier dans un autre répertoire, et optionnellement renomme le fichier. La variable <code>repertoire</code> doit être un objet <code>nsILocalFile</code> représentant le répertoire où l'on veut copier le fichier.</dd> - <dt><code>moveTo ( repertoire, nouveauNom )</code> </dt> - <dd>Déplace le fichier dans un autre répertoire ou le renomme. La variable <code>repertoire</code> doit être un objet <code>nsILocalFile</code> représentant le répertoire où l'on va mettre le fichier.</dd> -</dl> - -<p>Pour effacer un fichier, on doit d'abord l'assigner à un objet <code>nsILocalFile</code>. Nous appelons la méthode <code>initWithPath()</code> pour définir le fichier en question, en indiquant juste le chemin de celui-ci. Puis nous appelons la fonction <code>remove()</code> avec le paramètre <code>recursif</code> à 'false'. Voici le code correspondant :</p> - -<pre>var aFile = Components.classes["@mozilla.org/file/local;1"].createInstance(); -if (aFile instanceof Components.interfaces.nsILocalFile){ - aFile.initWithPath("/mozilla/testfile.txt"); - aFile.remove(false); -} -</pre> - -<p>Ce code prend le fichier '/mozilla/testfile.txt' et l'efface. Essayez cet exemple en ajoutant le code à un gestionnaire d'évènements. Vous devez changer le nom du fichier pour qu'il corresponde à un fichier existant que vous voulez effacer sur votre poste local.</p> - -<p>Dans la liste ci-dessus, nous avons vu deux fonctions <code>copyTo()</code> et <code>moveTo()</code>. Ces fonctions sont utilisées pour respectivement copier et déplacer des fichiers.</p> - -<div class="note">Notez que ces fonctions ne prennent pas en paramètre une chaîne de caractères pour désigner un répertoire mais un objet <code>nsILocalFile</code>. Cela signifie que nous devons récupérer les deux composants "fichier".</div> - -<p>L'exemple suivant montre comment copier un fichier :</p> - -<pre>function copyFile(sourcefile,destdir) -{ - // récupérer un composant pour le fichier à copier - var aFile = Components.classes["@mozilla.org/file/local;1"] - .createInstance(Components.interfaces.nsILocalFile); - if (!aFile) return false; - - // récupérer un composant pour le répertoire où la copie va s'effectuer. - var aDir = Components.classes["@mozilla.org/file/local;1"] - .createInstance(Components.interfaces.nsILocalFile); - if (!aDir) return false; - - // ensuite, on initialise les chemins - aFile.initWithPath(sourcefile); - aDir.initWithPath(destdir); - - // Au final, on copie le fichier sans le renommer - aFile.copyTo(aDir,null); -} - -copyFile("/mozilla/testfile.txt","/etc"); -</pre> - -<h3 id="Les_services_XPCOM" name="Les_services_XPCOM">Les services XPCOM</h3> - -<p>Certains composants XPCOM spéciaux sont appelés services. Vous ne pouvez pas créer plusieurs instances d'un service parce qu'il doit être unique. Les services fournissent des fonctions manipulant des données globales ou effectuent des opérations sur d'autres objets. Au lieu d'utiliser <code>createInstance()</code>, vous devez appeler <code>getService()</code> pour récupérer une référence sur le composant de type "service". À part ça, les services ne diffèrent pas des autres composants.</p> - -<p>Un exemple de service fournit par Mozilla est le service pour les marque-pages. Il vous permet d'ajouter un marque-page à la liste courante des marque-pages de l'utilisateur. Voici un exemple :</p> - -<pre>var bmarks = Components.classes["@mozilla.org/browser/bookmarks-service;1"].getService(); -bmarks.QueryInterface(Components.interfaces.nsIBookmarksService); -bmarks.addBookmarkImmediately("http://www.mozilla.org","Mozilla",0,null); -</pre> - -<p>Tout d'abord, le composant <a class="link-mailto" href="mailto:'@mozilla.org" rel="freelink">'@mozilla.org</a>/browser/bookmarks-service;1' est récupéré et son service est placé dans la variable <code>bmarks</code>. Nous utilisons <code>QueryInterface()</code> pour récupérer l'interface 'nsIBookmarksService'. La fonction <code>addBookmarkImmediately()</code> fournie par cette interface peut être utilisée pour ajouter des marque-pages. Les deux premiers paramètres de cette fonction sont l'URL et le titre du marque-page. Le troisième paramètre est le type de marque-page qui doit normalement être '0', et le dernier paramètre est l'encodage des caractères du document correspondant au marque-page, qui peut être nul.</p> - -<hr> -<p>Dans la section suivante, nous verrons quelques-unes des interfaces que l'on peut utiliser, fournies par Mozilla.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Exemples_XPCOM">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/introduction/index.html deleted file mode 100644 index c19e397929..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Introduction -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Introduction -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Introduction ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/La_structure_XUL">Suivant »</a></p> -</div> -<p>Ce tutoriel est destiné à vous guider dans l'apprentissage de<abbr title="XML User-interface Language"> XUL</abbr> (XML User-interface Language) qui est un langage multi plates-formes permettant de décrire les interfaces utilisateurs des applications.</p> -<p>Ce tutoriel vous montrera la création d'une simple interface utilisateur de recherche de fichiers, comme celle fournie par l'interface Sherlock du Macintosh, ou la boîte de dialogue de recherche de fichier de Windows.</p> -<p>Notez que seule l'interface utilisateur sera créée avec quelques fonctionnalités limitées. La recherche de fichiers proprement dite ne sera pas implémentée. Une ligne bleue apparaîtra sur la gauche des paragraphes où la boîte de dialogue de recherche de fichier sera modifiée. Vous pourrez suivre cela à travers les sections.</p> -<h3 id="Qu.27est_ce_que_XUL_et_pourquoi_a-t-il_.C3.A9t.C3.A9_cr.C3.A9.C3.A9.C2.A0.3F" name="Qu.27est_ce_que_XUL_et_pourquoi_a-t-il_.C3.A9t.C3.A9_cr.C3.A9.C3.A9.C2.A0.3F">Qu'est ce que XUL et pourquoi a-t-il été créé ?</h3> -<p><abbr title="XML User-Interface Language">XUL</abbr> (prononcez <em>zool</em>, cela rime avec cool) a été créé pour avoir un développement du navigateur Mozilla plus facile et plus rapide. C'est un langage <abbr title="eXtensible Markup Language">XML</abbr> donc toutes les caractéristiques disponibles dans XML le sont également dans XUL.</p> -<p>La plupart des applications ont besoin d'être développées en utilisant les caractéristiques d'une plate-forme spécifique, rendant l'adaptation multi plate-forme consommatrice en temps et coûteuse. Un certain nombre de solutions multi plates-formes ont été développées dans le passé. Java, par exemple, a comme principal argument de vente la portabilité. XUL est l'un de ces langages conçus spécialement pour créer des interfaces utilisateurs portables. Cela prend beaucoup de temps pour bâtir une application, même pour une seule plate-forme. Le temps requis pour compiler et débugger peut être long. Avec XUL, une interface peut être implémentée et modifiée rapidement et facilement.</p> -<p>XUL a tous les avantages des autres langages XML. Par exemple, XHTML ou d'autres langages XML comme <abbr title="Math Markup Langage">Math-ML</abbr> ou <abbr title="Scalable Vector Graphics">SVG</abbr> peuvent y être insérés. De plus, les textes affichés avec XUL sont aisément localisables, ce qui signifie qu'ils peuvent être traduits dans d'autres langues avec peu d'effort.</p> -<h3 id="Quels_types_d.27interface_utilisateurs_peuvent_.C3.AAtre_r.C3.A9alis.C3.A9s_avec_XUL.C2.A0.3F" name="Quels_types_d.27interface_utilisateurs_peuvent_.C3.AAtre_r.C3.A9alis.C3.A9s_avec_XUL.C2.A0.3F">Quels types d'interface utilisateurs peuvent être réalisés avec XUL ?</h3> -<p>XUL offre la possibilité de créer la plupart des éléments habituels que l'on rencontre dans des interfaces graphiques modernes. Voici quelques éléments pouvant être créés :</p> -<ul> - <li>Champs de saisie tels que des boîtes de textes et des cases à cocher</li> - <li>Barres d'outils avec boutons et autres contenus</li> - <li>Menus dans des barres de menus ou des menus surgissants (contextuels)</li> - <li>Boîtes de dialogues à onglets</li> - <li>Arbres de données hiérarchiques ou tabulaires</li> - <li>Raccourcis claviers</li> -</ul> -<p>Le contenu affiché peut être créé à partir du contenu d'un fichier XUL ou à partir d'une source de données. Dans Mozilla, de telles sources de données sont utilisées pour les messages des boîtes aux lettres, les marque-pages, et les résultats de recherche. Les contenus des menus, arbres, et autres éléments peuvent être remplis avec ces données, ou avec vos propres données fournies dans des fichiers <abbr title="Resource Description Framework">RDF</abbr>.</p> -<p>Il existe plusieurs cas où des applications XUL sont créées :</p> -<ul> - <li>Extension Firefox - une extension ajoute des fonctionnalités au navigateur lui-même, souvent sous la forme d'une barre d'outils supplémentaire, des menus contextuels, ou une interface pour personnaliser le navigateur. Pour obtenir ce résultat, une fonctionnalité du XUL appelé <em>overlay</em> est employée. Elle permet de faire fusionner une interface existante telle que le navigateur Firefox avec une interface utilisateur de l'extension. Des extensions peuvent également être appliquées à d'autres produits Mozilla tels que Thunderbird.</li> - <li>Application XULRunner autonome - XULRunner est une version empaquetée d'une plate-forme Mozilla permettant de créer des applications XUL autonomes. Aucun navigateur n'est requis pour lancer ces applications car elles contiennent leur propres fichiers exécutables.</li> - <li>Paquetage XUL - à mi chemin entre les deux autres se situent les applications créées de la même manière qu'une extension, mais fonctionnant comme une application indépendante dans une fenêtre séparée. Ces paquetages sont employés lorsque vous ne souhaitez pas d'une imposante application complète XULRunner sans pour autant imposer l'installation d'un navigateur Mozilla.</li> - <li>Application XUL distante - vous pouvez également simplement placer du code XUL sur un serveur Web et l'ouvrir dans un navigateur comme pour n'importe quelle page Web. Cette méthode a toutefois ses limites pour des questions de sécurité sur les actions que vous pouvez réaliser, telle que l'ouverture d'autres fenêtres.</li> -</ul> -<p>Les trois premiers types nécessitent chacun une installation sur la machine de l'utilisateur. De ce fait, ces types d'applications n'ont aucune restriction de sécurité et peuvent accéder au système de fichiers local, ou lire et écrire des préférences par exemple. Pour des extensions, les fichiers XUL et leurs scripts et images associés seront empaquetés dans un unique fichier qui sera téléchargé et installé par l'utilisateur. Des applications Mozilla telle que Firefox fournissent un gestionnaire d'extensions permettant l'installation de paquetages sans avoir à écrire beaucoup de code complexe.</p> -<p>Il est possible d'ouvrir des fichiers XUL directement depuis le système de fichiers ou à partir d'un site Web distant. Cependant, ils seront restreints dans les types d'opérations qu'ils peuvent effectués, et certains aspects de XUL ne fonctionneront pas. Toutefois, si vous voulez charger du contenu XUL à partir d'un site distant, le serveur Web doit être configuré pour envoyer les fichiers XUL avec le type de contenu <var>'application/vnd.mozilla.xul+xml'</var>. XUL est habituellement stocké dans des fichiers avec l'extension <code>.xul</code>. Vous pouvez ouvrir un fichier XUL avec Mozilla comme vous le feriez avec d'autres fichiers, en utilisant la commande 'Ouvrir un fichier…' du menu 'Fichier', ou en tapant l'URL dans la barre d'adresse.</p> -<h3 id="Que_dois-je_savoir_pour_comprendre_le_tutoriel.C2.A0.3F" name="Que_dois-je_savoir_pour_comprendre_le_tutoriel.C2.A0.3F">Que dois-je savoir pour comprendre le tutoriel ?</h3> -<p>Vous devez connaître <abbr title="HyperText Markup Language">HTML</abbr> et avoir au moins des connaissances de base sur XML et <abbr title="Cascading Style Sheets">CSS</abbr>. Voici quelques indications à garder à l'esprit :</p> -<ul> - <li>Les éléments XUL et attributs doivent être en minuscule car XML est sensible à la casse (contrairement à HTML).</li> - <li>Les valeurs d'attributs doivent être placés entre guillemets, même si ce sont des nombres.</li> - <li>Les fichiers XUL sont habituellement divisés en quatre fichiers : un pour la mise en page et les éléments, un pour les styles, un pour les déclarations d'entités (utilisées pour la localisation) et un pour les scripts. De plus, vous pouvez avoir des fichiers supplémentaires pour les images ou les données spécifiques à la plate-forme.</li> -</ul> -<p>XUL est supporté dans Mozilla et les navigateurs basés sur le moteur Gecko, comme Netscape 6 ou plus, et Mozilla Firefox. À cause des différents changements dans la syntaxe XUL au fil du temps, vous devriez avoir la dernière version pour que les exemples fonctionnent correctement. La plupart des exemples devraient fonctionner dans Mozilla 1.0 et plus. XUL est pratiquement similaire dans Firefox que dans les autres navigateurs, bien qu'il y ait des différences spécifiques, comme le support des barres de boutons personnalisables.</p> -<p>Ce tutoriel tente de couvrir la plupart des fonctionnalités de XUL. Cependant, toutes les spécificités ne seront pas examinées. Une fois que vous vous serez familiarisés avec XUL, vous pourrez utiliser <a href="/fr/Référence_XUL" title="fr/Référence_XUL">la référence des éléments XUL</a> pour trouver les autres fonctionnalités supportées par d'autres éléments spécifiques.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/La_structure_XUL">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_rdf/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_rdf/index.html deleted file mode 100644 index 6bbbb8e7a4..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_rdf/index.html +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: Introduction à RDF -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Introduction_à_RDF -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Introduction_to_RDF ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes_des_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Gabarits">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons nous intéresser à RDF (Resource Description Framework).</p> - -<h3 id="Resource_Description_Framework" name="Resource_Description_Framework">Resource Description Framework</h3> - -<p>Nous pouvons utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> pour afficher un ensemble de données, telles que des marque-pages ou des courriels. Cependant, il ne serait pas pratique de le faire en entrant les données directement dans le fichier <a href="/fr/XUL" title="fr/XUL">XUL</a>. Il serait très difficile de modifier les marque-pages s'ils étaient directement dans le fichier XUL. Le moyen de résoudre cette difficulté est d'utiliser des sources de données RDF.</p> - -<p><a href="/fr/RDF" title="fr/RDF">RDF</a> (Resource Description Framework) est un format qui peut être utilisé pour stocker des ressources telles que des marque-pages ou des courriels. Alternativement, on peut utiliser des données dans d'autres formats et écrire du code qui va lire le fichier et créer le fichier de données RDF. C'est de cette façon que Mozilla fonctionne quand il lit des données telles que les marque-pages, l'historique ou les messages de courriel. Mozilla fournit des sources de données pour ces données communes pour que vous puissiez facilement les utiliser.</p> - -<p>Vous pouvez utiliser n'importe quelles sources de données RDF fournies pour peupler les arbres <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> avec des données ou vous pouvez désigner un fichier RDF au format XML contenant les données. Elles sont très commodes pour afficher des arbres contenant beaucoup de lignes. RDF peut aussi peupler d'autres éléments XUL comme les <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> et les <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code>. Nous verrons cela dans la prochaine section.</p> - -<p>Un très bref aperçu de RDF sera fourni ici. Pour un guide de RDF plus détaillé, lisez <a class="external" href="http://www.xulplanet.com/tutorials/mozsdk/rdfstart.php">Introduction to the RDF Model (en)</a>. Il est recommandé de lire ce guide si vous êtes débutant en RDF.</p> - -<p>Pour plus d'information sur le RDF, consultez <a class="external" href="http://www.w3.org/RDF/">les spécifications RDF (en)</a>.</p> - -<h4 id="RDF.2FXML" name="RDF.2FXML">RDF/XML</h4> - -<p>RDF consiste en un modèle, qui est une représentation des données sous forme de graphe. RDF/XML est un langage XML utilisé pour représenter des données RDF. Il contient un ensemble assez simple d'éléments. L'exemple ci-dessous montre un gabarit RDF minimal.</p> - -<pre><?xml version="1.0"?> -<RDF:RDF - xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> - ... -</RDF:RDF> -</pre> - -<p>Il a quelques similitudes avec l'en-tête XUL. À la place de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>, l'élément <code>RDF</code> est utilisé. Vous pouvez voir que l'espace de nommage pour RDF a été déclaré pour que les éléments RDF soient reconnus proprement. À l'intérieur de l'élément RDF, vous placerez les données. Pour voir quelques exemples de fichiers RDF/XML, regardez ceux présents avec Mozilla. Ils ont une extension .rdf.</p> - -<h4 id="Base_de_donn.C3.A9es_RDF" name="Base_de_donn.C3.A9es_RDF">Base de données RDF</h4> - -<p>Prenons l'exemple d'une liste de marque-pages générée à partir de RDF. Une liste de marque-pages contient un ensemble d'enregistrements, chacun avec un ensemble de données associées, telles que l'URL, le titre et une date de visite.</p> - -<p>Pensez aux marque-pages comme une base de données qui est stockée comme une grande table avec de nombreux champs. Dans le cas de RDF cependant, les listes peuvent être hiérarchisées. C'est nécessaire pour que nous puissions avoir des dossiers ou des catégories de marque-pages. Chacun des champs dans la base de données RDF est une ressource, avec un nom associé. Le nom est décrit par un URI.</p> - -<p>Par exemple, une selection de champs dans la liste de marque-pages de Mozilla est décrite par les URIs ci-dessous :</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td>Name</td> - <td><span class="nowiki">http://home.netscape.com/NC-rdf#Name</span></td> - <td>Nom du marque-page</td> - </tr> - <tr> - <td>URL</td> - <td><span class="nowiki">http://home.netscape.com/NC-rdf#URL</span></td> - <td>URL correspondante</td> - </tr> - <tr> - <td>Description</td> - <td><span class="nowiki">http://home.netscape.com/NC-rdf#Description</span></td> - <td>description du marque-page</td> - </tr> - <tr> - <td>Last Visited</td> - <td><span class="nowiki">http://home.netscape.com/WEB-rdf#LastVisitDate</span></td> - <td>Date de dernière visite</td> - </tr> - </tbody> -</table> - -<p>Ils sont générés en prenant le nom de l'espace de nommage (<abbr title="Note du Traducteur">NdT</abbr> : exemple : '<span class="nowiki">http://home.netscape.com/NC-rdf</span>') et en ajoutant le nom du champ (<abbr title="Note du Traducteur">NdT</abbr> : exemple : '#Name'). Dans la prochaine section, nous verrons comment les utiliser pour remplir les valeurs des champs automatiquement. Notez que la dernière date de visite a un espace de nommage légèrement différent des trois autres.</p> - -<h4 id="Exemple_de_fichier_RDF.2FXML" name="Exemple_de_fichier_RDF.2FXML">Exemple de fichier RDF/XML</h4> - -<p>Voici maintenant un exemple de fichier RDF/XML listant une table avec trois enregistrements et trois champs.</p> - -<pre><RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:ANIMALS="http://www.some-fictitious-zoo.com/rdf#"> - - <RDF:Seq about="http://www.some-fictitious-zoo.com/all-animals"> - <RDF:li> - <RDF:Description about="http://www.some-fictitious-zoo.com/mammals/lion"> - <ANIMALS:name>Lion</ANIMALS:name> - <ANIMALS:species>Panthera leo</ANIMALS:species> - <ANIMALS:class>Mammifère</ANIMALS:class> - </RDF:Description> - </RDF:li> - <RDF:li> - <RDF:Description about="http://www.some-fictitious-zoo.com/arachnids/tarantula"> - <ANIMALS:name>Tarantule</ANIMALS:name> - <ANIMALS:species>Avicularia avicularia</ANIMALS:species> - <ANIMALS:class>Arachnide</ANIMALS:class> - </RDF:Description> - </RDF:li> - <RDF:li> - <RDF:Description about="http://www.some-fictitious-zoo.com/mammals/hippopotamus"> - <ANIMALS:name>Hippopotame</ANIMALS:name> - <ANIMALS:species>Hippopotamus amphibius</ANIMALS:species> - <ANIMALS:class>Mammifère</ANIMALS:class> - </RDF:Description> - </RDF:li> - </RDF:Seq> -</RDF:RDF> -</pre> - -<div class="note"><abbr title="Note du Traducteur">NdT</abbr> : les spécifications du format RDF précisent qu'il faut toujours indiquer l'espace de nom RDF pour les attributs du langage RDF comme <code id="a-ID"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ID">ID</a></code> <code id="a-about"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/about">about</a></code>, <code id="a-resource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resource">resource</a></code> etc. Pour être en conformité avec ces spécifications, vous devrez toujours déclarer un alias d'espace de nom (comme 'RDF' dans l'exemple précédent : <code><span class="nowiki">xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span></code>) et l'utiliser pour les attributs RDF (ex : <code><strong>RDF:</strong>about="..."</code>).</div> - -<p>Ici, trois enregistrements ont été décrits, un pour chaque animal. Chaque balise <code>RDF:Description</code> décrit un seul enregistrement. À l'intérieur de chaque enregistrement, trois champs sont décrits, 'name', 'species' et 'class'. Il n'est pas nécessaire que tous les enregistrements aient les mêmes champs mais cela donne plus de sens.</p> - -<p>À chacun des trois champs a été donné un espace de nommage appelé 'ANIMALS', dont l'URL a été déclarée dans la balise <code>RDF</code>. Ce nom a été choisi pour sa signification dans ce cas précis, mais nous aurions pu en choisir un autre. La fonctionnalité d'espace de nommage est utile car le champ 'class' peut entrer en conflit avec celui utilisé pour les styles.</p> - -<p>Les éléments <code>Seq</code> et <code>li</code> sont utilisés pour indiquer que les enregistrements sont dans une liste. C'est la même façon dont les listes HTML sont déclarées. L'élément <code>Seq</code> est utilisé pour indiquer que les éléments sont ordonnés. À la place de l'élément <code>Seq</code>, vous pouvez aussi utiliser l'élément <code>Bag</code> pour indiquer des données non ordonnées, et <code>Alt</code> pour indiquer des données où chaque enregistrement spécifie des valeurs alternatives (telles que des URLs mirroirs).</p> - -<p>À l'intérieur d'un fichier XUL, il est fait référence aux ressources en combinant l'URL de l'espace de nommage suivit du nom du champ. Dans l'exemple ci-dessus, les URIs suivants générés peuvent être utilisés pour référer aux champs spécifiques :</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td>Nom</td> - <td><span class="nowiki">http://www.www.some-fictitious-zoo.com/rdf#name</span></td> - </tr> - <tr> - <td>Espèce</td> - <td><span class="nowiki">http://www.www.some-fictitious-zoo.com/rdf#species</span></td> - </tr> - <tr> - <td>Classe</td> - <td><span class="nowiki">http://www.www.some-fictitious-zoo.com/rdf#class</span></td> - </tr> - </tbody> -</table> - -<hr> -<p>Dans la suite, nous allons voir comment utiliser RDF pour peupler des éléments XUL</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes_des_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Gabarits">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_xbl/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_xbl/index.html deleted file mode 100644 index 7730e47a24..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/introduction_à_xbl/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Introduction à XBL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Introduction_à_XBL -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Introduction_to_XBL ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_fichiers_de_propriétés" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Contenu_anonyme">Suivant »</a></p> -</div> -<p><a href="/fr/XUL" title="fr/XUL">XUL</a> a un langage qui lui est parent, <a href="/fr/XBL" title="fr/XBL">XBL</a> (eXtensible Bindings Language). Ce langage est utilisé pour déclarer le comportement des éléments graphiques de XUL.</p> -<h3 id="Liaisons" name="Liaisons">Liaisons</h3> -<p>Vous pouvez utiliser XUL pour définir la mise en page de l'interface utilisateur d'une application. Vous pouvez adapter l'apparence des éléments en leur appliquant <a href="/fr/Tutoriel_XUL/Ajouter_des_feuilles_de_style" title="fr/Tutoriel_XUL/Ajouter_des_feuilles_de_style">des styles</a>. Vous pouvez aussi <a href="/fr/Tutoriel_XUL/Créer_un_thème" title="fr/Tutoriel_XUL/Créer_un_thème">créer de nouveaux thèmes</a> en modifiant les styles. L'apparence basique de tous les éléments, comme <a href="/fr/Tutoriel_XUL/Barres_de_défilement" title="fr/Tutoriel_XUL/Barres_de_défilement">les barres de défilement</a> et <a href="/fr/Tutoriel_XUL/Les_champs_de_saisie#Les_cases_.C3.A0_cocher_et_les_boutons_radio" title="fr/Tutoriel_XUL/Les_champs_de_saisie#Les_cases_.C3.A0_cocher_et_les_boutons_radio">les cases à cocher</a> pourrait être modifiée en ajustant le style ou en déclarant des attributs à l'élément. Cependant, XUL ne fournit aucun moyen de vous permettre de changer le fonctionnement d'un élément. Par exemple, vous pourriez vouloir changer le fonctionnement des composants d'une barre de défilement. Pour cela, vous avez besoin de <a href="/fr/XBL" title="fr/XBL">XBL</a>.</p> -<p>Un fichier XBL contient un ensemble de liaisons. Chaque liaison décrit le comportement d'un élément graphique de XUL. Par exemple, une liaison pourrait être attachée à une barre de défilement. Le comportement décrit les propriétés et méthodes de la barre de défilement en plus de décrire les éléments de XUL qui la composent.</p> -<p>Comme XUL, XBL est un langage XML, ainsi il a des règles syntaxiques similaires. L'exemple suivant montre le squelette basique d'un fichier XBL :</p> -<pre><?xml version="1.0"?> -<bindings xmlns="http://www.mozilla.org/xbl"> - <binding id="binding1"> - <!-- le contenu, propriétés, méthodes et descriptions d'évènements viennent ici --> - </binding> - <binding id="binding2"> - <!-- le contenu, propriétés, méthodes et descriptions d'évènements viennent ici --> - </binding> -</bindings> -</pre> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code> est l'élément racine d'un fichier XBL et contient un ou plusieurs élément <code><a href="/fr/docs/Mozilla/Tech/XUL/binding" title="binding">binding</a></code>. Chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/binding" title="binding">binding</a></code> déclare une seule liaison. L'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> peut être utilisé pour identifier la liaison, comme dans l'exemple ci-dessus. Le modèle a deux liaisons, l'une appelée 'liaison1' et l'autre appelée 'liaison2'. L'une pourrait être attachée à une barre de défilement et l'autre à un menu. Une liaison peut être attachée à n'importe quel élément de XUL. Si vous utilisez des classes CSS, vous pouvez utiliser autant de liaisons que vous avez besoin. Notez l'espace de nommage de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code> dans le modèle ci-dessus. Il déclare que nous sommes en train d'utiliser une syntaxe XBL.</p> -<p>Vous assignez une liaison à un élément en déclarant la propriété CSS <a href="/fr/CSS/-moz-binding" title="fr/CSS/-moz-binding">-moz-binding</a> avec l'URL des fichiers de liaisons. Par exemple :</p> -<pre>scrollbar { - -moz-binding: url('chrome://findfile/content/findfile.xml#binding1'); -} -</pre> -<p>L'URL pointe vers la liaison avec l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> 'binding1' dans le fichier '<a class=" external" rel="freelink">chrome://findfile/content/findfile.xml</a>'. La syntaxe '#binding1' est utilisée pour pointer vers une liaison spécifique, de la même façon que si vous pointiez vers une ancre dans un fichier HTML. Vous mettrez habituellement toutes vos liaisons dans un seul fichier. Le résultat dans cet exemple, est que toutes les barres de défilement auront leur comportement décrit par la liaison "binding1".</p> -<p>Une liaison déclare cinq types de choses :</p> -<ol> <li>Le contenu : les éléments fils qui sont ajoutés à l'élément auquel la liaison est attachée.</li> <li>Les propriétés : les propriétés ajoutées à l'élément. Elles sont accessibles par un script.</li> <li>Les méthodes : les méthodes ajoutées à l'élément. Elles peuvent être appelées à partir d'un script.</li> <li>Les événements : les événements, comme les clics de souris et les appuis sur les touches auxquels l'élément répondra. La liaison peut ajouter des scripts pour fournir la manipulation par défaut. En plus de cela, de nouveaux événements peuvent être définis.</li> <li>Le style : adapte les propriétés de style que l'élément XBL possède.</li> -</ol> -<h3 id="Exemple_de_liaison" name="Exemple_de_liaison">Exemple de liaison</h3> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> est suffisamment générique pour que vous l'utilisiez afin de créer des éléments graphiques personnalisés (bien que vous puissiez utiliser d'autres éléments, même un élément composé par vous-même). En assignant un attribut <code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code> à une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code>, vous associez une liaison aux boîtes qui possèdent cette classe. L'exemple suivant le démontre :</p> -<pre class="eval"><strong>XUL (example.xul):</strong> - -<?xml version="1.0"?> -<?xml-stylesheet href="<a class=" external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> -<?xml-stylesheet href="<a class=" external" rel="freelink">chrome://example/skin/example.css</a>" type="text/css"?> - -<window - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - <box class="okcancelbuttons"/> -</window> - -<strong>CSS (example.css):</strong> - -box.okcancelbuttons { - -moz-binding: url('<a class=" external" rel="freelink">chrome://example/skin/example.xml#okcancel'</a>); -} - -<strong>XBL (example.xml):</strong> - -<?xml version="1.0"?> -<bindings xmlns="<span class="nowiki">http://www.mozilla.org/xbl</span>" - xmlns:xul="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - <binding id="okcancel"> - <content> - <xul:button label="OK"/> - <xul:button label="Annuler"/> - </content> - </binding> -</bindings> -</pre> -<p>Cet exemple crée une fenêtre avec une seule boîte. La boîte a été déclarée pour avoir un attribut <code>class</code> de valeur 'okcancelbuttons'. La feuille de styles associée au fichier indique que les boîtes avec les classes 'okcancelbuttons' ont une liaison spécialisée, définie dans le fichier XBL. Vous pouvez employer d'autres éléments derrière l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code>, même pour votre propre balise adaptée.</p> -<p>Nous verrons plus de détails concernant la partie XBL dans la section suivante. Cependant, pour récapituler, cet exemple entraîne l'ajout automatique de deux boutons dans la boîte, un bouton 'Ok' et un autre 'Annuler'.</p> -<hr> -<p>Dans la prochaine section, nous verrons comment créer un contenu avec XBL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Les_fichiers_de_propriétés" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Contenu_anonyme">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/l'url_chrome/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/l'url_chrome/index.html deleted file mode 100644 index 603447d0d8..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/l'url_chrome/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: L'URL Chrome -slug: Archive/Mozilla/XUL/Tutoriel_XUL/L'URL_Chrome -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/The_Chrome_URL ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/La_structure_XUL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_fichiers_manifest">Suivant »</a></p> -</div> -<p>Cette section décrit comment faire référence à des documents XUL et d'autres fichiers chrome.</p> -<h3 id="L.27URL_Chrome" name="L.27URL_Chrome">L'URL Chrome</h3> -<p>Les fichiers XUL peuvent être référencés par une URL HTTP habituelle tout comme les fichiers HTML (ou tout autre type d'URL). En revanche, les paquetages qui sont installés sur le système chrome de Mozilla doivent être référencés avec des URLs spéciales appelées « chrome ». Les paquetages livrés avec Mozilla seront déjà installés mais vous pouvez déclarer les votres.</p> -<p>Les paquetages installés ont l'avantage de ne pas avoir de restrictions de sécurité, ce qui est nécessaire pour de nombreuses applications. Un autre avantage comparé aux autres types d'URLs est qu'ils manipulent automatiquement les thèmes graphiques (<abbr title="Note du Traducteur">NdT</abbr> : skins) et les localisations (<abbr title="Note du Traducteur">NdT</abbr> : locales). Par exemple, une URL chrome vous permet d'adresser un fichier dans le thème, comme une image, sans avoir besoin de connaître le thème utilisé par l'utilisateur. Tant que les noms de fichiers sont identiques dans chaque thème, vous pouvez vous y faire référence via une URL chrome. Mozilla déterminera où le fichier est situé et renverra la bonne donnée. Cela signifie aussi que l'emplacement où le paquetage est installé n'est pas important pour être capable d'y accéder. Les URLs chrome sont indépendantes du lieu où les fichiers sont stockés physiquement. Il est donc simple d'écrire des applications contenant beaucoup de fichiers sans vous soucier des détails concernant leurs chemins d'accès.</p> -<p>La syntaxe de base d'une URL chrome est la suivante :</p> -<pre class="eval">chrome://<em><paquetage></em>/<em><partie></em>/<em><fichier.xul></em> -</pre> -<p>Le texte <code><paquetage></code> est le nom du paquetage, tel que messenger ou editor. Le texte <code><partie></code> vaut soit 'content', soit 'skin', soit 'locale', selon la partie que vous voulez. <code><fichier.xul></code> est simplement le nom du fichier.</p> -<p><strong>Exemple :</strong> <a class="external" rel="freelink">chrome://messenger/content/messenger.xul</a></p> -<p>Ici, l'exemple se réfère à la fenêtre de messagerie. Vous pouvez pointer vers un fichier qui fait partie d'un thème en remplaçant 'content' par 'skin' et en changeant le nom du fichier. De même, vous pouvez pointer vers un fichier qui fait partie de la localisation en utilisant 'locale' au lieu de 'content'.</p> -<p>Quand vous ouvrez une URL chrome, Mozilla consulte sa liste de paquetages installés et essaie de trouver le fichier JAR qui correspond au nom et à la partie recherchés. Le lien entre des URLs et des fichiers JAR est précisé dans les fichiers manifest situés dans le répertoire chrome. Si vous déplaciez le fichier messenger.jar autre part et que vous modifiez le fichier manifest en conséquence, Thunderbird fonctionnerait encore puisque ce fichier n'est pas dépendant de l'emplacement de son installation. En utilisant des URLs chrome, ce genre de détails est secondaire pour Mozilla. De même, si les utilisateurs changent leur thème graphique, la partie 'skin' de l'URL chrome va pointer vers une autre série de fichiers sans que le XUL et les scripts en soient affectés.</p> -<p>Voici quelques exemples. Notez qu'aucunes URLs ne précisent un thème, une langue ou bien des répertoires spécifiques.</p> -<pre class="eval"><a class="external" rel="freelink">chrome://messenger/content/messenger.xul</a> -<a class="external" rel="freelink">chrome://messenger/content/attach.js</a> -<a class="external" rel="freelink">chrome://messenger/skin/icons/images/folder-inbox.gif</a> -<a class="external" rel="freelink">chrome://messenger/locale/messenger.dtd</a> -</pre> -<p>Pour des sous-répertoires, vous pouvez simplement les ajouter à la fin des URLs chrome. Les URLs suivantes font référence à la fenêtre des marque-pages, aussi bien pour la suite Mozilla que pour Firefox, puisque les noms des paquetages sont différents :</p> -<pre class="eval"><a class="external" rel="freelink">chrome://communicator/content/bookma...rksManager.xul</a> (Mozilla) -<a class="external" rel="freelink">chrome://browser/content/bookmarks/b...rksManager.xul</a> (Firefox) -</pre> -<p>Vous pouvez entrer des URLs chrome partout où des URLs normales peuvent être utilisées. Vous pouvez même les entrer directement dans la barre d'adresse d'une fenêtre du navigateur Mozilla. Si vous entrez une des URLs mentionnées ci-dessus dans la barre d'adresse du navigateur, vous devriez voir cette fenêtre apparaître comme une page Web le ferait et, dans la plupart des cas, elle sera fonctionnelle comme si elle était dans une fenêtre séparée. Cependant, quelques boîtes de dialogue pourraient ne pas bien fonctionner, si elles nécessitent des arguments fournis par la fenêtre qui les a ouvertes.</p> -<p>Vous pourriez voir également des URLs chrome sans noms de fichiers spécifiés, tel que :</p> -<pre class="eval"><a class="external" rel="freelink">chrome://navigator/content/</a> -</pre> -<p>Dans le cas présent, seul le nom du paquetage et la partie sont spécifiés. Ce type de référence sélectionnera automatiquement un fichier approprié depuis le bon répertoire. Pour le contenu, un fichier avec le même nom que le paquetage et une extension xul sont choisis. Dans l'exemple ci-dessus, le fichier browser.xul est choisi. Pour messenger, messenger.xul serait sélectionné. Lorsque vous créez vos propres applications, vous devriez créer un fichier pour votre fenêtre principale avec le même nom que votre paquetage. Ainsi, elle pourra être appelée en utilisant cette syntaxe plus courte. C'est commode car alors, tout ce qu'a besoin de connaître un utilisateur pour pouvoir ouvrir l'application, c'est le nom du paquetage. Bien sûr, pour les extensions qui modifient l'interface du navigateur, l'utilisateur n'aura pas besoin de connaître l'URL car l'extension sera présente elle-même dans l'interface utilisateur.</p> -<p>Pour un thème, le fichier <em><paquetage></em>.css est choisi ; pour une localisation, le fichier <em><paquetage></em>.dtd est choisi.</p> -<p>Souvenez-vous, l'URL chrome n'est pas dépendante à un emplacement sur le disque. Les deux premières pièces sont le nom du paquetage et la partie ('content', 'skin', ou 'locale'). Bien qu'il soit courant de mettre les fichiers de contenu dans un répertoire appelé 'content', c'est une simple convention, et ces fichiers peuvent être placés dans une structure totalement différente.</p> -<hr> -<p>Dans la section suivante, nous verrons comment créer des fichiers .manifest et des paquetages.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/La_structure_XUL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_fichiers_manifest">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/la_structure_xul/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/la_structure_xul/index.html deleted file mode 100644 index 30da6fedbc..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/la_structure_xul/index.html +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: La structure XUL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/La_structure_XUL -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/XUL_Structure ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Introduction" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/L'URL_Chrome">Suivant »</a></p> -</div> - -<p>Nous commencerons par regarder comment le système de fichiers de XUL est organisé sous Mozilla.</p> - -<h3 id="Comment_XUL_est_g.C3.A9r.C3.A9" name="Comment_XUL_est_g.C3.A9r.C3.A9">Comment XUL est géré</h3> - -<p>Dans Mozilla, XUL est géré pratiquement de la même manière que du HTML ou d'autres types de contenu. Lorsque vous entrez l'URL d'une page HTML dans le champs de saisie d'adresse du navigateur, ce dernier localise le site Web et télécharge le contenu. Le moteur d'affichage de Mozilla traite le contenu du code source HTML, et le transforme en un arbre de document. L'arbre est alors converti en un ensemble d'objets qui peuvent être affichés sur l'écran. Des styles <a href="/fr/CSS" title="fr/CSS">CSS</a>, des images et d'autres technologies sont utilisés pour contrôler la présentation. XUL fonctionne de la même manière.</p> - -<p>En fait, sous Mozilla, tous les types de documents, qu'il soit HTML ou XUL, ou même <a href="/fr/SVG" title="fr/SVG">SVG</a>, sont tous traités par le même code sous-jacent. Cela signifie que les mêmes propriétés CSS peuvent être utilisées pour styler à la fois du XUL et du HTML, et beaucoup de spécificités peuvent être partagées entre les deux. Cependant, quelques fonctionnalités restent spécifiques au HTML, comme les formulaires, et d'autres restent spécifiques au XUL, comme les <a href="/fr/Tutoriel_XUL/Overlays" title="fr/Tutoriel_XUL/Overlays">overlays</a>. Puisque les fichiers XUL et HTML sont traités de la même manière, vous pouvez les charger à partir du système de fichiers local, d'une page Web, d'une extension, ou d'une application autonome <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a>.</p> - -<p>Les contenus provenant de sources distantes, comme par exemple <code><span class="nowiki">http://localhost/~username/</span></code>, qu'ils soient en HTML, XUL ou tout autre type de document, sont limités dans les opérations qu'ils peuvent réaliser pour des raisons de sécurité. C'est pour cela que Mozilla fournit une méthode pour installer localement du contenu et de l'enregistrer dans son système <strong><a href="/fr/Chrome" title="fr/Chrome">chrome</a></strong>. Une adresse URL spéciale <code>chrome://</code> est alors employée. Les fichiers ouverts depuis une adresse chrome reçoivent des privilèges plus élevés pour accéder aux fichiers locaux, ils peuvent accéder aux préférences et aux marque-pages, et réaliser d'autres opérations nécessitant certains privilèges. Bien entendu, les pages Web ne disposent pas de ces privilèges, à moins qu'ells soient signées avec un certificat numérique et que l'utilisateur ait obtenu un accès pour cela.</p> - -<p>La déclaration de paquetage chrome est la méthode par laquelle les extensions de Firefox ajoutent des fonctionnalités au navigateur. Les extensions sont de petits paquetages de fichiers XUL, Javascript, feuilles de styles et images, rassemblés en un seul fichier. Ce fichier peut être créé en utilisant un outil ZIP. Quand l'utilisateur le télécharge, il est installé sur sa machine. Il sera intégré dans le navigateur en utilisant une fonctionnalité spécifique appelée <a href="/fr/Overlays_XUL" title="fr/Overlays_XUL">overlay</a>, qui permet au XUL de l'extension et au XUL du navigateur de se combiner ensemble. Pour l'utilisateur, c'est comme si l'extension avait modifié le navigateur, mais en réalité, le code est séparé et l'extension peut être désinstallée facilement.</p> - -<p>Les paquetages déclarés ne sont pas nécessaires pour utiliser les overlays, bien sûr. Si ils ne le sont pas, vous ne pourrez pas y accéder via l'interface principale du navigateur, mais vous pourrez toujours y accéder depuis une URL chrome, si vous la connaissez.</p> - -<p>Des applications XUL autonomes peuvent également employer du code XUL inclus de façon similaire, mais il fera partie intégrante de l'application plutôt que de devoir être installé séparément comme une extension. Cependant, ce code XUL devra être déclaré dans le système chrome pour pouvoir s'afficher dans l'interface utilisateur de l'application.</p> - -<p>Il faut savoir que le navigateur Mozilla lui même regroupe en réalité toute une série de paquetages contenant des fichiers XUL, du JavaScript et des feuilles de styles. Ces fichiers sont ouverts depuis une URL chrome et ils ont des privilèges accrus et fonctionnent comme dans tous autres paquetages. Bien sûr, le navigateur est bien plus conséquent et plus sophistiqué que la plupart des extensions. Firefox et Thunderbird contiennent de nombreux composants qui sont tous écris en XUL et qui sont tous acceesibles via des URLs chrome. Vous pouvez examiner ces paquetages en parcourant le sous répertoire chrome où Firefox ou une application XUL a été installé.</p> - -<p>L'URL chrome commence toujours par 'chrome://'. De la même manière que les URLs <span class="nowiki">'http://'</span> réfèrent toujours aux sites Web distants, et que les URL 'file://' réfèrent toujours aux fichiers locaux, les URL 'chrome://' réfèrent toujours aux paquetages installés et aux extensions. Nous en verrons plus sur la syntaxe des URL chrome dans la prochaine section. Il est important de noter que lorsque l'on accède à du contenu depuis une URL chrome, il obtient les privilèges avancés tel que décrit plus haut contrairement aux autres types d'URL. Par exemple, une URL HTTP n'a pas de privilèges particuliers et une erreur apparaîtrait si une page Web essaie, par exemple, de lire un fichier local, alors qu'un fichier chargé depuis une URL chrome pourra lire des fichiers sans restrictions.</p> - -<p>Cette distinction est importante. Elle signifie qu'il y a certaines choses que le contenu des pages Web ne peut pas faire, comme lire les marque-pages de l'utilisateur. Cette distinction n'est pas basée sur le type du contenu affiché ; seul le type de l'URL est important. HTML et XUL placés sur un site Web n'ont pas de permissions supplémentaires. Mais HTML et XUL chargés avec une URL chrome obtiennent des permissions avancées.</p> - -<p>Si vous désirez utiliser XUL sur un site Web, il vous suffit de mettre les fichiers XUL sur le site Web comme vous le feriez avec un fichier HTML, et indiquer leurs URLs dans un navigateur (<code><span class="nowiki">http://localhost/xul.php</span></code>). Assurez vous que votre serveur Web est configuré pour transmettre les fichiers XUL avec le type mime <strong><code>application/vnd.mozilla.xul+xml</code></strong> (par ex en PHP <code>header('content-type: application/vnd.mozilla.xul+xml');</code>). Ce type mime permet à Mozilla de faire la différence entre HTML et XUL. Mozilla ne tient pas compte de l'extension du fichier sauf pour lire les fichiers locaux, mais vous devriez utiliser l'extension <code>.xul</code> pour tous les fichiers XUL. Vous pouvez ouvrir les fichiers XUL sur votre propre machine en les ouvrant dans le navigateur, ou en double cliquant sur le fichier dans votre gestionnaire de fichiers.</p> - -<div class="note">Souvenez vous que les fichiers XUL distants ont des restrictions significatives sur ce qu'ils peuvent faire.</div> - -<h3 id="Type_de_documents.C2.A0_HTML_XML_XUL_CSS" name="Type_de_documents.C2.A0:_HTML_XML_XUL_CSS">Type de documents : HTML XML XUL CSS</h3> - -<p>Tandis que la plupart des fonctionnalités sont partagées entre HTML et XUL, Mozilla utilise différents types de document pour chacun d'eux. Il y a trois principaux types de document dans Mozilla : HTML, XML et XUL. Bien entendu, le type HTML est utilisé pour les documents HTML, le type XUL est utilisé pour les documents XUL, et le type XML est utilisé pour les autres documents en XML. Puisque XUL est aussi du XML, il correspond à un sous-type du type générique XML. Il y a de subtiles différences dans les fonctionnalités. Par exemple, alors que les contrôles de formulaire dans les pages HTML sont accessibles via la propriété <code>document.forms</code>, cette propriété n'est pas disponible pour les documents XUL puisque XUL n'a pas de formulaire dans le sens HTML du terme. D'un autre coté, les fonctionnalités spécifiques de XUL comme les overlays ou les gabarits ne sont utilisables que dans les documents XUL.</p> - -<p>La distinction entre les documents est importante. Certaines fonctionnalités XUL sont utilisables dans des documents HTML ou XML si elles ne sont pas spécifiques au type de document mais d'autres seront liées au type du document. Par exemple, vous pourrez vous servir des types de mise en page XUL dans d'autres documents car ils ne reposent pas sur le type de document pour fonctionner.</p> - -<p>Pour résumer les points précédents :</p> - -<ul> - <li>Mozilla affiche <a href="/fr/HTML" title="fr/HTML">HTML</a> et <a href="/fr/XUL" title="fr/XUL">XUL</a> en utilisant le même moteur de rendu et utilise <a href="/fr/CSS" title="fr/CSS">CSS</a> pour spécifier leur présentation.</li> - <li>XUL peut être chargé à partir d'un site distant, du système de fichiers local, ou installé comme un paquetage en étant accessible par une URL <a href="/fr/Chrome" title="fr/Chrome">chrome</a>. C'est ce que font les extensions du navigateur.</li> - <li>Les URLs chrome servent à accéder aux paquetages installés en les ouvrant avec des privilèges avancés.</li> - <li>HTML, XML et XUL représentent chacun un type différent de document. Certaines fonctionnalités peuvent être utilisées dans n'importe quel type de document tandis que d'autres sont spécifiques à un type de document.</li> -</ul> - -<p>Les prochaines sections décrivent la structure de base d'un paquetage chrome qui peut être installé dans Mozilla. Cependant, si vous voulez seulement démarrer la création d'une simple application, rendez vous directement sur la page <a href="/fr/Tutoriel_XUL/Créer_une_fenêtre" title="fr/Tutoriel_XUL/Créer_une_fenêtre">Créer une fenêtre</a> et revenez sur cette section plus tard.</p> - -<h3 id="Organisation_d.27un_paquetage" name="Organisation_d.27un_paquetage">Organisation d'un paquetage</h3> - -<p>Mozilla est conçu de telle manière que vous pouvez pré-installer autant de composants que vous le souhaitez. Chaque extension est également un composant muni d'une adresse chrome différente. Il y a également un composant par thèmes graphiques ou langues. Chacun de ces composants, ou paquetages, est constitué d'un ensemble de fichiers décrivant l'interface utilisateur. Par exemple, le composant de messagerie décrit la fenêtre listant les messages des courriers, la fenêtre de rédaction et les boîtes de dialogues du carnet d'adresses.</p> - -<p>Les paquetages inclus dans Mozilla sont situés dans le répertoire chrome situé dans le répertoire d'installation de Mozilla. Ce répertoire chrome est l'endroit où sont situés tous les fichiers qui décrivent l'interface utilisateur employée par Mozilla, tels que le client de messagerie et d'autres applications. Typiquement pour une application, vous placerez vos fichiers XUL dans ce répertoire, sauf pour les extensions où les fichiers sont placés dans le répertoire extensions du profil utilisateur. La simple copie d'un fichier XUL dans le répertoire 'chrome' ne lui donne pas de droits supplémentaires et ne le rend pas accessible depuis une URL chrome. Pour que des droits supplémentaires lui soit attribués, vous devrez créer un fichier manifest et le placez dans le répertoire chrome. Ce fichier est facile à créer car il n'est composé que de quelques lignes. Il sert orienter une URL chrome vers l'emplacement d'un fichier ou d'un répertoire sur le disque où les fichiers XUL sont situés. Vous trouverez plus de détails sur la manière de créer ce fichier dans <a href="/fr/Tutoriel_XUL/Les_fichiers_manifest" title="fr/Tutoriel_XUL/Les_fichiers_manifest">une prochaine section</a>.</p> - -<p>La seule manière pour du contenu d'être accessible depuis une URL chrome est de créer un paquetage comme décrit dans les prochaines sections. Ce répertoire est nommé 'chrome' en référence aux répertoires où sont placés les paquetages chrome de Mozilla.</p> - -<p>Pour augmenter la confusion, il y a deux autres endroits où le mot "chrome" peut apparaître. Il y a l'argument en ligne de commande <code>-chrome</code> et le modificateur "chrome" de la fonction <code><a href="/fr/DOM/window.open" title="fr/DOM/window.open">window.open()</a></code>. L'appel à l'une de ces deux fonctionnalités n'autorise pas plus de privilèges. Elles sont plutôt utilisées pour ouvrir une nouvelle fenêtre principale sans l'interface utilisateur du navigateur comme les menus ou la barre d'outils. Vous utiliserez en général ces caractéristiques dans des applications XUL plus complexes lorsque vous ne voulez pas de fenêtre de navigation autour de vos boîtes de dialogue.</p> - -<p>Les fichiers d'un paquetage sont généralement combinés dans un simple fichier JAR. Un fichier JAR peut être créé et examiné en utilisant un utilitaire ZIP. Par exemple, ouvrez quelques uns des fichiers JAR du répertoire <code>chrome</code> de Mozilla pour voir la structure de leurs paquetages. Bien qu'il soit normal de combiner les fichiers dans un fichier JAR, les paquetages peuvent également être accessibles dans une forme décompressée à l'intérieur d'un ensemble de répertoire. Généralement, vous ne distribuerez pas un paquetage de cette façon, mais c'est une méthode pratique pendant le développement puisque vous pouvez éditer les fichiers du répertoire et ensuite les recharger sans avoir à ré-empaqueter ou réinstaller l'ensemble.</p> - -<p>Par défaut, les applications Mozilla analysent les fichiers XUL et les scripts, et mémorisent une version pré-compilée dans une session de l'application afin d'améliorer les performances. De ce fait, les fichiers XUL ne seront pas rechargés même si les fichiers sources ont été modifiés. Pour modifier ce mécanisme, il est nécessaire de modifier la préférence <code>nglayout.debug.disable_xul_cache</code>. Dans Firefox, cette préférence doit être ajoutée et définie à 'true' dans les préférences de l'utilisateur en tapant "about:config" dans la barre d'adresse. Vous pouvez aussi éditer manuellement le fichier des préférences <code>user.js</code> et y ajouter la ligne suivante :</p> - -<pre class="eval">pref("nglayout.debug.disable_xul_cache", true); -</pre> - -<p>Il y a habituellement trois parties différentes dans un paquetage chrome, bien qu'elles soient facultatives. Chaque partie est enregistrée dans un répertoire différent. Ces trois ensembles décris en dessous sont le contenu, le thème graphique et la localisation. Un paquetage particulier pourrait fournir un ou plusieurs thèmes et localisations, mais un utilisateur peut les remplacer par les siens. De plus, un paquetage peut inclure plusieurs applications différentes, chacune accessible via des URLs chrome différentes. Le système de paquetage est suffisamment souple pour n'inclure que les parties dont vous avez besoin, et permettre le téléchargement séparé d'autres parties, comme le texte pour les différentes langues.</p> - -<p>Les trois types de paquetages chrome sont :</p> - -<p> </p> - -<dl> - <dt><strong>Content</strong> - Fenêtres et scripts</dt> - <dd>Contient les déclarations des fenêtres et des éléments d'interface utilisateur. Ceux-ci sont stockés dans les fichiers XUL, qui ont l'extension xul. Il peut y avoir plusieurs fichiers XUL, mais la fenêtre principale devrait toujours avoir un nom de fichier identique au nom du paquetage. Par exemple, le paquetage editor contiendra un fichier appelé <code>editor.xul</code>. Les scripts (<abbr title="Note du Traducteur">NdT</abbr> : javascript) sont placés dans des fichiers séparés à côté des fichiers XUL.</dd> - <dt><strong>Skin</strong> - feuilles de style, images et autres fichiers de thèmes</dt> - <dd>Les feuilles de style décrivent des détails de l'aspect d'une fenêtre. Elles sont stockées séparément des fichiers XUL pour faciliter la modification du thème d'une application. Toutes les images utilisées sont également stockées ici.</dd> - <dt><strong>Locale</strong> - fichiers spécifiques de langues</dt> - <dd>Tous les textes qui sont affichés dans une fenêtre sont stockés séparément. De cette façon, un utilisateur peut avoir une configuration pour sa propre langue.</dd> -</dl> - -<h3 id="Paquetages_de_contenu" name="Paquetages_de_contenu">Paquetages de contenu</h3> - -<p>Le nom du fichier JAR devrait décrire ce qu'il contient, mais vous pouvez vous en assurer en regardant son contenu. Examinons par exemple le paquetage du navigateur inclus avec Firefox. Si vous décompressez les fichiers de <code>browser.jar</code>, vous verrez qu'ils forment une structure de répertoire ressemblant à :</p> - -<pre>content - browser - browser.xul - browser.js - --d'autres fichiers XUL et JS ici-- - bookmarks - --les fichiers pour les marque-pages ici-- - preferences - --les fichiers pour les préférences ici-- -. -. -.</pre> - -<p>On peut facilement identifier cela comme le contenu d'un paquetage, car le dossier supérieur s'appelle <code>content</code>. Pour les thèmes, le dossier aurait été appelé <code>skin</code> et pour les localisations, il aurait été appelé <code>locale</code>. En fait, ce n'est pas une obligation mais vous devriez suivre cette convention pour rendre votre paquetage plus clair. Certains paquetages peuvent inclure une section <em>content</em>, <em>skin</em> et <em>locale</em>. Dans ces paquetages, vous trouverez un sous-répertoire pour chaque section. Par exemple, Chatzilla est distribué de cette manière.</p> - -<p>Le dossier <code>content/browser</code> contient un certain nombre de fichiers avec les extensions <code>.xul</code> et <code>.js</code>. Les fichiers XUL sont ceux qui ont une extension <code>.xul</code>. Les fichiers avec l'extension <code>.js</code> sont des fichiers de JavaScript contenant les scripts qui gèrent les fonctionnalités d'une fenêtre. Beaucoup de fichiers XUL ont un ou plusieurs fichiers de script qui leur est associé.</p> - -<p>Dans la liste ci-dessus, deux fichiers ont été montrés. Il y en a évidemment d'autres, mais qui n'apparaissent pas pour des raisons de simplicité. Le fichier <code>browser.xul</code> est le fichier XUL qui décrit la fenêtre principale du navigateur. La fenêtre principale du contenu d'un paquetage devrait toujours porter le même nom que le nom du paquetage, avec une extension <code>.xul</code>. Dans ce cas, le paquetage étant nommé 'browser', le fichier sera <code>browser.xul</code>. D'autres fichiers XUL vont décrire des fenêtres différentes, comme par exemple le fichier <code>pageInfo.xul</code> qui décrit la boîte de dialogue 'Information sur la page'.</p> - -<p>Tous les paquetages contiennent un fichier <code>contents.rdf</code> qui décrit le paquetage, son auteur et les overlays qu'il utilise. Ce fichier est cependant devenu obsolète et a été remplacé par une mécanisme plus simple. Cette nouvelle méthode est le fichier manifest mentionné précédemment, et vous trouverez ce fichier dans le répertoire chrome avec une extension <code>.manifest</code>. Par exemple, <code>browser.manifest</code> décrit le paquetage browser.</p> - -<p>Plusieurs sous-répertoires, tels que <code>bookmarks</code> et <code>preferences</code>, décrivent des sections complémentaires au composant du navigateur. Ils sont placés dans des répertoires différents pour une meilleure organisation des fichiers.</p> - -<h3 id="Styles_et_th.C3.A8mes_graphiques" name="Styles_et_th.C3.A8mes_graphiques">Styles et thèmes graphiques</h3> - -<p>Bien que le code sous-jacent de Mozilla les appelle <em>skins</em> et que l'interface utilisateur les appelle <em>thèmes</em>, ils désignent la même chose. Le fichier <code>classic.jar</code> décrit le thème graphique inclus par défaut avec Firefox. La structure est semblable aux paquetages de contenu. Examinons par exemple le fichier <code>classic.jar</code> :</p> - -<pre>skin - classic - browser - browser.css - -- les autres fichiers thèmes du navigateur sont ici -- - global - -- les fichiers thèmes globaux sont ici -- -. -. -.</pre> - -<p>Ici encore, le respect de cette structure de répertoires n'est pas nécessaire, mais elle est conventionnelle. En réalité, vous pouvez mettre les fichiers dans un seul répertoire de niveau supérieur sans aucun sous-répertoire. Cependant, pour des applications plus importantes, des sous-répertoires servent à séparer les différents composants. Dans l'exemple précédent, un répertoire est dédié aux fichiers du thème graphique du navigateur et un autre pour les fichiers du thème global. Le répertoire global contient les fichiers de styles applicables à tous les paquetages. Ces fichiers s'appliquent à tous les composants et seront inclus à toutes vos applications autonomes. La partie globale définit l'apparence de tous les éléments graphiques communs, tandis que les autres répertoires contiennent les fichiers propres à ces applications. Firefox inclut à la fois les fichiers du thème graphique global et du navigateur dans une seule archive, mais ils pourraient être inclus séparément.</p> - -<p>Un thème se compose de fichiers CSS et d'un certain nombre d'images utilisés pour définir l'aspect d'une interface. Le fichier <code>browser.css</code> est utilisé par <code>browser.xul</code> et contient les styles pour définir l'apparence des différences parties de l'interface du navigateur. À nouveau, notez le nom du fichier <code>browser.css</code>, qui a le même nom que le paquetage. En changeant de fichier CSS, vous pouvez modifier l'apparence d'une fenêtre sans changer son fonctionnement. C'est ainsi que vous pouvez créer un nouveau thème. La partie XUL est toujours la même, mais la partie contenant le thème peut varier indépendamment.</p> - -<h3 id="Localisation" name="Localisation">Localisation</h3> - -<p>Le fichier <code>en-US.jar</code> décrit l'information de langage pour chaque composant, dans le cas présent pour l'anglais des États-Unis. Comme pour les thèmes, chaque fichier de langue contient les fichiers qui indiquent le texte utilisé par le paquetage pour une langue spécifique. La structure de 'locale' étant similaire aux autres, elle ne sera pas listée ici.</p> - -<p>Le texte localisé est stocké dans deux types de fichiers, des fichiers DTD et des fichiers de propriétés. Les fichiers DTD ont une extension <code>.dtd</code> et contiennent les déclarations d'entités, une pour chaque chaîne de caractères qui est utilisée dans une fenêtre. Par exemple, le fichier <code>browser.dtd</code> contient des déclarations d'entités pour chaque commande du menu. En outre, des raccourcis clavier pour chaque commandes sont également définis, parce qu'ils peuvent être différents selon la langue. Les fichiers DTD sont utilisés par des fichiers XUL, et donc en général, vous en aurez un par fichier XUL. La partie 'locale' contient également des fichiers de propriétés qui sont similaires, mais qui sont utilisés par les fichiers de script. Le fichier <code>browser.properties</code> contient quelques chaînes de caractères de ce type.</p> - -<p>Cette structure vous permet de traduire Mozilla ou un composant dans une langue différente en ajoutant juste une nouvelle partie 'locale' pour cette langue. Vous n'avez pas à modifier le code XUL. De plus, d'autres personnes peuvent fournir des paquetages séparés qui appliquent des thèmes ou des localisations à votre partie contenu, apportant ainsi un nouveau thème ou une nouvelle langue sans avoir à modifier le paquetage original.</p> - -<h3 id="Autres_paquetages" name="Autres_paquetages">Autres paquetages</h3> - -<p>Il existe un paquetage spécial appelé toolkit (ou global). Nous avions déjà vu le répertoire global pour des thèmes. Le fichier <code>toolkit.jar</code> contient la partie du contenu lui correspondant. Il contient quelques boîtes de dialogues et définitions globales. Il définit également l'aspect par défaut et les fonctionnalités des divers éléments graphiques tels que des champs de saisie et des boutons. Les fichiers situés dans la partie globale de l'archive du thème contiennent l'apparence par défaut de tous les éléments XUL d'interface. Le paquetage toolkit est utilisé par toutes les applications XUL.</p> - -<h3 id="Ajouter_un_paquetage" name="Ajouter_un_paquetage">Ajouter un paquetage</h3> - -<p>Mozilla place dans le répertoire <code>chrome</code> les paquetages qui sont inclus avec l'installation, mais il n'y a pas d'obligation à cela. Lors de l'installation d'un autre paquetage, vous pouvez le placer n'importe où sur le disque dès lors que son fichier manifest pointe vers lui. Il est commun d'installer les nouveaux paquetages dans le répertoire <code>chrome</code> simplement par convenance. Cependant ils fonctionneront aussi bien à partir d'un autre répertoire, ou de quelque part sur votre réseau local. Vous ne pouvez pas les placer sur un site distant, à moins que le site distant soit monté sur le système de fichiers local.</p> - -<p>Il y a deux répertoires <code>chrome</code> utilisés par les applications XUL : l'un est au même emplacement que l'application, l'autre fait partie du profil utilisateur. Le premier permet aux paquetages d'être partagés à tous les utilisateurs tandis que le second permet un accès aux paquetages à un utilisateur spécifique. Les extensions qui sont installées dans un répertoire extension séparé ne sont également accessibles qu'à un utilisateur spécifique. Chaque fichiers manifest situés dans l'un ou l'autre des répertoires chrome seront examinés pour voir quels paquetages sont installés.</p> - -<hr> -<p>Dans la prochaine section, nous regarderons comment se référer aux paquetages en utilisant les URL chrome.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Introduction" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/L'URL_Chrome">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/le_modèle_de_boîte/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/le_modèle_de_boîte/index.html deleted file mode 100644 index 0075e90f94..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/le_modèle_de_boîte/index.html +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: Le modèle de boîte -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Le_modèle_de_boîte -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/The_Box_Model ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_de_caractéristiques_sur_les_boutons" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Positionnement_des_éléments">Suivant »</a></p> -</div> - -<p>Dans cette section, nous allons voir comment XUL gère la mise en page.</p> - -<h3 id="Introduction_aux_bo.C3.AEtes" name="Introduction_aux_bo.C3.AEtes">Introduction aux boîtes</h3> - -<p>La forme principale de mise en page dans XUL s'appelle le « Modèle de Boîte ». Ce modèle vous permet de diviser une fenêtre en une série de boîtes. Les éléments à l'intérieur d'une boîte se placeront horizontalement ou verticalement. En combinant une série de boîtes, d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> et d'éléments avec des attributs <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, vous pouvez contrôler la mise en page d'une fenêtre.</p> - -<p>Bien qu'une boîte soit la partie fondamentale de la disposition d'éléments dans XUL, elle suit quelques règles très simples. Une boîte peut présenter ses enfants dans une des deux orientations, soit horizontalement, soit verticalement. Une boîte horizontale aligne ses éléments horizontalement et une boîte verticale place ses éléments verticalement. Vous pouvez vous représenter une boîte comme étant une rangée ou une colonne d'un tableau HTML. Divers attributs placés sur les éléments enfants, en plus de certaines propriétés de style CSS, contrôlent la position et la taille exactes des enfants.</p> - -<h4 id=".C3.89l.C3.A9ments_de_bo.C3.AEte" name=".C3.89l.C3.A9ments_de_bo.C3.AEte">Éléments de boîte</h4> - -<p>La syntaxe de base d'une boîte est la suivante :</p> - -<pre><hbox> - <!-- éléments horizontaux --> -</hbox> - -<vbox> - <!-- éléments verticaux --> -</vbox> -</pre> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> est utilisé pour créer une boîte orientée horizontalement. Chaque élément placé dans la <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> sera placé horizontalement sur une rangée. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code> est utilisé pour créer une boîte orientée verticalement. Les éléments ajoutés seront placés les uns en dessous des autres en colonne.</p> - -<p>Il existe également un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> générique qui s'oriente horizontalement par défaut, ce qui veut dire qu'il est similaire à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code>. Cependant, vous pouvez utiliser l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> pour contrôler l'orientation dans la boîte. Vous pouvez positionner cet attribut à la valeur 'horizontal' pour créer une boîte horizontale et à la valeur 'vertical' pour créer une boîte verticale.</p> - -<p>Ainsi, les deux lignes ci-dessous sont équivalentes :</p> - -<pre><vbox></vbox> - -<box orient="vertical"></box> -</pre> - -<p>L'exemple suivant montre comment placer trois boutons verticalement.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_1.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_boxes-ex1.png" class="internal" src="/@api/deki/files/1498/=Xultu_boxes-ex1.png"></div> - -<pre><vbox> - <button id="yes" label="Oui"/> - <button id="no" label="Non"/> - <button id="maybe" label="Peut-être"/> -</vbox> -</pre> - -<p>Ces trois boutons sont orientés verticalement comme le spécifie la boîte. Pour faire en sorte que les boutons soient orientés horizontalement, tout ce que vous avez à faire est de remplacer l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code> par l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code>.</p> - -<h4 id="Exemple_d.27invite_de_login" name="Exemple_d.27invite_de_login">Exemple d'invite de login</h4> - -<p>Vous pouvez ajouter autant d'éléments que vous le souhaitez à l'intérieur de la boîte, y compris d'autres boîtes. Dans le cas d'une boîte horizontale, chaque élément additionnel sera placé à la droite du précédent. Les éléments ne se chevauchent pas, donc plus vous ajoutez d'éléments, plus large est la fenêtre. De même, chaque élément ajouté dans une boîte verticale sera placé sous le précédent. L'exemple ci-dessous montre une simple demande de login :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_2.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_boxes-ex2.png" class="internal" src="/@api/deki/files/1499/=Xultu_boxes-ex2.png"></div> - -<pre><vbox> - <hbox> - <label control="login" value="Login :"/> - <textbox id="login"/> - </hbox> - <hbox> - <label control="pass" value="Mot de passe :"/> - <textbox id="pass"/> - </hbox> - <button id="ok" label="OK"/> - <button id="cancel" label="Annuler"/> -</vbox> -</pre> - -<p>Ici quatre éléments ont été orientés verticalement, deux balises <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> internes et deux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>. Notez que seuls les éléments qui sont des descendants directs de la boîte sont orientés verticalement. Les libellés et les boîtes de texte sont à l'intérieur d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code>, donc ils sont orientés suivant ces boîtes, lesquelles sont horizontales. Vous pouvez voir sur l'image que chaque libellé et leur champ de saisie est orienté horizontalement.</p> - -<h4 id="Alignement_des_champs_de_saisie" name="Alignement_des_champs_de_saisie">Alignement des champs de saisie</h4> - -<p>Si vous regardez attentivement l'image de la boîte de dialogue de login, vous verrez que les deux champs de saisie ne sont pas alignés horizontalement. Ce serait certainement mieux s'ils l'étaient. Pour y parvenir, nous devons ajouter quelques boîtes supplémentaires.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxes_3.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_boxes-ex3.png" class="internal" src="/@api/deki/files/1500/=Xultu_boxes-ex3.png"></div> - -<pre><vbox> - <hbox> - <vbox> - <label control="login" value="Login :"/> - <label control="pass" value="Mot de passe :"/> - </vbox> - <vbox> - <textbox id="login"/> - <textbox id="pass"/> - </vbox> - </hbox> - <button id="ok" label="OK"/> - <button id="cancel" label="Annuler"/> -</vbox> -</pre> - -<p>Notez que les champs de saisie sont maintenant alignés l'un avec l'autre. Pour cela, il nous a fallu ajouter des boîtes à l'intérieur de la boîte principale. Les deux libellés et les champs de saisie sont placés à l'intérieur d'une boîte horizontale. Ensuite, les libellés sont placés à l'intérieur d'une autre boîte, une verticale cette fois, de même que les champs de saisie. C'est cette boîte interne qui oriente verticalement les éléments. La boîte horizontale est nécessaire puisque nous voulons que la <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code> des libellés et que la <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code> des champs de saisie soient placées l'une à côté de l'autre. Si cette boîte était enlevée, les champs de saisie apparaîtraient sous les libellés.</p> - -<p>L'ennui est que le libellé « Mot de passe » est désormais trop haut. Il nous faudra utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grid" title="grid">grid</a></code> pour résoudre ce phénomène, ce que nous verrons dans <a href="/fr/Tutoriel_XUL/Grilles" title="fr/Tutoriel_XUL/Grilles">une prochaine section</a>.</p> - -<div class="highlight"> -<h3 id="Des_bo.C3.AEtes_dans_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers" name="Des_bo.C3.AEtes_dans_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers">Des boîtes dans la boîte de dialogue de recherche de fichiers</h3> - -<p>Ajoutons quelques boîtes à la boîte de dialogue de recherche de fichiers. Une boîte verticale sera ajoutée autour de tous les éléments, et une boîte horizontale sera ajoutée autour du champ de saisie et des boutons. Le résultat sera que les boutons apparaîtront sous le champ de saisie.</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxes.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxes.xul">Voir</a></p> - -<pre class="eval"><span class="highlightred"><vbox flex="1"> <description> Entrez votre critère de recherche ci-dessous et sélectionnez le bouton Rechercher pour démarrer la recherche. </description> <hbox></span> - <label value="Rechercher :" control="find-text"/> - <textbox id="find-text"/> - <span class="highlightred"></hbox> <hbox> <spacer flex="1"/></span> - - <button id="find-button" label="Rechercher"/> - <button id="cancel-button" label="Annuler"/> - <span class="highlightred"></hbox> </vbox></span> -</pre> - -<div class="float-right"><img alt="Image:xultu_boxes1.png" class="internal" src="/@api/deki/files/1501/=Xultu_boxes1.png"></div> - -<p>La boîte verticale entraîne l'orientation verticale du texte principal, de la boîte contenant le champ de saisie ainsi que de la boîte avec les deux boutons. Les boîtes internes orientent leurs éléments horizontalement. Comme vous pouvez le voir sur l'image, le libellé et le champ de saisie de texte sont placés côte à côte. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> et les deux boutons sont aussi placés horizontalement dans leur boîte.</p> - -<div class="note">Notez que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code>, parce qu'il est flexible, force les boutons à apparaître sur le côté droit.</div> -</div> - -<hr> -<p>Dans la prochaîne section, nous verrons comment spécifier les tailles des éléments individuellement et comment contraindre leurs tailles.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_de_caractéristiques_sur_les_boutons" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Positionnement_des_éléments">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_boîtes_de_groupe/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_boîtes_de_groupe/index.html deleted file mode 100644 index bba6701791..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_boîtes_de_groupe/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Les boîtes de groupe -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_boîtes_de_groupe -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Groupboxes ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Détails_sur_le_modèle_de_boîte" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajouter_plus_d'éléments">Suivant »</a></p> -</div> - -<p>Cette section décrit la façon d'inclure des éléments dans des groupes.</p> - -<h3 id="Les_bo.C3.AEtes_de_groupes" name="Les_bo.C3.AEtes_de_groupes">Les boîtes de groupes</h3> - -<p>HTML fournit un élément, <code>fieldset</code>, qui peut être utilisé pour regrouper plusieurs éléments. Une bordure est affichée autour des éléments pour montrer qu'ils sont en relation. Un exemple pourrait être un groupe de cases à cocher. XUL fournit un élément équivalent, <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code>, qui peut être utilisé pour un usage similaire.</p> - -<p>Comme son nom l'indique, <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> est un type de boîte. Ce qui signifie que les éléments à l'intérieur sont alignés selon l'application des règles des boîtes. Il y a deux différences entre les boîtes de groupes et les boîtes normales :</p> - -<ul> - <li>Une bordure incrustée est affichée par défaut autour de la boîte. Vous pouvez changer ce comportement en changeant le style CSS.</li> - <li>Les boîtes de groupe ont une légende qui est placée sur la partie haute de la bordure.</li> -</ul> - -<p>Puisque les boîtes de groupe sont des types de boîtes, vous pouvez utiliser les mêmes attributs tels que <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> et <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. Vous pouvez mettre tous les éléments que vous voulez à l'intérieur de la boîte, mais il devra typiquement y avoir un rapport entre eux.</p> - -<p>Le libellé en haut de la boîte de groupe peut être créé en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code>. Il fonctionne comme l'élément HTML <code>legend</code>. Un simple élément <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code> placé en tant que première balise fille est suffisant.</p> - -<h4 id="Un_simple_exemple_groupbox" name="Un_simple_exemple_groupbox">Un simple exemple groupbox</h4> - -<p>L'exemple ci-dessous montre un <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> simple :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_1.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_titledbox1.png" class="internal" src="/@api/deki/files/1560/=Xultu_titledbox1.png"></div> - -<pre><groupbox> - <caption label="Réponse"/> - <description value="Banane"/> - <description value="Mandarine"/> - <description value="Cabine téléphonique"/> - <description value="Kiwi"/> -</groupbox> -</pre> - -<p>Cet exemple affiche quatre bouts de texte entourés par la boîte avec le libellé <em>Réponse</em>. Notez que la boîte de groupe a une orientation verticale par défaut nécessaire pour avoir les éléments texte empilés en une seule colonne.</p> - -<h4 id="L.C3.A9gendes_plus_complexes" name="L.C3.A9gendes_plus_complexes">Légendes plus complexes</h4> - -<p>Vous pouvez aussi ajouter des éléments fils à l'interieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/caption" title="caption">caption</a></code> pour créer une légende plus complexe. Par exemple, le panneau de préférence des polices de caractères de mozilla utilise un liste déroulante comme légende. Bien que vous puissiez utiliser n'importe quel contenu, vous utiliserez la plupart du temps une case à cocher ou une liste déroulante.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_2.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_groupbox2.png" class="internal" src="/@api/deki/files/1522/=Xultu_groupbox2.png"></div> - -<pre><groupbox flex="1"> - <caption> - <checkbox label="Activer la sauvegarde"/> - </caption> - <hbox> - <label control="dir" value="Répertoire :"/> - <textbox id="dir" flex="1"/> - </hbox> - <checkbox label="Compresser les fichiers archivés"/> -</groupbox> -</pre> - -<p>Dans cet exemple, <a href="/fr/Tutoriel_XUL/Les_champs_de_saisie#Les_cases_.C3.A0_cocher_et_les_boutons_radio" title="fr/Tutoriel_XUL/Les_champs_de_saisie#Les_cases_.C3.A0_cocher_et_les_boutons_radio">une case à cocher</a> a été utilisée comme légende. Nous devons utiliser un script pour activer et désactiver le contenu de la boîte de groupe, quand la case est cochée ou décochée. La boîte de groupe contient une boîte horizontale avec un libellé et un champ de saisie. Ces deux éléments sont flexibles donc le champ de saisie s'agrandit quand la fenêtre s'agrandit. La case à cocher supplémentaire apparait en dessous du champ de saisie à cause de l'orientation verticale de la boîte de groupe. Nous ajouterons une boîte de groupe à notre exemple de recherche de fichiers dans la prochaine section.</p> - -<h3 id="Les_groupes_de_boutons_radio" name="Les_groupes_de_boutons_radio">Les groupes de boutons radio</h3> - -<p>Vous pouvez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> pour regrouper des éléments boutons radios. <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> est un type de boîte. Vous pouvez y mettre n'importe quel élément, et à part le comportement spécial sur les boutons radios, il fonctionne comme n'importe quelle autre boîte.</p> - -<p>Tous les boutons radios placés à l'intérieur d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> seront groupés ensemble, même s'ils sont à l'intérieur de boîtes imbriquées. Ce fonctionnement est utilisé pour ajouter des éléments supplémentaires à l'intérieur de la structure, comme dans l'exemple suivant :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_titledbox_3.xul">Voir</a></p> - -<pre><radiogroup> - <radio id="no" value="no" label="Pas de nombre"/> - <radio id="random" value="random" label="Nombre aléatoire"/> - <hbox> - <radio id="specify" value="specify" label="Nombre spécifique :"/> - <textbox id="specificnumber"/> - </hbox> -</radiogroup> -</pre> - -<div class="note">Notez que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> n'a pas de bordure. Vous devez placer un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/groupbox" title="groupbox">groupbox</a></code> autour si vous voulez une bordure et une légende.</div> - -<hr> -<p>Maintenant, nous allons utiliser tout ce que nous avons appris pour ajouter des éléments supplémentaires dans la boîte de dialogue de recherche de fichiers.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Détails_sur_le_modèle_de_boîte" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajouter_plus_d'éléments">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_champs_de_saisie/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_champs_de_saisie/index.html deleted file mode 100644 index 6b2501c9fc..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_champs_de_saisie/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Les champs de saisie -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_champs_de_saisie -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Input_Controls ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_libellés_et_des_images" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_numériques">Suivant »</a></p> -</div> - -<p> </p> - -<p>XUL possède des éléments qui sont similaires aux champs <a href="/fr/DOM/form" title="fr/DOM/form">des formulaires</a> HTML.</p> - -<h3 id="Les_champs_de_saisie_de_texte" name="Les_champs_de_saisie_de_texte">Les champs de saisie de texte</h3> - -<p>Le HTML possède une balise <code>input</code> pouvant être utilisée comme champ de saisie de texte. XUL possède un élément similaire, <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, utilisé comme champ de saisie de texte. Sans aucun attribut, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> crée une boîte dans laquelle l'utilisateur peut entrer du texte. Les boîtes de texte acceptent plusieurs attributs similaires à la balise <code>input</code> de l'HTML. En voici quelques uns :</p> - -<dl> - <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> - <dd>Un identifiant unique permettant d'identifier la boîte de texte.</dd> - <dt><code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code> </dt> - <dd>La classe du style de la boîte de texte.</dd> - <dt><code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> </dt> - <dd>Si vous voulez donner une valeur par défaut à la boîte de texte, renseignez l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>.</dd> - <dt><code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> </dt> - <dd>Mettez la valeur 'true' pour empêcher l'insertion de texte.</dd> - <dt><code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> </dt> - <dd>Vous pouvez renseigner cet attribut avec la valeur spéciale 'password' pour créer une boîte de texte dans laquelle tout ce qui est saisi est caché. Il est utilisé habituellement pour les champs de saisie de mot de passe.</dd> - <dt><code id="a-maxlength"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxlength">maxlength</a></code> </dt> - <dd>Le nombre maximum de caractères que l'on peut saisir dans la boîte de texte.</dd> -</dl> - -<div class="note">Notez que, tandis qu'en HTML différentes sortes de champs peuvent être créées avec l'élément <code>input</code>, il y a un élément différent pour chaque type de champs en XUL.</div> - -<p>L'exemple suivant montre quelques boîtes de texte :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_1.xul">Voir</a></p> - -<pre><label control="some-text" value="Entrez du texte"/> -<textbox id="some-text"/> -<label control="some-password" value="Entrez un mot de passe"/> -<textbox id="some-password" type="password" maxlength="8"/> -</pre> - -<h4 id="Bo.C3.AEte_de_texte_multiligne" name="Bo.C3.AEte_de_texte_multiligne">Boîte de texte multiligne</h4> - -<p>Les exemples de boîtes de texte ci-dessus créent des champs de saisie qui ne peuvent être utilisés que pour la saisie d'une seule ligne de texte. Le HTML possède aussi un élément <code>textarea</code> pour créer une zone de saisie plus grande. Dans XUL, vous pouvez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code> de la même façon -- deux éléments distincts ne sont pas nécessaires. Si vous mettez l'attribut <code id="a-multiline"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/multiline">multiline</a></code> à la valeur 'true', le champ de saisie de texte affichera plusieurs lignes.</p> - -<p>Par exemple :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_2.xul">Voir</a></p> - -<pre><textbox multiline="true" - value="Voici du texte qui pourrait s'étaler sur plusieurs lignes."/> -</pre> - -<p>Comme avec la balise <code>textarea</code> du HTML, vous pouvez utiliser les attributs <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code> et <code id="a-cols"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/cols">cols</a></code> pour définir la taille. Ils vous permettent d'ajuster le nombre de lignes et de colonnes de caractères à afficher.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> - -<p>Maintenant, ajoutons un champ de saisie de recherche à la boîte de dialogue de recherche de fichiers. Nous allons utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>.</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-inputs.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-inputs.xul">Voir</a></p> - -<pre class="eval"><span class="highlightred"><label value="Chercher :" control="find-text"/></span> -<span class="highlightred"><textbox id="find-text"/></span> - -<button id="find-button" label="Rechercher"/> -</pre> - -<div class="float-right"><img alt="Image:xultu_inputs1.png" class="internal" src="/@api/deki/files/1525/=Xultu_inputs1.png"></div> - -<p>Ajoutez ces lignes avant les boutons que nous avons créés dans la section précédente. Si vous ouvrez cette fenêtre, vous verrez quelque chose ressemblant à l'image ci-dessous.</p> -Notez que le libellé et le champ de saisie de texte sont maintenant apparus dans la fenêtre. La boîte de texte est complètement fonctionnelle et vous pouvez taper et sélectionner du texte dedans. Notez aussi que l'attribut <code id="a-control"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/control">control</a></code> a été utilisé. Ainsi, le champ de saisie est sélectionnée lorsque l'on clique sur son libellé.</div> - -<h3 id="Les_cases_.C3.A0_cocher_et_les_boutons_radio" name="Les_cases_.C3.A0_cocher_et_les_boutons_radio">Les cases à cocher et les boutons radio</h3> - -<p>Deux éléments supplémentaires sont utilisés pour la création des cases à cocher et des boutons radio. Ce sont des variantes de boutons. La case à cocher est utilisée pour des options qui peuvent être activées ou désactivées. Les boutons radio peuvent être utilisés dans un but similaire quand il y a un ensemble de boutons où un seul d'entre eux peut-être sélectionné à la fois.</p> - -<p>Vous pouvez employer la plupart des attributs des boutons avec les cases à cocher et les boutons radio. L'exemple ci-dessous montre des cases à cocher et boutons radio simples.</p> - -<pre><checkbox id="case-sensitive" checked="true" label="Sensible à la casse"/> -<radio id="orange" label="Orange"/> -<radio id="violet" selected="true" label="Violet"/> -<radio id="yellow" label="Jaune"/> -</pre> - -<p>La première ligne crée une simple case à cocher. Quand l'utilisateur clique sur la case à cocher, son état coché et décoché s'inverse. L'attribut <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code> peut être utilisé pour indiquer l'état par défaut. Il vous faudra l'initialiser soit à 'true', soit à 'false'. L'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> peut être utilisé pour ajouter un libellé qui apparaitra à côté de la case à cocher. Pour les boutons radio, vous utiliserez l'attribut <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> à la place de l'attribut <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code>. Initialisez le à 'true' pour avoir un bouton radio sélectionné par défaut, ou ne le mettez pas pour les autres boutons radio.</p> - -<h4 id=".C3.89lement_radiogroup" name=".C3.89lement_radiogroup">Élement <code>radiogroup</code></h4> - -<p>Pour grouper des boutons radio ensemble, vous devez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code>. Un seul bouton radio peut-être sélectionné dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code>. Cliquez sur l'un deux désélectionnera tous les autres du même groupe. C'est ce que démontre l'exemple suivant.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_inputs_3.xul">Voir</a></p> - -<pre><radiogroup> - <radio id="orange" label="Orange"/> - <radio id="violet" selected="true" label="Violet"/> - <radio id="Jaune" label="Jaune"/> -</radiogroup> -</pre> - -<h4 id="Attributs" name="Attributs">Attributs</h4> - -<p>Comme pour les boutons, les cases à cocher et les boutons radio sont constitués d'un libellé et d'une image, où l'image change en fonction de l'état coché ou décoché. Les cases à cocher ont certains attributs communs aux boutons :</p> - -<dl> - <dt><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> </dt> - <dd>Le libellé de la case à cocher ou du bouton radio.</dd> - <dt><code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> </dt> - <dd>Mettez la valeur à 'true' ou à 'false' pour désactiver ou activer la case à cocher ou le bouton radio.</dd> - <dt><code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> </dt> - <dd>La touche clavier pouvant être utilisée comme raccourci pour sélectionner l'élément. La lettre spécifiée est habituellement soulignée dans le libellé.</dd> -</dl> - -<hr> -<p>Dans la prochaine section, nous allons voir quelques éléments pour la création de boîtes de listes.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Ajouter_des_libellés_et_des_images" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_numériques">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_de_listes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_de_listes/index.html deleted file mode 100644 index 3a5349caa9..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_de_listes/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Les contrôles de listes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_contrôles_de_listes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/List_Controls ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_numériques" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Indicateurs_de_progression">Suivant »</a></p> -</div> -<p>XUL dispose de nombreux types d'éléments pour créer des boîtes de listes.</p> -<h3 id="Zones_de_listes" name="Zones_de_listes">Zones de listes</h3> -<p>Une zone de liste est utilisée pour afficher un nombre d'items dans une liste. L'utilisateur doit pouvoir choisir un des item de la liste.</p> -<p>XUL propose deux types d'éléments pour créer des listes, un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> pour créer des zones de liste multi-lignes, et un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> pour créer des zones de listes déroulantes. Ils fonctionnent de la même manière que l'élément <code>select</code> du langage HTML qui réalise ces deux fonctions, mais les élements XUL ont plus de fonctionnalités.</p> -<p>La zone de liste la plus simple utilise l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> pour créer la boîte, et l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> pour chacun des items. Par exemple, cette zone de liste a quatre lignes, une pour chaque item.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_1.xul">Voir</a></p> -<pre><listbox> - <listitem label="Beurre de cacahuète"/> - <listitem label="Chocolat à tartiner"/> - <listitem label="Confiture de fraise"/> - <listitem label="Crême chantilly"/> -</listbox> -</pre> -<div class="float-right"> - <img alt="Image:xultu_list1.png" class="internal" src="/@api/deki/files/1527/=Xultu_list1.png"></div> -<p>À l'instar de la balise <code>option</code> du langage HTML, vous pouvez assigner une valeur à chaque item en utilisant l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>. Vous pouvez ensuite utiliser cette valeur dans un script. Par défaut, la zone de liste ajustera sa taille à son contenu, mais vous pouvez contrôler sa taille avec l'attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code>. Affectez lui le nombre de lignes que vous souhaitez voir apparaître dans la zone de liste. Un ascenseur apparaîtra pour permettre à l'utilisateur d'afficher les lignes supplémentaires.</p> -<p>L'exemple suivant montre ces fonctionnalités supplémentaires :</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_2.xul">Voir</a></p> -<pre><listbox rows="3"> - <listitem label="Beurre de cacahuète" value="becacah"/> - <listitem label="Chocolat à tartiner" value="chotart"/> - <listitem label="Confiture de fraise" value="confraise"/> - <listitem label="Creme chantilly" value="crchant"/> -</listbox> -</pre> -<p>L'exemple a été modifié pour n'afficher que 3 lignes à la fois. Des valeurs ont également été ajoutées à chaque item de la liste. Les zones de liste ont beaucoup d'autres fonctionnalités qui seront décrites plus tard.</p> -<h3 id="Bo.C3.AEte_de_liste_multi-colonnes" name="Bo.C3.AEte_de_liste_multi-colonnes">Boîte de liste multi-colonnes</h3> -<p>Les boîtes de liste supportent également les colonnes multiples. Chaque cellule peut avoir un contenu arbitraire bien qu'il s'agisse souvent seulement de texte. Quand un utilisateur sélectionne un item dans la liste, la ligne entière est sélectionnée. Il n'est pas possible de sélectionner une seule cellule.</p> -<p>Deux balises sont utilisées pour spécifier les colonnes dans une boîte de liste. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listcols" title="listcols">listcols</a></code> est utilisé pour contenir l'information sur les colonnes, chacune d'elles est spécifiée en utilisant un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listcol" title="listcol">listcol</a></code> Vous aurez besoin d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listcol" title="listcol">listcol</a></code> pour chaque colonne de la liste.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code> doit être utilisé pour chaque cellule dans une ligne. Si vous voulez avoir trois colonnes, vous aurez besoin d'ajouter trois éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code> à l'intérieur de chaque <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code>. Pour spécifier le contenu d'un texte de la cellule, placez un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sur cet élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code>. Dans le cas simple où il n'y a qu'une seule colonne, vous pouvez aussi placer l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> directement sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> et omettre complètement les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/listcell" title="listcell">listcell</a></code>, comme cela a été montré dans les exemples de listes précédents.</p> -<p>L'exemple suivant est une boîte de liste de deux colonnes et trois lignes.</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_3.xul">Voir</a></p> -<pre><listbox> - <listcols> - <listcol/> - <listcol/> - </listcols> - <listitem> - <listcell label="George"/> - <listcell label="Peintre en bâtiment"/> - </listitem> - <listitem> - <listcell label="Mary Ellen"/> - <listcell label="Fabriquant de bougies"/> - </listitem> - <listitem> - <listcell label="Roger"/> - <listcell label="Bravache"/> - </listitem> -</listbox> -</pre> -<h3 id="Lignes_d.27en-t.C3.AAte" name="Lignes_d.27en-t.C3.AAte">Lignes d'en-tête</h3> -<p>Les boîtes de liste permettent également l'utilisation d'une ligne d'en-tête spéciale. Elle n'est rien d'autre qu'une ligne normale, sauf qu'elle est affichée différemment. Elle servira à créer des en-têtes de colonnes grâce à deux nouveaux éléments.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listhead" title="listhead">listhead</a></code> est utilisé pour définir la ligne d'en-tête, comme l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code> est utilisé pour définir une ligne normale. La ligne d'en-tête n'est toutefois pas une ligne normale, ainsi un script permettant de lire la première ligne d'une boîte de liste ne tiendra pas compte de cette ligne d'en-tête.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listheader" title="listheader">listheader</a></code> est utilisé pour chaque cellule de l'en-tête. Utilisez l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> pour définir le libellé de la cellule d'en-tête.</p> -<p>Voici l'exemple précédent avec une ligne d'en-tête :</p> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_4.xul">Voir</a></p> -<pre><listbox> - - <listhead> - <listheader label="Nom"/> - <listheader label="Activité"/> - </listhead> - - <listcols> - <listcol/> - <listcol flex="1"/> - </listcols> - - <listitem> - <listcell label="George"/> - <listcell label="Peintre en bâtiment"/> - </listitem> - <listitem> - <listcell label="Mary Ellen"/> - <listcell label="Fabriquant de bougies"/> - </listitem> - <listitem> - <listcell label="Roger"/> - <listcell label="Bravache"/> - </listitem> - -</listbox> -</pre> -<div class="float-right"> - <img alt="Image:xultu_lists_3.png" class="internal" src="/@api/deki/files/1529/=Xultu_lists_3.png"></div> -<p>Dans cet exemple, l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> est utilisé pour rendre la colonne flexible. Cet attribut sera décrit dans une section ultérieure, mais ici, il permet à la colonne de remplir tout l'espace disponible horizontalement. Vous pouvez retailler la fenêtre pour voir que la colonne s'adapte en même temps que la fenêtre. Si vous diminuez la taille horizontalement, les libellés sur les cellules seront raccourcis automatiquement, en affichant des points de suite. Vous pouvez utiliser l'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> sur les cellules ou sur les items, avec une valeur 'none' pour désactiver cette coupure.</p> -<h3 id="Zones_de_listes_d.C3.A9roulantes" name="Zones_de_listes_d.C3.A9roulantes">Zones de listes déroulantes</h3> -<p>Des listes déroulantes peuvent être créées en HTML avec la balise <code>select</code>. L'utilisateur ne voit qu'un unique choix dans une boîte de texte et doit cliquer sur une flèche ou un bouton similaire à côté de la boîte de texte pour changer la sélection. Les autres choix apparaitront alors dans une fenêtre surgissante. XUL dispose de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> qui peut servir à cet usage. Il est formé d'une boîte de texte avec un bouton à son côté. Son nom a été choisi parce qu'il propose un menu surgissant pour le choix.</p> -<p>Trois éléments sont nécessaires pour former une liste déroulante. Le premier est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> qui crée la boîte de texte avec son bouton à côté. Le second, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, crée la fenêtre surgissante qui apparaît lorsque le bouton est cliqué. Le troisième, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, crée les choix individuels.</p> -<p>Cette syntaxe est mieux décrite dans l'exemple ci-dessous :</p> -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_5.xul">Voir</a></p> -<pre><menulist label="Bus"> - <menupopup> - <menuitem label="Voiture"/> - <menuitem label="Taxi"/> - <menuitem label="Bus" selected="true"/> - <menuitem label="Train"/> - </menupopup> -</menulist> -</pre> -<div class="float-right"> - <img alt="Image:xultu_list2.png" class="internal" src="/@api/deki/files/1528/=Xultu_list2.png"></div> -<p>Ce menu contient quatre choix, un pour chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. Pour voir les choix possibles, cliquez sur le bouton flèche du menu. Lorsqu'un item est sélectionné, il apparaît comme le choix fait dans le texte du menu. L'attribut <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> est utilisé pour définir la valeur sélectionnée par défaut.</p> -<h4 id="menulist_.C3.A9ditable" name="menulist_.C3.A9ditable">menulist éditable</h4> -<p>Par défaut, vous ne pouvez sélectionner que des choix proposés dans la liste. Vous ne pouvez pas entrer votre propre sélection en la tapant au clavier. Une variante de <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> le permet. Par exemple, le champ URL du navigateur dispose d'une liste déroulante pour afficher les adresses précédemment utilisées, mais vous pouvez aussi la saisir vous même.</p> -<p>Pour créer une liste déroulante éditable, ajoutez l'attribut <code id="a-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/editable">editable</a></code> comme ceci :</p> -<p><span id="Exemple_6"><a id="Exemple_6"></a><strong>Exemple 6</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_6.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_lists_6.xul">Voir</a></p> -<pre><menulist '''editable="true"'''> - <menupopup> - <menuitem label="www.mozilla.org"/> - <menuitem label="www.xulplanet.com"/> - <menuitem label="www.dmoz.org"/> - </menupopup> -</menulist> -</pre> -<p>Le champ URL créé ici a trois adresses pré-saisies que l'utilisateur peut sélectionner ou alors il peut taper la sienne dans le champ. Le texte entré par l'utilisateur ne sera pas ajouté comme un futur choix à cette liste. Comme l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> n'a pas été utilisé dans cet exemple, sa valeur par défaut sera vide.</p> -<hr> -<p>Dans la section suivante, nous apprendrons comment ajouter des indicateurs de progression.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_numériques" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Indicateurs_de_progression">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_numériques/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_numériques/index.html deleted file mode 100644 index 73c81e4d9f..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_contrôles_numériques/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Les contrôles numériques -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_contrôles_numériques -tags: - - Firefox 3 - - Traduction_à_relire - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Numeric_Controls ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_champs_de_saisie" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_de_listes">Suivant »</a></p> -</div> - -<p>XUL comprend deux éléments servant aux entrées de valeurs ou de plages numériques, ainsi que de deux éléments pour la saisie des dates et heures. Ces éléments ne sont disponibles que dans Firefox 3 et suivant.</p> -<h3 id="Champs_num.C3.A9rique" name="Champs_num.C3.A9rique">Champs numérique</h3> -<p>Une boîte de texte peut servir à la saisie de nombres en lui définissant un attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> avec la valeur <code>number</code>. Ce type de boîte ne peut servir que pour entrer des nombres. Tout autre caractère tapé ne sera pas accepté et sera ignoré. De plus, des flèches apparaitront à côté de la boîte de texte pour permettre à l'utilisateur de faire défiler les valeurs.</p> -<div class="float-right"> - <img alt="Image:Controlguide-textbox-number.png" class="internal" src="/@api/deki/files/1249/=Controlguide-textbox-number.png"></div> -<p>Comme avec les autres boîtes de texte, la valeur par défaut peut être définie avec l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>. Naturellement, cette valeur doit être un nombre. Toutefois, les valeurs minimale et maximale peuvent être définies avec les attributs <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code> et <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code>. S'ils sont précisés, vous pouvez contrôler l'intervalle de valeurs permis par la boîte de texte. Si l'utilisateur tente d'entrer une valeur inférieure ou supérieure à cet intervalle, elle sera réinitialisée avec le minimum ou le maximum. Par exemple, la boîte de texte suivante a un intervalle de 1 à 20.</p> -<pre><textbox type="number" min="1" max="20"/> -</pre> -<p>Comme la valeur par défaut n'est pas définie, la boîte aura la valeur 1, la valeur minimum. L'attribut <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code> est défini à <code>1</code> pour indiquer la plus petite valeur possible, et l'attribut <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code> est défini à <code>20</code> pour indiquer la plus grande valeur possible. Si la valeur minimale n'est pas définie, elle aura une valeur par défaut de 0. La valeur maximale par défaut est la valeur spéciale <code>Infinity</code> signifiant qu'il n'y a aucune limite.</p> -<h4 id="Autres_attributs_des_champs_num.C3.A9riques" name="Autres_attributs_des_champs_num.C3.A9riques">Autres attributs des champs numériques</h4> -<p>L'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code> peut servir à spécifier de combien est modifiée la valeur lorsque les flèches sont pressées. La valeur par défaut est 1, mais une valeur différente permettra au nombre de changer d'une plus grosse valeur. L'exemple suivant effectue des écarts de multiples de 10.</p> -<pre><textbox type="number" increment="10" max="100"/> -</pre> -<p>Cette boîte de texte change par multiples de 10 de 0 à 100. Comme l'attribut <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code> n'a pas été défini, sa valeur par défaut est 0. Notez que l'utilisateur peut parfaitement entrer une autre valeur. L'attribut <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code> n'affecte que les flèches. L'utilisateur peut également incrémenter ou décrémenter la valeur en utilisant les flèches haut et bas du clavier lorsque la boîte de texte à le focus.</p> -<p>L'attribut <code id="a-decimalplaces"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/decimalplaces">decimalplaces</a></code> indique le nombre de décimales à afficher. La valeur par défaut est 0, ce qui signifie que la boîte n'affiche que des entiers. Une valeur différente permet d'afficher des nombres décimaux.</p> -<pre><textbox type="number" decimalplaces="2"/> -</pre> -<p>Dans cet exemple, deux chiffres après la virgule sont affichés. Les valeurs comportant d'autres décimales sont arrondies à 2 chiffres après la virgule.</p> -<h3 id=".C3.89chelles_de_valeurs" name=".C3.89chelles_de_valeurs">Échelles de valeurs</h3> -<p>Un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/scale" title="scale">scale</a></code> peut également être utilisé pour sélectionner une plage de valeurs. Plutôt que d'avoir une boîte de texte, un curseur glissant est utilisé. L'utilisateur peut déplacer le curseur de l'échelle pour ajuster la valeur.</p> -<div class="float-right"> - <img alt="Image:Controlguide-scale.png" class="internal" src="/@api/deki/files/1246/=Controlguide-scale.png"></div> -<p>La plupart des attributs de la boîte de texte numérique peuvent servir avec une échelle : <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>, <code id="a-min"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min">min</a></code>, <code id="a-max"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max">max</a></code> et <code id="a-increment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/increment">increment</a></code> peuvent servir de la même façon. L'échelle de valeur n'affiche en fait aucune valeur, mais peut le faire grâce à un script. Une échelle déclenche un événement <code>change</code> à chaque fois que sa valeur est modifiée.</p> -<pre><scale value="40" min="1" max="50"/> -</pre> -<p>La valeur par défaut de cette échelle est 40, et elle a une plage comprise entre 1 et 50.</p> -<p>Une boîte de texte numérique est employée généralement lorsque la valeur est importante pour l'utilisateur, comme un champs pour saisie un nombre de jours ou la taille maximale d'un fichier. Une échelle de valeur servira plutôt lorsque la valeur n'est pas très importante, comme l'augmentation ou la diminution d'un état, par exemple pour le volume sonore ou un zoom.</p> -<p>La disposition par défaut d'une échelle est horizontale avec à gauche les valeurs les plus basses et à droite, les plus hautes. Vous pouvez toutefois modifier cette orientation avec les attributs <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> et <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>.</p> -<pre><scale orient="vertical" dir="reverse"/> -</pre> -<p>Cette échelle de valeurs s'affichera verticalement avec les valeurs les plus basses en bas, et les plus élevées en haut.</p> -<h3 id="Champs_de_saisie_de_date_et_heure" name="Champs_de_saisie_de_date_et_heure">Champs de saisie de date et heure</h3> -<p>Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/datepicker" title="datepicker">datepicker</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/timepicker" title="timepicker">timepicker</a></code> permettent à l'utilisateur d'entrer des dates et des heures. À leur utilisation, ils affichent une série de boîtes de texte numérique pour entrer chaque composants de la date et de l'heure.</p> -<pre><datepicker value="2004/3/24"/> -<timepicker value="15:30:00"/> -</pre> -<div class="float-right"> - <img alt="Image:Controlguide-timepicker.png" class="internal" src="/@api/deki/files/1253/=Controlguide-timepicker.png"></div> -<p>L'attribut <code>value</code> permet de définir la valeur par défaut ; et si cet attribut est omis, le champ sera initialisé avec la date et l'heure courante. Le format de l'attribut est exactement comme ci-dessus, c'est-à-dire que les dates sont de la forme YYY/MM/DD et les heures sont de la forme HH:MM:SS (bien que les secondes et les autres colonnes peuvent être omises).</p> -<p>Ces deux éléments garantissent que l'utilisateur a bien entré une valeur date et une heure. De cette manière, vous n'avez pas à vous soucier qu'il s'agit d'une date valide, en vérifiant que le jour n'est pas supérieur au nombre de jour dans le mois, en gérant les années bissextiles, et ainsi de suite.</p> -<p>Tandis que <code><a href="/fr/docs/Mozilla/Tech/XUL/timepicker" title="timepicker">timepicker</a></code> ne possède qu'un seul style, <code><a href="/fr/docs/Mozilla/Tech/XUL/datepicker" title="datepicker">datepicker</a></code> possède trois variations différentes. Le style par défaut affiche trois champs pour l'année, le mois et le jour. L'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> permet de choisir les deux autres. Une valeur de <code>grid</code> utilise une grille de calendrier, comme affichée dans l'image ci-dessous.</p> -<p><img alt="Image:Controlsguide-datepicker-grid.png" class="internal" src="/@api/deki/files/1260/=Controlsguide-datepicker-grid.png"></p> -<p>Vous pouvez également utiliser la valeur <code>popup</code> pour créer une combinaison des deux types. Ce type a trois champs pour entrer l'année, le mois et la date, ainsi qu'un bouton pour afficher un calendrier surgissant pour choisir un jour.</p> -<pre><datepicker type="popup"/> -</pre> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/Les_champs_de_saisie" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Les_contrôles_de_listes">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_de_propriétés/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_de_propriétés/index.html deleted file mode 100644 index a644660bf3..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_de_propriétés/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Les fichiers de propriétés -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_fichiers_de_propriétés -tags: - - Localisation - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Property_Files ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Localisation" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Introduction_à_XBL">Suivant »</a></p> -</div> -<p> </p> -<p>Dans un script, les entités ne peuvent être utilisées. On utilise alors plutôt les fichiers de propriétés.</p> -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> -<p>Les fichiers DTD sont adaptés à des chaînes issues d'un fichier XUL. Néanmoins, dans un script, les entités ne sont pas analysées pour être remplacées. De plus, vous pourriez souhaiter afficher un message généré par un script, sans par exemple connaître à l'avance son contenu. Les fichiers de propriétés peuvent être utilisés dans ce but.</p> -<p>Un fichier de propriétés contient une suite de chaînes de caractères. Vous trouverez les fichiers de propriétés aux côtés des fichiers DTD avec l'extension <code>.properties</code>. Les propriétés dans un de ces fichiers sont déclarées selon une structure <code>nom=valeur</code>. Un exemple est décrit ci-dessous :</p> -<pre>notFoundAlert=Aucun fichier trouvé correspondant aux critères. -deleteAlert=Cliquez sur OK pour effacer tous vos fichiers. -resultMessage=%2$S fichiers trouvés dans le répertoire %1$S. -</pre> -<p>Ici, le fichier de propriétés contient deux propriétés. Elles pourront être lues par un script et affichées.</p> -<h3 id="Stringbundles" name="Stringbundles">Stringbundles</h3> -<p>Vous pouvez écrire le code de lecture des propriétés vous-mêmes, néanmoins XUL fournit l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stringbundle" title="stringbundle">stringbundle</a></code> qui le fait pour vous. Cet élément dispose de plusieurs fonctions pouvant être utilisées pour récupérer les chaînes de caractères des fichiers de propriétés et d'autres informations de localisation. Cet élément lit le contenu des fichiers de propriétés et construit une liste de ces propriétés pour vous. Vous pouvez donc ensuite y accéder par leur nom.</p> -<pre><stringbundleset id="strbundles"> -<stringbundle id="strings" src="strings.properties"/> -</stringbundleset> -</pre> -<p>L'inclusion de cet élément permettra de lire les propriétés via le fichier 'strings.properties' dans le même répertoire que le fichier XUL. Utilisez une URL chrome pour lire un fichier de localisation. Comme pour d'autres éléments non affichables, vous devriez déclarer tous les stringbundles à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stringbundleset" title="stringbundleset">stringbundleset</a></code> pour les regrouper.</p> -<h4 id="Obtention_d.27une_cha.C3.AEne_d.27une_collection" name="Obtention_d.27une_cha.C3.AEne_d.27une_collection">Obtention d'une chaîne d'une collection</h4> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stringbundle" title="stringbundle">stringbundle</a></code> a plusieurs propriétés. La première est <code id="a-getString"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/getString">getString</a></code> pouvant être utilisée dans un script pour lire une chaîne de caractères de la collection.</p> -<pre>var strbundle = document.getElementById("strings"); -var nofilesfound=strbundle.getString("notFoundAlert"); - -alert(nofilesfound); -</pre> -<ul> <li>Cet exemple récupère tout d'abord une référence sur la collection en utilisant son id.</li> <li>Puis il recherche la chaîne de caractères 'notFoundAlert' dans le fichier de propriétés. La fonction <code>getString()</code> retourne la valeur de la chaîne ou 'null' si la chaîne n'existe pas.</li> <li>Enfin, la chaîne de caractères est affichée dans une boîte d'alerte.</li> -</ul> -<h5 id=".C3.80_propos_de_l.27obtention_d.27une_cha.C3.AEne_d.27une_collection" name=".C3.80_propos_de_l.27obtention_d.27une_cha.C3.AEne_d.27une_collection">À propos de l'obtention d'une chaîne d'une collection</h5> -<p>Si vous souhaitez utiliser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stringbundle" title="stringbundle">stringbundle</a></code> au sein d'un <overlay>, merci de faire attention. Vous devrez placer votre <code><a href="/fr/docs/Mozilla/Tech/XUL/stringbundle" title="stringbundle">stringbundle</a></code> dans un élément <window>, d'identifiant 'main-window'. Sinon, vous ne serez pas à même de récupérer les chaînes depuis votre code JavaScript, sans comprendre pourquoi. Ainsi, le code que vous auriez écrit aurait pu être :</p> -<pre><overlay id="OverLayId"> - <stringbundleset id="strbundles"> - <stringbundle id="strings" src="strings.properties"/> - </stringbundleset> -</overlay> -</pre> -<p>Il sera donc :</p> -<pre><overlay id="OverLayId"> - <window id="main-window"> - <stringbundleset id="strbundles"> - <stringbundle id="strings" src="strings.properties"/> - </stringbundleset> - </window> -</overlay> -</pre> -<h4 id="Formatage_de_texte" name="Formatage_de_texte">Formatage de texte</h4> -<p>La méthode suivante est <code>getFormattedString()</code>. Elle permet également d'obtenir avec une clef donnée une chaîne de la collection. Mais en plus, chaque occurrence de code de formatage (par ex. %S) est remplacée par chaque élément successif dans le tableau transmis.</p> -<pre>var dir = "/usr/local/document"; -var count = 10; - -var strbundle = document.getElementById("strings"); -var result = strbundle.getFormattedString("resultMessage", [ dir, count ]); - -alert(result); -</pre> -<p>Cet exemple affichera le message suivant dans une boîte d'alerte.</p> -<pre>10 fichiers trouvés dans le répertoire /usr/local/document.</pre> -<p>Vous noterez que les codes de formatage <code>%1$S</code> et <code>%2$S</code> sont utilisés, et sont remplacés par les différents membres dans le tableau. Un code de formatage %<em>n</em>$S spécifie directement la position du paramètre correspondant. Bien que l'ordre des mots soit différent dans tous les langages, l'utilisation de <code>getFormattedString()</code> permet de préciser l'ordre dans les fichiers de propriétés.</p><h3 id=".C3.89chappement_de_caract.C3.A8res_non-ASCII" name=".C3.89chappement_de_caract.C3.A8res_non-ASCII">Échappement de caractères non-ASCII</h3> -<p> </p> -<p><strong>Avant Gecko 1.8</strong></p> -<p>Bien que la plupart des langages nécessitent des caractères non-ASCII, les fichiers de propriétés doivent être écrits en n'utilisant que des caractères ASCII. Cependant, les fichiers de propriétés supportent d'autres caractères grâce à des séquences échappées de la forme : <code>\uXXXX</code> où XXXX est le code du caractère. Ainsi, si votre fichier de propriété contient des caractères non-ASCII, vous devrez le convertir au format 'échappement-unicode'. Pour faire cela, vous pouvez utiliser l'utilitaire en ligne de commande native2ascii fourni avec le kit de développement Java de Sun (JDK).</p> -<p><strong>À partir de Gecko 1.8.x (et versions ultérieures) </strong></p> -<p>Les fichiers .properties encodés en UTF-8 sont pris en charge. Vous pouvez donc utiliser des caractères non-ASCII sans avoir à les "échapper".</p> -<hr> -<p>Dans la prochaine section, nous découvrirons XBL qui peut être utilisé pour définir le comportement d'un élément.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Localisation" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Introduction_à_XBL">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_manifest/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_manifest/index.html deleted file mode 100644 index 50ea0d2e3e..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_fichiers_manifest/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Les fichiers manifest -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_fichiers_manifest -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Manifest_Files ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/L'URL_Chrome" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Créer_une_fenêtre">Suivant »</a></p> -</div> -<p>Dans cette section, nous allons voir comment mettre des fichiers XUL et chrome dans un paquetage et créer les fichiers manifest associés.</p> -<h3 id="Paquetages" name="Paquetages">Paquetages</h3> -<p>Un paquetage est un ensemble de fichiers XUL et de scripts qui définissent la fonctionnalité d'une interface utilisateur. Les paquetages peuvent être installés dans Mozilla et référencés avec des URLs chrome. Un paquetage peut contenir tous les fichiers que l'on veut et peut-être découpé en sous-répertoires pour les différentes parties du paquetage. Un paquetage peut-être enregistré soit comme un répertoire ou soit comme une archive JAR.</p> -<h3 id="Les_fichiers_manifest" name="Les_fichiers_manifest">Les fichiers manifest</h3> -<p>Un fichier manifest décrit un paquetage et relie son emplacement sur le disque à son adresse URL chrome. Les fichiers manifest situés dans le répertoire chrome sont examinés au lancement d'une application Mozilla pour déterminer les paquetages installés. Cela signifie que tout ce que vous avez à faire pour installer un nouveau paquetage est d'ajouter un fichier manifest soit dans le répertoire chrome de l'application, soit dans le répertoire chrome du profil de l'utilisateur. Le second emplacement est normalement le seul utilisé puisque les permissions ne devraient pas être suffisantes pour écrire dans le répertoire de l'application.</p> -<p>Si vous voulez tester un code XUL à privilèges dans le navigateur Firefox, un simple fichier manifest contenant une seule ligne est nécessaire :</p> -<ol> - <li>Créez un nouveau répertoire quelque part. Par exemple, sur une plateforme Windows, utilisez C:\testfiles.</li> - <li>Créez un nouveau fichier <abbr title="American Standard Code for Information Interchange">ASCII</abbr> (un format UTF-8 avec BOM ne fonctionnera pas) appelé test.manifest dans le répertoire chrome. Le nom du fichier importe peu dès lors qu'il possède une extension .manifest.</li> - <li>Ajoutez la ligne suivante à ce fichier :</li> -</ol> -<pre class="eval">content tests <a class="external" rel="freelink">file:///C:/testfiles/</a> -</pre> -<p>Le chemin mentionné dans cette ligne doit pointer vers le répertoire créé plus haut. Si vous avez un doute sur la syntaxe de ce chemin, ouvrez ce répertoire dans un navigateur et copiez l'URL obtenue dans la barre d'adresse.</p> -<p>C'est fait ! Maintenant, tout ce qu'il vous reste à faire est d'ajouter des fichiers XUL dans ce nouveau répertoire, et vous serez capable de les charger en tapant une URL chrome de la forme <code><a class="external" rel="freelink">chrome://tests/content/</a><filename></code>. Bien entendu, vous devrez redémarrer votre navigateur pour les changements soient pris en compte. Si le fichier ne se charge pas, vérifiez que le chemin vers le répertoire est correct.</p> -<p>La syntaxe de base des lignes du manifest du paquetage de contenu est :</p> -<p>'content <nom_du_paquetage> <chemin_vers>'</p> -<p>Le premier mot 'content' indique qu'il s'agit d'un paquetage de contenu. Pour les thèmes graphiques, le mot serait 'skin' et pour les fichiers de langue, il serait 'locale'. Le nom du paquetage dans l'exemple ci-dessus est 'tests', donc le premier champ dans l'URL chrome est 'tests' comme dans <code><a class="external" rel="freelink">chrome://tests/content/exemple.xul</a></code>. Si le nom du paquetage était 'browser', l'URL chrome serait <code><a class="external" rel="freelink">chrome://browser/content</a></code>. Le dernier champ <chemin_vers> correspond à l'emplacement des fichiers. Il peut être soit un une URL file vers un répertoire local, soit une URL jar vers une archive JAR qui sera décrit plus tard. Vous pouvez déclarer plusieurs paquetages dan le même fichier manifest en ajoutant des lignes.</p> -<p>Le fichier browser.manifest utilisé par Firefox ressemble à ceci :</p> -<pre>content branding jar:browser.jar!/content/branding/ xpcnativewrappers=yes -content browser jar:browser.jar!/content/browser/ xpcnativewrappers=yes -overlay chrome://global/content/viewSource.xul chrome://browser/content/viewSourceOverlay.xul -overlay chrome://global/content/viewPartialSource.xul chrome://browser/content/viewSourceOverlay.xul -overlay chrome://browser/content/pageInfo.xul chrome://pippki/content/PageInfoOverlay.xul -</pre> -<p>Deux paquetages sont déclarés ici : 'branding' et 'browser'. Trois overlays sont également spécifiés pour permettre aux différents paquetages de se combiner entre eux. Les extensions font un large usage des overlays pour fusionner leurs interfaces à celle du navigateur.</p> -<p>Les deux chemins des paquetages branding et browser utilisent des URLs jar car leur contenu se trouve dans une archive. Une archive JAR peut être créée avec un utilitaire ZIP. Pour un fichier JAR situé dans un répertoire chrome, la syntaxe est assez simple :</p> -<p>jar:<nom_de_fichier.jar>!<chemin_dans_archive></p> -<p>Pour le paquetage du navigateur, l'archive est browser.jar et elle est située à côté du fichier manifest dans le répertoire chrome. Le chemin 'content/browser' spécifie le chemin à l'intérieur de l'archive où les fichier XUL sont situés. Il n'est pas nécessaire de préciser un chemin s'il n'y a aucun répertoire dans l'archive. Sur notre exemple, il y en a un puisque les fichiers du paquetage branding sont enregistrés dans un chemin différent de la même archive.</p> -<p>Pour le paquetage 'tests' créé ci-dessus, les fichiers ne sont pas empaquetés dans une archive, donc un chemin direct vers les fichiers est utilisé à la place. Cette méthode est bonne pour le développement puisque vous n'avez pas à réempaqueter tous les fichiers à chaque modification. Cependant, pour distribuer une application ou une extension, vous devriez les empaqueter dans une archive pour éviter l'installation d'une multitudes de petits fichiers.</p> -<p>La partie <code>xpcnativewrappers=yes</code> à la fin de la ligne du fichier manifest est un drapeau optionnel. En JavaScript, une page Web peut remplacer des fonctions natives avec son propre code. La présence de ce drapeau <code>xpcnativewrappers=yes</code> indique aux scripts tournant dans un contexte à privilèges de ne pas appeler ses versions remplacées, mais plutôt leurs versions natives. Sans cela, une extension pourrait tenter d'appeler ses versions modifiées et mal fonctionner, ou pire, ouvrir un trou de sécurité. Ce drapeau a été ajouté pour éviter ce genre de problème et devrait toujours être utilisé pour de nouvelles extensions, mais des anciennes extensions pourraient ne plus fonctionner sans lui. Pour plus d'informations concernant cette fonctionnalité, consultez <a href="/fr/XPCNativeWrapper" title="fr/XPCNativeWrapper">XPCNativeWrapper</a>.</p> -<h3 id="Th.C3.A8mes_graphiques_et_langues" name="Th.C3.A8mes_graphiques_et_langues">Thèmes graphiques et langues</h3> -<p>La syntaxe pour les thèmes et les langues est similaire aux paquetages de contenu, mais vous devrez préciser à quel paquetage de contenu ils s'appliquent. Par exemple :</p> -<pre>skin browser classic/1.0 jar:classic.jar!/skin/classic/browser/ -locale browser en-US jar:en-US.jar!/locale/browser/</pre> -<p>Pour cet exemple, le champ supplémentaire a été ajouté pour indiquer que le thème graphique et la langue s'applique au navigateur (browser). Le nom du thème est 'classic/1.0'. Dans le cas présent, un numéro de version est indiqué avec le nom du thème mais il est facultatif si vous développez votre propre thème. Mozilla n'effectue aucun traitement sur ce numéro qui est simplement une partie du nom du thème graphique. La langue est 'en-US'. Les adresses URLs résultant de cet exemple seront '<a class="external" rel="freelink">chrome://browser/skin</a>' et '<a class="external" rel="freelink">chrome://browser/locale</a>'. Si vous créez votre propre thème graphique ou langue, il vous suffit d'adapter ces deux lignes en conséquence.</p> -<p>Pour plus d'informations sur les thèmes graphiques, consultez <a href="/fr/Thèmes" title="fr/Thèmes">Thèmes</a>. Pour plus d'informations sur la localisation, consultez <a href="/fr/Localisation" title="fr/Localisation">Localisation</a>.</p> -<div class="highlight"> - <h3 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h3> - <p>Créons un fichier manifest pour notre boîte de dialogue de recherche de fichiers. Vous pouvez mettre ces trois types dans un même fichier. Lors de la création d'une extension, assurez vous que tous les types soient déclarés. Nous procèderons ainsi pour notre exemple. Créez un fichier findfile.manifest dans le répertoire chrome et ajoutez-y les lignes suivantes :</p> - <pre>content findfile file:///findfile/content/ -skin findfile classic/1.0 file:///findfile/skin/ -locale findfile en-US file:///findfile/locale/ -</pre> - <p>Créez les nouveaux répertoires listés ci-dessus. Peu importe où vous les créez, mais leurs emplacements doivent être indiqués dans le fichier manifest. Naturellement, vous adapterez les chemins en fonction de votre système de fichiers. Si nous voulions distribuer le paquetage, nous le placerions dans un fichier JAR en modifiant les chemins. Pour l'instant, il s'agit d'un exemple de création d'un fichier manifest et une préparation des répertoires pour les exemples à venir dans les sections suivantes.</p> - <p>Notez que les deuxièmes champs pour les lignes 'skin' et 'locale' sont 'findfile'. Elles signifient que le thème graphique et la langue modifient le paquetage 'findfile' défini à la première ligne. Les trois chemins mentionnés correspondent chacun à un sous répertoire différent. Vous devrez procéder ainsi pour séparer les fichiers de chaque catégorie.</p> -</div> -<h3 id="Installer_un_paquetage" name="Installer_un_paquetage">Installer un paquetage</h3> -<p>Pour installer une application, vous devez soit lui créer un installeur, soit l'inclure dans une autre application. La méthode dépend du type d'application que vous créez. Pour des extensions, vous devez créer un fichier d'installation <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">install.rdf</a> décrivant ce qui doit être installé, l'auteur de l'extension et avec quelles versions du navigateur ou d'autres applications elles sont compatibles. <a href="/fr/Bundles" title="fr/Bundles">Une structure de répertoires</a> bien spécifique est nécessaires car l'emplacement des fichiers des extensions est limité. Une extension est paquetagée dans un fichier <a href="/fr/XPI" title="fr/XPI">XPI</a>. XPI est le raccourci pour <a href="/fr/XPInstall" title="fr/XPInstall">XPInstall</a> utilisé par Mozilla pour l'installation de composants. Comme pour un fichier JAR, un fichier XPI n'est autre qu'un fichier ZIP avec une extension différente, donc il vous suffit de disposer d'un utilitaire ZIP pour créer ou visualiser un XPI.</p> -<p>Le gestionnaire d'extensions de Firefox gère automatique les fichiers XPI pour installer les extensions. Il est recommandé de transférer les extensions sur le <a class="link-https" href="https://addons.mozilla.org/">Mozilla Add-ons</a> où les utilisateurs pourront les retrouver. Elles peuvent être installées depuis n'importe quel site, mais la configuration par défaut devra être modifiée pour permettre d'autres sites.</p> -<p>Il est également possible d'utiliser un script d'installation écrit en JavaScript. Cela vous permet de copier des fichiers vers d'autres emplacements et de réaliser d'autres tâches de gestion de fichiers. Cependant, les extensions installées avec un script ne seront pas listées dans le gestionnaire d'extensions, et il n'existe aucune méthode automatisée pour les désinstaller. Pour cette raison, les scripts d'installation ne sont pas souvent utilisés.</p> -<p>Les applications autonomes peuvent être empaquetées en utilisant XULRunner. Ceci permet d'obtenir un fichier exécutable séparé, et l'application peut être distribuée indépendamment d'un navigateur.</p> -<p>Pour plus d'informations sur la création d'extensions, consultez la page <a href="/fr/Extensions" title="fr/Extensions">Extensions</a>. Pour plus d'informations sur XULRunner, consultez la page <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a>.</p> -<h3 id="Applications_anciennes" name="Applications_anciennes">Applications anciennes</h3> -<p>Si vous créez des applications pour des logiciels Mozilla plus anciens, c'est-à-dire précédent Firefox 1.5 ou Mozilla 1.8, le processus est un peu plus élaboré. Les explications qui suivent décrivent comment définir un paquetage pour des anciennes versions. Ce chapitre peut être omis si vous écrivez de nouvelles extensions ou applications XUL.</p> -<div class="note"> - <strong>Note :</strong> Cet ancien processus s'applique également à SeaMonkey 1.0 qui n'a pas encore adopté le format des <em>"manifest"</em>.</div> -<ol> - <li>Créez un répertoire n'importe où sur votre disque. De nombreuses personnes le placent dans un sous répertoire du répertoire chrome de Mozilla, mais ce n'est pas nécessaire. Le répertoire peut être ailleurs. Placez-y vos fichiers XUL.</li> - <li>Créez un fichier appelé contents.rdf et placez le dans ce répertoire. Copiez le texte suivant dans ce fichier contents.rdf. Ce fichier sert à identifier l'id de l'application, son nom, son auteur, sa version, etc. - <pre><?xml version="1.0"?> - -<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:chrome="http://www.mozilla.org/rdf/chrome#"> - -<RDF:Seq about="urn:mozilla:package:root"> <RDF:li resource="urn:mozilla:package:<span style="color:red">monapplication</span>"/> </RDF:Seq> - -<RDF:Description about="urn:mozilla:package:<span style="color:red">monapplication</span>" chrome:displayName="<span style="color:blue">Titre de l'application</span>" chrome:author="<span style="color:blue">Nom de l'auteur</span>" chrome:name="<span style="color:red">monapplication</span>" chrome:extension="true"/> - -</RDF:RDF></pre> - </li> - <li>Modifiez les textes surlignés du fichier ci-dessus avec vos propres informations. Le texte rouge <strong>monapplication</strong> devrait être l'ID de votre application. Habituellement, l'ID est le même que le nom de votre application. Remplacez le texte en bleu avec le titre et l'auteur de votre application.</li> - <li>Si le champ 'chrome:extension' est à 'true', l'application est une extension de Mozilla Firefox qui apparaîtra dans la fenêtre des extensions du navigateur. S'il est à 'faux', elle n'apparaîtra pas.</li> - <li>Sauvegardez le fichier contents.rdf et assurez vous qu'il se trouve bien dans le répertoire que vous avez créé à l'étape 1.</li> - <li>Ouvrez le fichier <mozilla-directory>/chrome/installed-chrome.txt, où <mozilla-directory> est le répertoire dans lequel est installé Mozilla. Quittez Mozilla avant cette opération.</li> - <li>Ensuite, vous allez enregistrer la nouvelle application pour que Mozilla sache la localiser. Ajoutez une ligne à la fin du fichier installed-chrome.txt pointant vers le nouveau répertoire que vous avez créé à l'étape 1. Modifiez le texte surligné correspondant au chemin du répertoire. Assurez vous que son URL finisse par un slash, et que vous avez appuyé sur <code>Entrée</code> en fin de ligne. Si vous n'êtes pas certain de l'écriture de cette URL, ouvrez le répertoire que vous avez créé à l'étape 1 dans le navigateur Mozilla et recopiez l'URL de la barre d'adresse. Notez que la référence doit toujours être un répertoire, pas un fichier. content,install,url,<span style=""><a class="external" rel="freelink">file:///main/app/</a></span></li> - <li>Effacez le fichier <mozilla-directory>/chrome/chrome.rdf.</li> - <li>Démarrez Mozilla. Vous devriez être capable de visualiser les fichiers XUL que vous avez placé dans ce répertoire en utilisant une URL de la forme : <code>chrome://<span style="">applicationid</span>/content/file.xul</code> où file.xul est le nom du fichier. Le nom de votre fichier principal doit être applicationid.xul, et il sera automatiquement chargé depuis l'URL raccourcie <code>chrome://<span style="">applicationid</span>/content/</code>.</li> -</ol> -<p>Si vous créez des portions de skin ou de locale, répétez les étapes précédentes à l'exception du format du fichier contents.rdf qui est légèrement différent. Regardez des fichiers contents.rdf dans d'autres applications pour plus de détails.</p> -<h3 id="Probl.C3.A8mes" name="Probl.C3.A8mes">Problèmes</h3> -<p>La création de paquetage chrome peut parfois s'avérer difficile et il est difficile de diagnostiquer les problèmes. Voici quelques astuces au cas où vous bloquez.</p> -<ul> - <li>Ouvrez le fichier <mozilla-directory>/chrome/chrome.rdf. Vous devriez y trouver des références à l'ID de votre application. S'il n'y en a pas, un problème a eu lieu avec l'enregistrement chrome. S'il y en a, vous avez probablement utilisé une mauvaise URL chrome pour charger le fichier.</li> - <li>Essayez d'effacer le fichier <mozilla-directory>/chrome/chrome.rdf. Il sera recréé. Effacez également tout le répertoire <mozilla-directory>/chrome/overlayinfo/ si vous utilisez des overlays.</li> - <li>Vérifiez que l'URL dans la ligne ajoutée dans installed-chrome.txt termine par un slash et que le fichier lui même se termine par une ligne vide.</li> - <li>Sous Windows, les URLs de fichiers sont de la forme '<a class="external" rel="freelink">file:///C</a>|/rep/app/', où C est la lettre du lecteur.</li> - <li>Vérifiez que le fichier contents.rdf est dans le bon répertoire et qu'il soit bien formé. Ouvrez le dans Mozilla pour voir s'il est traité comme du XML bien formé. S'il ne l'est pas, vous verrez un erreur sur un fond jaune.</li> - <li>Si vous utilisez une version de déboggage de Mozilla, certaines informations seront affichées dans le terminal lors du démarrage. Elles indiqueront quelle application chrome a été testée. Regardez si votre application y est listée.</li> - <li>Le message d'erreur "XML Parsing Error: undefined entity" dans votre fichier XUL peut être causé par une erreur dans le manifest ou dans le fichier JAR référencé par le manifest. Par exemple, dans <code><!DOCTYPE window SYSTEM "<a class="external" rel="freelink">chrome://fireclipse/locale/fireclipse.dtd</a>"></code>, le fichier dtd doit exister et son répertoire doit être correctement adressé dans le manifest "locale" pour que le traitement du XML n'échoue pas.</li> -</ul> -<p>Pour plus d'information concernant les fichiers manifest, consultez la page <a href="/fr/Enregistrement_chrome" title="fr/Enregistrement_chrome">Enregistrement chrome</a>.</p> -<p>Dans la section suivante, nous aborderons le langage XUL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL/L'URL_Chrome" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL/Créer_une_fenêtre">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes/index.html deleted file mode 100644 index 98826074eb..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes/index.html +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Les objets boîtes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_objets_boîtes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Box_Objects ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Manipulation_de_listes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Interfaces_XPCOM">Suivant »</a></p> -</div> - -<p>Cette section décrit l'objet boîte qui contient des informations relatives à l'affichage et à la mise en page d'une boîte XUL aussi bien que des détails sur la mise en page XUL.</p> - -<h3 id=".C3.80_propos_de_la_mise_en_page_XUL" name=".C3.80_propos_de_la_mise_en_page_XUL">À propos de la mise en page XUL</h3> - -<p>Mozilla divise son fonctionnement en deux séries d'arbres, l'arbre du contenu et l'arbre de mise en page. L'arbre de contenu stocke les nœuds trouvés tels quels dans le code source. L'arbre de mise en page contient un arbre différent des nœuds pour chaque composant individuel pouvant être affiché. L'arbre de mise en page contient la structure d'affichage des nœuds. Il n'y a pas forcément de relation directe entre le contenu et la mise en page des nœuds. Certains nœuds de contenu peuvent avoir plusieurs objets de mise en page, par exemple, chaque ligne d'un paragraphe a un objet de mise en page séparé. Réciproquement, certains nœuds de contenu n'ont aucun objet de mise en page. Par exemple, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> n'a aucun objet de mise en page puisqu'il n'est jamais affiché. De même, tout élément masqué n'aura plus d'objet de mise en page.</p> - -<p><abbr title="Document Object Model"><a href="/fr/DOM" title="fr/DOM">DOM</a></abbr> est généralement utilisé pour récupérer et modifier des informations concernant le contenu ou la structure d'un document. Il est relativement simple de déterminer quelle sorte de nœud de l'arbre sera créé pour un élément donné. Un élément XUL, par exemple, aura un type de nœud de contenu <code>XULElement</code>.</p> - -<p>Les objets de mise en page qui seront créés sont déterminés de manière plus complexe. Diverses parties d'information sont utilisées telles que le nom de la balise, les attributs d'un élément, diverses propriétés <a href="/fr/CSS" title="fr/CSS">CSS</a>, les éléments et les objets de mise en page autour de l'élément, et les liaisons <abbr title="eXtensible Binding Language">XBL</abbr> associées à un élément (les XBL seront décrites dans <a href="/fr/Tutoriel_XUL/Introduction_à_XBL" title="fr/Tutoriel_XUL/Introduction_à_XBL">une section ultérieure</a>). À moins que vous ne changiez le style d'un élément, la plupart des éléments XUL utilisent habituellement l'objet de boîte de mise en page ou un de ses sous-types. Souvenez-vous que tous les éléments XUL sont des types de boîtes, et que les boîtes sont la base de l'affichage de tous les éléments XUL. Toutefois, Il y a un certain nombre de sous-types, environ 25 ou plus, pour des éléments XUL spécifiques. Certains de ces sous-types, tels que les piles ou les boîtes de liste ont besoin d'une mise en page plus complexe qu'une simple boîte, tandis que d'autres, tels que les boutons, ne sont utilisés que pour ajouter la gestion des événements souris ou clavier.</p> - -<p>L'objet de mise en page associé à un élément peut être enlevé pour créer un objet de type complètement différent en changeant simplement la propriété <code>display</code> CSS. Par exemple, l'affectation de la valeur 'block' à la propriété <code>display</code> d'un élément bouton va effacer l'objet de mise en page et créer un objet 'block' à la place. Naturellement, ce changement modifiera l'apparence et les fonctionnalités de cet élément.</p> - -<p>Il n'est pas nécessaire de connaître les détails de la construction des objets de mise en page, mais il est quand même utile d'avoir la connaissance de comment est décrit la mise en page XUL pour aborder un développement avancé sous XUL.</p> - -<h3 id="Les_objets_de_bo.C3.AEte" name="Les_objets_de_bo.C3.AEte">Les objets de boîte</h3> - -<p>Les objets de mise en page ne peuvent pas être manipulés par les développeurs. Ils font partie des composants internes à la mise en page XUL. Toutefois, XUL fournit quelques objets d'aide, appelés objets de boîte, qui fournissent quelques informations concernant la mise en page. Comme leurs noms l'indiquent, ils sont disponibles pour tous éléments de type boîte.</p> - -<p>Il y a plusieurs sous-types d'objet boîte, bien que seul un petit nombre d'entre eux soit généralement employé. Les autres ont des fonctions plus accessibles par des méthodes liées directement à l'élément, car ces types sont généralement seulement utilisés avec un élément particulier. L'objet de boîte, ou l'interface <a class="external" href="http://www.xulplanet.com/references/objref/BoxObject.html">BoxObject</a>, toutefois, a un nombre de propriétés pouvant être utile pour le développement XUL.</p> - -<p>L'objet de boîte de base a deux fonctionnalités utiles. Premièrement, vous pouvez récupérer la position et les dimensions d'un élément XUL affiché, et deuxièmement, vous pouvez déterminer l'ordre d'affichage des éléments dans une boîte, au lieu de leurs ordres d'enregistrement dans le DOM.</p> - -<h4 id="R.C3.A9cup.C3.A9rer_la_position_et_les_dimensions" name="R.C3.A9cup.C3.A9rer_la_position_et_les_dimensions">Récupérer la position et les dimensions</h4> - -<p>L'objet de boîte fournit quatre propriétés, <code>x</code>, <code>y</code>, <code>width</code> et <code>height</code>, pour déterminer la position et les dimensions d'un élément. Les coordonnées <code>x</code> et <code>y</code> sont relatives au coin haut à gauche du document dans la fenêtre (en excluant le bord de la fenêtre et son titre). Elles sont mesurées en pixels. Les propriétés <code>width</code> et <code>height</code> sont également mesurées en pixels et retournent la largeur et la hauteur d'un élément en incluant les styles CSS <code>padding</code> et <code>border</code>, s'ils existent.</p> - -<p>Les valeurs sont toujours la position et les dimensions correspondant à l'affichage en cours, donc ces valeurs peuvent être différentes si l'élément est déplacé ou redimensionné. Par exemple, un élément flexible changera de taille et les dimensions de son objet de boîte seront mises à jour en conséquence. L'exemple suivant en offre une illustration :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_1.xul">Voir</a></p> - -<pre><button label="Cliquez ici" - oncommand="alert('La largeur est ' + this.boxObject.width);"/> -</pre> - -<p>Vous pouvez utiliser les attributs <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> et <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> pour définir respectivement la largeur et la hauteur d'un élément. Normalement, ces attributs n'ont pas à être modifiés et l'élément ajuste ses dimensions pour s'adapter au contenu. Ainsi, la définition de ces attributs substitue les valeurs spécifiées aux dimensions par défaut. Les propriétés <code>width</code> et <code>height</code> correspondantes peuvent être employées pour ajuster les dimensions d'un élément à tout moment, si vous souhaitez afficher un élément à une dimension précise. La récupération des valeurs de ces propriétés vous donnera les dimensions explicitement indiquées. Notez que ces propriétés renverront une chaîne vide si les attributs ou propriétés <code>width</code> et <code>height</code> n'ont pas encore été initialisées. Par conséquent, vous ne pouvez pas récupérer les dimensions actuelles avec ces propriétés ; vous devrez utiliser les propriétés de l'objet de boîte à la place.</p> - -<p>Cela doit vous sembler un peu confus, mais la clef est de se souvenir que les propriétés <code>width</code> et <code>height</code> d'un élément retournent les dimensions qui ont été définies dans le fichier XUL, tandis que les propriétés <code>width</code> et <code>height</code> de l'objet de boîte retournent les dimensions courantes réelles.</p> - -<h4 id=".C3.89l.C3.A9ment_cach.C3.A9_et_r.C3.A9duit" name=".C3.89l.C3.A9ment_cach.C3.A9_et_r.C3.A9duit">Élément caché et réduit</h4> - -<p>L'attribut <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> cachera un élément de telle sorte qu'il ne sera pas affiché. Comme il n'est pas affiché, les quatre propriétés de position et de dimensions de l'objet de boîte auront une valeur '0'. Lorsqu'un élément est caché, il est supprimé de l'affichage et ses objets de mise en page sont effacés. Ainsi, comme il n'est affiché nulle part, il n'aura ni position ni dimensions.</p> - -<p>L'attribut <code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code> aura le même effet visuel sur cet élément pour l'utilisateur, excepté le fait qu'il laisse l'élément sur l'écran et conserve les objets de mise en page intacts, mais en mettant ses dimensions à '0'. Cela signifie que même si les éléments cachés et réduits ont une largeur et une hauteur de '0', les éléments cachés auront une position <code>x</code> et <code>y</code> de '0' tandis que les éléments réduits conserveront leur position dans la fenêtre.</p> - -<p>Pour rechercher ou modifier les états <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> ou <code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, utilisez leurs propriétés respectives comme dans l'exemple suivant.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_2.xul">Voir</a></p> - -<pre><script> -function showPositionAndSize() -{ - var labelbox = document.getElementById('thelabel').boxObject; - - alert("La position est (" + labelbox.x + "," + labelbox.y + - ") et les dimensions sont (" + labelbox.width + "," + - labelbox.height + ")"); -} -</script> - -<button label="Caché" - oncommand="document.getElementById('thelabel').hidden = true;"/> -<button label="Montré" - oncommand="document.getElementById('thelabel').hidden = false;"/> -<button label="Réduit" - oncommand="document.getElementById('thelabel').collapsed = true;"/> -<button label="Non réduit" - oncommand="document.getElementById('thelabel').collapsed = false;"/> -<button label="Montrer la position et les dimensions - oncommand="showPositionAndSize();"/> -<label id="thelabel" value="Je suis un libellé"/> -</pre> - -<div class="note">Notez que si vous cachez ou réduisez le libellé, il sera invisible. Vous devrez changer ses attributs <code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code> ou <code>colapsed</code> pour le voir réapparaître.</div> - -<h3 id="Ordonnancement_des_.C3.A9l.C3.A9ments_XUL" name="Ordonnancement_des_.C3.A9l.C3.A9ments_XUL">Ordonnancement des éléments XUL</h3> - -<p>L'objet de boîte peut également être employé pour déterminer l'ordre d'affichage des éléments, qui peut ne pas être le même que dans la source. Souvenez-vous que les propriétés DOM telles que <code><a href="/fr/DOM/element.childNodes" title="fr/DOM/element.childNodes">childNodes</a></code>, <code><a href="/fr/DOM/element.firstChild" title="fr/DOM/element.firstChild">firstChild</a></code> et <code><a href="/fr/DOM/element.nextSibling" title="fr/DOM/element.nextSibling">nextSibling</a></code> peuvent être utilisées pour parcourir l'arbre de document. L'objet de boîte permet de naviguer de façon similaire mais retourne les éléments dans leur ordre d'affichage.</p> - -<p>L'objet de boîte fournit plusieurs propriétés, <code>firstChild</code>, <code>lastChild</code>, <code>nextSibling</code>, <code>previousSibling</code> et <code>parentBox</code>. Leurs noms devraient vous expliquer d'eux-même leur fonctionnement. Ces propriétés renvoient des éléments, par exemple, la propriété <code>firstChild</code> renvoie le premier élément enfant affiché. Il n'y a pas de propriété <code>childNodes</code> correspondante pour naviguer entre les boîtes ; à la place, vous devez utiliser les propriétés <code>nextSibling</code> et <code>previousSibling</code> pour parcourir les frères et sœurs.</p> - -<p>Contrairement à la navigation dans l'arbre DOM, les éléments cachés ne sont pas inclus dans la navigation avec les objets de boîte. Donc, si une boîte a six enfants dont les deux premiers sont cachés, la propriété <code>firstChild</code> renverra le troisième élément. Toutefois, les éléments réduits seront inclus car ils sont affichés même sans avoir de dimensions. Par exemple, la boîte sœur suivant le bouton 1 de l'exemple suivant sera le bouton 3, parce que le bouton 2 est caché. Mais la boîte sœur suivant le bouton 3 sera le bouton 4 qui est seulement réduit.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_3.xul">Voir</a></p> - -<pre><hbox> - <button label="Bouton 1" - oncommand="alert('Le suivant est : ' + this.boxObject.nextSibling.label);"/> - <button label="Bouton 2" hidden="true"/> - <button label="Bouton 3" - oncommand="alert('Le suivant est : ' + this.boxObject.nextSibling.label);"/> - <button label="Bouton 4" collapsed="true"/> -</hbox> -</pre> - -<h4 id="Attributs_d.27ordonnancement_de_bo.C3.AEte" name="Attributs_d.27ordonnancement_de_bo.C3.AEte">Attributs d'ordonnancement de boîte</h4> - -<p>Lorsqu'une boîte XUL est placée dans une fenêtre, les éléments sont ordonnés selon un certain nombre de propriétés, par exemple l'orientation, leur groupe ordinal et leur direction.</p> - -<h5 id="Attribut_XULAttrorient" name="Attribut_XULAttrorient">Attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code></h5> - -<p>L'orientation est communément modifiée en utilisant l'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>. Il existe également une propriété CSS <a href="/fr/docs/Web/CSS/-moz-box-orient" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>-moz-box-orient</code></a> correspondante qui peut remplacer l'attribut, en fonction de la situation. Cet attribut a été expliqué dans une section précédente sur les boîtes.</p> - -<h5 id="Attribut_XULAttrordinal" name="Attribut_XULAttrordinal">Attribut <code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code></h5> - -<p>L'attribut <code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code> d'un élément peut être placé pour spécifier un groupe ordonné d'éléments, ou vous pouvez utiliser la propriété CSS <a href="/fr/docs/Web/CSS/-moz-box-ordinal-group" title="La propriété -moz-box-ordinal-group indique le groupe ordinal auquel appartient l'élément. Les éléments dont le groupe ordinal est inférieur seront affichés avant ceux dont le groupe ordinal est plus élevé."><code>-moz-box-ordinal-group</code></a>.</p> - -<p>Les éléments avec une valeur ordinale inférieure sont placés dans la boîte avant les éléments ayant une plus grande valeur ordinale. Par exemple, un élément avec une valeur ordinale de '2' sera placé avant un élément ayant une valeur ordinale de '3' ou plus, mais après un élément ayant un ordinal de '1'. La valeur ordinale par défaut, si elle n'est pas définie, est de '1'. Cela signifie que si vous voulez modifier l'ordre d'affichage des éléments, vous aurez souvent besoin d'ajuster les ordinaux de plusieurs éléments.</p> - -<p>L'ajustement de l'ordinal d'un élément ne se fait pas aussi simplement par le placement des éléments dans un certain ordre dans la source. Il peut être utilisé pour réarranger les éléments plus tard sans ajuster le DOM. L'exemple suivant en est une illustration.</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_4.xul">Voir</a></p> - -<pre><hbox> - <button label="Un" oncommand="this.ordinal++;"/> - <button label="Deux" oncommand="this.ordinal++;"/> - <button label="Trois" oncommand="this.ordinal++;"/> -</hbox> -</pre> - -<p>Si vous pressez le premier bouton, son ordinal augmentera de un, de '1' à '2'. Il apparaîtra à la fin de la ligne puisque les autres boutons ont un ordinal de '1'. Si vous pressez le second bouton, son ordinal sera augmenté de un et sera déplacé à la fin de la ligne. Les éléments de même ordinal apparaîtront dans le même ordre que dans la source. Si vous pressez une nouvelle fois le bouton libellé 'Un', son ordinal augmentera à '3' et il sera déplacé à la fin. Finalement, presser le bouton libellé 'Trois' augmentera son ordinal à '2' et le fera apparaître entre les deux autres boutons.</p> - -<h5 id="Attribut_XULAttrdir" name="Attribut_XULAttrdir">Attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code></h5> - -<p>L'attribut final d'ordonnancement de boîte est l'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, ou la propriété CSS <a href="/fr/docs/Web/CSS/-moz-box-direction" title="Cette documentation n'a pas encore été rédigée, vous pouvez aider en contribuant !"><code>-moz-box-direction</code></a>. S'il est initialisé à 'reverse', tous les enfants dans la boîte sont affichés dans l'ordre inverse. Dans une boîte horizontale, les éléments seront affichés de la droite vers la gauche et dans une boîte verticale, les éléments seront affichés du bas vers le haut. Voici un exemple :</p> - -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxobject_5.xul">Voir</a></p> - -<pre><hbox dir="reverse"> - <button label="Gauche"/> - <button label="Centre"/> - <button label="Droite"/> -</hbox> -</pre> - -<p>Parcourir les nœuds en utilisant l'ordonnancement des objets de boîte vous renverra les éléments dans leur ordre d'affichage en tenant compte des ajustements faits sur leur ordinaux. Ainsi, si vous changez l'ordinal d'un élément, celui-ci aura une position différente dans la boîte. Toutefois, le renversement de la direction n'affectera pas l'ordre de la boîte.</p> - -<hr> -<p>Ensuite, nous verrons comment utiliser les objets XPCOM à partir de XUL et des scripts.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Manipulation_de_listes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Interfaces_XPCOM">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes_des_arbres/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes_des_arbres/index.html deleted file mode 100644 index 60924214cb..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_objets_boîtes_des_arbres/index.html +++ /dev/null @@ -1,193 +0,0 @@ ---- -title: Les objets boîtes des arbres -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_objets_boîtes_des_arbres -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Tree_Box_Objects ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Détails_sur_les_vues_d'arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Introduction_à_RDF">Suivant »</a></p> -</div> - -<p>Cette section va décrire l'objet de boîte d'arbre qui est utilisé pour gérer l'affichage d'un arbre.</p> - -<h3 id=".C3.80_propos_de_l.27objet_de_bo.C3.AEte" name=".C3.80_propos_de_l.27objet_de_bo.C3.AEte">À propos de l'objet de boîte</h3> - -<p>Les objets de boîte ont été décrits dans <a href="/fr/Tutoriel_XUL/Les_objets_boîtes" title="fr/Tutoriel_XUL/Les_objets_boîtes">une section précédente</a>. L'objet de boîte d'arbre est un objet de boîte spécial utilisé spécifiquement pour les arbres (tree). La boîte d'arbre implémente l'interface <code><a class="external" href="http://www.xulplanet.com/references/objref/TreeBoxObject.html">TreeBoxObject</a></code>.</p> - -<h4 id="Rafraichissement_de_l.27arbre" name="Rafraichissement_de_l.27arbre">Rafraichissement de l'arbre</h4> - -<p>Nous avons déjà vu la fonction <code>rowCountChanged()</code> de l'objet de boîte d'arbre dans la section précédente. Elle est employée pour indiquer qu'une ou plusieurs lignes de l'arbre ont été ajoutées ou enlevées. L'arbre rafraîchira l'affichage de la zone affectée. Vous n'avez pas besoin d'appeler la fonction <code>rowCountChanged()</code> lorsqu'une ligne a simplement été modifiée, comme par exemple lors du changement du libellé d'une cellule. Dans ce cas, d'autres fonctions d'affichage peuvent être utilisées. La plus simple est la fonction <code>invalidateRow()</code> qui rafraîchit l'affichage d'une ligne spécifique d'un arbre. L'arbre appellera la vue pour obtenir les données mises à jour et actualise son contenu à l'écran.</p> - -<p>Les autres fonctions de rafraichissement sont :</p> - -<ul> - <li><code>invalidateCell()</code> pour le rafraichissement d'une unique cellule,</li> - <li><code>invalidateColumn()</code> pour le rafraichissement d'une colonne,</li> - <li><code>invalidateRange()</code> pour le rafraichissement d'une plage de lignes,</li> - <li><code>invalidate()</code> pour le rafraichissement de l'arbre entier.</li> -</ul> - -<p>Notez que le rafraichissement de l'affichage n'aura lieu qu'une fois les tâches des scripts achevées, car Mozilla n'effectue pas cette opération en tâche de fond.</p> - -<h4 id="D.C3.A9filement_de_l.27arbre" name="D.C3.A9filement_de_l.27arbre">Défilement de l'arbre</h4> - -<p>Vous pouvez également faire défiler l'arbre en utilisant quatre méthodes différentes, similaires à celles disponibles pour les menus déroulants. La fonction <code>scrollToRow()</code> peut être utilisée pour faire le défilement jusqu'à une ligne particulière. Voici un exemple simple :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeboxobject_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeboxobject_1.xul">Voir</a></p> - -<pre><script> -function doScroll(){ - var value = document.getElementById("tbox").value; - var tree = document.getElementById("thetree"); - - var boxobject = tree.boxObject; - boxobject.QueryInterface(Components.interfaces.nsITreeBoxObject); - boxobject.scrollToRow(value); -} -</script> - -<tree id="thetree" rows="4"> - <treecols> - <treecol id="row" label="Ligne" primary="true" flex="1"/> - </treecols> - <treechildren> - <treeitem label="Ligne 0"/> - <treeitem label="Ligne 1"/> - <treeitem label="Ligne 2"/> - <treeitem label="Ligne 3"/> - <treeitem label="Ligne 4"/> - <treeitem label="Ligne 5"/> - <treeitem label="Ligne 6"/> - <treeitem label="Ligne 7"/> - <treeitem label="Ligne 8"/> - <treeitem label="Ligne 9"/> - </treechildren> -</tree> - -<hbox align="center"> - <label value="Défile jusqu'à la ligne :"/> - <textbox id="tbox"/> - <button label="Défile" oncommand="doScroll();"/> -</hbox> -</pre> - -<div class="note">Notez que nous utilisons l'attribut <code id="a-rows"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/rows">rows</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> pour spécifier que quatre lignes seulement doivent être affichées à la fois. Ainsi, il est plus facile de se représenter l'exemple. Notez également que la première ligne commence à '0'.</div> - -<p>La fonction <code>doScroll()</code> récupère l'objet de boîte et appelle la fonction <code>scrollToRow()</code> avec comme argument la valeur saisie dans le champ texte. Vous noterez que l'objet de boîte d'arbre peut être obtenu de la même manière qu'avec d'autres objets de boîte, en utilisant la propriété <code>boxObject</code>. Nous devons cependant appeler <code>QueryInterface()</code> pour invoquer l'objet de boîte spécifique aux arbres. Les fonctions générales de l'objet de boîte sont également disponibles pour les arbres.</p> - -<p>Les méthodes supplémentaires de défilement incluent les fonctions <code>scrollByLines()</code>, <code>scrollByPages()</code>, et <code>ensureRowIsVisible()</code>.</p> - -<p>La fonction <code>scrollByLines()</code> fait défiler vers le haut ou vers le bas d'un certain nombre de lignes ; un nombre positif fait défiler vers le bas, un nombre négatif fait défiler vers le haut. La fonction <code>scrollByPages()</code> fait défiler d'un certain nombre de pages. Elle est automatiquement appelée lorsque l'utilisateur appuie sur une des touches <code>Page Up</code> ou <code>Page Down</code> et que l'arbre a le focus. Une page est égale au nombre de lignes visibles. Par exemple, si un arbre affiche 10 lignes en même temps, une page sera équivalente à 10 lignes. C'est une méthode pratique dès lors que l'utilisateur redimensionne un arbre flexible : la taille de la page augmentera ou diminuera automatiquement sans avoir à la recalculer manuellement. Il n'est pas trop difficile de calculer cette taille manuellement car l'objet de boîte d'arbre fournit également une fonction <code>getPageLength()</code> qui retourne le nombre de lignes dans une page. Dans l'exemple de défilement ci-dessus, <code>getPageLength()</code> retournerait '4'.</p> - -<div class="note">Notez que dans Firefox 1.0 et Mozilla 1.7, et les versions plus récentes, la fonction <code>getPageLength()</code> est plutôt appelée <code>getPageCount()</code>. Le nom a été changé en <code>getPageLength()</code> afin d'éviter les confusions avec une fonction qui ne retourne pas le nombre de pages d'un arbre, mais la taille de chaque page. Vous pouvez déterminer le nombre de pages en divisant le nombre total de lignes par la taille d'une page.</div> - -<p>La fonction <code>ensureRowIsVisible()</code> fera défiler l'arbre jusqu'à une ligne, comme avec la fonction <code>scrollToRow()</code>, mais seulement si la ligne n'est pas visible au moment de l'appel.</p> - -<h3 id="Coordonn.C3.A9es_d.27une_cellule" name="Coordonn.C3.A9es_d.27une_cellule">Coordonnées d'une cellule</h3> - -<p>Certaines des fonctions les plus intéressantes d'un objet de boîte d'arbre sont utilisées pour obtenir les parties d'un arbre se trouvant à des coordonnées spécifiques et vice versa.</p> - -<ul> - <li>La fonction <code>getCellAt()</code> peut être utilisée pour obtenir une cellule précise située à un emplacement défini en pixels,</li> - <li>La fonction <code>getRowAt()</code> peut être utilisée pour obtenir une ligne à un emplacement défini lui aussi en pixels. La fonction <code>getRowAt()</code> prend deux arguments qui sont les coordonnées horizontales (x) et verticales (y).</li> -</ul> - -<pre>tree.boxObject.getRowAt( 50, 100 );</pre> - -<p>Cet exemple retournera l'index de la ligne ayant une position horizontale de '50' pixels et verticale de '100' pixel. Naturellement, la coordonnée x semble ne pas avoir beaucoup de sens dès lors que la ligne occupe tout l'espace horizontal de l'arbre.</p> - -<div class="note">Il est important de noter que les coordonnées sont mesurées à partir du coin supérieur gauche du document et non de l'arbre lui-même.</div> - -<p>Il est donc facile de passer à ces fonctions les coordonnées événementielles de l'objet <code>event</code>, comme avec la fonction <code>getCellAt()</code> dans l'exemple suivant.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeboxobject_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeboxobject_2.xul">Voir</a></p> - -<pre><script> -function updateFields(event){ - var row = {}, column = {}, part = {}; - var tree = document.getElementById("thetree"); - - var boxobject = tree.boxObject; - boxobject.QueryInterface(Components.interfaces.nsITreeBoxObject); - boxobject.getCellAt(event.clientX, event.clientY, row, column, part); - - if (column.value && typeof column.value != "string") - column.value = column.value.id; - - document.getElementById("row").value = row.value; - document.getElementById("column").value = column.value; - document.getElementById("part").value = part.value; -} -</script> - -<tree id="thetree" flex="1" onmousemove="updateFields(event);"> - <treecols> - <treecol id="utensil" label="Ustensiles" primary="true" flex="1"/> - <treecol id="count" label="Nombre" flex="1"/> - </treecols> - <treechildren> - <treeitem> - <treerow> - <treecell label="Fourchette"/> - <treecell label="5"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="Couteau"/> - <treecell label="2"/> - </treerow> - </treeitem> - <treeitem> - <treerow> - <treecell label="Cuillère"/> - <treecell label="8"/> - </treerow> - </treeitem> - </treechildren> -</tree> - -<label value="Ligne:"/> -<label id="row"/> -<label value="Colonne:"/> -<label id="column"/> -<label value="Type enfant:"/> -<label id="part"/> -</pre> - -<p>La fonction <code>getCellAt()</code> prend cinq arguments, les coordonnées où regarder et trois autres paramètres. Un argument par référence est utilisé parce que la fonction a besoin de retourner plusieurs valeurs. Vous verrez de nombreuses interfaces utilisant des arguments par référence avec <a class="external" href="http://www.xulplanet.com/references/objref/">les objets disponibles</a>. Ces arguments sont marqués avec un préfixe 'out'. Pour ceux-ci, vous devez transmettre un objet vide et la fonction remplira sa propriété <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> avec la valeur adéquate.</p> - -<p>Les trois paramètres par référence seront renseignés avec la ligne, la colonne et le type enfant. L'objet row contient l'index de la ligne survolée par la souris au moment où la fonction a été appelée par un événement mousemove, avec les coordonnées de cet événement. Si les coordonnées ne sont pas au-dessus d'une ligne de l'arbre, la valeur <code>row.value</code> sera égale à '-1'. La variable column est un objet <code>column</code> tel que défini dans Mozilla 1.8 et supérieur. Dans les versions plus anciennes, les colonnes étaient identifiées avec une chaîne de caractères (string) : l'identifiant <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de la colonne. Avec les versions plus récentes, un objet de colonne spécifique existe et permet de réaliser des requêtes sur les données en colonne.</p> - -<p>La ligne suivante est utilisée pour que l'exemple ci-dessus puisse fonctionner avec toutes les versions.</p> - -<pre>if (column.value && typeof column.value != "string") - column.value = column.value.id; -</pre> - -<p>Si la colonne est une chaîne de caractères, nous tournons sur Mozilla 1.7 ou inférieur, mais pour les versions récentes, nous obtenons l'identifiant de la colonne à partir de l'objet column. Si vous écrivez du code pour des versions multiples, vous devrez effectuer un test comme indiqué ci-avant.</p> - -<p>Le dernier argument de la fonction <code>getCellAt()</code> est le type enfant renseigné avec une chaîne dépendante de la partie de la cellule pointée par les coordonnées. Si vous déplacez la souris dans l'exemple précédent, vous noterez que le libellé passe de 'text' à 'cell'. La valeur 'text' indique la zone où le texte est dessiné et la valeur 'cell' indique la zone autour du texte ; par exemple, la marge gauche où sont habituellement dessinées les poignées ouvrantes et fermantes. Toutefois, s'il y avait une poignée, la valeur aurait plutôt été 'twisty'. Cette information pratique permet de déterminer si l'utilisateur a cliqué sur une poignée plutôt que sur une autre partie de la ligne. En fait, lorsque l'utilisateur double-clique sur la poignée, le code natif sous-jacent utilise cette méthode. La dernière valeur qui peut être retournée est 'image' si une image se trouve dans la cellule et que les coordonnées correspondent à celles de cette image. Bien entendu, dans la plupart des cas, vous ne désirez pas connaître quelle partie de la cellule pointe les coordonnées, mais seulement la ligne et la colonne concernées.</p> - -<p>Pour inverser la recherche et obtenir les coordonnées spécifiques d'une cellule, utilisez la fonction <code>getCoordsForCellItem()</code>. Elle prend sept arguments tels que décrits ci-dessous.</p> - -<pre>var x = {}, y = {}, width = {}, height = {}; -if (typeof tree.columns != "undefined") column = tree.columns[column]; -tree.boxObject.getCoordsForCellItem( row, column, part, x, y, width, height ); -</pre> - -<p>Les arguments 'row', 'column' et 'part' sont similaires à ceux retournés par la fonction <code>getCellAt()</code>. De nouveau, le type de l'argument 'column' dépend de la version que vous utilisez, soit une chaîne de caractères (string), soit un objet column. Le type de la zone de la cellule peut être utilisé pour obtenir les coordonnées, soit du texte, soit de toute la cellule, soit de la poignée, soit de l'image dans la cellule. Les mêmes valeurs que la fonction <code>getCellAt()</code> sont utilisées. La fonction <code>getCoordsForCellItem()</code> retourne par le biais des arguments passés en référence les coordonnées horizontales (x) et verticales (y), accompagnées de la largeur et la hauteur.</p> - -<hr> -<p>Par la suite, nous verrons comment RDF peut être utilisé automatiquement pour peupler des arbres et d'autres éléments.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Détails_sur_les_vues_d'arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Introduction_à_RDF">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/les_scripts_d'installation/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/les_scripts_d'installation/index.html deleted file mode 100644 index 0f5213a192..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/les_scripts_d'installation/index.html +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: Les scripts d'installation -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Les_scripts_d'installation -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Install_Scripts ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Création_d'un_programme_d'installation" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Fonctions_additionnelles_d'installation">Suivant »</a></p> -</div> - -<div class="note">NdT : Attention, cette section décrit le mécanisme XPInstall propre à la suite Mozilla et à des versions anciennes de Mozilla Firefox. Pour les versions récentes de Mozilla Firefox, ce mode d'installation n'est plus le même, mais il n'est pas encore décrit dans ce tutoriel. Voir <a class="external" href="http://xulfr.org/wiki/ExtensionsFirefox">comment faire des extensions pour firefox</a> sur xulfr.org.</div> - -<p>Cette section décrit le script d'installation.</p> - -<h3 id="Cr.C3.A9ation_d.27un_script_d.27installation" name="Cr.C3.A9ation_d.27un_script_d.27installation">Création d'un script d'installation</h3> - -<div class="note"><strong>Note :</strong> Pour des extensions Firefox, <code>install.js</code> n'est plus utilisé. Vous devez utiliser <a href="/fr/Tutoriel_XUL/Les_fichiers_manifest" title="fr/Tutoriel_XUL/Les_fichiers_manifest">install.rdf</a> à la place.</div> - -<p>Vous voulez généralement avoir une forme de contrôle sur vos processus d'installation. Par exemple, vous pouvez souhaiter vérifier les versions des fichiers existants et n'installer que des mises à jour, ou peut être souhaiteriez-vous simplement appliquer des corrections. Le script d'installation est même assez souple pour vous permettre de désinstaller des fichiers. Pour ces raisons, les programmes d'installation incluent un script propre à cette tâche.</p> - -<p>Le script d'installation doit s'appeler 'install.js' et doit être placé à la racine de l'archive de l'installeur. Ce script contient du code JavaScript qui appelle un certain nombre de fonctions d'installation.</p> - -<p>Dans un document HTML ou un document XUL, l'objet window est l'objet global racine. Il signifie que vous pouvez appeler les méthodes de l'objet window sans les faire précéder de leur qualificateur, ainsi <code>window.open()</code> peut simplement être écrit <code>open()</code>. Dans un script d'installation, il n'y a pas de fenêtre associée, toutefois l'objet global sera l'objet <code>Install</code> qui contient un certain nombre de fonctions pour personnaliser le processus d'installation. Certaines fonctions de l'objet global <code>Install</code> seront décrites ci dessous.</p> - -<p>Le script d'installation doit suivre les étapes suivantes :</p> - -<ol> - <li>Initialiser l'installation en précisant le paquetage et sa version.</li> - <li>Utiliser les fonctions d'installation pour spécifier les fichiers et les répertoires qui doivent être installés. Vous pouvez aussi spécifier les fichiers à déplacer ou à effacer.</li> - <li>Démarrer le processus qui installe les fichiers nécessaires.</li> -</ol> - -<p>Il est important de signaler que pendant l'étape numéro deux, vous n'indiquez seulement quels sont les fichiers qui seront installés et quelles autres opérations vous souhaitez réaliser. Aucun fichier ne sera copié avant l'étape trois. En procédant de la sorte, vous pouvez facilement définir plusieurs fichiers à installer, et en cas d'erreurs, vous pouvez annuler tout le processus d'installation sans modifier le système de l'utilisateur.</p> - -<h3 id="Le_registre_d.27extensions" name="Le_registre_d.27extensions">Le registre d'extensions</h3> - -<p>Mozilla tient à jour un fichier qui est un registre de toutes les extensions actuellement installées. Les extensions incluent les nouveaux paquetages chrome, les thèmes graphiques et les plugins. Lorsqu'une nouvelle extension est installée, le registre est mis à jour. Le registre stocke aussi l'ensemble des informations des fichiers et de leurs versions sur les extensions installées. De cette manière, il est aisé de vérifier si une version de votre extension est déjà présente et de la mettre à jour seulement si nécessaire.</p> - -<p>Le registre d'extensions fonctionne presque comme la base de registre de Windows. Il consiste en une série hiérarchisée de clefs et de valeurs. Vous n'avez pas besoin d'en savoir plus à son sujet pour créer des applications XUL à moins que vous ne créiez vos propres composants <a href="/fr/Tutoriel_XUL/Interfaces_XPCOM" title="fr/Tutoriel_XUL/Interfaces_XPCOM">XPCOM</a>.</p> - -<p>Ce que vous devez savoir pour une installation est que le registre stocke une série d'informations sur votre application, tels que la liste des fichiers et leurs versions. Toutes ces informations sont stockées dans une clef (et à l'intérieur, des sous clefs) que vous fournissez dans le script d'installation (dans l'étape 1 mentionnée ci dessus).</p> - -<p>Cette clef est structurée comme une arborescence de répertoire comme ceci :</p> - -<pre>/Auteur/Nom du Paquetage</pre> - -<p>Remplacez le mot 'Auteur' par votre nom et remplacez le 'Nom du Paquetage' avec le nom de votre paquetage que vous installez. Par exemple :</p> - -<pre>/Xulplanet/Find Files - -/Netscape/Personal Security Manager</pre> - -<p>Le premier exemple est celui utilisé pour notre exemple de boite de dialogue de recherche de fichiers. Le second est la clef utilisée pour le gestionnaire de données privées.</p> - -<h3 id="Initialisation_de_l.27installation" name="Initialisation_de_l.27installation">Initialisation de l'installation</h3> - -<p>L'objet <code>Install</code> a une fonction, <code>initInstall()</code>, servant à initialiser l'installation. Elle doit être appelée au lancement de votre script d'installation. La syntaxe de cette fonction est la suivante :</p> - -<pre>initInstall( packageName , regPackage , version ); - -'''Exemple:''' - -initInstall("Find Files","/Xulplanet/Find Files","0.5.0.0");</pre> - -<ul> - <li>Le premier argument est le nom du paquetage sous une forme lisible pour l'utilisateur.</li> - <li>Le second argument est la clef du registre utilisée pour mémoriser l'information du paquetage comme décrit ci avant.</li> - <li>Le troisième argument est la version du paquetage à installer.</li> -</ul> - -<p>Ensuite, nous devons indiquer le répertoire où seront installés les fichiers. Il y a deux façons de le faire.</p> - -<ul> - <li>La méthode simple est d'assigner un répertoire d'installation et d'y copier tous les fichiers.</li> - <li>La seconde méthode vous permet d'assigner une destination à chaque fichier (ou répertoire). La première méthode est décrite ci dessous.</li> -</ul> - -<p>La fonction <code>setPackageFolder()</code> assigne un répertoire d'installation. Pour l'exemple de recherche de fichiers, vous installerons les fichiers dans le répertoire chrome (nous pourrions aussi bien les mettre autre part). Cette fonction <code>setPackageFolder()</code> ne requiert qu'un argument, le répertoire d'installation. Pour une compatibilité maximale, vous ne devez pas spécifier un répertoire absolu. Au lieu de cela, vous utiliserez un identifiant d'un répertoire connu et pointerez sur un de ses sous répertoires. Ainsi, si votre application a besoin d'installer quelques librairies systèmes, vous n'avez pas besoin de connaître le nom de ces répertoires.</p> - -<p>Les identifiants de sélection de répertoires sont expliqués sur la page de <a class="external" href="http://www.xulplanet.com/references/elemref/ref_Install.html#prop_getFolder">XULPlanet référence</a>. Pour le répertoire chrome, l'identifiant est 'Chrome'. La fonction <code>getFolder()</code> peut être utilisée pour récupérer un de ces répertoires spéciaux. Cette fonction prend deux arguments, le premier étant l'identifiant et le second étant un sous répertoire. Par exemple :</p> - -<pre>findDir = getFolder("Chrome","findfile"); setPackageFolder(findDir);</pre> - -<p>Ici, nous récupérons l'emplacement du sous répertoire 'findfile' dans répertoire Chrome et nous le passons directement à la fonction <code>setPackageFolder()</code>. Le second argument de la fonction <code>getFolder()</code> est le sous répertoire qui servira à l'installation de l'exemple et qui n'a pas besoin d'avoir été créé d'abord. Vous pouvez ignorer cet argument si vous n'en avez pas besoin.</p> - -<h3 id="Marquage_des_fichiers_d.27installation" name="Marquage_des_fichiers_d.27installation">Marquage des fichiers d'installation</h3> - -<p>Ensuite, vous devez indiquer quels seront les fichiers à installer. Deux fonctions doivent être employées pour cela, <code>addDirectory()</code> et <code>addFile()</code>. La fonction <code>addDirectory()</code> précise à l'installeur un répertoire de l'archive XPI (et tout son contenu) qui devra être installé à un emplacement particulier. La fonction <code>addFile()</code> est similaire mais seulement pour un fichier.</p> - -<p>Les deux fonctions <code>addDirectory()</code> et <code>addFile()</code> ont plusieurs paramétrages. Le plus simple ne prend qu'un seul argument qui est le répertoire servant à l'installation.</p> - -<pre class="eval">addDirectory ( <em>dir</em> ); -addFile ( <em>dir</em> ); - -<strong>Exemple:</strong> - -addDirectory("findfile"); -</pre> - -<p>L'exemple ci dessus spécifie que le répertoire 'findfile' de l'archive d'installation est à installer. Nous pouvons appeler ces fonctions autant de fois que nécessaire pour les autres fichiers.</p> - -<p>Ensuite, nous voulons enregistrer les fichiers de notre exemple dans le registre chrome afin de pouvoir les appeler par une URL chrome. La fonction <code>registerChrome()</code> est utilisée pour cela. Elle prend deux arguments, le premier étant le type d'enregistrement chrome ('content' pour du contenu, 'skin' pour du thème graphique, ou 'locale' pour la localisation), le second pointant vers l'emplacement du fichier manifest 'contents.rdf' à enregistrer. Comme notre exemple de recherche de fichiers contient les trois types, la fonction <code>registerChrome()</code> devra être appelée trois fois.</p> - -<pre>registerChrome(Install.CONTENT | Install.DELAYED_CHROME, getFolder(findDir, "content")); -registerChrome(Install.SKIN | Install.DELAYED_CHROME, getFolder(findDir, "skin")); -registerChrome(Install.LOCALE | Install.DELAYED_CHROME, getFolder(findDir, "locale")); -</pre> - -<p>L'indicateur DELAYED_CHROME sert à indiquer que le chrome devra être installé au prochain lancement de Mozilla.</p> - -<h3 id="Finalisation_de_l.27installation" name="Finalisation_de_l.27installation">Finalisation de l'installation</h3> - -<p>Les fonctions <code>addDirectory()</code> et <code>addFile()</code> ne copient aucun fichier. Elles ne servent qu'à pointer quels fichiers devront être installés. De la même manière, la fonction <code>registerChrome()</code> ne fait que pointer quel chrome devra être enregistré. Pour achever le processus et commencer la copie des fichiers, appelez la fonction <code>performInstall()</code> sans argument.</p> - -<div class="highlight"> -<p>Le script final pour installer notre exemple de recherche de fichiers est le suivant :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_xpiscript_1.js.txt">Source</a></p> - -<pre>initInstall("Find Files","/Xulplanet/Find Files","0.5.0.0"); - -findDir = getFolder("Chrome","findfile"); -setPackageFolder(findDir); - -addDirectory("findfile"); - -registerChrome(Install.CONTENT | Install.DELAYED_CHROME, getFolder(findDir, "content")); -registerChrome(Install.SKIN | Install.DELAYED_CHROME, getFolder(findDir, "skin")); -registerChrome(Install.LOCALE | Install.DELAYED_CHROME, getFolder(findDir, "locale")); - -performInstall(); -</pre> -</div> - -<hr> -<p>Dans la section suivantes, nous verrons quelques fonctions supplémentaires pour l'installation.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Création_d'un_programme_d'installation" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Fonctions_additionnelles_d'installation">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/localisation/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/localisation/index.html deleted file mode 100644 index 3bc67299f8..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/localisation/index.html +++ /dev/null @@ -1,328 +0,0 @@ ---- -title: Localisation -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Localisation -tags: - - Localisation - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Localization ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Créer_un_thème" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_fichiers_de_propriétés">Suivant »</a></p> -</div> - -<p>XUL et XML fournissent des entités qui sont une solution permettant la localisation.</p> - -<h3 id="Entit.C3.A9s" name="Entit.C3.A9s">Entités</h3> - -<p>De nombreuses applications sont construites de telle sorte que la traduction de l'interface en différentes langues soit le plus simple possible. En général, une table de chaînes de caractères est créée pour chaque langue. Au lieu de la coder directement dans l'application, chaque partie de texte est seulement une référence dans la table de chaînes. <a href="/fr/XML" title="fr/XML">XML</a> fournit des entités qui peuvent être utilisées dans un but similaire.</p> - -<p>Vous devriez déjà être familier avec les entités si vous avez déjà écrit en <a href="/fr/HTML" title="fr/HTML">HTML</a>. Les codes <code>&lt;</code> et <code>&gt;</code> sont des exemples d'entités qui peuvent être utilisées pour placer les signes "inférieur" et "supérieur" dans le texte. XML a une syntaxe qui autorise la déclaration de vos propres entités. Vous pouvez les utiliser de manière à ce que l'entité soit remplacée par sa valeur qui peut être une chaîne de caractères. Des entités peuvent être employées toutes les fois où du texte est utilisé, y compris pour les valeurs des attributs. L'exemple ci-dessous décrit l'utilisation d'une entité dans un bouton.</p> - -<pre><button label="&findLabel;"/></pre> - -<p>Le texte qui apparaîtra sur le libellé sera la valeur de l'entité <code>&findlabel;</code></p> - -<p>Un fichier contenant les déclarations d'entités pour chaque langue supportée est créé. En français, on affectera probablement la valeur de texte 'Rechercher' à l'entité <code>&findlabel;</code></p> - -<h3 id="Les_fichiers_DTD" name="Les_fichiers_DTD">Les fichiers DTD</h3> - -<p> </p> - -<p>Les entités sont déclarées dans des fichiers DTD (<em>Document Type Declaration</em>). Ces types de fichiers sont en général utilisés pour déclarer la syntaxe et la sémantique d'un fichier XML particulier, mais ils autorisent aussi la déclaration d'entités. Dans le système chrome de Mozilla, vous trouverez les fichiers DTD dans le sous-répertoire <code>locales</code>. Vous devriez normalement avoir un fichier DTD (avec un extension <code>dtd</code>) par fichier XUL.</p> - -<p> </p> - -<p>Si vous regardez dans le répertoire chrome, vous devriez voir une archive pour votre langue (<code>fr.jar</code> par défaut pour le français). Vous pouvez avoir les fichiers de locales dans des langues multiples, par exemple, Anglais US (en-US) et Danois (dk). Dans ces archives, vous trouverez les fichiers qui contiennent les traductions pour chaque fenêtre. La structure de l'archive est très similaire à la structure des répertoires utilisée pour <a href="/fr/Tutoriel_XUL/Créer_un_thème" title="fr/Tutoriel_XUL/Créer_un_thème">les thèmes</a>.</p> - -<p> </p> - -<p>Dans les archives, vous placerez les fichiers DTD, dans lesquels vous déclarez les entités. Normalement vous aurez un fichier DTD par fichier XUL, en général avec le même nom de fichier excepté qu'il aura une extension <code>.dtd</code>. Donc pour la fenêtre de dialogue de recherche de fichiers, vous aurez besoin d'un fichier nommé <code>findfile.dtd</code>.</p> - -<p> </p> - -<p>Pour les fichiers chromes non installés, vous pouvez juste mettre le fichier DTD dans le même répertoire que le fichier XUL.</p> - -<div class="note"><strong>Note :</strong> Vous devez encoder les fichiers en UTF-8 à cause des caractères non ASCII. De ce fait, vous devez les sauvegarder au format UTF-8 (<a class="external" href="http://www.mozdev.org/notes/l10n/unicode/editors-en.html">sans BOM</a>). Pour plus d'information, consultez <a class="external" href="http://www.mozilla.org/projects/l10n/mlp_chrome.html#text">Mozilla language Packs</a>.</div> - -<p>Une fois que vous avez créé le fichier DTD pour votre fichier XUL, vous aurez besoin d'ajouter une ligne dans le fichier XUL qui indiquera que vous voulez utilisez le fichier DTD. Sinon, des erreurs seront générées car il ne sera pas capable de trouver les entités. Il vous suffit d'ajouter une ligne de la forme suivante vers le début du fichier XUL :</p> - -<pre><!DOCTYPE window SYSTEM "chrome://findfile/locale/findfile.dtd"></pre> - -<p>Cette ligne spécifie que l'URL indiquée est à utiliser en tant que fichier DTD. Dans ce cas, nous avons déclaré que nous voulons utiliser le fichier DTD <code>findfile.dtd</code>. Cette ligne est en général placée juste avant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>.</p> - -<p>Vous devez également ajouter la localisation dans le fichier <a href="/fr/Enregistrement_chrome#locale" title="fr/Enregistrement_chrome#locale">chrome.manifest</a>, par exemple :</p> - -<pre class="eval">locale findfile fr locale/ -</pre> - -<h3 id="D.C3.A9clarer_les_entit.C3.A9s" name="D.C3.A9clarer_les_entit.C3.A9s">Déclarer les entités</h3> - -<p>Les entités sont déclarées en utilisant une syntaxe simple vue ci-dessous :</p> - -<pre><!ENTITY findLabel "Rechercher"></pre> - -<p>Cet exemple crée une entité avec le nom 'findLabel' et la valeur 'Rechercher'. Elle signifie que quelque soit l'endroit où le texte '&findLabel;' apparaîtra dans le fichier XUL, il sera remplacé par le texte 'Rechercher'. Notez que les déclarations d'entités n'ont pas de slash terminal. Dans le fichier DTD d'une autre langue, le texte pour cette langue sera utilisé à la place.</p> - -<pre class="eval"><strong>pour l'anglais:</strong> -<!ENTITY findLabel "Find"> -</pre> - -<p>Par exemple, le texte suivant :</p> - -<pre><description value="&findLabel;"/></pre> - -<p>est converti en :</p> - -<pre class="eval"><strong>version française:</strong> -<description value="Rechercher"/> - -<strong>version anglaise</strong> -<description value="Find"/> -</pre> - -<p>Vous devrez déclarer une entité pour chaque libellé ou chaîne de caractères que vous utiliserez dans votre interface. Vous ne devriez plus avoir de texte affiché directement dans le fichier XUL.</p> - -<p>En plus d'utiliser les entités pour les libellés, vous devriez les utiliser pour chaque valeur qui pourrait être différente selon la langue ; <a href="/fr/Tutoriel_XUL/Raccourcis_clavier" title="fr/Tutoriel_XUL/Raccourcis_clavier">les touches d'accès et les raccourcis claviers</a> par exemple.</p> - -<pre class="eval"><strong>XUL</strong> -<menuitem label="&undo.label;" accesskey="&undo.key;"/> -<strong>DTD</strong> -<!ENTITY undo.label "Annuler"> -<!ENTITY undo.key "u"> -</pre> - -<p>L'exemple ci-dessus utilise deux entités, une pour le libellé de l'élément de menu Annuler et une seconde pour la touche d'accès.</p> - -<div class="highlight"> -<h3 id="Modification_de_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers" name="Modification_de_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers">Modification de la boîte de dialogue de recherche de fichiers</h3> - -<p>Jetons un œil sur la manière dont nous pourrions utiliser tout ce que nous avons appris en modifiant la boîte de dialogue de recherche de fichiers de manière à ce qu'elle utilise un fichier DTD pour toutes ses chaînes de caractères. La totalité du fichier XUL est décrite ci-dessous avec les changements décrits en rouge.</p> - -<pre class="eval"><?xml version="1.0"?> - -<?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?> -<?xml-stylesheet href="findfile.css" type="text/css"?> - -<span class="highlightred"><!DOCTYPE window SYSTEM "<a class="external" rel="freelink">chrome://findfile/locale/findfile.dtd</a>"></span> - -<window - id="findfile-window" - title="<span class="highlightred">&findWindow.title;</span>" - persist="screenX screenY width height" - orient="horizontal" - onload="initSearchList()" - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - -<script src="findfile.js"/> - -<popupset> - <menupopup id="editpopup"> - <menuitem label="<span class="highlightred">&cutCmd.label;</span>" accesskey="<span class="highlightred">&cutCmd.accesskey;</span>"/> - <menuitem label="<span class="highlightred">&copyCmd.label;</span>" accesskey="<span class="highlightred">&copyCmd.accesskey;</span>"/> - <menuitem label="<span class="highlightred">&pasteCmd.label;</span>" accesskey="<span class="highlightred">&pasteCmd.accesskey;</span>" disabled="true"/> - </menupopup> -</popupset> - -<keyset> - <key id="cut_cmd" modifiers="accel" key="<span class="highlightred">&cutCmd.commandkey;</span>"/> - <key id="copy_cmd" modifiers="accel" key="<span class="highlightred">&copyCmd.commandkey;</span>"/> - <key id="paste_cmd" modifiers="accel" key="<span class="highlightred">&pasteCmd.commandkey;</span>"/> - <key id="close_cmd" keycode="VK_ESCAPE" oncommand="window.close();"/> -</keyset> - -<vbox flex="1"> - - <toolbox> - - <menubar id="findfiles-menubar"> - <menu id="file-menu" label="<span class="highlightred">&fileMenu.label;</span>" - accesskey="<span class="highlightred">&fileMenu.accesskey;</span>"> - <menupopup id="file-popup"> - <menuitem label="<span class="highlightred">&openCmd.label;</span>" - accesskey="<span class="highlightred">&openCmd.accesskey;</span>"/> - <menuitem label="<span class="highlightred">&saveCmd.label;</span>" - accesskey="<span class="highlightred">&saveCmd.accesskey;</span>"/> - <menuseparator/> - <menuitem label="<span class="highlightred">&closeCmd.label;</span>" - accesskey="<span class="highlightred">&closeCmd.accesskey;" key="close_cmd" oncommand="window.close();</span>"/> - </menupopup> - </menu> - <menu id="edit-menu" label="<span class="highlightred">&editMenu.label;</span>" - accesskey="<span class="highlightred">&editMenu.accesskey;</span>"> - <menupopup id="edit-popup"> - <menuitem label="<span class="highlightred">&cutCmd.label;</span>" - accesskey="<span class="highlightred">&cutCmd.accesskey;</span>" key="cut_cmd"/> - <menuitem label="<span class="highlightred">&copyCmd.label;</span>" - accesskey="<span class="highlightred">&copyCmd.accesskey;</span>" key="copy_cmd"/> - <menuitem label="<span class="highlightred">&pasteCmd.label;</span>" - accesskey="<span class="highlightred">&pasteCmd.accesskey;</span>" key="paste_cmd" disabled="true"/> - </menupopup> - </menu> - </menubar> - - <toolbar id="findfiles-toolbar"> - <toolbarbutton id="opensearch" label="<span class="highlightred">&openCmdToolbar.label;</span>"/> - <toolbarbutton id="savesearch" label="<span class="highlightred">&saveCmdToolbar.label;</span>"/> - </toolbar> - </toolbox> - - <tabbox> - <tabs> - <tab label="<span class="highlightred">&searchTab;</span>" selected="true"/> - <tab label="<span class="highlightred">&optionsTab;</span>"/> - </tabs> - - <tabpanels> - - <tabpanel id="searchpanel" orient="vertical" context="editpopup"> - - <description> - <span class="highlightred">&findDescription;</span> - </description> - - <spacer class="titlespace"/> - - <groupbox orient="horizontal"> - <caption label="<span class="highlightred">&findCriteria;</span>"/> - - <menulist id="searchtype"> - <menupopup> - <menuitem label="<span class="highlightred">&type.name;</span>"/> - <menuitem label="<span class="highlightred">&type.size;</span>"/> - <menuitem label="<span class="highlightred">&type.date;</span>"/> - </menupopup> - </menulist> - <spacer class="springspace"/> - <menulist id="searchmode"> - <menupopup> - <menuitem label="<span class="highlightred">&mode.is;</span>"/> - <menuitem label="<span class="highlightred">&mode.isnot;</span>"/> - </menupopup> - </menulist> - <spacer class="springspace"/> - - <menulist id="find-text" flex="1" - editable="true" - datasources="<a class="external" rel="freelink">file:///mozilla/recents.rdf</a>" - ref="<span class="nowiki">http://www.xulplanet.com/rdf/recent/all</span>"> - <template> - <menupopup> - <menuitem label="<span class="nowiki">rdf:http://www.xulplanet.com/rdf/recent#Label</span>" uri="rdf:*"/> - </menupopup> - </template> - </menulist> - - </groupbox> - - </tabpanel> - - <tabpanel id="optionspanel" orient="vertical"> - <checkbox id="casecheck" label="<span class="highlightred">&casesensitive;</span>"/> - <checkbox id="wordscheck" label="<span class="highlightred">&matchfilename;</span>"/> - </tabpanel> - - </tabpanels> - </tabbox> - - <tree id="results" style="display: none;" flex="1"> - <treecols> - <treecol id="name" label="<span class="highlightred">&results.filename;</span>" flex="1"/> - <treecol id="location" label="<span class="highlightred">&results.location;</span>" flex="2"/> - <treecol id="size" label="<span class="highlightred">&results.size;</span>" flex="1"/> - </treecols> - - <treechildren> - <treeitem> - <treerow> - <treecell label="mozilla"/> - <treecell label="/usr/local"/> - <treecell label="<span class="highlightred">&bytes.before;</span>2520<span class="highlightred">&bytes.after;</span>"/> - </treerow> - </treeitem> - </treechildren> - </tree> - - <splitter id="splitbar" resizeafter="grow" style="display: none;"/> - - <spacer class="titlespace"/> - - <hbox> - <progressmeter id="progmeter" value="50%" style="display: none;"/> - <spacer flex="1"/> - <button id="find-button" label="<span class="highlightred">&button.find;</span>" - oncommand="doFind()"/> - <button id="cancel-button" label="<span class="highlightred">&button.cancel;</span>" - oncommand="window.close();"/> - </hbox> -</vbox> - -</window> -</pre> - -<p>Chaque chaîne de caractères a été remplacée par une référence à une entité. Un fichier DTD a été inclus au début du fichier XUL. Chaque entité qui a été ajoutée doit être déclarée dans le fichier DTD. La fenêtre ne sera pas affichée si une entité non déclarée est trouvée dans le fichier XUL.</p> - -<p>Notez que le nom de l'entité n'est pas important. Dans l'exemple ci-dessus, les mots dans les entités ont été séparés par des points. Vous n'avez pas à faire ça. Les noms des entités ici suivent des conventions similaires au reste du code de Mozilla.</p> - -<p>Vous aurez noté que le texte '2520 octets' a été remplacé par deux entités. En fait, la structure de la phrase pourrait être différente dans une autre langue. Par exemple, le nombre pourrait apparaître après l'équivalent du mot 'octets' au lieu d'avant. Bien sûr, il est beaucoup plus compliqué de vouloir l'affichage des Ko ou des Mo selon les besoins.</p> - -<p>Les touches d'accès et les raccourcis claviers ont aussi été traduits dans les entités car ils seront peut être différents dans une autre langue.</p> - -<p>Voici le fichier DTD (findfile.dtd) :</p> - -<pre><!ENTITY findWindow.title "Recherche de fichiers"> -<!ENTITY fileMenu.label "Fichier"> -<!ENTITY editMenu.label "Edition"> -<!ENTITY fileMenu.accesskey "f"> -<!ENTITY editMenu.accesskey "e"> -<!ENTITY openCmd.label "Ouvrir une recherche..."> -<!ENTITY saveCmd.label "Sauvegarder une recherche..."> -<!ENTITY closeCmd.label "Fermer"> -<!ENTITY openCmd.accesskey "o"> -<!ENTITY saveCmd.accesskey "s"> -<!ENTITY closeCmd.accesskey "f"> -<!ENTITY cutCmd.label "Couper"> -<!ENTITY copyCmd.label "Copier"> -<!ENTITY pasteCmd.label "Coller"> -<!ENTITY cutCmd.accesskey "p"> -<!ENTITY copyCmd.accesskey "c"> -<!ENTITY pasteCmd.accesskey "l"> -<!ENTITY cutCmd.commandkey "X"> -<!ENTITY copyCmd.commandkey "C"> -<!ENTITY pasteCmd.commandkey "V"> -<!ENTITY openCmdToolbar.label "Ouvrir"> -<!ENTITY saveCmdToolbar.label "Sauvegarder"> -<!ENTITY searchTab "Rechercher"> -<!ENTITY optionsTab "Options"> -<!ENTITY findDescription "Entrez votre critère de recherche ci-dessous et appuyer sur le bouton Rechercher."> -<!ENTITY findCriteria "Critère de recherche"> -<!ENTITY type.name "Nom"> -<!ENTITY type.size "Taille"> -<!ENTITY type.date "Date de modification"> -<!ENTITY mode.is "Est"> -<!ENTITY mode.isnot "N'est pas"> -<!ENTITY casesensitive "Recherche sensible à la casse"> -<!ENTITY matchfilename "Rechercher un nom entier"> -<!ENTITY results.filename "Nom de fichier"> -<!ENTITY results.location "Emplacement"> -<!ENTITY results.size "Taille"> -<!ENTITY bytes.before ""> -<!ENTITY bytes.after "octets"> -<!ENTITY button.find "Rechercher"> -<!ENTITY button.cancel "Annuler"> -</pre> - -<p>Maintenant pour changer de langue, tout ce que vous avez à faire est de créer un nouveau fichier DTD. En utilisant le système chrome pour ajouter le fichier DTD dans une langue différente, le même fichier XUL peut être utilisé pour toutes les langues.</p> -</div> - -<hr> -<p>Dans la prochaine section, nous regarderons les fichiers de propriétés.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Créer_un_thème" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_fichiers_de_propriétés">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/manipulation_de_listes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/manipulation_de_listes/index.html deleted file mode 100644 index 12a2c19574..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/manipulation_de_listes/index.html +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Manipulation de listes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Manipulation_de_listes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Manipulating_Lists ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Modification_d'une_interface_XUL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes">Suivant »</a></p> -</div> -<p>La boîte de liste XUL fournit un certain nombre de méthodes spécialisées.</p> -<h3 id="Manipulation_d.27une_liste" name="Manipulation_d.27une_liste">Manipulation d'une liste</h3> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> fournit de nombreuses méthodes pour rechercher et manipuler ses items. Bien que les boîtes de liste puissent être manipulées en utilisant les fonctions standard de <a href="/fr/DOM" title="fr/DOM">DOM</a>, il est recommandé d'employer les fonctions spécialisées de <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> autant que possible. Ces fonctions sont plus simples et feront correctement leur travail.</p> -<p>La fonction <code>appendItem()</code> est utilisée pour ajouter un nouvel item à la fin d'une liste. Elle est similaire à la fonction <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code> du DOM sauf qu'elle prend un libellé texte, et que vous n'avez pas à vous soucier où placer votre item dans la structure de la liste. Voici un exemple :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_1.xul">Voir</a></p> -<pre><script> -function addItem(){ - document.getElementById('laliste').appendItem("Jeudi", "jeu"); -} -</script> - -<listbox id="laliste"/> - -<button label="Ajouter" oncommand="addItem();"/> -</pre> -<p>La fonction <code>appendItem()</code> prend deux arguments, le libellé, dans l'exemple 'Jeudi', et une valeur 'jeu'. Les deux arguments correspondent aux attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/listitem" title="listitem">listitem</a></code>. L'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> est optionnel et sert à affecter à un item une valeur que vous pouvez réutiliser ensuite dans un script.</p> -<p>De même, il existe les fonctions <code>insertItemAt()</code> et <code>removeItemAt()</code>, qui ajoutent respectivement un nouvel item et suppriment un item existant. La syntaxe est la suivante :</p> -<pre>list.insertItemAt(3, "Jeudi", "jeu"); -list.removeItemAt(3); -</pre> -<p>La fonction <code>insertItemAt()</code> prend un argument supplémentaire, la position pour insérer le nouvel item. Le nouvel item est inséré à cet index. Ainsi, dans l'exemple, le nouvel item sera ajouté à la position 3 et l'item qui avait cette position aura maintenant l'index 4. Rappelez-vous que le premier item est 0. La fonction <code>removeItemAt()</code> supprimera l'item à un index spécifique.</p> -<p>Ces trois méthodes sont également disponibles pour plusieurs autres éléments XUL et fonctionnent de la même manière. En fait, ces méthodes font parties de l'interface <code><a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIDOMXULSelectControlElement.html">nsIDOMXULSelectControlElement</a></code> donc tous les éléments XUL qui implémentent cette interface héritent de ces méthodes. Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> en font partie. Par exemple, pour ajouter un nouvel item à un <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, vous pouvez employer la même syntaxe qu'une <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>. Le bon type d'élément sera ajouté dans chaque cas.</p> -<h3 id="S.C3.A9lection_de_liste" name="S.C3.A9lection_de_liste">Sélection de liste</h3> -<p>L'interface <code>nsIDOMXULSelectControlElement</code> fournit deux propriétés supplémentaires, <code>selectedIndex</code> et <code>selectedItem</code>. La première renvoie l'index de l'item sélectionné tandis que la seconde renvoie l'élément sélectionné. Par exemple, la valeur de retour de <code>selectedItem</code> sera le <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> sélectionné. Si aucun item n'est sélectionné, <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code> retournera '-1', et <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedItem">selectedItem</a></span></code></code> renverra 'null'.</p> -<h4 id="R.C3.A9cup.C3.A9rer_l.27item_s.C3.A9lectionn.C3.A9" name="R.C3.A9cup.C3.A9rer_l.27item_s.C3.A9lectionn.C3.A9">Récupérer l'item sélectionné</h4> -<p>Ces deux propriétés sont généralement inspectées durant un événement de sélection, comme dans l'exemple suivant :</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_2.xul">Voir</a></p> -<pre><listbox id="thelist" onselect="alert(this.selectedItem.label);"> - <listitem label="Petit"/> - <listitem label="Moyen"/> - <listitem label="Grand"/> -</listbox> -</pre> -<p>L'événement de sélection est exécuté par une <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> quand un item de la liste est sélectionné. Le gestionnaire affiche ici une alerte contenant le libellé de l'item sélectionné dans la liste. Puisque l'événement de sélection s'est exécuté, nous pouvons supposer qu'un item est sélectionné. Dans d'autres cas, vous devrez vous assurer que <code>selectedItem</code> n'est pas 'null' avant de poursuivre.</p> -<p>L'événement de sélection est également exécuté quand un bouton radio dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> est sélectionné et quand un onglet est sélectionné dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code>. Cependant, les <code><a href="/fr/docs/Mozilla/Tech/XUL/menulists" title="menulists">menulists</a></code> ne génèrent pas d'événement de sélection ; vous pouvez écouter l'événement "command" à la place pour traiter la sélection d'un item.</p> -<p>Pour l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code>, il est souvent plus commode d'employer les fonctions de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Il a aussi une fonction <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code> qui renverra l'index de l'onglet sélectionné. Cependant, pour récupérer l'item sélectionné, utilisez plutôt la fonction <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedTab">selectedTab</a></span></code></code> de <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Ou alors, utilisez la fonction <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedPanel">selectedPanel</a></span></code></code> pour récupérer la page d'onglet sélectionnée, ce qui renvoie le contenu associé à l'onglet.</p> -<h4 id="Modifier_la_s.C3.A9lection" name="Modifier_la_s.C3.A9lection">Modifier la sélection</h4> -<p>Toutes les propriétés de sélection décrites ci-dessus peuvent également se voir assigner une nouvelle valeur pour modifier la sélection. Dans l'exemple suivant, la propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> est modifiée avec la valeur entrée dans un champ de saisie. Ce code n'est cependant pas performant ; par exemple, il ne vérifie pas si la valeur entrée est hors limite. Il est conseillé d'ajouter ce genre de vérification d'erreur.</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_3.xul">Voir</a></p> -<pre><script> -function doSelect(){ - var val = document.getElementById('number').value; - val = Number(val); - if (val != null) - document.getElementById('level').selectedIndex = val - 1; -} -</script> - -<hbox align="center"> - <label value="Entrez un nombre compris entre 1 et 3 :"/> - <textbox id="number"/> - <button label="Sélectionnez" oncommand="doSelect();"/> -</hbox> - -<radiogroup id="level"> - <radio label="Excellent"/> - <radio label="Bon"/> - <radio label="Mauvais"/> -</radiogroup> -</pre> -<p>Les boîtes de liste supportent aussi les sélections multiples et les fonctions de l'interface <code><a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIDOMXULMultiSelectControlElement.html">nsIDOMXULMultiSelectControlElement</a></code>. Cette interface fournit un certain nombre de fonctions dédiées pour contrôler la sélection multiple. Par exemple, la propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedItems">selectedItems</a></span></code></code> contient une liste des items qui sont sélectionnés, alors que la propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedCount">selectedCount</a></span></code></code> contient le nombre d'items sélectionnés. En général, vous utiliserez ces propriétés pour parcourir la liste et y effectuer quelques opérations sur chaque item. Faites attention lorsque vous parcourez les items sélectionnés de la liste ; si vous modifiez les items dans la liste pendant que vous les parcourez, la liste sera modifiée et les propriétés de sélection pourraient retourner des valeurs différentes. C'est une raison pour laquelle il est utile de manipuler la liste par item plutôt que par l'index.</p> -<h4 id="Effacer_des_items_s.C3.A9lectionn.C3.A9s" name="Effacer_des_items_s.C3.A9lectionn.C3.A9s">Effacer des items sélectionnés</h4> -<p>L'exemple suivant montre une méthode correcte de suppression des items sélectionnés :</p> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_4.xul">Voir</a></p> -<pre><script> -function deleteSelection(){ - var list = document.getElementById('thelist'); - var count = list.selectedCount; - while (count--){ - var item = list.selectedItems[0]; - list.removeItemAt(list.getIndexOfItem(item)); - } -} -</script> - -<button label="Supprimer" oncommand="deleteSelection();"/> - -<listbox id="thelist" seltype="multiple"> - <listitem label="Cheddar"/> - <listitem label="Cheshire"/> - <listitem label="Edam"/> - <listitem label="Gouda"/> - <listitem label="Havartie"/> -</listbox> -</pre> -<p>À l'intérieur de la boucle <code>while</code>,</p> -<ul> <li>Nous récupérons d'abord l'item sélectionné à l'index 0. Le premier item sélectionné est toujours recherché car la taille du tableau diminuera au fur et à mesure que les items seront supprimés.</li> <li>Ensuite, nous supprimons l'item en utilisant la fonction <code>removeItemAt</code>. Comme cette fonction nécessite un index,</li> <li>Nous pouvons faire correspondre un item et son index en utilisant la fonction <code>getIndexOfItem()</code>. La fonction inverse correspondante est <code>getItemAtIndex()</code></li> -</ul> -<p>L'interface <code><a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIDOMXULMultiSelectControlElement.html">nsIDOMXULMultiSelectControlElement</a></code> fournit également des méthodes pour modifier les items sélectionnés. Par exemple, la fonction <code>addItemToSelection()</code> ajoute un nouvel item à la liste des items sélectionnés, sans vider la sélection existante. La fonction <code>removeItemFromSelection()</code> supprime un seul item dans la sélection.</p> -<h3 id="D.C3.A9filement_de_liste" name="D.C3.A9filement_de_liste">Défilement de liste</h3> -<p>Si la boîte de liste contient plus de lignes qu'elle ne peut en afficher, une barre de défilement apparaîtra pour permettre à l'utilisateur de faire défiler la liste. La position du défilement peut être ajustée en utilisant quelques méthodes de <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code>.</p> -<p>La méthode <code>scrollToIndex()</code> fait défiler jusqu'à une ligne donnée. Cette boîte de liste défilera jusqu'à ce que la ligne soit la première ligne visible, à moins que la ligne ne soit proche de la fin de la liste des items. La méthode <code>ensureIndexIsVisible()</code> est similaire puisqu'elle fait défiler la liste pour afficher une ligne, mais cette méthode ne défilera pas si l'item est déjà visible. Ainsi, la première fonction est utilisée pour faire défiler jusqu'à une ligne précise alors que la deuxième est utilisée pour s'assurer que la ligne soit visible. Il y a également <code>ensureItemIsVisible()</code> qui nécessite un item en argument au lieu d'un index. Comparez l'effet de ces deux fonctions à des positions de défilement différentes dans cet exemple :</p> -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_domlists_5.xul">Voir</a></p> -<pre><button label="scrollToIndex" - oncommand="document.getElementById('thelist').scrollToIndex(4);"/> -<button label="ensureIndexIsVisible" - oncommand="document.getElementById('thelist').ensureIndexIsVisible(4);"/> - -<listbox id="thelist" rows="5"> - <listitem label="1"/> - <listitem label="2"/> - <listitem label="3"/> - <listitem label="4"/> - <listitem label="5"/> - <listitem label="6"/> - <listitem label="7"/> - <listitem label="8"/> - <listitem label="9"/> - <listitem label="10"/> - <listitem label="11"/> - <listitem label="12"/> -</listbox> -</pre> -<hr> -<p>Nous verrons ensuite les objets boîtes XUL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Modification_d'une_interface_XUL" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Les_objets_boîtes">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/menus_défilants/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/menus_défilants/index.html deleted file mode 100644 index 7772a15f15..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/menus_défilants/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Menus défilants -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Menus_défilants -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Scrolling_Menus ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Menus_surgissants" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaires_d'évènements">Suivant »</a></p> -</div> -<p>Cette section va décrire les menus défilants et comment utiliser le mécanisme avec d'autres éléments.</p> -<h3 id="Cr.C3.A9er_un_grand_menu" name="Cr.C3.A9er_un_grand_menu">Créer un grand menu</h3> -<p>Vous vous demandez peut-être ce qu'il se passerait si vous créez un menu avec beaucoup de commandes, de telle manière que tous les items ne peuvent pas s'afficher tous à l'écran en même temps. Mozilla fournit un mécanisme de défilement permettant de faire défiler les items.</p> -<div class="float-right"><img alt="Image:xultu_menuscroll1.png" class=" internal" src="/@api/deki/files/1534/=Xultu_menuscroll1.png"></div> -<p>Si l'espace disponible est trop petit, des flèches vont apparaître sur chaque extrémité du menu. Si vous bougez la souris sur les flèches, le menu va défiler vers le haut et vers le bas. Si l'espace disponible est assez grand, les flèches n'apparaîtront pas. Notez que le comportement exact du défilement dépendra du thème graphique utilisé.</p> -<p>Ce comportement est automatique. Vous n'avez pas à faire quoi que se soit pour avoir des menus défilants. Il va s'appliquer aux menus des barres de menu, aux menus surgissants ou listes déroulantes. Il est implémenté en utilisant un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/arrowscrollbox" title="arrowscrollbox">arrowscrollbox</a></code>. Cet élément peut être utilisé pour créer une boîte de défilement avec des flèches.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/arrowscrollbox" title="arrowscrollbox">arrowscrollbox</a></code> peut être utilisé n'importe où une boîte normale peut être utilisée. Vous n'êtes pas obligé de l'utiliser pour des menus. Il s'agit toujours une boîte verticale pouvant contenir n'importe quel élément à l'intérieur. Vous pouvez l'utiliser pour implémenter une liste que vous ne voulez pas déroulante.</p> -<h4 id="Exemple_-_liste_d.C3.A9filante_de_boutons" name="Exemple_-_liste_d.C3.A9filante_de_boutons">Exemple - liste défilante de boutons</h4> -<p>L'exemple suivant montre comment créer une liste défilante de boutons (vous devrez redimensionner la fenêtre pour voir les boutons de flèches) :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_menuscroll_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_menuscroll_1.xul">Voir</a></p> -<pre><arrowscrollbox orient="vertical" flex="1"> - <button label="Rouge"/> - <button label="Bleu"/> - <button label="Vert"/> - <button label="Jaune"/> - <button label="Orange"/> - <button label="Argent"/> - <button label="Lavande"/> - <button label="Or"/> - <button label="Turquoise"/> - <button label="Pêche"/> - <button label="Bordeaux"/> - <button label="Noir"/> -</arrowscrollbox> -</pre> -<p>Si vous essayez cet exemple, il va d'abord s'ouvrir en pleine taille. Cependant, si vous réduisez la taille de la fenêtre, les flèches de défilement vont apparaître. Rendre la fenêtre plus grande à nouveau va faire disparaître les flèches.</p> -<p>Vous pouvez mettre une propriété CSS <code>max-height</code> sur les <code><a href="/fr/docs/Mozilla/Tech/XUL/arrowscrollbox" title="arrowscrollbox">arrowscrollbox</a></code> pour limiter la taille de la boîte de défilement et ainsi faire apparaître les flèches tout le temps.</p> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/arrowscrollbox" title="arrowscrollbox">arrowscrollbox</a></code> est principalement utile dans les menus et boîtes surgissantes.</p> -<hr> -<p>Par la suite, nous allons voir comment ajouter des gestionnaires d'événements à des éléments XUL.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Menus_surgissants" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaires_d'évènements">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/menus_surgissants/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/menus_surgissants/index.html deleted file mode 100644 index e5e70a93c6..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/menus_surgissants/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Menus surgissants -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Menus_surgissants -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Popup_Menus ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_de_fonctionnalités_de_menu" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Menus_défilants">Suivant »</a></p> -</div> - -<p>Dans la section précédente, nous avons vu comment créer un menu sur une barre de menu. XUL a aussi la capacité de créer des menus surgissants. Les menus surgissants sont habituellement affichés lorsque l'utilisateur presse le bouton droit de la souris.</p> - -<h3 id="Cr.C3.A9er_un_menu_surgissant" name="Cr.C3.A9er_un_menu_surgissant">Créer un menu surgissant</h3> - -<p>XUL a trois différentes types de boîtes surgissantes, décrites ci-dessous. La différence majeure est leurs façons d'apparaître.</p> - -<dl> - <dt>Boîte surgissante simple </dt> - <dd>La boîte surgissante simple est une fenêtre surgissante qui apparaît quand l'utilisateur presse le bouton gauche de la souris sur un élément. Elles sont assez semblables aux menus sur les barres de menu, excepté qu'elles peuvent être placées n'importe où et peuvent contenir n'importe quel contenu. Un bon exemple est le menu déroulant qui apparaît quand vous maintenez le bouton de la souris enfoncé sur les boutons "précédent" et "suivant" dans la fenêtre d'un navigateur.</dd> -</dl> - -<dl> - <dt>Boîte contextuelle </dt> - <dd>La boîte contextuelle est une fenêtre surgissante qui apparaît quand l'utilisateur presse le bouton de menu contextuel, qui est habituellement le bouton droit de la souris. Sur certaines plates-formes, Il peut s'agir d'un bouton différent - mais c'est toujours le bouton ou une combinaison de touches et de bouton de souris qui invoque un menu spécifique au contexte. Sur le Macintosh par exemple, l'utilisateur doit soit presser la touche Control et le bouton de la souris, soit maintenir le bouton de la souris enfoncé un certain temps.</dd> -</dl> - -<dl> - <dt>Bulle d'aide </dt> - <dd>Une fenêtre surgissante « bulle d'aide » va apparaître quand l'utilisateur survolera un élément avec la souris. Ce type de boîte surgissante est habituellement utilisé pour fournir la description d'un bouton de façon plus détaillée que le bouton le permet lui-même.</dd> -</dl> - -<p>Ces trois types de boîtes surgissantes diffèrent dans la façon dont l'utilisateur les invoque. <span class="comment">Elles peuvent contenir n'importe quel contenu, bien que des menus soient courants pour les boîtes simples et contextuelles, et qu'une simple chaîne de caractères soit courante pour une bulle d'aide.</span> Le type de boîte surgissante est déterminé par l'élément qui invoque la boîte.</p> - -<h4 id="D.C3.A9claration_d.27un_menu_surgissant" name="D.C3.A9claration_d.27un_menu_surgissant">Déclaration d'un menu surgissant</h4> - -<p>Une boîte sugissante est décrite en utilisant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. C'est un type de boîte sans attributs spéciaux. Quand elle est invoquée, une fenêtre contenant tout ce que vous avez pu mettre dans le <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> va s'afficher. Cependant, vous devez toujours insérer un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code> car il doit être associé à un élément. Nous verrons bientôt sa signification. D'abord, un exemple :</p> - -<pre><popupset> - <menupopup id="clipmenu"> - <menuitem label="Couper"/> - <menuitem label="Copier"/> - <menuitem label="Coller"/> - </menupopup> -</popupset> -</pre> - -<p>Comme vous pouvez le voir ici, un simple menu surgissant contenant trois commandes a été créé. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> entoure les trois items de menu. Vous remarquerez également que l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> a été mis sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> lui-même.</p> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/popupset" title="popupset">popupset</a></code> entoure l'entière déclaration de menu surgissant. Il s'agit d'un container générique pour les boîtes surgissantes, et il est optionnel. Il ne s'affiche pas à l'écran mais il est utilisé comme une section dans laquelle vous pouvez déclarer tous vos menus surgissants. Comme le nom <code><a href="/fr/docs/Mozilla/Tech/XUL/popupset" title="popupset">popupset</a></code> sous-entend, vous pouvez placer plusieurs déclarations de menus surgissants à l'intérieur. Ajoutez en simplement d'autres après le premier élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Vous pouvez avoir plus d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/popupset" title="popupset">popupset</a></code> dans un fichier, mais habituellement vous n'en aurez qu'un.</p> - -<h4 id="Association_d.27un_menu_surgissant_.C3.A0_un_.C3.A9l.C3.A9ment" name="Association_d.27un_menu_surgissant_.C3.A0_un_.C3.A9l.C3.A9ment">Association d'un menu surgissant à un élément</h4> - -<p>Maintenant que nous avons créé le menu surgissant, il est temps de le faire apparaître. Pour cela, nous avons besoin d'associer le menu à un élément d'où il devra apparaître. Nous faisons cela car nous voulons seulement que le menu apparaisse quand l'utilisateur clique à un certain endroit de la fenêtre. Habituellement, il s'agira d'un bouton spécifique ou d'une boîte.</p> - -<p>Pour associer le menu surgissant à un élément, ajoutez un de ces trois attributs à l'élément. L'attribut que vous ajoutez dépend du type de menu surgissant vous voulez créer. Pour les menus surgissants simples, ajoutez l'attribut <code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code> à l'élément. Pour les menus contextuels, ajoutez l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>. Enfin, pour les bulles d'aide, ajoutez l'attribut <code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>.</p> - -<p>La valeur de l'attribut doit être celle de l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> que vous voulez faire apparaître. C'est pour cela que vous devez mettre un <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Par ce moyen, il est facile d'avoir plusieurs menus surgissants dans un seul fichier.</p> - -<p>Dans l'exemple ci-dessus, nous voulons faire un menu surgissant contextuel. Nous devons donc utiliser l'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code> et l'ajouter à l'élément sur lequel nous voulons associer le menu surgissant. L'exemple ci-dessous montre comment procéder :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_1.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_popups1.png" class="internal" src="/@api/deki/files/1538/=Xultu_popups1.png"></div> - -<pre><popupset> - <menupopup id="clipmenu"> - <menuitem label="Couper"/> - <menuitem label="Copier"/> - <menuitem label="Coller"/> - </menupopup> -</popupset> - -<box context="clipmenu"> - <label value="Faites un clic contextuel pour afficher le menu"/> -</box> -</pre> - -<p>Ici, le menu contextuel a été associé à une boîte. À chaque fois que vous faîtes un clic contextuel (clic droit) n'importe où dans la boîte, le menu surgissant apparaîtra. Le menu apparaîtra aussi même si vous cliquez sur un enfant de la boîte, donc il apparaîtra aussi si vous cliquez sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/label" title="label">label</a></code>. L'attribut <code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code> a été utilisé pour associer la boîte au menu contextuel de même <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>. Dans ce cas, le menu 'clipmenu' va apparaître. De cette façon, vous pouvez disposer de plusieurs menus surgissants et les associer avec différents éléments.</p> - -<p>Vous pouvez associer plusieurs menus surgissants avec le même élément en mettant plusieurs d'attributs de différents types sur un élément. Vous pouvez aussi associer le même menu surgissant à plusieurs éléments, ce qui est un avantage de l'utilisation de la syntaxe popup. Les menus surgissants ne peuvent être associés qu'avec des éléments XUL. Ils ne peuvent pas être associés à des éléments HTML.</p> - -<h3 id="Bulles_d.27aide" name="Bulles_d.27aide">Bulles d'aide</h3> - -<p>Nous allons voir un moyen simple de créer des bulles d'aide. Il y a deux façons de créer des bulles d'aide. La méthode la plus simple, qui est la plus commune, est d'ajouter un attribut <code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code> à un élément sur lequel vous voulez assigner une bulle d'aide.</p> - -<p>La deuxième méthode consiste à utiliser un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code> contenant le contenu d'une bulle d'aide. Il nécessite que vous ayez un bloc séparé de contenu pour chaque bulle d'aide ou que vous ayez un script contenant le contenu, bien que certains contenus hormis du texte dans une bulle d'aide ne sont pas permis.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_2.xul">Voir</a></p> - -<pre><button label="Sauvegarder" tooltiptext="Cliquez ici pour enregistrer vos trucs"/> - -<popupset> - <tooltip id="moretip" orient="vertical" style="background-color: #33DD00;"> - <description value="Cliquez ici pour voir plus d'information"/> - <description value="Vraiment!" style="color: red;"/> - </tooltip> -</popupset> - -<button label="Plus" tooltip="moretip"/> -</pre> - -<p>Ces deux boutons ont chacun une bulle d'aide. Le premier utilise le style par défaut de bulle d'aide. Le second utilise une bulle d'aide modifiée qui a une couleur d'arrière-plan différente et un texte stylisé. La bulle d'aide est associée au bouton 'Plus' en utilisant l'attribut <code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, correspondant à l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code>. Notez que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tooltip" title="tooltip">tooltip</a></code> est également placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/popset" title="popset">popset</a></code> comme pour les autres types de menus surgissants.</p> - -<h3 id="Alignement_des_menus_surgissants" name="Alignement_des_menus_surgissants">Alignement des menus surgissants</h3> - -<p>Par défaut, les menus surgissants et contextuels vont apparaître là où le pointeur de la souris se trouve. Les bulles d'aides seront placées légèrement sous l'élément pour que le pointeur de la souris ne les cache pas. Il y a des cas toutefois, où vous voudrez préciser l'emplacement du menu surgissant. Par exemple, le menu surgissant qui apparaît quand vous cliquez sur le bouton Précédent dans un navigateur doit apparaître sous le bouton Précédent, non pas là ou se situe le pointeur de la souris.</p> - -<p>Pour changer la position du menu, vous pouvez utiliser un attribut additionnel, <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code>. Vous pouvez aussi l'ajouter à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Cet attribut est utilisé pour indiquer l'emplacement du menu relativement à l'élément invoquant la boîte. Ses différentes valeurs applicables sont décrites brièvement ci-dessous :</p> - -<dl> - <dt>'after_start' </dt> - <dd>Le menu surgissant apparaît sous l'élément avec les bords gauche de l'élément et du menu alignés. Si le menu surgissant est plus large que l'élément, il s'étend à droite. C'est cette valeur qui est utilisée pour les menus déroulants associés avec les boutons Précédent et Suivant du navigateur.</dd> -</dl> - -<dl> - <dt>'after_end' </dt> - <dd>Le menu surgissant apparaît sous l'élément avec les bords droit de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'before_start' </dt> - <dd>Le menu surgissant apparaît au-dessus de l'élément avec les bords gauche de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'before_end' </dt> - <dd>Le menu surgissant apparaît au-dessus de l'élément avec les bords droit de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'end_after' </dt> - <dd>Le menu surgissant apparaît à droite de l'élément avec les bords inférieurs de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'end_before' </dt> - <dd>Le menu surgissant apparaît à droite de l'élément avec les bords supérieurs de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'start_after' </dt> - <dd>Le menu surgissant apparaît à gauche de l'élément avec les bords inférieurs de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'start_before' </dt> - <dd>Le menu surgissant apparaît à gauche de l'élément avec les bords supérieurs de l'élément et du menu alignés.</dd> -</dl> - -<dl> - <dt>'overlap' </dt> - <dd>Le menu surgissant apparaît par dessus l'élément.</dd> -</dl> - -<dl> - <dt>'at_pointer' </dt> - <dd>Le menu surgissant apparaît à la position du pointeur de la souris.</dd> -</dl> - -<dl> - <dt>'after_pointer' </dt> - <dd>Le menu surgissant apparaît à la même position horizontale que le pointeur de la souris mais apparaît sous l'élément. C'est ainsi que les bulles d'aide apparaissent.</dd> -</dl> - -<p>En ajoutant l'attribut <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code> à un élément popup, vous pouvez spécifier précisément où le menu surgissant doit apparaître. Vous ne pouvez pas spécifier une position exacte en pixels. L'attribut <code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code> peut être utilisé pour les trois types de menus surgissants, bien que vous ne changerez probablement pas la valeur pour les bulles d'aide.</p> - -<p>L'exemple ci-dessous montre la création d'un bouton Précédent avec un menu surgissant :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_popups_3.xul">Voir</a></p> - -<pre><popupset> - <menupopup id="backpopup" position="after_start"> - <menuitem label="Page 1"/> - <menuitem label="Page 2"/> - </menupopup> -</popupset> - -<button label="Affiche moi" popup="backpopup"/> -</pre> - -<div class="highlight"> -<h3 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h3> - -<p>Ajoutons un simple menu surgissant à la boîte de dialogue de recherche de fichiers. Pour plus de simplicité, nous allons juste recopier le contenu du menu 'Edition'. Le menu apparaîtra quand l'on clique sur le premier onglet :</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-popups.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-popups.xul">Voir</a></p> - -<pre class="eval"><span class="highlightred"><popupset> <menupopup id="editpopup"> <menuitem label="Couper" accesskey="c"/> <menuitem label="Copier" accesskey="p"/> <menuitem label="Coller" accesskey="l" disabled="true"/> </menupopup> </popupset></span> - -<vbox flex="1"> -. -. -. - -<span class="highlightred"><tabpanel id="searchpanel" orient="vertical" context="editpopup"></span> -</pre> -Ici un simple menu surgissant, similaire au menu Edition, a été ajouté au premier onglet. Si vous faîtes un clic droit (Control-clic sur Macintosh) n'importe où sur la page de ce premier onglet, le menu surgissant va apparaître. Cependant, le menu n'apparaîtra pas si vous cliquez autre part. - -<div class="note">Notez que le champs de saisie a son propre menu surgissant qui supplantera celui que nous avons spécifié.</div> -</div> - -<hr> -<p>Par la suite, nous allons voir comment créer des menus défilants.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_de_fonctionnalités_de_menu" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Menus_défilants">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/mise_à_jour_de_commandes/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/mise_à_jour_de_commandes/index.html deleted file mode 100644 index ca785b61a8..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/mise_à_jour_de_commandes/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Mise à jour de commandes -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Mise_à_jour_de_commandes -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Updating_Commands ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Commandes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Broadcasters_et_Observateurs">Suivant »</a></p> -</div> - -<p>Dans cette section, nous verrons comment mettre à jour des commandes.</p> - -<h3 id="Appel_des_commandes" name="Appel_des_commandes">Appel des commandes</h3> - -<p>Si une commande a un attribut <code id="a-oncommand"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommand">oncommand</a></code>, vous pouvez simplement l'appeler en utilisant la méthode <code><span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand</a></code></span></code> de la commande ou un élément qui lui est attaché. Pour d'autres commandes, vous aurez besoin de quelques lignes de codes supplémentaires. Vous devrez passer par ces étapes spéciales dans le cas où les commandes appelées sont implémentées par un contrôleur. Vous aurez aussi besoin de le faire dans le cas où vous créez votre propre menu de commandes, par exemple pour implémenter les commandes du menu d'édition de votre propre application.</p> - -<p>Heureusement, le code spécial est assez simple. Tout ce que nous avons besoin de faire est d'obtenir le contrôleur demandé et d'appeler la commande. Une manière simple de le faire est la suivante :</p> - -<pre>var controller = document.commandDispatcher.getControllerForCommand("cmd_paste"); -if (controller && controller.isCommandEnabled("cmd_paste")){ - controller.doCommand(command); -} -</pre> - -<p>Le code ci-dessus recherche d'abord le contrôleur pour la commande '<code>cmd_paste</code>' grâce au répartiteur de commandes. Puis, il teste si la commande est activée, et enfin exécute la commande utilisant la méthode <code>doCommand</code> du contrôleur. Notez que nous n'avons pas besoin de préciser l'élément ou le contrôleur à utiliser. Le répartiteur de commandes s'en charge. En outre, nous pourrions juste appeler <code>doCommand</code> sans vérifier si la commande est activée ou non, mais il vaut mieux le faire.</p> - -<p>Le code ci-dessus est tellement générique qu'il pourrait être une fonction prenant une commande en argument et exécutant cette commande. Cette fonction pourrait être ainsi réutilisée pour toutes les commandes. En fait, c'est tellement commun que Mozilla inclut une bibliothèque qui ne fait que ça. Si vous incluez le script '<code><a class="external" rel="freelink">chrome://global/content/globalOverlay.js</a></code>' dans un fichier XUL, vous pouvez appeler la méthode <span id="m-goDoCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/goDoCommand">goDoCommand</a></code></span> qui exécute la commande passée en argument. Le code pour cette fonction ne fait que quelques lignes, ainsi vous pourriez l'inclure directement dans votre code si pour certaines raisons vous ne souhaitez pas inclure la bibliothèque.</p> - -<pre><script src="chrome://global/content/globalOverlay.js"/> - -<command id="cmd_paste" oncommand="goDoCommand('cmd_paste');/> -<button label="Coller" command="cmd_paste"/> -</pre> - -<p>L'exemple ci-dessus va implémenter un bouton pour « Coller ». Il est relié à la commande qui va appeler la commande du contrôleur concerné lorsqu'il est appelé. Le code ci-dessus est tout ce dont vous avez besoin pour implémenter la fonctionnalité de la commande Coller dans votre application. La seule autre chose dont vous avez besoin est de vous assurer que le statut de la commande Coller qui est activé, et donc du bouton, est mis à jour au bon moment, comme décrit ci-dessous.</p> - -<h3 id="Dispositifs_de_mise_.C3.A0_jour_de_commande" name="Dispositifs_de_mise_.C3.A0_jour_de_commande">Dispositifs de mise à jour de commande</h3> - -<p>Un dispositif de mise à jour de commande est un dispositif spécial de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/commandset" title="commandset">commandset</a></code> qui lui permet de mettre à jour les statuts activés d'une ou plusieurs commandes lorsque certains événements se produisent. Vous devrez y pensez lorsqu'une commande est valide et lorsqu'elle ne l'est pas. De plus, vous devrez considérer quand l'état pourrait changer et quand les commandes devraient être mises à jour.</p> - -<p>Par exemple, la commande « Coller » est valide lorsque le champ de saisie de texte a le focus et qu'il y a quelque chose dans le presse-papiers à coller. La commande deviendra active chaque fois que le champ de saisie aura le focus et lorsque le contenu du presse-papiers changera. Un dispositif de mise à jour de contenu surveillera ces situations et le code qui active et désactive les commandes pourra être exécuté selon les besoins.</p> - -<p>Un simple dispositif de mise à jour de commandes ressemble à ceci :</p> - -<pre><commandset id="updatePasteItem" - commandupdater="true" - events="focus" - oncommandupdate="goUpdateCommand('cmd_paste');"/> -</pre> - -<p>Un dispositif de mise à jour de commandes est indiqué en utilisant l'attribut <code id="a-commandupdater"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/commandupdater">commandupdater</a></code>, qui devrait être déclaré à 'true'. L'attribut <code id="a-events"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/events">events</a></code> est utilisé pour lister les événements que le dispositif de mise à jour de commandes surveille. Vous pouvez spécifier de multiples événements en les séparant par des virgules. Dans l'exemple ci-dessus, le dispositif de mise à jour de commandes surveille les événements de focus. Il a pour effet de mettre à jour les commandes lorsqu'un élément reçoit le focus.</p> - -<p>Lorsqu'un événement de focus se produit, le code dans l'attribut <code id="a-oncommandupdate"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/oncommandupdate">oncommandupdate</a></code> est appelé. Dans l'exemple, la méthode <code>goUpdateCommand</code>, qui est une fonction provenant du script globalOverlay.js décrit plus tôt, est appelée. Elle va mettre à jour la commande et activer ou désactiver les items de boutons et de menus nécessaires. Le code qui est derrière est assez simple. Il appelle seulement le contrôleur nécessaire, appelle sa méthode <code>isCommandEnabled</code>, et enfin active ou désactive la commande. Si vous avez plusieurs commandes à mettre à jour, appelez la méthode <code>goUpdateCommand</code> une fois pour chaque commande.</p> - -<div class="note">Notez que le dispositif de mise à jour de commandes recevra les notifications de tous les événements de focus sur tous les éléments, même si d'autres gestionnaires d'événements répondent à l'événement. Un dispositif de mise à jour de commandes est par essence un gestionnaire global d'événements.</div> - -<p>Les dispositifs de mise à jour de commandes disposent de plusieurs événements pouvant répondre à ceux qui sont listés ci-dessous. Il est également possible de créer le votre.</p> - -<ul> - <li><strong>focus</strong> : se produit lorsque l'élément qui a le focus change.</li> - <li><strong>select</strong> : se produit lorsque le texte sélectionné change.</li> - <li><strong>undo</strong> : se produit lorsque le tampon d'annulation change.</li> - <li><strong>clipboard</strong> : se produit lorsque le contenu du presse-papiers change.</li> -</ul> - -<p>L'exemple suivant montre le dispositif de mise à jour de commandes utilisé dans le navigateur Mozilla pour mettre à jour le menu d'édition de commandes. Les fonctions utilisées sont disponibles dans le script '<code><a class="external" rel="freelink">chrome://communicator/content/utilityOverlay.js</a></code>'.</p> - -<pre><commandset id="globalEditMenuItems" - commandupdater="true" - events="focus" - oncommandupdate="goUpdateGlobalEditMenuItems()"/> -<commandset id="selectEditMenuItems" - commandupdater="true" - events="select" - oncommandupdate="goUpdateSelectEditMenuItems()"/> -<commandset id="undoEditMenuItems" - commandupdater="true" - events="undo" - oncommandupdate="goUpdateUndoEditMenuItems()"/> -<commandset id="clipboardEditMenuItems" - commandupdater="true" - events="clipboard" - oncommandupdate="goUpdatePasteMenuItems()"/> -</pre> - -<hr> -<p>Ensuite, nous vous montrerons comment utiliser les observateurs.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Commandes" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Broadcasters_et_Observateurs">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/modification_d'une_interface_xul/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/modification_d'une_interface_xul/index.html deleted file mode 100644 index 249e58daa6..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/modification_d'une_interface_xul/index.html +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: Modification d'une interface XUL -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Modification_d'une_interface_XUL -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Modifying_a_XUL_Interface ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Document_Object_Model" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Manipulation_de_listes">Suivant »</a></p> -</div> - -<p>Le <abbr title="Document Object Model">DOM</abbr> fournit de nombreuses fonctions pour modifier un document.</p> - -<h3 id="Cr.C3.A9ation_de_nouveaux_.C3.A9l.C3.A9ments" name="Cr.C3.A9ation_de_nouveaux_.C3.A9l.C3.A9ments">Création de nouveaux éléments</h3> - -<p>Vous pouvez créer de nouveaux éléments en utilisant la fonction <code><a href="/fr/DOM/document.createElement" title="fr/DOM/document.createElement">createElement()</a></code> du document. Elle ne prend qu'un argument, le nom de la balise de l'élément à créer. Vous pouvez ensuite lui affecter des attributs en utilisant la fonction <code><a href="/fr/DOM/element.setAttribute" title="fr/DOM/element.setAttribute">setAttribute()</a></code> et ajouter cet élément au document XUL grâce à la fonction <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code>. L'exemple suivant ajoute un bouton à une fenêtre XUL :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_1.xul">Voir</a></p> - -<pre><script> -function addButton(){ - var aBox = document.getElementById("aBox"); - var button = document.createElement("button"); - button.setAttribute("label","Un bouton"); - aBox.appendChild(button); -} -</script> - -<box id="aBox" width="200"> - <button label="Ajouter" oncommand="addButton();"/> -</box> -</pre> - -<ul> - <li>Le script récupère d'abord avec <code><a href="/fr/DOM/document.getElementById" title="fr/DOM/document.getElementById">getElementById()</a></code> une référence à la boîte qui est le container dans lequel le nouveau bouton sera ajouté.</li> - <li>La fonction <code><a href="/fr/DOM/document.createElement" title="fr/DOM/document.createElement">createElement()</a></code> crée un nouveau bouton.</li> - <li>Nous assignons un libellé 'Un bouton' à ce bouton avec la fonction <code><a href="/fr/DOM/element.setAttribute" title="fr/DOM/element.setAttribute">setAttribute()</a></code>.</li> - <li>La fonction <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code> de la boîte est appelée pour lui ajouter le bouton.</li> -</ul> - -<p>La fonction <code><a href="/fr/DOM/document.createElement" title="fr/DOM/document.createElement">createElement()</a></code> va créer l'élément type par défaut du document. Pour des documents XUL, il sera généralement question de création d'éléments XUL. Pour un document HTML, un élément HTML sera créé, et donc, il aura les fonctionnalités et les fonctions d'un élément HTML. La fonction <code><a href="/fr/DOM/document.createElementNS" title="fr/DOM/document.createElementNS">createElementNS()</a></code> peut être utilisée pour créer des éléments dans un espace de nommage différent.</p> - -<p>La fonction <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code> est utilisée pour ajouter un élément en tant qu'enfant d'un autre élément. Il existe trois fonctions associées qui sont les fonctions <code><a href="/fr/DOM/element.insertBefore" title="fr/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="/fr/DOM/element.replaceChild" title="fr/DOM/element.replaceChild">replaceChild()</a></code> et <code><a href="/fr/DOM/element.removeChild" title="fr/DOM/element.removeChild">removeChild</a></code>. Leur syntaxe est la suivante :</p> - -<pre>parent.appendChild(child); -parent.insertBefore(child, referenceChild); -parent.replaceChild(newChild, oldChild); -parent.removeChild(child); -</pre> - -<p>Le nom de ces fonctions suffit à comprendre ce qu'elles font.</p> - -<ul> - <li>La fonction <code><a href="/fr/DOM/element.insertBefore" title="fr/DOM/element.insertBefore">insertBefore()</a></code> insère un nouveau n½ud enfant avant un autre existant. Elle est utilisée pour réaliser une insertion à l'intérieur d'une série d'enfants plutôt qu'à la fin comme le fait la fonction <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code>.</li> - <li>La fonction <code><a href="/fr/DOM/element.replaceChild" title="fr/DOM/element.replaceChild">replaceChild()</a></code> efface un enfant existant et en ajoute un nouveau à sa place, à la même position.</li> - <li>Pour finir, la fonction <code><a href="/fr/DOM/element.removeChild" title="fr/DOM/element.removeChild">removeChild()</a></code> supprime un nœud.</li> -</ul> - -<div class="note">Notez que pour toutes ces fonctions, l'enfant de référence ou l'enfant à supprimer doit exister sinon une erreur sera générée.</div> - -<p>Il est fréquent que vous vouliez effacer un élément existant et l'ajouter autre part. Dans ce cas, vous pouvez simplement ajouter l'élément sans l'effacer préalablement. Puisqu'un nœud ne peut exister qu'à un seul emplacement à la fois, le mécanisme d'insertion se chargera toujours d'effacer d'abord le nœud de son emplacement initial. C'est une méthode pratique pour déplacer un nœud dans un document.</p> - -<h4 id="Copie_de_n.C5.93uds" name="Copie_de_n.C5.93uds">Copie de nœuds</h4> - -<p>Toutefois, pour copier un nœud, vous devrez appeler la fonction <code><a href="/fr/DOM/element.cloneNode" title="fr/DOM/element.cloneNode">cloneNode()</a></code>. Cette fonction réalise une copie d'un nœud existant, ce qui vous permet ensuite de l'ajouter autre part. Le nœud original restera à sa place. Elle prend un argument booléen indiquant si elle doit copier tous les nœuds enfants ou non. Si la valeur est 'false', seul le n½ud est copié, comme s'il n'avait jamais eu aucun enfant. Si la valeur est 'true', tous les enfants sont également copiés. La copie est faite récursivement, donc pour de larges structures d'arbres, assurez-vous de vouloir réellement passer cette valeur 'true' à la fonction <code><a href="/fr/DOM/element.cloneNode" title="fr/DOM/element.cloneNode">cloneNode()</a></code>. Voici un exemple :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_2.xul">Voir</a></p> - -<pre><hbox height="400"> - <button label="Copier" - oncommand="this.parentNode.appendChild(this.nextSibling.cloneNode(true));"/> - - <vbox> - <button label="Premier"/> - <button label="Deuxième"/> - </vbox> -</hbox> -</pre> - -<p>Lorsque le bouton 'Copier' est appuyé :</p> - -<ul> - <li>nous récupérons l'élément voisin suivant de même niveau que le bouton, qui est dans ce cas l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code>.</li> - <li>une copie de cet élément est effectuée en utilisant la fonction <code><a href="/fr/DOM/element.cloneNode" title="fr/DOM/element.cloneNode">cloneNode()</a></code></li> - <li>et la copie est ajoutée à la fin grâce à <code><a href="/fr/DOM/element.appendChild" title="fr/DOM/element.appendChild">appendChild()</a></code>.</li> -</ul> - -<div class="note">Vous noterez que certains éléments, tels que <code><a href="/fr/docs/Mozilla/Tech/XUL/listbox" title="listbox">listbox</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code> disposent de fonctions de modification spécialisées supplémentaires que vous devriez utiliser dès que vous le pouvez. Elles seront décrites dans <a href="/fr/Tutoriel_XUL/Manipulation_de_listes" title="fr/Tutoriel_XUL/Manipulation_de_listes">une prochaine section</a>.</div> - -<h3 id="Manipulation_d.27.C3.A9l.C3.A9ments_basiques" name="Manipulation_d.27.C3.A9l.C3.A9ments_basiques">Manipulation d'éléments basiques</h3> - -<p>Les éléments principaux de XUL, tels que les boutons, les cases à cocher et les boutons radios, peuvent être manipulés grâce à de nombreuses propriétés de script. Les propriétés disponibles sont listées sur la page <a href="/fr/Référence_XUL" title="fr/Référence_XUL">référence des éléments</a> car celles disponibles varient selon les éléments. Les propriétés communes que vous pouvez manipuler sont <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/label">label</a></span></code></code>, <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/value">value</a></span></code></code>, <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/checked">checked</a></span></code></code> et <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/disabled">disabled</a></span></code></code>. Elles affectent ou effacent les attributs correspondants si nécessaire.</p> - -<h4 id="Exemples_de_propri.C3.A9t.C3.A9s_XULAttrlabel_et_XULAttrvalue" name="Exemples_de_propri.C3.A9t.C3.A9s_XULAttrlabel_et_XULAttrvalue">Exemples de propriétés <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code></h4> - -<p>Voici un exemple simple de changement d'un libellé de bouton :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_3.xul">Voir</a></p> - -<pre><button label="Bonjour" oncommand="this.label = 'Aurevoir';"/></pre> - -<p>Lorsque le bouton est pressé, son libellé est modifié. Cette technique fonctionne pour une large majorité d'éléments ayant des libellés (label). Pour les champs de saisie, vous pouvez faire quelque chose de similaire pour sa propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/value">value</a></span></code>.</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_4.xul">Voir</a></p> - -<pre><button label="Ajouter" oncommand="this.nextSibling.value += '1';"/> -<textbox/> -</pre> - -<p>Cet exemple ajoute un '1' dans le champ de saisie chaque fois que le bouton est pressé. La propriété <code><a href="/fr/DOM/element.nextSibling" title="fr/DOM/element.nextSibling">nextSibling</a></code> permet d'atteindre l'élément suivant le bouton (this), le champ de saisie <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>. L'opérateur <code>+=</code> sert à ajouter un '1' à la fin du texte de la valeur courante. Notez que vous pouvez encore ajouter du texte dans ce champ de saisie. Vous pouvez récupérer le libellé courant ou la valeur en utilisant ses propriétés, comme dans l'exemple suivant :</p> - -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_5.xul">Voir</a></p> - -<pre><button label="Bonjour" oncommand="alert(this.label);"/></pre> - -<h4 id="Changement_d.27.C3.A9tat_d.27une_case_.C3.A0_cocher" name="Changement_d.27.C3.A9tat_d.27une_case_.C3.A0_cocher">Changement d'état d'une case à cocher</h4> - -<p>Les cases à cocher disposent d'une propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/checked">checked</a></span></code> qui sert à les cocher ou à les décocher. Il est facile de comprendre son usage. Dans l'exemple à suivre, nous inversons l'état de la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/checked">checked</a></span></code> chaque fois que le bouton est pressé. Tandis que les libellés et les valeurs sont des chaînes de caractères, vous noterez que la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/checked">checked</a></span></code> est un booléen qui prend une valeur 'true' ou 'false'.</p> - -<p><span id="Exemple_6"><a id="Exemple_6"></a><strong>Exemple 6</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_6.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_6.xul">Voir</a></p> - -<pre><button label="Changer" oncommand="this.nextSibling.checked = - !this.nextSibling.checked;"/> -<checkbox label="Cochez pour les messages"/> -</pre> - -<p>Les boutons radios peuvent également être sélectionnés en utilisant des propriétés, toutefois, un seul est sélectionné à la fois dans un groupe, tous les autres étant décochés. Vous n'avez pas à réaliser cette gestion manuellement. La propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code> du <code><a href="/fr/docs/Mozilla/Tech/XUL/radiogroup" title="radiogroup">radiogroup</a></code> peut être utilisée pour cela. La propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code> sert à récupérer l'index du bouton radio sélectionné dans le groupe. Il sert également à le modifier.</p> - -<h4 id="Modification_de_l.27.C3.A9tat_activ.C3.A9_ou_d.C3.A9sactiv.C3.A9_d.27un_.C3.A9l.C3.A9ment" name="Modification_de_l.27.C3.A9tat_activ.C3.A9_ou_d.C3.A9sactiv.C3.A9_d.27un_.C3.A9l.C3.A9ment">Modification de l'état activé ou désactivé d'un élément</h4> - -<p>Il est habituel de désactiver des champs particuliers qui ne servent pas dans une situation donnée. Par exemple, dans la boîte de dialogue des préférences, vous avez le choix entre plusieurs possibilités, mais seul un choix permet un paramétrage supplémentaire. Voici un exemple de création de ce type d'interface :</p> - -<p><span id="Exemple_7"><a id="Exemple_7"></a><strong>Exemple 7</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_7.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_dommodify_7.xul">Voir</a></p> - -<pre><script> -function updateState(){ - var name = document.getElementById("name"); - var sindex = document.getElementById("group").selectedIndex; - name.disabled = sindex == 0; -} -</script> - -<radiogroup id="group" onselect="updateState();"> - <radio label="Nom aléatoire" selected="true"/> - <hbox> - <radio label="Spécifiez un nom :"/> - <textbox id="name" value="Alain" disabled="true"/> - </hbox> -</radiogroup> -</pre> - -<p>Dans cet exemple, une fonction <code>updateState()</code> est appelée chaque fois qu'un événement de sélection est déclenché depuis le groupe de boutons radios. Elle est exécutée lorsque qu'un bouton radio est sélectionné. La fonction retournera l'indice de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/radio" title="radio">radio</a></code> actuellement sélectionné en utilisant la propriété <code><code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/selectedIndex">selectedIndex</a></span></code></code>. Vous noterez que bien qu'un bouton radio se trouve à l'intérieur d'une boîte <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code>, il reste attaché au groupe radio. Si le premier bouton radio est sélectionné (index de '0'), le champ de saisie est désactivé en définissant sa propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/disabled">disabled</a></span></code> à 'true'. Si le second bouton radio est sélectionné, le champ de saisie est activé.</p> - -<hr> -<p>La section suivante fournira plus de détails sur la manipulation des groupes de boutons radios et la manipulation des listes.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Document_Object_Model" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Manipulation_de_listes">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> - -<p> </p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/modification_du_thème_par_défaut/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/modification_du_thème_par_défaut/index.html deleted file mode 100644 index 6e0899b330..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/modification_du_thème_par_défaut/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Modification du thème par défaut -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Modification_du_thème_par_défaut -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Modifying_the_Default_Skin ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Styler_un_arbre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Créer_un_thème">Suivant »</a></p> -</div> -<p>Cette section décrit comment modifier le thème graphique d'une fenêtre.</p> -<h3 id="Les_bases_d.27un_th.C3.A8me" name="Les_bases_d.27un_th.C3.A8me">Les bases d'un thème</h3> -<p><a href="/fr/Créer_un_thème_pour_Firefox//Premiers_pas" title="fr/Créer_un_thème_pour_Firefox//Premiers_pas">Un thème</a> est un ensemble de feuilles de styles, d'images et de comportements qui est appliqué à un fichier XUL. En appliquant un thème différent, vous pouvez changer l'apparence d'une fenêtre sans changer ses fonctionnalités. Firefox fournit un thème par défaut, et vous pouvez en télécharger d'autres. Le XUL pour les deux est le même. En revanche, les feuilles de styles et les images utilisées sont différentes.</p> -<p>Pour une simple personnalisation de l'apparence d'une fenêtre Mozilla, vous pouvez facilement changer les feuilles de styles qui lui sont associées. Des modifications plus importants peuvent être faits en créant un thème complètement nouveau. La fenêtre des préférences de Mozilla comporte un panneau pour changer le thème par défaut. (Bien que Mozilla appelle le code sous jacent les appelle 'skins' et que l'inteface utilisateur les appelle des thèmes, il s'agit de la même chose).</p> -<p>Un thème est décrit en utilisant des <a href="/fr/CSS" title="fr/CSS">CSS</a>, ce qui vous permet de définir <a href="/fr/CSS/Premiers_pas/Couleurs" title="fr/CSS/Premiers_pas/Couleurs">les couleurs</a>, <a href="/fr/CSS/Premiers_pas/Boîtes" title="fr/CSS/Premiers_pas/Boîtes">les bordures</a> et les images utilisées pour dessiner des éléments. Le fichier 'classic.jar' contient les définitions des thèmes. Le répertoire "global" inclus dans ces archives contient les définitions principales des styles concernant la manière d'afficher les différents éléments XUL. En modifiant ces fichiers, vous pouvez modifier l'apparence des applications XUL.</p> -<h3 id="Personnalisation_avec_userChrome.css" name="Personnalisation_avec_userChrome.css">Personnalisation avec userChrome.css</h3> -<p>Si vous placez un fichier appelé 'userChrome.css' dans le répertoire "chrome" dans le répertoire de votre profil utilisateur, vous pouvez remplacer des paramètres sans changer les archives elles-mêmes. Ce répertoire devrait être créé quand vous créez un profil et quelques exemples y figurer. Le fichier 'userContent.css' permet de personnaliser les pages Web, tandis que 'userChrome.css' permet de personnaliser les fichiers chrome.</p> -<p>Par exemple, en ajoutant ce qui suit à la fin de ce fichier, vous pouvez changer tous les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code> pour leur appliquer un fond rouge.</p> -<pre>menubar { - background-color: red; -} -</pre> -<p>Si vous ouvrez une fenêtre Mozilla après avoir effectué ce changement, les barres de menu seront rouges. Comme ce changement a été appliqué à la feuille de styles utilisateur, il affecte toutes les fenêtres. Cela signifie que la barre de menus du navigateur, la barre de menus des marque-pages et même la barre de menus du dialogue de recherche de fichiers seront rouges.</p> -<h3 id="Paquetages_de_th.C3.A8mes" name="Paquetages_de_th.C3.A8mes">Paquetages de thèmes</h3> -<p>Pour que le changement n'affecte qu'une fenêtre, modifiez la feuille de styles associée à ce fichier XUL. Par exemple, pour ajouter une bordure rouge autour des commandes de menu dans la fenêtre du carnet d'adresses, ajoutez ce qui suit au fichier 'bookmarksManager.css' dans l'archive 'classic.jar' ou de votre thème préféré.</p> -<pre>menuitem { - border: 1px solid red; -} -</pre> -<p>Si vous regardez dans les archives des thèmes, vous remarquerez que chacune contient un certain nombre de feuilles de styles et d'images. Les feuilles de styles font référence aux images. Vous devriez éviter de faire directement référence aux images dans les fichiers XUL si vous voulez que votre contenu puisse être modifié par un thème, parce qu'un certain thème peut ne pas utiliser d'images et avoir besoin d'un design plus complexe. En faisant référence aux images seulement dans les fichiers CSS, on peut facilement les enlever. Cela évite aussi la dépendance avec les noms de fichier spécifiques des images.</p> -<p>Vous pouvez attribuer des images à un bouton, à une case à cocher et à d'autres éléments en utilisant la propriété <code>list-style-image</code> comme suit :</p> -<pre>checkbox { - list-style-image: url("chrome://findfile/skin/images/check-off.jpg"); -} - -checkbox[checked="true"] { - list-style-image: url("chrome://findfile/skin/images/check-on.jpg"); -} -</pre> -<p>Ce code modifie l'image associée à une case à cocher. Le premier style applique une certaine image pour une case à cocher décochée et le second style pour une case à cocher cochée. Le modificateur 'checked=true' n'applique le style qu'aux éléments qui ont leur attribut <code id="a-checked"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/checked">checked</a></code> à 'true'.</p> -<p><small> Consultez <a href="/fr/Créer_un_thème_pour_Firefox" title="fr/Créer_un_thème_pour_Firefox">Créer un thème pour Firefox</a> et <a href="/fr/CSS/Premiers_pas" title="fr/CSS/Premiers_pas">CSS:Premiers pas</a> pour plus de détails. </small></p> -<hr> -<p>Dans la prochaine section, nous allons voir comment créer un nouveau thème.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Styler_un_arbre" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Créer_un_thème">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/onglets/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/onglets/index.html deleted file mode 100644 index e2d94235ea..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/onglets/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Onglets -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Onglets -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Tabboxes ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Positionnement_dans_une_pile" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Grilles">Suivant »</a></p> -</div> -<p>Il est courant de voir des pages à onglets dans les boîtes de dialogues de préférences. Nous allons voir ici comment les créer.</p> -<h3 id="Bo.C3.AEtes_d.27onglets" name="Bo.C3.AEtes_d.27onglets">Boîtes d'onglets</h3> -<p>Les boîtes d'onglets sont typiquement utilisées dans une application de fenêtre de préférences. Une série d'onglets apparaît en travers du bord supérieur de la fenêtre. L'utilisateur peut cliquer sur chaque onglet pour voir la sélection des options. L'emploi d'onglets est très utile lorsque vous avez plus d'options qu'il ne peut en tenir sur l'écran.</p> -<p>XUL offre une méthode pour créer de telles boîtes de dialogues. Elles nécessitent cinq nouveaux éléments qui sont décrits brièvement ici et plus en détail par la suite.</p> -<dl> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> </dt> <dd>La boîte externe qui contient les onglets sur le haut et les pages correspondantes elles mêmes.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> </dt> <dd>La boîte interne qui contient les onglets individuellement. En d'autres termes, il s'agit d'un groupement d'onglets.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> </dt> <dd>Un onglet spécifique. Cliquer sur un onglet remonte la page de l'onglet au premier plan.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code> </dt> <dd>Le container des pages.</dd> <dt><code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code> </dt> <dd>Le corps d'une page seule. Vous allez placer le contenu d'une page dans cette élément. Le premier <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code> correspond au premier onglet, le second <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code> correspond au second onglet, et ainsi de suite.</dd> -</dl> -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> est l'élément externe. Il est constitué de deux enfants, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> qui contient les en-têtes des onglets, et l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code> qui contient les pages d'onglets.</p> -<p>La syntaxe typique d'une boîte d'onglets est décrite ci dessous :</p> -<pre><tabbox id="tablist"> - <tabs> - <!-- les éléments tab viennent ici --> - </tabs> - <tabpanels> - <!-- les éléments tabpanel viennent ici --> - </tabpanels> -</tabbox> -</pre> -<p>Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> sont placés à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> qui se comporte comme une boîte normale. L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> lui même a été placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Cet élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> contient aussi l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code> qui apparaît en dessous de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> à cause de la disposition verticale de la boîte d'onglets.</p> -<p>Il n'y a réellement rien de spécial au sujet des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> qui les rendent différents des boîtes. Comme pour les boîtes, les onglets peuvent contenir n'importe quels éléments. La différence est que les onglets ont un rendu sensiblement différent et seulement le contenu de la page d'un seul onglet sera visible à la fois, comme peut le faire l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code>.</p> -<p>Le contenu des pages correspondant à chaque onglet doit être placé dans chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code> correspondant. Il ne doit pas être mis dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> qui contient, lui, le contenu descriptif de l'onglet sur le bord supérieur.</p> -<p>Chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code> devient une page de l'onglet affiché. La première page correspond au premier onglet, la seconde page correspond au second onglet, et ainsi de suite. Il y a une relation de un-à-un entre chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> et chaque élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanel" title="tabpanel">tabpanel</a></code>.</p> -<p>Pour déterminer la dimension d'une boîte d'onglets, la taille de la plus grande page est utilisée. Ainsi, si vous avez dix champs de saisie sur une page et seulement un sur une autre page, cette autre page sera dimensionnée pour s'ajuster à celle qui contient les dix champs de saisie en occupant plus d'espace. La surface occupée par la page d'un onglet ne change pas lorsque l'utilisateur bascule vers une page d'un autre onglet.</p> -<h4 id="Exemple_de_bo.C3.AEte_d.27onglets" name="Exemple_de_bo.C3.AEte_d.27onglets">Exemple de boîte d'onglets</h4> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_tabpanel_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_tabpanel_1.xul">Voir</a></p> -<div class="float-right"><img alt="Image:xultu_tabpanel1.png" class=" internal" src="/@api/deki/files/1555/=Xultu_tabpanel1.png"></div> -<pre><tabbox> - <tabs> - <tab label="Courrier"/> - <tab label="Forum"/> - </tabs> - <tabpanels> - <tabpanel id="mailtab"> - <checkbox label="Vérifier automatiquement le courrier"/> - </tabpanel> - <tabpanel id="newstab"> - <button label="Effacer le cache des forums"/> - </tabpanel> - </tabpanels> -</tabbox> -</pre> -<p>Ici, deux onglets ont été ajoutés. Le premier est intitulé 'Courrier' et l'autre est intitulé 'Forum'. Lorsque l'utilisateur clique sur l'onglet 'Courrier', le contenu de la première page est affiché. Dans ce cas, la boîte avec la case à cocher intitulé 'Vérifier automatiquement le courrier' apparaîtra sous cet onglet. Le second onglet, lorsqu'il est cliqué, affichera la boîte contenant le bouton intitulé 'Effacer le cache des forums'.</p> -<p>L'onglet courant sélectionné est donné par un attribut supplémentaire <code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code> initialisé à 'true' sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code>. Il sert à donner à l'onglet par défaut un aspect différent de telle façon qu'il apparaisse sélectionné. Un seul onglet peut avoir cet attribut avec une valeur 'true'.</p> -<h4 id="Positionnement_des_onglets" name="Positionnement_des_onglets">Positionnement des onglets</h4> -<p>Finalement, vous pouvez changer la position des onglets pour qu'ils apparaissent sur n'importe quel côté des pages d'onglets. Il suffit de définir les attributs <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> et <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> comme nécessaire. Souvenez vous que les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> sont des boîtes normales en terme de mise en page. D'ailleurs, l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code> se comporte comme une boîte normale ayant une orientation verticale par défaut, dans laquelle l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> est une boîte ayant une orientation horizontale.</p> -<div class="float-right"><img alt="Image:xultu_tabpanel_extra.png" class=" internal" src="/@api/deki/files/1557/=Xultu_tabpanel_extra.png"></div> -<p>Par exemple, pour mettre les onglets le long du bord gauche, changez l'orientation de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> pour qu'elle soit verticale. Ils seront empilés les uns sur les autres. Ensuite, mettez une orientation horizontale sur le <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Les onglets appaîtront à gauche, et pas au dessus des pages d'onglets. Notez que la modification de l'orientation de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code> n'aura aucun effet puisque les pages d'onglets sont empilées les unes sur les autres. (NdT : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_tabs.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_tabs.xul">Voir</a>)</p> -<p>Vous pouvez placer les onglets le long du bord droit ou en bas en déplaçant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabs" title="tabs">tabs</a></code> après l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tabpanels" title="tabpanels">tabpanels</a></code>. De plus, vous devrez définir l'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> à 'reverse' sur <code><a href="/fr/docs/Mozilla/Tech/XUL/tabbox" title="tabbox">tabbox</a></code>. Cependant, vous devriez laisser les onglets en haut car leur rendu graphique risque d'être mauvais avec certains thèmes graphiques particuliers.</p> -<div class="highlight"> -<h3 id="Ajout_d.27onglets_.C3.A0_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers" name="Ajout_d.27onglets_.C3.A0_la_bo.C3.AEte_de_dialogue_de_recherche_de_fichiers">Ajout d'onglets à la boîte de dialogue de recherche de fichiers</h3> -<p>Ajoutons une seconde page à notre boîte de dialogue de recherche de fichiers. Nous allons créer un onglet 'Options' (en le sélectionnant par défaut) qui contiendra quelques options de recherche. Ce n'est peut être pas la meilleure interface pour faire cela, mais nous l'utiliserons pour la démonstration des onglets. Le libellé d'en-tête et la boîte de critères de recherche iront dans la première page d'onglet. Nous allons ajouter quelques options dans la seconde page d'onglet. La barre de progression et les boutons restent sur la boîte de dialogue principale, en dehors des onglets.</p> -<pre class="eval"><vbox flex="1"> - -<span class="highlightred"><tabbox selectedIndex="1"> <tabs> <tab label="Recherche"/> <tab label="Options"/> </tabs> <tabpanels> <tabpanel id="searchpanel" orient="vertical"></span> - - <description> - Entrez votre critère de recherche ci dessous et appuyer sur le - bouton Rechercher. - </description> - - <spacer style="height: 10px"/> - - <groupbox orient="horizontal"> - <span class="nowiki"><caption label="Critère de recherche"/></span> - - <menulist id="searchtype"> - <menupopup> - <menuitem label="Nom"/> - <menuitem label="Taille"/> - <menuitem label="Date de modification"/> - </menupopup> - </menulist> - <spacer style="width: 10px;"/> - <menulist id="searchmode"> - <menupopup> - <menuitem label="Est"/> - <menuitem label="N'est pas"/> - </menupopup> - </menulist> - - <spacer style="height: 10px"/> - <textbox id="find-text" flex="1" style="min-width: 15em;"/> - - </groupbox> - <span class="highlightred"></tabpanel> <tabpanel id="optionspanel" orient="vertical"> <checkbox id="casecheck" label="Recherche sensible à la casse"/> <checkbox id="wordscheck" label="Nom de fichier entier"/> </tabpanel> </tabpanels> </tabbox></span> -</pre> -<div class="float-right"><img alt="Image:xultu_tabpanel2.png" class=" internal" src="/@api/deki/files/1556/=Xultu_tabpanel2.png"></div> -<p>Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tab" title="tab">tab</a></code> ont été placés autour du contenu principal de la fenêtre. Vous pouvez voir les deux onglets, 'Recherche' et 'Options'. En cliquant sur chacun d'eux, vous faites apparaître les pages correspondantes. Comme montré sur l'image ci-dessus, les deux options de recherche apparaissent sur le deuxième onglet. La première page ressemble beaucoup à ce qu'elle était avant, exceptée la présence des onglets sur le bord supérieur.</p> -Exemple de recherche de fichiers : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfiles-tabpanel.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfiles-tabpanel.xul">Voir</a></div> -<hr> -<p>Dans la section suivante, nous allons voir comment créer des grilles pour le placement de contenus.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Positionnement_dans_une_pile" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Grilles">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/overlays_inter-paquetage/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/overlays_inter-paquetage/index.html deleted file mode 100644 index fa037a0316..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/overlays_inter-paquetage/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Overlays inter-paquetage -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Overlays_inter-paquetage -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Cross_Package_Overlays ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Overlays" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Création_d'un_programme_d'installation">Suivant »</a></p> -</div> - -<p>Cette section décrit comment appliquer des overlays à des fichiers qui ne les importent pas.</p> - -<h3 id="Application_d.27overlays_.C3.A0_d.27autres_paquetages" name="Application_d.27overlays_.C3.A0_d.27autres_paquetages">Application d'overlays à d'autres paquetages</h3> - -<div class="note">Note : Cette section traite de contents.rdf qui a été remplacé par <a href="/fr/Tutoriel_XUL/Les_fichiers_manifest" title="fr/Tutoriel_XUL/Les_fichiers_manifest">des fichiers manifest</a> depuis <a href="/fr/Gecko" title="fr/Gecko">Gecko</a> 1.8.</div> - -<p>Les overlays ont d'autres fonctionnalités très utiles. Dans les exemples de <a href="/fr/Tutoriel_XUL/Overlays" title="fr/Tutoriel_XUL/Overlays">la section précédente</a>, les overlays étaient importés par la fenêtre. Vous pouvez aussi utiliser une autre méthode en indiquant aux overlays pour quelles fenêtres ils seront appliqués. Il vous suffit de modifier le fichier 'contents.rdf' de votre paquetage. Cette méthode est très utile car elle permet à un overlay de modifier l'interface utilisateur d'un autre paquetage sans pour cela modifier celui-ci. Par exemple, vous pouvez ajouter des <a href="/fr/Tutoriel_XUL/Barres_de_menus_simples" title="fr/Tutoriel_XUL/Barres_de_menus_simples">items de menu</a> ou des <a href="/fr/Tutoriel_XUL/Barre_d'outils" title="fr/Tutoriel_XUL/Barre_d'outils">barres d'outils</a> à la fenêtre du navigateur Mozilla.</p> - -<p>Nous utiliserons cette fonctionnalité pour ajouter une barre d'outils dans le fenêtre du navigateur Mozilla. Le client courrier de Mozilla utilise les overlays pour ajouter du contenu à la fenêtre du navigateur. Par exemple, si le client n'est pas installé, il n'y a pas de commande pour de nouveaux messages. Toutefois, si le client est installé, un overlay sera appliqué au menu pour ajouter une commande de nouveaux messages. Ci-dessous, nous ajouterons une barre d'outils de recherche de fichiers au navigateur. Cette fonctionnalité n'a aucune utilité, mais nous l'intégreront quand même.</p> - -<p>Mozilla vous permet d'ajouter une liste d'overlays dans le fichier 'contents.rdf' utilisé pour spécifier les paquetages chrome, les thèmes graphiques et les localisations. Dès que vous avez créé un overlay, vous pouvez l'ajouter au fichier 'contents.rdf'. Il vous suffit d'ajouter les informations pour chacune des fenêtres où vous voulez appliquer l'overlay.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h4> - -<p>Tout d'abord, créons un simple overlay. Il contiendra quelques champs de saisie pour la recherche d'un nom de fichier et d'un répertoire. Chargez le fichier 'foverlay.xul' et ajoutez-le au répertoire de notre exemple de recherche de fichiers à côté de 'findfile.xul'.</p> - -<h4 id="Notre_exemple_foverlay.xul" name="Notre_exemple_foverlay.xul">Notre exemple foverlay.xul</h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_crosspov_1.xul.txt">Source</a></p> - -<pre><?xml version="1.0" encoding="ISO-8859-1"?> - -<overlay - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<toolbox id="navigator-toolbox"> - <toolbar id="findfile_toolbar"> - <label control="findfile_filename" value="Recherche des fichiers nommés :"/> - <textbox id="findfile_filename"/> - <label control="findfile_dir" value="Répertoire :"/> - <textbox id="findfile_dir"/> - <button label="Parcourir..."/> - </toolbar> -</toolbox> - -</overlay> -</pre> - -<p>Vous pouvez visualiser cet exemple en changeant l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/overlay" title="overlay">overlay</a></code> par <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. La seule chose un peu spécifique est l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> utilisé sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbox" title="toolbox">toolbox</a></code>. Cette valeur ('navigator-toolbox') est la même que l'identifiant de la boîte d'outils de la fenêtre du navigateur ('navigator.xul'). Elle signifie que cet overlay sera appliqué à la boîte d'outils du navigateur et que son contenu sera ajouté comme une barre d'outils supplémentaire.</p> - -<p>Pour ajouter cet overlay au fichier manifest, vous devons ajouter deux ressources. Premièrement, nous en ajoutons une pour chaque fenêtre où l'overlay sera appliqué. Le code suivant doit être placé dans le fichier 'contents.rdf' juste avant la balise fermante de RDF.</p> - -<pre><RDF:Seq about="urn:mozilla:overlays"> - <RDF:li resource="chrome://navigator/content/navigator.xul"/> -</RDF:Seq> -</pre> - -<p>Cette déclaration précise l'ajout d'une fenêtre overlay au système de gestion des overlays (urn:mozilla:overlays). Vous pouvez ajouter des nœuds supplémentaires pour chaque fenêtre à modifier en ajoutant des balises <code>li</code> supplémentaires.</p> - -<p>Ensuite, nous ajoutons un nœud pour chaque overlay s'appliquant à la fenêtre. Dans ce cas, vous n'en avez qu'un, mais d'autres peuvent être appliqués. Ajoutez ces lignes à la suite des précédentes :</p> - -<pre><RDF:Seq about="chrome://navigator/content/navigator.xul"> - <RDF:li>chrome://findfile/content/foverlay.xul</RDF:li> -</RDF:Seq> -</pre> -</div> - -<div class="float-right"><img alt="Image:xultu_crosspov.png" class="internal" src="/@api/deki/files/1511/=Xultu_crosspov.png"></div> - -<p>Mozilla lit cette information et construit une liste d'overlays appliqués à d'autres fenêtres. Il enregistre cette information dans un répertoire chrome/overlayinfo. Il n'est pas nécessaire que vous modifiez manuellement les fichiers de ce répertoire. Ils sont générés automatiquement et modifiés au premier lancement de Mozilla ou lorque de nouveaux paquetages sont installés. Toutefois, vous pouvez forcer la reconstruction de leurs données en effaçant ce répertoire et le fichier 'chrome.rdf.'</p> - -<p>Note complémentaire : vous pouvez utiliser cette même technique pour appliquer des feuilles de styles supplémentaires. L'exemple suivant vous montre comment :</p> - -<pre><RDF:Seq about="urn:mozilla:stylesheets"> - <RDF:li resource="chrome://messenger/content/messenger.xul"/> -</RDF:Seq> - -<RDF:Seq about="chrome://messenger/content/messenger.xul"> - <RDF:li>chrome://blueswayedshoes/skin/myskinfile.css</RDF:li> -</RDF:Seq> -</pre> - -<hr> -<p>Nous verrons ensuite comment créer un installeur pour une application XUL.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Overlays" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Création_d'un_programme_d'installation">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/piles_et_paquets/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/piles_et_paquets/index.html deleted file mode 100644 index 2913d20ebb..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/piles_et_paquets/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Piles et Paquets -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Piles_et_Paquets -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Stacks_and_Decks ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajouter_plus_d'éléments" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Positionnement_dans_une_pile">Suivant »</a></p> -</div> - -<p>Il se peut qu'il soit nécessaire d'afficher des éléments comme un empilement superposé de cartes. Les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code> peuvent être utilisés à cet effet.</p> - -<h3 id="Containers" name="Containers">Containers</h3> - -<p>Chaque boîte XUL est un container qui peut contenir n'importe quel autre élément. Il y a un certain nombre d'éléments qui sont des types spécialisés de boîtes, tels que <a href="/fr/Tutoriel_XUL/Barre_d'outils" title="fr/Tutoriel_XUL/Barre_d'outils">les barres d'outils</a> et <a href="/fr/Tutoriel_XUL/Onglets" title="fr/Tutoriel_XUL/Onglets">les onglets</a>. La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code> crée la plus simple des boîtes sans propriétés spéciales. Toutefois, les types spécialisés de boîtes fonctionnent comme des boîtes normales dans le sens où elles orientent les éléments qu'elles contiennent, mais elles ont des fonctionnalités supplémentaires.</p> - -<p>En fait, beaucoup de composants peuvent contenir d'autres éléments. Nous avons déjà vu que les boutons peuvent contenir d'autres choses que leurs contenus par défaut. Une barre de défilement est juste un type spécial de boîte qui crée ses propres éléments si vous ne les fournissez pas. Ceux-ci contrôlent également le déplacement de l'ascenseur de la barre de défilement.</p> - -<p>Dans les prochaines sections, nous allons introduire quelques éléments qui sont prévus pour le contrôle d'autres éléments. Ce sont tous des types spéciaux de boîtes et permettent d'inclure tous les attributs des boîtes.</p> - -<h3 id="Piles" name="Piles">Piles</h3> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code> est une simple boîte. Il fonctionne comme toute autre boîte mais a la propriété spéciale que ces enfants sont tous disposés les uns au dessus des autres. Le premier enfant de la pile est dessiné sur le dessous, le second enfant est dessiné ensuite, suivi du troisième et ainsi de suite. De nombreux éléments peuvent être empilés sur une pile.</p> - -<p>La propriété <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> n'a aucune signification particulière sur un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>, car les enfants sont empilés les uns sur les autres au lieu d'être côte à côte. Les dimensions d'une pile sont déterminées par celle de son plus grand enfant, mais vous pouvez utilisez les propriétés CSS <code>width</code>, <code>height</code>, <code>min-width</code> ou d'autres propriétés similaires à la fois sur la pile et ses enfants.</p> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code> pourrait être utilisé quand un indicateur d'état doit d'être ajouté au dessus d'un élément existant. Par exemple, un indicateur de progression pourrait être créé avec une barre et un libellé en surimpression.</p> - -<p><img alt="Image:xultu_stacks_progress.png" class="internal" src="/@api/deki/files/1554/=Xultu_stacks_progress.png"></p> - -<h4 id="Effet_d.27ombre_avec_des_piles" name="Effet_d.27ombre_avec_des_piles">Effet d'ombre avec des piles</h4> - -<p>Une utilisation pratique de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code> est de pouvoir simuler un certain nombre de propriétés CSS avec. Par exemple, vous pouvez créer un effet similaire à la propriété <code>text-shadow</code> comme ceci :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_1.xul">Voir</a></p> - -<pre><stack> - <description value="Ombré" style="padding-left: 1px; padding-top: 1px; font-size: 15pt"/> - <description value="Ombré" style="color: red; font-size: 15pt;"/> -</stack> -</pre> - -<p><img alt="Image:xultu_stacks1.png" class="internal" src="/@api/deki/files/1553/=Xultu_stacks1.png"></p> - -<p>Les deux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> créent chacun un texte avec une taille de 15 points. Le premier est toutefois décalé d'un pixel vers la droite et vers le bas grâce à l'ajout d'une marge de texte sur la gauche et sur le haut. Le résultat est le dessin répété du même texte 'Ombré' mais en léger décalage. Le second élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> est dessiné en rouge pour que l'effet soit encore plus visible.</p> - -<p>Cette méthode a des avantages sur l'emploi de <code>text-shadow</code> car vous pouvez complètement personnaliser les effets d'ombres de votre texte principal. Il peut avoir sa propre police de caractères, un soulignement ou une taille propre (vous pouvez même créer un texte ombré clignotant). C'est aussi utile car Mozilla ne supporte pas pour l'instant les textes ombrés en CSS. Un désavantage est que l'espace occupé par le texte ombré fait une pile plus grande. L'effet d'ombrage est très utile pour créer des boutons d'apparence désactivée :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_2.xul">Voir</a></p> - -<pre><stack style="background-color: #C0C0C0"> - <description value="Désactivé" style="color: white; padding-left: 1px; padding-top: 1px;"/> - <description value="Désactivé" style="color: grey;"/> -</stack> -</pre> - -<p>Cet arrangement de couleurs de texte et d'ombrage créent cet aspect désactivé que l'on retrouve sur certaines plates-formes.</p> - -<div class="note">Notez que les évènements tels que les clics de la souris et les touches du clavier sont transmis à l'élément sur le haut de la pile qui est le dernier élément de la pile. Cela signifie qu'un bouton ne fonctionnera correctement que s'il est le dernier élément de la pile.</div> - -<h3 id="Paquets" name="Paquets">Paquets</h3> - -<p>Un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code> place également ses enfants les uns au dessus des autres comme l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code>, toutefois les paquets n'affichent qu'un seul de leurs enfants à la fois. Ce comportement s'avère utile pour une interface d'assistant dans laquelle une série de panneaux similaires sont affichés en série. Au lieu de créer des fenêtres séparées et d'ajouter des boutons de navigation à chacune d'elles, vous n'avez qu'à créer une seule fenêtre et utiliser un paquet dans lequel le contenu changera.</p> - -<p>Comme pour les piles, les enfants directs d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code> forment les pages du paquet. S'il y a trois enfants dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code>, le paquet aura trois enfants. La page affichée du paquet peut être changée en définissant un attribut <code id="a-selectdIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectdIndex">selectdIndex</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/deck" title="deck">deck</a></code>. L'index est un nombre qui identifie quelle page à afficher. Les pages sont numérotées à partir de zéro. Ainsi, le premier enfant du paquet est la page '0', le second est la page '1', etc.</p> - -<p>Ce qui suit est un exemple de paquet :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_stacks_3.xul">Voir</a></p> - -<pre><deck selectedIndex="2"> - <description value="Ceci est la première page "/> - <button label="Ceci est la seconde page "/> - <box> - <description value="Ceci est la troisième page "/> - <button label="Ceci est également la troisième page "/> - </box> -</deck> -</pre> - -<p>Ici, il y a trois pages, celle affichée par défaut est la troisième. La troisième page est une boîte avec deux éléments qui y sont inclus. L'ensemble de cette boîte et de ses éléments forme une page. Le paquet sera aussi grand que le plus grand de ses enfants, qui dans le cas présent sera la troisième page.</p> - -<p>Vous pouvez changer de page en utilisant un script pour modifier l'attribut <code id="a-selectedIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selectedIndex">selectedIndex</a></code>. Pour plus de renseignements là dessus, reportez vous aux sections sur les évènements et le DOM.</p> - -<hr> -<p>La prochaine section décrit comment les piles peuvent être utilisées pour positionner les éléments.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajouter_plus_d'éléments" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Positionnement_dans_une_pile">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_caractéristiques_sur_les_boutons/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_caractéristiques_sur_les_boutons/index.html deleted file mode 100644 index b6b5318c43..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_caractéristiques_sur_les_boutons/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Plus de caractéristiques sur les boutons -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Plus_de_caractéristiques_sur_les_boutons -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/More_Button_Features ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Utilisation_des_spacers" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Le_modèle_de_boîte">Suivant »</a></p> -</div> - -<p>Dans ce chapitre, nous allons voir quelques fonctionnalités supplémentaires des boutons.</p> - -<h3 id="Ajouter_une_image" name="Ajouter_une_image">Ajouter une image</h3> - -<p>Vous pouvez ajouter une image dans un bouton en spécifiant une adresse <abbr title="Uniform Resource Locator">URL</abbr> dans l'attribut <code id="a-image"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/image">image</a></code>. L'image chargée à partir de l'URL, qui peut être relative ou absolue, sera affichée sur le bouton.</p> - -<p>Le bouton sur l'exemple ci-dessous aura en même temps un libellé et une image 'happy.png'. L'image apparaîtra à gauche du libellé. Vous pouvez changer cette position en utilisant deux autres attributs. Ils seront expliqués dans un moment.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_1.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_1">Voir</a></p> - -<pre><button label="Aide" image="happy.png"/></pre> - -<h4 id="Bouton_avec_une_image_CSS" name="Bouton_avec_une_image_CSS">Bouton avec une image CSS</h4> - -<p>Une autre façon de procéder consiste à spécifier une image en utilisant la propriété de <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> CSS <a href="/fr/docs/Web/CSS/list-style-image" title="La propriété list-style-image définit l'image utilisée comme puce devant les éléments de listes. On peut également utiliser la propriété raccourcie list-style."><code>list-style-image</code></a> appliquée au bouton. Cette méthode permet de changer l'apparence (dans ce cas, l'apparence de l'image) sans modifier le fichier XUL. Un exemple vous est montré ci-dessous.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_2.xul">Voir</a></p> - -<pre><button id="find-button" - label="Chercher" style="list-style-image: url('happy.png')"/> -</pre> - -<p>Dans ce cas, l'image 'happy.png' est affichée sur le bouton. L'attribut <code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code> fonctionne de façon similaire à son homologue HTML. En général, il peut être utilisé sur tous les éléments XUL. Notez qu'il serait plus judicieux de placer toutes les déclarations de styles dans une feuille de style séparée.</p> - -<h3 id="Le_positionnement_des_images" name="Le_positionnement_des_images">Le positionnement des images</h3> - -<p>Par défaut, l'image sur le bouton apparaît à gauche du libellé. Il y a deux attributs permettant de contrôler sa position.</p> - -<p>L'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> contrôle la direction de l'image et du texte. En définissant cet attribut avec la valeur 'reverse', l'image sera placée à droite du texte. En utilisant la valeur 'normal', ou en omettant cet attribut, l'image sera placée à gauche du texte.</p> - -<div class="note"><abbr title="Note du Traducteur">NdT</abbr> : Sur de vieilles versions de Mozilla, les valeurs à utiliser sont respectivement 'rtl' (right-to-left) et 'ltr' (left-to-right).</div> - -<p>L'attribut <code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code> peut être utilisé pour placer l'image au-dessus ou en dessous du texte. Sa valeur par défaut est 'horizontal' et sert à placer l'image à gauche ou à droite. Vous pouvez aussi utiliser la valeur 'vertical' pour placer l'image au-dessus ou en dessous. Dans ce cas, l'attribut <code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code> contrôle le placement vertical. Les mêmes valeurs sont utilisées, où 'normal' provoque le placement de l'image au-dessus du texte, et 'reverse' provoque le placement de l'image en dessous du texte.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_3.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_advbtns1.png" class="internal" src="/@api/deki/files/1492/=Xultu_advbtns1.png"></div> - -<pre><button label="Gauche" image="happy.png"/> -<button label="Droite" image="happy.png" dir="reverse"/> -<button label="Dessus" image="happy.png" orient="vertical"/> -<button label="Dessous" image="happy.png" orient="vertical" dir="reverse"/> -</pre> - -<p>Cet exemple vous montre les quatre types d'alignement des boutons. Notez que les deux attributs ne sont pas spécifiés lorsque leur valeur par défaut est utilisée.</p> - -<h3 id="Des_boutons_avec_des_contenus_sp.C3.A9ciaux" name="Des_boutons_avec_des_contenus_sp.C3.A9ciaux">Des boutons avec des contenus spéciaux</h3> - -<p>Les boutons peuvent contenir un balisage arbitraire, qui sera représenté dans le bouton. Vous ne l'utiliserez probablement pas très souvent, mais vous pourrez l'utiliser pour créer des éléments personnalisés.</p> - -<p>Cet exemple va créer un bouton dans lequel deux mots seront en magenta :</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_4.xul">Voir</a></p> - -<pre><button> - <description value="Ceci est"/> - <description value="un étrange" style="color: purple;"/> - <description value="bouton"/> -</button> -</pre> - -<p>N'importe quel élément XUL peut être placé à l'intérieur d'un bouton. Les éléments HTML seront ignorés, donc vous devez les intégrer à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code>. Si vous spécifiez un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> sur un bouton, il supplantera n'importe quel autre contenu placé dans la définition du bouton.</p> - -<h4 id="Bouton_avec_un_menu_surgissant" name="Bouton_avec_un_menu_surgissant">Bouton avec un menu surgissant</h4> - -<p>Vous pouvez mettre un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> dans un bouton pour générer une liste déroulante lorsque le bouton est enfoncé, à l'instar de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>. Toutefois, dans ce cas, vous devez indiquer l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> avec la valeur 'menu'.</p> - -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_5.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_advbtns2.png" class="internal" src="/@api/deki/files/1493/=Xultu_advbtns2.png"></div> - -<pre><button type="menu" label="Périphérique"> - <menupopup> - <menuitem label="Imprimante"/> - <menuitem label="Souris"/> - <menuitem label="Clavier"/> - </menupopup> -</button> -</pre> - -<p>Dans cet exemple, l'utilisateur doit cliquer sur le bouton pour faire apparaître un menu contenant trois items de menu. Notez que la sélection d'un des items ne change pas le libellé du bouton, contrairement à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>. Ce type de bouton est destiné à être utilisé comme un menu, avec des scripts associés à chaque item, exécutant une tâche précise. Nous en verrons plus sur les menus plus tard.</p> - -<p>Vous pouvez également affecter la valeur 'menu-button' à l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> (<abbr title="Note du Traducteur">NdT</abbr> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_5bis.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advbtns_5bis.xul">Voir</a>). Cette valeur crée aussi un bouton avec un menu, mais son apparence est différente. L'image ci-contre montre cette différence. Le bouton de gauche est un 'menu' et celui de droite est un 'menu-button'. Ils ont chacun une flèche pour indiquer la présence d'un menu déroulant. Pour le 'menu', l'utilisateur doit cliquer n'importe où sur le bouton pour ouvrir le menu. Pour le 'menu-button', l'utilisateur doit cliquer sur la flèche pour faire apparaître le menu.</p> - -<hr> -<p>Dans la prochaine section, nous en apprendrons plus sur le positionnement des éléments XUL dans une fenêtre.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Utilisation_des_spacers" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Le_modèle_de_boîte">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_fonctionnalités_de_menu/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_fonctionnalités_de_menu/index.html deleted file mode 100644 index 908aab0ed9..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_de_fonctionnalités_de_menu/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Plus de fonctionnalités de menu -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Plus_de_fonctionnalités_de_menu -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/More_Menu_Features ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Barres_de_menus_simples" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Menus_surgissants">Suivant »</a></p> -</div> -<p>Dans cette section, nous allons voir comment créer des sous-menus et des coches de menus.</p> -<h3 id="Cr.C3.A9er_des_sous-menus" name="Cr.C3.A9er_des_sous-menus">Créer des sous-menus</h3> -<p>Vous pouvez créer des sous-menus à l'intérieur d'autres menus (menus imbriqués) en utilisant les éléments existants. Souvenez-vous que vous pouvez mettre n'importe quel élément dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Nous avons vu comment placer des <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code> et des <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> dans des <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>. Toutefois, vous pouvez créer des sous-menus en plaçant simplement l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> à l'intérieur de l'élément <code>menupopup</code>. Ce fonctionnement est possible du fait que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> est valide même quand il n'est pas placé directement dans une barre de menu.</p> -<p>L'exemple ci-dessous crée un simple sous-menu dans le menu Fichier :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_1.xul">Voir</a></p> -<div class="float-right"><img alt="Image:xultu_menubar_3.png" class=" internal" src="/@api/deki/files/1533/=Xultu_menubar_3.png"></div> -<pre><toolbox flex="1"> - <menubar id="sample-menubar"> - <menu id="file-menu" label="Fichier"> - <menupopup id="file-popup"> - <menu id="new-menu" label="Nouveau"> - <menupopup id="new-popup"> - <menuitem label="Fenêtre"/> - <menuitem label="Message"/> - </menupopup> - </menu> - <menuitem label="Ouvrir"/> - <menuitem label="Sauver"/> - <menuseparator/> - <menuitem label="Quitter"/> - </menupopup> - </menu> - </menubar> -</toolbox> -</pre> -<div class="highlight"> -<h3 id="Ajout_d.27un_menu_.C3.A0_notre_exemple_de_recherche_de_fichiers" name="Ajout_d.27un_menu_.C3.A0_notre_exemple_de_recherche_de_fichiers">Ajout d'un menu à notre exemple de recherche de fichiers</h3> -<p>Ajoutons un menu à la boîte de dialogue de recherche de fichiers. Nous allons juste ajouter quelques commandes simples à un menu 'Fichier' et à un menu 'Édition'. Ces menus sont similaires à l'exemple ci-dessus.</p> -<pre class="eval"><toolbox> - - <span class="highlightred"><menubar id="findfiles-menubar"> <menu id="file-menu" label="Fichier" accesskey="f"> <menupopup id="file-popup"> <menuitem label="Ouvrir une Recherche..." accesskey="o"/> <menuitem label="Enregistrer une Recherche..." accesskey="s"/> <menuseparator/> <menuitem label="Fermer" accesskey="c"/> </menupopup> </menu> <menu id="edit-menu" label="Édition" accesskey="e"> <menupopup id="edit-popup"> <menuitem label="Couper" accesskey="t"/> <menuitem label="Copier" accesskey="p"/> <menuitem label="Copier" accesskey="l" disabled="true"/> </menupopup> </menu> </menubar></span> - -<toolbar id="findfiles-toolbar> -</pre> -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-advmenu.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-advmenu.xul">Voir</a></p> -<div class="float-right"><img alt="Image:xultu_menubar1.png" class=" internal" src="/@api/deki/files/1530/=Xultu_menubar1.png"></div> -Ici, nous avons ajouté deux menus contenant des commandes variées. Notez que la barre de menus a été ajoutée dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/toolbox" title="toolbox">toolbox</a></code>. Les points de suspension après 'Ouvrir une Recherche' et 'Enregistrer une Recherche' sont le moyen habituel pour indiquer à l'utilisateur qu'une boîte de dialogue va s'ouvrir quand il sélectionne une de ces commandes. Des touches de raccourcis ont été associées à chaque menu et à chaque item de menu. Vous verrez dans l'image que cette lettre a été soulignée dans le texte du menu. Vous verrez aussi que la commande 'Coller' a été désactivée. Nous supposons qu'il n'y a rien à coller.</div> -<h3 id="Ajouter_des_coches_aux_menus" name="Ajouter_des_coches_aux_menus">Ajouter des coches aux menus</h3> -<p>De nombreuses applications ont des items de menu avec des coches. Par exemple, une fonctionnalité qui est active a une coche placé à côté de la commande et une fonctionnalité qui est désactivée n'a pas de coche. Quand l'utilisateur sélectionne le menu, l'état de la coche est inversé. Vous pouvez aussi créer des boutons radio sur les items de menu.</p> -<p>Les coches sont créées de manière similaire aux éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/radio" title="radio">radio</a></code>. Elles impliquent l'utilisation de deux attributs : <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> pour indiquer le type de coche et <code id="a-name"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/name">name</a></code> pour regrouper les commandes. L'exemple ci-dessous crée un menu avec un élément coché.</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_2.xul">Voir</a></p> -<pre><toolbox> - <menubar id="options-menubar"> - <menu id="options_menu" label="Options"> - <menupopup> - <menuitem id="backups" label="Faire des sauvegardes" type="checkbox"/> - <menuitem id="backups" label="Mail de l'administrateur" type="checkbox" checked="true"/> - </menupopup> - </menu> - </menubar> -</toolbox> -</pre> -<p>L'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> ajouté est utilisé pour rendre l'élément de menu « cochable ». En mettant sa valeur à 'checkbox', l'élément de menu peut être coché et décoché par simple sélection.</p> -<h4 id="Menu_avec_des_boutons_radio" name="Menu_avec_des_boutons_radio">Menu avec des boutons radio</h4> -<p>En plus des coches standard, vous pouvez créer des coches de style radio en mettant <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> à la valeur 'radio'. Une coche radio est utilisée quand vous voulez un groupe d'éléments de menu dont l'un seulement peut être coché à la fois. Un exemple peut être un menu de police de caractères où une seule police peut être sélectionnée. Quand un autre item est sélectionné, l'élément choisi précédemment est automatiquement décoché.</p> -<p>Pour grouper plusieurs éléments de menu ensemble, vous devez placer un attribut <code id="a-name"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/name">name</a></code> sur chacun d'eux. Mettez la même chaîne de caractères comme valeur. L'exemple ci-dessous vous en donne l'illustration :</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advmenu_3.xul">Voir</a></p> -<pre><toolbox> - <menubar id="planets-menubar"> - <menu id="planet-menu" label="Planète"> - <menupopup> - <menuitem id="jupiter" label="Jupiter" type="radio" name="ringed"/> - <menuitem id="saturn" label="Saturne" type="radio" name="ringed" checked="true"/> - <menuitem id="uranus" label="Uranus" type="radio" name="ringed"/> - <menuseparator/> - <menuitem id="earth" label="Terre" type="radio" name="inhabited" checked="true"/> - <menuitem id="moon" label="Lune" type="radio" name="inhabited"/> - </menupopup> - </menu> - </menubar> -</toolbox> -</pre> -<p>Si vous essayez cet exemple, vous verrez que sur les trois premiers éléments, un seul peut être coché à la fois. Ils sont regroupés car ils ont le même nom. Le dernier élément de menu, 'Terre', ne fait pas partie du groupe car il a un nom différent. Pourtant, c'est aussi un bouton radio.</p> -<p>Bien sûr, les éléments de menu groupés doivent tous être dans le même menu. Ils n'ont pas à être placés les uns à côté des autres, mais les placer autrement n'aurait pas beaucoup de sens.</p> -<hr> -<p>Par la suite, nous allons voir comment créer des menus surgissants.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Barres_de_menus_simples" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Menus_surgissants">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_sur_les_gestionnaires_d'évènements/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/plus_sur_les_gestionnaires_d'évènements/index.html deleted file mode 100644 index 73d1b21264..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/plus_sur_les_gestionnaires_d'évènements/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: Plus sur les gestionnaires d'évènements -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Plus_sur_les_gestionnaires_d'évènements -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/More_Event_Handlers ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaires_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Raccourcis_clavier">Suivant »</a></p> -</div> -<p>Dans cette section, l'objet événement sera examiné et des événements additionnels seront décrits.</p> -<h3 id="L.27objet_.27event.27" name="L.27objet_.27event.27">L'objet 'event'</h3> -<p>Chaque gestionnaire d'événement dispose d'un unique argument qui contient un objet <a href="/fr/DOM/event" title="fr/DOM/event">event</a>. Dans la forme avec attributs des scrutateurs d'événements, cet événement est un argument implicite auquel un script peut se référer en utilisant le nom 'event'. Sous la forme <a href="/fr/DOM/element.addEventListener" title="fr/DOM/element.addEventListener">addEventListener</a>, le premier argument de la fonction scrutatrice sera un objet événement. L'objet 'event' dispose d'un certain nombre de propriétés qui peuvent être examinées lors de l'émission d'un événement. La liste complète est disponible dans <a class="external" href="http://xulplanet.com/references/objref/Event.html">les références objets</a>.</p> -<p>Nous avons déjà vu la propriété <code><a href="/fr/DOM/event.target" title="fr/DOM/event.target">target</a></code> d'un événement dans la section précédente. Elle contient une référence de l'élément ayant déclenché l'événement. Une propriété similaire <code><a href="/fr/DOM/event.currentTarget" title="fr/DOM/event.currentTarget">currentTarget</a></code> contient l'élément sur lequel est placé un scrutateur d'événement. Dans l'exemple ci-dessous, <code><a href="/fr/DOM/event.currentTarget" title="fr/DOM/event.currentTarget">currentTarget</a></code> pointe toujours la boîte <code><a href="/fr/docs/Mozilla/Tech/XUL/vbox" title="vbox">vbox</a></code>, alors que la cible peut être un élément spécifique, le bouton ou la case à cocher qui a été activé.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_1.xul">Voir</a></p> -<pre><vbox oncommand="alert(event.currentTarget.tagName);"> - <button label="OK"/> - <checkbox label="Voir les images"/> -</vbox> -</pre> -<h4 id="Stopper_la_propagation_d.27.C3.A9v.C3.A9nement" name="Stopper_la_propagation_d.27.C3.A9v.C3.A9nement">Stopper la propagation d'événement</h4> -<p>Une fois qu'un événement est traité, indépendamment de l'étape de la propagation où se trouve l'événement, vous pouvez empêcher qu'il soit transmis aux éléments suivants, c'est-à-dire de stopper les phases de captures ou de diffusion. En fonction de la manière dont vous avez attaché le scrutateur d'événement sur un élément, il existe plusieurs méthodes pour le faire.</p> -<p>Rappelez-vous que la phase de capture intervient avant la phase de diffusion, donc tous les scrutateurs de capture sont déclenchés avant les scrutateurs de diffusion. Si un événement capturé stoppe la propagation événementielle, aucun des scrutateurs de capture ou de diffusion suivants ne recevront de notification d'un quelconque événement. Pour interrompre la propagation événementielle, appelez la méthode <code><a href="/fr/DOM/event.stopPropagation" title="fr/DOM/event.stopPropagation">stopPropagation</a></code> de l'objet événement, comme dans l'exemple qui suit.</p> -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_2.xul">Voir</a></p> -<pre><hbox id="outerbox"> - <button id="okbutton" label="OK"/> -</hbox> - -<script> -function buttonPressed(event){ - alert('Le bouton a été pressé !'); -} - -function boxPressed(event){ - alert('La boîte a été pressée !'); - event.stopPropagation(); -} - -var button = document.getElementById("okbutton"); -button.addEventListener('command',buttonPressed,true); - -var outerbox = document.getElementById("outerbox"); -outerbox.addEventListener('command',boxPressed,true); -</script> -</pre> -<p>Ici, un scrutateur d'événement a été ajouté au bouton, et un autre à la boîte. La méthode <code><a href="/fr/DOM/event.stopPropagation" title="fr/DOM/event.stopPropagation">stopPropagation</a></code> est appelée dans le scrutateur de la boîte, donc le scrutateur du bouton ne sera jamais appelé. Si cet appel est enlevé, les deux scrutateurs seront appelés et les deux alertes apparaîtront.</p> -<h4 id="Emp.C3.AAcher_l.27action_par_d.C3.A9faut" name="Emp.C3.AAcher_l.27action_par_d.C3.A9faut">Empêcher l'action par défaut</h4> -<p>Si aucun gestionnaire d'événement n'a été enregistré pour un événement donné, alors après avoir accompli les phases de capture et de diffusion, l'élément traitera l'événement dans un mode par défaut. L'action par défaut dépendra de la nature de l'événement et du type d'élément. Par exemple, l'événement 'popupshowing' est envoyé par un menu surgissant juste avant son affichage. L'action par défaut est l'affichage du menu surgissant. Si l'action par défaut est bloquée, l'affichage ne se fera pas. L'action par défaut peut être empêchée avec la méthode <code><a href="/fr/DOM/event.preventDefault" title="fr/DOM/event.preventDefault">preventDefault</a></code> de l'objet événement, comme dans l'exemple ci-dessous.</p> -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_3.xul">Voir</a></p> -<pre><button label="Types" type="menu"> - <menupopup onpopupshowing="event.preventDefault();"> - <menuitem label="Verre"/> - <menuitem label="Plastique"/> - </menupopup> -</button> -</pre> -<p>Alternativement, pour des scrutateurs d'événement par attributs, vous pouvez simplement faire renvoyer la valeur 'false' par le code. Notez que l'empêchement de l'action par défaut ne revient pas à interrompre la propagation événementielle avec la méthode <code><a href="/fr/DOM/event.stopPropagation" title="fr/DOM/event.stopPropagation">stopPropagation</a></code>. Même si l'action par défaut a été bloquée, l'événement continue à se propager. De même, l'appel de la méthode <code><a href="/fr/DOM/event.stopPropagation" title="fr/DOM/event.stopPropagation">stopPropagation</a></code> ne bloquera pas l'action par défaut. Vous devrez appeler ces deux méthodes pour interrompre les deux actions.</p> -<p>Notez qu'une fois la propagation ou l'action par défaut bloquée, il n'est pas possible de les rendre actives de nouveau pour cet événement.</p> -<p>Les sous-sections ci-dessous listent quelques-uns des événements pouvant être utilisés. Une liste complète est fournie dans <a class="external" href="http://www.xulplanet.com/references/elemref/ref_EventHandlers.html">la référence des événements</a>.</p> -<h3 id=".C3.89v.C3.A9nements_de_la_souris" name=".C3.89v.C3.A9nements_de_la_souris">Événements de la souris</h3> -<p>Il y a plusieurs événements pouvant être employés pour gérer les actions de la souris, listés dans le tableau suivant :</p> -<dl> - <dt> - 'click' </dt> - <dd> - appelé lorsque la souris est appuyée puis relâchée sur un élément.</dd> - <dt> - 'dblclick' </dt> - <dd> - appelé lorsque la souris est double-cliquée.</dd> - <dt> - 'mousedown' </dt> - <dd> - appelé lorsqu'un bouton de la souris est pressé. Le gestionnaire d'événement est appelé aussitôt que le bouton de la souris est appuyé, avant même qu'il ne soit relâché.</dd> - <dt> - 'mouseup' </dt> - <dd> - appelé lorsque la souris est relâchée sur un élément.</dd> - <dt> - 'mouseover' </dt> - <dd> - appelé lorsque le pointeur de la souris survole un élément. Vous pourriez utiliser cet événement pour mettre en valeur l'élément, toutefois CSS fournit une façon automatique de le faire, il est donc inutile de le faire avec un événement. Vous pouvez toutefois l'utiliser pour afficher une aide dans la barre d'état.</dd> - <dt> - 'mousemove' </dt> - <dd> - appelé lorsque le pointeur de la souris se déplace au-dessus d'un élément. L'événement étant appelé à chaque déplacement de la souris, vous devriez éviter de faire appel à ce gestionnaire pour des tâches trop longues.</dd> - <dt> - 'mouseout' </dt> - <dd> - appelé lorsque le pointeur de la souris quitte un élément. Vous pourriez annuler la mise en valeur de l'élément ou effacer le texte de la barre d'état.</dd> -</dl> -<p>Il existe également un jeu d'événements relatifs au glisser, qui intervient lorsque l'utilisateur maintient le bouton de la souris enfoncé et déplace la souris. Ces événements seront décrits dans <a href="/fr/Tutoriel_XUL/Glisser-Déposer" title="fr/Tutoriel_XUL/Glisser-Déposer">la section Glisser-Déposer</a>.</p> -<h4 id="Propri.C3.A9t.C3.A9s_des_.C3.A9v.C3.A9nements_des_boutons_de_la_souris" name="Propri.C3.A9t.C3.A9s_des_.C3.A9v.C3.A9nements_des_boutons_de_la_souris">Propriétés des événements des boutons de la souris</h4> -<p>Lorsqu'un événement sur un bouton de la souris se produit, vous disposez d'un certain nombre de propriétés supplémentaires pour déterminer quels boutons ont été pressés et la position du pointeur de la souris. La propriété <code><a href="/fr/DOM/event.button" title="fr/DOM/event.button">button</a></code> de 'event' peut être utilisée pour déterminer quel bouton a été pressé, avec les valeurs possibles de '0' pour le bouton de gauche, '1' pour le bouton de droite, et '2' pour le bouton du milieu. Si vous avez configuré votre souris différemment, ces valeurs peuvent être différentes.</p> -<p>La propriété <code><a href="/fr/DOM/event.detail" title="fr/DOM/event.detail">detail</a></code> contient le nombre de fois que le bouton a été cliqué rapidement en séquence. Elle permet de tester des clics simples, doubles ou triples. Bien entendu, si vous ne souhaitez tester que les double-clics, vous pouvez plutôt utiliser l'événement 'dblclick'. L'événement 'click' sera lancé dès le premier clic, puis de nouveau pour le second clic, puis pour le troisième clic, tandis que l'événement 'dblclick' ne sera lancé que pour un double-clic.</p> -<p>Les propriétés <code><a href="/fr/DOM/event.button" title="fr/DOM/event.button">button</a></code> et <code><a href="/fr/DOM/event.detail" title="fr/DOM/event.detail">detail</a></code> ne s'appliquent qu'aux événements se rapportant aux boutons de la souris, et non aux déplacements de la souris. Pour l'événement 'mousemove', par exemple, l'ensemble de ces propriétés aura une valeur de '0'.</p> -<h4 id="Propri.C3.A9t.C3.A9s_des_.C3.A9v.C3.A9nements_de_position_de_la_souris" name="Propri.C3.A9t.C3.A9s_des_.C3.A9v.C3.A9nements_de_position_de_la_souris">Propriétés des événements de position de la souris</h4> -<p>Toutefois, tous les événements de la souris disposent des propriétés contenant les coordonnées de la position de la souris lors du déclenchement de l'événement. Il y a deux jeux de coordonnées. Le premier jeu définit les propriétés <code><a href="/fr/DOM/event.screenX" title="fr/DOM/event.screenX">screenX</a></code> et <code><a href="/fr/DOM/event.screenY" title="fr/DOM/event.screenY">screenY</a></code> mesurées depuis le coin supérieur gauche de l'écran. Le second jeu, <code><a href="/fr/DOM/event.clientX" title="fr/DOM/event.clientX">clientX</a></code> et <code><a href="/fr/DOM/event.clientY" title="fr/DOM/event.clientY">clientY</a></code>, est calculé à partir du coin supérieur gauche du document. Voici un exemple qui affiche les coordonnées courantes de la souris :</p> -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advevents_4.xul">Voir</a></p> -<pre><script> - -function updateMouseCoordinates(event){ - var text = "X:" + event.clientX + " Y:" + event.clientY; - document.getElementById("xy").value = text; -} -</script> - -<label id="xy"/> -<hbox width="400" height="400" onmousemove="updateMouseCoordinates(event);"/> -</pre> -<p>Dans cet exemple, les dimensions de la boîte ont été fixées explicitement pour que l'effet soit plus visible. Le gestionnaire d'événement récupère les propriétés <code><a href="/fr/DOM/event.clientX" title="fr/DOM/event.clientX">clientX</a></code> et <code><a href="/fr/DOM/event.clientY" title="fr/DOM/event.clientY">clientY</a></code> et les convertit en une chaîne (string). Cette chaîne est affectée à la propriété <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> du libellé. Notez que l'argument 'event' doit être passé à la fonction <code>updateMouseCoordinates</code>. Si vous déplacez rapidement la souris autour de la bordure, vous noterez que les coordonnées ne s'arrêtent généralement pas exactement sur '400'. Ceci s'explique car l'événement 'mousemove' se déclenche selon un intervalle dépendant de la vitesse de déplacement de la souris, et celle-ci s'est généralement déplacée au-delà de la bordure avant le lancement de l'événement suivant. Évidement, il ne serait pas judicieux d'envoyer un événement 'mousemove' sur chacun des pixels parcourus par la souris.</p> -<h4 id="Coordonn.C3.A9es_relatives_.C3.A0_un_.C3.A9l.C3.A9ment" name="Coordonn.C3.A9es_relatives_.C3.A0_un_.C3.A9l.C3.A9ment">Coordonnées relatives à un élément</h4> -<p>Souvent, ce sont les coordonnées relatives à l'élément qui a déclenché l'événement que vous voulez obtenir, pas celles relatives à la fenêtre entière. Pour y parvenir, il vous suffit de soustraire la position de l'élément à la position de l'événement, comme dans le code suivant.</p> -<pre>var element = event.target; -var elementX = event.clientX - element.boxObject.x; -var elementY = event.clientY - element.boxObject.y; -</pre> -<p>Les éléments XUL ont un objet de boîte accessible en utilisant la propriété <code>boxObject</code>. Nous en apprendrons plus sur l'objet de boîte dans <a href="/fr/Tutoriel_XUL/Les_objets_boîtes" title="fr/Tutoriel_XUL/Les_objets_boîtes">une section ultérieure</a>, mais sachez qu'il contient des informations sur l'affichage de l'élément, incluant notamment ses coordonnées horizontales (x) et verticales (y). Dans cet exemple de code, ces coordonnées sont soustraites de celles de l'événement pour obtenir la position relative de l'élément XUL.</p> -<h3 id=".C3.89v.C3.A9nements_de_chargement" name=".C3.89v.C3.A9nements_de_chargement">Événements de chargement</h3> -<p>L'événement de chargement est envoyé au document (l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>) dès que le fichier XUL a fini son chargement et juste avant que son contenu ne soit affiché. Cet événement est couramment utilisé pour initialiser les champs et réaliser d'autres tâches qui doivent être exécutées avant que l'utilisateur ne dispose de la fenêtre. Vous devriez utiliser un événement de chargement pour faire ce genre de chose plutôt que d'ajouter un script de niveau supérieur extérieur à une fonction. Cette préconisation tient au fait que les éléments XUL peuvent ne pas être chargés ou ne pas être totalement initialisés, ce qui peut entraîner des dysfonctionnements. Pour utiliser un événement de chargement, placez l'attribut <code id="a-onload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onload">onload</a></code> sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Appelez du code à l'intérieur du gestionnaire de chargement afin d'initialiser l'interface si nécessaire.</p> -<p>Il existe également un événement <code id="a-unload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/unload">unload</a></code> qui est appelé dès que la fenêtre est fermée ou, dans un contexte de navigation, lorsque la page bascule vers une autre URL. Vous pouvez utiliser cet événement, par exemple, pour sauvegarder des informations modifiées.</p> -<hr> -<p>Nous verrons ensuite comment ajouter des raccourcis clavier.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_de_gestionnaires_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Raccourcis_clavier">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_dans_une_pile/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_dans_une_pile/index.html deleted file mode 100644 index 5a940e4ff2..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_dans_une_pile/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Positionnement dans une pile -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Positionnement_dans_une_pile -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Stack_Positioning ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Piles_et_Paquets" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Onglets">Suivant »</a></p> -</div> -<p>Cette section va décrire comment positionner des éléments dans une pile (stack).</p> -<h3 id="Placement_des_enfants_d.27une_pile" name="Placement_des_enfants_d.27une_pile">Placement des enfants d'une pile</h3> -<p>Normalement, les éléments enfants d'une pile s'étirent pour s'ajuster à la dimension de la pile. Toutefois, vous pouvez aussi placer ces enfants à des coordonnées précises. Par exemple, si la pile a deux boutons comme enfants, l'un d'eux peut être placé à 20 pixels du bord gauche et 50 pixels du bord supérieur. Le second bouton peut être placé à 100 pixels du bord gauche et 5 pixels du bord supérieur.</p> -<p>La position d'un élément enfant doit être précisée en plaçant deux attributs sur chaque élément. Pour le positionnement horizontal, utilisez l'attribut <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> et pour le positionnement vertical, utilisez l'attribut <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>. Si vous ne mettez pas ces attributs sur un enfant de la pile, celui-ci va s'étirer pour s'ajuster à la dimension de la pile.</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_bulletins_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_bulletins_1.xul">Voir</a></p> -<div class="float-right"><img alt="Image:xultu_ex_4_4_1.png" class=" internal" src="/@api/deki/files/1519/=Xultu_ex_4_4_1.png"></div> -<pre><stack> - <button label="Goblins" left="5" top="5"/> - <button label="Trolls" left="60" top="20"/> - <button label="Vampires" left="10" top="60"/> -</stack> -</pre> -<p>La pile <code><a href="/fr/docs/Mozilla/Tech/XUL/stack" title="stack">stack</a></code> contient trois éléments, chacun d'eux est positionné aux coordonnées précisées par les attributs <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> et <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>. Ici, les trois éléments enfants sont des boutons, mais les éléments n'ont pas à être tous du même type. Il peut y avoir n'importe quels éléments, même des boîtes ou d'autres piles.</p> -<p>Les dimensions d'une pile sont déterminées par les positions de ses éléments enfants. La pile aura toujours des dimensions permettant à ses éléments enfants d'être visibles. Ainsi, si vous initialisez l'attribut <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> d'un enfant à la valeur de '400', la pile aura une largeur d'environ 400 pixels plus la largeur de cet élément enfant. Vous pouvez outrepasser cette taille avec des propriétés de style variées telles que <code>width</code> et <code>max-width</code>.</p> -<p>Vous pouvez utiliser un script pour ajuster les valeurs des attributs <code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code> et <code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code> et de ce fait, rendre les éléments mobiles. Les piles présentent l'avantage suivant : lorsqu'un élément positionné de façon absolue change sa position, la position des autres éléments n'est pas affectée. Si vous essayez de déplacer des éléments dans une boîte normale, les autres éléments vont bouger en réaction.</p> -<p>Il est également possible de placer des éléments enfants de telle manière qu'ils se superposent. Lorsque les éléments enfants se dessinent, ils sont affichés dans l'ordre où ils sont apparus dans la pile. De ce fait, le premier enfant d'une pile apparaît en arrière plan, suivi du second et ainsi de suite. Le dernier enfant apparaît au premier plan. Vous pouvez utiliser les fonctions DOM pour modifier l'ordre des éléments.</p> -<p>Lorsqu'ils répondent aux événements de la souris, les éléments au premier plan vont capturer les événements en premier. Cela signifie que si deux boutons se superposent, le bouton au premier plan va capturer le clic de la souris à l'endroit où il couvre l'autre bouton.</p> -<hr> -<p>La prochaine section décrit les onglets, qui sont comme des paquets (deck) mais fournissent leur propre système d'utilisation.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Piles_et_Paquets" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Onglets">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_des_éléments/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_des_éléments/index.html deleted file mode 100644 index f3cdf9ff84..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/positionnement_des_éléments/index.html +++ /dev/null @@ -1,253 +0,0 @@ ---- -title: Positionnement des éléments -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Positionnement_des_éléments -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Element_Positioning ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Le_modèle_de_boîte" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Détails_sur_le_modèle_de_boîte">Suivant »</a></p> -</div> - -<p>Ici nous apprendrons à contrôler la position et la taille d'un élément.</p> - -<h2 id="Positionnement_des_.C3.A9l.C3.A9ments_de_bo.C3.AEte" name="Positionnement_des_.C3.A9l.C3.A9ments_de_bo.C3.AEte">Positionnement des éléments de boîte</h2> - -<p>Jusqu'ici, nous avons appris à placer des éléments horizontalement ou verticalement à l'intérieur d'une boîte. Nous aurons souvent besoin d'un meilleur contrôle sur la position et la taille des éléments à l'intérieur d'une boîte. Pour cela, nous devons d'abord comprendre le fonctionnement d'une boîte.</p> - -<p>La position d'un élément est déterminée par le style de mise en plage de son conteneur. Par exemple, la position d'un bouton dans une boîte horizontale est à droite du bouton précédent, s'il y en a plusieurs. La dimension d'un élément est déterminée par deux facteurs, la place que cet élément cherche à occuper et la taille que vous avez spécifiée. La taille qu'un élément cherche à avoir est déterminée par son contenu. Par exemple, la largeur d'un bouton est déterminée par la quantité de texte à l'intérieur du bouton.</p> - -<p>Un élément sera généralement juste assez large pour les besoins de l'affichage de son contenu, et pas plus large. Quelques éléments, tels que les boîtes de textes, utiliseront une taille par défaut. Une boîte aura la largeur nécessaire à l'affichage des éléments qu'elle contient. Une boîte horizontale contenant trois boutons aura la largeur de ces trois boutons, plus la marge.</p> - -<p>Dans l'image ci-dessous, les deux premiers boutons ont la taille suffisante à l'affichage de leur texte. Le troisième bouton est plus large parce que son contenu est plus grand. La largeur de la boîte contenant les boutons correspond au total des largeurs de ces boutons plus la marge entre eux. La hauteur des boutons est une taille adaptée à l'affichage du texte.</p> - -<p><img alt="Image:xultu_boxstyle1n.png" class="internal" src="/@api/deki/files/1505/=Xultu_boxstyle1n.png"></p> - -<h3 id="Attributs_de_largeur_et_de_hauteur" name="Attributs_de_largeur_et_de_hauteur">Attributs de largeur et de hauteur</h3> - -<p>Vous pourriez avoir besoin de mieux contrôler la taille d'un élément dans une fenêtre. Plusieurs dispositifs vous permettent de contrôler la dimension d'un élément. La méthode la plus rapide est d'ajouter simplement les attributs <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> et <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> sur un élément, un peu comme vous le feriez avec la balise HTML <code>img</code>. Voir l'exemple ci-dessous :</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_1.xul">Voir</a></p> - -<pre><button label="OK" width="100" height="40"/></pre> - -<p>Cependant, il n'est pas recommandé de procéder ainsi. Cette méthode n'est pas vraiment portable et peut ne pas s'adapter à certains thèmes. Une meilleure méthode consiste à utiliser des propriétés de style, dont le fonctionnement est similaire aux feuilles de styles du HTML. Les propriétés CSS suivantes peuvent être utilisées.</p> - -<dl> - <dt><code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </dt> - <dd>Ceci indique la largeur d'un élément.</dd> - <dt><code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> </dt> - <dd>Ceci indique la hauteur d'un élément.</dd> -</dl> - -<p>En plaçant l'une ou l'autre de ces deux propriétés, l'élément sera créé avec cette largeur et cette hauteur. Si vous spécifiez seulement une de ces deux propriétés, l'autre est calculée en fonction de ses propres besoins. La valeur de ces propriétés de style doit être définie par un nombre suivi d'une unité de mesure.</p> - -<h3 id=".C3.89l.C3.A9ments_flexibles" name=".C3.89l.C3.A9ments_flexibles">Éléments flexibles</h3> - -<p>Les dimensions des éléments non flexibles sont assez faciles à calculer. Elles correspondent simplement aux largeurs et de hauteurs spécifiées, ou si ces valeurs ne sont pas définies, elles sont ajustées par défaut au contenu. Pour les éléments flexibles, le calcul est légèrement plus savant.</p> - -<p>Les éléments flexibles sont ceux qui ont un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> dont la valeur est supérieure à 0. Rappelez-vous que les éléments flexibles s'étirent et s'élargissent pour remplacer l'espace vide. Leurs tailles par défaut restent calculées de la même façon que les éléments non flexibles. Considérez l'exemple suivant :</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_2.xul">Voir</a></p> - -<pre><window orient="horizontal" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<box> - <button label="Oui" flex="1"/> - <button label="Non"/> - <button label="Je ne connais pas vraiment cette manière ou l'autre"/> -</box> -</pre> - -<p>La fenêtre apparaîtra initialement comme sur l'image précédente. Les deux premiers boutons seront dimensionnés à une largeur par défaut convenable et le troisième bouton sera plus large parce que son libellé est plus long. Le premier bouton est flexible et les trois éléments ont été placés à l'intérieur d'une boîte. La largeur de la boîte correspondra à la largeur totale des trois boutons (environs 515 pixels dans l'image).</p> - -<p>Si vous augmentez la largeur de la fenêtre, une vérification de la flexibilité des éléments est effectuée afin d'assurer le remplissage de l'espace libre à afficher. Le bouton est le seul élément flexible, mais il ne s'élargira pas plus, parce que la boîte contenant le bouton n'est pas flexible. Un élément inflexible ne change jamais de taille même lorsque de l'espace est disponible, c'est pourquoi le bouton ne s'agrandit pas non plus. Ainsi, le bouton ne pourra pas s'élargir.</p> - -<p>La solution est de rendre la boîte flexible également. De cette façon, quand vous élargirez la fenêtre, de l'espace supplémentaire sera disponible, et la boîte s'élargira alors pour remplir cet espace supplémentaire. Puisque la boîte est plus grande, une plus grande quantité d'espace libre est créée à l'intérieur de celle-ci, et le bouton flexible qu'elle contient s'élargira pour occuper l'espace disponible. Ce processus est répété pour toutes les boîtes présentes, autant de fois que nécessaire.</p> - -<h2 id="R.C3.A9glage_des_tailles_minimales_et_maximales" name="R.C3.A9glage_des_tailles_minimales_et_maximales">Réglage des tailles minimales et maximales</h2> - -<p>Vous pouvez autoriser un élément à être flexible tout en limitant ses dimensions de sorte à certaines valeurs. À l'inverse, vous pouvez définir des dimensions minimales. Ce comportement se définit par les quatre attributs suivants :</p> - -<dl> - <dt><code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code> </dt> - <dd>Ceci indique la largeur minimale que l'élément peut posséder.</dd> - <dt><code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code> </dt> - <dd>Ceci indique la hauteur minimale que l'élément peut posséder.</dd> - <dt><code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code> </dt> - <dd>Ceci indique la largeur minimale que l'élément peut posséder.</dd> - <dt><code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code> </dt> - <dd>Ceci indique la hauteur minimale que l'élément peut posséder.</dd> -</dl> - -<p>Les valeurs sont toujours mesurées en pixels. Vous pouvez également employer les propriétés CSS correspondantes, <code>min-width</code>, <code>min-height</code>, <code>max-width</code> et <code>max-height</code>.</p> - -<p>Ces propriétés ne sont utiles que pour des éléments flexibles. En plaçant une hauteur maximale, par exemple, un bouton extensible s'étirera seulement jusqu'à cette hauteur maximale. Vous pourrez toujours agrandir la fenêtre au-delà de ce point mais la taille du bouton cessera de s'accroître. La boîte dans laquelle le bouton se trouve continuera également à s'agrandir, à moins que vous ne définissiez aussi une hauteur maximale pour la boîte.</p> - -<p>Si deux boutons sont flexibles, ils se partageront normalement tous les deux la quantité d'espace disponible. Si un bouton a une largeur maximale, le second devrait continuer de s'agrandir en prenant tout l'espace restant.</p> - -<p>Si une boîte a une largeur ou une hauteur maximale, les enfants ne peuvent pas se développer au-delà de cette taille maximale. Si une boîte a une largeur ou une taille minimale, les enfants ne peuvent pas rétrécir au-delà de cette taille minimale.</p> - -<h3 id="Exemples_de_r.C3.A9glage_de_largeurs_et_de_hauteurs" name="Exemples_de_r.C3.A9glage_de_largeurs_et_de_hauteurs">Exemples de réglage de largeurs et de hauteurs</h3> - -<pre><button label="1" style="width: 100px;"/> -<button label="2" style="width: 100em; height: 10px;"/> -<button label="3" flex="1" style="min-width: 50px;"/> -<button label="4" flex="1" style="min-height: 2ex; max-width: 100px"/> -<textbox flex="1" style="max-width: 10em;"/> -<description style="max-width: 50px">Ceci est quelque peu ennuyant mais c'est un texte s'étalant simplement.</description> -</pre> - -<dl> - <dt>Exemple 1 </dt> - <dd>Le premier bouton sera affiché avec une largeur de 100 pixels (le <code>px</code> signifie pixels). Vous devez ajouter l'unité, ou la largeur définie sera ignorée.</dd> - <dt>Exemple 2 </dt> - <dd>Le deuxième bouton sera affiché avec une hauteur de dix pixels et une largeur de 100 em (un <code>em</code> correspond à la taille d'un caractère dans la police courante).</dd> - <dt>Exemple 3 </dt> - <dd>Le troisième bouton flexible s'agrandira en se basant sur la taille de la boîte qui le contient. Cependant, le bouton ne rétrécira jamais au-dessous de 50 pixels. D'autres composants flexibles tels que des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/spacers" title="spacers">spacers</a></code> absorberont l'espace restant, brisant ainsi le rapport de flexibilité.</dd> - <dt>Exemple 4 </dt> - <dd>Le quatrième bouton est flexible et n'aura jamais une hauteur inférieure à 2 ex (un <code>ex</code> correspond habituellement à la taille de la lettre x dans la police courante) ou une largeur supérieure à 100 pixels.</dd> - <dt>Exemple 5 </dt> - <dd>Le champ de saisie de texte est flexible mais sa largeur ne sera jamais supérieure à 10 em. Vous employerez souvent les ems quand vous préciserez les tailles des champs de saisie de texte en fonction du texte qu'ils contiennent. Cette unité est utile pour des champs de saisie de texte qui peuvent ainsi s'adapter à la police de caractères utilisée, même si la police est très grande.</dd> - <dt>Exemple 6 </dt> - <dd>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/description" title="description">description</a></code> est limité à 50 pixels en largeur maximale. À l'intérieur, une césure du texte sur la ligne suivante interviendra après 50 pixels.</dd> -</dl> - -<div class="highlight"> -<h3 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h3> - -<p>Ajoutons quelques-uns de ces styles à notre exemple de fenêtre de recherche de fichiers. Nous le ferons de telle manière que le champ de saisie de texte s'étire pour remplir entièrement la fenêtre.</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxstyle.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-boxstyle.xul">Voir</a></p> - -<pre><textbox id="find-text" '''flex="1" style="min-width: 15em;"'''/></pre> - -<div class="float-right"><img alt="Image:xultu_boxstyle1.png" class="internal" src="/@api/deki/files/1504/=Xultu_boxstyle1.png"></div> - -<p>Ici, le champ de saisie de texte a été rendu flexible. De cette façon, il s'agrandira si l'utilisateur change la taille de la fenêtre. C'est utile si l'utilisateur veut saisir une longue chaîne de caractères. En outre, une largeur minimale de 15 em a été définie de sorte que le champ de saisie de texte affiche toujours au moins 15 caractères. Si l'utilisateur redimensionne la fenêtre en diminuant sa taille, le champ de saisie de texte ne se rétrécira pas en-dessous de 15 em. Il sera dessiné comme s'il se prolongait au-delà du bord de la fenêtre. Notez que sur l'image, le champ de saisie de texte s'est étiré de façon à occuper toute la largeur de la fenêtre.</p> -</div> - -<h2 id="Empaquetage_de_bo.C3.AEte" name="Empaquetage_de_bo.C3.AEte">Empaquetage de boîte</h2> - -<p>Nous avons une boîte avec deux éléments enfants, qui ne sont pas flexibles, mais dans la boîte qui est flexible. Par exemple :</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_3.xul">Voir</a></p> - -<pre><box flex="1"> - <button label="Heureux"/> - <button label="Triste"/> -</box> -</pre> - -<p>Si vous redimensionnez la fenêtre, la boîte s'étirera pour s'ajuster à la taille de la fenêtre. Les boutons n'étant pas flexibles, leur largeur ne changera pas. Le résultat est qu'un espace supplémentaire apparaîtra sur le côté droit de la fenêtre, à l'intérieur de la boîte. Cependant, vous pouvez désirer que l'espace supplémentaire apparaisse plutôt sur le côté gauche alors que les boutons restent alignés sur la droite de la fenêtre.</p> - -<p>Vous pouvez réaliser cela en plaçant un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> à l'intérieur de la boîte, mais cela peut rendre le code confus quand vous devez le faire plusieurs fois. Une meilleure solution est d'utiliser l'attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code> sur la boîte. Cet attribut indique comment empaqueter les éléments enfants à l'intérieur d'une boîte. Pour des boîtes orientées horizontalement, il contrôle le positionnement horizontal des enfants. Pour les boîtes orientées verticalement, il contrôle le positionnement vertical des enfants. Vous pouvez utilisez les valeurs suivantes :</p> - -<dl> - <dt>start </dt> - <dd>Ceci positionne les éléments sur le bord gauche pour les boîtes horizontales et sur le bord haut pour les boîtes verticales. C'est la valeur par défaut.</dd> - <dt>center </dt> - <dd>Ceci centre les éléments enfants dans la boîte.</dd> - <dt>end </dt> - <dd>Ceci positionne les éléments sur le bord droit pour les boîtes horizontales et sur le bord bas pour les boîtes verticales.</dd> -</dl> - -<p>L'attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code> s'applique à la boîte contenant les éléments à empaqueter et non aux éléments eux-mêmes.</p> - -<p>Nous pouvons modifier l'exemple précédent pour centrer les éléments de cette façon :</p> - -<p><span id="Exemple_4"><a id="Exemple_4"></a><strong>Exemple 4</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_4.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_4.xul">Voir</a></p> - -<pre><box flex="1" pack="center"> - <button label="Heureux"/> - <button label="Triste"/> -</box> -</pre> - -<p>Maintenant, lorsque la fenêtre est redimensionnée, les boutons sont centrés horizontalement. Comparez ce comportement à celui de l'exemple précédent.</p> - -<h2 id="Alignement_de_bo.C3.AEte" name="Alignement_de_bo.C3.AEte">Alignement de boîte</h2> - -<p>Si vous redimensionnez horizontalement la fenêtre dans l'exemple « Heureux-Triste », la boîte devrait s'élargir. Si vous redimensionnez verticalement la fenêtre, vous noterez que les boutons sont étirés. Ceci est dû à la flexibilité qui est affectée par défaut à l'autre direction.</p> - -<p>Vous pouvez contrôler ce comportement avec l'attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>. Pour les boîtes horizontales, il contrôle le positionnement vertical des enfants. Pour les boîtes verticales, il contrôle le positionnement horizontal des enfants. Les valeurs possibles sont similaires à celles de l'attibut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>.</p> - -<dl> - <dt>start </dt> - <dd>Ceci aligne les éléments le long du bord haut pour les boîtes horizontales et le long du bord gauche pour les boîtes verticales.</dd> - <dt>center </dt> - <dd>Ceci centre les éléments enfants dans la boîte.</dd> - <dt>end </dt> - <dd>Ceci aligne les éléments le long du bord bas pour les boîtes horizontales et le long du bord droit pour les boîtes verticales.</dd> - <dt>baseline </dt> - <dd>Ceci aligne les éléments et le texte. Il est utilisable seulement avec des boîtes horizontales.</dd> - <dt>stretch </dt> - <dd>Cette valeur, affectée par défaut, provoque l'agrandissement des éléments proportionnellement à la taille de la boîte, un peu à la façon d'un élément flexible, mais dans la direction opposée.</dd> -</dl> - -<p>Comme avec l'attribut <code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, l'attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code> s'applique à la boîte contenant les éléments à aligner et non aux éléments eux-mêmes.</p> - -<p>Dans l'exemple ci-dessous, la première boîte aura ses enfants étirés, car c'est le comportement par défaut. La seconde boîte a un attribut <code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, c'est pourquoi ses enfants sont placés au centre.</p> - -<p><span id="Exemple_5"><a id="Exemple_5"></a><strong>Exemple 5</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_5.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_5.xul">Voir</a></p> - -<pre><?xml version="1.0"?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<window id="yesno" title="Question" orient="horizontal" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - - <hbox> - <button label="Oui"/> - <button label="Non"/> - </hbox> - <hbox align="center"> - <button label="Peut-être"/> - <button label="Il se peut"/> - </hbox> - -</window> -</pre> - -<div class="float-right"><img alt="Image:xultu_boxstyle2-b.png" class="internal" src="/@api/deki/files/1506/=Xultu_boxstyle2-b.png"></div> - -<p>Vous pouvez aussi utiliser les propriétés de style <a href="/fr/CSS/-moz-box-pack" title="fr/CSS/-moz-box-pack">-moz-box-pack</a> et <a href="/fr/CSS/-moz-box-pack" title="fr/CSS/-moz-box-pack">-moz-box-align</a> à la place des attributs indiqués.</p> - -<div class="note">Vous pouvez trouver l'<a class="external" href="http://developer.mozilla.org/samples/xultu/examples/aligner.xul">exemple d'alignement de boîte</a> pratique pour tester les différentes propriétés de boîte (<abbr title="Note du Traducteur">NdT</abbr> : vous pouvez aussi voir une <a class="external" href="http://xulfr.org/sources/tutoriel/boite/boite.xul">autre démonstration du même genre sur xulfr</a>).</div> - -<h2 id="Coupure_du_texte_et_des_boutons" name="Coupure_du_texte_et_des_boutons">Coupure du texte et des boutons</h2> - -<p>Vous pouvez potentiellement créer un élément bouton qui contient un libellé plus large que la largeur maximale du bouton. Bien sûr, une solution serait d'augmenter la taille du bouton. Cependant, les boutons (et les autres éléments avec un libellé) ont un attribut spécial appelé <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> qui vous permet d'indiquer de quelle manière le texte doit être traité s'il est trop grand.</p> - -<p>Si le texte est coupé, un point de suspension (…) apparaît sur le bouton où le texte a été enlevé. Quatre valeurs sont valides :</p> - -<dl> - <dt>left </dt> - <dd>Le texte est coupé sur son côté gauche.</dd> - <dt>right </dt> - <dd>Le texte est coupé sur son côté droit.</dd> - <dt>center </dt> - <dd>Le texte est coupé au milieu.</dd> - <dt>none </dt> - <dd>Le texte n'est pas coupé. C'est la valeur par défaut.</dd> -</dl> - -<p>Cet attribut est vraiment utile quand une boîte de dialogue a été conçue pour être utilisable à n'importe quelle taille. L'attribut <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> peut aussi être utilisé avec les autres éléments qui utilisent un attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> en tant que libellé. L'exemple suivant montre l'utilisation de cet attribut :</p> - -<p><span id="Exemple_6"><a id="Exemple_6"></a><strong>Exemple 6</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_6.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_boxstyle_6.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_boxstyle2.png" class="internal" src="/@api/deki/files/1507/=Xultu_boxstyle2.png"></div> - -<pre><button label="Pressez moi, s'il vous plait !" crop="right" flex="1"/></pre> - -<p>Notez comment le texte sur le bouton voit son côté droit coupé si la fenêtre est réduite.</p> - -<hr> -<p>Dans la prochaine section, nous ferons un petit résumé et décrirons quelques détails supplémentaires concernant le modèle de boîte.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Le_modèle_de_boîte" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Détails_sur_le_modèle_de_boîte">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/raccourcis_clavier/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/raccourcis_clavier/index.html deleted file mode 100644 index 861c0450d0..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/raccourcis_clavier/index.html +++ /dev/null @@ -1,377 +0,0 @@ ---- -title: Raccourcis clavier -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Raccourcis_clavier -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Keyboard_Shortcuts ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_sur_les_gestionnaires_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Focus_et_Selection">Suivant »</a></p> -</div> - -<p>Pour réagir aux touches pressées, vous pouvez utiliser des gestionnaires d'événements clavier, mais il serait fastidieux de le faire pour chaque bouton ou chaque item de menu.</p> - -<h3 id="Cr.C3.A9ation_d.27un_raccourci_clavier" name="Cr.C3.A9ation_d.27un_raccourci_clavier">Création d'un raccourci clavier</h3> - -<p>XUL fournit des méthodes par lesquelles vous pouvez définir des raccourcis clavier. Nous avons déjà vu dans <a href="/fr/Tutoriel_XUL/Barres_de_menus_simples" title="fr/Tutoriel_XUL/Barres_de_menus_simples">la section sur les menus</a> que nous pouvions définir un attribut appelé <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> qui spécifie la touche à presser par l'utilisateur pour activer le menu ou l'item de menu. Dans l'exemple ci-dessous, le menu Fichier peut être sélectionné en pressant <code>Alt</code> et <code>F</code> (ou une autre combinaison de touches spécifique à une plate-forme). Une fois le menu Fichier ouvert, l'item de menu Fermer peut être sélectionné en pressant <code>F</code>.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_keyshort_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_keyshort_1.xul">Voir</a></p> - -<pre><menubar id="sample-menubar"> - <menu id="file-menu" label="Fichier" accesskey="f"> - <menupopup id="file-popup"> - <menuitem id="close-command" label="Fermer" accesskey="f"/> - </menupopup> - </menu> -</menubar> -</pre> - -<p>Vous pouvez aussi utiliser l'attribut <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code> sur les boutons. Dans ce cas, quand la touche est pressée, le bouton est sélectionné.</p> - -<p>Cependant, vous pourriez vouloir mettre en place des raccourcis clavier plus généraux, comme par exemple, la combinaison <code>Ctrl</code>+<code>C</code> pour copier du texte dans le presse-papiers. Bien que de tels raccourcis puissent ne pas être toujours valides, ils fonctionneront habituellement dès qu'une fenêtre est ouverte. Normalement, un raccourci sera autorisé à n'importe quel moment et vous pourrez vérifier via un script s'il doit faire quelque chose. Par exemple, copier du texte dans le presse-papiers ne devrait fonctionner seulement quand du texte est sélectionné.</p> - -<h4 id=".C3.89l.C3.A9ment_key" name=".C3.89l.C3.A9ment_key">Élément <code>key</code></h4> - -<p>XUL fournit un élément, <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code>, qui vous permet de définir un raccourci clavier pour une fenêtre. Il comprend des attributs pour définir la touche qui doit être pressée et quels modificateurs de touches (tels que shift pour <code>Maj</code> ou control pour <code>Ctrl</code>) doivent l'accompagner. Un exemple :</p> - -<pre><keyset> - <key id="sample-key" modifiers="shift" key="R"/> -</keyset> -</pre> - -<p>Cet exemple définit un raccourci clavier qui s'active lorsque l'utilisateur presse les touches <code>Maj</code> et <code>R</code>. L'attribut <code id="a-key"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/key">key</a></code> (notez qu'il a le même nom que l'élément lui-même) est utilisé pour indiquer quelle touche doit être pressée, dans ce cas <code>R</code>. Vous pouvez ajouter n'importe quels caractères à cet attribut selon les combinaisons de touches devant être pressées. Les modificateurs de touches devant être pressés sont indiqués par l'attribut <code id="a-modifiers"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/modifiers">modifiers</a></code>. Il s'agit d'une liste de modificateurs séparée par des espaces, et ils sont décrits ci-dessous :</p> - -<dl> - <dt>'alt' </dt> - <dd>L'utilisateur doit presser la touche <code>Alt</code>. Sous Macintosh, il s'agit de la touche <code>Option</code>.</dd> - <dt>'control' </dt> - <dd>L'utilisateur doit presser la touche <code>Ctrl</code></dd> - <dt>'meta' </dt> - <dd>L'utilisateur doit presser la touche <code>Meta</code>. Il s'agit de la touche <code>Command</code> sous Macintosh.</dd> - <dt>'shift' </dt> - <dd>L'utilisateur doit presser la touche <code>Shift</code> (<code>Maj</code>)</dd> - <dt>'accel' </dt> - <dd>L'utilisateur doit presser la touche spéciale d'accélérateur. L'utilisateur doit presser la touche de raccourci spécifique à sa plate-forme. Il s'agit de la valeur que vous utiliserez habituellement.</dd> -</dl> - -<p>Votre clavier n'a pas forcément toutes ces touches, dans ce cas, elles seront actives par d'autres touches de modification que vous possédez.</p> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> doit être placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/keyset" title="keyset">keyset</a></code>. Cet élément est destiné à contenir un ensemble d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> servant à grouper toutes les définitions de raccourcis dans un seul emplacement du fichier. Tout élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> à l'extérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/keyset" title="keyset">keyset</a></code> ne sera pas pris en compte.</p> - -<p>Généralement, chaque plate-forme utilise une touche différente pour les raccourcis clavier. Par exemple, Windows utilise la touche <code>Ctrl</code> tandis que Macintosh utilise la touche <code>Command</code>. Il serait peu commode de définir un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> propre à chaque plate-forme. Heureusement, il y a une solution, le modificateur de touches 'accel' se réfère à la touche de raccourci spécifique à la plate-forme. Il fonctionne exactement comme les autres modificateurs de touches excepté qu'il change selon la plate-forme.</p> - -<p>Voici quelques exemples supplémentaires :</p> - -<pre><keyset> - <key id="copy-key" modifiers="control" key="C"/> - <key id="explore-key" modifiers="control alt" key="E"/> - <key id="paste-key" modifiers="accel" key="V"/> -</keyset> -</pre> - -<h4 id="Attribut_XULAttrkeycode" name="Attribut_XULAttrkeycode">Attribut <code id="a-keycode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/keycode">keycode</a></code></h4> - -<p>L'attribut <code id="a-key"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/key">key</a></code> est utilisé pour spécifier quelles touches doivent être pressées. Toutefois, il y aura aussi des cas où vous voudrez spécifier des touches qui ne peuvent être décrites par un simple caractère (telle que la touche <code>Enter</code> ou les touches de fonctions). L'attribut <code id="a-key"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/key">key</a></code> peut seulement être utilisé pour des caractères imprimables. Un autre attribut, <code id="a-keycode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/keycode">keycode</a></code> peut être utilisé pour les caractères non imprimables.</p> - -<p>La valeur de l'attribut <code id="a-keycode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/keycode">keycode</a></code> doit être un code spécial qui représente la touche souhaitée. Une liste de touches est disponible ci-dessous. Toutes les touches ne sont pas disponibles sur toutes les plate-formes.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td>VK_CANCEL</td> - <td>VK_BACK</td> - <td>VK_TAB</td> - <td>VK_CLEAR</td> - </tr> - <tr> - <td>VK_RETURN</td> - <td>VK_ENTER</td> - <td>VK_SHIFT</td> - <td>VK_CONTROL</td> - </tr> - <tr> - <td>VK_ALT</td> - <td>VK_PAUSE</td> - <td>VK_CAPS_LOCK</td> - <td>VK_ESCAPE</td> - </tr> - <tr> - <td>VK_SPACE</td> - <td>VK_PAGE_UP</td> - <td>VK_PAGE_DOWN</td> - <td>VK_END</td> - </tr> - <tr> - <td>VK_HOME</td> - <td>VK_LEFT</td> - <td>VK_UP</td> - <td>VK_RIGHT</td> - </tr> - <tr> - <td>VK_DOWN</td> - <td>VK_PRINTSCREEN</td> - <td>VK_INSERT</td> - <td>VK_DELETE</td> - </tr> - <tr> - <td>VK_0</td> - <td>VK_1</td> - <td>VK_2</td> - <td>VK_3</td> - </tr> - <tr> - <td>VK_4</td> - <td>VK_5</td> - <td>VK_6</td> - <td>VK_7</td> - </tr> - <tr> - <td>VK_8</td> - <td>VK_9</td> - <td>VK_SEMICOLON</td> - <td>VK_EQUALS</td> - </tr> - <tr> - <td>VK_A</td> - <td>VK_B</td> - <td>VK_C</td> - <td>VK_D</td> - </tr> - <tr> - <td>VK_E</td> - <td>VK_F</td> - <td>VK_G</td> - <td>VK_H</td> - </tr> - <tr> - <td>VK_I</td> - <td>VK_J</td> - <td>VK_K</td> - <td>VK_L</td> - </tr> - <tr> - <td>VK_M</td> - <td>VK_N</td> - <td>VK_O</td> - <td>VK_P</td> - </tr> - <tr> - <td>VK_Q</td> - <td>VK_R</td> - <td>VK_S</td> - <td>VK_T</td> - </tr> - <tr> - <td>VK_U</td> - <td>VK_V</td> - <td>VK_W</td> - <td>VK_X</td> - </tr> - <tr> - <td>VK_Y</td> - <td>VK_Z</td> - <td>VK_NUMPAD0</td> - <td>VK_NUMPAD1</td> - </tr> - <tr> - <td>VK_NUMPAD2</td> - <td>VK_NUMPAD3</td> - <td>VK_NUMPAD4</td> - <td>VK_NUMPAD5</td> - </tr> - <tr> - <td>VK_NUMPAD6</td> - <td>VK_NUMPAD7</td> - <td>VK_NUMPAD8</td> - <td>VK_NUMPAD9</td> - </tr> - <tr> - <td>VK_MULTIPLY</td> - <td>VK_ADD</td> - <td>VK_SEPARATOR</td> - <td>VK_SUBTRACT</td> - </tr> - <tr> - <td>VK_DECIMAL</td> - <td>VK_DIVIDE</td> - <td>VK_F1</td> - <td>VK_F2</td> - </tr> - <tr> - <td>VK_F3</td> - <td>VK_F4</td> - <td>VK_F5</td> - <td>VK_F6</td> - </tr> - <tr> - <td>VK_F7</td> - <td>VK_F8</td> - <td>VK_F9</td> - <td>VK_F10</td> - </tr> - <tr> - <td>VK_F11</td> - <td>VK_F12</td> - <td>VK_F13</td> - <td>VK_F14</td> - </tr> - <tr> - <td>VK_F15</td> - <td>VK_F16</td> - <td>VK_F17</td> - <td>VK_F18</td> - </tr> - <tr> - <td>VK_F19</td> - <td>VK_F20</td> - <td>VK_F21</td> - <td>VK_F22</td> - </tr> - <tr> - <td>VK_F23</td> - <td>VK_F24</td> - <td>VK_NUM_LOCK</td> - <td>VK_SCROLL_LOCK</td> - </tr> - <tr> - <td>VK_COMMA</td> - <td>VK_PERIOD</td> - <td>VK_SLASH</td> - <td>VK_BACK_QUOTE</td> - </tr> - <tr> - <td>VK_OPEN_BRACKET</td> - <td>VK_BACK_SLASH</td> - <td>VK_CLOSE_BRACKET</td> - <td>VK_QUOTE</td> - </tr> - <tr> - <td>VK_HELP</td> - <td> </td> - <td> </td> - <td> </td> - </tr> - </tbody> -</table> - -<p>Par exemple, pour créer un raccourci qui est activé quand l'utilisateur presse les touches <code>Alt</code> et <code>F5</code>, faites ainsi :</p> - -<pre><keyset> - <key id="test-key" modifiers="alt" keycode="VK_F5"/> -</keyset> -</pre> - -<p>L'exemple ci-dessous montre quelques raccourcis clavier supplémentaires :</p> - -<pre><keyset> - <key id="copy-key" modifiers="accel" key="C"/> - <key id="find-key" keycode="VK_F3"/> - <key id="switch-key" modifiers="control alt" key="1"/> -</keyset> -</pre> - -<p>Le premier raccourci est déclenché lorsque l'utilisateur presse la touche de raccourci spécifique à sa plate-forme et <code>C</code>. Le deuxième est invoqué quand l'utilisateur presse <code>F3</code>. Le troisième se déclenche sur une pression des touches <code>Ctrl</code>, <code>Alt</code> et <code>1</code>. Si vous voulez distinguer les touches de la partie centrale du clavier et les touches du pavé numérique, utilisez les touches VK_NUMPAD (telles que 'VK_NUMPAD1').</p> - -<div class="note">Consultez la page anglaise <a class="external" href="http://www.mozilla.org/access/keyboard/">Mozilla Keyboard Planning FAQ and Cross Reference</a> pour de plus amples informations sur les raccourcis clavier dans les applications.</div> - -<h3 id="Utilisation_des_raccourcis_clavier" name="Utilisation_des_raccourcis_clavier">Utilisation des raccourcis clavier</h3> - -<p>Maintenant que nous savons comment définir les raccourcis clavier, nous allons découvrir comment les utiliser. Il y a deux manières. La première est la plus simple et requiert seulement que vous utilisiez le gestionnaire d'événements clavier sur l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code>. Quand l'utilisateur presse la (ou les) touche(s), le script est invoqué. Voici un exemple :</p> - -<pre><keyset> - <key id="copy-key" modifiers="accel" key="C" oncommand="DoCopy();"/> -</keyset> -</pre> - -<p>La fonction <code>DoCopy</code> sera appelée quand l'utilisateur pressera les touches spécifiées par l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> qui sont, dans cet exemple, les touches pour copier vers le presse-papiers (telles que <code>Ctrl</code>+<code>C</code>). Ceci fonctionnera tant que la fenêtre sera ouverte. La fonction <code>DoCopy</code> devrait vérifier si du texte est sélectionné et le copier dans le presse-papiers si tel est le cas. Notez que les champs de saisie intègrent déjà des raccourcis pour utiliser le presse-papiers, de sorte que vous n'avez pas besoin de les implémenter vous-même.</p> - -<h4 id="Assignation_d.27un_raccourci_clavier_.C3.A0_un_menu" name="Assignation_d.27un_raccourci_clavier_.C3.A0_un_menu">Assignation d'un raccourci clavier à un menu</h4> - -<p>Si vous assignez un raccourci clavier à une commande qui existe déjà dans un menu, vous pouvez associer directement l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> avec la commande du menu. Pour cela, ajoutez un attribut <code id="a-key"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/key">key</a></code> à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>. Donnez lui comme valeur l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du raccourci que vous voulez lui associer. L'exemple ci-dessous explique cette méthode.</p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_keyshort_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_keyshort_2.xul">Voir</a></p> - -<div class="float-right"><img alt="Image:xultu_keyshort1.jpg" class="internal" src="/@api/deki/files/1526/=Xultu_keyshort1.jpg"></div> - -<pre><keyset> - <key id="paste-key" modifiers="accel" key="V" - oncommand="alert('invoque Coller')"/> -</keyset> - -<menubar id="sample-menubar"> - <menu id="edit-menu" label="Editer" accesskey="e"> - <menupopup id="edit-popup"> - <menuitem id="paste-command" - accesskey="c" key="paste-key" - label="Coller" oncommand="alert('invoque Coller')"/> - </menupopup> - </menu> -</menubar> -</pre> - -<p>L'attribut <code id="a-key"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/key">key</a></code> de l'item du menu, qui est ici 'paste-key', est égal à l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du raccourci défini. Vous pouvez utilisez cette méthode pour définir des raccourcis supplémentaires à plusieurs items de menu.</p> - -<p>Vous noterez également dans cette image que du texte a été placé à côté de la commande 'Coller' du menu pour indiquer le raccourci <code>Ctrl</code>+<code>V</code> pouvant être pressé pour invoquer la commande du menu. Cette indication est ajoutée automatiquement pour vous sur la base des touches de modification de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code>. Les raccourcis associés aux menus fonctionneront même si le menu n'est pas ouvert.</p> - -<p>Une fonctionnalité supplémentaire des définitions de raccourcis est que vous pouvez les désactivez facilement. Il vous suffit d'ajouter un attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> et lui affecter la valeur 'true'. Cet attribut désactive le raccourci clavier de façon à ce qu'il ne puisse pas être invoqué. Il est facile de modifier l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> par le biais d'un script.</p> - -<div class="highlight"> -<h3 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h3> - -<p>Ajoutons des raccourcis clavier à la boîte de dialogue de recherche de fichiers. Nous en ajouterons quatre, un pour chacune des commandes Couper, Copier et Coller, et aussi un pour la commande Fermer quand l'utilisateur presse <code>Esc</code></p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-keyshort.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-keyshort.xul">Voir</a></p> - -<pre class="eval"><span class="highlightred"><keyset> <key id="cut_cmd" modifiers="accel" key="X"/> <key id="copy_cmd" modifiers="accel" key="C"/> <key id="paste_cmd" modifiers="accel" key="V"/> <key id="close_cmd" keycode="VK_ESCAPE" oncommand="window.close();"/> </keyset></span> - -<vbox flex="1"> - <toolbox> - <menubar id="findfiles-menubar"> - <menu id="file-menu" label="Fichier" accesskey="f"> - <menupopup id="file-popup"> - <menuitem label="Ouvrir une recherche..." accesskey="o"/> - <menuitem label="Sauver une recherche..." accesskey="s"/> - <menuseparator/> - <menuitem label="Fermer" accesskey="c" <span class="highlightred">key="close_cmd"</span> - oncommand="window.close();"/> - </menupopup> - </menu> - <menu id="edit-menu" label="Editer" accesskey="e"> - <menupopup id="edit-popup"> - <menuitem label="Couper" accesskey="e" <span class="highlightred">key="cut_cmd"</span>/> - <menuitem label="Copier" accesskey="p" <span class="highlightred">key="copy_cmd"</span>/> - <menuitem label="Coller" accesskey="l" <span class="highlightred">key="paste_cmd"</span> disabled="true"/> - </menupopup> - </menu> -</pre> -Maintenant nous pouvons utiliser ces raccourcis pour activer les commandes. Évidemment les commandes du presse-papiers restent inactives puisque nous n'avons pas encore écrit leurs scripts.</div> - -<h3 id=".C3.89v.C3.A9nements_Clavier" name=".C3.89v.C3.A9nements_Clavier">Événements Clavier</h3> - -<p>Il y a trois types d'événements clavier qui peuvent être utilisés si les dispositifs principaux décrits ci-dessus ne sont pas appropriés.</p> - -<dl> - <dt><code>keypress</code> </dt> - <dd>Appelé quand une touche est pressée puis relachée avec l'élement qui a le focus (élément actif). Vous pouvez l'utiliser pour controller les caractères saisis dans un champ.</dd> - <dt><code>keydown</code> </dt> - <dd>Appelé quand une touche est pressée avec l'élément qui a le focus (élément actif). Remarquez que l'évènement sera appelé aussitôt la touche enfoncée, même si elle n'a pas été encore relachée.</dd> - <dt><code>keyup</code> </dt> - <dd>Appelé quand une touche est relachée avec l'élément qui a le focus (élément actif).</dd> -</dl> - -<p>Les évènements clavier sont envoyés seulement à l'élément qui a le focus. Typiquement, ils incluent les champs de saisie, les boutons, les cases à cocher, et d'autres encore. Si aucun des éléments n'est actif, l'événement sera dirigé vers le document XUL lui-même. Dans ce cas, vous pouvez associer un scrutateur d'événements à la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>. Cependant, si vous voulez réagir aux événements de manière globale, vous devriez utiliser un raccourci clavier comme décrit plus haut.</p> - -<p>L'<a href="/fr/DOM/event" title="fr/DOM/event">objet event</a> a deux propriétés qui contiennent la touche pressée. La propriété <code><a href="/fr/DOM/event.keyCode" title="fr/DOM/event.keyCode">keyCode</a></code> contient le code de la touche qui peut être comparé à une des constantes de la table des codes de touche vue plus tôt dans cette section. La propriété <code><a href="/fr/DOM/event.charCode" title="fr/DOM/event.charCode">charCode</a></code> est utilisée pour les caractères imprimables et contient le caractère de la touche pressée.</p> - -<hr> -<p>Dans la prochaine section, nous allons découvrir comment gérer le focus et la sélection.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Plus_sur_les_gestionnaires_d'évènements" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Focus_et_Selection">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/règles_avançées/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/règles_avançées/index.html deleted file mode 100644 index 8916f1e816..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/règles_avançées/index.html +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: Règles avançées -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Règles_avançées -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Advanced_Rules ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Sources_de_données_RDF" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Données_persistantes">Suivant »</a></p> -</div> - -<p>Cette section décrit la syntaxe des règles les plus complexes.</p> - -<h3 id="La_syntaxe_des_r.C3.A8gles_compl.C3.A8tes" name="La_syntaxe_des_r.C3.A8gles_compl.C3.A8tes">La syntaxe des règles complètes</h3> - -<p>La syntaxe des règles décrites jusqu'ici est utile pour certaines sources de données, mais parfois les données doivent être affichées de manière plus sophistiquée. La syntaxe de règle simple n'est en fait qu'un raccourci pour la syntaxe de règle complète qui est décrite ci-dessous. Comme pour la syntaxe de règle simple, la règle complète est placée entre des balises <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>.</p> - -<p>Une syntaxe de règle complète contient trois balises filles : une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/conditions" title="conditions">conditions</a></code> , une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code> et une balise <code><a href="/fr/docs/Mozilla/Tech/XUL/action" title="action">action</a></code>. La balise <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code> n'est pas toujours nécessaire.</p> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/conditions" title="conditions">conditions</a></code> spécifie le critère qui doit correspondre à une ressource donnée. Vous pouvez spécifier plusieurs conditions qui doivent toutes correspondre à la ressource donnée. En utilisant la syntaxe de règle simple, les conditions sont directement placées dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>.</p> - -<p>Si les conditions correspondent à une ressource donnée, le contenu placé entre les balises <code><a href="/fr/docs/Mozilla/Tech/XUL/action" title="action">action</a></code> est généré. Dans la syntaxe de règle simple, le contenu est directement placé dans la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code>.</p> - -<h3 id="Conditions_d.27une_r.C3.A8gle" name="Conditions_d.27une_r.C3.A8gle">Conditions d'une règle</h3> - -<p>Lorsque qu'un arbre, un menu ou tout autre élément avec une source de données génère son contenu, le générateur de modèle cherche en premier lieu la ressource marquée par l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>. L'opération est ensuite répétée pour l'ensemble des ressources filles. Le générateur compare chaque ressource aux conditions. Si celles-ci sont vérifiées, le contenu de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/action" title="action">action</a></code> est généré pour ces ressources. Si elles ne sont pas vérifiées, rien n'est généré.</p> - -<h4 id=".C3.89l.C3.A9ment_content" name=".C3.89l.C3.A9ment_content">Élément <code>content</code></h4> - -<p>L'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/conditions" title="conditions">conditions</a></code> contient trois sous-éléments. Le premier est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> qui ne doit être présent qu'une seule fois. Il sert de marqueur lorsque le générateur de modèle parcourt les ressources. Il indique le nom de la variable dans laquelle est placée une référence à la ressource racine pendant que les conditions sont analysées. La ressource racine est indiquée par l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> dans l'élément contenant le modèle.</p> - -<p>La syntaxe d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> est la suivante :</p> - -<pre><content uri="?var"/></pre> - -<p>La point d'interrogation indique que le texte qui suit est une variable. Vous pouvez alors utiliser la variable <code>var</code> dans le reste des conditions. Bien entendu, vous pouvez nommer la variable comme vous le voulez.</p> - -<h4 id=".C3.89l.C3.A9ment_member" name=".C3.89l.C3.A9ment_member">Élément <code>member</code></h4> - -<p>L'élément suivant est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/member" title="member">member</a></code> qui est utilisé pour parcourir un ensemble de ressources filles. En termes RDF, il est comparable à <code>Seq</code>, <code>Bag</code> ou <code>Alt</code>. Imaginons que vous ayez une liste de villes, comme dans l'extrait RDF/XML suivant :</p> - -<pre><RDF:Seq about="http://www.xulplanet.com/rdf/weather/cities"> - <RDF:li resource="http://www.xulplanet.com/rdf/weather/city/Paris"/> - <RDF:li resource="http://www.xulplanet.com/rdf/weather/city/Manchester"/> - <RDF:li resource="http://www.xulplanet.com/rdf/weather/city/Melbourne"/> - <RDF:li resource="http://www.xulplanet.com/rdf/weather/city/Kiev"/> -</RDF:Seq> - -<RDF:Description about="http://www.xulplanet.com/rdf/weather/city/Paris"> - <cityset:name>Paris</cityset:name> -</RDF:Description> - -. -. -. -</pre> - -<p>Vous voulez afficher une ligne dans une arborescence pour chaque ville. Pour accomplir cela, utilisez l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/member" title="member">member</a></code> comme ceci :</p> - -<pre><tree id="citiesTree" datasources="weather.rdf" - ref="http://www.xulplanet.com/rdf/weather/cities"> - <template> - <rule> - <conditions> - <content uri="?list"/> - <member container="?list" child="?city"/> - </conditions> - <rule> - <template> -</tree> -</pre> - -<p>Le générateur de modèle commence par récupérer la valeur de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> qui dans ce cas est '<span class="nowiki">http://www.xulplanet.com/rdf/weather/cities</span>'. Cette ressource va être mise dans la variable <code>list</code> comme il est indiqué par la balise <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code>. Vous obtiendrez les ressources associées à la ressource racine en utilisant la variable <code>list</code>.</p> - -<p>Le générateur de modèle s'intéresse ensuite à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/member" title="member">member</a></code>. Le générateur est contraint de parcourir les fils d'un élément. Le parent est indiqué par l'attribut <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> et les fils par l'attribut <code id="a-child"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/child">child</a></code>. Dans l'exemple ci-dessus, la valeur de l'attribut <code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code> est la variable <code>list</code>. Ainsi le parent sera la valeur de la variable <code>list</code> qui a la valeur de la ressource racine '<span class="nowiki">http://www.xulplanet.com/rdf/weather/cities</span>'. L'effet induit va être de parcourir la liste de tous les fils de '<span class="nowiki">http://www.xulplanet.com/rdf/weather/cities</span>'.</p> - -<p>Si vous regardez en détail le RDF ci-dessus, la ressource '<span class="nowiki">http://www.xulplanet.com/rdf/weather/cities</span>' a quatre filles, une pour chaque ville. Le générateur de modèle parcourt chacune d'elle, comparant la fille avec la valeur de l'attribut <code id="a-child"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/child">child</a></code>. Dans le cas présent, celui-ci contient la valeur 'city'. Donc le générateur va donner à la variable <code>city</code> la valeur des ressources filles au fur et à mesure.</p> - -<p>Comme il n'y a pas d'autres conditions, la condition correspond à chacune des quatre ressources et le générateur va créer du contenu pour chacune d'entre elles. Bien sûr, l'exemple ci-dessus n'a aucun contenu. On l'ajoutera par la suite.</p> - -<h4 id=".C3.89l.C3.A9ment_triple" name=".C3.89l.C3.A9ment_triple">Élément <code>triple</code></h4> - -<p>L'élément suivant est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/triple" title="triple">triple</a></code>. Il est utilisé pour vérifier l'existence d'un triplet (ou assertion) dans la source de données du RDF. Un triplet est comme la propriété d'une ressource. Par exemple, un triplet existe entre un marque-page et son URL associée. Il peut-être exprimé ainsi :</p> - -<pre>Un marque-page vers mozilla.org -> URL -> www.mozilla.org</pre> - -<p>Cela signifie qu'il existe un triplet entre le marque-page 'Un marque-page vers mozilla.org' et 'www.mozilla.org' par la propriété <code>URL</code>. La première partie est appelée le sujet, la seconde, le prédicat, et la dernière, l'objet. Exprimé avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/triple" title="triple">triple</a></code>, ce mécanisme est décrit comme ceci :</p> - -<pre><triple subject="A Bookmark to mozilla.org" - predicate="URL" - object="www.mozilla.org"/> -</pre> - -<p>Ce code a été simplifié par rapport au code réel. Le prédicat devrait normalement inclure les espaces de nommage, et le sujet devrait être l'identifiant ressource du marque-page, et non pas le titre du marque-page comme ici. En fait, le titre du marque-page devrait être un autre triplet dans la source de données, qui utiliserait le prédicat 'nom'.</p> - -<p>Vous pouvez remplacer le sujet et l'objet dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/triple" title="triple">triple</a></code> par des références aux variables, auquel cas les valeurs seront substituées aux variables. Si aucune valeur n'est définie pour une variable, le générateur de modèle va attribuer à la variable la valeur de la source de données.</p> - -<p>Disons, par exemple, que l'on veuille ajouter une prédiction météo à la source de données des villes. Les conditions suivantes peuvent être utilisées :</p> - -<pre><conditions> - <content uri="?list"/> - <member container="?list" child="?city"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#prediction" - object="?pred"/> -</conditions> -</pre> - -<p>Le générateur de modèle va parcourir chaque ville comme précédemment. Lorsqu'il arrivera au triplet, il va s'intéresser aux assertions de la source de données RDF pour une prédiction météo. La prédiction météo est attribuée à la variable 'pred'. Le générateur va répéter cette opération pour chacune des quatre villes. Une comparaison a lieu et le générateur va créer du contenu pour chaque ville qui a une prédiction météo associée. Si la ville n'a pas de ressource de prédiction, la condition ne correspond pas et aucun contenu ne sera créé pour cette ville. Remarquez que vous n'avez pas besoin de mettre 'rdf:' au début du prédicat, car il est sous-entendu.</p> - -<p>On peut aussi remplacer l'attribut <code id="a-object"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/object">object</a></code> par une valeur statique. par exemple :</p> - -<pre><conditions> - <content uri="?city"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#prediction" - object="Nuageux"/> -</conditions> -</pre> - -<p>Cet exemple est similaire mais nous spécifions que nous voulons une comparaison qui s'effectue sur « 'Nuageux' ». Le résultat obtenu est que la condition ne sera remplie que pour les villes dont la prédiction météo est « 'Nuageux' ».</p> - -<p>Nous pouvons ajouter davantage de triplets pour réaliser d'autres comparaisons. Par exemple, dans l'exemple ci-dessus, la température et la vitesse du vent peuvent être testées. Pour cela, il suffit d'ajouter un autre triplet qui vérifiera les ressources supplémentaires. La condition sera remplie si et seulement si l'intégralité des triplets retournent des valeurs.</p> - -<p>L'exemple ci-dessous va vérifier un triplet supplémentaire appliqué au nom de la ville. Il lui sera attribué une variable <code>name</code>. La condition va correspondre si la ville possède à la fois un nom et une prédiction météo.</p> - -<pre><conditions> - <content uri="?list"/> - <member container="?list" child="?city"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#name" - object="?name"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#prediction" - object="?pred"/> -</conditions> -</pre> - -<h3 id="G.C3.A9n.C3.A9rer_du_contenu" name="G.C3.A9n.C3.A9rer_du_contenu">Générer du contenu</h3> - -<p>Le contenu à générer pour une règle est spécifié dans l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/action" title="action">action</a></code>. Il peut être le contenu des lignes d'un arbre, des items de menu ou tout ce que vous souhaitez générer. À l'intérieur du contenu, vous pouvez vous référer aux variables qui ont été définies dans les conditions. Ainsi, dans l'exemple météo ci-dessus, vous pouvez utiliser les variables <code>name</code> ou <code>pred</code> pour afficher la ville ou la prédiction météo. Vous pouvez aussi utiliser les variables <code>list</code> ou <code>city</code>, mais elles contiennent des ressources et non du texte, donc elles n'auront pas de sens pour les utilisateurs.</p> - -<p>Dans la syntaxe de règle simple, la syntaxe <code>uri="rdf:*"</code> est utilisée pour indiquer où le contenu doit être généré. Dans la syntaxe de règles complètes, vous appliquez la valeur de l'attribut <code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code> à une variable que l'on a utilisée dans la partie des conditions. Normalement, ce sera la variable assignée à l'attribut <code id="a-child"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/child">child</a></code> de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/member" title="member">member</a></code>.</p> - -<h4 id="Exemple_complet_d.27arbre" name="Exemple_complet_d.27arbre">Exemple complet d'arbre</h4> - -<p>L'exemple suivant montre un arbre complet avec des conditions et une action. Vous pouvez consulter le fichier RDF séparément (<a href="https://developer.mozilla.org/samples/xultu/examples/weather.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/weather.rdf">RDF</a>).</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advrules_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_advrules_1.xul">Voir</a></p> - -<pre><tree id="weatherTree" flex="1" datasources="weather.rdf" - ref="http://www.xulplanet.com/rdf/weather/cities"> - <treecols> - <treecol id="city" label="Ville" primary="true" flex="1"/> - <treecol id="pred" label="Prédiction Météo" flex="1"/> - </treecols> - - <template> - <rule> - <conditions> - <content uri="?list"/> - <member container="?list" child="?city"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#name" - object="?name"/> - <triple subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#prediction" - object="?pred"/> - </conditions> - <action> - <treechildren> - <treeitem uri="?city"> - <treerow> - <treecell label="?name"/> - <treecell label="?pred"/> - </treerow> - </treeitem> - </treechildren> - </action> - </rule> - </template> -</tree> -</pre> - -<p>Deux colonnes apparaissent dans cet arbre, l'une qui affiche la valeur de 'name' pour chacun ligne, et l'autre qui affiche le résultat de la prédiction météo.</p> - -<div class="note">Si vous utilisez le marqueur 'dont-build-content' (ne-pas-générer-de-contenu) sur un arbre, remplacez l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/content" title="content">content</a></code> par un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code></div> - -<h3 id="Ajouter_des_liaisons_suppl.C3.A9mentaires" name="Ajouter_des_liaisons_suppl.C3.A9mentaires">Ajouter des liaisons supplémentaires</h3> - -<p>Le dernier élément que vous pouvez ajouter à l'intérieur d'une règle est l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/bindings" title="bindings">bindings</a></code>. À l'intérieur de celui-ci, vous pouvez mettre un ou plusieurs éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/binding" title="binding">binding</a></code>. Une liaison dans une règle a la même syntaxe qu'un triplet et remplit quasiment la même fonction. Par exemple, dans l'exemple météo précédent, on peut ajouter la liaison suivante :</p> - -<pre><bindings> - <binding subject="?city" - predicate="http://www.xulplanet.com/rdf/weather#temperature" - object="?temp"/> -</bindings> -</pre> - -<p>La liaison va prendre la ressource "température" de chaque ville et l'attribuer à la variable <code>temp</code>. C'est tout à fait similaire à ce qu'un triplet accomplit. La différence réside dans le fait que la liaison créée par le binding n'est pas prise en compte dans la vérification des conditions. Ainsi, pour qu'une ville soit affichée, il est impératif qu'elle ait un nom et une prédiction météo, mais peu importe qu'elle ait ou non une température. Si toutefois elle en possède une, la valeur sera attribuée à la variable <code>temp</code> et pourra être utilisée dans une action. Si une ville n'a pas de température, la variable <code>temp</code> sera une chaîne de caractère vide.</p> - -<hr> -<p>Par la suite, nous verrons comment sauvegarder les états des éléments XUL.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Sources_de_données_RDF" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Données_persistantes">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/sources_de_données_rdf/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/sources_de_données_rdf/index.html deleted file mode 100644 index 27240972a3..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/sources_de_données_rdf/index.html +++ /dev/null @@ -1,296 +0,0 @@ ---- -title: Sources de données RDF -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Sources_de_données_RDF -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/RDF_Datasources ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Arbres_et_Gabarits" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Règles_avançées">Suivant »</a></p> -</div> - -<p>Nous nous intéresserons ici aux sources de données additionnelles, ainsi qu'à la manière d'utiliser vos propres fichiers <abbr title="Resource Description Framework">RDF</abbr> comme sources de données.</p> - -<h3 id="Autres_sources_de_donn.C3.A9es_pour_Mozilla" name="Autres_sources_de_donn.C3.A9es_pour_Mozilla">Autres sources de données pour Mozilla</h3> - -<p>Mozilla fournit nativement plusieurs sources de données. Certaines sont indiquées ici, avec quelques exemples. Leur fonctionnement est très similaire à celui des marque-pages, bien que les champs soient différents à chaque fois.</p> - -<div class="note"><abbr title="Note du traducteur">Ndt</abbr> : Les ressources RDF fournies par mozilla ne sont utilisables que par les applications qui sont enregistrées dans le chrome. Vous ne verrez donc pas les données dans certains des exemples proposés.</div> - -<h3 id="La_liste_d.27historique_de_navigation" name="La_liste_d.27historique_de_navigation">La liste d'historique de navigation</h3> - -<p>Cette source de données fournit l'accès à la liste d'historique de l'utilisateur, qui est une liste d'<abbr title="Uniform Resource Locator">URL</abbr>s que l'utilisateur a consulté récemment. On peut se référer à cette ressource en utilisant <code>rdf:history</code> comme source de données. La table ci-dessous montre les ressources (ou champs) que vous pouvez récupérer depuis la source de donnée "history". Utilisez les <abbr title="Uniform Resource Locator">URL</abbr>s ci-dessous là où vous souhaitez que la valeur de la ressource soit utilisée.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td>Date</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Date</span></td> - <td>Date de la dernière visite</td> - </tr> - <tr> - <td>Name</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Name</span></td> - <td>Titre de la page</td> - </tr> - <tr> - <td>Page</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Page</span></td> - <td>Nom de la page</td> - </tr> - <tr> - <td>Referrer</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Referrer</span></td> - <td>Page d'origine (referrer)</td> - </tr> - <tr> - <td>URL</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#URL</span></td> - <td>URL de la page</td> - </tr> - <tr> - <td>Visit Count</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#VisitCount</span></td> - <td>Nombre de visites de la page</td> - </tr> - </tbody> -</table> - -<p>Une liste d'historique typique affichera un arbre doté d'une sélection de ces champs. Pour les utiliser, placez les URL ci-dessus dans l'attribut <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> des boutons ou des cellules d'un arbre. Vous pouvez utiliser 'NC:HistoryRoot' comme valeur de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>. Vous pouvez également utiliser la valeur 'NC:HistoryByDate' pour obtenir la liste d'historique triée par jour.</p> - -<h4 id="Exemple_d.27utilisation_de_la_liste_historique" name="Exemple_d.27utilisation_de_la_liste_historique">Exemple d'utilisation de la liste historique</h4> - -<p>Voyons un exemple d'affichage de la liste d'historique. Nous afficherons l'historique dans un arbre avec les trois colonnes Nom, URL et Date.</p> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_1.xul">Voir</a></p> - -<pre><tree flex="1" datasources="rdf:history" ref="NC:HistoryRoot"> - - <treecols> - <treecol id="name" label="Nom" flex="1"/> - <treecol id="url" label="URL" flex="1"/> - <treecol id="date" label="Date" flex="1"/> - </treecols> - - <template> - - <rule> - <treechildren> - <treeitem uri="rdf:*"> - <treerow> - <treecell label="rdf:http://home.netscape.com/NC-rdf#Name"/> - <treecell label="rdf:http://home.netscape.com/NC-rdf#URL"/> - <treecell label="rdf:http://home.netscape.com/NC-rdf#Date"/> - </treerow> - </treeitem> - </treechildren> - </rule> - - </template> -</tree> -</pre> - -<h3 id="Autres_sources_de_donn.C3.A9es" name="Autres_sources_de_donn.C3.A9es">Autres sources de données</h3> - -<p>Les tableaux ci-dessous listent quelques-unes des autres sources de données disponibles avec Mozilla. Vous pouvez les utiliser comme vous voulez.</p> - -<p><strong>Marque-pages ('rdf:bookmarks') :</strong></p> - -<p>Les marque-pages sont générés depuis la liste de marque-pages de l'utilisateur.</p> - -<p><br> - <strong>Ressources</strong></p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td>Date d'ajout</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#BookmarkAddDate</span></td> - <td>Date à laquelle le marque-page a été ajouté</td> - </tr> - <tr> - <td>Description</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Description</span></td> - <td>Description du marque-page</td> - </tr> - <tr> - <td>Dernière modification</td> - <td><span class="nowiki">rdf:http://home.netscape.com/WEB-rdf#LastModifiedDate</span></td> - <td>Date de la dernière modification</td> - </tr> - <tr> - <td>Dernière visite</td> - <td><span class="nowiki">rdf:http://home.netscape.com/WEB-rdf#LastVisitDate</span></td> - <td>Date de la dernière visite</td> - </tr> - <tr> - <td>Nom</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Name</span></td> - <td>Nom du marque-page</td> - </tr> - <tr> - <td>Raccourci URL</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#ShortcutURL</span></td> - <td>Champ de mots-clés personnalisés</td> - </tr> - <tr> - <td>URL</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#URL</span></td> - <td>L'URL vers laquelle pointe le lien</td> - </tr> - </tbody> -</table> - -<p><strong>Racines possibles pour les marque-pages</strong></p> - -<dl> - <dt>'NC</dt> - <dd>BookmarksRoot' : La racine de la hiérarchie des marque-pages</dd> -</dl> - -<p> </p> - -<dl> - <dt>'NC</dt> - <dd>IEFavoritesRoot' : Le dossier de marque-pages correspondant aux « Favoris IE » de l'utilisateur</dd> -</dl> - -<p> </p> - -<dl> - <dt>'NC</dt> - <dd>PersonalToolbarFolder' : Le dossier de marque-pages correspondant au dossier de la barre d'outils personnelle</dd> -</dl> - -<p><strong>Fichiers('rdf:files') :</strong></p> - -<p>Une vue des fichiers de l'utilisateur.</p> - -<p><strong>Ressources</strong></p> - -<table class="donneestuto"> - <tbody> - <tr> - <td>Nom</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#Name</span></td> - <td>Nom du fichier</td> - </tr> - <tr> - <td>URL</td> - <td><span class="nowiki">rdf:http://home.netscape.com/NC-rdf#URL</span></td> - <td>URL du fichier</td> - </tr> - </tbody> -</table> - -<p><strong>Racine possible des fichiers</strong></p> - -<dl> - <dt>'NC</dt> - <dd>FilesRoot' : Racine du système de fichiers (habituellement une liste de disques)</dd> -</dl> - -<p> </p> - -<dl> - <dt>'URL d'un fichier' </dt> - <dd>En utilisant une URL de fichier pour l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, vous pouvez choisir un répertoire/dossier à retourner. Par exemple, vous pouvez utiliser <a class="external" rel="freelink">file:///windows</a> ou <a class="external" rel="freelink">file:///usr/local</a></dd> -</dl> - -<p>La source de données de fichiers est un exemple de source de données qui ne détermine ses ressources que lorsque cela est nécessaire. Nous ne voulons pas que tous les fichiers du système de fichiers soient évalués avant d'afficher les données. Seuls nous intéressent les fichiers et répertoires que l'arbre (ou tout autre élément) doit afficher à un instant donné.</p> - -<h3 id="Sources_de_donn.C3.A9es_composites" name="Sources_de_donn.C3.A9es_composites">Sources de données composites</h3> - -<p>Vous pouvez spécifier plusieurs sources de données dans l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code> en les séparant par des espaces, comme dans l'exemple ci-dessous. Les données seront ainsi lues dans toutes les sources de données mentionnées.</p> - -<pre><tree datasources="rdf:bookmarks rdf:history animals.rdf" ref="NC:BookmarksRoot"></pre> - -<p>Cet exemple lit les ressources des marque-pages, de l'historique et d'un fichier nommé 'animals.rdf'. Celles-ci sont combinées en une source de données composite et peuvent être utilisées comme une unique source de données.</p> - -<p>La source de donnée spéciale <code>rdf:null</code> correspond à une source vide. Vous pouvez utiliser cette source de données si vous voulez gérer dynamiquement la source via un script, sans avoir à l'initialiser tout de suite ou parce que vous ne connaissez pas son URL exacte.</p> - -<h3 id="Sources_de_donn.C3.A9es_RDF_personnalis.C3.A9es" name="Sources_de_donn.C3.A9es_RDF_personnalis.C3.A9es">Sources de données RDF personnalisées</h3> - -<p>Vous pouvez utiliser chacune des sources de données internes ci-dessus si vous le désirez. Il en existe plusieurs autres, pour le courrier électronique, les carnets d'adresses, les recherches... Cependant, vous pouvez utiliser votre propre source de données RDF, enregistrée dans un fichier RDF. Le fichier peut être local ou distant. Il suffit d'indiquer l'URL du fichier RDF dans l'attribut <code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>.</p> - -<p>L'utilisation des fichiers RDF apporte les mêmes fonctionnalités que n'importe quelle source de données interne. Vous pouvez utiliser des règles pour retrouver un type spécifique de contenu. Les attributs de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/rule" title="rule">rule</a></code> seront respectés s'ils correspondent aux attributs d'un élément RDF <code>Description</code>. Vous pouvez également créer des fichiers RDF hiérarchiques.</p> - -<h4 id="Exemple_d.27utilisation_d.27un_fichier_RDF" name="Exemple_d.27utilisation_d.27un_fichier_RDF">Exemple d'utilisation d'un fichier RDF</h4> - -<p>Ce qui suit est un exemple d'utilisation d'un fichier RDF comme source de données. Le fichier RDF est relativement gros et peut être consulté séparément : <a href="https://developer.mozilla.org/samples/xultu/examples/animals.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/animals.rdf">RDF</a></p> - -<p><span id="Exemple_2"><a id="Exemple_2"></a><strong>Exemple 2</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_2.xul">Voir</a></p> - -<pre><tree flex="1" width="200" height="200" - datasources="animals.rdf" ref="http://www.some-fictitious-zoo.com/all-animals"> - - <treecols> - <treecol id="name" label="Nom" primary="true" flex="1"/> - <treecol id="species" label="Espèces" flex="1"/> - </treecols> - - <template> - <rule> - <treechildren> - <treeitem uri="rdf:*"> - <treerow> - <treecell label="rdf:http://www.some-fictitious-zoo.com/rdf#name"/> - <treecell label="rdf:http://www.some-fictitious-zoo.com/rdf#species"/> - </treerow> - </treeitem> - </treechildren> - </rule> - - </template> -</tree> -</pre> - -<p><img alt="Image:xultu_datasrc1.png" class="internal" src="/@api/deki/files/1518/=Xultu_datasrc1.png"></p> - -<p>Ici, les données sont générées depuis le fichier RDF. L'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> a été positionné sur l'élément racine de ce fichier, qui est la balise de premier niveau <code>Seq</code>. Nous obtenons une liste complète d'animaux. Si nous avions voulu, nous aurions pu positionner l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> sur n'importe quelle valeur de l'attribut <code id="a-about"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/about">about</a></code> afin de limiter la quantité de données retournées. Par exemple, pour afficher seulement les reptiles, nous pouvons utiliser la valeur '<span class="nowiki">http://www.some-fictitious-zoo.com/reptiles</span>'.</p> - -<h4 id="Exemple_de_d.C3.A9finition_de_l.27attribut_XULAttrref" name="Exemple_de_d.C3.A9finition_de_l.27attribut_XULAttrref">Exemple de définition de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code></h4> - -<p>L'exemple ci-dessous montre comment afficher des éléments particuliers d'une source de données RDF en définissant l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>.</p> - -<p><span id="Exemple_3"><a id="Exemple_3"></a><strong>Exemple 3</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_3.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_datasrc_3.xul">Voir</a></p> - -<pre><window - id="example-window" - title="Mammifères du zoo" - xmlns:ANIMALS="http://www.some-fictitious-zoo.com/rdf#" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - -<button label="Cliquez ici pour voir les mammifères du zoo" type="menu" - datasources="animals.rdf" ref="http://www.some-fictitious-zoo.com/mammals"> - <template> - <rule ANIMALS:specimens="0"></rule> - <rule> - <menupopup> - <menuitem uri="rdf:*" label="rdf:http://www.some-fictitious-zoo.com/rdf#name"/> - </menupopup> - </rule> - </template> -</button> - -</window> -</pre> - -<p>Dans le cas présent, nous voulons seulement la liste des mammifères, nous sélectionnons donc l'URI de la liste des mammifères. Vous remarquerez que la valeur de l'attribut <code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code> de notre exemple est '<span class="nowiki">http://www.some-fictitious-zoo.com/mammals</span>', ce qui correspond à l'un des éléments <code>Seq</code> du fichier RDF. Seuls les descendants de cette liste seront retournés.</p> - -<p>Nous avons utilisé deux règles ici. La première filtre toutes les ressources dont l'attribut <code>ANIMALS:specimen</code> est positionné à '0'. Vous pouvez voir cet attribut dans le fichier RDF pour chacun des éléments <code>Description</code>. Certains d'entre eux ont une valeur de '0'. Dans ce cas, la première règle s'applique. Puisque cette règle n'a pas de contenu, rien ne sera affiché pour les éléments concernés. Ainsi, nous pouvons cacher les données que nous ne voulons pas afficher.</p> - -<p>La seconde règle s'applique aux autres ressources et crée une rangée dans un menu surgissant. Le résultat final est un menu surgissant contenant tous les mammifères dont le spécimen n'est pas positionné à '0'.</p> - -<hr> -<p>Dans la prochaine section, nous examinerons la syntaxe des règles complètes.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Arbres_et_Gabarits" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Règles_avançées">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/styler_un_arbre/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/styler_un_arbre/index.html deleted file mode 100644 index 641cb8199e..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/styler_un_arbre/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Styler un arbre -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Styler_un_arbre -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Styling_a_Tree ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajouter_des_feuilles_de_style" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Modification_du_thème_par_défaut">Suivant »</a></p> -</div> -<p>Cette section explique comment styler un arbre.</p> -<h3 id="Styler_l.27arbre" name="Styler_l.27arbre">Styler l'arbre</h3> -<p>Vous pouvez styler la bordure de l'arbre et les en-têtes de colonnes de la même manière que pour d'autres éléments. Les styles ajoutés à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> seront appliqués à l'arbre entier. L'ajout d'un style à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> ne l'applique pas à la colonne mais seulement à son en-tête.</p> -<p>Le corps de l'arbre doit être stylé d'une manière un peu différente des autres éléments, parce que le corps de l'arbre est stocké d'une manière différente des autres éléments. Le <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> extérieur est le seul vrai élément du corps de l'arbre. Les éléments intérieurs n'ont qu'un rôle de conteneurs.</p> -<h4 id="D.C3.A9finition_de_propri.C3.A9t.C3.A9s" name="D.C3.A9finition_de_propri.C3.A9t.C3.A9s">Définition de propriétés</h4> -<p>Vous devez donc utiliser l'attribut <code id="a-properties"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/properties">properties</a></code> sur les lignes ou les cellules pour modifier une ou plusieurs propriétés nommées. Cet attribut peut être utilisé avec des arbres à contenu statique, <a href="/fr/Tutoriel_XUL/Arbres_et_Gabarits" title="fr/Tutoriel_XUL/Arbres_et_Gabarits">produit par RDF</a> ou avec <a href="/fr/Tutoriel_XUL/Vues_d'arbre_personnalisées" title="fr/Tutoriel_XUL/Vues_d'arbre_personnalisées">des arbres à vue personnalisée</a>. Supposons que nous voulions donner une couleur de fond bleue à une ligne particulière, comme il est possible de le remarquer sur les libellés dans la messagerie de Mozilla. Nous allons utiliser une propriété appelée 'makeItBlue'. Vous pouvez utiliser le nom que vous voulez. Vous pouvez modifier plusieurs propriétés en les séparant par des espaces.</p> -<p>Modifiez la propriété sur une ligne ou une cellule, comme dans l'exemple suivant :</p> -<pre><treerow properties="makeItBlue"></pre> -<h4 id="S.C3.A9lecteurs_CSS_pour_l.27arbre" name="S.C3.A9lecteurs_CSS_pour_l.27arbre">Sélecteurs CSS pour l'arbre</h4> -<p>La feuille de styles peut récupérer cette propriété et l'utiliser pour changer l'apparence d'une ligne pour les messages non lus ou les libellés. Les propriétés fonctionnent en quelque sorte comme les classes de style, bien qu'elles nécessitent une syntaxe un peu plus complexe à utiliser dans une feuille de styles. En effet, il est possible de spécifier un style pour chaque partie d'une cellule. Vous pouvez styler non seulement la cellule et son texte, mais aussi le "twisty" (<abbr title="Note du traducteur">NdT</abbr> : petit '+' ou '-' permettant de développer et replier l'arborescence) et l'indentation. La syntaxe à utiliser est la suivante :</p> -<pre>treechildren::-moz-tree-row(makeItBlue) -{ - background-color: blue; -} -</pre> -<p>Ce pseudo-style spécial est utilisé pour styler la couleur de fond des lignes qui ont la propriété 'makeItBlue'. Cette syntaxe spéciale est nécessaire parce que les cellules elles-mêmes ne sont pas des éléments séparés. Tout le contenu intérieur au corps de l'arbre obtient son rendu par l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code>. Cependant, CSS dispose d'un concept pour accéder aux parties des éléments en les considérant comme des pseudo-éléments. Ce sélecteur correspond à quelques lignes de l'arbre à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> comme pseudo-élément. Le pseudo-style définit des règles de style pour des parties particulières de ce qu'il affiche. Cette règle de style signifie, dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> : mettre une couleur de fond bleue à toutes les lignes de l'arbre qui ont la propriété 'makeItBlue'.</p> -<p>Le texte '::-moz-tree-row' spécifie quelle est la zone de contenu désirée, qui est dans ce cas une ligne. Vous pouvez aussi utiliser les valeurs suivantes :</p> -<dl> <dt><code>::-moz-tree-cell</code> </dt> <dd>une cellule. Utilisez ceci pour modifier les couleurs des bordures et du fond.</dd> <dt><code>::-moz-tree-cell-text</code> </dt> <dd>le texte d'une cellule. Utilisez ceci pour modifier la police et la couleur du texte.</dd> <dt><code>::-moz-tree-twisty</code> </dt> <dd>l'apparence du "twisty" utilisé pour développer et replier les lignes filles.</dd> <dt><code>::-moz-tree-image</code> </dt> <dd>l'image pour une cellule. Vous pouvez indiquer l'image avec la propriété <a href="/fr/CSS/list-style-image" title="fr/CSS/list-style-image">list-style-image</a>.</dd> <dt><code>::-moz-tree-row</code> </dt> <dd>une ligne. Utilisez ceci pour choisir la couleur de fond d'une ligne.</dd> <dt><code>::-moz-tree-indentation</code> </dt> <dd>l'indentation à gauche des lignes filles.</dd> <dt><code>::-moz-tree-column</code> </dt> <dd>une colonne.</dd> <dt><code>::-moz-tree-line</code> </dt> <dd>les lignes dessinées pour connecter les lignes filles aux lignes parentes.</dd> <dt><code>::-moz-tree-separator</code> </dt> <dd>un séparateur dans un arbre.</dd> <dt><code>::-moz-tree-progressmeter</code> </dt> <dd>contenu pour des cellules à indicateur de progression. Vous pouvez créer une colonne avec des indicateurs de progression en mettant l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> de la colonne à 'progressmeter'.</dd> <dt><code>::-moz-tree-drop-feedback</code> </dt> <dd>le retour du glisser-déposer.</dd> <dt><code>::-moz-tree-checkbox</code> </dt> <dd>l'image à utiliser pour les colonnes de case à cocher.</dd> -</dl> -<p>Vous pouvez tester la présence de plusieurs propriétés en les séparant par des virgules. L'exemple ci-dessous met une couleur de fond grise aux lignes qui ont les propriétés 'readonly' et 'unread'. Pour les propriétés qui sont 'readonly', il ajoute une bordure rouge autour de la ligne. Notez que la première règle s'appliquera à toute ligne qui est 'readonly', peu importe la présence d'autres propriétés comme 'unread'.</p> -<pre>treechildren::-moz-tree-row(readonly) -{ - border: 1px solid red; -} -treechildren::-moz-tree-row(readonly, unread) -{ - background-color: rgb(80%, 80%, 80%); -} -</pre> -<h4 id="Propri.C3.A9t.C3.A9s_par_d.C3.A9faut" name="Propri.C3.A9t.C3.A9s_par_d.C3.A9faut">Propriétés par défaut</h4> -<p>La liste des propriétés des éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code> contient un petit nombre de propriétés par défaut que vous pouvez aussi utiliser dans une feuille de styles. Vous pouvez utiliser ces propriétés supplémentaires pour modifier l'apparence des conteneurs ou des lignes sélectionnées. Les propriétés suivantes sont modifiées automatiquement en cas de besoin :</p> -<dl> <dt><code id="a-focus"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/focus">focus</a></code></dt> <dd>cette propriété est mise si l'arbre a le focus.</dd> <dt><code id="a-selected"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/selected">selected</a></code></dt> <dd>cette propriété est mise pour les lignes ou les cellules actuellement sélectionnées.</dd> <dt><code id="a-current"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/current">current</a></code></dt> <dd>cette propriété est mise si le curseur est sur la ligne. Seule une ligne à la fois peut avoir cette propriété.</dd> <dt><code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code></dt> <dd>cette propriété est mise pour les lignes ou les cellules qui ont des lignes filles.</dd> <dt><code id="a-leaf"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/leaf">leaf</a></code></dt> <dd>cette propriété est mise pour les lignes ou les cellules qui n'ont pas de lignes filles.</dd> <dt><code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code></dt> <dd>cette propriété est mise pour les lignes ou les cellules qui sont développées.</dd> <dt><code id="a-closed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/closed">closed</a></code></dt> <dd>cette propriété est mise pour les lignes ou les cellules qui sont repliées.</dd> <dt><code id="a-primary"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/primary">primary</a></code></dt> <dd>cette propriété est mise pour les cellules de la colonne primaire.</dd> <dt><code id="a-sorted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sorted">sorted</a></code></dt> <dd>cette propriété est mise pour les cellules de la colonne actuellement triées.</dd> <dt><code id="a-even"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/even">even</a></code></dt> <dd>cette propriété est mise pour les lignes paires.</dd> <dt><code id="a-odd"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/odd">odd</a></code></dt> <dd>cette propriété est mise pour les lignes impaires. Cette propriété ainsi que la propriété <code id="a-even"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/even">even</a></code> vous permettent, par exemple, d'alterner les couleurs entre chaque ligne.</dd> <dt><code id="a-dragSession"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dragSession">dragSession</a></code></dt> <dd>cette propriété est mise si quelque chose est en train d'être déplacé.</dd> <dt><code id="a-dropOn"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dropOn">dropOn</a></code></dt> <dd>si un déplacement a lieu au-dessus de l'arbre, cette propriété est mise pour la ligne en train d'être survolée par le déplacement, tant que le pointeur de la souris est au-dessus de la ligne.</dd> <dt><code id="a-dropBefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dropBefore">dropBefore</a></code></dt> <dd>cette propriété est mise si le pointeur de la souris survole avant la ligne en cours de déplacement.</dd> <dt><code id="a-dropAfter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dropAfter">dropAfter</a></code></dt> <dd>cette propriété est mise si le pointeur de la souris survole après la ligne en cours de déplacement.</dd> <dt><code id="a-progressNormal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/progressNormal">progressNormal</a></code></dt> <dd>cette propriété est mise pour les cellules à indicateur de progression.</dd> <dt><code id="a-progressUndetermined"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/progressUndetermined">progressUndetermined</a></code></dt> <dd>cette propriété est mise pour les cellules à indicateur de progression indéterminé.</dd> <dt><code id="a-progressNone"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/progressNone">progressNone</a></code></dt> <dd>cette propriété est mise pour les cellules sans indicateur de progression.</dd> -</dl> -<p>Les propriétés sont mises pour les lignes ou les cellules d'une ligne à l'état correspondant. Pour les colonnes et les cellules, une propriété additionnelle, l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de la colonne ou la colonne dans laquelle est la cellule, sera mise.</p> -<h4 id="D.C3.A9finition_des_propri.C3.A9t.C3.A9s_pour_les_arbres_g.C3.A9n.C3.A9r.C3.A9s_par_RDF" name="D.C3.A9finition_des_propri.C3.A9t.C3.A9s_pour_les_arbres_g.C3.A9n.C3.A9r.C3.A9s_par_RDF">Définition des propriétés pour les arbres générés par RDF</h4> -<p>Pour <a href="/fr/Tutoriel_XUL/Sources_de_données_RDF" title="fr/Tutoriel_XUL/Sources_de_données_RDF">les arbres générés par RDF</a>, vous pouvez utiliser la même syntaxe. Cependant, vous affecterez souvent les propriétés en vous basant sur des valeurs de la source de données.</p> -<h4 id="D.C3.A9finition_des_propri.C3.A9t.C3.A9s_pour_les_vues_personnalis.C3.A9es" name="D.C3.A9finition_des_propri.C3.A9t.C3.A9s_pour_les_vues_personnalis.C3.A9es">Définition des propriétés pour les vues personnalisées</h4> -<p>Pour des arbres avec un script de vue personnalisée, vous pouvez modifier des propriétés en fournissant les fonctions <code>getRowProperties()</code>, <code>getColumnProperties()</code> et <code>getCellProperties()</code> dans la vue. Elles renvoient des informations à propos d'une ligne, d'une colonne et d'une cellule individuelle. Les arguments à ces fonctions indiquent quelle ligne et/ou colonne. Le dernier argument de chacune de ces fonctions est une liste de propriétés que la vue est supposée remplir avec une liste de propriétés. La fonction <code>getColumnProperties()</code> fournit aussi l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> correspondant pour la colonne.</p> -<pre>getRowProperties : function(row,prop){} -getColumnProperties : function(column,columnElement,prop){} -getCellProperties : function(row,column,prop){} -</pre> -<p>Regardons un exemple de modification d'une cellule spécifique. Rendons le texte bleu une ligne sur quatre, en utilisant l'exemple d'<a href="/fr/Tutoriel_XUL/Vues_d'arbre_personnalisées" title="fr/Tutoriel_XUL/Vues_d'arbre_personnalisées">une section précédente</a>. Nous allons avoir besoin d'ajouter du code à la fonction <code>getCellProperties()</code> pour ajouter une propriété 'makeItBlue' aux cellules toutes les quatres lignes (Nous n'utilisons pas <code>getRowProperties()</code> puisque la couleur du texte ne sera pas héritée dans chaque cellule).</p> -<p>L'objet <code>properties</code> qui est passé en dernier argument de <code>getCellProperties()</code> est un objet <a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a> qui implémente <code>nslSupportsArray</code>. Il s'agit en fait une version XPCOM d'un tableau. Il contient une fonction <code>AppendElement()</code> qui peut être utilisée pour ajouter un élément au tableau. Nous pouvons utiliser l'interface <code>nslAtomService</code> pour construire des atomes de chaînes pour les propriétés.</p> -<pre>getCellProperties: function(row,col,props){ - if ((row %4) == 0){ - var aserv=Components.classes["@mozilla.org/atom-service;1"]. - getService(Components.interfaces.nsIAtomService); - props.AppendElement(aserv.getAtom("makeItBlue")); - } -} -</pre> -<p>Cette fonction sera définie comme partie d'un objet de vue. Elle vérifie d'abord quelle ligne est demandée et affecte une propriété pour les cellules toutes les quatres lignes. La liste des propriétés nécessite un tableau d'objets atom qui peuvent être considérés comme des chaînes de caractères constantes. Nous les créons en utilisant l'interface XPCOM <code>nslAtomService</code> et nous les ajoutons au tableau en utilisant la fonction <code>AppendElement()</code>. Ici, nous créons un atome 'makeItBlue'. Vous pouvez appeler <code>AppendElement()</code> à nouveau pour ajouter des propriétés additionnelles.</p> -<h4 id="Exemple_de_feuille_de_styles" name="Exemple_de_feuille_de_styles">Exemple de feuille de styles</h4> -<pre>treechildren::-moz-tree-row(selected) { background-color: #FFFFAA; } -treechildren::-moz-tree-row(odd) { background-color: #EEEEEE; } -treechildren::-moz-tree-row(odd, selected) { background-color: #FFFFAA; } -treechildren::-moz-tree-cell-text(selected) { color: #000000; } -treechildren::-moz-tree-cell-text(odd, selected) { color: #000000; } -</pre> -<hr> -<p>Dans la suite, nous allons voir comment modifier le thème par défaut.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajouter_des_feuilles_de_style" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Modification_du_thème_par_défaut">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/sélection_dans_les_arbres/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/sélection_dans_les_arbres/index.html deleted file mode 100644 index 6aa59a15d8..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/sélection_dans_les_arbres/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Sélection dans les arbres -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Sélection_dans_les_arbres -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Tree_Selection ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Autres_caractéristiques_des_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Vues_d'arbre_personnalisées">Suivant »</a></p> -</div> -<p>Cette section décrit comment obtenir et modifier les items sélectionnés dans un arbre.</p> -<h3 id="R.C3.A9cup.C3.A9rer_les_items_s.C3.A9lectionn.C3.A9s_d.27un_arbre" name="R.C3.A9cup.C3.A9rer_les_items_s.C3.A9lectionn.C3.A9s_d.27un_arbre">Récupérer les items sélectionnés d'un arbre</h3> -<p>Chaque item dans un arbre (qui correspond à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> en utilisant un arbre de contenu) peut être sélectionné individuellement. Si vous ajoutez l'attribut <code id="a-seltype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/seltype">seltype</a></code> à l'arbre en lui attribuant la valeur 'single' , l'utilisateur ne pourra sélectionner qu'une ligne à la fois. Sinon, l'utilisateur pourra sélectionner plusieurs lignes qui ne seront pas nécessairement contiguës. L'arbre fournit plusieurs fonctions qui peuvent être utilisées pour déterminer si un item est sélectionné.</p> -<h4 id="Gestion_de_l.27.C3.A9v.C3.A9nement_de_s.C3.A9lection" name="Gestion_de_l.27.C3.A9v.C3.A9nement_de_s.C3.A9lection">Gestion de l'événement de sélection</h4> -<p>Voyons d'abord comment nous pouvons déterminer qu'un item est sélectionné. Le gestionnaire d'événement <code id="a-onselect"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onselect">onselect</a></code> peut être ajouté à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/tree" title="tree">tree</a></code>. Lorsque l'utilisateur sélectionne un item de l'arbre, le gestionnaire d'événement est appelé. L'utilisateur peut également modifier la sélection en utilisant les touches de déplacement. Si l'utilisateur appuie en continu sur une touche de déplacement afin de se déplacer rapidement dans les items, le gestionnaire d'événement n'est pas appelé jusqu'à ce que l'utilisateur relâche la touche. Ce mode de fonctionnement améliore les performances. Il signifie également que la surbrillance du texte apparaîtra sur plusieurs items même si l'événement de sélection n'est pas déclenché pour ces items.</p> -<p>La syntaxe du gestionnaire d'événement <code id="a-onselect"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onselect">onselect</a></code> est présentée ci-dessous.</p> -<pre><tree id="treeset" onselect="alert('Vous avez sélectionné quelque chose !');"></pre> -<h4 id="Indices_d.27arbre" name="Indices_d.27arbre">Indices d'arbre</h4> -<p>L'arbre possède une propriété <code id="a-currentIndex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/currentIndex">currentIndex</a></code> (index courant, en commençant à '0' pour la première ligne) qui peut être utilisée pour obtenir l'item sélectionné.</p> -<p>Les éléments fils sont inclus dans le comptage juste après leurs parents. Ainsi, s'il y a trois items racines et que chacun a deux items fils, il y aura un total de six objets. Le premier item (d'index '0') sera le premier item racine. L'item suivant, d'index '1', sera son premier fils. Le second fils aura l'index '2', le second item parent sera à la position '3' et ainsi de suite.</p> -<div class="float-right"><img alt="Image:xultu_seltree1.png" class=" internal" src="/@api/deki/files/1544/=Xultu_seltree1.png"></div> -<p>Dans l'image ci-contre, il y a huit lignes affichées, dont deux sont sélectionnées. La première ligne sélectionnée a un index de '4' et la seconde, un index de '7'. Les lignes qui ne sont pas affichées ne sont pas incluses dans le comptage d'index.</p> -<h4 id="S.C3.A9lection_multiple" name="S.C3.A9lection_multiple">Sélection multiple</h4> -<p>Pour les arbres qui permettent une sélection multiple, obtenir la liste des lignes sélectionnées est un peu plus compliqué. La vue de l'arbre a une propriété de sélection qui contient l'information sur les lignes sélectionnées. Cette sélection sera un objet <a class="external" href="http://xulplanet.com/references/objref/TreeSelection.html">TreeSelection</a>. La vue n'a pas besoin d'implémenter cet objet elle-même, car l'arbre aura assigné un objet de sélection à la propriété de sélection de la vue lorsque celle-ci a été attachée à l'arbre. À partir de l'arbre, vous pouvez obtenir la sélection en utilisant la propriété <code>view</code> de l'arbre et ensuite la propriété <code>selection</code> de la vue. Vous pouvez utiliser les méthodes de l'objet de sélection pour récupérer l'ensemble des items sélectionnés ou pour modifier la sélection.</p> -<p>Comme les items sélectionnés dans une sélection multiple ne sont pas nécessairement contigus, vous pouvez récupérer chaque bloc de sélection contiguë en utilisant les fonctions <code>getRangeCount()</code> et <code>getRangeAt()</code>. La première fonction retourne le nombre de plages de sélection effectuées. Si seule une valeur a été sélectionnée, la valeur retournée sera '1'. Vous pourrez alors écrire une boucle sur le nombre de plages, en appelant <code>getRangeAt()</code> pour obtenir les bons index du début et de la fin d'une plage.</p> -<p>La fonction <code>getRangeAt()</code> comporte trois arguments.</p> -<ul> <li>Le premier est la plage d'index.</li> <li>Le deuxième est un objet qui sera rempli par la fonction avec l'index du premier item sélectionné.</li> <li>Le troisième argument est un objet qui sera rempli avec l'index du dernier item sélectionné.</li> -</ul> -<h4 id="Exemple_getRangeAt" name="Exemple_getRangeAt">Exemple <code>getRangeAt</code></h4> -<pre>var start = new Object(); -var end = new Object(); -var numRanges = tree.view.selection.getRangeCount(); - -for (var t = 0; t < numRanges; t++){ - tree.view.selection.getRangeAt(t,start,end); - for (var v = start.value; v <= end.value; v++){ - alert("Item " + v + " sélectionné."); - } -} -</pre> -<p>Nous avons créé deux objets appelés <code>start</code> et <code>end</code>. Ensuite, nous lançons une boucle sur les plages de la sélection dont le nombre a été retourné par la fonction <code>getRangeCount()</code>. La fonction <code>getRangeAt()</code> est appelée avec l'index de la plage, et les objets <code>start</code> et <code>end</code>. Cette fonction renseignera les index <code>start</code> et <code>end</code> en leur attribuant la propriété 'value'. Donc, si la première plage commence au troisième item et se termine au septième, <code>start.value</code> vaudra '2' (souvenez-vous que les index commencent à 0, donc nous en décrémentons de un) et <code>end.value</code> vaudra '6'. Un message d'alerte est affichée pour chaque index.</p> -<p>Si vous souhaitez seulement savoir si une ligne précise a été sélectionnée, vous pouvez utiliser la fonction <code>isSelected()</code>. Elle prend l'index de la ligne en argument et retourne 'true' si la ligne est sélectionnée.</p> -<pre>alert(tree.view.selection.isSelected(3));</pre> -<h3 id="Modifier_la_s.C3.A9lection_dans_un_arbre" name="Modifier_la_s.C3.A9lection_dans_un_arbre">Modifier la sélection dans un arbre</h3> -<p>L'objet de sélection dispose de plusieurs fonctions qui peuvent être utilisées pour changer une sélection. La fonction la plus simple est <code>select()</code> qui dé-sélectionne toutes les lignes actuellement sélectionnées et en sélectionne une spécifique. Par exemple, le code suivant sélectionnera la ligne d'index '5' :</p> -<pre>tree.view.selection.select(5);</pre> -<p>Notez que vous ne devez pas modifier la propriété <code>currentIndex</code> pour changer la sélection. Vous devez plutôt utiliser la fonction de sélection <code>select()</code> comme indiqué dans l'exemple précédent. Vous pouvez sélectionner toutes les lignes avec la fonction <code>selectAll()</code>. Notez que les lignes imbriquées à l'intérieur de containers qui n'ont pas été ouverts ne seront pas sélectionnées. Naturellement, cette fonction n'est valable que pour des arbres à sélections multiples. Il y a aussi les fonctions <code>clearSelection()</code> pour effacer la sélection et <code>invertSelection()</code> pour inverser la sélection, c'est-à-dire dé-sélectionner toutes les lignes sélectionnées et sélectionner les autres.</p> -<p>Pour sélectionner des lignes spécifiques, utiliser la fonction <code>rangedSelect()</code> qui sélectionne toutes les lignes entre deux indices. Voici un exemple de sélection des lignes comprises entre les index '2' et '7'. Notez que les lignes '2' et '7' seront incluses dans la sélection.</p> -<pre>tree.view.selection.rangedSelect(2,7,true);</pre> -<p>L'argument final indique s'il s'agit d'un ajout à la sélection courante. Si la valeur est 'true', la plage sera ajoutée à la sélection courante. Si la valeur est 'false', toutes les lignes préalablement sélectionnées seront préalablement dé-sélectionnées. Finalement, la fonction <code>clearRange()</code> peut être utilisée pour dé-sélectionner une plage de lignes, les lignes en dehors de cette plage n'étant pas affectées.</p> -<pre>tree.view.selection.clearRange(2,7);</pre> -<hr> -<p>Nous allons maintenant apprendre comment créer une vue personnalisée pour un arbre.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Autres_caractéristiques_des_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Vues_d'arbre_personnalisées">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/séparateurs/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/séparateurs/index.html deleted file mode 100644 index cd9b6fda85..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/séparateurs/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Séparateurs -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Séparateurs -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Splitters ---- -<p> </p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Cadres_de_contenu" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Barres_de_défilement">Suivant »</a></p> -</div> -<p>Ici, nous allons voir comment ajouter des séparateurs dans une fenêtre.</p> -<h3 id="D.C3.A9coupage_d.27une_bo.C3.AEte" name="D.C3.A9coupage_d.27une_bo.C3.AEte">Découpage d'une boîte</h3> -<p>Il arrive des fois où vous voulez disposer de deux sections dans une fenêtre que l'utilisateur peut redimensionner à son gré. Un exemple est la fenêtre du navigateur Mozilla, où vous pouvez changer la taille du panneau latéral en déplaçant le trait d'intersection des deux cadres. Vous pouvez aussi cacher ce panneau latéral en cliquant sur la poignée de ce trait.</p> -<h4 id=".C3.89l.C3.A9ment_splitter" name=".C3.89l.C3.A9ment_splitter">Élément <code>splitter</code></h4> -<p>Cette fonctionnalité est accomplie en utilisant un élément appelé <code><a href="/fr/docs/Mozilla/Tech/XUL/splitter" title="splitter">splitter</a></code>. Il crée une barre étroite entre les deux sections en permettant de redimensionner chaque côté. Vous pouvez placer un séparateur où vous voulez pour vous permettre de redimensionner les éléments situés avant lui et les éléments situés après lui dans une même boîte.</p> -<p>Lorsqu'un séparateur est placé à l'intérieur d'une boîte horizontale, il permet un redimensionnement horizontal. Lorsqu'un séparateur est placé à l'intérieur d'une boîte verticale, il permet un redimensionnement vertical.</p> -<p>La syntaxe d'un séparateur est la suivante :</p> -<pre><splitter - id="identifier" - state="open" - collapse="before" - resizebefore="closest" - resizeafter="closest"> -</pre> -<p>Les attributs sont les suivants :</p> -<dl> <dt><code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> </dt> <dd>L'identifiant unique d'un séparateur.</dd> <dt><code id="a-state"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/state">state</a></code> </dt> <dd>Indique l'état d'un séparateur. Mettez lui la valeur 'open', valeur par défaut, pour que le panneau redimensionnable soit initialement ouvert ou mettez lui la valeur 'collapsed' pour qu'un des panneaux soit complètement réduit et que l'autre occupe toute la place.</dd> <dt><code id="a-collapse"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapse">collapse</a></code> </dt> <dd>Il indique de quel côté le panneau doit se réduire quand la poignée du séparateur est cliquée ou quand le séparateur est initialisée avec un état 'collapsed'. Mettez lui la valeur 'before' pour désigner l'élément avant le séparateur ou la valeur 'after' pour désigner l'élément après le séparateur. Si vous l'initialisez avec la valeur 'none', qui est aussi la valeur par défaut, la poignée du séparateur ne réduira pas les panneaux quand elle est cliquée.</dd> <dt><code id="a-resizebefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizebefore">resizebefore</a></code> </dt> <dd>Lorsqu'un séparateur est déplacé, les éléments sur sa gauche sont redimensionnés. Cet attribut indique quel élément est concerné. Mettez la valeur 'closest' pour que l'élément immédiatement à gauche du séparateur soit redimensionné. Mettez la valeur 'farthest' pour que l'élément le plus éloigné à gauche du séparateur soit redimensionné (le premier élément de la boîte). La valeur par défaut est 'closest'.</dd> <dt><code id="a-resizeafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizeafter">resizeafter</a></code> </dt> <dd>Lorsqu'un séparateur est déplacé, les éléments sur sa droite sont redimensionnés. Cet attribut indique quel élément est concerné. Mettez la valeur 'closest' pour que l'élément immédiatement à droite du séparateur soit redimensionné. Mettez la valeur 'farthest' pour que l'élément le plus éloigné à droite du séparateur soit redimensionné (le dernier élément de la boîte). Cet attribut peut aussi avoir la valeur 'grow', dans ce cas, les éléments à droite du séparateur ne changent pas de taille lorsque le séparateur est déplacé. La valeur par défaut est 'closest'.</dd> -</dl> -<p>Si vous employez l'attribut <code id="a-collapse"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapse">collapse</a></code>, vous devrez aussi ajouter l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/grippy" title="grippy">grippy</a></code> à l'intérieur de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/splitter" title="splitter">splitter</a></code> afin que l'utilisateur puisse utiliser la poignée pour réduire un panneau.</p> -<h4 id="Exemple_avec_splitter" name="Exemple_avec_splitter">Exemple avec <code>splitter</code></h4> -<p>Un exemple vous sera utile :</p> -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span>: <a href="https://developer.mozilla.org/samples/xultu/examples/ex_splitter_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_splitter_1.xul">Voir</a></p> -<pre><vbox flex="1"> - <iframe id="content-1" width="60" height="20" src="w1.html"/> - <splitter collapse="before" resizeafter="farthest"> - <grippy/> - </splitter> - <iframe id="content-2" width="60" height="20" src="w2.html"/> - <iframe id="content-3" width="60" height="20" src="w3.html"/> - <iframe id="content-4" width="60" height="20" src="w4.html"/> -</vbox> -</pre> -<div class="float-right"><img alt="Image:xultu_splitter1.png" class=" internal" src="/@api/deki/files/1545/=Xultu_splitter1.png"></div> -<p>Ici, quatre cadres <code><a href="/fr/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code> ont été créés et un séparateur a été placé entre le premier et le second. L'attribut <code id="a-collapse"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapse">collapse</a></code> a été affecté d'une valeur 'before' pour signifier que si la poignée est cliquée, le premier cadre va disparaître, et le séparateur et les cadres restants vont glisser vers la gauche. La poignée du séparateur est centrée sur la barre de séparation.</p> -<p>La valeur 'farthest' a été affectée à l'attribut <code id="a-resizeafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizeafter">resizeafter</a></code> du séparateur. Elle signifie que lorsque le séparateur est déplacé, l'élément le plus éloigné après lui changera sa taille. Dans ce cas, il s'agit du quatrième cadre.</p> -<p>Aucune valeur n'a été spécifiée pour l'attribut <code id="a-resizebefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizebefore">resizebefore</a></code> qui aura donc sa valeur 'closest' par défaut. Dans ce cas, il n'y a qu'un cadre avant le séparateur, c'est donc le premier cadre qui changera de taille.</p> -<p>Les deuxième et troisième cadres ne changeront leur taille que si vous déplacez le séparateur suffisamment loin sur la droite jusqu'à ce que le quatrième cadre ait atteint sa largeur minimale.</p> -<p>Les quatre cadres avec le séparateur dans un état réduit :</p> -<p><img alt="Image:xultu_splitter2.png" class=" internal" src="/@api/deki/files/1546/=Xultu_splitter2.png"></p> -<p>Une image des quatre cadres avec le séparateur redimensionné vers la droite est montrée ci dessous. Notez que les deux cadres du milieu n'ont pas changé leur dimension. Seuls les premier et quatrième cadres ont changé de dimension. Vous pouvez seulement voir une partie du quatrième cadre. Si vous continuez à déplacer le séparateur vers la droite, les deux autres cadres vont se réduire.</p> -<p><img alt="Image:xultu_splitter3.png" class=" internal" src="/@api/deki/files/1547/=Xultu_splitter3.png"></p> -<p>Vous pouvez utiliser des propriétés de style telles que <code id="a-min-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/min-width">min-width</a></code>, <code id="a-max-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/max-width">max-width</a></code> sur les cadres pour spécifier leurs largeurs minimales ou maximales ou leurs hauteurs dans la boîte. Si vous faites cela, le séparateur va le détecter et ne permettra pas de le déplacer au-delà des tailles minimales ou maximales.</p> -<p>Par exemple, si vous spécifiez un minimum de 30 pixels en largeur sur le quatrième cadre, il ne se réduira pas en dessous de cette taille. Les deux autres cadres vont alors se réduire. Si vous mettez une largeur minimale de 50 pixels sur le premier cadre, vous ne pourrez déplacer le séparateur que de 10 pixels vers la gauche (car il démarre à 60 pixels de large). Toutefois, vous pouvez toujours faire disparaître le cadre.</p> -<p>Vous pouvez également placer plus d'un séparateur dans une boîte si vous le souhaitez, dans ce cas vous pourrez réduire les différentes parties de son contenu. De façon similaire, il n'y a pas que les cadres qui peuvent êre réduits, n'importe quel élément peut l'être.</p> -<div class="highlight"> -<h3 id="Notre_exemple_de_recherche_de_fichiers" name="Notre_exemple_de_recherche_de_fichiers">Notre exemple de recherche de fichiers</h3> -<p>Voyons ce que devient notre exemple de recherche de fichiers avec un séparateur. Une possibilité serait d'inclure les résultats de la recherche dans la boîte de dialogue. Nous ajouterons une zone entre les critères de recherche et les boutons du bas. Un séparateur permettra de réduire ou masquer les résultats de la recherche.</p> -<pre class="eval"></tabbox> - - <span class="highlightred"><iframe src="results.html"/> <splitter resizeafter="grow"/></span> - - <hbox> -</pre> -<p>Ici, un séparateur et un cadre ont été ajoutés à la boîte de dialogue. Nous n'avons plus besoin de l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> après la boîte d'onglets, donc nous l'enlèverons. Le contenu du cadre provient d'un fichier appelé '<code>result.html</code>'. Créez ce fichier et mettez ce que vous souhaitez dedans pour l'instant. Le cadre sera remplacé <a href="/fr/Tutoriel_XUL/Arbres" title="fr/Tutoriel_XUL/Arbres">plus tard</a> par la liste des résultats lorsque vous saurez comment la créer. Pour l'instant, il nous servira à expliquer le séparateur.</p> -<p>Le séparateur a été initialisé avec la valeur 'before' sur l'attribut <code id="a-collapse"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapse">collapse</a></code>, ce qui signifie que l'élément juste avant le séparateur va se réduire. Ici, il s'agit du cadre. Comme montré sur les images ci-dessous, lorsque la poignée est cliquée, le cadre est masqué et les boutons glissent vers le haut.</p> -<p>L'attribut <code id="a-resizeafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/resizeafter">resizeafter</a></code> a été initialisé avec une valeur 'grow' pour que les éléments situés après le séparateur se déplace vers la bas lorsque celui ci est déplacé vers le bas. Le contenu dans le cadre peut s'agrandir sans restriction. Vous noterez que la fenêtre ne se redimensionne pas automatiquement. Vous remarquerez également que c'est un séparateur horizontal parce qu'il a été placé dans une boîte verticale.</p> -<p>Etat normal :</p> -<p><img alt="Image:xultu_splitter4.png" class=" internal" src="/@api/deki/files/1548/=Xultu_splitter4.png"></p> -<p>Etat réduit :</p> -<p><img alt="Image:xultu_splitter5.png" class=" internal" src="/@api/deki/files/1549/=Xultu_splitter5.png"></p> -<p>Exemple de recherche de fichiers : <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfiles-splitter.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfiles-splitter.xul">Voir</a></p> -</div> -<hr> -<p>Dans la section suivante, nous verrons comment créer une barre de défilement.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Cadres_de_contenu" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Barres_de_défilement">Suivant »</a></p> -</div> -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/utilisation_des_spacers/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/utilisation_des_spacers/index.html deleted file mode 100644 index cecd0b9291..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/utilisation_des_spacers/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: Utilisation des spacers -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Utilisation_des_spacers -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Using_Spacers ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_d'éléments_HTML" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_de_caractéristiques_sur_les_boutons">Suivant »</a></p> -</div> - -<p>Dans cette section, vous trouverez comment ajouter des espacements entre les différents éléments que vous avez créés.</p> - -<h3 id="Ajout_de_spacers" name="Ajout_de_spacers">Ajout de spacers</h3> - -<p>Un des problèmes avec le développement des interfaces utilisateur est que chaque utilisateur a son propre affichage. Certains utilisateurs peuvent avoir de grands écrans avec une haute résolution et d'autres de faibles résolutions. De plus, chaque plate-forme peut avoir des spécificités pour l'interface utilisateur. En ajoutant le support multi-langue, un texte dans une langue peut avoir besoin de plus de place que dans une autre.</p> - -<p>Les applications qui doivent être compatibles avec différentes plates-formes ou langages ont souvent des fenêtres créées avec beaucoup de place pour permettre leur exécution. Certaines plates-formes et outils de développement d'interfaces utilisateur proposent des composants qui sont suffisamment intelligents pour se redimensionner et se repositionner eux-mêmes selon les besoins de l'utilisateur (Java utilise des gestionnaires de mise en page par exemple).</p> - -<p>XUL fournit la possibilité aux éléments de se positionner et se redimensionner automatiquement. Comme nous l'avons vu, la fenêtre de "recherche de fichiers" est apparue avec une taille qui correspond aux éléments qui y sont inclus. Chaque fois que nous y ajoutons quelque chose, la fenêtre s'agrandit.</p> - -<p>XUL utilise un système de mise en page appelé le " Box Model ". Nous en parlerons dans <a href="/fr/Tutoriel_XUL/Les_boîtes_de_groupe" title="fr/Tutoriel_XUL/Les_boîtes_de_groupe">la prochaine section</a> mais il vous permet essentiellement de diviser une fenêtre en une série de boîtes contenant vos éléments. Ces boîtes se positionnent et se redimensionnent en fonction des spécifications que vous avez définies. Pour l'instant, sachez simplement que l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> est un type de boîte.</p> - -<p>Avant d'entrer plus dans le détail avec les boîtes, nous allons présenter un autre élément XUL qui se montre très utile pour la mise en page, le <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code>. Un <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> est très simple et ne requiert qu'un seul attribut qui sera expliqué dans un moment. Le <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> le plus simple ressemble à ceci :</p> - -<pre class="eval"><spacer flex="1" /> -</pre> - -<p>Un <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> est utilisé pour placer des espaces vides dans une fenêtre. Sa principale caractéristique est de pouvoir s'agrandir ou se rétrécir lorsque l'utilisateur redimensionne la fenêtre. Il permet à quelqu'un de placer des boutons à droite ou en bas d'une fenêtre et de vouloir les fixer sur le coté droit ou en bas, quelle que soit la taille de la fenêtre. Comme vous le verrez, vous pouvez utiliser des séries de <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> pour créer quelques effets de mise en page.</p> - -<p>Dans la syntaxe ci-dessus, <code>spacer</code> a un seul attribut appelé <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. Il est utilisé pour définir la " flexibilité " de l'espacement. Dans le cas ci-dessus, le <code>spacer</code> a un <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '1'. Il en devient un élément d'espacement flexible. Si vous placez un <code>spacer</code> directement dans une fenêtre, il s'adaptera à la taille de la fenêtre lorsque celle-ci est modifiée.</p> - -<p>Nous allons bientôt ajouter un élément <code>spacer</code> dans notre boîte de dialogue "Recherche de Fichiers". Tout d'abord, voilà ce qu'il se passe si la fenêtre est agrandie :</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-inputs.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-inputs.xul">Voir</a></p> - -<p><img alt="Image:xultu_springs1.png" class="internal" src="/@api/deki/files/1550/=Xultu_springs1.png"></p> - -<p>Si vous changez la taille de la fenêtre, vous pouvez voir que les éléments ont conservé leur position. Aucun d'eux n'a bougé ou s'est redimensionné bien que la fenêtre dispose de plus de place. Regardons maintenant ce qu'il se passe si un élément <code>spacer</code> est ajouté entre la boîte de texte et le bouton 'Rechercher' :</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-spacer.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-spacer.xul">Voir</a></p> - -<p><img alt="Image:xultu_springs2.png" class="internal" src="/@api/deki/files/1551/=Xultu_springs2.png"></p> - -<p>En ajoutant un <code>spacer</code> et en agrandissant la fenêtre, vous voyez que le <code>spacer</code> s'est agrandi de façon à remplir l'espace libre. Les boutons ont été repoussés.</p> - -<div class="highlight"> -<h4 id="Notre_exemple_de_recherche_de_fichier" name="Notre_exemple_de_recherche_de_fichier">Notre exemple de recherche de fichier</h4> - -<p>Le code pour ajouter un <code>spacer</code> est indiqué juste après. Insérez le juste avant le bouton 'Rechercher' :</p> - -<pre class="eval"><span class="highlightred"><spacer flex="1"/></span> - -<button id="find-button" label="Rechercher"/> -</pre> -</div> - -<h3 id="Plus_d.27informations_sur_la_flexibilit.C3.A9" name="Plus_d.27informations_sur_la_flexibilit.C3.A9">Plus d'informations sur la flexibilité</h3> - -<p>XUL place les éléments d'une fenêtre en calculant les largeurs et les hauteurs adéquates des éléments et ajoute ensuite des espacements là où ils sont flexibles. À moins que vous ne spécifiez la largeur et la hauteur d'un élément, la dimension par défaut de cet élément sera déterminée par son contenu. Vous noterez que le bouton 'Annuler' des boîtes de dialogue a toujours adapté sa largeur pour contenir son texte. Si vous créez un bouton avec un très long libellé, la taille par défaut de ce bouton sera assez large pour contenir le libellé en entier. Les autres éléments, tels que la boîte de texte, se sont adaptés de façon adéquate.</p> - -<p>L'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> est utilisé pour spécifier si un élément peut changer sa dimension pour s'ajuster à sa boîte le contenant (dans notre cas, la fenêtre <code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>). Nous avons montré l'application de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sur les <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code>, mais il peut s'appliquer à n'importe quel élément. Par exemple, vous pouvez souhaiter avoir plutôt un redimensionnement du bouton 'Rechercher' :</p> - -<p><a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-spacer2.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-spacer2.xul">Voir</a></p> - -<p><img alt="Image:xultu_springs3.png" class="internal" src="/@api/deki/files/1552/=Xultu_springs3.png"></p> - -<p>Comme vous pouvez voir sur l'image, en plaçant un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sur le bouton 'Rechercher', celui-ci s'agrandit en même temps que la fenêtre. Un <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> n'a rien de spécial. Il peut être considéré comme un bouton invisible. Il fonctionne de la même manière qu'un bouton, excepté qu'il ne se dessine pas à l'écran.</p> - -<p>Vous aurez remarqué quelque chose sur l'image ci-dessus. Il n'y a pas que le bouton 'Rechercher' qui s'agrandit mais un espacement est également apparu entre le texte à gauche et le bouton. Bien entendu, il s'agit du <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> que nous avons placé tout à l'heure. Il s'est redimensionné de lui même également. Si vous regardez suffisamment de près, vous devriez remarquer que ce changement de taille a été partagé en part égale entre le <code>spacer</code> et le bouton. Le <code>spacer</code> a reçu la moitié de l'espace libre et le bouton a reçu l'autre moitié.</p> - -<p>La raison de ce comportement est que le <code><a href="/fr/docs/Mozilla/Tech/XUL/spacer" title="spacer">spacer</a></code> et le bouton ont chacun un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. Parce qu'ils sont flexibles, le <code>spacer</code> et le bouton se redimensionnent équitablement.</p> - -<p>Comment faire si vous voulez qu'un élément s'agrandisse deux fois plus qu'un autre ? Vous pouvez choisir un nombre plus grand pour la valeur de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>. Les valeurs de l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sont des ratios. Si un élément a un <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '1' et un second un <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '2', le second s'agrandira du du double par rapport au premier. En effet, un <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '2' signifie que cet élément a une flexibilité de deux fois celle d'un élément de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '1'.</p> - -<p>L'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> ne sert pas à définir une taille. Il spécifie au contraire comment se répartissent les espaces vides entre les différents éléments fils d'une boîte. Nous aborderons les boîtes dans le prochain chapitre. Dès lors que les dimensions par défaut des éléments fils d'une boîte sont déterminées, les valeurs de flexibilité sont appliquées pour diviser l'espace restant dans la boîte. Par exemple, si la boîte fait 200 pixels de large, qu'elle contient deux boutons flexibles respectivement de 50 pixels et 90 pixels, il restera un espacement de 60 pixels. Si ces deux boutons ont une valeur de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> de '1', cet espacement sera divisé en deux moitiés égales de 30 pixels affectées à chacun d'eux. Si le second bouton voit sa valeur de flexibilité augmentée à '2', le premier bouton recevra 20 pixels d'espacement supplémentaire et le second en recevra 40 pixels.</p> - -<p>L'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> peut être placé sur n'importe quel élément, toutefois il n'a de sens que si cet élément est directement inclus dans une boîte. Donc, même si vous placez un attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sur un élément HTML, il restera sans effet cet élément est situé dans un élément n'étant pas une boîte.</p> - -<h4 id="Exemples_d.27utilisation_de_flex" name="Exemples_d.27utilisation_de_flex">Exemples d'utilisation de <code>flex</code></h4> - -<pre class="eval">Exemple 1: - <button label="Chercher" flex="1"/> - <button label="Annuler" flex="1"/> - -Exemple 2: - <button label="Chercher" flex="1"/> - <button label="Annuler" flex="10"/> - -Exemple 3: - <button label="Chercher" flex="2"/> - <button label="Remplacer"/> - <button label="Annuler" flex="4"/> - -Exemple 4: - <button label="Chercher" flex="2"/> - <button label="Remplacer" flex="2"/> - <button label="Annuler" flex="3"/> - -Exemple 5: - <html:div> - <button label="Chercher" flex="2"/> - <button label="Remplacer" flex="2"/> - </html:div> - -Exemple 6: - <button label="Chercher" flex="145"/> - <button label="Remplacer" flex="145"/> -</pre> - -<dl> - <dt>Exemple 1 </dt> - <dd>dans ce cas, la flexibilité est divisée en part égale pour les deux boutons. Leurs tailles changeront en proportion égale.</dd> - <dt>Exemple 2 </dt> - <dd>ici, les deux boutons sont flexibles, mais le bouton Chercher sera dix fois plus petit que le bouton Annuler qui a une valeur <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> dix fois plus importante que celle du bouton Chercher. L'espace restant est divisé en une part pour le bouton Chercher et 10 parts pour le bouton Annuler.</dd> - <dt>Exemple 3 </dt> - <dd>seuls deux boutons sont flexibles ici. Le bouton Remplacer ne changera jamais sa taille mais les deux autres le pourront. Le bouton Annuler aura toujours une taille du double du bouton Chercher parce qu'il a une valeur de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> du double.</dd> - <dt>Exemple 4 </dt> - <dd>dans ce cas, les trois boutons sont flexibles. Les boutons Chercher et Remplacer auront exactement la même taille mais le bouton Annuler sera un peu plus large (50% plus large pour être exact).</dd> - <dt>Exemple 5 </dt> - <dd>ici, les deux boutons sont placés dans une balise <code>div</code>. La flexibilité perd toute signification puisque les boutons ne sont pas directement dans une boîte. L'effet serait le même si les attributs <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> étaient enlevés.</dd> - <dt>Exemple 6 </dt> - <dd>Comme les valeurs de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> sont identiques, les deux boutons auront la même taille. Cela fonctionne aussi bien que si vous aviez mis une valeur de '1' au lieu de '145'. Il est recommandé de mettre les valeurs les plus basses pour une meilleure lecture.</dd> -</dl> - -<div class="note">Notez que d'autres facteurs tels que les libellés des boutons et les tailles minimales des boutons peuvent affecter les dimensions réelles des boutons. Par exemple, un bouton ne peut pas être réduit au delà d'une taille nécessaire pour y placer son libellé.</div> - -<p>Spécifier une valeur de '0' a le même effet que si vous enleviez l'attribut <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> en entier. L'élément perd toute flexibilité. Vous verrez parfois des valeurs de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> avec un pourcentage. Il n'y a aucune signification spéciale et le signe pourcentage est traité comme s'il n'existait pas.</p> - -<p>Vous avez dû remarquer que si vous redimensionnez verticalement la boîte de dialogue « Recherche de fichiers », les boutons se redimensionnent également en hauteur pour s'ajuster à la hauteur de la fenêtre. Ceci s'explique par le fait que les boutons ont une valeur de <code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code> verticale implicite donnée par la fenêtre. Dans une prochaine section, nous expliquerons comment changer ce comportement.</p> - -<hr> -<p>Nous allons maintenant apprendre des nouvelles caractéristiques sur les boutons.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Ajout_d'éléments_HTML" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Plus_de_caractéristiques_sur_les_boutons">Suivant »</a></p> -</div> - -<p><span class="comment">Interwiki</span></p> diff --git a/files/fr/archive/mozilla/xul/tutoriel_xul/vues_d'arbre_personnalisées/index.html b/files/fr/archive/mozilla/xul/tutoriel_xul/vues_d'arbre_personnalisées/index.html deleted file mode 100644 index da6a3f7744..0000000000 --- a/files/fr/archive/mozilla/xul/tutoriel_xul/vues_d'arbre_personnalisées/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: Vues d'arbre personnalisées -slug: Archive/Mozilla/XUL/Tutoriel_XUL/Vues_d'arbre_personnalisées -tags: - - Tutoriel_XUL - - Tutoriels - - XUL -translation_of: Archive/Mozilla/XUL/Tutorial/Custom_Tree_Views ---- -<p> </p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Sélection_dans_les_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Détails_sur_les_vues_d'arbres">Suivant »</a></p> -</div> - -<p>Les vues d'arbres permettent d'afficher des données dans une arborescence.</p> - -<h3 id="Cr.C3.A9ation_d.27une_vue_personnalis.C3.A9e" name="Cr.C3.A9ation_d.27une_vue_personnalis.C3.A9e">Création d'une vue personnalisée</h3> - -<p>Jusqu'à présent, nous avons utilisé la construction interne d'une vue d'arbre. Dans cette section, nous verrons la création d'une vue personnalisée. Elle devient nécessaire dès lors que la quantité de données devient trop importante ou que celles-ci soient arrangées de manière trop complexe. Par exemple, l'utilisation d'éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code> ne serait plus viable en terme de performance avec plusieurs milliers de lignes. Vous pouvez également utiliser une vue personnalisée pour afficher des données obtenues par calculs. Puisque la vue peut stocker et récupérer de la meilleure manière possible les données en fonction de leur type, l'arbre peut être utilisé même si plusieurs milliers de lignes doivent être affichées.</p> - -<div class="note">Note : les interfaces relatives aux arbres ont changé dans <a href="/fr/Gecko" title="fr/Gecko">Gecko</a> 1.8. Consultez <a href="/fr/Modifications_de_l'API_Tree" title="fr/Modifications_de_l'API_Tree">Modifications de l'API Tree</a> pour plus de détails.</div> - -<p>Pour implémenter une vue personnalisée, vous devez créer un objet qui implémente l'interface <a class="external" href="http://xulplanet.com/references/xpcomref/ifaces/nsITreeView.html">nsITreeView</a>. Vous pouvez créer ces objets en javascript, mais vous aurez besoin d'un objet séparé pour chaque arbre. Naturellement, comme la vue d'arbre personnalisée est utilisée, la vue de contenu d'arbre ne le sera pas, donc les éléments <code><a href="/fr/docs/Mozilla/Tech/XUL/treeitem" title="treeitem">treeitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/treerow" title="treerow">treerow</a></code> et <code><a href="/fr/docs/Mozilla/Tech/XUL/treecell" title="treecell">treecell</a></code> n'auront aucun sens car la vue d'arbre obtient ses données ailleurs. Ainsi, vous pouvez simplement laisser l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treechildren" title="treechildren">treechildren</a></code> vide. L'exemple suivant vous le montre :</p> - -<pre><tree id="my-tree" flex="1"> - <treecols> - <treecol id="namecol" label="Nom" flex="1"/> - <treecol id="datecol" label="Date" flex="1"/> - </treecols> - <treechildren/> -</tree> -</pre> - -<p>Pour assigner les données à afficher dans l'arbre, un objet de vue doit être créé, il sera utilisé pour indiquer la valeur de chaque cellule, le nombre total de lignes plus d'autres informations optionnelles. L'arbre appellera des méthodes de la vue pour obtenir les informations dont il a besoin pour son affichage.</p> - -<p>En général, bien que la vue d'arbre dispose de plus d'une trentaine de fonctions pouvant être implémentées, il vous suffira de ne définir que celles appelées par l'arbre. Les trois méthodes que vous devrez implémenter sont décrites ci-dessous :</p> - -<dl> - <dt><code>rowCount</code></dt> - <dd>Cette propriété doit se voir assigner le nombre total de lignes dans l'arbre.</dd> - <dt><code>getCellText( ligne, colonne )</code></dt> - <dd>Cette méthode doit retourner le texte contenu à la ligne et la colonne spécifiées. Elle sera appelée pour afficher les données de chaque cellule. Les lignes sont spécifiées par des valeurs numériques qui commencent à '0'. Les colonnes sont des objets <code>TreeColumn</code>. Dans les anciennes versions de Mozilla (antérieures à Firefox 1.5 ou Mozilla 1.8), les colonnes sont référencées par les valeurs de l'attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> de la colonne. Si vous avez besoin d'un attribut <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> comme pour ces anciennes version, une propriété <code>id</code> peut être utilisée sur <code>TreeColumn</code>.</dd> - <dt><code>setTree( arbre )</code></dt> - <dd>Cette méthode est appelée une seule fois pour affecter l'objet arbre à la vue.</dd> -</dl> - -<p>Voici un exemple de définition d'un tel objet qui peut avoir le nom que vous souhaitez :</p> - -<pre>//Moz 1.8 -var treeView = { - rowCount : 10000, - getCellText : function(row,column){ - if (column.id == "namecol") return "Ligne "+row; - else return "18 février"; - }, - setTree: function(treebox){ this.treebox = treebox; }, - isContainer: function(row){ return false; }, - isSeparator: function(row){ return false; }, - isSorted: function(){ return false; }, - getLevel: function(row){ return 0; }, - getImageSrc: function(row,col){ return null; }, - getRowProperties: function(row,props){}, - getCellProperties: function(row,col,props){}, - getColumnProperties: function(colid,col,props){} -}; -</pre> - -<p>Les fonctions de l'exemple ci-dessus que nous n'avons pas décrites n'ont pas besoin d'effectuer une quelconque action, mais elles doivent être définies car l'arbre les appelle pour rassembler des informations supplémentaires.</p> - -<p>Cet exemple peut-être utilisé pour un arbre avec 10000 lignes. Le contenu des cellules de la première colonne sera 'Ligne X' où X sera le numéro de la ligne. Le contenu des cellules de la seconde colonne sera '18 février'. La structure <code>if</code> dans la fonction <code>getCellText()</code> compare la propriété <code>id</code> de l'argument <code>column</code> au texte 'namecol'. Ce texte 'namecol' correspond à l'<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> du premier élément <code><a href="/fr/docs/Mozilla/Tech/XUL/treecol" title="treecol">treecol</a></code> dans l'exemple précédent. Cet exemple est très simplifié bien sûr - en réalité vous aurez des données bien plus complexes dans chaque cellule.</p> - -<p>L'étape finale est d'associer l'objet de vue avec l'arbre. L'arbre a une propriété <code id="a-view"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/view">view</a></code>, à laquelle on peut assigner l'objet déclaré ci-dessus. Nous pouvons assigner une valeur à cette propriété à tout moment pour attribuer une vue à l'arbre, ou en changer.</p> - -<pre>function setView(){ - document.getElementById('my-tree').view = treeView; -} -</pre> - -<p>Le code source suivant présente l'exemple en entier. Un script intégré au fichier XUL a été utilisé ici pour simplifier l'exemple. En temps normal vous mettriez le script dans un fichier de script externe.</p> - -<h4 id="Exemple_d.27arbre_personnalis.C3.A9" name="Exemple_d.27arbre_personnalis.C3.A9">Exemple d'arbre personnalisé</h4> - -<p><span id="Exemple_1"><a id="Exemple_1"></a><strong>Exemple 1</strong></span> : <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeview_1.xul.txt">Source</a> <a href="https://developer.mozilla.org/samples/xultu/examples/ex_treeview_1.xul">Voir</a></p> - -<pre><?xml version="1.0" encoding="iso-8859-1"?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> - -<window title="Exemple d'arbre" id="tree-window" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" - onload="setView();"> - -<script> -//Moz 1.8 -var treeView = { - rowCount : 10000, - getCellText : function(row,column){ - if (column.id == "namecol") return "Ligne "+row; - else return "18 février"; - }, - setTree: function(treebox){ this.treebox = treebox; }, - isContainer: function(row){ return false; }, - isSeparator: function(row){ return false; }, - isSorted: function(){ return false; }, - getLevel: function(row){ return 0; }, - getImageSrc: function(row,col){ return null; }, - getRowProperties: function(row,props){}, - getCellProperties: function(row,col,props){}, - getColumnProperties: function(colid,col,props){} -}; - -function setView(){ - document.getElementById('my-tree').view = treeView; -} -</script> - -<tree id="my-tree" flex="1"> - <treecols> - <treecol id="namecol" label="Nom" flex="1"/> - <treecol id="datecol" label="Date" flex="1"/> - </treecols> - <treechildren/> -</tree> - -</window> -</pre> - -<p><img alt="Image:xultu_treeview1.png" class="internal" src="/@api/deki/files/1566/=Xultu_treeview1.png"></p> - -<p>Sur l'image, vous voyez deux colonnes, chacune obtenant ses données par l'intermédiaire de la fonction <code>getCellText()</code>. La fonction <code>setView()</code> a été appelée par le gestionnaire <code id="a-onload"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onload">onload</a></code> de la fenêtre (<code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code>), mais vous pouvez aussi changer la vue plus tard si vous le souhaitez. Vous pouvez la changer à n'importe quel instant.</p> - -<p>Il faut noter que la fonction <code>getCellText()</code> est seulement appelée quand cela est nécessaire pour afficher le contenu. Dans l'exemple de 10000 lignes ci-dessus, <code>getCellText()</code> est seulement appelée pour les cellules qui sont actuellement affichées. Sur cette image, seules sept lignes sont affichées, donc la fonction <code>getCellText()</code> a été appelée 14 fois. Elle sera appelée pour les autres lignes lorsque l'utilisateur les fera défiler. Cette méthode rend l'arbre beaucoup plus efficace.</p> - -<div class="note">Notez que l'objet de vue est aussi disponible pour des arbres prédéfinis dans votre installation. Vous pouvez les utiliser pour récupérer les libellés de leurs cellules et d'autres informations.</div> - -<p>L'<a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsITreeView.html">interface nsITreeView</a> liste toutes les méthodes et propriétés que vous pouvez implémenter pour la vue d'un arbre.</p> - -<hr> -<p>Dans la prochaine section, nous verrons d'autres fonctionnalités des vues d'arbre.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Tutoriel_XUL:Sélection_dans_les_arbres" style="float: left;">« Précédent</a><a href="/fr/docs/Tutoriel_XUL:Détails_sur_les_vues_d'arbres">Suivant »</a></p> -</div> diff --git a/files/fr/archive/mozilla/xul/utilisation_de_nsixulappinfo/index.html b/files/fr/archive/mozilla/xul/utilisation_de_nsixulappinfo/index.html deleted file mode 100644 index 10f33316ad..0000000000 --- a/files/fr/archive/mozilla/xul/utilisation_de_nsixulappinfo/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Utilisation de nsIXULAppInfo -slug: Archive/Mozilla/XUL/Utilisation_de_nsIXULAppInfo -tags: - - Extensions -translation_of: Archive/Mozilla/XUL/Using_nsIXULAppInfo ---- -<p> -À partir de Mozilla/<a href="fr/XULRunner">XULRunner</a> 1.8, il existe une nouvelle manière de connaître l'application, sa version et la version de <a href="fr/Gecko">Gecko</a> sur laquelle votre code tourne. -</p><p>Cela peut s'avérer utile, par exemple, dans le cas d'<a href="fr/Extensions">extensions</a> prévues pour fonctionner sur plusieurs applications basées sur Mozilla ou différentes versions d'une même application. Ce n'est <b>pas</b> utile pour les scripts sur des pages Web, qui doivent utiliser <a href="fr/DOM/window.navigator">l'objet navigator</a>. -</p> -<h2 id="L'interface_nsIXULAppInfo"> L'interface <code>nsIXULAppInfo</code> </h2> -<p>Pour faire la distinction entre différentes applications basées sur Mozilla, utilisez l'interface gelée <a href="fr/NsIXULAppInfo">nsIXULAppInfo</a>. Les sections suivantes proposent quelques exemples d'utilisation de <code>nsIXULAppInfo</code> depuis JavaScript. -</p><p>Notez que si Firefox 1.5, Thunderbird 1.5, et les applications basées sur <a href="fr/XULRunner">XULRunner</a> 1.8 supportent <code>nsIXULAppInfo</code>, des applications plus anciennes comme Firefox et Thunderbird 1.0 ne le font pas. Vous devrez utiliser du <a href="#old">code supplémentaire pour ces anciennes versions</a>. -</p> -<h3 id="Obtenir_nsIXULAppInfo"> Obtenir <code>nsIXULAppInfo</code> </h3> -<p>Pour qu'un composant implémente <code>nsIXULAppInfo</code>, utilisez ce code : -</p> -<pre class="eval">var appInfo = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo); -</pre> -<p>(Pour une explication, consultez <a class="external" href="http://xulplanet.com/references/xpcomref/creatingcomps.html">cet article sur XUL Planet</a>.) -</p> -<h3 id="Des_informations_sur_l'application"> Des informations sur l'application </h3> -<p>Après avoir obtenu le composant d'information sur l'application, vous pouvez lire ses propriétés pour connaître l'ID de l'application, son nom lisible par un humain, sa version, la plateforme utilisée, etc. Pour une liste complète des propriétés de <code>nsIXULAppInfo</code>, veuillez consulter la description de l'interface <a href="fr/NsIXULAppInfo">nsIXULAppInfo</a>. -</p> -<h4 id="ID"> ID </h4> -<p>Vous pouvez connaître l'application sous laquelle vous tournez à l'aide de la propriété <code>nsIXULAppInfo.ID</code>. -</p> -<pre class="eval">const FIREFOX_ID = "{ec8030f7-c20a-464f-9b0e-13a3a9e97384}"; -const THUNDERBIRD_ID = "{3550f703-e582-4d05-9a08-453d09bdfdc6}"; -var appInfo = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo); -if(appInfo.ID == FIREFOX_ID) { - // on est sous Firefox -} else if(appInfo.ID == THUNDERBIRD_ID) { - // on est sous Thunderbird -} else { - // c'est une autre application -} -</pre> -<p>Note : vous auriez également pu utiliser <code>nsIXULAppInfo.name</code>, qui est un nom lisible par un humain pour l'application, comme « Firefox », mais qui sait, peut-être qu'il changera encore de nom ! -</p> -<h4 id="Version"> Version </h4> -<p>Dans certains cas, vous aurez besoin de connaître la version de l'application sous laquelle tourne votre code. Par exemple, une des fonctions non gelée que vous utilisez peut avoir changé. -</p><p><b>Note : <code>nsIXULAppInfo</code> fournit des informations concernant l'<i>application</i> et la <i>plateforme</i>, faites attention d'utiliser la bonne, particulièrement dans le cas d'applications basées sur XULRunner.</b> -</p><p>Dans de tels cas, vous voudrez probablement vérifier <code>nsIXULAppInfo.version</code> et/ou <code>nsIXULAppInfo.appBuildID</code>. Cette dernière est utile si vous essayez de fonctionner avec des nightlies de développement de l'application, tandis que la premère est plutôt utile si vous prenez uniquement en compte les sorties officielles, et pour faire la distinction entre les compilations de branches particulières ou du tronc. -</p><p><b>Exemple 1 : vérification de la version de Firefox</b> -</p> -<pre class="eval">// en supposant qu'on tourne sous Firefox -var appInfo = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo); -var versionChecker = Components.classes["@mozilla.org/xpcom/version-comparator;1"] - .getService(Components.interfaces.nsIVersionComparator); -if(versionChecker.compare(appInfo.version, "1.5") >= 0) { - // il s'agit de Firefox 1.5 ou supérieur -} -</pre> -<p><b>Exemple 2 : reconnaître les nightlies</b> -</p> -<pre class="eval">var appInfo = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo); -if(appInfo.appBuildID >= "2005093006") { - // la compilation est postérieure ou égale à 2005093006 -} -</pre> -<p>Vous ne devriez pas vous baser sur les ID de compilation pour des versions officielles, car l'ID de compilation peut être différent pour des compilations personnalisées ou les version localisées d'une application. -</p> -<h4 id="Version_de_la_plateforme"> Version de la plateforme </h4> -<p><code>nsIXULAppInfo</code> fournit des informations de version à propos de l'application XUL (comme Firefox) et la plateforme (c'est-à-dire Gecko ou XULRunner). Par exemple, dans Firefox 1.5 beta 2 la version de l'application est 1.4.1 et la version de la plateforme est 1.8b5. Faites attention d'utiliser l'information dont vous avez besoin, particulièrement dans le cas d'applications basées sur XULRunner. -</p><p>L'obtention des informations de version sur la plateforme s'effectue ainsi : -</p> -<pre class="eval">var appInfo = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo); -var platformVer = appInfo.platformVersion; -var platformBuildID = appInfo.platformBuildID; -</pre> -<p><s id="old"> -</s></p><s id="old"> -<h2 id="Versions_plus_anciennes"> Versions plus anciennes </h2> -<p>Comme indiqué plus haut, les anciennes application basées sur Mozilla 1.7 ne supportent pas <code>nsIXULAppInfo</code>. Vour aurez à écrire du code supplémentaire si vous choisissez de fonctionner avec ces versions. -</p><p>Par exemple, Firefox et Thunderbird 1.0 stockaient leur ID dans la préférence <code>app.id</code> (et leur version dans <code>app.version</code>), donc vous pouvez utiliser un code comme celui-ci pour savoir sous quelle application vous tournez : -</p> -<pre class="eval">function getAppID() { - var id; - if("@mozilla.org/xre/app-info;1" in Components.classes) { - // on est sous Mozilla 1.8 ou supérieur - id = Components.classes["@mozilla.org/xre/app-info;1"] - .getService(Components.interfaces.nsIXULAppInfo).ID; - } else { - try { - id = Components.classes["@mozilla.org/preferences-service;1"] - .getService(Components.interfaces.nsIPrefBranch) - .getCharPref("app.id"); - } catch(e) { - // très ancienne version - dump(e); - } - } - return id; -} -alert(getAppID()); -</pre> -<h2 id="Voir_aussi"> Voir aussi </h2> -<ul><li> LXR : <a class="external" href="http://lxr.mozilla.org/seamonkey/source/toolkit/xre/nsIXULAppInfo.idl">nsIXULAppInfo.idl</a> -</li></ul> -<div class="noinclude"> -</div> -</s> diff --git a/files/fr/archive/mozilla/xul/utilisation_de_plusieurs_dtd/index.html b/files/fr/archive/mozilla/xul/utilisation_de_plusieurs_dtd/index.html deleted file mode 100644 index b8a892ecf0..0000000000 --- a/files/fr/archive/mozilla/xul/utilisation_de_plusieurs_dtd/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Utilisation de plusieurs DTD -slug: Archive/Mozilla/XUL/Utilisation_de_plusieurs_DTD -tags: - - Localisation - - XUL -translation_of: Archive/Mozilla/XUL/Using_multiple_DTDs ---- -<p>Généralement il n'y a qu'un unique ficher DTD (<strong>D</strong>ocument <strong>T</strong>ype <strong>D</strong>efinition) pour la localisation d'un fichier <a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL" title="fr/XUL">XUL</a> spécifique. Mais il existe des cas où l'utilisation de plusieurs DTD peut être nécessaire, comme par exemple pour la localisation de "widgets" couramment utilisés dans les fichiers XUL, en plus de ceux spécifiques au fichier à localiser.</p> - -<h2 id="DTD_unique" name="DTD_unique">DTD unique</h2> - -<p>Pour rendre localisables les chaînes de votre fichier <a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL" title="fr/XUL">XUL</a>, vous devez <a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Tutoriel_XUL/Localisation" title="fr/Tutoriel_XUL/Localisation">ajouter une déclaration DTD</a> au début du fichier comme ceci :</p> - -<pre class="eval line-numbers language-html"><code class="language-html"><span class="doctype token"><!DOCTYPE window SYSTEM "chrome://myextension/locale/mainwindow.dtd"></span></code></pre> - -<p>où <code>window</code> est le nom local de l'élément (racine) du document.</p> - -<p>Par exemple, si vous avez une entité appelée <code>someButton.label</code> définie dans <code>mainwindow.dtd</code>, vous pouvez y accéder comme ceci :</p> - -<pre class="eval"><button id="somebutton" label="&someButton.label"> -</pre> - -<h2 id="DTD_multiples" name="DTD_multiples">DTD multiples</h2> - -<p>Si vous voulez utiliser plusieurs DTD pour votre fichier XUL, vous pouvez simplement lister tous les fichiers DTD dans votre déclaration DTD :</p> - -<pre class="eval line-numbers language-html"><code class="language-html"><span class="doctype token"><!DOCTYPE window [ - <!ENTITY % commonDTD SYSTEM "chrome://myextensions/locale/common.dtd"></span> - %commonDTD; - <!ENTITY % mainwindowDTD SYSTEM "chrome://myextension/locale/mainwindow.dtd"> - %mainwindowDTD; -]></code></pre> - -<p>Vous pouvez maintenant accéder aux entités déclarées dans les DTD comme indiqué ci-dessus. Supposons que vous avez une entité <code>okButton.label</code> définie dans le fichier <code>common.dtd</code>, alors l'accès aux entités des deux DTD ressemblera à cela :</p> - -<pre class="eval line-numbers language-html"><code class="language-html"><span class="tag token"><span class="tag token"><span class="punctuation token"><</span>button</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>somebutton<span class="punctuation token">"</span></span> <span class="attr-name token">label</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>&someButton.label<span class="punctuation token">"</span></span><span class="punctuation token">></span></span> -... -<span class="tag token"><span class="tag token"><span class="punctuation token"><</span>button</span> <span class="attr-name token">id</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>okbutton<span class="punctuation token">"</span></span> <span class="attr-name token">label</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>&okButton.label<span class="punctuation token">"</span></span><span class="punctuation token">></span></span></code></pre> - -<p>Notez qu'il n'existe rien de comparable aux espaces de noms avec plusieurs DTD. Vous devez vous assurez qu'il n'y a pas de conflit entre les entités définies dans les différents DTD.</p> diff --git a/files/fr/archive/mozilla/xul/utilisation_du_correcteur_orthographique_dans_xul/index.html b/files/fr/archive/mozilla/xul/utilisation_du_correcteur_orthographique_dans_xul/index.html deleted file mode 100644 index 563925da26..0000000000 --- a/files/fr/archive/mozilla/xul/utilisation_du_correcteur_orthographique_dans_xul/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Utilisation du correcteur orthographique dans XUL -slug: Archive/Mozilla/XUL/Utilisation_du_correcteur_orthographique_dans_XUL -tags: - - Extensions -translation_of: Archive/Mozilla/XUL/Using_spell_checking_in_XUL ---- -<p>Une nouvelle fonction de correction orthographique est disponible dans <a href="fr/Firefox_2">Firefox 2</a>. Ce document explique comment utiliser le composant <code><a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/mozISpellCheckingEngine.html">mozISpellCheckingEngine</a></code> pour permettre à vos extensions Firefox d'en bénéficier. </p><p>Consultez <a href="fr/Contr%c3%b4le_du_correcteur_d'orthographe_dans_les_formulaires_HTML">Contrôle du correcteur d'orthographe dans les formulaires HTML</a> pour des détails sur l'activation du correcteur orthographique dans les formulaires HTML de vos sites Web. -</p> -<h3 id="Vérification_de_l'orthographe_d'un_mot"> Vérification de l'orthographe d'un mot </h3> -<p>Pour vérifier l'orthographe d'un mot, vous devez d'abord créer une interface vers le composant <code><a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/mozISpellCheckingEngine.html">mozISpellCheckingEngine</a></code> en utilisant <code>@mozilla.org/spellchecker/myspell;1</code> comme ID de contrat, et appeler ensuite la méthode <code>check()</code> avec la chaine à vérifier. Cette méthode renvoie <code>true</code> si le mot est correctement orthographié, ou <code>false</code> dans le cas contraire. -</p> -<pre>gSpellCheckEngine = Components.classes["@mozilla.org/spellchecker/myspell;1"] - .getService(Components.interfaces.mozISpellCheckingEngine); -gSpellCheckEngine.dictionary = 'en-US'; - -if (gSpellCheckEngine.check("kat")) { - // Le mot est correctement écrit -} -else { - // Le mot n'est pas correctement écrit -} -</pre> -<h3 id="Obtention_d'une_liste_de_suggestions"> Obtention d'une liste de suggestions </h3> -<p>Pour obtenir une liste de suggestions pour un mot incorrect, appelez la méthode <code>suggest()</code> en spécifiant le mot et un objet pouvant être rempli d'un tableau de suggestions possibles. -</p> -<pre class="eval">var suggestions = {}; -gSpellCheckEngine.suggest("kat", suggestions); - -if (suggestions.value) { - // suggestions.value est un tableau JavaScript (objet <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_Core/Objets_globaux/Array">Array</a>) de chaines - // suggestions.value.length compte le nombre de suggestions trouvées -} -</pre> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/vbox/index.html b/files/fr/archive/mozilla/xul/vbox/index.html deleted file mode 100644 index 87392e6beb..0000000000 --- a/files/fr/archive/mozilla/xul/vbox/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: vbox -slug: Archive/Mozilla/XUL/vbox -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/vbox ---- -<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>Un élément conteneur qui peut contenir une infinité d'éléments enfants. C'est l'équivalent de l'élément <code><code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code></code>, sauf que son orientation par défaut est verticale. -</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Le_mod%c3%a8le_de_bo%c3%aete">Tutoriel XUL</a>. </p> -<h3 id="Exemple" name="Exemple"> Exemple </h3> -<pre><!-- Deux labels en bas --> -<vbox> - <spacer flex="1"/> - <label value="Un"/> - <label value="Deux"/> -</vbox> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238);"> -<tbody> -<tr> -<td><p><strong>Hérités de XUL element</strong><br> <small> -<code id="a-align"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/align">align</a></code>, -<code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code>, -<code id="a-allownegativeassertions"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allownegativeassertions">allownegativeassertions</a></code>, -<code id="a-class"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/class">class</a></code>, -<code id="a-coalesceduplicatearcs"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/coalesceduplicatearcs">coalesceduplicatearcs</a></code>, -<code id="a-collapsed"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/collapsed">collapsed</a></code>, -<code id="a-container"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/container">container</a></code>, -<code id="a-containment"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/containment">containment</a></code>, -<code id="a-context"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/context">context</a></code>, -<code id="a-contextmenu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/contextmenu">contextmenu</a></code>, -<code id="a-datasources"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/datasources">datasources</a></code>, -<code id="a-dir"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/dir">dir</a></code>, -<code id="a-empty"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/empty">empty</a></code>, -<code id="a-equalsize"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/equalsize">equalsize</a></code>, -<code id="a-flags"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flags">flags</a></code>, -<code id="a-flex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/flex">flex</a></code>, -<code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code>, -<code id="a-hidden"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidden">hidden</a></code>, -<code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code>, -<code id="a-insertafter"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertafter">insertafter</a></code>, -<code id="a-insertbefore"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/insertbefore">insertbefore</a></code>, -<code id="a-left"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/left">left</a></code>, -<code id="a-maxheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxheight">maxheight</a></code>, -<code id="a-maxwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/maxwidth">maxwidth</a></code>, -<code id="a-menu"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/menu">menu</a></code>, -<code id="a-minheight"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minheight">minheight</a></code>, -<code id="a-minwidth"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/minwidth">minwidth</a></code>, -<code id="a-mousethrough"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/mousethrough">mousethrough</a></code>, -<code id="a-observes"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/observes">observes</a></code>, -<code id="a-ordinal"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ordinal">ordinal</a></code>, -<code id="a-orient"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/orient">orient</a></code>, -<code id="a-pack"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/pack">pack</a></code>, -<code id="a-persist"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/persist">persist</a></code>, -<code id="a-popup"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/popup">popup</a></code>, -<code id="a-position"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/position">position</a></code>, -<code id="a-preference-editable"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference-editable">preference-editable</a></code>, -<code id="a-querytype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/querytype">querytype</a></code>, -<code id="a-ref"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/ref">ref</a></code>, -<code id="a-removeelement"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/removeelement">removeelement</a></code>, -<code id="a-sortDirection"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortDirection">sortDirection</a></code>, -<code id="a-sortResource"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource">sortResource</a></code>, -<code id="a-sortResource2"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sortResource2">sortResource2</a></code>, -<code id="a-statustext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/statustext">statustext</a></code>, -<code id="a-style"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/style">style</a></code>, -<code id="a-template"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/template">template</a></code>, -<code id="a-tooltip"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltip">tooltip</a></code>, -<code id="a-tooltiptext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tooltiptext">tooltiptext</a></code>, -<code id="a-top"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/top">top</a></code>, -<code id="a-uri"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/uri">uri</a></code>, -<code id="a-wait-cursor"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/wait-cursor">wait-cursor</a></code>, -<code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> </small></p> -</td> -</tr> -</tbody> -</table> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/box" title="box">box</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/hbox" title="hbox">hbox</a></code> -</dd></dl> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xul/vulgarisation_xul/index.html b/files/fr/archive/mozilla/xul/vulgarisation_xul/index.html deleted file mode 100644 index c5ab6b4c9f..0000000000 --- a/files/fr/archive/mozilla/xul/vulgarisation_xul/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Tutoriel de vulgarisation XUL -slug: Archive/Mozilla/XUL/Vulgarisation_XUL -translation_of: Archive/Add-ons/Overlay_Extensions/XUL_School ---- -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="The XUL School -project was developed by -Glaxstar (now Appcoast), as a comprehensive extension development -tutorial, covering the most significant aspects of extension -development, including proven techniques and high quality standards.">Le projet XUL School a été développé par Glaxstar (maintenant <a class="external" href="http://appcoast.com/" title="http://appcoast.com/">Appcoast</a>), comme un tutoriel complet de développement d'extensions, couvrant les aspects les plus significatifs de développement des extensions, y compris des techniques éprouvées et des normes de haute qualité. </span><span style="background-color: rgb(255, 255, 255);" title="Appcoast -has kindly -donated the contents of this project, which is now published on MDC -following its sharing licenses.">Appcoast a aimablement donné le contenu de ce projet, qui est maintenant publié sur le MDC selon <a href="/Project:Copyrights" title="Project:Copyrights">ses licences de partage</a>. </span><span style="background-color: rgb(255, 255, 255);" title="Some of the contents have been modified -from its original -source, and will likely continue to change with community -contributions.">Certains de ces contenus ont été modifiés à partir de sa source d'origine, et va probablement continuer à évoluer avec les contributions de la communauté.</span></span></p> -<p>Il vous est conseillé de bien lire en entier au moins une fois son contenu, et de vous repérez au contenu de référence, ainsi que de télécharger, étudier et tester les exemples de codes.</p> -<p>Contenu :</p> -<ul> <li><a href="/fr/Vulgarisation_XUL/Introduction" title="fr/Vulgarisation XUL/Introduction">Introduction</a></li> <li><a href="/fr/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox" title="fr/Vulgarisation XUL/Premiers pas avec les extensions Firefox">Premiers pas avec les extensions Firefox</a></li> <li><a href="/fr/Vulgarisation_XUL/L'essentiel_d'une_extension" title="fr/Vulgarisation XUL/L'essentiel d'une extension">L'essentiel_d'une_extension</a></li> <li><a href="/en/XUL_School/Setting_Up_a_Development_Environment" title="en/XUL School/Setting - Up a Development Environment">Setting Up a Development Environment</a></li> <li><a href="/en/XUL_School/Adding_menus_and_submenus" title="en/XUL - School/Adding menus and submenus">Adding menus and submenus</a></li> <li><a href="/en/XUL_School/Adding_Toolbars_and_Toolbar_Buttons" title="en/XUL School/Adding Toolbars - and Toolbar Buttons">Adding Toolbars and Toolbar Buttons</a></li> <li><a href="/en/XUL_School/Adding_Events_and_Commands" title="en/XUL - School/Adding Events and Commands">Adding events and commands</a></li> <li><a href="/en/XUL_School/The_Box_Model" title="en/XUL School/The Box Model">The Box Model</a></li> <li><a href="/en/XUL_School/Adding_windows_and_dialogs" title="en/XUL School/Adding windows and dialogs">Adding windows and dialogs</a></li> <li><a href="/en/XUL_School/Adding_sidebars" title="en/XUL School/Adding - sidebars">Adding sidebars</a></li> <li><a href="/en/XUL_School/JavaScript_Object_Management" title="en/XUL School/JavaScript Object - Management">JavaScript Object Management</a></li> <li><a href="/en/XUL_School/XPCOM_Objects" title="en/XUL School/XPCOM Objects">XPCOM Objects</a></li> <li><a href="/en/XUL_School/Observer_Notifications" title="en/XUL School/Observer Notifications">Observer Notifications</a></li> <li><a href="/en/XUL_School/Handling_Preferences" title="en/XUL School/Handling - Preferences">Handling preferences</a></li> <li><a href="/en/XUL_School/Local_Storage" title="en/XUL School/Local Storage">Local Storage</a></li> <li><a href="/en/XUL_School/Intercepting_Page_Loads" title="en/XUL School/Intercepting Page Loads">Intercepting page loads</a></li> <li><a href="/en/XUL_School/Connecting_to_Remote_Content" title="en/XUL School/Connecting to Remote - Content">Connecting to Remote Content</a></li> <li><a href="/en/XUL_School/Custom_XUL_Elements_with_XBL" title="en/XUL School/Custom XUL - Elements with XBL">Custom XUL Elements with XBL</a></li> <li><a href="/en/XUL_School/User_Notifications_and_Alerts" title="en/XUL School/User - Notifications and Alerts">User notifications and alerts</a></li> <li><a href="/en/XUL_School/Mozilla_Documentation_Roadmap" title="en/XUL School/Mozilla - Documentation Roadmap">Mozilla Documentation Roadmap</a></li> <li><a href="/en/XUL_School/Useful_Mozilla_Community_Sites" title="en/XUL School/Useful - Mozilla Community Sites">Useful Mozilla Community Sites</a></li> -</ul> -<p><br> </p> diff --git a/files/fr/archive/mozilla/xul/vulgarisation_xul/introduction/index.html b/files/fr/archive/mozilla/xul/vulgarisation_xul/introduction/index.html deleted file mode 100644 index 7d4aed3de9..0000000000 --- a/files/fr/archive/mozilla/xul/vulgarisation_xul/introduction/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Introduction -slug: Archive/Mozilla/XUL/Vulgarisation_XUL/Introduction -translation_of: Archive/Add-ons/Overlay_Extensions/XUL_School/Introduction ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox">Suivant »</a></p> -</div> -<p>Bonjour, et bienvenue sur le tutoriel de vulgarisation XUL pour les développeurs d'extension !</p> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="This tutorial is meant to be the stepping -stone that will turn you into a professional Firefox extension developer -in no time.">Ce tutoriel est destiné à être le tremplin qui va vous transformer en un développeur d'extensions professionnelles sous Firefox en peu de temps. </span><span style="background-color: rgb(255, 255, 255);" title="We have poured years of XUL experience into it, providing all -kinds of solutions for common problems, and describing the pros and cons -of different approaches for solving these problems.">Il contient des années d'expérience en XUL, en fournissant toutes sortes de solutions aux problèmes communs, et en décrivant les avantages et les inconvénients des différentes approches pour résoudre ces problèmes. </span><span style="background-color: rgb(255, 255, 255);" title="This tutorial also -reflects a new way of making Firefox extensions, taking advantage of -the new features and APIs that Firefox 3 provides.">Ce tutoriel reflète également une nouvelle manière de faire des extensions Firefox, profitant des nouvelles fonctionnalités et API que Firefox 3 fournit.</span></span></p> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="XUL School was created by Glaxstar (now -Appcoast), one of the few companies dedicated to building high-quality -Firefox extensions.">Ce tutoriel XUL a été créé par Glaxstar (maintenant <a class="external" href="http://appcoast.com/" title="http://appcoast.com/">Appcoast</a>), l'une des rares entreprises spécialisée dans l'élaboration d'extensions de haute qualité pour Firefox. </span></span><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="A team of over a dozen XUL developers -conformed Glaxstar at the time this tutorial was created, and the -combined experiences of years creating Firefox extensions are reflected -here.">Une équipe de plus d'une douzaine de développeurs XUL de chez Glaxstar ont participé en même temps à ce tutoriel, et l'ensemble des expériences des années de création d'extensions Firefox sont reflétées ici.</span></span></p> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="In this tutorial you'll learn how to develop -Firefox extensions.">Dans ce tutoriel, vous apprendrez à développer des extensions Firefox. </span><span style="background-color: rgb(255, 255, 255);" title="You'll learn how to quickly do the most common tasks in -extension development, comparing several different approaches to solve -them.">Vous apprendrez comment faire rapidement les tâches les plus communes dans le développement d'extensions, en comparant plusieurs approches différentes pour les résoudre. </span><span style="background-color: rgb(255, 255, 255);" title="In most cases we'll -provide code examples that you can easily copy and adapt to your needs, -as well as some working example extensions.">Dans la plupart des cas, nous vous fournirons des exemples de code que vous pouvez facilement copier et adapter à vos besoins, ainsi que certains exemples fonctionnels d'extensions. </span><span style="background-color: rgb(255, 255, 255);" title="The tutorial aims to be as brief as possible, often -falling back on Mozilla documentation for more detailed information.">Le tutoriel vise à être aussi bref que possible, en faisant des renvois fréquent sur la documentation de Mozilla pour plus d'informations. </span><span style="background-color: rgb(255, 255, 255);" title="You can think of it -as a quick guide to the expansive world that is the Mozilla platform.">Vous pouvez penser que c'est un guide trop court face au monde vaste qui est la plate-forme Mozilla. </span><span style="background-color: rgb(255, 255, 255);" title="Most links in this documentation are meant to be clicked -and read, since we're not aiming to be comprehensive.">La plupart des liens dans cette documentation sont destinés à être ouverts et lus, puisque nous ne cherchons pas à être exhaustif.</span></span></p> -<p><span class="medium_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="We'll start with a brief introduction to -some key concepts, in case you're not familiar with Mozilla and -Firefox.">Nous allons commencer par une brève introduction à certains concepts clés, au cas où vous n'êtes pas familier avec Mozilla et Firefox. </span><span title="You can safely skip these sections if you -already know this.">Vous pouvez ignorer ces sections si vous les connaissez déjà.</span></span></p> -<h2 id="Mozilla_and_Firefox">Mozilla and Firefox</h2> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="The term Mozilla can be used to refer to -several concepts: the Mozilla project, the Mozilla Foundation, the -Mozilla Corporation and the old Mozilla browser.">Le terme <a class="external" href="http://fr.wikipedia.org/wiki/Mozilla" title="http://fr.wikipedia.org/wiki/Mozilla">Mozilla</a> sert à définir plusieurs concepts : le projet Mozilla, la <a class="external" href="http://fr.wikipedia.org/wiki/Fondation_Mozilla" title="http://fr.wikipedia.org/wiki/Fondation_Mozilla">fondation Mozilla</a>, la <a class="external" href="http://fr.wikipedia.org/wiki/Mozilla_Corporation" title="http://fr.wikipedia.org/wiki/Mozilla_Corporation">Mozilla Corporation</a> et le vieux <a class="external" href="http://fr.wikipedia.org/wiki/Mozilla_Application_Suite" title="http://fr.wikipedia.org/wiki/Mozilla_Application_Suite">navigateur Mozilla</a>. </span><span title='Even Firefox is sometimes referred to as "Mozilla".'>Même Firefox est parfois appelé "Mozilla". </span><span style="background-color: rgb(255, 255, 255);" title="If you're -unfamiliar with these terms, it's good that you take some time and learn -a little about Mozilla.">Si vous n'êtes pas familier avec ces termes, il est bon que vous prendre un peu de temps et d'en apprendre un peu plus sur Mozilla. </span><span style="background-color: rgb(255, 255, 255);" title="This will help you understand the culture that surrounds the -Mozilla community.">Cela vous aidera à comprendre la culture qui entoure la communauté Mozilla.</span></span></p> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="Mozilla has spawned several products and -projects, the most notable being the Mozilla Firefox web browser, -currently the second most used browser in the world, with a very large -and growing user base and a very large and growing contributor and -developer community.">Mozilla a donné naissance à plusieurs <a class="external" href="http://www.mozilla.org/projects/" title="http://www.mozilla.org/projects/">produits et projets</a>, le plus important étant le navigateur Web Mozilla Firefox, qui est actuellement le deuxième navigateur le plus utilisé dans le monde, avec une base d'utilisateurs très importante et croissante et un nombre de contributeurs </span></span><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="Mozilla has spawned several products and -projects, the most notable being the Mozilla Firefox web browser, -currently the second most used browser in the world, with a very large -and growing user base and a very large and growing contributor and -developer community.">et une communauté de développeurs </span></span><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="Mozilla has spawned several products and -projects, the most notable being the Mozilla Firefox web browser, -currently the second most used browser in the world, with a very large -and growing user base and a very large and growing contributor and -developer community.">très importants et croissants. </span><span style="background-color: rgb(255, 255, 255);" title="Firefox is one of the most successful open source projects in -history, combining the openness, standards-compliance and sophistication -of open source with the focus on user experience and powerful marketing -of more commercial offerings.">Firefox est l'un des projet libre les plus réussis dans l'histoire, combinant l'ouverture, aux normes de conformité et de la sophistication de l'open source en mettant l'accent sur l'expérience utilisateur et sur un marketing puissant d'offres commerciales.</span></span></p> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="Version 1.0 of Firefox was released in -November 2004, version 2.0 in October 2006, and version 3.0 in June -2008.">La version 1.0 de Firefox a été publiée en Novembre 2004, la version 2.0 en Octobre 2006, et la version 3.0 en Juin 2008. </span><span style="background-color: rgb(255, 255, 255);" title="Version 3.0 -includes a wide variety of changes, some of which are not -backwards-compatible, so you need to take this into account when -building extensions.">La version 3.0 comprend une grande variété de modifications, dont certaines ne sont pas rétro-compatibles, donc vous devez en tenir compte lors du développement d'extensions. </span><span style="background-color: rgb(255, 255, 255);" title="This tutorial -focuses on development for Firefox 3.0 and above, but most of it applies -for the Firefox 2 and Firefox 1 lines as well.">Ce tutoriel se concentre sur le développement de Firefox 3.0 et suivant, mais une majorité de son contenu s'applique également pour Firefox 2 et Firefox 1. </span><span title="The tutorial will specify when a certain solution works only on -newer versions of Firefox.">Le tutoriel précisera quand une solution ne fonctionne que sur certaines versions les plus récentes de Firefox.</span></span></p> -<div class="note"> - <p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title="We recommend that you develop your -extensions for Firefox 3 and above.">Nous vous recommandons de développer vos extensions pour Firefox 3 et plus. </span><span style="background-color: rgb(255, 255, 255);" title="Firefox 3 users -will shortly be the majority of Firefox users, and the advantages of -using the new features of Firefox 3 are significant.">Les utilisateurs de Firefox 3 seront bientôt la majorité des utilisateurs de Firefox, et les avantages d'utiliser les nouvelles fonctionnalités de Firefox 3 sont importants.</span></span></p> -</div> -<h2 id="XUL">XUL</h2> -<p><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title='XUL (pronounced "zool") is one of -many technologies used for creating Mozilla-based products and -extensions.'><a href="/fr/XUL" title="fr/XUL">XUL</a> (prononcez «zool») est l'une des nombreuses technologies utilisées pour créer des produits </span></span><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title='XUL (pronounced "zool") is one of -many technologies used for creating Mozilla-based products and -extensions.'>et des extensions </span></span><span class="long_text" id="result_box"><span style="background-color: rgb(255, 255, 255);" title='XUL (pronounced "zool") is one of -many technologies used for creating Mozilla-based products and -extensions.'>basés sur Mozilla. </span><span style="background-color: rgb(255, 255, 255);" title="It is only one part of the development landscape, but given that -it's practically exclusive to Mozilla, it tends to be used to identify -all Mozilla-related development.">C'est seulement une partie de l'environnement de développement, mais étant donné qu'il est pratiquement exclusif à Mozilla, il tend à être utilisé pour identifier tous les développements liés à Mozilla. </span><span style="background-color: rgb(255, 255, 255);" title="You'll sometimes read terms like "XUL -applications" and "XUL extensions", but rarely will they -refer to projects that are exclusively built with XUL.">Vous verrez parfois écrit des termes comme "applications XUL" et "extensions XUL", mais rarement ils vont se référer à des projets qui sont exclusivement construits avec XUL. </span><span style="background-color: rgb(255, 255, 255);" title="It usually means that the projects were built using -Mozilla technologies.">Cela signifie généralement que les projets ont été construits en utilisant les technologies Mozilla. </span><span style="background-color: rgb(255, 255, 255);" title="Even this project, -called XUL School, covers several other technologies such as JavaScript, -CSS, XBL and XPCOM.">Même ce tutoriel couvre plusieurs autres technologies telles que JavaScript, CSS, XBL et XPCOM.</span></span></p> -<h2 id="Gecko">Gecko</h2> -<p>Le <a href="/fr/Gecko" title="fr/Gecko">moteur Gecko</a> est la partie de Firefox utilisée pour le rendu des pages Web et sa propre interface utilisateur. Vous pouvez identifier le niveau de compatibilité des standards du Web dans les <a class="external" href="http://fr.wikipedia.org/wiki/Gecko_%28moteur_de_rendu%29#Logiciels_utilisant_Gecko" title="http://fr.wikipedia.org/wiki/Gecko_(moteur_de_rendu)#Logiciels_utilisant_Gecko">navigateurs basés sur Gecko</a> en regardant leur chaîne d'<a class="external" href="http://fr.wikipedia.org/wiki/User-Agent" title="http://fr.wikipedia.org/wiki/User-Agent">agent utilisateur</a>, qui devrait inclure la version Gecko. Les versions de Gecko sont indépendantes des versions de Firefox, et vous pouvez voir une cartographie des versions de Firefox et les versions Gecko sur la <a href="/fr/Gecko" title="fr/Gecko">page Gecko</a>. La chaîne d'agent utilisateur pour Firefox au moment d'écrire ces lignes (en anglais américain, Mac OS X) est la suivante :</p> -<p>Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:<strong>1.9.2</strong>) Gecko/20100115 Firefox/3.6</p> -<p>La section en surbrillance est la version Gecko: 1.9.2. Vous pouvez lire et copier la chaîne de l'agent utilisateur de n'importe quelle fenêtre de Firefox, en choisissant "? > À propos de Mozilla Firefox" dans le menu principal ("Firefox > À propos de Mozilla Firefox", sur Mac).</p> -<h2 id="XULRunner">XULRunner</h2> -<p>Firefox et d'autres applications Mozilla peuvent être considérés comme composés de deux parties distinctes : une couche d'interface utilisateur qui est distincte pour chaque projet, et une plate-forme commune sur laquelle la couche d'interface est construite. Cette plate-forme est connue sous le nom de <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a>. XULRunner inclut le moteur de rendu Gecko, la <a href="/fr/Necko" title="fr/Necko">bibliothèque réseau Necko</a>, et plusieurs autres composants qui permettent aux gestionnaires de fichiers OS indépendant, l'accessibilité et la localisation, entre autres. C'est cette plate-forme très puissante qui a permis une croissance rapide de la communauté de développement autour de Mozilla et Firefox.</p> -<p>XULRunner est disponible sous forme binaire sur la <a href="/fr/XULRunner" title="fr/XULRunner">page XULRunner</a>, et il est la base de plusieurs projets, tels que Songbird, Miro et Eudora. Il y a une liste très complète d'applications XULRunner dans le <a href="/fr/Florilège_des_applications_XULrunner" title="fr/Florilège des applications XULrunner">Hall of Fame XULRunner</a>.</p> -<h2 id="Sur_le_tutoriel">Sur le tutoriel</h2> -<p>Avec ce rappel des concepts de base, nous pouvons maintenant aller droit au développement d'extensions. Vous êtes probablement encore à vous demander qu'est-ce qu'est exactement une extension, ce qu'elle fait, et comment vous pouvez en faire. Eh bien, tout ce tutoriel est consacré à vous l'expliquer.</p> -<p>Bienvenue dans le monde du développement d'extensions. Maintenant, allons-y.</p> -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox">Suivant »</a></p> -</div> -<p><span style="font-size: small;">Ce tutoriel a été gracieusement offert à Mozilla par Appcoast.</span></p> diff --git a/files/fr/archive/mozilla/xul/vulgarisation_xul/l'essentiel_d'une_extension/index.html b/files/fr/archive/mozilla/xul/vulgarisation_xul/l'essentiel_d'une_extension/index.html deleted file mode 100644 index 455bc53fb1..0000000000 --- a/files/fr/archive/mozilla/xul/vulgarisation_xul/l'essentiel_d'une_extension/index.html +++ /dev/null @@ -1,412 +0,0 @@ ---- -title: L'essentiel d'une extension -slug: Archive/Mozilla/XUL/Vulgarisation_XUL/L'essentiel_d'une_extension -translation_of: Archive/Add-ons/Overlay_Extensions/XUL_School/The_Essentials_of_an_Extension ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox" style="float: left;">« Précédent</a><a href="/fr/docs/XUL_School/Setting_Up_a_Development_Environment">Suivant »</a></p> -</div> - -<h2 id="Le_fichier_install.rdf">Le fichier install.rdf</h2> - -<p>Dans la section précédente, nous avons examiné le contenu de l'extension "Hello World". Maintenant, nous allons examiner dans son code et ses fichiers, en commençant par le fichier <em>install.rdf</em>. Vous pouvez l'ouvrir avec n'importe quel éditeur de texte.</p> - -<p>Le fichier est formaté selon un type particulier XML appelé <a class="external" href="http://fr.wikipedia.org/wiki/Resource_Description_Framework" title="http://fr.wikipedia.org/wiki/Resource_Description_Framework">RDF</a>. RDF est utilisé pour le mécanisme de stockage centralisé pour Firefox, mais il est maintenant remplacé par un système plus simple de base de données. Nous aborderons ces deux systèmes de stockage plus loin dans le tutoriel.</p> - -<p>Maintenant, regardons les parties importantes du fichier.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><em:id>helloworld@xulschool.com</em:id></pre> -</div> -</div> - -<p>Il s'agit d'un identifiant unique pour l'extension. Firefox en a besoin pour distinguer votre extension des autres, il est donc nécessaire que cet identifiant soit unique.</p> - -<p>Il existe deux normes acceptées pour les IDS des extensions. Le premier est le format de type e-mail comme dans l'exemple "Hello World", qui devrait être quelque chose comme <em><project-name>@<yourdomain></em>. L'autre pratique standard consiste à utiliser une chaîne UUID générée qui est extrêmement peu probable à être reproduite. Les systèmes basés sur Unix ont un outil en ligne de commande appelé <em>uuidgen</em> qui génère des UUIDs. Il existe également des outils téléchargeables disponibles pour toutes les plates-formes pour les générer. Les crochets entourant ne sont que la notation, et il s'agit d'une simple notation courante. Tant que votre id a une certaine unicité, il est possible d'utiliser l'une des deux formes.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><em:name>XUL School Hello World</em:name> -<em:description>Welcome to XUL School!</em:description> -<em:version>0.1</em:version> -<em:creator>Appcoast</em:creator> -<span class="code-comment"><em:homepageURL>https://developer.mozilla.org/en/XUL_School</em:homepageURL></span></pre> -</div> -</div> - -<p>Il s'agit des données qui sont affichées avant et après l'installation de l'extension, et que vous pouvez voir dans la fenêtre des modules complémentaires. L'URL de la page d'accueil peut être visité par un clic droit sur l'extension et en choisissant Visitez la page Web. Il y a beaucoup d'autres balises pouvant être ajoutées, pour les auteurs et les traducteurs. La <a href="/fr/Manifestes_d'installation" title="fr/Manifestes_d'installation">spécification complète</a> du fichier install.rdf contient tous les détails.</p> - -<p>Comme les extensions peuvent être traduites en plusieurs langues, il est souvent nécessaire de traduire la description de l'extension, ou même son nom. Sur Firefox 3 et suivant, une description localisée et un nom peuvent être ajoutés par le code suivant :</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><em:localized> - <Description> - <em:locale>es-ES</em:locale> - <em:name>XUL School Hola Mundo</em:name> - <em:description>Bienvenido a XUL School!</em:description> - </Description> -</em:localized></pre> -</div> -</div> - -<p>La chaîne de localisation <em>es-ES</em> indique que la langue est l'espagnol (es) pour l'Espagne (ES). Vous pouvez ajouter autant de sections <em><em:localized></em> que vous avez besoin. Pour Firefox 2, la <a href="/fr/Localisation_des_descriptions_d'extensions#La_localisation_avant_Gecko_1.9" title="fr/Localisation des descriptions d'extensions#La localisation avant Gecko 1.9">localisation de ce fichier</a> est un peu plus compliqué. Nous verrons la localisation plus loin dans cette section.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><em:type>2</em:type></pre> -</div> -</div> - -<p>Ceci précise que le module en cours d'installation est une extension. Vous pouvez consulter les différents types possibles dans <a href="/fr/Manifestes_d'installation#Type" title="fr/Manifestes d'installation#Type">la spécification install.rdf</a>.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><em:targetApplication> - <Description> - <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id> - <em:minVersion>3.0</em:minVersion> - <em:maxVersion>3.6.*</em:maxVersion> - </Description> -</em:targetApplication></pre> -</div> -</div> - -<p>Ce nœud spécifie l'application cible et les versions cibles de l'extension, en particulier Firefox de la version 3.0 au versions 3.6.*. L'UUID est l'ID unique de Firefox. Les autres applications Mozilla et basées sur Mozilla telles que Thunderbird et Seamonkey ont le leurs. Vous pouvez avoir une extension qui fonctionne sur de multiples applications et versions. Par exemple, si vous créez une extension de Firefox, il faudrait normalement peu d'effort pour la porter sur Flock ou sur SeaMonkey, qui ont une interface utilisateur et des caractéristiques très similaires.</p> - -<p>Le min et max de la version spécifie l'étendue des versions où l'extension peut être installée. Des détails sont disponibles sur le <a href="/en/Toolkit_version_format" title="en/Toolkit version format">format de version</a>. Si l'application ou la plage de version ne correspondent pas, vous ne serez pas autorisé à installer l'extension, ou l'extension sera installée dans un état désactivé. Les utilisateurs peuvent désactiver les contrôles version grâce à des préférences ou d'installer des modules complémentaires comme <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/15003" title="https://addons.mozilla.org/en-US/firefox/addon/15003">Add-on Compatibility Reporter</a>.</p> - -<p>Ce sont les seules informations dont Firefox et d'autres applications Mozilla ont besoin pour installer un module complémentaire. Toutes erreurs ou manques d'information entraînent un échec du processus d'installation, ou laissent l'extension s'installer dans un état désactivé.</p> - -<h2 id="Le_fichier_chrome.manifest">Le fichier chrome.manifest</h2> - -<blockquote> -<p>Le chrome est l'ensemble des éléments de l'interface utilisateur d'une application qui sont situés en dehors de la zone de contenu d'une fenêtre. Les barres d'outils, les barres de menus, les barres de progression, et les titres de fenêtres sont tous des exemples d'éléments qui font habituellement partie du chrome.</p> -</blockquote> - -<p>Citation de <a href="/fr/Enregistrement_chrome" title="fr/Enregistrement chrome">Enregistrement Chrome</a>.</p> - -<p>En d'autres termes, le chrome correspond à tout ce que vous voyez dans Firefox. Toutes les fenêtres Firefox peuvent être considérées comme ayant deux parties : (1) le chrome et (2) peut-être une zone de contenu, comme celui qui affiche les pages Web dans un onglet Firefox. Les fenêtres comme le gestionnaire de modules complémentaires et de la fenêtre de téléchargements sont en chrome pur. La plupart du code pour une extension réside dans le dossier chrome, tout comme dans l'exemple Hello World.</p> - -<p>Les fichiers Chrome sont tous empaquetés dans une archive JAR, généralement nommée d'après l'extension. Il n'est pas nécessaire d'empaqueter les fichiers chrome, mais c'est une pratique courante et recommandée pour des raisons de performances.</p> - -<p>Comme nous l'avons vu dans la structure des répertoires de l'extension décompressée, le chrome est composé de 3 sections : content, locale et skin. Les 3 sont nécessaires pour la plupart des extensions. Si nous ouvrons le fichier chrome.manifest (encore une fois, un éditeur de texte fera l'affaire), nous voyons que les 3 mêmes sections sont mentionnés :</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">content xulschoolhello jar:chrome/xulschoolhello.jar!/content/ -skin xulschoolhello classic/1.0 jar:chrome/xulschoolhello.jar!/skin/ -locale xulschoolhello en-US jar:chrome/xulschoolhello.jar!/locale/en-US/</pre> -</div> -</div> - -<p>Le fichier <em>chrome.manifest</em> indique à Firefox où chercher les fichiers chrome. Le texte est espacé pour ressembler à un tableau, mais ce n'est pas nécessaire. L'analyseur ignorera les espaces répétées.</p> - -<p>Le premier mot d'une ligne indique à Firefox ce qui est déclaré (le contenu, le thème graphique, la langue, ou d'autres choses que nous verrons plus loin). Le second est le nom du paquet, que nous expliquerons bientôt. Les paquets des thèmes et langages ont une troisième valeur afin de définir ce qu'ils étendent. Il peut y avoir plusieurs thèmes ou langages. Le cas le plus fréquent est d'avoir une seule entrée pour le thème correspondant au thème global <em>classic/1.0</em>, et des entrées multiples de langages, une pour chaque langue. Enfin, l'emplacement est spécifié. Note sur le schéma jar: ; il indique à Firefox de d'ouvrir le fichier JAR et de lire les fichiers à leur emplacement. Si vous voulez avoir une extension avec un répertoire chrome non empaqueté, il vous suffit de modifier les chemins d'accès en quelque chose comme <em>chrome/ content/</em>.</p> - -<p>Quelques options supplémentaires peuvent être inclues dans les entrées d'un fichier <em>chrome.manifest</em>. Elles sont documentées dans la page <a href="/fr/Enregistrement_chrome" title="fr/Enregistrement chrome">Enregistrement Chrome</a>. Notamment, nous pouvons avoir des entrées qui sont spécifiques à l'OS. Ceci est important, spécialement dans Firefox 3 et plus, où l'apparence du navigateur est très différente selon le système d'exploitation. Si notre extension doit avoir une apparence différence sur d'autres systèmes, nous pourrions modifier le fichier manifest comme ceci :</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">content xulschoolhello jar:chrome/xulschoolhello.jar!/content/ -skin xulschoolhello classic/1.0 jar:chrome/xulschoolhello.jar!/skin/unix/ -skin xulschoolhello classic/1.0 jar:chrome/xulschoolhello.jar!/skin/mac/ os=Darwin -skin xulschoolhello classic/1.0 jar:chrome/xulschoolhello.jar!/skin/win/ os=WinNT -locale xulschoolhello en-US jar:chrome/xulschoolhello.jar!/locale/en-US/</pre> -</div> -</div> - -<p>De cette façon, nous pouvons avoir des thèmes graphiques distincts pour Windows, Mac OS X, et Linux (ainsi que d'autres systèmes de type Unix), définis chacun dans un répertoire distinct. Comme la plupart des autres systèmes sont basés sur Unix, le thème "unix" est la valeur par défaut, sans drapeaux.</p> - -<h2 id="Le_Chrome">Le Chrome</h2> - -<p>Comme mentionné précédemment, le chrome est composé de 3 sections : le contenu, le langage et le thème. Le contenu est la section la plus importante, contenant les fichiers de l'interface utilisateur (XUL) et du script (JS). La section du thème contient les fichiers définissant principalement l'apparence graphique de l'interface utilisateur (en utilisant le CSS et les images, tout comme les pages Web). Enfin, la section du langage regroupe tous les textes utilisés dans l'extension, dans des fichiers DTD et properties. Cette division permet aux développeurs de créer d'autres thèmes graphiques, et aux traducteurs de créer des versions dans des langues différentes, tout cela sans avoir à modifier votre extension ou votre code. Cela donne aux extensions Firefox beaucoup de flexibilité.</p> - -<p>Les fichiers Chrome sont accessibles via le protocole chrome. Les URIs chrome sont définis comme suit </p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">chrome:<span class="code-comment">//packagename/section/path/to/file</span></pre> -</div> -</div> - -<p>Ainsi, par exemple, si je veux accéder au fichier <em>browserOverlay.xul</em> dans l'extension, l'URI chrome serait <em><a class="external" rel="freelink">chrome://xulschoolhello/content/browserOverlay.xul</a></em>. Si vous avez trop de fichiers dans le contenu et vous souhaitez les organiser en sous-répertoires, il n'y a rien à changer de <em>chrome.manifest</em>, il vous suffit d'ajouter le chemin correspondant après <em>content</em> dans l'URI. Les fichiers des thèmes ou de langages fonctionnent de la même manière, et vous n'avez pas besoin de spécifier leurs noms exacts. Ainsi, pour accéder au fichier DTD dans l'exemple Hello World, le chemin de chrome est <em><a class="external" rel="freelink">chrome://xulschoolhello/locale/browserOverlay.dtd</a></em>. Firefox sait de quel fichier de traduction il s'agit.</p> - -<p>Voici une expérience intéressante. Ouvrez un nouvel onglet Firefox, tapez <em><a class="external" rel="freelink">chrome://mozapps/content/downloads/downloads.xul</a></em> dans votre barre d'adresse et appuyez sur ENTRER. Surpris ? Vous venez d'ouvrir la fenêtre des Téléchargements dans un onglet Firefox ! Vous pouvez accéder à un fichier chrome en tapant simplement son URI dans la barre d'adresse. Cela peut être utile si vous voulez inspecter les fichiers de script qui font partie de Firefox, d'autres extensions, ou de la votre. La plupart de ces fichiers sont ouverts sous forme de fichiers texte, à l'exception des fichiers XUL qui sont exécutés et affichés comme vous les verriez normalement sur une fenêtre.</p> - -<h3 id="Content">Content</h3> - -<p>Il y a 2 fichiers dans le répertoire content. Regardons le premier fichier XUL.</p> - -<p>Les fichiers <a href="/XUL" title="XUL">XUL</a> sont des fichiers XML qui définissent les éléments de l'interface utilisateur dans Firefox et les extensions Firefox. XUL a été inspiré par le HTML, donc vous verrez beaucoup de similitudes entre les deux. Cependant, XUL est aussi une amélioration par rapport à HTML, ayant appris de bon nombre des erreurs commises durant l'évolution de HTML. XUL permet de créer des interfaces plus riches et plus interactives que celles que vous pouvez créer avec le langage HTML, ou tout au moins XUL les rend plus facile.</p> - -<p>Les fichiers XUL définissent généralement l'une des deux choses suivantes : les fenêtres ou les superpositions (overlay). Le fichier que vous avez ouvert précédemment, <em>downloads.xul</em>, a un code qui définit la fenêtre de téléchargements. Le fichier XUL inclus dans l'extension Hello World est une superposition. Une superposition étend une fenêtre existante, en ajoutant de nouveaux éléments ou en remplaçant certains des éléments qu'elle contient. La ligne que nous avons sauté dans les lignes du fichier <em>chrome.manifest</em> décrit que ce fichier XUL est une superposition de la fenêtre principale du navigateur :</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">overlay chrome:<span class="code-comment">//browser/content/browser.xul chrome://xulschoolhello/content/browserOverlay.xul</span></pre> -</div> -</div> - -<p>With this line, Firefox knows that it needs to take the contents of <em>browserOverlay.xul</em> and overlay it on the main browser window, <em>browser.xul</em>. You can declare overlays for any window or dialog in Firefox, but overlaying the main browser window is the most common case by far.</p> - -<p>Now let's look at the contents of our XUL file. We'll skip the first few lines because they relate to skin and locale, which we'll cover later.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><overlay id="xulschoolhello-browser-overlay" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"></pre> -</div> -</div> - -<p>The root element in the file is an <em>overlay</em>. Other XUL documents use the <em>window</em> or <em>dialog</em> tag. The element has a unique id, which you should have on most elements in your XUL. The second attribute is the namespace, which is something you should always define in your XUL root element. It says that this node and all child nodes are XUL. You only need to change namespace declarations when you combine different types of content, such as XUL with HTML or SVG.</p> - -<div class="panel" style="border-width: 1px;"> -<div class="panelContent"> -<div class="note">You may have noticed the naming we use on several places, such as the id <em>xulschoolhello-browser-overlay</em>. This is the namespacing standard that we use to avoid conflicts with Firefox and other extensions, as well as making some development tasks easier. We namespace all ids and style classes in overlay elements because they will be mixed with other elements in the main browser window. If we used generic ids like <em>container</em> or <em>input</em>, they will likely conflict with ids used within Firefox, or with ids from other extension overlays. Using namespaces minimizes compatibility problems with other extensions. We use camel casing for file names, and all lower case with dashes for element ids and CSS style class names.</div> -</div> -</div> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><script type=<span class="code-quote">"application/x-javascript"</span> - src=<span class="code-quote">"chrome:<span class="code-comment">//xulschoolhello/content/browserOverlay.js"</span> /></span></pre> -</div> -</div> - -<p>Just like in HTML, this includes a JavaScript script file. You can have as many <em>script</em> elements on a XUL file as you need. We'll look into its code later.</p> - -<div class="panel" style="border-width: 1px;"> -<div class="panelContent"> -<div class="note">You also probably noticed how we format our code, and wonder about the rules we follow. Our general rule on line length is not having lines longer than 80 characters. This feels very restrictive, specially with XML files, but the number was chosen to allow pretty much any text editor to handle these files easily. Even old command line editors work well with files that cut their lines at 80 characters. The tabulation is very straightforward: 2 blank space indents. We never use actual tab characters, with the exception of Makefiles, which will be covered later on. Most of our coding standards are based on Mozilla's or other known and used standards.</div> -</div> -</div> - -<p> We'll skip some code that is covered in the locale section, moving on to the most important part of the content:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><menubar id="main-menubar"> - <menu id="xulschoolhello-hello-menu" label="&xulschoolhello.hello.label;" - accesskey="&xulschoolhello.helloMenu.accesskey;" insertafter="helpMenu"> - <menupopup> - <menuitem id="xulschoolhello-hello-menu-item" - label="&xulschoolhello.hello.label;" - accesskey="&xulschoolhello.helloItem.accesskey;" - oncommand="XULSchoolChrome.BrowserOverlay.sayHello(event);" /> - </menupopup> - </menu> -</menubar></pre> -</div> -</div> - -<p>This is the code that adds the Hello World menu to the browser window. In order to write this code, we needed some knowledge of the XUL code in <em>browser.xul</em>. We needed to know that the id of the main menu is <em>main-menubar</em>. We're adding a menu of our own, and telling Firefox to add it in the main menu bar, right after the Help menu. That's the purpose of the attribute:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">insertafter=<span class="code-quote">"helpMenu"</span></pre> -</div> -</div> - -<p><em>helpMenu</em> is the id of the menu element that corresponds to the Help menu in the main menu of the browser. We'll see later how we can find out things like the ids of browser elements, but for now let's look at the elements that compose the Hello World menu.</p> - -<p>The <a href="/en/XUL/menubar" title="en/XUL/menubar">menubar</a> element represents the menu bar you normally see at the top of an application window. The main Firefox window has one, but few of its other windows do. It's also rare for additional extension windows to have their own menu bars.</p> - -<p>We added the Hello World menu right in the "root" of the menu bar so that it would be very easy for you to spot it, but this is not a recommended practice. Imagine if all extensions added menus to the top menu bar; having a few extensions would make the menu look like an airplane dashboard, full of options. The recommended location for extension menus is under the <em>Tools</em> menu, so the code should really look like this:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><menupopup id=<span class="code-quote">"menu_ToolsPopup"</span>> - <menu id=<span class="code-quote">"xulschoolhello-hello-menu"</span> label=<span class="code-quote">"&</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.hello.label;"</span> - accesskey=<span class="code-quote">"&</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.helloMenu.accesskey;"</span> - insertafter=<span class="code-quote">"javascriptConsole,devToolsSeparator"</span>> - <menupopup> - <menuitem id=<span class="code-quote">"</span><span class="code-quote">xulschoolhello</span><span class="code-quote">-hello-menu-item" - </span> label=<span class="code-quote">"&</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.hello.label;"</span> - accesskey=<span class="code-quote">"&</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.helloItem.accesskey;"</span> - oncommand=<span class="code-quote">"XULSchoolChrome.BrowserOverlay.sayHello(event);"</span> /> - </menupopup> - </menu> -</menupopup></pre> -</div> -</div> - -<p>We're overlaying a menu that is deeper into the XUL tree, but it doesn't matter because all we need is the id of the element we want to overlay. In this case it is the <a href="/en/XUL/menupopup" title="en/XUL/menupopup">menupopup</a> element that's inside of the Tools <a href="/en/XUL/menu" title="en/XUL/menu">menu</a> element. The <em>insertafter</em> attribute tells Firefox to add the menu below the Error Console item (formerly known as JavaScript Console) in the Tools menu, just like recommended in the <a href="/en/Extension_Etiquette" title="en/Extension Etiquette"><span class="external">Extension Etiquette page</span></a>. We'll discuss more about menus later on in the tutorial. For now let's focus on the following line:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">oncommand=<span class="code-quote">"XULSchoolChrome.BrowserOverlay.sayHello(event);"</span></pre> -</div> -</div> - -<p>This attribute defines an event handler. The <em>command</em> event is the most frequently used in Firefox, since it corresponds to the main action for most UI elements. The value of the attribute is JavaScript code that invokes a function. This function is defined in the JS file that was included with the <em>script</em> tag. The JS function will be called once the user clicks on the menu item in the Hello World menu. All event handlers define a special object named <em>event</em>, which is usually good to pass as an argument to the function. Event handlers are explained in grater depth further ahead.</p> - -<p>Now let's look at the JavaScript file and see what's going on when the event is fired.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="brush: js">/** - * XULSchoolChrome namespace. - */ -if ("undefined" == typeof(XULSchoolChrome)) { - var XULSchoolChrome = {}; -};</pre> -</div> -</div> - -<p>The <em>XULSchoolChrome</em> namespace is defined. All objects and variables we define in this JavaScript are global, meaning that scripts in Firefox and other extensions can see them and interact with them. This also means that if we define an object called <em>MenuHandler</em> or some other generic name, it's likely going to conflict with an existing object. What we do here is define a single global object: <em>XULSchoolChrome</em>. Now we know that all of our objects are inside this object, which is unlikely to be duplicated or overwritten by other extensions.</p> - -<p>You can read more about the <a href="/en/JavaScript/Reference/Operators/Special/typeof" title="en/Core JavaScript 1.5 -Reference/Operators/Special Operators/typeof Operator"><span class="external">typeof operator</span></a>. If you're unfamiliar with JavaScript or this particular syntax, initializing an object as <em>{}</em> is the equivalent of initializing it to <em>new Object()</em>.</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="brush: js">/** - * Controls the browser overlay <span class="code-keyword">for</span> the Hello World extension. - */ -XULSchoolChrome.BrowserOverlay = {</pre> -</div> -</div> - -<p>Finally, <em>BrowserOverlay</em> is our object. Naming and referencing objects in such a long and verbose manner can feel uncomfortable at first, but it's worth the cost.</p> - -<div class="panel" style="border-width: 1px;"> -<div class="panelContent"> -<div class="note">We use <a class="external" href="http://java.sun.com/j2se/javadoc/writingdoccomments/index.html">Javadoc</a> style comments on all namespaces, objects and object members. This is a similar standard to the one used in Mozilla code, and some tools can generate documentation automatically from Javadoc.</div> -</div> -</div> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="brush: js">sayHello : function(aEvent) { - let stringBundle = document.getElementById("xulschoolhello-string-bundle"); - let message = stringBundle.getString("xulschoolhello.greeting.label"); - - window.alert(message); -}</pre> -</div> -</div> - -<p>And, finally, this is our function declaration. Three lines of code are all we need for it to work. The first line in the body of the function declares a variable that will hold the <a href="/en/XUL/stringbundle" title="en/XUL/stringBundle">stringbundle</a> element defined in the overlay. The variable is declared using <em>let,</em> which is similar to <em>var</em> but with more restricted scope. Here you can read more about <a href="/en/JavaScript/New_in_JavaScript/1.7#Block_scope_with_let" title="en/New in JavaScript 1.7#Block scope -with let"><span class="external">let declarations</span></a>. It's worth noting that this is a relatively new addition to JavaScript in Firefox and you should use <em>var</em> if you're creating an extension compatible with very old versions.</p> - -<p>Just like in regular JS, we can use the <a href="/en/DOM" title="en/DOM"><span class="external">DOM</span></a> (Document Object Model) in order to manipulate the XUL document. First we get a reference of the <a href="/en/XUL/stringbundle" title="en/XUL/stringbundle"><span class="external">stringbundle element</span></a> in the document. This is a special element that allows us to obtain localized strings dynamically, by only providing a "key" that identifies the string. This is what we do on the second line. We call the <a href="/en/XUL/stringbundle#m-getString" title="en/XUL/stringbundle#m-getString">getString method</a> of the bundle element and get the localized message to be displayed. We then call the <a href="/en/DOM/window.alert" title="en/DOM/window.alert">window.alert</a> function with the message, just like we would do in an HTML document.</p> - -<h3 id="Locale">Locale</h3> - -<p>There are two types of locale files: DTD and properties, and in this example we use them both. DTD is the most efficient way of showing text in XUL, so you should use it whenever possible. It is somewhat inflexible so it can't be used for dynamically generated text, hence the need for an alternate way of getting localized strings.</p> - -<p>Looking back at the menu code, you probably noticed some attributes such as this:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">label=<span class="code-quote">"&xulschoolhello.hello.label;"</span> accesskey=<span class="code-quote">"&xulschoolhello.helloItem.accesskey;"</span></pre> -</div> -</div> - -<p>These attributes define the text that you see on the menus, and they are string keys that are defined in our DTD file, <em>browserOverlay.dtd</em>. The DTD file was included in the XUL file with the following code:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><!DOCTYPE overlay SYSTEM "chrome://xulschoolhello/locale/browserOverlay.dtd" ></pre> -</div> -</div> - -<p>And in the DTD file you can see the association between keys and localized strings:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><!ENTITY xulschoolhello.hello.label <span class="code-quote">"Hello World!"</span>> -<!ENTITY xulschoolhello.helloMenu.accesskey <span class="code-quote">"l"</span>> -<!ENTITY xulschoolhello.helloItem.accesskey <span class="code-quote">"H"</span>></pre> -</div> -</div> - -<p>Notice that on the XUL file you enclose the string key with <em>&</em> and <em>;</em> while on the DTD file you only specify the key. You may get weird parsing errors or incorrect localization if you don't get it right.</p> - -<p>Access keys are the shortcuts that allow you to quickly navigate a menu using only the keyboard. They are also the only way to navigate a menu for people with accessibility problems, such as partial or total blindness, or physical disabilities that make using a mouse very difficult or impossible. You can easily recognize the access keys on Windows because the letter that corresponds to the access key is underlined, as in the following image:</p> - -<div> -<p><img alt="" class="internal" src="../../../../@api/deki/files/4226/=accesskeys.png" style="height: 58px; width: 167px;"></p> -</div> - -<p>Most user interface controls have the <em>accesskey</em> attribute, and you should use it. The value of the access key is localized because it should match a letter in the label text. You should also be careful to avoid access key repetition. For example, within a menu or submenu, access keys should not be repeated. In a window you have to be more careful picking access keys because there are usually more controls there. You have to be specially careful when picking access keys on an overlay. In our case, we can't use the letter "H" as an accesskey in the Main menu item, because it would be the same as the access key in the Help menu. Same goes with "W" and the Window menu on Mac OS. So we settled on the letter "l".</p> - -<p>DTD strings are resolved and set when the document is being loaded. If you request the <em>label</em> attribute value for the Hello World menu using DOM, you get the localized string, not the string key. You cannot dynamically change an attribute value with a new DTD key, you have to set the new value directly:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="brush: js">let helloItem = document.getElementById(<span class="code-quote">"xulschoolhello-hello-menu-item"</span>); - -<span class="code-comment">// The alert will say <span class="code-quote">"Hello World!"</span> -</span>alert(helloItem.getAttribute(<span class="code-quote">"label"</span>)); -<span class="code-comment">// Wrong -</span>helloItem.setAttribute(<span class="code-quote">"label"</span>, <span class="code-quote">"&</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.hello2.label;"</span>); -<span class="code-comment">// Better -</span>helloItem.setAttribute(<span class="code-quote">"label"</span>, <span class="code-quote">"Alternate message"</span>); -<span class="code-comment">// Right! -</span>helloItem.setAttribute(<span class="code-quote">"label"</span>, someStringBundle.getString(<span class="code-quote">"</span><span class="code-quote">xulschoolhello</span><span class="code-quote">.hello2.label"</span>));</pre> -</div> -</div> - -<p>This is the reason DTD strings are not a solution for all localization cases, and the reason we often need to include string bundles in XUL files:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><stringbundleset id="stringbundleset"> - <stringbundle id="xulschoolhello-string-bundle" - src="chrome://xulschoolhello/locale/browserOverlay.properties" /> -</stringbundleset></pre> -</div> -</div> - -<p>The <a href="/en/XUL/stringbundleset" title="en/XUL/stringbundleset">stringbundleset</a> element is just a container for <a href="/en/XUL/stringbundle" title="en/XUL/stringbundle">stringbundle</a> elements. There should only be one per document, which is the reason why we overlay the <em>stringbundleset</em> that is in <em>browser.xul</em>, hence the very generic id. We don't include the <em>insertbefore</em> or <em>insertafter</em> attributes because the ordering of string bundles doesn't make a difference. The element is completely invisible. If you don't include any of those ordering attributes in an overlay element, Firefox will just append your element as the last child of the parent element.</p> - -<p>All you need for the string bundle is an id (to be able to fetch the element later) and the chrome path to the properties file. And, of course, you need the properties file:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">xulshoolhello.greeting.label = Hi! How are you?</pre> -</div> -</div> - -<p>The whitespace around the equals sign is ignored. Just like in <em>install.rdf</em>, comments can be added using the # character at the beginning of the line. Empty lines are ignored as well.</p> - -<p>You will often want to include dynamic content as part of localized strings, like when you want to inform the user about some stat related to the extension. For example: "Found 5 words matching the search query". Your first idea would probably be to simply concatenate strings, and have one "Found" property and another "words matching..." property. This is not a good idea. It greatly complicates the work of localizers, and grammar rules on different languages may change the ordering of the sentence entirely. For this reason it's better to use parameters in the properties:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java">xulshoolhello.search.label = Found %S words matching the search query!</pre> -</div> -</div> - -<p>Then you use <a href="/en/XUL/stringbundle#m-getFormattedString" title="en/XUL/stringbundle#m-getFormattedString">getFormattedString</a> instead of <em>getString</em> in order to get the localized string. Thanks to this we don't need to have multiple properties, and life is easier for translators. You can read more about it on the <a href="/en/XUL_Tutorial/Property_Files#Text_Formatting" title="en/XUL Tutorial/Property Files#Text Formatting">Text Formatting section</a> of the XUL Tutorial. Also have a look at the <a href="/en/Localization_and_Plurals" title="en/Localization and Plurals">Plurals and Localization</a> article, that covers a new localization feature in Firefox 3 that allows you to further refine this last example to handle different types of plural forms that are also language-dependent.</p> - -<h3 id="Skin">Skin</h3> - -<p>Styling XUL is very similar to styling HTML. We'll look into some of the differences when we cover the XUL Box Model, and other more advanced topics. There isn't much styling you can do to a minimal menu and a very simple alert message, so the Hello World extension only includes an empty CSS file and the compulsory global skin file:</p> - -<div class="code panel" style="border-width: 1px;"> -<div class="codeContent panelContent"> -<pre class="code-java"><?xml-stylesheet type=<span class="code-quote">"text/css"</span> href=<span class="code-quote">"chrome:<span class="code-comment">//global/skin/"</span> ?> -</span><?xml-stylesheet type=<span class="code-quote">"text/css"</span> - href=<span class="code-quote">"chrome:<span class="code-comment">//xulschoolhello/skin/browserOverlay.css"</span> ?></span></pre> -</div> -</div> - -<p>The global skin CSS file holds the default styles for all XUL elements and windows. Forgetting to include this file in a XUL window usually leads to interesting and often unwanted results. In our case we don't really need to include it, since we're overlaying the main browser XUL file, and that file already includes this global CSS. At any rate it's better to always include it. This way it's harder to make the mistake of not including it. You can enter the chrome path in the location bar and inspect the file if you're curious.</p> - -<p>This covers all of the files in the Hello World extension. Now you should have an idea of the basics involved in extension development, so now we'll jump right in and set up a development environment. But first, a little exercise.</p> - -<h2 id="Exercise">Exercise</h2> - -<p>Change the welcome message that is displayed in the alert window and move the Hello World menu to the Tools Menu, where it belongs. Repackage the XPI and re-install it. You can just drag the XPI file to the browser and it will be installed locally. Test it and verify your changes worked. If you run into problems at installation, it's likely that you didn't reproduce the XPI structure correctly, maybe adding unnecessary folders.</p> - -<p>Once you're done, you can look at this reference solution: <a class="internal" href="/@api/deki/files/4227/=xulschoolhello2.xpi" title="/@api/deki/files/4227/=xulschoolhello2.xpi">Hello World 2</a>.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox" style="float: left;">« Précédent</a><a href="/fr/docs/XUL_School/Setting_Up_a_Development_Environment">Suivant »</a></p> -</div> - -<p><span style="font-size: small;">This tutorial was kindly donated to Mozilla by Appcoast.</span></p> diff --git a/files/fr/archive/mozilla/xul/vulgarisation_xul/premiers_pas_avec_les_extensions_firefox/index.html b/files/fr/archive/mozilla/xul/vulgarisation_xul/premiers_pas_avec_les_extensions_firefox/index.html deleted file mode 100644 index 417c76133f..0000000000 --- a/files/fr/archive/mozilla/xul/vulgarisation_xul/premiers_pas_avec_les_extensions_firefox/index.html +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Premiers pas avec les extensions Firefox -slug: Archive/Mozilla/XUL/Vulgarisation_XUL/Premiers_pas_avec_les_extensions_Firefox -translation_of: >- - Archive/Add-ons/Overlay_Extensions/XUL_School/Getting_Started_with_Firefox_Extensions ---- -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Introduction" style="float: left;">« Précédent</a><a href="/fr/docs/Vulgarisation_XUL/L'essentiel_d'une_extension">Suivant »</a></p> -</div> - -<h2 id="Qu'est-ce_qu'une_extension_Firefox">Qu'est-ce qu'une extension Firefox ?</h2> - -<blockquote> -<p>Les extensions ajoutent de nouvelles fonctionnalités à des applications Mozilla telles que Firefox et Thunderbird. Elles peuvent ajouter n'importe quoi depuis le bouton d'une barre d'outils à une fonctionnalité entièrement nouvelle. Ils permettent à l'application d'être personnalisée pour répondre aux besoins personnels de chaque utilisateur en fonctionnalités supplémentaires, tout en gardant des applications légères à télécharger.</p> -</blockquote> - -<p>Telle que décrit dans le texte cité, une extension est une petite application qui ajoute quelque chose de nouveau à une ou plusieurs applications Mozilla. Ce tutoriel se concentre sur des extensions pour Firefox, mais les mêmes (ou très similaires) principes s'appliquent à la création d'extensions pour d'autres applications comme Thunderbird, SeaMonkey, et Flock.</p> - -<p>Il est également intéressant de noter qu'il existe des différences entre la définition d'<em>extension</em> et de <em>module complémentaire</em>. Toutes les extensions sont des modules complémentaires, mais des modules complémentaires peuvent également être des thèmes, des plugins, ou paquetages de langue. Ce tutoriel porte sur le développement d'extensions, mais les thèmes et les paquetages de langues sont développés de manière très similaire. Les plugins sont tout à fait différents, et ils ne seront pas abordés dans ce tutoriel. Vous pourrez en savoir plus sur les plugins et leur développement dans la <a href="/fr/Mozilla/Add-ons/Plugins" title="fr/Plugins">page Plugins</a>.</p> - -<p>Firefox fournit une architecture très riche et flexible qui permet aux développeurs d'extensions d'ajouter des fonctionnalités avancées, de personnaliser l'expérience de l'utilisateur, et de remplacer ou d'enlever complètement des parties de votre navigateur. Le référentiel <a class="link-https" href="https://addons.mozilla.org" title="https://addons.mozilla.org/">Mozilla Add-ons</a> (AMO) regroupe un grand nombre d'extensions ayant une grande variété de fonctions : le filtrage de contenu (AdBlock Plus, NoScript), l'interaction d'application Web (Delicious Bookmarks, eBay Companion), le développement Web (DOM Inspector, Firebug) et la protection de l'enfance (Glubble pour les familles). Il s'agit d'extensions très avancées et complexes, et vous apprendrez plus qu'il n'en faut pour créer des extensions comme celles-ci (Glaxstar participe à 3 de celles qui sont énumérées).</p> - -<p>Nous commencerons par examiner une extension très simple.</p> - -<h2 id="L'extension_Hello_World">L'extension Hello World</h2> - -<p>Nos exemples d'extensions et ce tutoriel sont en général destinés à la version Firefox 3 et plus, mais la plupart fonctionne aussi sur les versions précédentes de Firefox. Nous essaierons de le préciser lorsque nous discuterons d'une fonction qui ne fonctionne que sur certaines versions de Firefox.</p> - -<p>Nous allons maintenant commencer par une extension basique "Hello World". Commençons par l'installation de l'extension. Cliquez sur le lien ci-dessous.</p> - -<div class="warning"> -<p>L'extension suivante servant d'exemple n'est pas signée numériquement. Pour pouvoir l'activer, vous devez disposer de Firefox Developer Edition et <a href="https://support.mozilla.org/fr/kb/signature-modules-complementaires-firefox#w_passer-outre-aa-la-signature-des-modules-complaementaires-utilisateurs-avancaes">désactiver le controle de la signature numérique</a>.</p> -</div> - -<p><a href="/@api/deki/files/5139/=xulschoolhello1.xpi" title="https://developer.mozilla.org/@api/deki/files/4225/=xulschoolhello1.xpi">Installation de Hello World</a></p> - -<p>Ce lien déclenchera une installation ou un téléchargement de fichier, en fonction du Content-type utilisé par le serveur Web. Le type de contenu approprié pour déclencher une installation est <strong>application/x-xpinstall</strong>. Dans ce cas, un téléchargement de fichier doit se produire.</p> - -<p>Si le type de contenu est défini correctement, vous serez informé que le site n'est pas autorisé à installer des modules complémentaires sous Firefox. Il s'agit d'une mesure de sécurité qui empêche des sites d'installer des extensions sans le consentement de l'utilisateur. Cela est nécessaire car les extensions malveillantes peuvent avoir le même niveau de dommage que tout programme malveillant : le vol de données, l'effacement ou le remplacement des fichiers, et entraîner des comportements indésirables en général. AMO est le seul site de pré-autorisés car tous les modules complémentaires publiés sur l'AMO sont passés par un processus d'examen qui comprend des contrôles de sécurité.</p> - -<p>Après avoir téléchargé le fichier, vous pouvez le faire glisser et le déposer dans la zone de contenu Firefox, et l'installation devrait commencer.</p> - -<p>Vous verrez une fenêtre vous indiquant que vous êtes sur le point d'installer une extension, avec quelques informations supplémentaires telles que le nom de son auteur. Vous verrez un message disant que l'auteur ne peut être vérifié. Seules les extensions signées avec un certificat numérique peuvent être authentifiées. Les extensions signées sont rares, mais nous allons aborder la façon de les signer plus tard.</p> - -<p>Cliquez sur le bouton Installer maintenant. Après que l'extension soit installée, il vous sera demandé de redémarrer Firefox. L'installation, la désinstallation, l'activation et la désactivation des modules complémentaires (exceptés les plugins) nécessitent un redémarrage pour terminer, et il n'y a pas d'autre moyen de faire. C'est un point important à garder à l'esprit si vous construisez une extension qui manipule les autres extensions ou des thèmes. Il y a <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=256509" title="https://bugzilla.mozilla.org/show_bug.cgi?id=256509">un bug très ancien</a> qui permet de suivre cette question.</p> - -<p>Maintenant, après le redémarrage du navigateur, vous verrez la fenêtre du Gestionnaire de modules complémentaires, montrant le nom de l'extension, sa version, et une brève description.</p> - -<p><img alt="addonman.png" class="default internal" src="/@api/deki/files/4137/=addonman.png"></p> - -<p>Fermez le Gestionnaire de modules complémentaires. Regardez la fenêtre principale de Firefox et voyez si vous remarquez quelque chose de différent.</p> - -<p>L'avez-vous vu ? Il y a un nouveau menu dans la barre de menu principal, intitulé «Hello World!». Si vous ouvrez le menu, puis la sélection du menu surgissant, vous verrez un chouette message d'alerte. Cliquez sur le bouton OK pour le fermer.</p> - -<p><img alt="" class="internal" src="/@api/deki/files/4138/=helloworldalert.png" style="height: 126px; width: 326px;"></p> - -<p>C'est tout ce que l'extension fait. Maintenant, nous allons y regarder de plus près. </p> - -<h2 id="Contenus_d'une_extension">Contenus d'une extension</h2> - -<p>Vous avez peut être remarqué que le fichier de l'extension que vous avez installé est nommé xulschoolhello1.xpi. <a href="/fr/XPI" title="fr/XPI">XPI</a> (prononcez "zippy") est synonyme de d'installeur multi plate-formes (NdT : Cross-Platform Installer), car le même fichier d'installation peut fonctionner sur les principales plates-formes, et c'est le cas pour la plupart des extensions XPI. Les fichiers XPI sont tout simplement des fichiers compressés au format ZIP, mais Firefox les reconnaît comme extension et déclenche le processus d'installation quand un lien XPI est cliqué.</p> - -<p>Pour regarder dans le fichier XPI, vous avez besoin de le télécharger d'abord sans l'installer. Si le serveur déclenche une installation en cliquant sur un lien ou sur un bouton, vous devez faire un clic droit sur le <a href="/@api/deki/files/4225/=xulschoolhello1.xpi" title="https://developer.mozilla.org/@api/deki/files/4225/=xulschoolhello1.xpi">lien d'installation</a>, puis cliquez sur l'option Enregistrer le lien sous….</p> - -<p>Ensuite, nous allons décompresser le fichier XPI. Une façon de faire est de renommer le fichier afin qu'il ait l'extension <em>zip</em> au lieu de <em>xpi</em>. Une autre façon est d'ouvrir le fichier en utilisant un utilitaire ZIP. La plupart des systèmes d'exploitation dispose d'un utilitaire de compression ZIP, et il existe des outils plus avancés disponibles en ligne. Faites votre choix, et décompressez le fichier dans un emplacement qui vous convient. Vous devriez voir une structure similaire à celle-ci :</p> - -<p>xulschoolhello1</p> - -<ul> - <li> - <ul> - <li>chrome.manifest</li> - <li>install.rdf</li> - <li>chrome - <ul> - <li>xulschoolhello.jar</li> - </ul> - </li> - </ul> - </li> -</ul> - -<p>Le fichier JAR contient la majorité du code, alors nous devrons également en extraire son contenu. Tout comme pour les XPI, vous n'avez besoin que d'un utilitaire ZIP pour décompresser le fichier. Après avoir fait cela, vous aurez quelque chose comme ceci :</p> - -<p>xulschoolhello1</p> - -<ul> - <li> - <ul> - <li>chrome.manifest</li> - <li>install.rdf</li> - <li>chrome - <ul> - <li>xulschoolhello.jar</li> - <li>xulschoolhello - <ul> - <li>content - <ul> - <li>browserOverlay.xul</li> - <li>browserOverlay.js</li> - </ul> - </li> - <li>locale - <ul> - <li>en-US - <ul> - <li>browserOverlay.dtd</li> - <li>browserOverlay.properties</li> - </ul> - </li> - </ul> - </li> - <li>skin - <ul> - <li>browserOverlay.css</li> - </ul> - </li> - </ul> - </li> - </ul> - </li> - </ul> - </li> -</ul> - -<p>Cela fait beaucoup de fichiers pour quelque chose de si simple ! Eh bien, rassurez-vous, nous allons bientôt détailler tous ces fichiers et réaliser que c'est assez simple. Dans la section suivante nous allons examiner ces fichiers et voir ce qu'ils font.</p> - -<div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/Vulgarisation_XUL/Introduction" style="float: left;">« Précédent</a><a href="/fr/docs/Vulgarisation_XUL/L'essentiel_d'une_extension">Suivant »</a></p> -</div> - -<p><span style="font-size: small;">This tutorial was kindly donated to Mozilla by Appcoast.</span></p> diff --git a/files/fr/archive/mozilla/xul/window/index.html b/files/fr/archive/mozilla/xul/window/index.html deleted file mode 100644 index 7369e65496..0000000000 --- a/files/fr/archive/mozilla/xul/window/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: window -slug: Archive/Mozilla/XUL/window -tags: - - Éléments_XUL -translation_of: Archive/Mozilla/XUL/window ---- -<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>Décrit la structure d'une fenêtre de premier niveau. Il s'agit du nœud racine d'un document XUL. Forme par défaut une boîte orientée horizontalement. Comme il s'agit d'une boîte, tous les attributs de boîte peuvent être utilisés. Par défaut, la fenêtre aura un cadre spécifique à la plateforme pour l'entourer. </p><p>Pour assigner une icône à la fenêtre, créez un fichier d'icône spécifique à la plateforme <var><windowid></var><code>.ico</code> et/ou <var><windowid></var><code>.xpm</code> et placez ou installez ces fichiers dans le répertoire <var><répertoire-de-mozilla></var><code>/chrome/icons/default/</code>. La valeur <var><windowid></var> est celle de l'attribut <code>id</code> de la fenêtre. Ceci permet d'avoir une icône différente pour chaque fenêtre. -</p><p>Pour les propriétés et méthodes, consultez l'objet <a class="external" href="http://www.xulplanet.com/references/objref/Window.html">XUL Window</a> sur XULPlanet ou sur XULfr <a class="external" href="http://xulfr.org/wiki/Reference/Xul/window">. -</a></p><p><a class="external" href="http://xulfr.org/wiki/Reference/Xul/window">D'autres informations sont disponibles dans le </a><a href="fr/Tutoriel_XUL/Cr%c3%a9er_une_fen%c3%aatre">tutoriel XUL</a>. -</p> -<dl><dt> Attributs -</dt><dd> <a href="#a-height">height</a>, <a href="#a-hidechrome">hidechrome</a>, <a href="#a-id">id</a>, <a href="#a-screenX">screenX</a>, <a href="#a-screenY">screenY</a>, <a href="#a-sizemode">sizemode</a>, <a href="#a-title">title</a>, <a href="#a-width">width</a>, <a href="#a-windowtype">windowtype</a> -</dd></dl> -<h3 id="Exemples" name="Exemples"> Exemples </h3> -<pre><?xml version="1.0"?> -<?xml-stylesheet href="chrome://global/skin/" type="text/css"?> -<window id="rootWnd" title="Enregistrement en ligne" - xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - <vbox> - <hbox> - <image src="formulaire_enregistrement.png"/> - <description>Enregistrement en ligne</description> - </hbox> - <groupbox align="start"> - <caption label="Vos informations"/> - <radiogroup> - <vbox> - <hbox> - <label control="your-fname" value="Entrez le prénom :"/> - <textbox id="your-fname" value="Johan"/> - </hbox> - <hbox> - <label control="your-lname" value="Entrez le nom de famille :"/> - <textbox id="your-lname" value="Hernandez"/> - </hbox> - <hbox> - <button oncommand="alert('enregistrement')"> - <description>Enregistrer</description> - </button> - </hbox> - </vbox> - </radiogroup> - </groupbox> - </vbox> -</window> -</pre> -<h3 id="Attributs" name="Attributs"> Attributs </h3> -<p> -</p><div id="a-height"> - -<dl><dt> <code id="a-height"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/height">height</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La hauteur préférée de l'élément en pixels. La hauteur réellement affichée peut être différentes si l'élément ou son contenu ont une hauteur minimum ou maximum. La propriété CSS <code>height</code> peut également être utilisée. -</dd></dl> - - -</div> -<div id="a-hidechrome"> - -<dl><dt> <code id="a-hidechrome"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/hidechrome">hidechrome</a></code> -</dt><dd> Type : <i>booléen</i> -</dd><dd> Définissez cet attribut à <code>true</code> pour que le chrome, en ce compris la barre de titre, soit caché. -</dd></dl> - - -</div> -<div id="a-id"> - -<dl><dt> <code id="a-id"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/id">id</a></code> -</dt><dd> Type : <i>id d'élément, doit être unique dans la fenêtre</i> -</dd><dd> Un identifiant unique permettant d'identifier l'élément. Celui-ci peut être utilisé comme paramètre pour <code><a href="fr/DOM/document.getElementById">getElementById()</a></code> et d'autres fonctions DOM et pour référencer l'élément dans des feuilles de style. -</dd></dl> - - -</div> -<div id="a-screenX"> - -<dl><dt> <code id="a-screenX"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/screenX">screenX</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> La position horizontale à laquelle la fenêtre apparaît à l'écran. -</dd></dl> - - -</div> -<div id="a-screenY"> - -<dl><dt> <code id="a-screenY"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/screenY">screenY</a></code> -</dt><dd> Type : <i>entier</i> -</dd><dd> La position verticale à laquelle la fenêtre apparaît à l'écran. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-sizemode"> - -<dl><dt> <code id="a-sizemode"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/sizemode">sizemode</a></code> -</dt><dd> Type : <i>une des valeurs ci-dessous</i> -</dd><dd> L'état de la fenêtre (<code><code><a href="/fr/docs/Mozilla/Tech/XUL/window" title="window">window</a></code></code>). Les valeurs suivantes peuvent être utilisées : -</dd></dl> -<ul><li> <code>maximized</code> : La fenêtre est maximisée, et occupe la totalité de l'écran. -</li><li> <code>minimized</code> : La fenêtre est minimisée, ou masquée. -</li><li> <code>normal</code> : La fenêtre apparaît dans un état normal à la taille désirée. -</li></ul> -<p><br> -</p> - - -</div> -<div id="a-title"> - -<dl><dt> <code id="a-title"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/title">title</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Le texte qui doit apparaître dans la barre de titre de la fenêtre ou boîte de dialogue. -</dd></dl> -<p><br> -</p> - - -</div> -<div id="a-width"> - -<dl><dt> <code id="a-width"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/width">width</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> (représentant un entier) -</dd><dd> La largeur préférée de l'élément. La valeur ne doit pas préciser d'unité car elle est toujours exprimée en pixels. La largeur réellement affichée peut être différente si l'élément ou son contenu ont une largeur minimum ou maximum, ou que la taille est ajustée selon la flexibilité ou l'alignement de son parent. La propriété CSS <code>width</code> peut également être utilisée. -</dd></dl> - - -</div> -<div id="a-windowtype"> - -<dl><dt> <code id="a-windowtype"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/windowtype">windowtype</a></code> -</dt><dd> Type : <i>chaîne de caractères</i> -</dd><dd> Définit une chaîne pouvant être utilisée pour identifier le type de fenêtre. Celle-ci peut être utilisée, par exemple, pour faire la distinction entre une fenêtre de navigation et une fenêtre d'édition. Certaines des fonctions de gestion de fenêtres de Mozilla utilisent cet attribut pour grouper les fenêtres du même type. -</dd></dl> -<p><br> -</p> - - -</div> - -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> -<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propriétés/width">width</a></span></code></small></p> </td> </tr> </tbody> -</table> - -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> -<p><span class="lang lang-fr" lang="fr"> -</span></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <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></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> - -<h3 id="Note" name="Note"> Note </h3> -<p>Le message d'erreur « XML Parsing Error: undefined entity...<window » peut être provoqué par l'indisponibilité ou l'absence d'un fichier DTD référencé dans le fichier XUL. Le chargement d'un fichier dont le nom suit le mot-clé SYSTEM dans une déclaration DOCTYPE peut échouer silencieusement et le seul message d'erreur sera une erreur d'entité non définie sur l'élément XUL suivant. -</p> -<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> -<dl><dt> Éléments -</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/dialog" title="dialog">dialog</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/dialogheader" title="dialogheader">dialogheader</a></code> -</dd></dl> -<h3 id="Notes_des_utilisateurs" name="Notes_des_utilisateurs"> Notes des utilisateurs </h3> -<p>Pour changer l'icône affichée dans la barre de titre d'une fenêtre, consultez la page <a href="fr/Ic%c3%b4nes_de_fen%c3%aatre">Icônes de fenêtre</a>. -</p><p>Pour ajouter une icône de site (favicon) à la barre d'adresse et aux onglets de navigation (si le dialogue n'est pas un popup), utilisez l'extrait de code suivant pour utiliser l'espace de noms HTML et l'élément <code>link</code>. -</p> -<pre><window xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" - xmlns:html="http://www.w3.org/1999/xhtml"> - -<!-- Icône du chrome --> -<html:link rel="icon" href="chrome://monExtension/content/chemin/vers/favicon.png"/> - -<!-- Depuis un site distant --> -<html:link rel="icon" href="http://www.mozilla.org/favicon.ico"/> -</pre> diff --git a/files/fr/archive/mozilla/xulrunner/astuces_xulrunner/index.html b/files/fr/archive/mozilla/xulrunner/astuces_xulrunner/index.html deleted file mode 100644 index 93ab4c2bcd..0000000000 --- a/files/fr/archive/mozilla/xulrunner/astuces_xulrunner/index.html +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: Astuces XULRunner -slug: Archive/Mozilla/XULRunner/Astuces_XULRunner -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/Tips ---- -<p>XULRunner: Questions Fréquemment Posées. [WIP] -</p> -<h2 id="Gestionnaire_d.27Extensions" name="Gestionnaire_d.27Extensions">Gestionnaire d'Extensions</h2> -<p>Pour pouvoir installer des extensions, vous devez d'abord activer le Gestionnaire d'Extensions] dans <a href="fr/Empaqueter_une_application_XUL#em">application.ini</a>. XULRunner 1.8.0 ne charge pas les extensions depuis le dossier de l'application; seul le dossier XULRunner et le dossier du profil de l'utilisateur sont vérifiés. Les préférences suivantes doivent être définies pour faire fonctionner le dialogue XPInstall, le gestionnaire d'extensions et le gestionnaire de thèmes: -</p> -<pre class="eval">pref("xpinstall.dialog.confirm", "<a class=" external" rel="freelink">chrome://mozapps/content/xpinstall/x...allConfirm.xul</a>"); -pref("xpinstall.dialog.progress.skin", "<a class=" external" rel="freelink">chrome://mozapps/content/extensions/...ul?type=themes</a>"); -pref("xpinstall.dialog.progress.chrome", "<a class=" external" rel="freelink">chrome://mozapps/content/extensions/...ype=extensions</a>"); -pref("xpinstall.dialog.progress.type.skin", "Extension:Manager-themes"); -pref("xpinstall.dialog.progress.type.chrome", "Extension:Manager-extensions"); -pref("extensions.update.enabled", true); -pref("extensions.update.interval", 86400); -pref("extensions.dss.enabled", false); -pref("extensions.dss.switchPending", false); -pref("extensions.ignoreMTimeChanges", false); -pref("extensions.logging.enabled", false); -pref("general.skins.selectedSkin", "classic/1.0"); -// NB these point at AMO -pref("extensions.update.url", "<a class=" external" rel="freelink">chrome://mozapps/locale/extensions/e...ons.properties</a>"); -pref("extensions.getMoreExtensionsURL", "<a class=" external" rel="freelink">chrome://mozapps/locale/extensions/e...ons.properties</a>"); -pref("extensions.getMoreThemesURL", "<a class=" external" rel="freelink">chrome://mozapps/locale/extensions/e...ons.properties</a>"); -</pre> -<h2 id="URLs_Chrome_Utiles" name="URLs_Chrome_Utiles">URLs Chrome Utiles</h2> -<p>La plupart requièrent le "<a href="#Branding"> branding</a>" -</p> -<table class="standard-table"> -<tbody><tr><th>Fenêtre</th><th>URL</th><th>Type de fenêtre -</th></tr><tr><td>Gestionnaire d'Extensions -</td><td><a class=" external" rel="freelink">chrome://mozapps/content/extensions/...ype=extensions</a> -</td><td>Extension:Manager-extensions -</td></tr><tr><td>Gestionnaire de Thèmes -</td><td><a class=" external" rel="freelink">chrome://mozapps/content/extensions/...ul?type=themes</a> -</td><td>Extension:Manager-themes -</td></tr><tr><td>Console JavaScript -</td><td><a class=" external" rel="freelink">chrome://global/content/console.xul</a> -</td><td>global:console -</td></tr><tr><td>about:config -</td><td><a class=" external" rel="freelink">chrome://global/content/config.xul</a> -</td><td> -</td></tr></tbody></table> -<h2 id="Extensions_pour_le_D.C3.A9veloppeur" name="Extensions_pour_le_D.C3.A9veloppeur">Extensions pour le Développeur</h2> -<h3 id="Venkman" name="Venkman"> <a href="fr/Venkman">Venkman</a> </h3> -<ul><li>Requiert une version personnalisée ou une extension compatible -</li><li>Besoin de modifier la compatibilité dans <i>install.rdf</i> par rapport à l'<i>id</i> et aux versions dans <i>application.ini</i> -</li><li>Besoin d'une méthode pour démarrer Venkman (communément en faisant un overlaying du fichier XUL principal, similaire au code existant pour Firefox, Suite, etc.) -</li><li>La fonction <i>toOpenWindowByType()</i> doit être définie. Une ébauche de fonction efficiente est <a class="external" href="http://tjlaurenzo.blogspot.com/2006/03/getting-dev-tools-working-with.html">sur ce blog</a>. <i>Une meilleure suggestion?</i> -</li><li>Venkman utilise "<a class=" external" rel="freelink">chrome://communicator/skin/</a>" comme alias pour "<a class=" external" rel="freelink">chrome://global/skin/</a>" et cet alias fut maintenu dans le toolkit XULRunner jusqu'à XULRunner 1.9. Avec XULRunner 1.9 ou supérieur, vous pouvez créer votre propre alias" -</li></ul> -<pre>dans votre chrome manifest ajoutez une ligne "skin": - -skin communicator classic/1.0 skin/communicator/ - -ajoutez un dossier de skin "communicator" et une simple CSS nommée "communicator.css" avec ce contenu: - -@import url("chrome://global/skin/"); -</pre> -<h3 id="Inspecteur_DOM" name="Inspecteur_DOM"> <a href="fr/Inspecteur_DOM">Inspecteur DOM</a> </h3> -<p>Idem que Venkman -</p> -<h3 id="L.27Extension_du_Developpeur_d.27Extensions" name="L.27Extension_du_Developpeur_d.27Extensions"> L'Extension du Developpeur d'Extensions </h3> -<p><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extension Developer's Extension</a> est un outil utile, avec un Editeur XUL Live et un shell JavaScript. -</p><p>Pour installer l'extension dans votre application, vous aurez besoin de modifier son <i>install.rdf</i> (voir ci-dessus). Vous voudrez aussi probablement créer des éléments de menu qui vous laisseront ouvrir le shell Js et les autres outils de cette extension. -</p> -<h3 id="Autre_m.C3.A9thode" name="Autre_m.C3.A9thode"> Autre méthode </h3> -<p>Une autre méthode pour faire fonctionner Venkman et EDE [en]<a class="external" href="http://tjlaurenzo.blogspot.com/2006/03/getting-dev-tools-working-with.html">sur ce blog</a> -</p> -<h2 id="Branding" name="Branding"> Branding </h2> -<p>Branding est un <a href="fr/Enregistrement_chrome">packetage chrome</a> qui contient des informations spécifiques au produit (ex: nom, créateur, logo). -</p><p>Quelques composants XULRunner (en particulier le <a href="#Gestionnaire_d.27Extensions">Gestionnaire d'Extensions</a>) dépendent du branding car ils cherchent certaines chaines dans <tt><a class=" external" rel="freelink">chrome://branding/locale/brand.dtd</a></tt> et <tt><a class=" external" rel="freelink">chrome://branding/locale/brand.properties</a></tt>. -</p><p>Pour satisfaire ces dépendances, vous pouvez copier depuis Firefox <tt>brand.dtd</tt>/<tt>brand.properties</tt> vers <tt>chrome/locale/branding</tt>, les modifier en conséquence, et <a href="fr/Enregistrement_chrome#locale">enregistrer la localisation</a> pour <tt>branding</tt> en ajoutant à votre manifest chrome: -</p> -<pre class="eval">locale branding fr-FR chrome/locale/branding/ -</pre> -<p><i>La localisation que vous mettez dans les fichiers de branding n'importe pas du moment que c'est elle qui est présente dans le manifest.</i> -</p><p>En addition, un <i>branding content package (traduction requise)</i> <a href="fr/Enregistrement_chrome#content">doit être enregistré</a> pour inclure le logo de l'application: -</p> -<pre class="eval">content branding chrome/branding -</pre> -<p>2 icônes doivent être fournies dans ce dossier: <i>icon48.png</i> and <i>icon64.png</i>. Voir <a class="external" href="http://mxr.mozilla.org/mozilla/source/other-licenses/branding/firefox/content/">Firefox</a> pour avoir un exemple. -</p><p><span class="comment">commentaire copié de la version anglaise: In ''~.mozconfig'': ac_add_options --enable-branding=« branding location »</span> -</p> -<h3 id=".5BWindows.5D_Faire_apparaitre_correctement_le_nom_et_l.27ic.C3.B4ne" name=".5BWindows.5D_Faire_apparaitre_correctement_le_nom_et_l.27ic.C3.B4ne"> [Windows] Faire apparaitre correctement le nom et l'icône </h3> -<p>Par défaut, la barre de tâches de Windows grouppe les fenêtres appartenant au même processus dans un seul bouton pour gagner de la place. ce bouton est souvent appelé "xulrunner.exe" et a l'icône de XULRunner. Il y a deux méthodes pour afficher la bonne dénomination ( = <i>branding</i>) de votre application à la place: -</p> -<ul> -<li> -Si vous compilez XULRunner vous-même: créez un fichier module.ver dans <i>mozilla/xulrunner/app</i> avec: -<pre>WIN32_MODULE_DESCRIPTION=MonApplication</pre> -<p>MonApplication doit être remplacé par le titre voulu sur le bouton. Vous pouvez aussi remplacer xulrunner.ico dans le même répertoire par l'icône de votre application. -</p> -</li> -<li> -Avec un XULRunner precompilé: utilisez xulrunner-stub.exe pour démarrer votre application mais renommez le en MonApplication.exe. Avec XULRunner 1.9, le nom choisi apparaitra dans la barre de tâches (pas avec XULRunner 1.8 cependant). Votre icône peut être ajoutée avec un logiciel comme <a class="external" href="http://www.angusj.com/resourcehacker/">Resource Hacker</a> (très simple à prendre en main). -</li> -</ul> -<h2 id="Lire_les_arguments_en_ligne_de_commande" name="Lire_les_arguments_en_ligne_de_commande"> Lire les arguments en ligne de commande </h2> -<p>Les arguments en ligne de commande sont gérés par <i>nsICommandLineHandler</i>. -</p><p><span class="comment">commentaire copié depuis la version anglaise: = Can i have JavaScript errors / warnings directed to stdout instead of the jsconsole? = See <a class="external" href="https://bugzilla.mozilla.org/show_bug.cgi?id=306263" title="https://bugzilla.mozilla.org/show_bug.cgi?id=306263">#306263</a> This doesn't do anything (1.8.0.1): xulrunner -app application.ini -console This neither (1.8.0.1) in ''defaults/preferences/«application name».js'': pref("javascript.options.strict", true); pref("javascript.options.showInConsole", true); pref("browser.dom.window.dump.enabled", true);</span> -</p><p><br> -</p> -<h2 id="Pr.C3.A9f.C3.A9rences_requises_pour_les_dialogues_de_t.C3.A9l.C3.A9chargement" name="Pr.C3.A9f.C3.A9rences_requises_pour_les_dialogues_de_t.C3.A9l.C3.A9chargement"> Préférences requises pour les dialogues de téléchargement </h2> -<p>Pour utiliser le <i>unknown-content-type</i> et le dialogue <i>file-downloads</i> depuis un élément <code><browser></code>, vous devez ajouter les préférences suivantes: -</p> -<pre class="eval">pref("browser.download.useDownloadDir", true); -pref("browser.download.folderList", 0); -pref("browser.download.manager.showAlertOnComplete", true); -pref("browser.download.manager.showAlertInterval", 2000); -pref("browser.download.manager.retention", 2); -pref("browser.download.manager.showWhenStarting", true); -pref("browser.download.manager.useWindow", true); -pref("browser.download.manager.closeWhenDone", true); -pref("browser.download.manager.openDelay", 0); -pref("browser.download.manager.focusWhenStarting", false); -pref("browser.download.manager.flashCount", 2); -// -pref("alerts.slideIncrement", 1); -pref("alerts.slideIncrementTime", 10); -pref("alerts.totalOpenTime", 4000); -pref("alerts.height", 50); -</pre> -<p>Si vous en oubliez, vous aurez l'erreur suivante: -</p> -<pre class="eval">Component returned failure code: 0x8000ffff (NS_ERROR_UNEXPECTED) [nsIPrefBranch.getBoolPref] - -Error: dialog has no properties -Source File: <a class=" external" rel="freelink">chrome://mozapps/content/downloads/u...ontentType.xul</a> -Line: 1 -</pre> -<h2 id="Activer_le_Gestionnaire_de_Mots_de_Passe" name="Activer_le_Gestionnaire_de_Mots_de_Passe"> Activer le Gestionnaire de Mots de Passe </h2> -<p>Ces préférences sont par défaut dans Firefox mais pas dans XULRunner. Sans elles, le gestionnaire de mots de passe ne retiendra pas les détails d'identification. -</p> -<pre class="eval">pref("signon.rememberSignons", true); -pref("signon.expireMasterPassword", false); -pref("signon.SignonFileName", "signons.txt"); -</pre> -<p>Vous avez aussi besoin d'obtenir une instance du service <i>login-manager</i>, qui initialise le système en interne: -</p> -<pre class="eval">Components.classes["@mozilla.org/login-manager;1"].getService(Components.interfaces.nsILoginManager); -</pre> -<h2 id="Utiliser_Firefox_3_pour_lancer_des_applications_XULRunner" name="Utiliser_Firefox_3_pour_lancer_des_applications_XULRunner"> Utiliser Firefox 3 pour lancer des applications XULRunner </h2> -<p>Firefox 3 contient le runtime XULRunner avec l'option <tt>-app</tt> en ligne de commandes pour lancer l'application XUL désirée au lieu de Firefox. Par exemple, sous Windows: -</p> -<pre class="eval"> firefox.exe -app <i>chemin\vers\</i>application.ini -</pre> -<p>Sous Mac: -</p> -<pre class="eval"> /Applications/Firefox.app/Contents/MacOS/firefox-bin -app <i>/chemin/vers/</i>application.ini -</pre> -<p>Notez que sous Mac, vous devez donner un chemin direct. Les chemins relatifs semblent ne pas marcher. -</p> -<h2 id="R.C3.A9solution_de_probl.C3.A8mes" name="R.C3.A9solution_de_probl.C3.A8mes"> Résolution de problèmes </h2> -<h3 id="Titre_de_fen.C3.AAtre_manquant" name="Titre_de_fen.C3.AAtre_manquant"> Titre de fenêtre manquant </h3> -<p>Si le titre de votre <code><<a href="fr/XUL/window">window</a>></code> XUL est vierge, même en spécifiant un attribut title vérifiez que votre fichier XUL est en <tt>.xul</tt> et non pas <tt>.xml</tt>. -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xulrunner/ce_qu'offre_xulrunner/index.html b/files/fr/archive/mozilla/xulrunner/ce_qu'offre_xulrunner/index.html deleted file mode 100644 index 8130eeece0..0000000000 --- a/files/fr/archive/mozilla/xulrunner/ce_qu'offre_xulrunner/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Ce qu'offre XULRunner -slug: Archive/Mozilla/XULRunner/Ce_qu'offre_XULRunner -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/What_XULRunner_Provides ---- -<p> </p> -<p>L'objectif de <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a> est d'offrir une solution pour le déploiement d'applications XUL (en priorité Firefox et Thunderbird), ainsi qu'un mécanisme pour embarquer les capacités des produits Mozilla dans d'autres applications. Les fonctionnalités suivantes sont soit déjà implémentées, soit planifiées :</p> -<p> </p> -<h3 id="Fonctionnalit.C3.A9s_Gecko" name="Fonctionnalit.C3.A9s_Gecko">Fonctionnalités Gecko</h3> -<ul> - <li><a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a></li> - <li>Réseau</li> - <li>Moteur de rendu Gecko</li> - <li>Édition DOM et support transactionnel (sans interface utilisateur)</li> - <li>Cryptographie</li> - <li><a href="/fr/XBL" title="fr/XBL">XBL</a> (XBL2 planifié)</li> - <li><a href="/fr/XUL" title="fr/XUL">XUL</a></li> - <li><a href="/fr/SVG" title="fr/SVG">SVG</a></li> - <li><a href="/fr/XSLT" title="fr/XSLT">XSLT</a></li> - <li>Extras XML (<code><a href="/fr/XMLHttpRequest" title="fr/XMLHttpRequest">XMLHttpRequest</a></code>, <code><a href="/fr/DOMParser" title="fr/DOMParser">DOMParser</a></code>, etc.)</li> - <li>Services Web (SOAP)</li> - <li>Support de mise à jour automatique <em>(pas entièrement implémenté)</em></li> - <li>Barre d'outils de recherche avec auto-complétion du texte</li> - <li>Implémentation de l'historique (l'implémentation de <em>places</em> dans le cycle 1.9)</li> - <li>Support de l'accessibilité</li> - <li>Service IPC pour les communications entre les applications basées sur Gecko <em>(pas entièrement implémenté)</em></li> - <li>Interfaces <a href="/fr/Storage" title="fr/Storage">Storage</a>/sqlite <em>(pas encore activé par défaut)</em></li> -</ul> -<h3 id="Fonctionnalit.C3.A9s_d.27interface_utilisateur" name="Fonctionnalit.C3.A9s_d.27interface_utilisateur">Fonctionnalités d'interface utilisateur</h3> -<p>Les interfaces utilisateur suivantes sont fournies par XULRunner, mais peuvent être outrepassées dans certaines circonstances :</p> -<ul> - <li>Les API et interface utilisateur pour l'installation, la désinstallation et la mise à jour d'applications XUL. Consultez <a class="wikimo" href="https://wiki.mozilla.org/XUL:Installation_Story" title="wikimo:XUL:Installation Story">wikimo:XUL:Installation Story</a>.</li> - <li>Le gestionnaire d'extensions</li> - <li>Le sélecteur de fichiers (utilise le sélecteur natif de l'OS)</li> - <li>La barre d'outils de recherche</li> - <li>Les boîtes de dialogue d'aide</li> - <li>Interface utilisateur de la sécurité (maintenance des clefs SSL, etc.)</li> -</ul> -<h3 id="APIs_embarqu.C3.A9es" name="APIs_embarqu.C3.A9es">APIs embarquées</h3> -<p>Les APIs embarquées suivantes sont fournies par XULRunner :</p> -<ul> - <li>Embarquement inter-plateformes (XRE_InitEmbedding)</li> - <li>Embarquement de <a href="/fr/JavaXPCOM" title="fr/JavaXPCOM">JavaXPCOM</a></li> - <li>gtkmozembed (Linux seulement)</li> - <li>Contrôles ActiveX (Windows seulement) <em>(incomplet)</em></li> - <li>NSView-based-widget (Mac OS X seulement) <em>(incomplet)</em></li> -</ul> -<h3 id="En_projet" name="En_projet">En projet</h3> -<p>Les fonctionnalités suivantes ont été proposées à l'intégration et pourront l'être si les développeurs en ont le temps, et si la taille du code est raisonnable :</p> -<ul> - <li>Support LDAP</li> - <li>Support du correcteur orthographique (avec ou sans dictionnaires inclus) voir le <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=285977">bug 285977</a></li> - <li>Support principal du profil errant (adapté spécifiquement aux applications)</li> - <li>Embarquement de <a href="/fr/PyXPCOM" title="fr/PyXPCOM">PyXPCOM</a> <em>(incomplet)</em></li> -</ul> -<h3 id="Non_support.C3.A9" name="Non_support.C3.A9">Non supporté</h3> -<p>XULRunner n'intégrera pas :</p> -<ul> - <li>Les marque-pages ou un historique de navigation (ils doivent être gérés par l'application)</li> - <li>XForms (XForms sera disponible sous forme d'extension)</li> -</ul> -<p><br> - <span class="comment">Interwiki Language Links</span></p> -<p></p> diff --git a/files/fr/archive/mozilla/xulrunner/déploiement_de_xulrunner_1.8/index.html b/files/fr/archive/mozilla/xulrunner/déploiement_de_xulrunner_1.8/index.html deleted file mode 100644 index d2e38696e4..0000000000 --- a/files/fr/archive/mozilla/xulrunner/déploiement_de_xulrunner_1.8/index.html +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Déploiement de XULRunner 1.8 -slug: Archive/Mozilla/XULRunner/Déploiement_de_XULRunner_1.8 -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/Deploying_XULRunner ---- -<p><a href="/fr/docs/XULRunner">XULRunner</a> 1.8 est une pré-version stable pour les développeurs. Cela signifie que même si certaines parties de cette version ne sont pas finalisées, comme le déploiement, l'intégration à d'autres applications et au système d'exploitation, elle peut déjà servir aux développeurs pour la création d'applications XUL autonomes. Ce document explique comme ce déploiement doit être réalisé.</p> -<h3 id="Windows" name="Windows">Windows</h3> -<p>Sous Windows, XULRunner ne dispose pas encore de solution d'installation intégrée ; les développeurs d'applications doivent utiliser des solutions existantes pour disposer d'un installeur Windows. Les fichiers installés doivent être disposés selon la structure de répertoires suivante :</p> -<ul> - <li>installdir/ - <ul> - <li>application.ini</li> - <li>components/ - <ul> - <li>… les composants faisant partie de l'application</li> - </ul> - </li> - <li>chrome/ - <ul> - <li>… le chrome faisant partie de l'application</li> - </ul> - </li> - <li>… les fichiers complémentaires de l'application tels que des icônes, etc.</li> - <li>myapplicationname.exe (il s'agit de « l'exécutable de lancement ». Vous devez copier et renommer le fichier xulrunner-stub.exe dans votre répertoire d'installation de XULRunner.)</li> - <li>xulrunner/ - <ul> - <li>… copiez xulrunner/ dans ce répertoire</li> - </ul> - </li> - </ul> - </li> -</ul> -<h3 id="Mac_OS_X" name="Mac_OS_X">Mac OS X</h3> -<p>Sous Mac OS X, l'ensemble du framework de XULRunner est placé dans le paquetage de votre application :</p> -<ul> - <li>MyApp.app/ - <ul> - <li>Contents/ - <ul> - <li>Info.plist</li> - <li>Frameworks/ - <ul> - <li>XUL.framework/ - <ul> - <li>fichiers copiés depuis /Library/Frameworks/XUL.framework/Versions/1.8/… assurez vous d'avoir copié correctement tous les liens symboliques (utilisez rsync -rl /Library/Frameworks/XUL.framework ...).</li> - </ul> - </li> - </ul> - </li> - <li>Resources - <ul> - <li>application.ini</li> - <li>app_icon.icns</li> - <li>components/ - <ul> - <li>… les composants faisant partie de l'application</li> - </ul> - </li> - <li>chrome/ - <ul> - <li>… le chrome faisant partie de l'application</li> - </ul> - </li> - <li>… les fichiers complémentaires de l'application tels que des icônes, etc.</li> - </ul> - </li> - <li>MacOS/ - <ul> - <li>xulrunner (il s'agit de « l'exécutable de lancement ». Vous devez copier depuis /Library/Frameworks/XUL.framework/Versions/1.8/xulrunner)</li> - </ul> - </li> - </ul> - </li> - </ul> - </li> -</ul> -<p>De plus, votre application Mac ne se lancera pas sans un fichier - <i> - Info.plist</i> - valide. En voici un exemple :</p> -<pre><?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> -<plist version="1.0"> -<dict> - <key>CFBundleDevelopmentRegion</key> - <string>English</string> - <key>CFBundleExecutable</key> - <string>xulrunner</string> - <key>CFBundleGetInfoString</key> - <string>1.0</string> - <key>CFBundleIconFile</key> - <string>app_icon.icns</string> - <key>CFBundleIdentifier</key> - <string>net.yourcompany.yourapplication</string> - <key>CFBundleInfoDictionaryVersion</key> - <string>6.0</string> - <key>CFBundleName</key> - <string>applicationName</string> - <key>CFBundlePackageType</key> - <string>APPL</string> - <key>CFBundleShortVersionString</key> - <string>1.0</string> - <key>CFBundleSignature</key> - <string>YOURAPP</string> - <key>CFBundleURLTypes</key> - <array> - <dict> - <key>CFBundleURLIconFile</key> - <string>app_icon.icns</string> - <key>CFBundleURLName</key> - <string>YOURAPP Entity</string> - <key>CFBundleURLSchemes</key> - <array> - <string>chrome</string> - </array> - </dict> - </array> - <key>CFBundleVersion</key> - <string>1.0</string> -</dict> -</plist></pre> -<p>Éditez cet exemple selon vos besoins, mais CFBundleExecutable doit être - <i> - xulrunner</i> - , et CFBundleIconFile et CFBundleURLIconFile doivent être définis avec le nom de fichier de l'icône de votre application ( - <i> - app_icon.icns</i> - ).</p> -<h3 id="Linux" name="Linux">Linux</h3> -<p>La plupart des applications Linux sont distribuées comme de simples archives .tar.bz2 que l'utilisateur peut décompresser où il le désire. L'archive doit être structurée comme ceci :</p> -<ul> - <li>appname/ - <ul> - <li>application.ini</li> - <li>components/ - <ul> - <li>… les composants faisant partie de l'application</li> - </ul> - </li> - <li>chrome/ - <ul> - <li>… le chrome faisant partie de l'application</li> - </ul> - </li> - <li>… les fichiers complémentaires de l'application tels que des icônes, etc.</li> - <li>myapplicationname (il s'agit de « l'exécutable de lancement ». Vous devez copier et renommer le fichier xulrunner-stub.exe dans votre répertoire d'installation de XULRunner.)</li> - <li>xulrunner/ - <ul> - <li>… copiez xulrunner/ dans ce répertoire</li> - </ul> - </li> - </ul> - </li> -</ul> diff --git a/files/fr/archive/mozilla/xulrunner/empaqueter_une_application_xul/index.html b/files/fr/archive/mozilla/xulrunner/empaqueter_une_application_xul/index.html deleted file mode 100644 index 4efbb6183f..0000000000 --- a/files/fr/archive/mozilla/xulrunner/empaqueter_une_application_xul/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Empaqueter une application XUL -slug: Archive/Mozilla/XULRunner/Empaqueter_une_application_XUL -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/XUL_Application_Packaging ---- -<p>Les paquets d'application <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a> sont des paquets standard du toolkit (comme les extensions Firefox), avec un fichier manifest en plus (<code>application.ini</code>) qui décrit l'application. Les paquets d'application sont généralement compressées au format zip dans une archive avec l'extension .xulapp ou .xpi. Ils peuvent être installés avec la ligne de commande XULRunner "-install-app" (voir les <a href="/fr/Notes_de_versions_de_XULRunner_1.8.0.4" title="fr/Notes_de_versions_de_XULRunner_1.8.0.4">Notes de versions de XULRunner 1.8.0.4</a> <small>(à traduire de <a href="/en/XULRunner_1.8.0.4_Release_Notes">en:XULRunner_1.8.0.4_Release_Notes</a>)</small>).</p> - -<h3 id="application.ini" name="application.ini">application.ini</h3> - -<p>Le fichier manifest <code>application.ini</code> se trouve à la racine de le l'extension et fournit les metadonnées pour permettre au XULRunner de lancer correctement l'application. Il est analysé comme un fichier style INI windows avec le couple <code>'Headings'</code> et <code>Key=Value</code>. Les lignes commençant par <code>;</code> ou <code>#</code> sont traités comme des commentaires.</p> - -<p>Vous pouvez trouver un exemple de <code>application.ini</code> dans <a href="https://dxr.mozilla.org/mozilla-central/source/xulrunner/examples/simple/application.ini" rel="custom">le code source de Mozilla</a>.</p> - -<h2 id="Section_.5BApp.5D" name="Section_.5BApp.5D">Section [App]</h2> - -<p>La partie <code>App</code> spécifie les metadonnées sur l'application</p> - -<dl> - <dt>Name</dt> - <dd>Indique le nom de l'application.<br> - REQUIS<br> - Exemple : <code>Name=TestApplication</code></dd> - <dt>Version</dt> - <dd>Indique la version de l'application<br> - REQUIS<br> - Voir <a href="/fr/Format_de_version_du_toolkit" title="fr/Format_de_version_du_toolkit">Format de version du toolkit</a> pour les détails sur le numérotage des versions<br> - Exemple : <code>Version=0.1</code></dd> - <dt>BuildID</dt> - <dd>Indique un identifiant de compilation unique. Il s'agit généralement d'un identifiant temporel, devrait être différent pour chaque version publiée de l'application.<br> - REQUIS<br> - Exemple : <code>BuildID=20060201</code></dd> - <dt>ID</dt> - <dd>Spécifie un l'identifiant unique de l'application<br> - REQUIS<br> - L'ID de l'application, comme les IDs d'extensions, peuvent être formés soit comme un email <code><a class="link-mailto" href="mailto:ApplicationName@vendor.tld" rel="freelink">ApplicationName@vendor.tld</a></code> ou comme un UUID (Universal Unique Identifier) <code>{12345678-1234-1234-1234-123456789abc}</code>. Le format email est préférable pour les nouveaux développements d'application.<br> - Exemple: <code><a class="link-mailto" href="mailto:ID=TestApplication@example.tld" rel="freelink">ID=TestApplication@example.tld</a></code></dd> - <dt>Vendor</dt> - <dd>Indique le vendeur de l'application<br> - OPTIONNEL<br> - Exemple : <code>Vendor=Grinch Productions</code></dd> -</dl> - -<h2 id="Section_.5BGecko.5D" name="Section_.5BGecko.5D">Section [Gecko]</h2> - -<p>La partie <code>Gecko</code> spécifie quelle version de XULRunner est requise par l'application.</p> - -<dl> - <dt>MinVersion</dt> - <dd>Indique la version minimale de XULRunner requise pour l'application.<br> - REQUIS<br> - Exemple : <code>MinVersion=1.8</code></dd> - <dt>MaxVersion</dt> - <dd>Indique la version maximum de XULRunner dont l'application à besoin.<br> - OPTIONNEL - la valeur par défaut correspond à n'importe quelle version de XULRunner inférieure à XULRunner 2<br> - Exemple : <code>MaxVersion=1.8.0.*</code></dd> -</dl> - -<h2 id="Section_.5BXRE.5D" name="Section_.5BXRE.5D">Section [XRE]</h2> - -<p>La section <code>XRE</code> spécifie diverses caractéristiques possibles du démarrage de XULRunner.</p> - -<dl> - <dt id="em">EnableExtensionManager</dt> - <dd>Spécifie si les extensions sont activées. Il peut prendre la valeur 1 ou 0.<br> - OPTIONNEL - La valeur par défaut est 0<br> - Exemple : <code>EnableExtensionManager=1</code></dd> - <dt>EnableProfileMigrator</dt></dt> - <dd>Spécifie si, quand l'application est lancée pour la première fois et qu'il n'y a pas de profils, le code de migration de profil doit être activé par l'interface nsIProfileMigrator. Les valeurs possibles sont 1 et 0.<br> - OPTIONNEL - La valeur par défaut est 0<br> - Exemple : <code>EnableProfileMigrator=1</code></dd> -</dl> diff --git a/files/fr/archive/mozilla/xulrunner/faq_de_xulrunner/index.html b/files/fr/archive/mozilla/xulrunner/faq_de_xulrunner/index.html deleted file mode 100644 index e803a9af7a..0000000000 --- a/files/fr/archive/mozilla/xulrunner/faq_de_xulrunner/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: FAQ de XULRunner -slug: Archive/Mozilla/XULRunner/FAQ_de_XULRunner -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/FAQ ---- -<p> </p> -<p>Cette page a pour but de répondre à des questions fréquemment posées et de corriger des idées fausses courantes sur <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a>.</p> -<dl> <dt>Est-ce que XULRunner est un navigateur ?</dt> <dd>Non. Vous pouvez utiliser XULRunner pour créer un navigateur (<a class="external" href="http://benjamin.smedbergs.us/xulrunner/">exemple mybrowser</a> ou Firefox), mais il n'existe pas (et n'existera jamais) de « navigateur XULRunner ».</dd> -</dl> -<dl> <dt>Est-ce que XULRunner est un outil de développement ?</dt> <dd>Pas particulièrement ; XULRunner est une technologie de moteur d'exécution Internet. XULRunner peut servir à créer des outils de développement (le <a class="external" href="http://www.alphaworks.ibm.com/tech/ajaxtk">framework toolkit AJAX</a> par exemple). À l'avenir, des kits de développement XULRunner seront proposés avec divers outils de développement.</dd> -</dl> -<dl> <dt>Comment comparer XULRunner à d'autres moteurs d'exécution comme Java ou .NET (ou Python ou ...) ?</dt> <dd>Le but de XULRunner est de faciliter le développement et le déploiement d'applications Internet. Il n'est pas destiné à être un environnement d'exécution universel ; ceci permet à XULRunner de rester compact et d'offrir une stratégie de déploiement plus simple que les environnements génériques.</dd> -</dl> -<dl> <dt>Si j'utilise XULRunner, dois-je écrire mes applications en XUL ?</dt> <dd>Non ! Vous pouvez écrire votre application dans n'importe quel langage supporté par la plateforme Web de Mozilla, dont HTML, XHTML, SVG, or XUL.</dd> -</dl> -<dl> <dt>Pourquoi est-il appelé XULRunner, plutôt que HTMLRunner ou quelque chose de ce genre ?</dt> <dd>Le nom n'est pas arrêté. D'autres noms peuvent être proposés au développeur en chef <a href="/User:Benjamin_Smedberg">Benjamin Smedberg</a>.</dd> -</dl> -<dl> <dt>Quand Firefox sera-t-il basé sur XULRunner ?</dt> <dd>Consultez la <a class="external" href="http://wiki.mozilla.org/XULRunner:Roadmap">feuille de route de XULRunner</a>. C'est prévu pour Firefox 3 (et XULRunner 1.9) vers la fin 2007.</dd> -</dl> -<p></p> diff --git a/files/fr/archive/mozilla/xulrunner/florilège_des_applications_xulrunner/index.html b/files/fr/archive/mozilla/xulrunner/florilège_des_applications_xulrunner/index.html deleted file mode 100644 index d95b17e186..0000000000 --- a/files/fr/archive/mozilla/xulrunner/florilège_des_applications_xulrunner/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Florilège des applications XULrunner -slug: Archive/Mozilla/XULRunner/Florilège_des_applications_XULrunner -tags: - - Entreprise - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/Hall_of_Fame ---- -<p>Cette page liste les applications XULRunner existantes.</p> -<h3 id="Applications_XULRunner" name="Applications_XULRunner">Applications XULRunner</h3> -<dl> <dt><a class="external" href="http://chatzilla.rdmsoft.com/xulrunner/">ChatZilla</a></dt> <dd>Une version autonome du client IRC ChatZilla.</dd> -</dl> -<dl> <dt><a class="external" href="http://ffsearchplugins.free.fr/clines/index.php#xulrunner">Clines</a></dt> <dd>Un clone de Color Lines (jeu)</dd> -</dl> -<dl> <dt><a class="external" href="http://www.psyc.us">CocoaPSYC.app</a></dt> <dd>Un client IM/Chat <a class="external" href="http://about.psyc.eu">PSYC</a> pour Mac OS X (également disponible en extension pour Firefox).</dd> -</dl> -<dl> <dt><a class="external" href="http://www.twinsoft.com/intl/en/cariocaweb/convertigo-ems-enterprise-mashup-server.htm">Convertigo Enterprise Mashup Server</a></dt> <dd>Un outil pour intégrer des applications WEB sous forme de services Web SOAP ou pour les « clippers » afin de construire des « mashups » en entreprise.</dd> -</dl> -<dl> <dt><a class="external" href="http://daim.project.free.fr/">DAIM</a></dt> <dd>Un superbe outil d'analyse d'images, utilisant une bibliothèque d'images professionnelle.</dd> -</dl> -<dl> <dt><a class="external" href="http://developer.emusic.com/">eMusic Remote</a></dt> <dd>Le gestionnaire de téléchargement pour la plate-forme eMusic.</dd> -</dl> -<dl> <dt><a class="external" href="http://open-ils.org/">Evergreen - Staff Client</a></dt> <dd>Evergreen est une bibliothèque système libre.</dd> -</dl> -<dl> <dt><a class="external" href="http://mathijs.jurresip.nl/findthatfont/">FindThatFont!</a></dt> <dd>Outil de gestion de fonte pour Microsoft Windows et Linux, qui permet de rechercher une fonte particulière.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.jakinbidea.com/?page_id=39">GencatRss</a></dt> <dd>Un gestionnaire de flux RSS.</dd> -</dl> -<dl> <dt><a class="external" href="http://services.google.com/adwordseditor/index.html">Google AdWords Editor</a></dt> <dd>AdWords Editor est une application locale de gestion des comptes Google.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.birgin.de/produkte/ida/index_EN.php">IDA</a></dt> <dd>Système de publication E-Learning pour créer facilement des applications d'apprentissage sur le Web.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.joost.com/">Joost</a> (précédemment dénommé <a class="external" href="http://www.theveniceproject.com">The Venice Project</a>)</dt> <dd>Un application TV Internet. La compagnie aim veut combiner le meilleur des fonctionnalités de la télévision avec celles d'Internet.</dd> <dt> </dt><dt><a class="external" href="http://www.kiwix.org/index.php/Main_Page/fr" title="http://www.kiwix.org/index.php/Main_Page/fr">Kiwix</a></dt> <dd>Une application pour avoir accès à Wikipédia, où encore à la document d'Ubuntu, hors-ligne.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.kirix.com/">Kirix Strata</a></dt> <dd>Un nouveau navigateur spécialise pour accéder et manipuler des données à partir du Web.</dd> -</dl> -<dl> <dt><a class="external" href="http://www-03.ibm.com/developerworks/blogs/page/CompApps?entry=how_to_run_xul_applications">Lotus Notes / Sametime</a></dt> <dd>Les dernières version de Lotus Notes et de Sametime d'IBM peuvent embarquées des applications XUL.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.mangoproject.org/">Mango</a></dt> <dd>Un client Jabber.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.getmiro.com/">Miro</a></dt> <dd>Lecteur et navigateur TV sur Internet.</dd> -</dl> -<dl> <dt><a class="external" href="http://davidkellogg.com/wiki/Main_Page">Plain Old Webserver</a></dt> <dd>Un serveur Web pleinement fonctionnel qui exécute du code JavaScript côté serveur.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.songbirdnest.com/">Songbird</a></dt> <dd>Un lecteur audio.</dd> -</dl> -<dl> <dt><a class="external" href="http://telekast.sourceforge.net">TeleKast</a></dt> <dd>TeleKast fournit des éditeurs de scripts, de documents Web et de kiosk. Il comprend aussi un téléprompteur. Le téléprompteur, éditeur de documents Web et kiosk utilisent des scripts permettant de communiquer facilement.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.tomtom.com">TomTom HOME 2</a></dt> <dd>Application PC pour gérer les périphériques GPS TomTom.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.openwengo.org">WengoPhone</a></dt> <dd>Un client IM/VoIP basé sur SIP/XMPP.</dd> <dd> </dd><dt><a class="external" href="http://www.yoono.com/desktop_features.html" title="http://www.yoono.com/desktop_features.html">Yoono Desktop</a></dt> <dd>Application PC/Mac pour gérer et suivre vos réseaux sociaux et vos messageries instantanées (support de : Facebook, Twitter, MySpace, FriendFeed, Flickr, iMeem, MSN Live Messenger, Yahoo Messenger, AIM, GTalk).</dd> -</dl> -<dl> <dt><a class="external" href="http://developer.mozilla.org/en/docs/Category:Mozilla_Webclient">Embed XULRunner in Java</a></dt> -</dl> -<h3 id="Utilitaires_.2F_Prototypes" name="Utilitaires_.2F_Prototypes">Utilitaires / Prototypes</h3> -<dl> <dt><a class="external" href="http://benjamin.smedbergs.us/xulrunner/">Exemples XULRunner</a> de Benjamin</dt> <dd>« mybrowser est un exemple de navigateur simple », xulmine</dd> -</dl> -<dl> <dt><a class="external" href="http://www.jinsync.com/?q=node/9">30b</a></dt> <dd>Un <strong>wrapper</strong> à base de XULRunner pour 30boxes.com</dd> -</dl> -<dl> <dt><a class="external" href="http://www.eclipse.org/atf/">AJAX Toolkit Framework (ATF)</a></dt> <dd>A part of the Eclipse Web Tools Platform (WTP)</dd> -</dl> -<dl> <dt><a class="external" href="http://simile.mit.edu/crowbar/">Crowbar</a></dt> <dd>Un environnement Web simplifié basé sur l'utilisation d'un navigateur basé sur Mozilla côté serveur.</dd> -</dl> -<dl> <dt><a class="external" href="http://exch.mozdev.org/">Exch</a></dt> <dd>Un outil de conversion des devises utilisant des données mises à jour depuis le site <a class=" external" href="http://finance.yahoo.com/currency" rel="freelink">http://finance.yahoo.com/currency</a>. Vous pouvez utiliser l'extension Firefox ou la version autonome.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.smellman.homelinux.org/mozilla/xulapp.html#foxkehclock">Foxkeh Clock (ja)</a></dt> <dd>Une horlage mettant en scène le personnage <a class="external" href="http://www.foxkeh.com/">Foxkeh</a>.</dd> -</dl> -<dl> <dt><a class="external" href="http://opendocumentfellowship.org/odfviewer">Visualiseur OpenDocument</a></dt> <dd>Visualiseur de documents OpenDocument multiplate-forme.</dd> -</dl> -<dl> <dt><a class="external" href="http://www.treebuilder.de/default.asp?file=257091.xml">SVGclock</a></dt> <dd>Une horloge en SVG.</dd> -</dl> -<dl> <dt><a class="external" href="http://blogs.acceleration.net/ryan/articles/2018.aspx">TaskPool</a></dt> <dd>TaskPool est une petite application de gestion du temps. Elle vous permet d'ajouter des tâches à une liste de chose à faire, de les activer ou de les désactiver, et elle décomptera les secondes.</dd> -</dl> -<dl> <dt><a class="external" href="http://starkravingfinkle.org/blog/xul-explorer/">XUL Explorer</a></dt> <dd>« Un IDE XUL légère… un moyen facile et rapide de développer avec XUL »</dd> -</dl> -<dl> <dt><a class="external" href="http://labs.mozilla.com/2007/10/prism/">Prims</a> (précédemment <a class="external" href="http://starkravingfinkle.org/blog/2007/07/webrunner-05-now-with-more-power/">WebRunner</a>)</dt> <dd>Un navigateur spécifique à un site en particulier. Il permet de lancer une application Web telle que Gmail dans un processus indépendant de celui du navigateur.</dd> -</dl> -<p></p> diff --git a/files/fr/archive/mozilla/xulrunner/index.html b/files/fr/archive/mozilla/xulrunner/index.html deleted file mode 100644 index 4f72cf88ec..0000000000 --- a/files/fr/archive/mozilla/xulrunner/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: XULRunner -slug: Archive/Mozilla/XULRunner -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner ---- -<div class="callout-box"><strong><a class="external" href="http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx">XULRunner tutorial</a></strong><br> -Une courte introduction à XULRunner.</div> - -<div><strong>XULRunner</strong> est un environnement d'exécution installable pouvant gérer des applications <a href="/fr/XUL" title="fr/XUL">XUL</a>+<a href="/fr/XPCOM" title="fr/XPCOM">XPCOM</a> aussi riches que Firefox et Thunderbird. Il fournit des mécanismes permettant d'installer, de mettre à jour et de désinstaller des applications. XULRunner fournira également libxul, une solution permettant d'embarquer les technologies Mozilla dans d'autres projets et produits.</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="T.C3.A9l.C3.A9chargements" name="T.C3.A9l.C3.A9chargements">Téléchargements</h4> - - <div class="note"> - <p>XULRunner est <a class="external external-icon" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/latest" title="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/">disponible sur ftp.mozilla.org</a>. Veuillez consulter les <a href="/fr/Notes_de_versions_de_XULRunner_1.9" title="fr/Notes_de_versions_de_XULRunner_1.9">notes de version</a> pour l'installation, la désinstallation et d'autres informations.</p> - - <p>Firefox 3 est distribué avec un paquet XULRunner privé, qui peut exécuter toute application compatible XULRunner à l'aide du paramètre de commande <code>-app</code>.</p> - - <p><a href="/fr/XULRunner//Anciennes_versions" title="fr/XULRunner//Anciennes_versions">Des versions plus anciennes</a> sont également disponibles.</p> - </div> - - <h4 id="Aper.C3.A7u" name="Aper.C3.A7u">Aperçu</h4> - - <ul> - <li><a class="wikimo" href="https://wiki.mozilla.org/XULRunner:Roadmap" title="Feuille de route de développement">Feuille de route de développement</a></li> - <li><a href="/fr/XULRunner/Ce_qu'offre_XULRunner" title="fr/XULRunner/Ce_qu'offre_XULRunner">Ce qu'offre XULRunner</a></li> - <li><a href="/fr/FAQ_de_XULRunner" title="fr/FAQ_de_XULRunner">FAQ de XULRunner</a></li> - <li>Compilations nocturnes : <a href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/">latest-trunk</a></li> - </ul> - - <h4 id="Documentation" name="Documentation">Documentation</h4> - - <dl> - <dt><a class="external" href="http://zenit.senecac.on.ca/wiki/index.php/XULRunner_Guide">Guide XULRunner</a></dt> - <dd><small>Une introduction assez complète et un tutoriel pour XULRunner qui regroupe la plupart des informations disponibles ici.</small></dd> - </dl> - - <dl> - <dt><a href="/Special:Tags?tag=XULRunner:Exemples&language=fr" title="Special:Tags?tag=XULRunner:Exemples&language=fr">Exemples d'applications</a></dt> - <dd><small>Quelques exemples simples d'applications XULRunner qui peuvent être copiés.</small></dd> - </dl> - - <dl> - <dt><a class="external" href="http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx">A XULRunner Tutorial</a></dt> - <dd><small>Une courte introduction à XULRunner.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Astuces_XULRunner" title="fr/Astuces_XULRunner">Astuces XULRunner</a></dt> - <dd><small>Une collection d'astuces pour travailler avec XULRunner.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XULRunner/Déploiement_de_XULRunner_1.8" title="fr/XULRunner/Déploiement_de_XULRunner_1.8">Déploiement de XULRunner</a></dt> - <dd><small>Cet article décrit comment déployer des applications autonomes XUL dans un environnement de production.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Florilège_des_applications_XULrunner" title="fr/Florilège_des_applications_XULrunner">Florilège des applications XULrunner</a></dt> - <dd><small>Suivi des applications disponibles basées sur XULRunner.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Documentation_sur_la_compilation" title="fr/Documentation_sur_la_compilation">Documentation sur la compilation</a></dt> - <dd><small>Découvrez comment obtenir le code source et le compiler.</small></dd> - </dl> - - <dl> - <dt> </dt> - <dd><small>Étapes de configuration de Venkman pour déboguer votre application.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Débogage_d'une_application_XULRunner" title="fr/Débogage_d'une_application_XULRunner">Documentation de débogage</a></dt> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XULRunner&language=fr" title="Special:Tags?tag=XULRunner&language=fr">Tous les articles…</a></span></p> - </td> - <td> - <h4 id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p></p><ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-platform"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.platform"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.platform/feeds"> Flux de syndication</a></li> -</ul><p></p> - - <ul> - <li><a class="link-irc" href="irc://irc.mozilla.org/#xulrunner">#xulrunner sur irc.mozilla.org</a></li> - <li><a class="external" href="http://mail.mozilla.org/listinfo/xulrunner-dev">mailing list XULRunner-Dev</a></li> - <li><a href="/fr/XULRunner/Communauté" title="fr/XULRunner/Communauté">Autres liens communautaires…</a></li> - </ul> - - <h4 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/XUL" title="fr/XUL">XUL</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Categories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.8.0.4/index.html b/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.8.0.4/index.html deleted file mode 100644 index 83087ff904..0000000000 --- a/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.8.0.4/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Notes de versions de XULRunner 1.8.0.4 -slug: Archive/Mozilla/XULRunner/Notes_de_versions_de_XULRunner_1.8.0.4 -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/1.8.0.4 ---- -<p>XULRunner 1.8.0.4 est une <i>version stable pour les développeurs</i> de l'environnement d'éxécution Mozilla <a href="fr/XULRunner">XULRunner</a>. Il remplace <a href="fr/Notes_de_versions_de_XULRunner_1.8.0.1">la version 1.8.0.1</a> ; tous les utilisateurs devraient mettre à jour leur version. Il permet de lancer des applications XUL autonomes, et d'embarquer des API qui permettent d'avoir un rendu de pages Web dans des applications natives ou Java. -</p> -<h3 id="Configuration_syst.C3.A8me_minimum" name="Configuration_syst.C3.A8me_minimum"> Configuration système minimum </h3> -<p>Avant installation, vérifiez que votre ordinateur répond <a class="external" href="http://www.mozilla.com/firefox/system-requirements.html">aux exigences système minimales</a> (en). Ces exigences sont les mêmes pour XULRunner et pour Firefox. -</p> -<h3 id="Installation_de_XULRunner" name="Installation_de_XULRunner"> Installation de XULRunner </h3> -<p>Mozilla propose XULRunner pour Windows, Mac OS X et Linux, uniquement en anglais : -</p> -<ul><li> <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/win32/en-US/xulrunner-1.8.0.4.en-US.win32.zip">Télécharger XULRunner pour Windows</a> -</li><li> <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/mac/en-US/xulrunner-1.8.0.4.en-US.mac.dmg">Télécharger XULRunner pour Mac OS X</a> -</li><li> <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/linux-i686/en-US/xulrunner-1.8.0.4.en-US.linux-i686.tar.gz">Télécharger XULRunner pour Linux</a> -</li></ul> -<p>Frenchmozilla propose sur son site une <a class="external" href="http://frenchmozilla.sourceforge.net/xulrunner/">version française</a> de XULRunner 1.8.0.4 pour ces trois plateformes. -</p> -<h4 id="Windows" name="Windows"> Windows </h4> -<ul><li> Décompressez le fichier ZIP dans un nouveau répertoire en utilisant un outil d'archivage (<a class="external" href="http://www.7-zip.org/fr/">7zip</a> est préconisé). Le répertoire suivant est recommandé : <tt>C:\Program Files\Mozilla XULRunner\1.8.0.4</tt>. -</li><li> Pour enregistrer XULRunner auprès du système d'exploitation, ouvrez une invite de commande et exécutez <tt>xulrunner.exe --register-global</tt> (pour un enregistrement global) ou <tt>xulrunner.exe --register-user</tt> (pour n'enregistrer que pour un utilisateur). -</li></ul> -<h4 id="Mac_OS_X" name="Mac_OS_X"> Mac OS X </h4> -<ul><li> Ouvrez le fichier .pkg dans l'installeur, et suivez les indications. -</li></ul> -<h4 id="Linux" name="Linux"> Linux </h4> -<ul><li> Décompressez le tarball dans un nouveau répertoire en utilisant la commande <tt>tar -xzf xulrunner-1.8.0.4.en-US.linux-i686.tar.gz</tt>. Le répertoire suivant est recommandé : <tt>/opt/xulrunner/1.8.0.4</tt>. -</li><li> Enregistrez XULRunner auprès du système d'exploitation en exécutant <tt>xulrunner --register-global</tt> (pour une installation globale, doit être faite par root) ou <tt>xulrunner --register-user</tt> (pour n'enregistrer que pour un utilisateur). -</li></ul> -<h3 id="D.C3.A9sinstallation_de_XULRunner" name="D.C3.A9sinstallation_de_XULRunner"> Désinstallation de XULRunner </h3> -<h4 id="Windows.2FLinux" name="Windows.2FLinux"> Windows/Linux </h4> -<ul><li> Depuis une invite de commande, lancez <tt>xulrunner --unregister-global</tt> ou <tt>xulrunner --unregister-user</tt> pour désenregistrer XULRunner de la même manière que vous l'avez enregistré à l'installation. -</li><li> Supprimez le répertoire XULRunner. -</li></ul> -<h4 id="Mac_OS_X_2" name="Mac_OS_X_2"> Mac OS X </h4> -<p>Si vous disposez de plusieurs versions installées de XULRunner sous Mac OS X, il n'est pas possible d'en désinstaller une seule. -</p> -<ul><li> Pour enlever <b>toutes</b> les versions installées de XULRunner, supprimez le répertoire <tt>/Library/Frameworks/XUL.framework</tt>. -</li></ul> -<h3 id="Installation_d.27applications_XUL" name="Installation_d.27applications_XUL"> Installation d'applications XUL </h3> -<p>Les applications XUL peuvent être obtenues de différentes sources, et sont habituellement livrées sous forme d'archive ZIP portant une extension <tt>.xulapp</tt> ou <tt>.xpi</tt>. <a>Quelques applications</a> sont disponibles depuis le <a href="fr">Mozilla Developer Center</a>. -</p> -<ul><li> Sauvegardez l'archive de l'application sur votre bureau ou à un endroit de votre choix. -</li></ul> -<h4 id="Windows_2" name="Windows_2"> Windows </h4> -<p>Lancez la commande suivantes depuis Menu > Exécutez ou depuis une invite de commande : -</p> -<pre class="eval">"C:\Program Files\Mozilla XULRunner\1.8.0.4\xulrunner\xulrunner.exe" --install-app "C:\Documents and Settings\<var>nomUtilisateur</var>\Bureau\<var>monApplication</var>.xpi" -</pre> -<p>L'application sera installée dans <tt>C:\Program Files\<var>NomVendeur</var>\<var>NomApplication</var></tt> -</p> -<h4 id="Mac_OS_X_3" name="Mac_OS_X_3"> Mac OS X </h4> -<p>Lancez la commande suivante dans une invite de commande : -</p> -<pre class="eval">/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Bureau/<var>monApplication</var>.xpi -</pre> -<p>L'application sera installée dans <tt>/Applications/<var>nomVendeur</var>/<var>nomApplication</var></tt> -</p> -<h4 id="Linux_2" name="Linux_2"> Linux </h4> -<p>Lancez la commande suivante dans une invite de commande : -</p> -<pre class="eval">/opt/xulrunner/1.8.0.4/xulrunner/xulrunner --install-app ~/Desktop/<var>monApplication</var>.xpi -</pre> -<p>L'application sera installée dans <tt>/usr/lib/<var>nomVendeur</var>/<var>nomApplication</var></tt> -</p> -<h3 id="Probl.C3.A8mes_connus" name="Probl.C3.A8mes_connus"> Problèmes connus </h3> -<ul><li> Les logiciels pare-feu peuvent identifier les applications XUL comme étant une seule et unique application. -</li><li> Sous Microsoft Windows XP, toutes les applications XUL peuvent être regroupées ensemble dans la barre de tâche. -</li></ul> -<h3 id="Foires_aux_questions" name="Foires_aux_questions"> Foires aux questions </h3> -<p></p><dl> -<dt>Pourquoi l'installation de XULRunner est-il aussi pénible ? Pourquoi n'y a-t-il pas un joli installeur ? -</dt><dd>Parce que personne n'en a encore écrit le code ! Il s'agit d'une version préalable pour les développeurs : des fonctionnalités supplémentaires pour l'installation et le déploiement de XULRunner et des applications basées sur XULRunner seront disponibles dans les futures versions. -<p></p></dd><dt>J'ai écrit une application XUL, comment puis-je la déployer chez mes utilisateurs ? -</dt><dd>Pour l'instant, Mozilla recommande que XULRunner soit déployé individuellement avec chaque application. Consultez <a href="fr/XULRunner/D%c3%a9ploiement_de_XULRunner_1.8">Déploiement de XULRunner 1.8</a> pour plus d'information. -<p></p></dd><dt>Où est le code source ? -</dt><dd><a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/source/xulrunner-1.8.0.4-source.tar.bz2">Ici.</a> -<p></p></dd><dt>Je pense avoir trouvé un bogue, comment puis-je le signaler ? -</dt><dd><a class="link-https" href="https://bugzilla.mozilla.org/">bugzilla.mozilla.org</a> sert à traquer les bogues de tous les produits Mozilla. Assurez-vous s'il vous plait que votre bogue n'est pas déjà connu avant de le poster, en utilisant la fonction de recherche. -<p></p></dd><dt>Comment puis-je aider ? -</dt><dd>Si vous souhaitez participer à XULRunner sans savoir par où débuter, visitez la page <a href="fr/XULRunner/Communaut%c3%a9">XULRunner:Communauté</a> et posez vos questions sur les newsgroups ou sur le canal IRC. -</dd></dl> -<p><span class="comment">Interwiki Language Links</span> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.9/index.html b/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.9/index.html deleted file mode 100644 index 3e2e5b6e1b..0000000000 --- a/files/fr/archive/mozilla/xulrunner/notes_de_versions_de_xulrunner_1.9/index.html +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Notes de versions de XULRunner 1.9 -slug: Archive/Mozilla/XULRunner/Notes_de_versions_de_XULRunner_1.9 -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/1.9 ---- -<p>XULRunner 1.9 est une<em>version stable</em> de l'environnement d'exécution Mozilla <a href="fr/XULRunner">XULRunner</a>. Il remplace <a href="fr/Notes_de_versions_de_XULRunner_1.8.0.4">la version 1.8.0.4</a> ; tous les utilisateurs devraient mettre à jour leur version. Il permet de lancer des applications XUL autonomes, et d'embarquer des API qui permettent d'avoir un rendu de pages Web dans des applications natives ou Java. XULRunner 1.9 est basé sur les mêmes sources que Firefox 3.</p> - -<h3 id="Configuration_syst.C3.A8me_minimum" name="Configuration_syst.C3.A8me_minimum">Configuration système minimum</h3> - -<p>Avant installation, vérifiez que votre ordinateur répond <a class="external" href="http://www.mozilla.com/firefox/system-requirements.html">aux exigences système minimales</a> (en). Ces exigences sont les mêmes pour XULRunner et pour Firefox.</p> - -<h3 id="Installation_de_XULRunner" name="Installation_de_XULRunner">Installation de XULRunner</h3> - -<p>Mozilla propose XULRunner pour Windows, Mac OS X et Linux, uniquement en anglais :</p> - -<ul> - <li><a class="external" href="http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.0/runtimes/xulrunner-1.9.en-US.win32.zip">Télécharger XULRunner pour Windows</a></li> - <li><a class="external" href="http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.0/runtimes/xulrunner-1.9.en-US.mac-pkg.dmg">Télécharger XULRunner pour Mac OS X</a></li> - <li><a class="external" href="http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.0/runtimes/xulrunner-1.9.en-US.linux-i686.tar.bz2">Télécharger XULRunner pour Linux</a></li> -</ul> - -<p>Frenchmozilla propose sur son site une <a class="external" href="http://www.frenchmozilla.fr/xulrunner/">version française</a> de XULRunner 1.9 pour ces trois plateformes.</p> - -<h4 id="Windows" name="Windows">Windows</h4> - -<ul> - <li>Décompressez le fichier ZIP dans un nouveau répertoire en utilisant un outil d'archivage (<a class="external" href="http://www.7-zip.org/fr/">7zip</a> est préconisé). Le répertoire suivant est recommandé : <code>C:\Program Files\Mozilla XULRunner\1.9</code> .</li> - <li>Pour enregistrer XULRunner auprès du système d'exploitation, ouvrez une invite de commande et exécutez <code>xulrunner.exe --register-global</code> (pour un enregistrement global) ou <code>xulrunner.exe --register-user</code> (pour n'enregistrer que pour un utilisateur).</li> -</ul> - -<h4 id="Mac_OS_X" name="Mac_OS_X">Mac OS X</h4> - -<ul> - <li>Ouvrez le fichier .pkg dans l'installeur, et suivez les indications.</li> -</ul> - -<h4 id="Linux" name="Linux">Linux</h4> - -<ul> - <li>Décompressez le tarball dans un nouveau répertoire en utilisant la commande tar -xjf xulrunner-1.9.en-US.linux-i686.tar.bz2. Le répertoire suivant est recommandé : /opt/xulrunner/1.9.</li> - <li>Enregistrez XULRunner auprès du système d'exploitation en exécutant xulrunner --register-global (pour une installation globale, doit être faite par root) ou xulrunner --register-user (pour n'enregistrer que pour un utilisateur).</li> -</ul> - -<h3 id="D.C3.A9sinstallation_de_XULRunner" name="D.C3.A9sinstallation_de_XULRunner">Désinstallation de XULRunner</h3> - -<h4 id="Windows.2FLinux" name="Windows.2FLinux">Windows/Linux</h4> - -<ul> - <li>Depuis une invite de commande, lancez xulrunner --unregister-global ou xulrunner --unregister-user pour désenregistrer XULRunner de la même manière que vous l'avez enregistré à l'installation.</li> - <li>Supprimez le répertoire XULRunner.</li> -</ul> - -<h4 id="Mac_OS_X_2" name="Mac_OS_X_2">Mac OS X</h4> - -<p>Si vous disposez de plusieurs versions installées de XULRunner sous Mac OS X, il n'est pas possible d'en désinstaller une seule.</p> - -<ul> - <li>Pour enlever <strong>toutes</strong> les versions installées de XULRunner, supprimez le répertoire /Library/Frameworks/XUL.framework.</li> -</ul> - -<h3 id="Installation_d.27applications_XUL" name="Installation_d.27applications_XUL">Installation d'applications XUL</h3> - -<p>Les applications XUL peuvent être obtenues de différentes sources, et sont habituellement livrées sous forme d'archive ZIP portant une extension .xulapp ou .xpi. <a>Quelques applications</a> sont disponibles depuis le <a href="fr">Mozilla Developer Center</a>.</p> - -<ul> - <li>Sauvegardez l'archive de l'application sur votre bureau ou à un endroit de votre choix.</li> -</ul> - -<h4 id="Windows_2" name="Windows_2">Windows</h4> - -<p>Lancez la commande suivantes depuis le menu<em>Démarrer → Exécuter</em> ou depuis une invite de commandes :</p> - -<pre class="eval">"C:\Program Files\Mozilla XULRunner\1.9\xulrunner\xulrunner.exe" --install-app "C:\Documents and Settings\<var>nomUtilisateur</var>\Bureau\<var>monApplication</var>.xpi" -</pre> - -<p>L'application sera installée dans C:\Program Files\<var>NomVendeur</var>\<var>NomApplication</var></p> - -<h4 id="Mac_OS_X_3" name="Mac_OS_X_3">Mac OS X</h4> - -<p>Lancez la commande suivante dans une invite de commandes :</p> - -<pre class="eval">/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Bureau/<var>monApplication</var>.xpi -</pre> - -<p>L'application sera installée dans /Applications/<var>nomVendeur</var>/<var>nomApplication</var></p> - -<h4 id="Linux_2" name="Linux_2">Linux</h4> - -<p>Lancez la commande suivante dans une invite de commandes :</p> - -<pre class="eval">/opt/xulrunner/1.9/xulrunner/xulrunner --install-app ~/Desktop/<var>monApplication</var>.xpi -</pre> - -<p>L'application sera installée dans /usr/lib/<var>nomVendeur</var>/<var>nomApplication</var></p> - -<h3 id="Probl.C3.A8mes_connus" name="Probl.C3.A8mes_connus">Problèmes connus</h3> - -<ul> - <li>Les logiciels pare-feu peuvent identifier les applications XUL comme étant une seule et unique application.</li> - <li>Sous Microsoft Windows XP, toutes les applications XUL peuvent être regroupées ensemble dans la barre des tâches.</li> -</ul> - -<h3 id="Foire_aux_questions" name="Foire_aux_questions">Foire aux questions</h3> - -<p> </p> - -<dl> - <dt>Pourquoi l'installation de XULRunner est-elle aussi pénible ? Pourquoi n'y a-t-il pas un joli installeur ?</dt> - <dd>Parce que personne n'en a encore écrit le code ! Des fonctionnalités supplémentaires pour l'installation et le déploiement de XULRunner et des applications basées sur XULRunner seront disponibles dans les futures versions. - <p> </p> - </dd> - <dt>J'ai écrit une application XUL, comment puis-je la déployer chez mes utilisateurs ?</dt> - <dd>Pour l'instant, Mozilla recommande que XULRunner soit déployé individuellement avec chaque application. Consultez <a href="fr/XULRunner/D%c3%a9ploiement_de_XULRunner_1.8">Déploiement de XULRunner</a> pour plus d'informations. - <p> </p> - </dd> - <dt>Où est le code source ?</dt> - <dd><a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.0.4/source/xulrunner-1.9.0.0-source.tar.bz2">Ici.</a> - <p> </p> - </dd> - <dt>Où est le SDK ?</dt> - <dd><a class="external" href="http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.0/sdk/">Là.</a> - <p> </p> - </dd> - <dt>Je pense avoir trouvé un bogue, comment puis-je le signaler ?</dt> - <dd><a class="link-https" href="https://bugzilla.mozilla.org/">bugzilla.mozilla.org</a> sert à traquer les bogues de tous les produits Mozilla. Assurez-vous s'il vous plait que votre bogue n'est pas déjà connu avant de le poster, en utilisant la fonction de recherche. - <p> </p> - </dd> - <dt>Comment puis-je aider ?</dt> - <dd>Si vous souhaitez participer à XULRunner sans savoir par où débuter, visitez la page <a href="fr/XULRunner/Communaut%c3%a9">XULRunner:Communauté</a> et posez vos questions sur les newsgroups ou sur le canal IRC.</dd> -</dl> - -<div class="noinclude"> </div> - -<p></p> diff --git a/files/fr/archive/mozilla/xulrunner/xulrunner_anciennes_versions/index.html b/files/fr/archive/mozilla/xulrunner/xulrunner_anciennes_versions/index.html deleted file mode 100644 index afd9b3fd26..0000000000 --- a/files/fr/archive/mozilla/xulrunner/xulrunner_anciennes_versions/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: XULRunner/Anciennes versions -slug: Archive/Mozilla/XULRunner/XULRunner_Anciennes_versions -tags: - - XUL - - XULRunner -translation_of: Archive/Mozilla/XULRunner/Old_releases ---- -<dl> - <dt> - <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/">Compilations nocturnes de XULRunner 1.9.0.x</a></dt> - <dd> - Ces compilations sont effectués depuis la branche stable 1.9.</dd> -</dl> -<dl> - <dt> - <a class="external" href="http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.8.1.3/">Compilations contribuées par la communauté de XULRunner 1.8.1.3</a></dt> - <dd> - Ces compilations sont fournies par la communauté <a class="external" href="http://www.eclipse.org/atf/">Eclipse ATF</a> et sont prévues pour l'intégration dans d'autres produits (embedding). Les compilations Windows et Linux pourront exécuter des applications XULRunner normales, mais la version Mac utilise des widgets Cocoa et ne pourra donc pas lancer d'applications XULRunner.</dd> -</dl> -<dl> - <dt> - <a href="fr/Notes_de_versions_de_XULRunner_1.8.0.4">XULRunner 1.8.0.4</a></dt> - <dd> - Il s'agit de la dernière version de démonstration stable pour développeurs de la branche 1.8.0. Elle comporte des trous de sécurité connus et ne devrait pas être utilisée dans des applications traitant du contenu Web public.</dd> -</dl> diff --git a/files/fr/archive/plugins/reference/index.html b/files/fr/archive/plugins/reference/index.html deleted file mode 100644 index b50c0e6643..0000000000 --- a/files/fr/archive/plugins/reference/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: NPAPI plugin reference -slug: Archive/Plugins/Reference -tags: - - Deprecated - - Landing - - NPAPI - - Plugins - - Reference - - TopicStub -translation_of: Archive/Plugins/Reference ---- -<p>{{deprecated_header}}</p> - -<p>Les articles ci-dessous décrivent chacune des API liées aux plugins NPAPI.</p> - -<p>{{LandingPageListSubpages}}</p> diff --git a/files/fr/archive/rss/autres_ressources/index.html b/files/fr/archive/rss/autres_ressources/index.html deleted file mode 100644 index 3b45e58d8f..0000000000 --- a/files/fr/archive/rss/autres_ressources/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Autres ressources -slug: Archive/RSS/Autres_ressources -tags: - - RSS -translation_of: Archive/RSS/Other_Resources ---- -<p> </p> -<h3 id="Toutes_les_autres_ressources" name="Toutes_les_autres_ressources">Toutes les autres ressources</h3> -<ul> - <li>Anglais : - <ul> - <li><a class="external" href="http://www.reallysimplesyndication.com/">Weblog RSS de Dave Winer</a></li> - <li><a class="external" href="http://backend.userland.com/davesRss2PoliticalFaq">FAQ de Dave Winer sur la politique de RSS 2.0</a></li> - </ul> - </li> -</ul> diff --git a/files/fr/archive/rss/entités/index.html b/files/fr/archive/rss/entités/index.html deleted file mode 100644 index 3b0e56f201..0000000000 --- a/files/fr/archive/rss/entités/index.html +++ /dev/null @@ -1,1379 +0,0 @@ ---- -title: Entités -slug: Archive/RSS/Entités -tags: - - RSS - - 'RSS:Références' -translation_of: Archive/RSS/Entity_list ---- -<h2 id="Liste_des_entit.C3.A9s_RSS" name="Liste_des_entit.C3.A9s_RSS">Liste des entités RSS</h2> - -<div class="note"> -<p><strong>NOTE</strong>: Il existe trois versions différentes incompatibles de RSS 0.91. Il y a <a href="fr/RSS/Version/0.91/Netscape/R%c3%a9vision_1">Netscape RSS 0.91 (Révision 1)</a> (N 0.91 R1), <a href="fr/RSS/Version/0.91/Netscape/R%c3%a9vision_3">Netscape RSS 0.91 Révision 3</a> (N 0.91 R3) et <a href="fr/RSS/Version/0.91/Userland">Userland RSS 0.91</a> (U 0.91). Netscape RSS 0.91 utilise un DTD définissant les 96 entités supplémentaires (Userland RSS 0.91 n'utilise pas cette DTD).</p> -</div> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th rowspan="2">Entity</th> - <th rowspan="2">Decimal</th> - <th rowspan="2">Character</th> - <th colspan="9" style="text-align: center;"><a href="/en/RSS/Version" title="en/RSS/Version">RSS Version</a></th> - </tr> - <tr> - <th>0.90</th> - <th>N 0.91 R1</th> - <th>N 0.91 R3</th> - <th>U 0.91</th> - <th>0.92</th> - <th>0.93</th> - <th>0.94</th> - <th>1.0</th> - <th>2.0</th> - </tr> - <tr> - <td>á</td> - <td>#</td> - <td>á</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Á</td> - <td>#</td> - <td>Á</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>´</td> - <td>#</td> - <td>´</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>â</td> - <td>#</td> - <td>â</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Â</td> - <td>#</td> - <td>Â</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>æ</td> - <td>#</td> - <td>æ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Æ</td> - <td>#</td> - <td>Æ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>à</td> - <td>#</td> - <td>à</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>À</td> - <td>#</td> - <td>À</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>å</td> - <td>#</td> - <td>å</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Å</td> - <td>#</td> - <td>Å</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ã</td> - <td>#</td> - <td>ã</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ã</td> - <td>#</td> - <td>Ã</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ä</td> - <td>#</td> - <td>ä</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ä</td> - <td>#</td> - <td>Ä</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¦</td> - <td>¦</td> - <td>¦</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ç</td> - <td>#</td> - <td>ç</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ç</td> - <td>#</td> - <td>Ç</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¸</td> - <td>#</td> - <td>¸</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¢</td> - <td>¢</td> - <td>¢</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>©</td> - <td>#</td> - <td>©</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¤</td> - <td>¤</td> - <td>¤</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>°</td> - <td>#</td> - <td>°</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>÷</td> - <td>#</td> - <td>÷</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>é</td> - <td>#</td> - <td>é</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>É</td> - <td>#</td> - <td>É</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ê</td> - <td>#</td> - <td>ê</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ê</td> - <td>#</td> - <td>Ê</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>è</td> - <td>#</td> - <td>è</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>È</td> - <td>#</td> - <td>È</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ð</td> - <td>#</td> - <td>ð</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ð</td> - <td>#</td> - <td>Ð</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ë</td> - <td>#</td> - <td>ë</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ë</td> - <td>#</td> - <td>Ë</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>½</td> - <td>#</td> - <td>½</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¼</td> - <td>#</td> - <td>¼</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¾</td> - <td>#</td> - <td>¾</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>í</td> - <td>#</td> - <td>í</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Í</td> - <td>#</td> - <td>Í</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>î</td> - <td>#</td> - <td>î</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Î</td> - <td>#</td> - <td>Î</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¡</td> - <td>¡</td> - <td>¡</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ì</td> - <td>#</td> - <td>ì</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ì</td> - <td>#</td> - <td>Ì</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¿</td> - <td>#</td> - <td>¿</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ï</td> - <td>#</td> - <td>ï</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ï</td> - <td>#</td> - <td>Ï</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>«</td> - <td>#</td> - <td>«</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¯</td> - <td>#</td> - <td>¯</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>µ</td> - <td>#</td> - <td>µ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>·</td> - <td>#</td> - <td>·</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td> </td> - <td> </td> - <td> </td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¬</td> - <td>#</td> - <td>¬</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ñ</td> - <td>#</td> - <td>ñ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ñ</td> - <td>#</td> - <td>Ñ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ó</td> - <td>#</td> - <td>ó</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ó</td> - <td>#</td> - <td>Ó</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ô</td> - <td>#</td> - <td>ô</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ô</td> - <td>#</td> - <td>Ô</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ò</td> - <td>#</td> - <td>ò</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ò</td> - <td>#</td> - <td>Ò</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ª</td> - <td>#</td> - <td>ª</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>º</td> - <td>#</td> - <td>º</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ø</td> - <td>#</td> - <td>ø</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ø</td> - <td>#</td> - <td>Ø</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>õ</td> - <td>#</td> - <td>õ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Õ</td> - <td>#</td> - <td>Õ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ö</td> - <td>#</td> - <td>ö</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ö</td> - <td>#</td> - <td>Ö</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¶</td> - <td>#</td> - <td>¶</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>£</td> - <td>£</td> - <td>£</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>±</td> - <td>#</td> - <td>±</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>»</td> - <td>#</td> - <td>»</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>®</td> - <td>#</td> - <td>®</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>§</td> - <td>#</td> - <td>§</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td></td> - <td>#</td> - <td></td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¹</td> - <td>#</td> - <td>¹</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>²</td> - <td>#</td> - <td>²</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>³</td> - <td>#</td> - <td>³</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ß</td> - <td>#</td> - <td>ß</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>þ</td> - <td>#</td> - <td>þ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Þ</td> - <td>#</td> - <td>Þ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>×</td> - <td>#</td> - <td>×</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ú</td> - <td>#</td> - <td>ú</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ú</td> - <td>#</td> - <td>Ú</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>û</td> - <td>#</td> - <td>û</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Û</td> - <td>#</td> - <td>Û</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ù</td> - <td>#</td> - <td>ù</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ù</td> - <td>#</td> - <td>Ù</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¨</td> - <td>#</td> - <td>¨</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ü</td> - <td>#</td> - <td>ü</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ü</td> - <td>#</td> - <td>Ü</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ý</td> - <td>#</td> - <td>ý</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>Ý</td> - <td>#</td> - <td>Ý</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>¥</td> - <td>¥</td> - <td>¥</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - <tr> - <td>ÿ</td> - <td>#</td> - <td>ÿ</td> - <td>✔</td> - <td>✔</td> - <td>✔</td> - <td> </td> - <td> </td> - <td> </td> - <td> </td> - <td>?</td> - <td> </td> - </tr> - </tbody> -</table> diff --git a/files/fr/archive/rss/index.html b/files/fr/archive/rss/index.html deleted file mode 100644 index 4c298461f8..0000000000 --- a/files/fr/archive/rss/index.html +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: RSS -slug: Archive/RSS -tags: - - RSS -translation_of: Archive/RSS ---- -<div class="callout-box"><strong><a href="/fr/RSS/Premiers_pas" title="fr/RSS/Premiers_pas">Premiers pas</a></strong><br> -<small>Ce tutoriel vous guidera pour débuter avec RSS.</small></div> - -<div><strong>RSS (Really Simple Syndication)</strong> est un format de données populaire similaire à <a href="/fr/HTML" title="fr/HTML">HTML</a>, basé sur <a href="/fr/XML" title="fr/XML">XML</a> et utilisé pour la syndication. RSS a une histoire compliquée et il existe une multitude de <a href="/fr/RSS/Version" title="fr/RSS/Version">versions</a> différentes et incompatibles. (Certaines sont basées sur <a href="/fr/RDF" title="fr/RDF">RDF</a>, mais la plupart utilisent seulement <a href="/fr/XML" title="fr/XML">XML</a>) Malgré cela, RSS est aujourd'hui un format très répandu, utilisé pour le suivi d'actualités, de blogs, de radios et de télévisions.</div> - -<p> </p> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation"><a href="/Special:Tags?tag=RSS&language=fr" title="Special:Tags?tag=RSS&language=fr">Documentation</a></h2> - - <dl> - <dt><a href="/fr/RSS/Comptage_de_vos_commentaires_avec_le_module_RSS_Slash" title="fr/RSS/Comptage_de_vos_commentaires_avec_le_module_RSS_Slash">Comptage de vos commentaires avec le module RSS Slash</a></dt> - <dd><small>Charles Iliya Krempeaux présente le module <em>RSS Slash</em>, explique pourquoi il est si populaire chez certains et montre comment il sert à <em>compter</em> vos commentaires (à traduire de <a href="/en/RSS/Article/Why_RSS_Slash_is_Popular_-_Counting_Your_Comments">Why RSS Slash is Popular - Counting Your Comments</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/RSS/Lier_vers_vos_commentaires_avec_le_module_RSS_Well-Formed_Web" title="fr/RSS/Lier_vers_vos_commentaires_avec_le_module_RSS_Well-Formed_Web">Lier vers vos commentaires avec le module RSS Well-Formed Web</a></dt> - <dd><small>Charles Iliya Krempeaux présente le module <em>RSS Well-Formed Web</em>, explique pourquoi il est si populaire chez certains et montre comment il sert à <em>lier</em> vos commentaires (à traduire de <a href="/en/RSS/Article/Why_Well-Formed_Web_RSS_Module_is_Popular_-_Syndicating_Your_Comments">Why Well-Formed Web RSS Module is Popular - Syndicating Your Comments</a>).</small></dd> - </dl> - - <dl> - <dt><a class="external" href="http://diveintomark.org/archives/2004/02/04/incompatible-rss">The Myth of RSS Compatibility</a></dt> - <dd><small>Mark Pilgrim évoque l'histoire chronologique du RSS et détaille les incompatibilités entre chaque version.</small></dd> - </dl> - - <dl> - <dt><a class="external" href="http://www.tbray.org/ongoing/When/200x/2005/07/27/Atomic-RSS">Atomic RSS</a></dt> - <dd><small>Tim Bray explique comment utiliser Atom 1.0 comme micro format et module d'extension pour RSS 2.0 ; en conservant RSS 2.0 pour votre format de syndication mais en y apportant certains éléments d'Atom 1.0.</small></dd> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=RSS&language=fr" title="Special:Tags?tag=RSS&language=fr">Tous les articles…</a></span></p> - </td> - <td> - <h2 class="Community" id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h2> - - <ul> - <li>Voir les forums XML de Mozilla…</li> - </ul> - - <p></p><ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-xml"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xml"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xml/feeds"> Flux de syndication</a></li> -</ul><p></p> - - <h2 class="Related_Topics" id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h2> - - <dl> - <dd><a href="/fr/RDF" title="fr/RDF">RDF</a>, <a href="/fr/XML" title="fr/XML">XML</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Catégories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/rss/premiers_pas/fonctionnement_de_rss/index.html b/files/fr/archive/rss/premiers_pas/fonctionnement_de_rss/index.html deleted file mode 100644 index d6d8601ddc..0000000000 --- a/files/fr/archive/rss/premiers_pas/fonctionnement_de_rss/index.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Fonctionnement de RSS -slug: Archive/RSS/Premiers_pas/Fonctionnement_de_RSS -tags: - - Premiers_pas - - RSS - - 'RSS:Premiers_pas' -translation_of: Archive/RSS/Getting_Started/How_RSS_Works ---- -<p>Cette page explique le fonctionnement de RSS. Vous ne créerez pas encore vos propres fichiers RSS, mais vous découvrirez les différents systèmes qui entrent en jeu lors de la syndication RSS.</p> - -<h3 id="Fonctionnement_de_RSS" name="Fonctionnement_de_RSS">Fonctionnement de RSS</h3> - -<p>Deux composants principaux entrent en jeu dans la syndication avec RSS : le côté<em>serveur</em> et le côté<em>client</em>.</p> - -<p>Le côté<em>serveur</em> de la syndication RSS est la partie du système qui produit le flux RSS. Un site d'actualité, une radio ou TV IP se trouvent par exemple du côté<em>serveur</em> de la syndication.</p> - -<p>Le côté<em>client</em> de la syndication RSS est la partie du système qui consomme le flux RSS. Le navigateur Mozilla Firefox, un agrégateur RSS de bureau ou un site d'agrégation se trouvent donc du côté<em>client</em> de la syndication.<br> - </p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/RSS:Premiers_pas:Pourquoi_utiliser_RSS" style="float: left;">« Précédent</a><a href="/fr/docs/RSS:Premiers_pas:Hello_World">Suivant »</a></p> -</div><p></p> diff --git a/files/fr/archive/rss/premiers_pas/index.html b/files/fr/archive/rss/premiers_pas/index.html deleted file mode 100644 index 6ea56e5dbf..0000000000 --- a/files/fr/archive/rss/premiers_pas/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Premiers pas -slug: Archive/RSS/Premiers_pas -tags: - - Aide_pour_les_éditeurs_de_MDC - - Premiers_pas - - RSS - - 'RSS:Premiers_pas' - - Traduction_en_cours -translation_of: Archive/RSS/Getting_Started ---- -<p> -</p> -<h3 id="Introduction" name="Introduction"> Introduction </h3> -<p>Ce tutoriel est une introduction à la <b>Really Simple Syndication</b> (<b>RSS</b>). -</p><p>Il vous guidera pas à pas à travers les bases de RSS à l'aide d'exemples fonctionnels visibles en action. Ce tutoriel suit la philosophie selon laquelle <i>la meilleure manière d'apprendre est de faire</i>. C'est pourquoi vous créerez vos propres fichiers RSS à la main. -</p> -<h4 id=".C3.80_qui_est_destin.C3.A9_ce_tutoriel" name=".C3.80_qui_est_destin.C3.A9_ce_tutoriel"> À qui est destiné ce tutoriel </h4> -<p>Ce tutoriel s'adresse surtout aux débutants (c'est-à-dire, ceux qui n'ont que peu ou aucune expérience de RSS). Cependant, ceux qui ont une certaine expérience de RSS peuvent également le trouver utile pour découvrir des informations qu'ils ne connaissaient pas, ou simplement pour se rafraichir la mémoire. -</p><p>Ce tutoriel suppose que vous avez une certaine expérience de <a href="fr/HTML">HTML</a> (ou <a href="fr/XML">XML</a>). Que vous connaissez les bases du <i>balisage</i>. En d'autres mots, que ce code vous semble familier : -</p> -<pre class="eval"> Ceci est un morceau de texte avec une balise <b>en gras</b>. -</pre> -<p>Si cela ne vous pose pas de problème, vous ne devriez pas en avoir non plus avec l'apprentissage de RSS. -</p> -<div class="note"> -<p><b>NOTE</b> : Si vous n'êtes PAS un développeur Web et ne désirez pas en devenir un, ce tutoriel n'est PAS pour vous. Vous devez être capable de créer un balisage pour utiliser convenablement ce tutoriel. -</p> -</div> -<h4 id="Avant_de_commencer" name="Avant_de_commencer"> Avant de commencer </h4> -<p>Pour obtenir le maximum de ce tutoriel, vous aurez besoin d'un éditeur de texte et d'un lecteur RSS. Vous devez également savoir utiliser l'un et l'autre. -</p> -<div class="note"> -<p><b>NOTE</b> : Un traitement de texte n'est pas un éditeur de texte. Si vous utilisez un traitement de texte, vous devez vous assurer qu'il enregistre vos fichiers RSS dans un format texte uniquement (pur et simple). -</p> -</div> -<p>Il n'est pas obligatoire de créer les fichier RSS de ce tutoriel, vous pouvez simplement le parcourir, mais c'est une manière moins efficace d'apprendre. Vous retiendrez mieux les informations si vous créez les fichiers RSS vous-même. -</p> -<h4 id="Utilisation_de_ce_tutoriel" name="Utilisation_de_ce_tutoriel"> Utilisation de ce tutoriel </h4> -<p>Bien que chaque page de ce tutoriel aie été écrite de manière à former un petit tutoriel en elle-même, il est entendu que vous avez déjà connaissance des informations présentes dans les parties précédentes du tutoriel. Bien qu'il soit possible de se rendre directement à n'importe quel point du tutoriel, il est vivement suggéré aux nouveaux venus en RSS de lire le tutoriel dans l'ordre proposé. -</p> -<h3 id="Tutoriel" name="Tutoriel"> Tutoriel </h3> -<ol><li><b><a href="fr/RSS/Premiers_pas/Pr%c3%a9sentation_de_RSS">Présentation de RSS</a></b> -</li><li><b><a href="fr/RSS/Premiers_pas/Pourquoi_utiliser_RSS">Pourquoi utiliser RSS</a></b> -</li><li><b><a href="fr/RSS/Premiers_pas/Fonctionnement_de_RSS">Fonctionnement de RSS</a></b> -</li><li><b><a href="fr/RSS/Premiers_pas/Hello_World">Hello World</a></b> (à venir) -</li><li><b><a href="fr/RSS/Premiers_pas/Syndication">Syndication</a></b> -</li><li><b><a href="fr/RSS/Premiers_pas/Blogs">Blogs</a></b> (à venir) -</li><li><b><a href="fr/RSS/Premiers_pas/Broadcatching">Broadcatching</a></b> (à venir) -</li><li><b><a href="fr/RSS/Premiers_pas/Microformats">Microformats</a></b> (à venir) -</li><li><b><a href="fr/RSS/Premiers_pas/Advanced_Broadcatching">Advanced Broadcatching</a></b> (à venir) -</li></ol> -<p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/fr/archive/rss/premiers_pas/pourquoi_utiliser_rss/index.html b/files/fr/archive/rss/premiers_pas/pourquoi_utiliser_rss/index.html deleted file mode 100644 index f91867a655..0000000000 --- a/files/fr/archive/rss/premiers_pas/pourquoi_utiliser_rss/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Pourquoi utiliser RSS -slug: Archive/RSS/Premiers_pas/Pourquoi_utiliser_RSS -tags: - - Premiers_pas - - RSS - - 'RSS:Premiers_pas' -translation_of: Archive/RSS/Getting_Started/Why_use_RSS ---- -<p>Cette page explique pourquoi vous pourriez être amené à utiliser RSS. Elle n'explique pas encore comment créer vos propres fichiers RSS, mais présente plusieurs raisons de le faire.</p> - -<h3 id="Pourquoi_utiliser_RSS_.3F" name="Pourquoi_utiliser_RSS_.3F">Pourquoi utiliser RSS ?</h3> - -<p>Si vous lisez ces lignes, vous avez probablement déjà vos propres raisons de vouloir utiliser RSS. Il en existe beaucoup, mais les deux raisons que l'on retrouve le plus souvent sont les suivantes :</p> - -<ol> - <li>RSS correspond à un réel besoin</li> - <li>Utiliser RSS fait très tendance, tout le monde le fait</li> -</ol> - -<p>RSS connait un énorme élan de popularité. On l'utilise pour syndiquer toutes sortes de choses : articles de journaux en ligne, blogs, marque-pages, émissions radio IP, émissions TV IP, mises à jour de logiciels, courriels, listes de diffusion, playlists de musique, et bien d'autres. Tout ce qui est régulièrement mis à jour peut être syndiqué avec RSS.</p> - -<h3 id="Les_agr.C3.A9gateurs_RSS_sont_partout" name="Les_agr.C3.A9gateurs_RSS_sont_partout">Les agrégateurs RSS sont partout</h3> - -<p>Les logiciels pouvant lire et utiliser RSS sont également partout. Mozilla Firefox gère le RSS à sa façon avec les marque-pages dynamiques. Il y a d'ailleurs trop d'agrégateurs RSS pour les citer tous, qu'ils soient sous la forme d'applications de bureau ou de sites d'agrégation spécialisés. C'est l'une des raisons principales d'utiliser RSS pour la syndication : vos flux RSS pourront être lus par tous ces agrégateurs.<br> - </p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/RSS:Premiers_pas:Présentation_de_RSS" style="float: left;">« Précédent</a><a href="/fr/docs/RSS:Premiers_pas:Fonctionnement_de_RSS">Suivant »</a></p> -</div><p></p> diff --git a/files/fr/archive/rss/premiers_pas/présentation_de_rss/index.html b/files/fr/archive/rss/premiers_pas/présentation_de_rss/index.html deleted file mode 100644 index 4051f856c8..0000000000 --- a/files/fr/archive/rss/premiers_pas/présentation_de_rss/index.html +++ /dev/null @@ -1,255 +0,0 @@ ---- -title: Présentation de RSS -slug: Archive/RSS/Premiers_pas/Présentation_de_RSS -tags: - - Premiers_pas - - RSS - - 'RSS:Premiers_pas' -translation_of: Archive/RSS/Getting_Started/What_is_RSS ---- -<p> </p> - -<p>Cette page explique ce qu'est RSS. Vous n'allez pas créer vos propres fichiers RSS tout de suite, mais vous découvrirez la façon dont RSS est utilisé en général, ainsi que quelques fichiers RSS d'exemples des utilisations les plus courantes. Vous aurez aussi droit à un petit historique à propos de RSS.</p> - -<h3 id="Qu.27est_ce_que_RSS_.3F" name="Qu.27est_ce_que_RSS_.3F">Qu'est ce que RSS ?</h3> - -<p>Les <a href="fr/RSS/Version">versions de RSS</a> les plus populaires sont des langages de balisage basés sur <a href="fr/XML">XML</a> utilisés pour la syndication. (Bien qu'il existe des formats RSS basés sur <a href="fr/RDF">RDF</a> tels que <a href="fr/RSS/Version/0.90">RSS 0.90</a> et <a href="fr/RSS/Version/1.0">RSS 1.0</a> qui sont aujourd'hui dépréciés). Les utilisations les plus courantes de la syndication RSS se font pour la syndication des sites Web d'actualité, des blogs, des radios et TV IP.</p> - -<p>Ce tutoriel traite essentiellement de <a href="fr/RSS/Version/2.0">RSS 2.0</a>, mais évoque certains aspects spécifiques aux autres <a href="fr/RSS/Version">versions de RSS</a>.</p> - -<p>On n'écrit presque jamais du RSS à la main. La plupart du temps, c'est un programme côté serveur (en général écrit en PHP, Java, C# ou Python) qui s'en occupe. Cependant, pour les besoins du tutoriel, nous allons écrire nos propres fichiers RSS à la main.</p> - -<h3 id="Bref_historique_de_RSS" name="Bref_historique_de_RSS">Bref historique de RSS</h3> - -<p>En mars 1999, Netscape a publié <a href="fr/RSS/Version/0.90">RSS 0.90</a>. On était alors bien loin du RSS d'aujourd'hui. Il ne s'agissait pas réellement d'un format de syndication mais plutôt d'un format fournissant le résumé d'un site Web. En fait, à l'époque, RSS ne signifiait pas encore <strong>Really Simple Syndication</strong>, mais <strong>Rich Site Summary</strong> (NdT : Résumé de site enrichi).</p> - -<p>En juillet 1999 sort <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a>. Tout comme <a href="fr/RSS/Version/0.90">RSS 0.90</a>, le RSS 0.91 de Netscape était un format destiné à fournir le résumé d'un site Web et non pas un format de syndication (comme c'est le cas aujourd'hui). Cette nouvelle version a été concue pour simplifier les choses. En effet, alors que RSS 0.90 était basé sur <a href="fr/RDF">RDF</a>, que beaucoup trouvaient particulièrement complexe, RSS 0.91 de Netscape était quant à lui basé uniquement sur <a href="fr/XML">XML</a> et ajoutait une <a href="fr/DTD">DTD</a> permettant d'utiliser de nombreuses entités (que l'on trouve généralement en <a href="fr/HTML">HTML</a>).</p> - -<p>Dès lors, Netscape déclara comme "déprécié" le format <a href="fr/RSS/Version/0.90">RSS 0.90</a> basé sur <a href="fr/RDF">RDF</a> et demanda à tout le monde d'utiliser le <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a> qui lui, était basé sur du <a href="fr/XML">XML</a>.</p> - -<p>En juin 2000 sort le <a href="fr/RSS/Version/0.91/Userland">RSS 0.91 de Userland</a>. Oui, vous l'avez compris, il existe bien deux versions différentes de <a href="fr/RSS/Version/0.91">RSS 0.91</a>. La différence entre ces deux versions de <a href="fr/RSS/Version/0.91">RSS 0.91</a> (<a href="fr/RSS/Version/0.91/Netscape">celle de Netscape</a> et <a href="fr/RSS/Version/0.91/Userland">celle de Userland</a>) est que le RSS 0.91 de Userland ne propose pas la DTD du RSS 0.91 de Netscape, et donc ne dispose pas des entités supplémentaires (et que l'on trouve généralement en <a href="fr/HTML">HTML</a>) dont disposait le RSS 0.91 de Netscape . En dehors de ça, ils sont similaires. Techniquement, le RSS 0.91 de Userland n'est qu'une version moins complète du RSS 0.91 de Netscape.</p> - -<p>En décembre 2000, le<em>RSS-DEV working group</em> sort <a href="fr/RSS/Version/1.0">RSS 1.0</a>. Cette version de RSS n'était plus basée sur du <a href="fr/XML">XML</a> pur, mais à nouveau sur <a href="fr/RDF">RDF</a>, comme l'était le <a href="fr/RSS/Version/0.90">RSS 0.90</a> d'origine. Le<em>RSS-DEV working group</em> a modifié la signification de RSS en <strong>RDF Site Summary</strong> (NdT : résumé en RDF de site Web), du moins c'était ainsi qu'était présenté RSS dans cette version.</p> - -<p>À ce moment là, nous avions donc le <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a>, le <a href="fr/RSS/Version/0.91/Userland">RSS 0.91 de Userland</a> et le <a href="fr/RSS/Version/1.0">RSS 1.0</a> du<em>RSS-DEV working group</em>.</p> - -<p>Un peu plus tard, au cours de ce même mois de décembre 2000, Userland a publié <a href="fr/RSS/Version/0.92">RSS 0.92</a>, censé remplacer le <a href="fr/RSS/Version/0.91/Userland">RSS 0.91 de Userland</a>. Vous l'aurez remarqué, dès lors la numérotation des versions de RSS devient encore plus confuse puisque RSS 0.92 est une version plus récente que RSS 1.0.</p> - -<p>À présent, on disposait du <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a>, du <a href="fr/RSS/Version/1.0">RSS 1.0</a> du<em>RSS-DEV working group</em> et du <a href="fr/RSS/Version/0.92">RSS 0.92</a> de Userland.</p> - -<p>En avril 2001, Userland a sorti une ébauche de <a href="fr/RSS/Version/0.93">RSS 0.93</a>. Cette version de RSS n'a cependant jamais été finalisée et n'a donc jamais remplacé le <a href="fr/RSS/Version/0.92">RSS 0.92</a> de Userland.</p> - -<p>Donc, à ce moment là, si l'on avait <em>toujours</em> le <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a>, le <a href="fr/RSS/Version/1.0">RSS 1.0</a> du<em>RSS-DEV working group</em> et le <a href="fr/RSS/Version/0.92">RSS 0.92</a> de Userland, certains se sont également mis à utiliser <a href="fr/RSS/Version/0.93">RSS 0.93</a> et <a href="fr/RSS/Version/0.94">RSS 0.94</a> alors qu'ils n'étaient pas supposés l'être.</p> - -<p>En septembre 2002, Userland publie <a href="fr/RSS/Version/2.0">RSS 2.0</a>, destiné à remplacer <a href="fr/RSS/Version/0.92">RSS 0.92</a> ainsi que les ébauches <a href="fr/RSS/Version/0.93">RSS 0.93</a> et <a href="fr/RSS/Version/0.94">RSS 0.94</a> (que personne n'était supposé utiliser). Userland a choisi de passer directement le numéro de version à <strong>2.0</strong> puisque le<em>RSS-DEV working group</em> avait déjà utilisé le numéro de version <strong>1.0</strong> pour leur <a href="fr/RSS/Version/1.0">RSS 1.0</a> basé sur RDF.</p> - -<p>À ce moment là, on pouvait donc trouver le <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a>, le <a href="fr/RSS/Version/1.0">RSS 1.0</a> du<em>RSS-DEV working group</em> et le <a href="fr/RSS/Version/2.0">RSS 2.0</a> de Userland.</p> - -<p>L'histoire ne s'arrête pas là. Une première fois en novembre 2002, et ensuite en janvier 2003, Userland a modifié les spécifications de <a href="fr/RSS/Version/2.0">RSS 2.0</a>. Et bien que ces spécifications soient différentes, toutes sont présentées comme étant RSS 2.0 sur l'élément <a href="fr/RSS/%c3%89l%c3%a9ment/rss"><rss></a>.</p> - -<p>Aujourd'hui, nous avons toujours le <a href="fr/RSS/Version/0.91/Netscape">RSS 0.91 de Netscape</a> (puisque Netscape ne l'a jamais déclaré comme déprécié), bien que plus personne ne l'utilise. Les formats les plus utilisés sont les formats <a href="fr/RSS/Version/1.0">RSS 1.0</a> basé sur du <a href="fr/RDF">RDF</a> et <a href="fr/RSS/Version/2.0">RSS 2.0</a> basé sur du <a href="fr/XML">XML</a> avec un léger avantage pour ce dernier. C'est cette version qui est présentée dans ce tutoriel.</p> - -<h3 id="Comment_RSS_est_utilis.C3.A9_aujourd.27hui" name="Comment_RSS_est_utilis.C3.A9_aujourd.27hui">Comment RSS est utilisé aujourd'hui</h3> - -<p>Aujourd'hui, RSS est essentiellement utilisé à des fins de syndication. La syndication est le fait de signaler aux autres que vous avez du contenu à les faire consommer. En d'autres mots, vous dites aux autres quelque chose qui ressemble à : « Ohé vous autres, j'ai des articles que je voudrais vous faire lire ! Abonnez-vous donc à mon flux RSS et vous aurez la possibilité de lire les articles plus récents qui sortent. »</p> - -<div class="note"> -<p><strong>NOTE</strong> : Si vous proposez un flux RSS qui n'est pas protégé par mot de passe, cela signifie que vous permettez implicitement à chacun d'utiliser son contenu comme bon lui semble. Tout le monde peut le lire, en faire une copie, partager cette copie, le diffuser sur sont propre site web, le re-syndiquer, etc.</p> - -<p>Si vous ne souhaitez pas que cela arrive, ne placez pas votre contenu dans un flux RSS non protégé par mot de passe, et ne rendez pas le mot de passe public évidemment.</p> -</div> - -<p>Les sites web d'actualité utilisent RSS pour fournir à tous la liste de leurs derniers articles parus. Par exemple :</p> - -<pre class="eval"> <span class="nowiki"> - <?xml version="1.0"?> - - <rss version="2.0"> - - <channel> - <title>Exemple de site d'informations</title> - <description>Ceci est un exemple de site d'informations journalistique</description> - <lastBuildDate>Wed, 27 Jul 2005 00:30:30 -0700</lastBuildDate> - <link>http://news.example.com/</link> - - <item> - <title>Brève : J'aime le pain</title> - <guid>4d4a0a12-f188-4c97-908b-eea27213c2fe</guid> - <pubDate>Wed, 27 Jul 2005 00:30:30 -0700</pubDate> - <link>http://news.example.com/artcle/554</link> - </item> - <item> - <title>La nouvelle du jour: Les oiseaux volent</title> - <guid>c4a63f09-b45b-466b-8773-6ff264001ab7</guid> - <pubDate>Tue, 19 Jul 2005 04:32:51 -0700</pubDate> - <link>http://news.example.com/artcle/553</link> - </item> - <item> - <title>Le feu ça brûle</title> - <guid>c1795324-d5ea-44fa-95b1-b5ce2090d4f1</guid> - <pubDate>Sun, 15 May 2005 13:02:08 -0700</pubDate> - <link>http://news.example.com/artcle/552</link> - </item> - </channel> - - </rss> - </span> -</pre> - -<p>Les blogueurs utilisent RSS pour fournir à tous une liste de leurs derniers messages. Par exemple :</p> - -<pre class="eval"> <span class="nowiki"> - <?xml version="1.0"?> - - <rss version="2.0"> - - <channel> - <title>Blog de Michel Martin</title> - <description>Il s'agit du blog de Michel Martin</description> - <lastBuildDate>Sun, 15 May 2005 13:02:08 -0500</lastBuildDate> - <link>http://michel-martin.example.net/</link> - - <item> - <title>Depuis le temps que je bloggue...</title> - <guid>http://joe-blow.example.net/log/21</guid> - <pubDate>Sun, 15 May 2005 13:02:08 -0500</pubDate> - <link>http://joe-blow.example.net/log/21</link> - </item> - <item> - <title>Je suis super mal1</title> - <guid>http://joe-blow.example.net/log/20</guid> - <pubDate>Sat, 14 May 2005 22:19:18 -0500</pubDate> - <link>http://joe-blow.example.net/log/20</link> - </item> - <item> - <title>Allo ?</title> - <guid>http://joe-blow.example.net/log/19</guid> - <pubDate>Sat, 14 May 2005 09:55:59 -0500</pubDate> - <link>http://joe-blow.example.net/log/19</link> - </item> - <item> - <title>Mauvais jour pour un chat noir</title> - <guid>http://joe-blow.example.net/log/18</guid> - <pubDate>Fri, 13 May 2005 13:13:13 -0500</pubDate> - <link>http://joe-blow.example.net/log/18</link> - </item> - </channel> - - </rss> - </span> -</pre> - -<p>Ceux qui montent une radio IP (IPRadio) utilisent RSS pour permettre aux utilisateurs d'écouter leurs émissions. Exemple :</p> - -<pre class="eval"> <span class="nowiki"> - <?xml version="1.0"?> - - <rss version="2.0"> - - <channel> - <title>Hervé's IPradio Show</title> - <description>La meilleure émission de radio du net, avec Hervé !</description> - <lastBuildDate>Mon, 15 Aug 2005 16:12:37 -0400</lastBuildDate> - <link>http://joe.ipradio.example.net/</link> - - <item> - <title>On voit tes marques de bronzage</title> - <guid>http://joe.ipradio.example.net/show/55</guid> - <pubDate>Mon, 15 Aug 2005 16:11:57 -0400</pubDate> - <enclosure url="http://joe.ipradio.example.net/show/55" - length="4487216" - type="application/ogg" - /> - </item> - <item> - <title>La valise Hervé L</title> - <guid>http://joe.ipradio.example.net/show/54</guid> - <pubDate>Mon, 8 Aug 2005 13:12:12 -0400</pubDate> - <enclosure url="http://joe.ipradio.example.net/show/54" - length="4892178" - type="audio/x-mp3" - /> - </item> - <item> - <title>Les 10 minutes du peuple</title> - <guid>http://joe.ipradio.example.net/show/53</guid> - <pubDate>Mon, 1 Aug 2005 18:22:14 -0400</pubDate> - <enclosure url="http://joe.ipradio.example.net/show/53" - length="3984215" - type="application/ogg" - /> - </item> - </channel> - - </rss> - </span> -</pre> - -<div class="note"> -<p><strong>NOTE</strong> : On parle parfois de Podcasting pour parler d'écoute de la radio sur internet. Il est préférable de ne pas employer ce terme car il semble que Apple possède les droits d'utilisation de ce terme. Ce mot <strong>appartient</strong> donc à Apple.</p> -</div> - -<p>Ceux qui proposent de la TV sur IP (IPTV) utilisent RSS pour permettrent aux utilisateurs de voir leurs émissions en ligne. Exemple :</p> - -<pre class="eval"> <span class="nowiki"> - <?xml version="1.0"?> - - <rss version="2.0"> - - <channel> - <title>L'émission de Sylvie</title> - <description>L'émission à ne pas rater</description> - <lastBuildDate>Tue, 23 Aug 2005 21:02:05 -0800</lastBuildDate> - <link>http://sylvietv.example.com/</link> - - <item> - <title>Ca c'est fort !</title> - <guid>http://sylvietv.example.com/show/4</guid> - <pubDate>Tue, 23 Aug 2005 21:02:05 -0800</pubDate> - <enclosure url="http://katetv.example.com/show/4" - length="1911146" - type="application/ogg" - /> - </item> - <item> - <title>Mate un peu ça !</title> - <guid>http://sylvietv.example.com/show/3</guid> - <pubDate>Tue, 16 Aug 2005 16:11:57 -0400</pubDate> - <enclosure url="http://katetv.example.com/show/3" - length="1387442" - type="application/ogg" - /> - </item> - <item> - <title>Encore moi</title> - <guid>http://sulvietv.example.com/show/2</guid> - <pubDate>Tue, 9 Aug 2005 13:12:12 -0400</pubDate> - <enclosure url="http://katetv.example.com/show/2" - length="1894877" - type="video/mpeg" - /> - </item> - <item> - <title>Salut</title> - <guid>http://sylvietv.example.com/show/1</guid> - <pubDate>Tue, 2 Aug 2005 18:22:14 -0400</pubDate> - <enclosure url="http://katetv.example.com/show/1" - length="17442215" - type="application/ogg" - /> - </item> - </channel> - - </rss> - </span> -</pre> - -<p>Le lecteur attentif se sera rendu compte que les exemples de<em>site d'informations</em> et de<em>blogueur</em> se ressemblent. De même, les exemples de<em>IPRadio</em> et<em>IPTV</em> se ressemblent. En fait, la seule différence entre les exemples site d'informations/blogueur et IPRadio/IPTV réside dans le fait que les 2 premiers utilisent l'élément <a href="fr/RSS/%c3%89l%c3%a9ment/link"><link></a> et que les 2 autres utilisent l'élément <a href="fr/RSS/%c3%89l%c3%a9ment/enclosure"><enclosure></a></p> - -<div class="note"> -<p><strong>NOTE</strong> : Ces exemples sont simplifiés à l'extrême et ont été conçus pour vous donner une idée de ce à quoi ressemble du RSS basique. Lorsque vous créerez vos propres flux RSS, vous les voudrez probablement plus complets et plus complexes et ils inclueront sûrement d'autres <a href="fr/RSS/%c3%89l%c3%a9ment">éléments RSS</a> et vous utiliserez peut-être quelques-uns des différents <a href="fr/RSS/Module">modules RSS</a>.</p> -</div> - -<p></p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/RSS:Premiers_pas:Pourquoi_utiliser_RSS">Suivant »</a></p> -</div><p></p> diff --git a/files/fr/archive/rss/premiers_pas/syndication/index.html b/files/fr/archive/rss/premiers_pas/syndication/index.html deleted file mode 100644 index 6cf258fa19..0000000000 --- a/files/fr/archive/rss/premiers_pas/syndication/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Syndication -slug: Archive/RSS/Premiers_pas/Syndication -tags: - - Premiers_pas - - RSS - - 'RSS:Premiers_pas' -translation_of: Archive/RSS/Getting_Started/Syndicating ---- -<p>Cette page explique la syndication Web avec RSS. Vous y apprendrez comment faire pour que visiteurs et machines trouvent facilement votre flux RSS.</p> - -<h3 id="Pr.C3.A9sentation_de_la_syndication" name="Pr.C3.A9sentation_de_la_syndication">Présentation de la syndication</h3> - -<p>La <strong>syndication</strong> (ou <strong>syndication Web</strong>) consiste à mettre à disposition d'autres personnes du contenu texte, photo, audio, ou vidéo. Lorsque vous écrivez sur votre blog, que vous produisez une émission de radio ou de télévision par Internet, vous syndiquez.</p> - -<p>RSS vous aide à syndiquer du contenu, en le présentant sous un format aisément exploitable par des machines.</p> - -<p>La syndication avec RSS implique 3 choses :</p> - -<ol> - <li>Créer un flux RSS.</li> - <li>Ajouter un élément <code><a href="fr/HTML/Element/link"><link></a></code> spécial dans une ou des pages HTML.</li> - <li>Ajouter un élément <code><a href="fr/HTML/Element/a"><a></a></code> spécial dans une ou des pages HTML.</li> -</ol> - -<p>Nous avons déjà évoqué le 1er point - la création des flux RSS - aussi nous intéresserons nous plus particulièrement aux points 2 et 3 dans ce document.</p> - -<h3 id="Ajouter_l.27.C3.A9l.C3.A9ment_.3Clink.3E" name="Ajouter_l.27.C3.A9l.C3.A9ment_.3Clink.3E">Ajouter l'élément <link></h3> - -<p>Souvent, les données présentes dans un flux RSS le sont également sur une page Web HTML. Lorsque c'est le cas, la page Web HTML peut signaler la présence du flux aux visiteurs et aux machines avec un code comme celui-ci :</p> - -<pre class="eval"><link rel="alternate" type="application/rss+xml" href="<a class="external" href="http://example.com/feed" rel="freelink">http://example.com/feed</a>" /> -</pre> - -<p>Vous pouvez également annoncer le flux RSS depuis d'autres emplacements (par exemple, depuis un billet de blog). Vous pouvez utiliser dans ce cas un code similaire à ceci :</p> - -<pre class="eval"><link rel="home" type="application/rss+xml" href="<a class="external" href="http://example.com/feed" rel="freelink">http://example.com/feed</a>" /> -</pre> - -<p>Remarquez que cela ressemble fortement au code précédent, la seule différence étant la valeur de l'attribut <code>rel</code> (la valeur de <code>rel</code> dans le code précédent était <code>alternate</code>, elle est ici <code>home</code>.</p> - -<div class="note"> -<p><strong>NOTE</strong> : Il y a pas mal d'abus dans l'utilisation de l'élément <code><link></code> pour la syndication RSS. Certains blogueurs veulent que les internautes puissent <em>s'abonner</em> à leur blog depuis n'importe quelle page (et pas uniquement leur <em>page d'accueil</em>). Beaucoup ont donc ajouté l'élément <code><link></code> avec un attribut <code>rel="alternate"</code> sur chaque page (dans les entrées du blog également, et pas uniquement sur la <em>page d'accueil</em>). C'est une mauvaise pratique ! Cela devrait être <code>rel="home"</code>. (Voir <a href="fr/Understanding_rel_and_rev">Understanding rel and rev</a> pour plus d'informations.) La chose la plus importante lorsque vous utilisez l'élément <code><link></code> pour la syndication de votre flux RSS est de mettre l'attribut <code>type="application/rss+xml"</code>.</p> -</div> - -<h3 id="Ajouter_l.27.C3.A9l.C3.A9ment_.3Ca.3E" name="Ajouter_l.27.C3.A9l.C3.A9ment_.3Ca.3E">Ajouter l'élément <a></h3> - -<p>L'utilisation de l'élement HTML <code><link></code> est très puissante mais elle est la plupart de temps <em>cachée</em>. Pour publier plus directement votre flux RSS, vous pouvez utiliser l'élément HTML <code><a></code>. Cela imite l'élément <code><link></code> que nous venons de voir.</p> - -<p>Quand vous faites un lien depuis la page Web où les données d'un flux RSS sont également présentes, utilisez :</p> - -<pre class="eval"><a rel="alternate" type="application/rss+xml" href="<a class="external" href="http://example.com/feed" rel="freelink">http://example.com/feed</a>">…</a> -</pre> - -<p>Quand vous faites un lien depuis, par exemple, un article de blog, utilisez le code suivant :</p> - -<pre class="eval"><a rel="home" type="application/rss+xml" href="<a class="external" href="http://example.com/feed" rel="freelink">http://example.com/feed</a>">…</a> -</pre> - -<p>Une nouvelle fois, remarquez que les deux codes sont très similaires. Seule la valeur de l'attribut <code>rel</code> change. La valeur de rel du premier code est <code>alternate</code> ; dans le second elle est <code>home</code>.</p> - -<h3 id="Ic.C3.B4nes_de_flux" name="Ic.C3.B4nes_de_flux">Icônes de flux</h3> - -<p>Les flux RSS (ainsi que les autres) utilisent une icône spécifique. Il est recommandé de l'utiliser lorsque vous créez le lien spécial <code><a></code> vers votre flux. Cette icône ressemble à cela :</p> - -<dl> - <dd><img alt="Image:Feed-icon-32x32.png"></dd> -</dl> - -<p>Vous pouvez obtenir d'autres icônes de ce type sur le site <a class="external" href="http://feedicons.com/">Feed Icons</a>. Il existe différentes couleurs et tailles, et les fichiers sources sont disponibles également.</p> - -<h3 id="Techniques_de_syndication_avanc.C3.A9e" name="Techniques_de_syndication_avanc.C3.A9e">Techniques de syndication avancée</h3> - -<p>Bien que cette technique de syndication avancée ne soit pas nécessaire, son support est recommandé ; en particulier pour les sites Web et les applications avec de grande exigence de performance.</p> - -<p>Le protocole <a href="fr/HTTP">HTTP</a> -- l'une des technologies clef du Web -- fournit un moyen d'établir des priorités dans le type de contenu qu'un client HTTP préfère recevoir. Cette technique en tire avantage en faisant en sorte que le client <em>préfére</em> RSS (plutôt que HTML ou un autre format). Voici un exemple simple de ce qui peut être fait :</p> - -<pre class="eval">Accept: application/rss+xml, text/html -</pre> - -<p>Cependant, avec des logiciels de production, cela ressemblera plus à :</p> - -<pre class="eval">Accept: application/rss+xml, application/xhtml+xml, text/html -</pre> - -<p>Voici un exemple plus complet :</p> - -<pre class="eval">GET / HTTP/1.1 -Host: exemple.com -Accept: application/rss+xml, application/xhtml+xml, text/html -</pre> - -<p>Lorsqu'un serveur HTTP (ou un script côté serveur) reçoit ce code, il devrait rediriger le client HTTP vers le flux, en envoyant un code <code>HTTP 302 Found</code>. Ce qui donne quelque chose comme :</p> - -<pre class="eval">HTTP/1.1 302 Found -Location: <a class="external" href="http://example.com/feed" rel="freelink">http://example.com/feed</a> -</pre> - -<p></p><div class="prevnext" style="text-align: right;"> - <p><a href="/fr/docs/RSS:Premiers_pas:Hello_World" style="float: left;">« Précédent</a><a href="/fr/docs/RSS:Premiers_pas:Blogs">Suivant »</a></p> -</div><p></p> diff --git a/files/fr/archive/rss/version/index.html b/files/fr/archive/rss/version/index.html deleted file mode 100644 index 38cf40777d..0000000000 --- a/files/fr/archive/rss/version/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Version -slug: Archive/RSS/Version -tags: - - RSS -translation_of: Archive/RSS/Version ---- -<p> -</p> -<h2 id="Les_versions_de_RSS" name="Les_versions_de_RSS"> Les versions de RSS </h2> -<p>RSS a une histoire compliquée. Des personnes et des groupes différents ont créés chacun de leur côté des applications qu'ils ont appelés RSS. Certain RSS sont des formats basés sur <a href="fr/XML">XML</a>, et d'autres sur des formats <a href="fr/RDF">RDF</a>. -</p><p>La liste ci-dessous représente toutes les versions connues RSS. Elles sont listées par ordre chronologiques de leurs sorties. -</p> -<div class="note"> -<p><b>NOTE</b> : dans la liste ci-dessous, RSS 1.0 semble ne pas être à sa place. Cependant, il apparaît là selon l'ordre chronologique. -</p> -</div> -<div class="note"> -<p><b>NOTE</b> : il existe 3 versions différentes de <a href="fr/RSS/Version/0.91">RSS 0.91</a>, celle de Netscape (revision 1 et revision) et celle d'Userland. Pour être exact, le RSS 0.91 d'Userland est un sous-ensemble du RSS 0.91 de Netscape. -</p> -</div> -<div class="note"> -<p><b>NOTE</b> : RSS 0.93 et RSS 0.94 n'ont jamais été publiés qu'en tant que « brouillons » et ne sont jamais devenus « finaux ». Ils n'étaient donc pas censés être réellement utilisés. -</p> -</div> -<table class="standard-table"> <tbody><tr> <th>Nom</th> <th>Statut</th> <th>Date de publication</th> <th>Basé sur</th> <th>Auteur</th> </tr> <tr> <td><a href="fr/RSS/Version/0.90">RSS 0.90</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">Mars 1999</td> <td><a href="fr/RDF">RDF</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="fr/RSS/Version/0.91/Netscape/Revision_1">RSS 0.91 de Netscape (Revision 1)</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">?</td> <td><a href="fr/XML">XML</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="fr/RSS/Version/0.91/Netscape/Revision_3">RSS 0.91 Revision 3 de Netscape</a></td> <td><span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span></td> <td class="small">10 juillet 1999</td> <td><a href="fr/XML">XML</a></td> <td class="small">Netscape</td> </tr> <tr> <td><a href="fr/RSS/Version/0.91/Userland">RSS 0.91 d'Userland</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">4 juin 2000</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/1.0">RSS 1.0</a></td> <td>Standard</td> <td class="small">9 décembre 2000</td> <td><a href="fr/RDF">RDF</a></td> <td class="small">Groupe de travail RSS-DEV</td> </tr> <tr> <td><a href="fr/RSS/Version/0.92">RSS 0.92</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">25 décembre 2000</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/0.93">RSS 0.93</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">20 avril 2001</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/0.94">RSS 0.94</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">19 août 2002</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/2.0">RSS 2.0</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">Septembre 2002</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/2.0/2002-11-11">RSS 2.0 (post 2002-11-11)</a></td> <td><span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span></td> <td class="small">11 novembre 2002</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> <tr> <td><a href="fr/RSS/Version/2.0/2003-01-21">RSS 2.0 (post 2003-01-21)</a></td> <td>Standard</td> <td class="small">21 janvier 2003</td> <td><a href="fr/XML">XML</a></td> <td class="small">Userland</td> </tr> -</tbody></table> diff --git a/files/fr/archive/rss/éléments/index.html b/files/fr/archive/rss/éléments/index.html deleted file mode 100644 index a622270973..0000000000 --- a/files/fr/archive/rss/éléments/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Éléments -slug: Archive/RSS/Éléments -tags: - - RSS -translation_of: Archive/RSS_elements ---- -<p> </p> -<h2 id="Les_.C3.A9l.C3.A9ments_RSS" name="Les_.C3.A9l.C3.A9ments_RSS">Les éléments RSS</h2> -<h3 id="A" name="A">A</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/author"><author></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/author">Élément RSS Author</a>)</li> -</ul> -<h3 id="B" name="B">B</h3> -<h3 id="C" name="C">C</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/category"><category></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/category">Élément RSS Category</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/channel"><channel></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/channel">Élément RSS Channel</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/cloud"><cloud></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/cloud">Élément RSS Cloud</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/comments"><comments></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/comments">Élément RSS Comments</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/copyright"><copyright></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/copyright">Élément RSS Copyright</a>)</li> -</ul> -<h3 id="D" name="D">D</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/description"><description></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/description">Élément RSS Description</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/docs"><docs></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/docs">Élément RSS Docs</a>)</li> -</ul> -<h3 id="E" name="E">E</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/enclosure"><enclosure></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/enclosure">Élément RSS Enclosure</a>)</li> -</ul> -<h3 id="F" name="F">F</h3> -<h3 id="G" name="G">G</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/generator"><generator></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/generator">Élément RSS Generator</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/guid"><guid></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/guid">Élément RSS GUID</a>)</li> -</ul> -<h3 id="H" name="H">H</h3> -<h3 id="I" name="I">I</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/image"><image></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/image">Élément RSS Image</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/item"><item></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/item">Élément RSS Item</a>)</li> -</ul> -<h3 id="J" name="J">J</h3> -<h3 id="K" name="K">K</h3> -<h3 id="L" name="L">L</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/language"><language></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/language">Élément RSS Language</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/link"><link></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/link">Élément RSS Link</a>)</li> -</ul> -<h3 id="M" name="M">M</h3> -<h3 id="N" name="N">N</h3> -<h3 id="O" name="O">O</h3> -<h3 id="P" name="P">P</h3> -<h3 id="Q" name="Q">Q</h3> -<h3 id="R" name="R">R</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/rating"><rating></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/rating">Élément RSS Rating</a>)</li> -</ul> -<h3 id="S" name="S">S</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/source"><source></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/source">Élément RSS Source</a>)</li> -</ul> -<h3 id="T" name="T">T</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/textinput"><textinput></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/textinput">RSS Text Input Element</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/title"><title></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/title">Élément RSS Title</a>)</li> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/ttl"><ttl></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/ttl">Élément RSS TTL</a>)</li> -</ul> -<h3 id="U" name="U">U</h3> -<ul> - <li><a href="fr/RSS/%c3%89l%c3%a9ments/url"><url></a> (<a href="fr/RSS/%c3%89l%c3%a9ments/url">Élément RSS URL</a>)</li> -</ul> -<h3 id="V" name="V">V</h3> -<h3 id="W" name="W">W</h3> -<h3 id="X" name="X">X</h3> -<h3 id="Y" name="Y">Y</h3> -<h3 id="Z" name="Z">Z</h3> -<p><span class="comment">Catégories</span></p> -<p></p> diff --git a/files/fr/archive/security/index.html b/files/fr/archive/security/index.html deleted file mode 100644 index 02db228352..0000000000 --- a/files/fr/archive/security/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Security -slug: Archive/Security -tags: - - TopicStub -translation_of: Archive/Security ---- -<p><strong><span class="seoSummary">Il est fortement déconseillé de se fier à ces articles de sécurité obsolètes. Cela pourrait mettre vos systèmes en danger.</span></strong></p> - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/fr/docs/Introduction_%C3%A0_la_cryptographie_%C3%A0_clef_publique">Introduction à la cryptographie à clef publique</a></dt> - <dd class="landingPageList">La cryptographie à clef publique ainsi que les standards et les techniques qui s'y rapportent sont à la base des dispositifs de sécurité de nombreux produits Red Hat. Cela comprend : la signature et le chiffrement de messages électroniques, la signature de formulaire, la signature d'objet, les ouvertures de session unique et le protocole SSL (Secure Sockets Layer). Ce document est une introduction aux concepts de base de la cryptographie à clef publique.</dd> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="/fr/docs/Introduction_%C3%A0_SSL">Introduction à SSL</a></dt> - <dd class="landingPageList">Ce document est une introduction au protocole<em>Secure Sockets Layer</em> (SSL). SSL a été universellement adopté sur le<em>World Wide Web</em> pour authentifier et chiffrer les communications entre clients et serveurs.</dd> -</dl> -</div> -</div> diff --git a/files/fr/archive/standards_du_web/choisir_de_se_conformer_aux_standards_plutôt_qu_aux_pratiques_propriétaires/index.html b/files/fr/archive/standards_du_web/choisir_de_se_conformer_aux_standards_plutôt_qu_aux_pratiques_propriétaires/index.html deleted file mode 100644 index 3f2ad0a34e..0000000000 --- a/files/fr/archive/standards_du_web/choisir_de_se_conformer_aux_standards_plutôt_qu_aux_pratiques_propriétaires/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Choisir les standards plutôt que les pratiques propriétaires -slug: >- - Archive/Standards_du_Web/Choisir_de_se_conformer_aux_standards_plutôt_qu_aux_pratiques_propriétaires -tags: - - Standards_du_Web -translation_of: Archive/Web_Standards/Choosing_Standards_Compliance_Over_Proprietary_Practices ---- -<h3 id="Introduction">Introduction</h3> - -<p>There are a number of standards, procedures, and processes that an organization can use. At the high level, there are two primary types of standards: procedural (how do we do it) versus technical (what do we follow). Organizations implement internal procedural standards so they are able to operate efficiently. They may also incorporate external procedural and/or technical standards. Technical standards have traditionally been pioneered through consortiums or standards bodies. The technical standards can be either public, standards-based or a proprietary de facto standard. The purpose of this document is to discuss and emphasize the importance of conforming to open technology standards that are external to the organization. Let’s begin the discussion, however, by looking inward to internal procedures, processes and standards.</p> - -<p>Why should organizations have standard procedures at every level? Following standards is certainly not a new organizational phenomenon; organizations require their employees to follow common rules, or a common set of standards all the time. Memos, time cards, and accounting procedures are all standardized across groups.</p> - -<p>In the development world, there is a need for standards because applications are designed across multiple development groups. Many organizations publish internal development standards and practices. For example, an organization may decide that C++, Java, and JavaScript will be the primary coding languages. They may require that each project be comprised of Marketing Requirements Documents, Product Requirements Documents, Functional Requirements Documents, Quality Assurance Test Plans, and Certification Documents.</p> - -<p>As organizations mature, they discover that they need more processes to give them greater control, which allows them to more easily plan and predict. With processes, organizations can make release schedules, implement marketing plans, analyze resource allocations, and make adjustments when needed. Adherence to standards and processes can actually provide a level of flexibility because development does become predictable. In addition to predictability, standard processes improve understanding and streamline costs.</p> - -<h3 id="Un_processus_de_développement_commun">Un processus de développement commun</h3> - -<p>As an organization matures, managers and engineers develop a fundamental understanding of the importance of requiring adherence to these processes. When projects are proposed, they are evaluated to ensure compatibility with the overall business strategy. Product marketing must then analyze the marketability of the application/product, and then conduct in-depth technical evaluations and market research studies. If the project is accepted, the compiled information, analysis and research is merged into a Request for Proposal (RFP).</p> - -<p>This process is not unique: most organizations have basic project management processes for product or service. Even within organizations, their processes are fine-tuned to work within the existing culture. When this happens, a development standard is created and is expected to be followed.</p> - -<p>It is easy to get caught up in the process and forget why organizations have these processes in place. Bottom line, organizations have them because they save money, time, and resources. Sure, there are other reasons -– accountability, checkpoints, and scheduling, for example. The end result, however, is having a process in place that maximizes the organization's investment.</p> - -<h3 id="Autres_standards">Autres standards</h3> - -<p>It is also important to follow other types of standards across an organization. There are numerous standards organizations that affect how and why we do what we do. For example, in the accounting arena there is FASB (Financial Accounting Standards Board) and IASB (International Accounting Standards Board). All businesses are expected and required to follow the guidelines set forth by the FASB. When auditors evaluate an organizations financial health, they do so by following the FASB rules.</p> - -<p>Focusing on the software development portion of an organization, there are numerous standards bodies that can affect development decisions. For example, if an organization is developing a web-based client, they may have to adhere to standards imposed by these organizations:</p> - -<ul> - <li>ANSI (<em><a class="external" href="http://www.ansi.org/">American National Standards Institute</a></em>),</li> - <li>ATSC (<em><a class="external" href="http://www.atsc.org/">Advanced Television Systems Committee</a></em>),</li> - <li>ECMA (<em><a class="external" href="http://www.ecma-international.org/">European Computer Manufacturers Association</a>: Standardizing Information and Communication Systems</em>),</li> - <li>IEEE (<em><a class="external" href="http://www.ieee.org/">Institute of Electrical and Electronics Engineers</a></em>),</li> - <li>IETF (<em><a class="external" href="http://www.ietf.org/">Internet Engineering Task Force</a></em>),</li> - <li>IRTF (<em><a class="external" href="http://www.irtf.org/">Internet Research Task Force</a></em>),</li> - <li>ISO (<em><a class="external" href="http://www.iso.org/">International Standards Organization</a></em>),</li> - <li>ITU (<em><a class="external" href="http://www.itu.org/">International Telecommunication Union</a></em>),</li> - <li>OASIS (<em><a class="external" href="http://www.oasis-open.org">Organization for the Advancement of Structured Information Standards</a></em>),</li> - <li>OMA (<em><a class="external" href="http://www.openmobilealliance.org/">Open Mobile Alliance</a></em> (formally WAP)),</li> - <li>UNI (<em><a class="external" href="http://www.unicode.org/">Unicode Consortium</a></em>), and</li> - <li>W3C (<em><a class="external" href="http://www.w3.org/">World Wide Web Consortium</a></em>),</li> -</ul> - -<p>Like the processes and standards that accountants and project managers must follow, the above-mentioned standards organizations provide focus and direction for the development engineering community. By following the guidelines that have been put into place, organizations like AOL can enhance user experience, interoperability, code reuse, shared resources, and goodwill while reducing costs. I will discuss each of these items in the following paragraphs.</p> - -<div dir="ltr"> -<h2 id="Interopérabilité">Interopérabilité</h2> -</div> - -<p>The key to interoperability is settling on a standard that has a potential for long-term use. An organization must have the assurance that the standard they choose to incorporate into their development process will be relevant in the future. In other words, there must be long-term potential. A fundamental mistake that many organizations make is to use proprietary methods, software, code, or standards. Following a proprietary path has led many organizations down disastrous paths.</p> - -<p>Case in point: Xerox Corporation. Xerox was clearly ahead of their time in the early 1980’s when they designed and developed the Star Office System. It was an elegant workstation with an iconic desktop developed by the engineers at PARC (Palo Alto Research Center). The Star Office System offered functionality that neither Microsoft nor Apple has been able to match with their current offerings.</p> - -<p>The engineers developed Star on a proprietary development operating system known as Pilot. Pilot had a highly-integrated debugging tool called Co-pilot that allowed the Xerox development organization to quickly and easily debug issues. However, what Xerox neglected to understand was that regardless of how powerful Pilot and Co-pilot was, the Star Workstation could not evolve with the times because it was proprietary. Xerox was bound to a unique hardware platform and to a closed development operating system. And Xerox chose to bypass multiple opportunities to port the code to other platforms, and to provide open-source code. Consequently, Xerox eventually had to shut down the production of their workstation development because of escalating manufacturing and developing costs and slowed sales.</p> - -<p>Xerox’s biggest asset in the beginning became its weapon of destruction. They settled on a proprietary environment, and missed the opportunity to make their environment the benchmark – and set the standard.</p> - -<p>Following open standards has an added benefit. When it is necessary for an organization to interact with other applications through alliances, merger, or acquisition, the integration and interoperability is much less costly if all parties involved follow the standards from the outset. Consistent standards significantly reduce development re-work, and ensure consistent and predictable behavior from one application to the next.</p> - -<h3 id="Expérience_utilisateur_et_bonne_volonté">Expérience utilisateur et bonne volonté</h3> - -<p>Customer retention and market expansion is critical. When customers choose to use a particular product, they must have a positive experience with consistent, reliable, and predictable behavior. As users become more sophisticated, and as additional devices become more affordable, they will be accessing the same information across a variety of devices – and expect them to look and act the same – regardless of whether they are accessing a web site from their desktop, phone, or handheld. Consequently, if an organization offers a suite of products they must ensure that the user experience is consistent and predictable across the product line.</p> - -<h4 id="Cohérence">Cohérence</h4> - -<p>To be successful, organizations need to understand this user expectation and provide a consistent experience across their product offerings. When usability alters too much across products, users complain.</p> - -<p>Apple and Microsoft have learned this lesson well. When a Macintosh user shifted from Mac OS 8.x to Mac OS 9.x, the interface and desktop metaphor was virtually unchanged. Users could quickly and easily shift from one version to the next. However, when Mac OS X was released, Apple completely revamped the interface and desktop metaphor. That change caused quite a rumble through the Apple user community. It changed just enough to make it awkward, but not enough to where the user could not adjust. Apple received both good and bad press; and they lost some users and won some others over.</p> - -<p>An example of how consistent user experience wins user loyalty can be seen in how Microsoft ensures common behavior across applications. For example, in Word, Excel, and other Windows applications, we know that pressing <code>CTL</code>+<code>C</code> within any Microsoft product means copy. The behavior is consistent and predictable and has subsequently become the de-facto standard. The reason it is consistent and predictable is because Microsoft has established a corporate set of usability standards and supports the relevant international standards.</p> - -<h4 id="Accessibilité">Accessibilité</h4> - -<p>No organization can afford to overlook or ignore accessibility standards. Within the web environment, the accessibility standards are closely tied to HTML, XML, XHTML, and other W3C standards. By integrating and supporting the accessibility guidelines, an organization can offer their product lines or services to a larger and more diverse user base.</p> - -<h4 id="Interchangeabilité">Interchangeabilité</h4> - -<p>If a user experiences consistent behavior across a range of products, they can predict how a particular action or function will work or respond. As a product provider, the goal should be the element of least surprise. By instilling a set of global goals and standards into an organizational infrastructure, an organization is ensuring its end users the ability to interact, function, view, and process information consistently as they transition from one device to the next.</p> - -<p>A significant drawback in allowing divergence across applications is that information must be replicated, altered, or massaged to be processed across the divergent applications. This also creates issues in regard to authoring tools for these various applications. For example, let us say we have multiple application offerings that can be used to browse the web. Each of these applications has followed their own development and support standards. They each may support some or part of the international standards, but not fully. What authoring tool should we use? Would it be fiscally prudent to develop proprietary authoring tools for each application? What would the market adoption rate be for the suite of applications in this case? How can an organization consistently win market share if their product offerings are not integrated? More importantly, what if the user perception is that their products are not interchangeable?</p> - -<h3 id="Ressources_Partagées">Ressources Partagées</h3> - -<p>When an organization instills a corporate-wide policy of shared standards, they can leverage engineering resources across multiple projects. The development engineers can shift more readily between projects with little to no downtime. Coding practices are consistent. Expectations are known. There is equivalent functionality across applications offered by the organization. And, the engineers have a broader base of experience, making them more valuable within the organization.</p> - -<p>For example, if web-based applications are expected to be W3C compliant, each engineer would be expected to know and understand the W3C standards. Development efforts would consequently support similar levels of standards support, which could possibly lead to cross-application coding, or code reuse.</p> - -<p>For example, if a development engineer writes an application following the ANSI standard of C and C++, and writes that code on a particular platform, that code can be compiled on any other platform and operating system that supports ANSI standards. Microsoft products are difficult to export because they introduced MFC (Microsoft Foundation Classes), which is a Windows-only standard that does not follow the ANSI standard.</p> - -<h3 id="Assurance_de_la_qualité">Assurance de la qualité</h3> - -<p>We know from experience that without rigorous testing, our products can fail miserably when we introduce them into the market. Technical support is costly not only in regard to support staff costs, but also in respect to customer dissatisfaction.</p> - -<p>That is why organizations also need to apply standards to quality testing. By adopting a set of standards, the QA organization can produce a set of test suites that they can use across multiple projects. By having a standardized set of test suites, the QA organization can easily maintain, verify, and certify the tests, and eliminate redundant testing databases to ensure consistency and reliability. Like the engineers, standardization also helps the QA engineers become highly proficient and capable of shifting from project to project.</p> - -<h3 id="Résumé">Résumé</h3> - -<p>As organizations expand product development across multiple devices and product families, integration and compatibility must be a key requirement. Adhering to a set of future-focused International standards will make cross-functional integration possible. Adopting standards will not only help an organizations end users enjoy a cross application experience; organizations will help themselves by giving development and quality assurance engineers the tools to become better equipped and flexible. Lastly, by following a series of standards, organizations can more easily measure progress, performance, and results across the organization.</p> - -<p>The most compelling dilemma is how an organization chooses to follow open external standards versus a proprietary de facto standard. Following proprietary de facto standards leaves an organization vulnerable and open to obsolescence when the owner of the de facto changes focus or direction, or abandons the de facto altogether and renders the standard stagnate. On the other hand, by adopting open technology standards and participating in the development and direction of those standards, an organization is providing a path for future development, growth and revenue.</p> diff --git a/files/fr/archive/standards_du_web/communauté/index.html b/files/fr/archive/standards_du_web/communauté/index.html deleted file mode 100644 index 27a26f6bbc..0000000000 --- a/files/fr/archive/standards_du_web/communauté/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Communauté -slug: Archive/Standards_du_Web/Communauté -tags: - - Standards_du_Web -translation_of: Archive/Web_Standards/Community ---- -<p> -Quelques liens sur la communauté francophone des standards du Web. -</p> -<h3 id="Sites_majeurs" name="Sites_majeurs"> Sites majeurs </h3> -<ul><li> <a class="external" href="http://openweb.eu.org/">L'Openweb Group pour les standards du Web</a> -</li><li> <a class="external" href="http://pompage.net/">Pompage.net : le web design puisé à la source</a> -</li><li> <a class="external" href="http://www.opquast.com/">Opquast - Bonnes pratiques qualité pour les services en ligne</a> -</li><li> <a class="external" href="http://www.alsacreations.com">Alsacréations - formations HTML / CSS et conception Web</a> -</li><li> <a class="external" href="http://www.webonorme.net">WebonOrme - Annuaire de ressources sur les standards du web</a> -</li></ul> -<h3 id="Autres_ressources" name="Autres_ressources"> Autres ressources </h3> -<h4 id="Forums" name="Forums"> Forums </h4> -<ul><li> <a class="external" href="http://forums.alsacreations.com/">Forums CSS et standards W3C d'Alsacréations</a> -</li><li> <a class="external" href="http://www.webmaster-hub.com/index.php?showforum=89">Webmater Hub - Création et exploitation de Sites Internet</a> -</li></ul> -<h4 id="Listes_de_diffusion" name="Listes_de_diffusion"> Listes de diffusion </h4> -<ul><li> <a class="external" href="http://pompage.net/liste/">La liste des pompeurs</a> -</li></ul> -<h4 id="Blogs" name="Blogs"> Blogs </h4> -<ul><li> <a class="external" href="http://standblog.org">Le StandBlog de Tristan Nitot</a> -</li><li> <a class="external" href="http://blog.alsacreations.com">Le blog d'Alsacréations</a> -</li><li> <a class="external" href="http://www.blog-and-blues.org/">Blog et articles sur les standards, de Laurent Denis</a> -</li></ul> diff --git a/files/fr/archive/standards_du_web/index.html b/files/fr/archive/standards_du_web/index.html deleted file mode 100644 index 87eedc9111..0000000000 --- a/files/fr/archive/standards_du_web/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Standards du Web -slug: Archive/Standards_du_Web -tags: - - Standards_du_Web -translation_of: Archive/Web_Standards ---- -<div>En produisant des <strong>sites Web conformes aux standards</strong> du W3C, on s'assure qu'ils vont fonctionner quel que soit le navigateur. […] Parce qu'Internet tient une place importante dans nos vies, et qu'il est bien parti pour occuper plus de place encore dans le futur, il appartient à chaque auteur de site web de s'assurer que les pages qui sont produites sont utilisables par tous les navigateurs récents, quels que soient le matériel utilisé, et le handicap éventuel de l'utilisateur. Bien sûr, il est impossible de tester son site sur toutes les plateformes possibles. Mais en produisant du code valide (c'est-à-dire respectant les standards du W3C et validé par les outils HTML et CSS), il est possible de s'assurer que le contenu du site s'affichera aussi bien que possible dans une très grande majorité des plate-formes, préservant ainsi la diversité des navigateurs, du matériel et des individus.</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation"><a href="/Special:Tags?tag=Standards_du_Web&language=fr" title="Special:Tags?tag=Standards_du_Web&language=fr">Documentation</a></h4> - - <dl> - <dt><a href="/fr/Migration_d'applications_d'Internet_Explorer_vers_Mozilla" title="fr/Migration_d'applications_d'Internet_Explorer_vers_Mozilla">Migration d'applications d'Internet Explorer vers Mozilla</a></dt> - <dd><small>Tout le monde a déjà été confronté à des difficultés pour faire fonctionner des applications Web spécifiques à Internet Explorer sous Mozilla. Cet article traite des problèmes classiques avec la migration d'applications vers un navigateur libre basé sur Mozilla.</small></dd> - </dl> - - <dl> - <dt><a class="external" href="http://www.mozilla.org/docs/web-developer/upgrade_2.html">Using Web Standards in your Web Pages</a></dt> - <dd><small>Cet article propose un aperçu du processus de mise à jour du contenu d'un site pour le rendre conforme aux standards Web du W3C.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Préférer_le_respect_des_standards_aux_solutions_propriétaires" title="fr/Préférer_le_respect_des_standards_aux_solutions_propriétaires">Préférer le respect des standards aux solutions propriétaires</a></dt> - <dd><small>(à traduire de <a href="/en/Choosing_Standards_Compliance_Over_Proprietary_Practices">en:Choosing Standards Compliance Over Proprietary Practices</a>)</small></dd> - <dd>Dans le monde du développement, il y a un besoin de standards parce que les applications doivent fonctionner sur de multiples groupes de développement.</dd> - </dl> - - <dl> - <dt><a href="/fr/Le_modèle_économique_des_standards_Web" title="fr/Le_modèle_économique_des_standards_Web">Le modèle économique des standards Web</a></dt> - <dd><small>Cet article explique comment l'adhésion aux standards Web et l'abandon des formats et technologies propriétaires peuvent contribuer aux bénéfices d'une entreprise.</small></dd> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=Standards_du_Web&language=fr" title="Special:Tags?tag=Standards_du_Web&language=fr">Tous les articles…</a></span></p> - </td> - <td> - <h4 id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p></p><ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-web-development"> Liste de diffusion</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.web-development"> newsgroup</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.web-development/feeds"> Flux de syndication</a></li> -</ul><p></p> - - <ul> - <li><a class="external" href="http://openweb.eu.org/">OpenWeb</a> — pour les standards du Web</li> - <li><a class="external" href="http://webstandards.org/">Le Web Standards Project</a></li> - <li><a class="external" href="http://webdevfeedhouse.com/">WebDev FeedHouse</a></li> - <li><a href="/fr/Standards_du_Web/Communauté" title="fr/Standards_du_Web/Communauté">Autres liens sur la communauté…</a></li> - </ul> - - <h4 id="Outils" name="Outils">Outils</h4> - - <ul> - <li><a class="link-https" href="https://addons.mozilla.org/fr/firefox/addon/1843">L'extension Firebug</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/fr/firefox/addon/60">L'extension Web Developer</a></li> - <li><a class="external" href="http://validator.w3.org/">Service de validation du balisage (W3C)</a></li> - <li><a class="external" href="http://jigsaw.w3.org/css-validator/">Service de validation CSS (W3C)</a></li> - </ul> - - <p><span class="alllinks"><a href="/Special:Tags?tag=Standards_du_Web:Outils&language=fr" title="Special:Tags?tag=Standards_du_Web:Outils&language=fr">Tous les outils…</a></span></p> - - <h4 id="Exemples" name="Exemples">Exemples</h4> - - <ul> - <li><a class="external" href="http://www.mozilla.org/start/1.0/demos.html">Démos de Mozilla 1.0</a> — montre ce qui peut être fait avec les standards du Web.</li> - <li><a class="external" href="http://www.mozilla.org/newlayout/demo/">Démos Gecko</a></li> - <li><a class="external" href="http://www.csszengarden.com/">css Zen Garden</a></li> - <li><a class="external" href="http://www.meyerweb.com/eric/css/edge/">css/edge par Eric Meyer</a></li> - <li><a class="external" href="http://dmoz.org/Computers/Programming/Languages/JavaScript/W3C_DOM/Demos/">Démos du DOM W3C</a></li> - </ul> - - <h4 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/CSS" title="fr/CSS">CSS</a>, <a href="/fr/DHTML" title="fr/DHTML">DHTML</a>, <a href="/fr/HTML" title="fr/HTML">HTML</a>, <a href="/fr/Développement_Web" title="fr/Développement_Web">Développement Web</a>, <a href="/fr/XHTML" title="fr/XHTML">XHTML</a>, <a href="/fr/XML" title="fr/XML">XML</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<hr> diff --git a/files/fr/archive/standards_du_web/le_modèle_économique_des_standards_web/index.html b/files/fr/archive/standards_du_web/le_modèle_économique_des_standards_web/index.html deleted file mode 100644 index eaadc83364..0000000000 --- a/files/fr/archive/standards_du_web/le_modèle_économique_des_standards_web/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: Le modèle économique des standards Web -slug: Archive/Standards_du_Web/Le_modèle_économique_des_standards_Web -tags: - - Développement_Web - - Standards_du_Web -translation_of: Archive/Web_Standards/The_Business_Benefits_of_Web_Standards ---- -<h2 id="Introduction_et_contexte" name="Introduction_et_contexte">Introduction et contexte</h2> - -<p>« Faire plus avec moins » semble être une mission impossible pour nos concepteurs Web : s'adresser à toujours plus de clients et à un public toujours plus large, avoir plus de diversité en termes de navigateurs, plus d'accessibilité, répondre aux attentes d'utilisateurs qui demandent plus de rapidité, tout en dépensant moins dans le maintien ou le réaménagement d'un site Web… Dans cette situation délicate, les concepteurs Web sont confrontés à un challenge incroyable. Pourtant, ils sont en train de trouver un allié insoupçonné dans la bataille : <a href="fr/Standards_du_Web">les standards du Web</a>.</p> - -<p>Cet article explique comment le fait d'adhérer à des standards Web (c.-à-d. à des normes), et de laisser tomber le balisage et les technologies propriétaires, peut contribuer à atteindre les objectifs d'affaires d'une société.</p> - -<h2 id="Coh.C3.A9rence_de_l.27apparence_et_du_sens_sur_l.27ensemble_du_site" name="Coh.C3.A9rence_de_l.27apparence_et_du_sens_sur_l.27ensemble_du_site">Cohérence de l'apparence et du sens sur l'ensemble du site</h2> - -<p>En séparant la structure (ou contenu) de la présentation, les concepteurs Web ont beaucoup a gagner. En particulier, la présentation est définie par l'emploi d'un langage orienté vers la mise en page <a href="fr/CSS">CSS</a>. Ranger CSS dans un document à part (c.-à-d. la feuille de style) et l'appliquer à une série de documents <a href="fr/HTML">HTML</a> permet de changer la présentation de tous ces documents en un clin d'œil. Le HTML strict (contrairement au balisage HTML transitoire fréquemment utilisé), oblige le concepteur à ne pas utiliser des balises de présentation dans les documents HTML, renforçant ainsi naturellement la séparation entre contenu et présentation.</p> - -<p>En réunissant toutes les questions de style et de design dans un seul document — la feuille de style — des sites entiers peuvent changer instantanément de thème. La communauté des blogs est particulièrement dynamique à cet égard, et dans beaucoup de plateformes dont WordPress, TextPattern et Habari, le thème du site est une entité complète et discrète, dans son propre droit.</p> - -<h2 id="Am.C3.A9lioration_de_l.27exp.C3.A9rience_utilisateur.C2.A0:_moins_de_bande_passante_et_des_chargements_plus_rapides" name="Am.C3.A9lioration_de_l.27exp.C3.A9rience_utilisateur.C2.A0:_moins_de_bande_passante_et_des_chargements_plus_rapides">Amélioration de l'expérience utilisateur : moins de bande passante et des chargements plus rapides</h2> - -<p>Le code HTML est souvent beaucoup plus compact (et donc plus facile à lire et à maintenir) lorsqu'il est utilisé conjointement à CSS. Selon divers reports, études de cas, et <a class="external" href="http://webword.com/interviews/king.html">Andy King</a>, auteur de <a class="external" href="http://www.websiteoptimization.com/speed/5/">Accélérez votre site Web : optimisation de sites Web</a>, CSS a rendu possible la transformation des mises en page de type tableaux en mises en page de type CSS. Habituellement, cela réduit de 25 à 50% la taille de la page. Ceci se traduit par une amélioration de l'expérience utilisateur, <a class="external" href="http://www.useit.com/papers/responsetime.html">selon le gourou de l'ergonomie/Utilisabilité Jakob Nielsen</a>, qui remarque que les utilisateurs ont tendance à fermer une page Web quand elle prend plus de 10 secondes à se charger.</p> - -<p>La feuille de style n'a besoin de se charger qu'une seule fois pour être sauvegardée en mémoire cache. Le poids du chargement peut être légèrement supérieur pour la première page. Mais pour l'accès à plusieurs pages d'un même site, étalé sur plusieurs visites, les économies en bandes passantes sont énormes.</p> - -<h2 id="Am.C3.A9liorer_les_SERPS_.28r.C3.A9sultats_de_recherche_sur_les_moteurs.29_organiques_sans_d.C3.A9penser_d.27argent" name="Am.C3.A9liorer_les_SERPS_.28r.C3.A9sultats_de_recherche_sur_les_moteurs.29_organiques_sans_d.C3.A9penser_d.27argent">Améliorer les SERPS (résultats de recherche sur les moteurs) organiques sans dépenser d'argent</h2> - -<p>L'une des plus grandes difficultés pour nos webmestres est d'avoir un bon classement dans les moteurs de recherche. Pour atteindre cet objectif, tout doit entrer en compte. Grâce à l'utilisation d'un balisage sémantique, nous aidons énormément les moteurs de recherche dans leur processus d'indexation. Ces idées viennent tout naturellement aux développeurs qui utilisent les standards, sans aucun effort, temps, ni pensée supplémentaires. Tous leurs documents sont correctement signalés dès le départ. Le nombre de sites ne fournissant pas de titres ni de descriptions appropriés dans les balises Méta est surprenant. Beaucoup d'autres sites augmenteraient énormément leur <abbr title="Search Engine Optimization : optimisation pour les moteurs de recherche">SEO</abbr> simplement s'ils utilisaient des balises appropriées au contenu. Rajouter des balises h1, h2, h3, et ainsi de suite, apporte une bonne structure aux documents hypertextes.</p> - -<p>Les agents des moteurs de recherche sillonnent le Web pour l'indexer, mais pour les besoins de classement ou d'indexation ils ne peuvent traiter que le texte. Les effets dynamiques, tels que ceux créés par <a href="fr/JavaScript">JavaScript</a> ne sont pas pris en compte, et un texte contenant des graphiques ne peut pas être lu ni analysé non plus. Le fait de séparer la présentation du contenu permet d'augmenter le taux d'information/balisage, rendant ainsi les documents de type CSS plus pertinents en ce qui concerne les termes de recherche, ce qui leur permet d'être classés plus haut dans les résultats de recherche. De la même manière, l'utilisation de CSS à la place de graphiques pour réaliser des titres peut être d'une grande aide.</p> - -<p>Il existe des différences significatives dans la manière dont opèrent les moteurs de recherche. Au lieu de se préoccuper de chaque moteur de recherche, et d'essayer de manipuler artificiellement les résultats, les pages utilisant les standards Web sont indexées et classées correctement (là où elles le méritent) à travers tous les moteurs de recherche. Non seulement les standards réduisent énormément nos soucis envers les différences de navigateurs, mais ils réduisent aussi les différences dans la manière dont les moteurs de recherche classent les pages.</p> - -<p>En utilisant correctement les standards du web, il ne devrait pas ou plus être nécessaire d'avoir recours à des campagnes propriétaires de paiement par clic, dont les coûts augmentent sans cesse et dont la qualité et l'intégrité laissent parfois à désirer.</p> - -<h2 id="Augmenter_le_trafic_des_sites_Web" name="Augmenter_le_trafic_des_sites_Web">Augmenter le trafic des sites Web</h2> - -<h2 id="Maintenir_le_contact_avec_votre_utilisateur_sur_des_plateformes_multiples" name="Maintenir_le_contact_avec_votre_utilisateur_sur_des_plateformes_multiples">Maintenir le contact avec votre utilisateur sur des plateformes multiples</h2> - -<p>Les codes respectant les standards et fonctionnant sur diverses plateformes vont main dans la main. Alors que certains navigateurs ont des bizarreries qui provoquent des comportements différents selon la plateforme, <a class="external" href="http://www.mozilla.org/university/HOF.html">les navigateurs de Mozilla</a> sont conçus pour se comporter de manière identique sur toutes les plateformes supportées (Mac, Linux, Unix, Windows…)</p> - -<p>Un nombre croissant d'agents utilisateur autres que des navigateurs, ou alors des navigateurs sur des plateformes différentes —nbsp;comme les téléphones mobiles — ont accès au contenu du Web. Les contenus de données tels que RSS et Atom ne marcheront tout simplement pas sans avoir été préalablement implantés en suivant les standards requis.</p> - -<p>Les suppositions émises à propos des utilisateurs et de leur plateforme, basées sur une réflexion erronée à propos de la communauté d'utilisateurs, sont inévitablement toujours fausses. Par exemple, il n'est pas obligatoire que les hommes d'affaires possèdent un moniteur à écran large. Le contraire peut aussi être vrai. Les « usagers puissants » (Power users) et les hommes d'affaires qui voyagent beaucoup sont en train de réduire leurs portables. Il arrive de plus en plus souvent qu'une seule personne ait peut-être besoin d'accéder au même site en utilisant des plateformes différentes à la maison, au bureau ou lors de déplacements. Ils s'attendent à une expérience constante et cohérente.</p> - -<p>Afin de gérer ces paradoxes, les standards Web nous fournissent différents outils et procédés, et nous permettent une contribution encore plus forte : la diffusion universelle de nos données est accessible aux personnes de différentes circonstances sociales, médicales ou économiques.</p> - -<h2 id="Un_personnel_plus_heureux" name="Un_personnel_plus_heureux">Un personnel plus heureux</h2> - -<p>Les bons développeurs — provenant des agences, mais aussi des stagiaires — ne veulent simplement pas travailler en utilisant des méthodes dépassées ou des plateformes aux normes incertaines, suite à l'incertitude conséquente sur la qualité. Ils ont adopté les standards Web il y a bien longtemps, et travaillent à présent là où ces nouvelles compétences sont appréciées. La connaissance de Dreamweaver ou de n'importe quel autre logiciel ancien n'entre absolument pas en compte dans le recrutement d'un personnel créatif.</p> - -<h2 id=".C3.89liminer_les_d.C3.A9penses_futures_ind.C3.A9sirables" name=".C3.89liminer_les_d.C3.A9penses_futures_ind.C3.A9sirables">Éliminer les dépenses futures indésirables</h2> - -<p>Une portion très significative de l'information stockée électroniquement est produite pour le Web et écrite en format HTML. La plupart de ces informations utilisent de l'HTML erroné, qui s'affiche (pour l'instant) correctement dans des navigateurs plus anciens et permissifs. Au cours de l'évolution du Web, les navigateurs Web risquent soit de devenir moins permissifs, soit de se comporter différemment lorsque des balises erronées lui seront données (p. ex. ils risquent d'analyser les données erronées et de les rendre légèrement différentes). En utilisant un balisage valide et conforme aux normes, les données seront réutilisables pendant longtemps. En effet, les prérequis pour une analyse des formats standards sont fixes et bien documentés.</p> - -<p>Contrairement aux croyances populaires, passer aux codes standards ne signifie pas que l'on produit un contenu moins attractif. D'ailleurs, tout ce qui exploite des extensions propriétaires peut être adapté aux normes, avec l'avantage supplémentaire d'être multiplateforme et à l'épreuve du temps.</p> - -<p>En s'assurant que toutes les données numériques de l'opérateur soit signalées de manière constante et conforme aux normes, la base de données devient un atout réutilisable et perpétuel — et sans aucune dépense supplémentaire future.</p> - -<h2 id="Extensibilit.C3.A9" name="Extensibilit.C3.A9">Extensibilité</h2> - -<p>L'utilisation du HTML strict et la séparation entre structure et contenu fraient la voie au <a href="fr/XHTML">XHTML</a>, une version de HTML compatible avec <a href="fr/XML">XML</a>. L'utilisation du XHTML permettra aux auteurs du Web de multiplier les outils provenant du monde XML, tel que <a href="fr/XSLT">XSLT</a>, afin de facilement manipuler les données XML.</p> - -<p>L'utilisation du XHTML est une manière d'entrer dans une série de standards composés par des technologies XML, tels que XML, XSLT (transformation des données), <a href="fr/SVG">SVG</a> (graphiques animés), <a href="fr/MathML">MathML</a> (décrire des expressions mathématiques)… De telles technologies ont été conçues pour interfonctionner, et sont la base-même des services Web. Cela va donc beaucoup plus loin que de la simple création de contenu pour le Web.</p> - -<h2 id="R.C3.A9duire_le_co.C3.BBt_d.27op.C3.A9rations_et_de_maintenance_de_site" name="R.C3.A9duire_le_co.C3.BBt_d.27op.C3.A9rations_et_de_maintenance_de_site">Réduire le coût d'opérations et de maintenance de site</h2> - -<p>Mais au fait, qu'est-ce réellement que la maintenance ? Une des caractéristiques principales d'un site réussi est d'élaborer constamment un contenu approprié, qui puisse à son tour alimenter le dialogue médiatique social avec la communauté d'utilisateurs. Il est donc nécessaire de créer une structure et un procédé à suivre, afin de permettre aux contributeurs qui travaillent sur le contenu de publier des articles, de récupérer des vidéos, du son, ou n'importe quel autre média. Un site Web n'est qu'un support qui permet d'insérer, de déplacer, et d'afficher ce contenu. Les systèmes de gestion de contenu tentent avec un relatif succès d'alimenter ce niveau de fonctionnalité. Ce sont de très bons exemples d'une véritable séparation non seulement du style et du contenu, mais aussi du procédé par lequel ces éléments — qui sont très différents — sont exécutés.</p> - -<p>Le procédé doit donc se dérouler en trois étapes : la création du contenu, l'application du balisage, et l'ajout du style. Vu sous cet angle, il est parfois surprenant de constater à quel point le procédé de développement Web est en fait propre, élégant et simple. Dans un environnement multi-dirigé et potentiellement commercial, tel qu'une agence de développement Web, cette approche se prête aussi à une démarcation très stricte, entre disciplines d'une structure commune. Celui qui créé le contenu — qui peut être un journaliste, un producteur de musique, ou encore provenir de n'importe laquelle de nombreuses disciplines — n'a pas besoin de s'investir du tout dans le processus actuel de publication du contenu. Et la personne qui applique le balisage n'a pas forcément besoin de savoir (ni de se soucier de) comment il va être composé. Le véritable impact de<em>The Zen Garden</em> a été d'aider à démontrer les stupéfiants résultats qui sont possibles sans modification du balisage, ainsi que de vraiment garder la quantité de balisage de présentation à un minimum acceptable.</p> - -<p>Le modèle Contenu-Balisage-Style se prête aussi très correctement aux méthodes linéaires de production. Il ne doit y avoir aucun besoin ni aucune activité de développement Web avant que le contenu ne soit produit. Inversement, une fois le contenu à portée de main, le processus de développement et de publication devrait être incroyablement rapide. Et c'est comme cela que ça devrait être. Si nous avons produit un contenu, nous voulons le publier dès maintenant. Pas dans six semaines.</p> - -<p>De plus, en signalant rigoureusement le procédé de production, on peut mesurer et contrôler le temps, les budgets, et les ressources, non-seulement du développement initial du contenu émergeant, mais aussi de sa publication en cours. C'est un outil de gestion très puissant.</p> - -<p>Voilà de quoi sont capables les Standards Web. Cela permet de fournir une structure de développement nettement meilleure, autant pour les fournisseurs de contenu, que pour les développeurs Web et les stylistes de CSS. Il est tout simplement inimaginable que quiconque ne puisse profiter des énormes bénéfices qu'apportent les Standards, et qu'il ne les partage. Les clients, les développeurs et les créateurs de médias numériques peuvent être libérés de la tyrannie du développement composé de graphiques, des générateurs de codes, ainsi que du balisage incompréhensible. Mais le véritable intérêt réside dans le résultat final. Le message, délivré tant aux comptables qu'aux exécutifs et aux actionnaires, devrait être irrésistible.</p> - -<h3 id="Avantages_de_CSS_par_rapport_.C3.A0_Javascript" name="Avantages_de_CSS_par_rapport_.C3.A0_Javascript">Avantages de CSS par rapport à Javascript</h3> - -<p>Plus particulièrement, les graphiques et Javascript sont souvent utilisés pour les effets spéciaux dans les fragments de texte. Vu que la technologie des feuilles de style permet aux concepteurs un bon contrôle typographique et la réalisation d'effets tels que les<em>RollOver</em>, elle réduit considérablement le besoin d'une programmation Javascript et la création de graphiques. Et plus encore : cela réduit la consommation de bande passante due aux images.</p> - -<h3 id="Un_code_HTML_bien_form.C3.A9_.C3.A9conomise_du_temps_et_de_l.27argent" name="Un_code_HTML_bien_form.C3.A9_.C3.A9conomise_du_temps_et_de_l.27argent">Un code HTML bien formé économise du temps et de l'argent</h3> - -<p>Les pages Web qui s'affichent différemment d'un navigateur à l'autre provoquent l'un des plus grands maux de têtes aux développeurs Web. De telles différences de rendu touchent surtout les anciens navigateurs, mais la plupart sont bien connues et documentées. Dans de nombreux cas, des codes ambigus causent ces différences de rendu. Pour les développeurs dans les environnements commerciaux, capables de mesurer ces dépenses en temps, certains chiffres sont étonnants. Concernant une caractéristique haut de gamme d'un site, une seule incohérence entre navigateurs peut absorber les principaux développeurs dans des heures douloureuses et frustrantes de chasse aux forums et de réparation de bogues. Comme nous utilisons les Standards depuis le début, nous disposons d'un point de référence connu afin de mesurer les variations connues des vieux navigateurs. À présent, presque toutes ces variations sont bien documentées, et les réparations sont bien publiées et bien connues. En revanche, la réparation de balises chaotiques est un trou noir qui aspire temps et argent.</p> - -<p>Un code bien défini réduit considérablement les différences de rendu dans divers navigateurs. L'utilisation d'outils de validation tels que <a class="external" href="http://validator.w3.org/">le validateur du W3C</a> aide en repérant les erreurs de codage et en vérifiant que le code HTML soit bien formé, ce qui élimine l'ambiguïté dans l'analyse des navigateurs.</p> - -<h2 id="Les_nouveaux_navigateurs_adoptent_les_standards" name="Les_nouveaux_navigateurs_adoptent_les_standards">Les nouveaux navigateurs adoptent les standards</h2> - -<p>De plus en plus de navigateurs, autres qu'Internet Explorer pour Windows, sont utilisés pour naviguer sur le Web :</p> - -<ul> - <li>Windows : MSIE, navigateurs utilisant le <a href="fr/Gecko">moteur de rendu Gecko de Mozilla</a>, Opera</li> - <li>Mac : MS-Tasman (les moteurs de rendus d'IE/Mac), les navigateurs de type Gecko, Safari, Opera</li> - <li>Linux : les navigateurs de type Gecko, les navigateurs de type KHTML, Opera</li> -</ul> - -<p>Globalement, 5 différents moteurs de rendu sont utilisés pour naviguer sur le Web. Ils se servent de douzaines de navigateurs sur 3 plateformes.</p> - -<p>Selon de nombreuses sources, les navigateurs de type Gecko sont aujourd'hui beaucoup plus courants que les navigateurs de Netscape 4.x et de MSIE 4, et cela augmente de manière significative avec le temps. Rien que <a class="external" href="http://getfirefox.com/">Firefox</a> a été téléchargé plus de 50 millions de fois en l'espace de 6 mois.</p> - -<p>Dans un tel environnement, de plus en plus hétérogène, il est inimaginable de tester chaque page Web dans toutes les configurations possibles. La seule solution pratique est donc de se mettre aux standards.</p> - -<p>Dans un environnement novateur, Microsoft a sorti pour IE 8 une nouvelle balise meta qui peut être utilisée pour déclencher dans les sites le mode des Standards Web. En même temps, les anciens sites qui ne sont pas en mode Standards s'afficheront toujours correctement. Même si ce geste est d'une certaine manière controversé, l'annonce a reçu énormément de soutien de la part des principaux développeurs et des partisans des standards, Jeffrey Zeldman en tête.</p> - -<h3 id="Anciens_navigateurs.C2.A0:_Netscape_4_et_IE4" name="Anciens_navigateurs.C2.A0:_Netscape_4_et_IE4">Anciens navigateurs : Netscape 4 et IE4</h3> - -<p>Le seul inconvénient avec l'utilisation de CSS est que les anciens navigateurs (surtout IE4 et NS4) ne sont pas en mesure de l'afficher correctement. Dans certains cas, par exemple si le public est nombreux à naviguer sur Netscape 4.x, la solution peut être d'utiliser de simples tableaux pour la mise en page, et CSS pour le contrôle des polices. Une autre option serait de fournir du contenu HTML aux utilisateurs de Netscape 4.x, sans le style CSS. Le contenu sera utilisable, mais beaucoup moins attractif que dans les navigateurs modernes. De plus, les navigateurs 4.x sont connus pour leurs problèmes de sécurité : leurs utilisateurs devraient donc être encouragés à les mettre à jour.</p> - -<h2 id="Une_accessibilit.C3.A9_r.C3.A9glement.C3.A9e" name="Une_accessibilit.C3.A9_r.C3.A9glement.C3.A9e">Une accessibilité réglementée</h2> - -<p>Les organismes gouvernementaux de nombreux pays (US, UK, Canada) ont l'obligation d'être accessibles, et, dans certains pays comme l'Australie, cela s'applique à toutes les organisations. Aux États-Unis, la <a class="external" href="http://www.section508.gov/">Section 508</a> s'applique aux agences et aux projets financés par le gouvernement.</p> - -<p>En utilisant les standards (surtout CSS pour le positionnement, ainsi que du HTML strict), l'accessibilité est un but plus facile à atteindre. Car les standards ont en effet été créés dans un souci d'accessibilité.</p> - -<p>Pour bien entretenir l'accessibilité, il faut être capable d'offrir un contenu Web à un plus grand public, accroissant ainsi l'ergonomie/l'utilisabilité d'un site Web, même pour les personnes non handicapées.</p> - -<p>Pour les développeurs qui souhaitent surtout accéder à des fonds publics, ou qui travaillent avec des organismes de charité ou socialement responsables, une des clefs les plus importantes est de s'harmoniser avec la législation pertinente de sa juridiction. Tout aussi crucial que le besoin évident de se soumettre à la loi, l'adoption des standards web le plus souvent possible indique clairement un esprit de responsabilité sociale communautaire. De nombreux leaders industriels appliquent cette façon de pensée à tout ce qu'ils font. Les sites qui ne satisfont que l'égo du concepteur et de très peu d'autres personnes vont subir un avenir commercial de plus en plus difficile.</p> - -<h2 id="Le_processus_de_d.C3.A9veloppement.C2.A0:_travailler_en_.C3.A9quipe" name="Le_processus_de_d.C3.A9veloppement.C2.A0:_travailler_en_.C3.A9quipe">Le processus de développement : travailler en équipe</h2> - -<p>Un code écrit par d'autres développeurs représente un défi commun à tous les développeurs Web qui assurent la gestion des sites existants. Dans de nombreux cas, ils sont confrontés à un code HTML de très mauvaise qualité, qui dépend aussi parfois de fonctions et de programmes non-documentés, ainsi que de pratiques de codage spécifiques. Le manque de documentation est aussi souvent problématique.</p> - -<p>Suivre les documents sur <a class="external" href="http://www.w3.org/QA/2002/07/WebAgency-Requirements">standards-compliance in requirements</a> est une manière très efficace d'assurer une qualité mesurable du produit fini, le W3C étant un juge impartial (le World Wide Web Consortium, abrégé par le sigle W3C, est un organisme de normalisation fondé en octobre 1994 comme un consortium chargé de promouvoir la compatibilité des technologies du World Wide Web telles que HTML, XHTML, XML, RDF, CSS, PNG, SVG et SOAP. Le W3C n'émet pas des normes au sens européen, mais des recommandations à valeur de standards industriels).</p> - -<p>Comme les standards sont très bien documentés, une nouvelle personne qui viendrait reprendre des codes respectueux des standards peut commencer immédiatement, et n'a pas besoin de se familiariser avec les pratiques de codage du développeur antérieur. Cela réduit aussi de manière significative les enfermements propriétaires</p> - -<h2 id="Standards_Web.C2.A0:_enrichir_l.27exp.C3.A9rience_utilisateur" name="Standards_Web.C2.A0:_enrichir_l.27exp.C3.A9rience_utilisateur">Standards Web : enrichir l'expérience utilisateur</h2> - -<p>Tout l'esprit des Standards Web découle du fait qu'ils évoluent grâce à l'expérience utilisateur. Cet esprit n'est déterminé ni par les concepteurs graphiques, ni par les développeurs de générateurs de code propriétaires, ni par le besoin d'effectuer une gymnastique de codage tridimensionnelle pour pouvoir faire face aux vendeurs de navigateurs et d'autres agents utilisateurs. Afin d'améliorer cette expérience utilisateur, les objectifs les plus importants du développement utilisant les standards sont les fameux jumeaux utilisabilité et accessibilité. Le fait d'employer simplement — et assez grossièrement — une expérience utilisateur agréable, satisfaisante et épanouissante se traduit par un trafic plus dense, plus de visiteurs récurrents, moins de rebonds, plus de temps pour flâner, plus de clics suivis. Finalement, cette expérience utilisateur améliorée permet d'atteindre les objectifs d'affaires ou opérationnels du site. Un dialogue plus ouvert, plus de ventes, et d'une certaine manière plus de personnes qui interagissent avec l'opérateur du site.</p> - -<p>Les sites créés à partir de méthodologies, de processus, et de la pratique des standards Web réalisent de loin — et en tout point de vue — les meilleures performances. Ils se chargent plus rapidement, sont plus faciles à retrouver dans les moteurs de recherche, et ils organisent et délivrent efficacement leur contenu. L'utilisateur peut profiter de toutes ces merveilleuses expériences, sans jamais se soucier de la plateforme, du logiciel, du système d'exploitation, ni de douzaines d'autres variables telles que la taille de l'écran, la résolution du texte, l'activation de JavaScript, ou n'importe quel handicap que rencontre l'utilisateur.</p> - -<h2 id="Conclusion" name="Conclusion">Conclusion</h2> - -<p>L'utilisation de standards Web, ainsi que la séparation entre la structure et la présentation, rapporte un bon nombre de bénéfices pour aujourd'hui et demain.</p> - -<p>Pour aujourd'hui, cela représente un public plus nombreux, moins de dépenses d'argent pour la production d'un nouveau contenu, et de devenir conciliant envers les exigences requises par l'accessibilité.</p> - -<p>Pour demain, cela représente la réduction des enfermements propriétaires, la réduction des dépenses dans la maintenance, et plus de flexibilité dans la présentation d'un site Web. Sans oublier que l'utilisation des standards ouvre la porte aux technologies XML.</p> - -<p>Tous ces facteurs contribuent aussi à améliorer la gestion des sites, à rassembler un public plus large, et à perfectionner le retour des investissements. Les<em>geeks</em>, les marchands, et le contrôle de gestion peuvent tous bénéficier d'un site Web fondé sur les standards. Et c'est déjà plus que ce que l'on pourrait espérer….</p> diff --git a/files/fr/archive/standards_du_web/le_sniffing_de_doctype_dans_mozilla/index.html b/files/fr/archive/standards_du_web/le_sniffing_de_doctype_dans_mozilla/index.html deleted file mode 100644 index 77084464d7..0000000000 --- a/files/fr/archive/standards_du_web/le_sniffing_de_doctype_dans_mozilla/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: Le sniffing de DOCTYPE dans Mozilla -slug: Archive/Standards_du_Web/Le_sniffing_de_DOCTYPE_dans_Mozilla -tags: - - Développement_Web -translation_of: Archive/Web_Standards/Mozilla_s_DOCTYPE_sniffing ---- -<p> </p> -<p>Ce document décrit comment Mozilla utilise la déclaration DOCTYPE pour choisir entre le mode strict et <a href="fr/Mode_quirks_de_Mozilla">le mode dégradé quirks</a>. Le code qui permet cette détermination est la fonction <a href="https://dxr.mozilla.org/mozilla-central/source/parser/htmlparser/src/nsParser.cpp#833" rel="custom">DetermineParseMode() dans nsParser.cpp</a>. Consultez le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1312" title='FIXED: "Standard" compatibility mode needs to be hooked to DOCTYPE'>bug 1312</a> et le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=55264" title="FIXED: [DOCTYPE] Documents with unknown DOCTYPE should be displayed in strict mode">bug 55264</a> pour plus d'informations sur l'histoire de cette détermination. Consultez le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=153032" title="FIXED: Implement almost-standards rendering mode">bug 153032</a> pour la création du mode « presque standard » depuis Mozilla 1.0. L'objectif recherché pour ce comportement a été le suivant :</p> -<ul> - <li>la plupart des pages <code>text/html</code> existantes sur le Web qui ont besoin d'un mode dégradé pour s'afficher correctement doivent être affichées avec le mode quirks ( - <i> - presque</i> - toutes, plutôt que toutes, pour répondre également aux points suivants).</li> - <li>Les auteurs de pages Web écrivant selon les standards en vigueur doivent pouvoir basculer vers le mode strict.</li> - <li>Les pages écrites en utilisant n'importe quel identifiant public dans leur déclaration DOCTYPE qui apparaîtront dans l'avenir doivent s'afficher en mode strict.</li> -</ul> -<p>En d'autres termes, l'algorithme est la meilleure approximation que nous ayons trouvée pour déterminer quelles pages ont été écrites après que Mozilla ne devienne un navigateur important sur le Web.</p> -<h3 id="Mode_standard_complet" name="Mode_standard_complet">Mode standard complet</h3> -<p>Les lignes suivantes déclenchent le mode standard complet :</p> -<ul> - <li>Tous les documents avec un type MIME XML tel que <code>text/xml</code>, <code>application/xml</code>, ou <code>application/xhtml+xml</code> (puisque le sniffing n'a lieu que pour les documents text/html).</li> - <li>Tous les documents <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+SYSTEM+%22http%3A%2F%2Fwww.w3.org%2FTR%2FREC-html40%2Fstrict.dtd%22%3E">"DOCTYPE HTML SYSTEM"</a> par opposition au "DOCTYPE HTML PUBLIC", à l'exception des doctypes IBM notés plus bas.</li> - <li>Une déclaration DOCTYPE sans DTD, c'est-à-dire <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML%3E"><!DOCTYPE HTML></a>.</li> - <li>Une déclaration DOCTYPE avec un <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+%5B+%3C%21ELEMENT+TEST+-+-+%28P%29+%3E+%5D%3E+">sous-ensemble interne</a>.</li> - <li>Tout doctype inconnu, ce qui veut dire aussi les doctypes (techniquement connus) suivants : - <ul> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.01%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.01//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.0%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+XHTML+1.0+Strict%2F%2FEN%22%3E">"-//W3C//DTD XHTML 1.0 Strict//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22ISO%2FIEC+15445:2000%2F%2FDTD+HyperText+Markup+Language%2F%2FEN%22%3E">"ISO/IEC 15445:2000//DTD HyperText Markup Language//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22ISO%2FIEC+15445:2000%2F%2FDTD+HTML%2F%2FEN%22%3E">"ISO/IEC 15445:2000//DTD HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+i18n%2F%2FEN%22%3E">"-//IETF//DTD HTML i18n//EN"</a>.</li> - </ul> - </li> -</ul> -<h3 id="Mode_presque_standard" name="Mode_presque_standard">Mode presque standard</h3> -<p>Les lignes suivantes déclenchent le mode presque standard. Le <a href="fr/Mode_presque_standard_de_Gecko">mode presque standard</a> a été créé après les versions 1.0 et 1.1alpha de Mozilla, mais avant les versions 1.0.1 et 1.1beta. Avant la création de ce mode, ces doctypes permettaient de basculer en mode standard complet.</p> -<ul> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+XHTML+1.0+Transitional%2F%2FEN%22%3E">"-//W3C//DTD XHTML 1.0 Transitional//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+XHTML+1.0+Frameset%2F%2FEN%22%3E">"-//W3C//DTD XHTML 1.0 Frameset//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.01+Transitional%2F%2FEN%22+%22http%3A%2F%2Fwww.w3.org%2FTR%2Fhtml4%2Floose.dtd%22%3E">"-//W3C//DTD HTML 4.01 Transitional//EN"</a>, avec un identificateur système.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.01+Frameset%2F%2FEN%22+%22http%3A%2F%2Fwww.w3.org%2FTR%2Fhtml4%2Fframeset.dtd%22%3E">"-//W3C//DTD HTML 4.01 Frameset//EN"</a>, avec un identificateur système.</li> -</ul> -<h3 id="Mode_d.C3.A9grad.C3.A9_quirks" name="Mode_d.C3.A9grad.C3.A9_quirks">Mode dégradé quirks</h3> -<p>Les lignes suivantes déclenchent le mode quirks (cette liste doit être complète afin que les pages existantes sur le Web basculent en mode quirks) :</p> -<p>Les sites suivants ont été utiles pour préparer cette liste : <a class="external" href="http://validator.w3.org/sgml-lib/catalog">W3C HTML Validator</a>, <a class="external" href="http://www.htmlhelp.com/tools/validator/lib/catalog">HTMLHelp HTML Validator</a>.</p> -<ul> - <li>L'<a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=">absence de DOCTYPE</a>.</li> - <li>Une <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%3Fxml+version%3D%221.0%22%3F%3E">déclaration XML (pseudo-PI) sans doctype</a> (en d'autres termes, ignorer la déclaration XML et utiliser le DOCTYPE). Avant les versions 1.0 et 1.1alpha (mais pas 1.0.1 et 1.1beta), la présence d'une déclaration XML déclenchait le mode standard complet.</li> - <li>Une déclaration DOCTYPE qui <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+NOT+UNDERSTOOD%3E">ne peut pas être comprise</a> (par ex. qui ne correspond à rien).</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+html+SYSTEM+%22http%3A%2F%2Fwww.ibm.com%2Fdata%2Fdtd%2Fv11%2Fibmxhtml1-transitional.dtd%22%3E">"http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd"</a> (avant 1.5b et 1.4.2, il déclenchait le mode quasi standard).</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.01+Transitional%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.01 Transitional//EN"</a>, sans identificateur système.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.01+Frameset%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.01 Frameset//EN"</a>, sans identificateur système.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.0+Transitional%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.0 Transitional//EN"</a> (voir également <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.0+Transitional%2F%2FEN%22+%22http%3A%2F%2Fwww.w3.org%2FTR%2FREC-html40%2Floose.dtd%22%3E">ce test avec un identificateur système</a>).</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.0+Frameset%2F%2FEN%22%3E">"-//W3C//DTD HTML 4.0 Frameset//EN"</a> (voir également <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+4.0+Frameset%2F%2FEN%22+%22http%3A%2F%2Fwww.w3.org%2FTR%2FREC-html40%2Fframeset.dtd%22%3E">ce test avec un identificateur système</a>).</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSoftQuad+Software%2F%2FDTD+HoTMetaL+PRO+6.0::19990601::extensions+to+HTML+4.0%2F%2FEN%22%3E">"-//SoftQuad Software//DTD HoTMetaL PRO 6.0::19990601::extensions to HTML 4.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSoftQuad%2F%2FDTD+HoTMetaL+PRO+4.0::19971010::extensions+to+HTML+4.0%2F%2FEN%22%3E">"-//SoftQuad//DTD HoTMetaL PRO 4.0::19971010::extensions to HTML 4.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML%2F%2FEN%2F%2F3.0%22%3E">"-//IETF//DTD HTML//EN//3.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3O%2F%2FDTD+W3+HTML+3.0%2F%2FEN%2F%2F%22%3E">"-//W3O//DTD W3 HTML 3.0//EN//"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3O%2F%2FDTD+W3+HTML+3.0%2F%2FEN%22%3E">"-//W3O//DTD W3 HTML 3.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+3+1995-03-24%2F%2FEN%22%3E">"-//W3C//DTD HTML 3 1995-03-24//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+3.0%2F%2FEN%22%3E">"-//IETF//DTD HTML 3.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+3.0%2F%2FEN%2F%2F%22%3E">"-//IETF//DTD HTML 3.0//EN//"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+3%2F%2FEN%22%3E">"-//IETF//DTD HTML 3//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+3%2F%2FEN%22%3E">"-//IETF//DTD HTML Level 3//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+3%2F%2FEN%2F%2F3.0%22%3E">"-//IETF//DTD HTML Level 3//EN//3.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+3.2%2F%2FEN%22%3E">"-//IETF//DTD HTML 3.2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FAdvaSoft+Ltd%2F%2FDTD+HTML+3.0+asWedit+%2B+extensions%2F%2FEN%22%3E">"-//AS//DTD HTML 3.0 asWedit + extensions//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FAdvaSoft+Ltd%2F%2FDTD+HTML+3.0+asWedit+%2B+extensions%2F%2FEN%22%3E">"-//AdvaSoft Ltd//DTD HTML 3.0 asWedit + extensions//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict%2F%2FEN%2F%2F3.0%22%3E">"-//IETF//DTD HTML Strict//EN//3.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3O%2F%2FDTD+W3+HTML+Strict+3.0%2F%2FEN%2F%2F%22%3E">"-//W3O//DTD W3 HTML Strict 3.0//EN//"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+3%2F%2FEN%22%3E">"-//IETF//DTD HTML Strict Level 3//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+3%2F%2FEN%2F%2F3.0%22%3E">"-//IETF//DTD HTML Strict Level 3//EN//3.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22HTML%22%3E">"HTML"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML%2F%2FEN%22%3E">"-//IETF//DTD HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+2%2F%2FEN%22%3E">"-//IETF//DTD HTML Level 2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+2%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Level 2//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0+Level+2%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0 Level 2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+1%2F%2FEN%22%3E">"-//IETF//DTD HTML Level 1//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+1%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Level 1//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0+Level+1%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0 Level 1//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+0%2F%2FEN%22%3E">"-//IETF//DTD HTML Level 0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Level+0%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Level 0//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict%2F%2FEN%22%3E">"-//IETF//DTD HTML Strict//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Strict//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+2%2F%2FEN%22%3E">"-//IETF//DTD HTML Strict Level 2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+2%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Strict Level 2//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0+Strict%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0 Strict//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0+Strict+Level+2%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0 Strict Level 2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+1%2F%2FEN%22%3E">"-//IETF//DTD HTML Strict Level 1//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+1%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Strict Level 1//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.0+Strict+Level+1%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.0 Strict Level 1//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+0%2F%2FEN%22%3E">"-//IETF//DTD HTML Strict Level 0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+Strict+Level+0%2F%2FEN%2F%2F2.0%22%3E">"-//IETF//DTD HTML Strict Level 0//EN//2.0"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FWebTechs%2F%2FDTD+Mozilla+HTML%2F%2FEN%22%3E">"-//WebTechs//DTD Mozilla HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FWebTechs%2F%2FDTD+Mozilla+HTML+2.0%2F%2FEN%22%3E">"-//WebTechs//DTD Mozilla HTML 2.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FNetscape+Comm.+Corp.%2F%2FDTD+HTML%2F%2FEN%22%3E">"-//Netscape Comm. Corp.//DTD HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FNetscape+Comm.+Corp.%2F%2FDTD+HTML%2F%2FEN%22%3E">"-//Netscape Comm. Corp.//DTD HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FNetscape+Comm.+Corp.%2F%2FDTD+Strict+HTML%2F%2FEN%22%3E">"-//Netscape Comm. Corp.//DTD Strict HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+2.0+HTML%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 2.0 HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+2.0+HTML+Strict%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 2.0 HTML Strict//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+2.0+Tables%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 2.0 Tables//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+3.0+HTML%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 3.0 HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+3.0+HTML+Strict%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 3.0 HTML Strict//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FMicrosoft%2F%2FDTD+Internet+Explorer+3.0+Tables%2F%2FEN%22%3E">"-//Microsoft//DTD Internet Explorer 3.0 Tables//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSun+Microsystems+Corp.%2F%2FDTD+HotJava+HTML%2F%2FEN%22%3E">"-//Sun Microsystems Corp.//DTD HotJava HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSun+Microsystems+Corp.%2F%2FDTD+HotJava+Strict+HTML%2F%2FEN%22%3E">"-//Sun Microsystems Corp.//DTD HotJava Strict HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FIETF%2F%2FDTD+HTML+2.1E%2F%2FEN%22%3E">"-//IETF//DTD HTML 2.1E//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FO%27Reilly+and+Associates%2F%2FDTD+HTML+Extended+1.0%2F%2FEN%22%3E">"-//O'Reilly and Associates//DTD HTML Extended 1.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FO%27Reilly+and+Associates%2F%2FDTD+HTML+Extended+Relaxed+1.0%2F%2FEN%22%3E">"-//O'Reilly and Associates//DTD HTML Extended Relaxed 1.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FO%27Reilly+and+Associates%2F%2FDTD+HTML+2.0%2F%2FEN%22%3E">"-//O'Reilly and Associates//DTD HTML 2.0//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSQ%2F%2FDTD+HTML+2.0+HoTMetaL+%2B+extensions%2F%2FEN%22%3E">"-//SQ//DTD HTML 2.0 HoTMetaL + extensions//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FSpyglass%2F%2FDTD+HTML+2.0+Extended%2F%2FEN%22%3E">"-//Spyglass//DTD HTML 2.0 Extended//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22%2B%2F%2FSilmaril%2F%2FDTD+HTML+Pro+v0r11+19970101%2F%2FEN%22%3E">"+//Silmaril//DTD HTML Pro v0r11 19970101//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+Experimental+19960712%2F%2FEN%22%3E">"-//W3C//DTD HTML Experimental 19960712//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+3.2%2F%2FEN%22%3E">"-//W3C//DTD HTML 3.2//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+3.2+Final%2F%2FEN%22%3E">"-//W3C//DTD HTML 3.2 Final//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+3.2+Draft%2F%2FEN%22%3E">"-//W3C//DTD HTML 3.2 Draft//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+Experimental+970421%2F%2FEN%22%3E">"-//W3C//DTD HTML Experimental 970421//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+HTML+3.2S+Draft%2F%2FEN%22%3E">"-//W3C//DTD HTML 3.2S Draft//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?doctype=%3C%21DOCTYPE+HTML+PUBLIC+%22-%2F%2FW3C%2F%2FDTD+W3+HTML%2F%2FEN%22%3E">"-//W3C//DTD W3 HTML//EN"</a>.</li> - <li>L'identificateur public <a class="external" href="http://dbaron.org/mozilla/tests/compat?pubid=-%2F%2FMetrius%2F%2FDTD+Metrius+Presentational%2F%2FEN">"-//Metrius//DTD Metrius Presentational//EN"</a>.</li> -</ul> -<p>Notez que toutes les comparaisons d'identificateurs publics sont insensibles à la casse, à cause du nombre important de pages qui utilisent des identificateurs ayant une casse incorrecte (ce qui est techniquement incorrect puisque les chaînes de caractères sont sensibles à la casse).</p> -<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3> -<ul> - <li><a href="fr/D%c3%a9veloppement_Web">Développement Web</a></li> - <li><a href="fr/Mode_quirks_de_Mozilla">Mode quirks de Mozilla</a></li> - <li><a href="fr/Comportement_du_mode_quirks_de_Mozilla">Comportement du mode quirks de Mozilla</a></li> -</ul> -<div class="originaldocinfo"> - <h3 id="Informations_sur_le_document_original" name="Informations_sur_le_document_original">Informations sur le document original</h3> - <ul> - <li>Auteur(s) : <a class="external" href="http://dbaron.org/">David Baron</a></li> - <li>Dernière mise à jour : 2 août 2005</li> - <li>Copyright : Copyright © <a class="external" href="http://dbaron.org/">David Baron</a></li> - </ul> -</div> -<p> </p> diff --git a/files/fr/archive/standards_du_web/problèmes_soulevés_par_le_pseudo_élément_hover/index.html b/files/fr/archive/standards_du_web/problèmes_soulevés_par_le_pseudo_élément_hover/index.html deleted file mode 100644 index 7cc2a12604..0000000000 --- a/files/fr/archive/standards_du_web/problèmes_soulevés_par_le_pseudo_élément_hover/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Problèmes soulevés par le pseudo élément hover -slug: Archive/Standards_du_Web/Problèmes_soulevés_par_le_pseudo_élément_hover -tags: - - CSS -translation_of: Archive/Web_Standards/Issues_Arising_From_Arbitrary-Element_hover ---- -<p> </p> -<p><br> - <span class="comment">Summary: Thanks to long-standing limitations, we're used to thinking of hover styles as applying only to hyperlinks, which has led to some sloppy authoring practices that are now causing problems for some Web sites. This technote explains the source of the problems and how to avoid encountering them.</span></p> -<p>Beaucoup d'auteurs utilisent la pseudo-classe CSS2 <code>:hover</code> pour appliquer un style à leurs liens. Cette innovation, introduite en premier par Microsoft® Internet Explorer et adoptée dans les spécifications CSS, est très populaire pour styler des liens texte, en remplacement des « rollovers » faits en JavaScript. Toutefois, le support avancé de CSS dans les navigateurs a entraîné des comportements agressifs inattendus sur certaines pages.</p> -<h3 id="Hover_et_.C3.A9l.C3.A9ments_non-liens" name="Hover_et_.C3.A9l.C3.A9ments_non-liens">Hover et éléments non-liens</h3> -<p><a class="external" href="http://www.yoyodesign.org/doc/w3c/css2/selector.html#dynamic-pseudo-classes">Le chapitre 5.11.3 de CSS2</a> définit les trois types de pseudo-classes (<code>:hover</code>, <code>:active</code>, et <code>:focus</code>) et mentionne que :</p> -<blockquote> - CSS ne définit pas lesquels des éléments peuvent être dans un de ces états ou comment ceux-ci entrent et sortent de ces états. L'écriture peut varier, selon que les éléments réagissent aux actions de l'utilisateur, ou non, et les divers appareils et agents utilisateurs peuvent avoir différentes façons de désigner ou d'activer les éléments.</blockquote> -<p>Ainsi, bien que les auteurs s'imaginent que ces trois états ne s'appliquent exclusivement qu'aux liens hypertexte, il n'y a pas de limitation dans CSS2. Tout élément peut, en théorie, se trouver dans l'un de ces trois états et être stylé selon ces états. Ce n'était pas traditionnellement le cas.</p> -<h3 id="Pseudo-classes_nues" name="Pseudo-classes_nues">Pseudo-classes nues</h3> -<p>La seconde partie du problème vient lorsque nous considérons les effets d'une pseudo-classe « nue » dans un sélecteur. Par exemple :</p> -<pre class="eval">:hover {color: red;} -</pre> -<p>Cette règle est équivalente à la règle CSS2 suivante :</p> -<pre class="eval">*:hover {color: red;} -</pre> -<p>…qui se traduit en « tout élément survolé aura sa couleur d'écriture mise en rouge ». Ainsi, le survol de paragraphes, de tableaux, d'en-têtes et tous autres éléments dans un document coloriera le texte en rouge.</p> -<p>Une variante classique consiste à utiliser une classe nue et une pseudo-classe <code>hover</code> comme ceci :</p> -<pre class="eval">.nav:hover {color: red;} -</pre> -<p>Les situations où seules les instances de la valeur <code>nav</code> de la classe <code>class</code> sont appliquées aux liens hypertextes fonctionnent correctement. Cependant, les règles de ce type se rencontrent habituellement avec des balises comme ceci :</p> -<pre><td class="nav"> -<a href="one.html" class="nav">un</a> | -<a href="two.html" class="nav">deux</a> | -<a href="thr.html" class="nav">trois</a> | -<a href="fou.html" class="nav">quatre</a> -</td></pre> -<p>Comme la cellule du tableau a une <code>class</code> à <code>nav</code>, le caractère barre verticale virera en rouge lorsque l'utilisateur déplacera la souris n'importe où dans la cellule. Les liens vireront également en rouge lorsqu'ils sont survolés.</p> -<h3 id="Comportement_de_Gecko" name="Comportement_de_Gecko">Comportement de Gecko</h3> -<p>Dans les navigateurs basés sur des compilations de Gecko postérieures à 20020410 (Netscape 6.1+), les styles <code>:hover</code> peuvent s'appliquer à n'importe quel élément d'un document. De ce fait, les auteurs qui ont employé des pseudo-classes nues ou leur combinaisons, risquent de voir ce style s'appliquer même à d'autres éléments que leurs liens. La meilleure parade est d'ajouter l'élément ancre aux sélecteurs comme ceci :</p> -<pre class="eval">a:hover {color: red;} -a.nav:hover {color: red;} -</pre> -<p>Pour éviter le plus possible les problèmes avec des documents anciens, les navigateurs basés sur Mozilla 1.0 et suivant (Netscape 7+) incluent du code permettant aux pseudo-classes d'être restreintes aux seuls liens seulement si le document est rendu dans le mode « quirks ». Dans les navigateurs basés sur un moteur postérieure à Mozilla 1.3b, ce mode <i>quirk</i> a été étendu pour couvrir les sélecteurs qui combinent un sélecteur de classe nu avec la pseudo-classes <code>:hover</code> (voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=169078" title="FIXED: .class:hover should be ignored for non-links in quirks mode">bug 169078</a> pour plus de détails).</p> -<h3 id="Probl.C3.A8mes_des_ancres_nomm.C3.A9es" name="Probl.C3.A8mes_des_ancres_nomm.C3.A9es">Problèmes des ancres nommées</h3> -<p>En plus des effets précédemment décrit, il y a deux autres effets relativement répandus que les auteurs de pages Web peuvent ne pas désirer. Le premier est facilement corrigible grâce à la validation du document, mais le second est un peu plus subtil.</p> -<p>Tout d'abord, il y a le problème des ancres nommées ouvertes mais non fermées. Par exemple :</p> -<pre><a name="pagetop"> -<h2>My Page</h2> -</pre> -<p>Sans balise de fermeture <code></a></code>, le <code>name</code> englobera la suite du document. Ceci signifie généralement que la suite du document se verra attribuer les styles <code>hover</code>. Considérons les effets de la règle suivante :</p> -<pre class="eval">a:hover {color: red;} -</pre> -<p>Dans un document comportant une ancre nommée non fermée, tout texte suivant la balise d'ouverture de l'ancre sera coloré en rouge (à moins qu'une autre règle CSS ne soit définie).</p> -<p>Ceci nous amène au second problème, qui est que les ancres nommées peuvent accepter des styles <code>hover</code>. Bien que les auteurs désirent souvent que le sélecteur <code>a:hover</code> ne s'applique qu'aux hyperliens, il peut également s'appliquer aux ancres nommées, puisque le sélecteur spécifie que chaque élément <code>a</code> sera stylé lors de son survol. Afin d'éviter de problème, les auteurs devraient utiliser la syntaxe de la pseudo-classe combinée décrite dans CSS2 :</p> -<pre class="eval">a:link:hover {color: red;} -a:visited:hover {color: maroon;} -</pre> -<p>Remarquez qu'avec cette syntaxe, il est possible de styler les liens visités et non visités différemment lorsqu'ils sont survolés. Ce n'était pas possible avec un simple <code>a:hover</code>. Cela signifie, bien entendu, que le sélecteur <code>a:link:hover</code> ne s'appliquera qu'aux liens non visités, ainsi les auteurs désireux d'obtenir le même style pour les liens visités et non visités lors du survol doivent grouper les deux sélecteurs dans une seule et unique règle.</p> -<h3 id="Recommendation" name="Recommendation">Recommendation</h3> -<p>Pour éviter les problèmes inattendus, les auteurs sont <b>fortement</b> encouragés à inclure des noms d'élément dans les pseudo-classes dynamiques qui sont destinées à être appliquées aux hyperliens. En outre, combiner des pseudo-classes prévient l'application de styles <code>:hover</code> à des ancres qui ne sont pas des hyperliens. Ainsi, <code>a:hover</code> devrait toujours être utilisé à la place du simple <code>:hover</code>, et <code>a:link:hover</code> (et <code>a:visited:hover</code>) sont préférables à un simple <code>a:hover</code>.</p> -<h3 id="Liens_connexes" name="Liens_connexes">Liens connexes</h3> -<ul> - <li><a class="external" href="http://www.yoyodesign.org/doc/w3c/css2/selector.html#dynamic-pseudo-classes">Les pseudo-classes dynamiques : :hover, :active, et :focus</a></li> -</ul> -<div class="originaldocinfo"> - <h3 id="Informations_sur_le_document_original" name="Informations_sur_le_document_original">Informations sur le document original</h3> - <ul> - <li>Auteur(s) : Eric A. Meyer, Netscape Communications</li> - <li>Dernière mise à jour : Publié le 7 mars 2003 ; Révisé le 21 mars 2003</li> - <li>Copyright : Copyright © 2001-2003 Netscape. All rights reserved.</li> - <li>Note : This reprinted article was originally part of the DevEdge site.</li> - </ul> -</div> -<p><span class="comment">Interwiki Languages Links</span></p> -<p></p> diff --git a/files/fr/archive/standards_du_web/rdf_en_cinquante_mots/index.html b/files/fr/archive/standards_du_web/rdf_en_cinquante_mots/index.html deleted file mode 100644 index daa552c354..0000000000 --- a/files/fr/archive/standards_du_web/rdf_en_cinquante_mots/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: RDF en cinquante mots -slug: Archive/Standards_du_Web/RDF_en_cinquante_mots -tags: - - RDF -translation_of: Archive/Web_Standards/RDF_in_Fifty_Words_or_Less ---- -<p>D'accord, peut-être qu'il y a un peu plus de cinquante mots, mais les points-clés sont plutôt simples (et <strong>en gras</strong> pour vous les dirigeants qui voulez juste aller à l'essentiel). Le <a class="external" href="http://developer.mozilla.org/en/docs/RDF"><em>Resource Description Framework</em></a> (NdT : « Cadre de description de ressources »), ou « RDF », c'est en fait deux choses.</p> - -<p><strong>D'abord, RDF est un modèle à base de graphes pour décrire les ressources Internet (comme les pages web ou les emails), et comment ces ressources sont liées les unes aux autres.</strong></p> - -<p>Mais qu'est-ce que cela signifie<em>réellement</em> ? Pour un développeur Mozilla, cela veut dire que le modèle de donnée RDF (le « graphe ») peut être utilisé comme mécanisme pour intégrer et organiser les ressources Internet.</p> - -<p>Prenons un exemple : les marque-pages. Actuellement, la plupart des navigateurs vous permettent d'organiser hiérarchiquement vos marque-pages dans des<em>dossiers</em>. Chaque marque-page est un<em>pointeur</em> vers une page web, appelé <strong>URI</strong> (<strong>U</strong>niform <strong>R</strong>esource <strong>I</strong>dentifier, ou identifiant uniforme de ressource).</p> - -<p>Mais une page web est seulement une sorte de ressource Internet. Il y en a des tonnes d'autres, dont les emails, les articles de news Usenet (ou les newsgroups Usenet entiers), et les résultats de recherche de votre moteur de recherche favori, pour n'en citer que quelques uns. Et fondamentalement, il n'y a aucune raison pour que vous ne traitiez pas ces ressources comme des « marque-pages », en les regroupant dans des dossiers selon votre bon plaisir, ou même en créant des dossiers « intelligents » qui, quand vous les ouvrez, génèrent leur contenu dynamiquement en lançant une recherche commune que vous avez définie.</p> - -<p>Et un marque-page peut vraiment avoir des propriétés arbitraires associées : vous pourriez vouloir inventer votre propre schéma « classification » pour un marque-page codé à la façon « cool » Macintosh. Ou vous pourriez vouloir relier un marque-page à un autre marque-page, ou le garder dans plusieurs « dossiers » à la fois.</p> - -<p>Le graphe RDF fournit un modèle de données parfait sur lequel construire un service de marque-pages « universel » comme décrit ci-dessus : le graphe peut contenir des pointeurs vers des ressources arbitraires et les regrouper de n'importe quelle manière que vous pouvez imaginer.</p> - -<p>Mais attendez, il y a plus…</p> - -<p><strong>Ensuite, RDF est une syntaxe de sérialisation. Cette syntaxe permet aux modèle à base de graphes d'être transmis entre « agents ».</strong></p> - -<p>D'accord, qu'est-ce que ça peut bien vouloir dire ? Fondamentalement, cela signifie que les parties du modèle de données RDF peuvent être communiquées au-delà des frontières du réseau, et les contenus du graphe peuvent changer dynamiquement lorsque l'information provient d'un service distant.</p> - -<p>Reprenons l'exemple des marque-pages. Disons que l'un de mes « dossiers » de marque-pages est réellement un pointeur vers ma boîte de réception : lorsque j'ouvre ce dossier,<em>voilà</em>! Tous les messages que j'ai reçus dans la nuit apparaissent.</p> - -<p>Mais comment cela marche-t-il ? Le dossier « boîte de réception » était en fait un simple pointeur vers une ressource Internet qui contient plus de RDF qui étendent le graphe. Cette « ressource Internet » était une URI qui pointait vers un script CGI (disons, <span class="nowiki">http://www.mozilla.org/smart-mail/get-mail.cgi?user=waterson&folder=inbox</span>). Le script CGI génère en fait du<em>RDF sérialisé</em>, qui est simplement un moyen de formater un graphe en <a class="external" href="http://developer.mozilla.org/en/docs/XML">XML</a> :</p> - -<pre class="eval"><rdf:RDF - xmlns:rdf="<a class="external" href="http://www.w3.org/TR/WD-rdf-syntax#" rel="freelink">http://www.w3.org/TR/WD-rdf-syntax#</a>" - xmlns:sm="<a class="external" href="http://www.mozilla.org/smart-mail/schema#" rel="freelink">http://www.mozilla.org/smart-mail/schema#</a>"> - <rdf:Description - about="<a class="external" href="http://www.mozilla.org/smart-mail/get-mail.cgi?user=waterson&folder=inbox" rel="freelink">http://www.mozilla.org/smart-mail/ge...n&folder=inbox</a>"> - <sm:message id="4025293"> - <sm:recipient> - Chris Waterson "<a class="link-mailto" href="mailto:waterson@netscape.com" rel="freelink">waterson@netscape.com</a>" - </sm:recipient> - <sm:sender> - Aunt Helga "<a class="link-mailto" href="mailto:helga@netcenter.net" rel="freelink">helga@netcenter.net</a>" - </sm:sender> - <sm:received-by>x-wing.mcom.com</sm:received-by> - <sm:subject>Great recipe for Yam Soup!</sm:subject> - <sm:body> - <a class="external" href="http://www.mozilla.org/smart-mail/get-body.cgi?id=4025293" rel="freelink">http://www.mozilla.org/smart-mail/ge...cgi?id=4025293</a> - </sm:body> - </sm:message> - <sm:message id="4025294"> - <sm:recipient> - Chris Waterson "<a class="link-mailto" href="mailto:waterson@netscape.com" rel="freelink">waterson@netscape.com</a>" - </sm:recipient> - <sm:sender> - Sarah Waterson "<a class="link-mailto" href="mailto:waterson.2@postbox.acs.ohio-state.edu" rel="freelink">waterson.2@postbox.acs.ohio-state.edu</a>" - </sm:sender> - <sm:received-by>x-wing.mcom.com</sm:received-by> - <sm:subject>We won our ultimate game</sm:subject> - <sm:body> - <a class="external" href="http://www.mozilla.org/smart-mail/get-body.cgi?id=4025294" rel="freelink">http://www.mozilla.org/smart-mail/ge...cgi?id=4025294</a> - </sm:body> - </sm:message> - </rdf:Description> -</rdf:RDF> -</pre> - -<p>À la réception de la monstruosité ci-dessus, le moteur RDF incorpore le RDF à la bonne place dans le graphe, et le contrôle arbre qui implémente réellement l'UI dans le marque-page est informé qu'il devrait commencer à dessiner des icônes pour le dernier message sur la purée de patate douce de Tante Helga.</p> - -<p>C'est<em>exactement</em> comme ça que fonctionne SmartMail.</p> diff --git a/files/fr/archive/standards_du_web/utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes/index.html b/files/fr/archive/standards_du_web/utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes/index.html deleted file mode 100644 index c97ae34880..0000000000 --- a/files/fr/archive/standards_du_web/utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Utiliser des titres corrects avec des feuilles de styles externes -slug: >- - Archive/Standards_du_Web/Utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes -tags: - - CSS -translation_of: Archive/Web_Standards/Correctly_Using_Titles_With_External_Stylesheets ---- -<p> -Les feuilles de style externes sont souvent associées aux documents HTML en utilisant l'élément <code>link</code>, mais il est important d'en employer correctement les attributs. En effet, il y a trois sortes de feuilles de style, et l'attribut <code>title</code> est la clé de deux d'entre elles. Sa présence dans un élément <code>link</code> qui référence une feuille de style externe transforme celle-ci en feuille de style par défaut. Dans la plupart des cas, ceci conduira la feuille de style externe à être ignorée, ce qui n'est généralement pas l'intention de l'auteur. -</p> -<h3 id="Pourquoi_les_titres_sont-ils_importants" name="Pourquoi_les_titres_sont-ils_importants"> Pourquoi les titres sont-ils importants </h3> -<p>L'attribut <code>title</code> détermine la façon dont votre feuille de style externe s'applique à votre document. En fait, l'utilisation de l'attribut <code>title</code> est tellement significative que le HTML 4.01 classe les feuilles de style par catégorie selon sa présence ou son absence. En spécifiant un attribut <code>title</code>, vous pouvez décider si une feuille particulière affecte le document en permanence ou si elle est employée seulement dans certaines circonstances. </p><p>Il y a trois sortes de feuilles de style possibles : <i>permanente</i>, <i>par défaut</i> et <i>alternative</i>. Les auteurs sont surtout familiarisés avec les feuilles de style <i>permanentes</i>, qui peuvent s'appliquer simultanément en n'importe quel nombre à un document. Une feuille de style permanente n'a pas d'attribut <code>title</code> et son attribut <code>rel</code> a la valeur <code>stylesheet</code>. Un document peut se référer à une ou plusieurs feuilles de style permanentes, qui seront toutes utilisées pour sa présentation. </p><p>Une feuille de style <i>par défaut</i>, quant à elle, a un attribut <code>rel</code> doté de la valeur <code>stylesheet</code> et un attribut <code>title</code> de n'importe quelle valeur. En voici deux exemples : </p> -<pre><link type="text/css" rel="stylesheet" title="Basic styles" href="basic.css" /> -<link type="text/css" rel="stylesheet" title="Fish and boats" href="ocean.css" /> -</pre> -<p>Selon la spécification HTML 4.01, seulement <b>une et une seule</b> feuille de style par défaut peut être utilisée à la fois. Dès lors, dans l'exemple ci-dessus, une seule des deux feuilles de style par défaut sera appliquée au document. La spécification ne fournit pas de procédure pour décider laquelle doit être utilisée ; les agents utilisateur sont donc libres de choisir. </p><p>Par conséquent, aucun <code>link</code> vers une feuille de style incluant un attribut <code>title</code> ne sera permanent. Il risque au contraire d'être ignoré par le navigateur. N'importe quel élément <code>link</code> se rapportant à une feuille de style avec un attribut <code>title</code> doit être <i>par défaut</i> ou <i>alternatif</i>, selon la valeur de l'attribut <code>rel</code>. </p><p>Dans un document qui propose des styles alternatifs, la feuille de style par défaut sera employée à condition qu'aucun des styles alternatifs ne soit choisi par l'utilisateur. Ainsi, quand le document est chargé, le navigateur emploiera tous les styles permanents et une des feuilles de style par défaut (mais attention, il ne peut y avoir qu'un seul style par défaut). Lorsque l'utilisateur choisit un des styles alternatifs, le style par défaut ne sera plus employé, bien que l'utilisateur puisse toujours le sélectionner à nouveau. </p><p>Le rôle essentiel des styles par défaut est d'indiquer le style de préférence pour l'affichage du document ; c'est-à-dire que c'est sa « présentation » par défaut. Si l'une ou l'autre des feuilles de style alternatives est choisie, alors le style par défaut est ignoré en faveur du style alternatif choisi par l'utilisateur. Ceci diffère donc des styles permanents qui sont toujours appliqués au document, qu'un style alternatif ait été choisi ou pas. -</p> -<h3 id="Recommandations" name="Recommandations"> Recommandations </h3> -<p>Les auteurs doivent s'assurer que chaque feuille de style qui doit toujours s'appliquer est permanente et non alternative. Pour citer la <a class="external" href="http://web.archive.org/web/20040405164311/http://www.w3.org/TR/HTML401/present/styles.html#h-14.3.1">Spécification HTML 4.01, section 14.3.1</a> : </p> -<blockquote> -<ul><li> Pour rendre une feuille de style permanente, il faut spécifier la valeur « stylesheet » pour l'attribut <code>rel</code> et ne pas spécifier d'attribut <code>title</code>. -</li><li> Pour rendre une feuille de style par défaut, il faut spécifier la valeur « stylesheet » pour l'attribut <code>rel</code> et spécifier un attribut <code>title</code>. -</li></ul> -</blockquote> -<h3 id="Liens" name="Liens"> Liens </h3> -<ul><li> <a class="external" href="http://www.w3.org/TR/html401/present/styles.html#h-14.3">HTML 4.01 Specification, section 14.3: External style sheets</a> -</li></ul> -<div class="originaldocinfo"> -<h3 id="Document_original" name="Document_original"> Document original </h3> -<ul><li> Auteur : Eric A. Meyer, <i>Netscape Communications</i> -</li><li> Publié le 30 déc. 2002 -</li><li> Copyright © 2001-2003 Netscape. -</li></ul> -</div> diff --git a/files/fr/archive/themes/create_your_own_firefox_background_theme/index.html b/files/fr/archive/themes/create_your_own_firefox_background_theme/index.html deleted file mode 100644 index fef2634185..0000000000 --- a/files/fr/archive/themes/create_your_own_firefox_background_theme/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Créez ta propre thème de arrière plan pour Firefox -slug: Archive/Themes/Create_Your_Own_Firefox_Background_Theme -translation_of: Archive/Themes/Create_Your_Own_Firefox_Background_Theme ---- -<h2 id="Comment_créer_ta_propre_thème_de_arrière-plan">Comment créer ta propre thème de arrière-plan</h2> - -<div class="primary auto" id="getting-started"> -<p>Les thèmes s'agissent d'une graphique "en-tête", qui style l'arrière-plan de l'IU de Firefox.</p> - -<p>Terminé votre conception? Vous pouvez <a href="https://addons.mozilla.org/developers/theme/submit">la soumettre tout de suite!</a></p> - -<h3 id="Créer_une_image_de_thème_d'en_tête">Créer une image de thème d'en tête</h3> - -<p>L'image d'en-tête image est affiché comme l'arrière plan en haut de la fenêtre de navigateur, derrière les barres d'outils, barre d'addresse, et la barre de recherche. Il sera <strong>fixé au coin haut à droit</strong> du fenêtre de navigateur.</p> - -<p class="screenshot"><img alt="" src="https://mdn.mozillademos.org/files/9929/header-step.jpg" style="height: 215px; width: 1059px;"></p> - -<ul> - <li><a href="https://addons.cdn.mozilla.net/static/img/docs/themes/header.jpg">Voir une échantillion d'une image d'en tête ici.</a></li> -</ul> - -<h4 id="Conditions_de_l'image">Conditions de l'image</h4> - -<ul> - <li>Dimensions devraient être <strong>3000px large × 200px haut</strong></li> - <li>Format PNG ou JPG</li> - <li>L'image ne devrait pas être plus grand que 300 KO en taille de fichier</li> -</ul> - -<h4 id="Conseils">Conseils</h4> - -<ul> - <li>Les images subtilles avec du contraste doux et des gradients marchent les meilleures; les images détaillés se batteraient avec l'IU du navigateur.</li> - <li>Firefox pourrait révéler plus du fond de l'image si un autre barre d'outil ou élément de l'IU est ajouté en haut de la fenêtre.</li> - <li>Le côté haut à droit de l'image devrait contenir les informations les plus importants —quand l'utilisateur augmente la largeur du fenêtre de navigateur, le navigateur affiche plus du gauche de l'image.</li> -</ul> - -<h4 id="Éditeurs_d'images_enlignes">Éditeurs d'images enlignes</h4> - -<ul> - <li><a href="http://www.pixlr.com">Pixlr</a> — Pixlr offere des outils professionels et faciles à utiliser pour créer ou modifier les images dans la navigateur.</li> - <li><a href="http://www.photoshop.com">Photoshop</a> — Ajuste, tourne et retouche les photos avec Photoshop® Express, une éditeur enligne gratuit.</li> -</ul> - -<h3 id="Créer_une_image_de_thème_de_bas_de_page">Créer une image de thème de bas de page</h3> - -<p>Dans les versions anciennes de Firefox, ou les versions neuves avec certains "add-ons" installés, l'image de bas de pas est affiché comme l'arrière plan du fond du fenêtre de navigateur, derrière la barre des "add-ons" et la barre de retrouver. Il sera fixé au coin fond à gauche du fenêtre de navigateur. L'image de bas de page est optionelle.</p> - -<p class="screenshot"><img alt="" src="https://mdn.mozillademos.org/files/9935/footer-step.jpg" style="height: 56px; width: 1249px;"></p> - -<ul> - <li><a href="https://addons.cdn.mozilla.net/static/img/docs/themes/header.jpg">Voir une échantillion d'une image de bas de page ici.</a></li> -</ul> - -<h4 id="Conditions_de_l'image_2">Conditions de l'image</h4> - -<ul> - <li>Dimensions devraient être <strong>3000px large × 100px haut</strong></li> - <li>Format PNG ou JPG</li> - <li>L'image ne devrait pas être plus grand que 300 KO en taille de fichier</li> -</ul> - -<h4 id="Conseils_2">Conseils</h4> - -<ul> - <li>Les images subtilles avec du contraste doux et gradients marchent les meilleures; les images détaillés se batteraient avec l'IU du navigateur.</li> - <li>Firefox pourrait révéler plus du haut de l'image si la barre de retrouver est ouverte ou une extension augmente l'hauteur au fond du fenêtre.</li> - <li>Le côté gauche de l'image devrait contenir les informations les plus importants —quand l'utilisateur augmente la largeur du fenêtre de navigateur, le navigateur affiche plus du droit de l'image.</li> -</ul> - -<h3 id="Soumettre_vos_images_de_thème">Soumettre vos images de thème</h3> - -<p>Pour commencer à soumettre vos images, aller au page Soumission de Thèmes:</p> - -<ol class="itemized"> - <li><strong>Nommez votre thème</strong> — choisissez un nom unique pour votre thème. Les noms doubles ne sont pas permis, donc vous pourriez devoir essayer quelque fois pour trouver un nom unique.</li> - <li><strong>Choisissez une catégorie et des étiquettes</strong> — selectionnez une catégorie et saisissez des étiquettes qui décrivent votre thème. Gardez en tête qu'un réviseur pourrait réjeter votre thème si il est évident que la catégorie ou les étiquettes ne sont pas liés à votre thème.</li> - <li><strong>Décrirez votre thème</strong> — écrivez une déscription courte de votre thème. Gardez en tête qu'un réviseur pourrait réjeter votre thème si votre déscription ne répresente pas votre thème.</li> - <li><strong>Choisissez une license pour ton thème</strong> — décidez d'un type de license de copyright pour votre thème <a href="http://creativecommons.org/licenses/">Lire plus sur les types de licenses "Creative Common"</a> - <ul> - <li><strong>Important:</strong> Soyez certain que vous avez le droit d'utiliser l'image dans votre thème!</li> - </ul> - </li> - <li><strong>Mettrez vos images en ligne</strong> — soyez certain qu'ils ne sont pas plus grands que 300 KO, et sont en format JPG ou PNG!</li> - <li><strong>Selectionnez des couleurs pour la texte et les onglets</strong> — vous pouvez choisir la couleur pour la texte et l'arrière plan des onglets qui fonctionnent la meilleure avec votre image de thème en tête.</li> - <li><strong>Voir en avant-première votre thème</strong> — vous êtes prèt pour en avant-première votre thème! Simplement passez la souris au dessous de l'image en haut du bouton Submit Theme pour voir à quoi ça ressemble.</li> - <li><strong>Soumettrez votre thème</strong> — si tout a l'air correct, cliquez la bouton Submit Theme et vous avec terminé! Vous pouvez voir tous vos thèmes sur ta page de profil. - <ul> - <li><strong>Conseil:</strong> pour t'asssurer que votre thème a été approuvé pour la galerie, soyez certain qu'il obtempère avec les directives de contenu et les conditions de service!</li> - </ul> - </li> -</ol> - -<p class="screenshot"><img alt="" src="https://mdn.mozillademos.org/files/9933/submission-step.jpg" style="height: 1800px; width: 785px;"></p> - -<p class="call-to-submit"><a class="button prominent" href="https://addons.mozilla.org/en-US/developers/theme/submit">Soumettrez votre thème maintenant</a></p> - -<h2 class="call-to-submit" id="Plus_de_tutoriels">Plus de tutoriels</h2> - -<p><a href="http://vanillaorchidstutorials.blogspot.com/2015/11/mozilla-themes-focal-point-sizing.html">Mozilla Themes Focal Point on Sizing</a> - A tutorial on theming with a focus on sizing, by VanillaOrchids.</p> -</div> diff --git a/files/fr/archive/themes/creer_un_theme/index.html b/files/fr/archive/themes/creer_un_theme/index.html deleted file mode 100644 index fafa4f1803..0000000000 --- a/files/fr/archive/themes/creer_un_theme/index.html +++ /dev/null @@ -1,268 +0,0 @@ ---- -title: Créer un thème -slug: Archive/Themes/Creer_un_theme -translation_of: Archive/Themes/Building_a_Theme ---- -<h4 class="editable" id="Introduction"><span>Introduction</span></h4> - -<p>Ce tutoriel va vous mener à travers les étapes requises pour construire un <a class="internal" href="/Add-ons/Themes" title="en/Themes">thème</a> très basique qui va modifier la couleur de fond des barres d'outils dans Firefox.</p> - -<div class="note"> -<p><strong>Note :</strong> Ce tutoriel concerne la création de thèmes pour Firefox 29 et supérieur. D'autres tutoriels existent pour créer des thèmes destinés aux versions antérieurs de Firefox. Pour un ancien tutoriel, voir <a class="internal" href="/docs/Creating_a_Skin_for_Firefox_Getting_Started" title="en/Creating a Skin for Firefox//Getting Started">Créer un thème pour Firefox</a>.</p> -</div> - -<div id="section_2"> -<div class="blockIndicator warning"> -<p class="editable"><strong>Note :</strong> FireFox pour Mac OS X utilise des répertoires qui ont été déplacés, ce qui peut rendre ce guide obsolète.</p> -</div> - -<h4 class="editable" id="Mettre_en_place_l'environement_de_développement"><span>Mettre en place l'environement de développement</span></h4> - -<p>Les thèmes et extensions sont empaquetés et distribués dans des fichiers ZIP ou <a href="/docs/Bundles" rel="internal">Paquets</a>, avec l'extension de fichier <code>XPI</code> (<em>prononcé “zippy”</em>).</p> - -<p>Un exemple du contenu d'un fichier XPI typique d'un thème:</p> - -<pre class="eval">example.xpi: - /<a href="/Add-ons/Install_Manifests" rel="internal">install.rdf</a> - /<a href="/docs/Chrome_Registration" rel="internal">chrome.manifest</a> - /preview.png - /icon.png - /chrome/ - browser/ - communicator/ - global/ - mozapps/ - -</pre> - -<p>Nous souhaitons créer une structure de fichier similaire à celle présentée ci-dessus pour notre tutoriel, donc commençons par créer un dossier pour votre thème quelque part sur votre disque dur (ex. : <code>C:\themes\mon_theme\</code> ou <code>~/themes/mon_theme/</code>). Dans votre nouveau dossier de thème, créez deux nouveaux fichiers texte vides, l'un nommé <code>chrome.manifest</code> et l'autre appelé <code>install.rdf</code>. Le fichier <code>preview.png</code> est montré comme une prévisulaisation du thème dans le paneau des thèmes de la fenêtre des modules complémentaires. Le fichier <code>icon.png</code> est utilisé comme une icône dans le même panneau. Nous les laisserons de côté pour l'instant, sauf si vous disposez déjà d'éléments graphiques que vous souhaitez utiliser.</p> - -<p>Les répertoires restants seront extraits depuis le thème par défaut. Pour commencer, vous devrez créer un répertoire quelque part. <strong>Copiez</strong> votre fichier <code>omni.ja</code> d'installation Firefox dans ce répertoire. La localisation diffère suivant le système d'exploitation :</p> - -<p><strong>Linux:</strong> <code>/usr/lib/MozillaFirefox/chrome/classic.jar</code> <em>ou</em> <code>/usr/lib/firefox-*.*.*/omni.ja</code></p> - -<p><strong>Windows:</strong> <code>\Program Files\Mozilla Firefox\omni.ja</code></p> - -<p><strong>Mac OS X: </strong><code>/Applications/Firefox.app/Contents/MacOS/omni.ja</code></p> - -<p>Maintenant, ouvrez (ou extrayez) ce fichier dans le répertoire que vous avez créé. Il contient plusieurs dossiers, <code>modules</code>, <code>jssubloader</code> et autres. Les fichiers dont vous aurez besoin sont situés dans le dossier <code>chrome\toolkit\skin\classic</code>.</p> - -<p>Créez un dossier nommé <code>chrome</code> dans le dossier de votre thème. Ensuite, le contenu des répertoires suivants dans leurs dossiers respectifs de ce dossier.</p> - -<ol> - <li><code>global</code> dans <code>chrome/global</code></li> - <li><code>mozapps</code> dans <code>chrome/mozapps</code></li> -</ol> - -<p>À présent que vous avez copié les dossiers <code>global</code> et <code>mozapps</code>, une poignée d'autres dossiers de l'archive <code>browser/omni.ja</code> sont requis. Ils sont situés dans le dossier du navigateur à l'emplacement mentionné ci-dessus. Les fichiers dont nous aurons besoins dans l'archive browser/omni.ja sont situés dans <code>chrome/browser/skin/classic</code>.</p> - -<p>Copiez les contenus des répertoires suivants dans leurs dossiers respectifs. Ceci nous donnera une base de style avec laquelle nous allons commencer à travailler.</p> - -<ol> - <li><code>browser</code> dans <code>chrome/browser/</code></li> - <li><code>communicator</code> dans <code>chrome/communicator/</code></li> -</ol> - -<p>La structure de vos répertoires doit être comme suit :</p> - -<pre><ext path>/ - /install.rdf - /chrome.manifest - /chrome/ - browser/ - communicator/ - global/ - mozapps/ -</pre> - -<p>Après ces étapes, nous vous recommandons de lire l'article <a href="/Add-ons/Setting_up_extension_development_environment" rel="internal">Setting up extension development environment</a> et les indications qui y sont données. En particulier, vous devrez installer le <a class="internal" href="/en/DOM_Inspector" title="en/DOM Inspector">DOM Inspector</a>, que nous utiliserons dans les étapes suivantes</p> -</div> - -<div id="section_3"> -<h4 class="editable" id="Création_du_Manifeste_d'Installation_(Install_Manifest)">Création du Manifeste d'Installation (<em>Install Manifest</em>)<span> </span></h4> - -<p>Ouvrez le fichier nommé <code><a href="/Add-ons/Install_Manifests" rel="internal">install.rdf</a> </code>que vous avez créé en haut de la hierarchie de votre répertoire d'extention et ajoutez-y le contenu suivant :</p> - -<pre class="eval"><?xml version="1.0"?> - -<RDF xmlns="<a class="external" href="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rel="freelink">http://www.w3.org/1999/02/22-rdf-syntax-ns#</a>" - xmlns:em="<a class="external" href="http://www.mozilla.org/2004/em-rdf#" rel="freelink">http://www.mozilla.org/2004/em-rdf#</a>"> - - <Description about="urn:mozilla:install-manifest"> - <em:id><strong><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></strong></em:id> - <em:version><strong>1.0</strong></em:version> - <em:type><strong>4</strong></em:type> - - <!-- Target Application this theme can install into, - with minimum and maximum supported versions. --> - <em:targetApplication> - <Description> - <em:id><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong></em:id> - <em:minVersion><strong>29.0</strong></em:minVersion> - <em:maxVersion>32<strong>.*</strong></em:maxVersion> - </Description> - </em:targetApplication> - - <!-- Front End MetaData --> - <em:name><strong>My Theme</strong></em:name> - <em:internalName><strong>sample</strong></em:internalName> - <em:description><strong>A test extension</strong></em:description> - <em:creator><strong>Your Name Here</strong></em:creator> - <em:homepageURL><strong><a class="external" href="http://www.example.com/" rel="freelink">http://www.example.com/</a></strong></em:homepageURL> - </Description> -</RDF> -</pre> - -<ul> - <li><strong><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></strong> - c'est l'ID de l'extension. Il s'agit d'un nom de votre choix qui permet d'identifier votre extension sous la forme d'une adresse courriel (notez que ce n'est pas <em>votre</em> adresse personnelle). Créez un nom unique. Vous pouvez vous aider d'un GUID. NOTE : ce paramètre DOIT être au format d'une adresse courriel, même si elle n'a PAS à être authentique et valide. (exemple.exemple.exemple)</li> - <li><strong>4</strong> - le type de l'add-on. '4' informe qu'il s'agit de l'installation d'un thème. Si vous souhaitiez installer une extension ce serait 2 (voir <a href="/Add-ons/Install_Manifests#type" rel="internal">Install Manifests#type</a> pour les autres types de codes).</li> - <li><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong> - ID d'application de Firefox.</li> - <li><strong>29.0</strong> - Le numéro de la version exacte à partir de laquelle votre extension fonctionne. N'utilisez jamais une asterisque * dans minVersion, cela ne fera pas ce à quoi vous vous attendez.</li> - <li><strong>32.*</strong> - La version la plus récente de Firefox avec laquelle votre extension va fonctionner. Ne pas définir à une version plus récente que celle actuellement disponible ! Dans ce cas, "32.*" indique que l'extension fonctionne avec Firefox 32 et toutes les sous-version 32.x. Les thèmes sont compatibles par défaut, tant que vous ne définissez pas un mode de compatiblité stricte pour votre thème.</li> -</ul> - -<p>Si vous obtenez un message qui vous informe que install.rdf est mal formé, il est utile de le charger dans Firefox en utilisant la commande Fichier->Ouvrir un fichier et il vous rapportera les erreurs XML.</p> - -<p>Voir <a href="/Add-ons/Install_Manifests" rel="internal">Install Manifests</a> pour une liste complète des propriétés requises et optionelles.</p> - -<p>Sauvegardez le fichier.</p> -</div> - -<div id="section_4"> -<h4 class="editable" id="Styliser_l'interface_du_navigateur_avec_CSS">Styliser l'interface du navigateur avec CSS</h4> - -<p>L'interface utilisateur de Firefox est écrite en XUL et JavaScript. <a href="/docs/Mozilla/Tech/XUL" rel="internal">XUL</a> est une grammaire XML qui fournit des modules d'interface utilisateur comme les boutons, menus, barres d'outils, arbres, etc. Les actions utilisateur possèdent leurs fonctionnalités en utilisant du JavaScript. Ces éléments XUL sont stylisés en utilisant du <a class="internal" href="/en/CSS" title="en/CSS">CSS</a>. Si vous ne connaissez pas le CSS, ce sera une pente abrupte de votre apprentissage, et vous devriez essayer des tutoriels basés sur le HTML pour commencer.</p> - -<p>L'interface utilisateur du navigateur n'a absolument aucun style de base - si vous essayez de commencer avec un thème vide, Firefox deviendra inutilisable, car les boutons seront uniquement du texte. C'est pourquoi nous avons copié le style par défaut dans l'étape d'organisation.</p> - -<p>Lors de l'écriture d'un thème, la manière la plus simple de déterminer quels selecteurs CSS vous avez besoin d'écrire est d'utiliser l'inspecteur DOM que vous devriez avoir installé à l'étape d'organisation. Vous pouvez utiliser cela pour inspecter n'importe quel élément dans une page web ou un document XUL, ce qui en fait quelque chose d'important pour les thèmes.</p> - -<h4 class="editable" id="Modifier_le_style_de_la_barre_d'outils">Modifier le style de la barre d'outils</h4> - -<div class="note"> -<p><strong>Note</strong> Dans Firefox 4.0 et supérieur, l'option de surlignement de l'inspecteur DOM ne fonctionne plus. Pour contourner ça, désactivez l'accélération matérielle dans les options de Firefox.</p> -</div> - -<p>Ouvrez maintenant l'inspecteur DOM (Dans le menu "Outils") et allez dans "Fichier->Inspecter le document chrome". Ce devrait être un menu contenant tous les documents XUL actuellement ouverts dans Firefox.<br> - Prenez le premier document avec un titre de page web, comme "Page de démarrage Firefox" et sélectionnez-le.</p> - -<p>Pour ce tutoriel, nous allons modifier la couleur de fond des barres d'outils. Sélectionnez l'outil de recherche de nœud (la case de la flèche pour en voir plus dans le coin en haut à gauche de l'inspecteur DOM) et cliquez dans n'importe quel espace non-utilisé d'une barre d'outils. Cela devrait sélectionner un nœud de type "xul:toolbar" dans l'inspecteur DOM.</p> - -<p>À partir d'ici, vous pouvez vous amuser avec différents styles pour la barre d'outils et les éléments associés. Par défaut, le panneau de droite devrait montrer le nœud DOM, qui possède des informations importantes comme la classe CSS et l'id de nœud. L'élément lui-même a le simple id <code>navigator-toolbox</code>, sans plus. Pour accorder son style avec notre thème, nous avons besoin d'écrire une règle de sélecteur pour sélectionner cette classe.</p> - -<p>Ouvrez le fichier <code>chrome/browser/browser.css</code> de votre thème. Cherchez dans ce fichier le sélecteur <code>#navigator-toolbox</code>, et ajoutez-lui cette règle<code> background: orange;</code></p> - -<p>Sauvegardez le fichier.</p> -</div> - -<div id="section_6"> -<h4 class="editable" id="Chrome_URIs"><span>Chrome URIs</span></h4> - -<p><span id="result_box" lang="fr"><span>Ensuite, nous devons dire à Firefox où trouver les fichiers de thème pour votre thème.</span> <span>CSS, XUL et autres fichiers font partie de</span></span> "<a href="/docs/Chrome_Registration" rel="internal">Chrome Packages</a>" - <span id="result_box" lang="fr"><span>des composants d'interface utilisateur qui sont chargés via</span></span> <code><a class="external" rel="external nofollow" title="chrome://">chrome://</a></code> URIs. <span id="result_box" lang="fr"><span>Plutôt que de charger le navigateur depuis le disque</span></span> <code><a class="external" rel="external nofollow" title="file://">file://</a></code> <span id="result_box" lang="fr"><span>URI (car l'emplacement de Firefox sur le système peut changer d'une plateforme à l'autre), les développeurs de Mozilla ont mis au point une solution de création d'URI pour le contenu de l'add-on.</span></span></p> - -<p><span class="short_text" id="result_box" lang="fr"><span>La fenêtre du navigateur est:</span></span> <code><a class="external" rel="external nofollow" title="chrome://browser/content/browser.xul">chrome://browser/content/browser.xul</a></code>. <span id="result_box" lang="fr"><span>Essayez de taper cette URL dans la barre d'adresse dans Firefox !</span><br> - <br> - <span>Les URI de Chrome se composent de plusieurs composants:</span></span></p> - -<ul> - <li><span id="result_box" lang="fr"><span>Tout d'abord, le schéma URI (chrome) qui indique à la bibliothèque réseau de Firefox qu'il s'agit d'un URI de Chrome.</span> <span>Il indique que le contenu de l'URI doit être traité comme un (chrome).</span> <span>Comparez (chrome) à (http) qui indique à Firefox de traiter l'URI comme une page Web.</span></span></li> - <li><span id="result_box" lang="fr"><span>Deuxièmement, un nom de paquet (dans l'exemple ci-dessus, <strong>navigateur</strong>) qui identifie le paquet de composants d'interface utilisateur.</span></span></li> - <li><span id="result_box" lang="fr"><span>Troisièmement, le type de données demandées.</span> <span>Il existe trois types: le contenu (XUL, JavaScript, les liaisons XBL, etc., qui forment la structure et le comportement d'une interface utilisateur d'application), les paramètres régionaux (DTD, .properties, etc., qui contiennent des chaînes pour les UI</span></span> <a href="/docs/Glossary/Localization" rel="internal">localization</a>), <span class="short_text" id="result_box" lang="fr"><span>et l'apparence (CSS et images qui forment le</span></span> <a href="/Add-ons/Themes" rel="internal">theme</a> de l'UI).</li> - <li><span class="short_text" id="result_box" lang="fr"><span>Enfin, le chemin d'accès d'un fichier à charger.</span></span></li> -</ul> - -<p>Alors, <code><a class="external" rel="external nofollow" title="chrome://foo/skin/bar.png">chrome://foo/skin/bar.png</a></code> <span id="result_box" lang="fr"><span>charge le fichier bar.png de la section skin du thème foo.</span></span></p> - -<p><span id="result_box" lang="fr"><span>Lorsque vous chargez du contenu à l'aide d'un URI Chrome, Firefox utilise le Registre Chrome pour traduire ces URI dans les fichiers source réels sur le disque (ou dans les packages JAR).</span></span></p> -</div> - -<div id="section_7"> -<h4 class="editable" id="Creer_un_Chrome_Manifest"><span>Creer un Chrome Manifest</span></h4> - -<p><span id="result_box" lang="fr"><span>Le manifeste Chrome est le fichier qui mappe ces URI Chrome vers les fichiers de votre thème.</span> <span>Pour plus d'informations sur les Manifestes Google Chrome et les propriétés qu'ils prennent en charge,</span></span> <a href="/docs/Chrome_Registration" rel="internal">Chrome Manifest</a> reference.</p> - -<p><span id="result_box" lang="fr"><span>Ouvrez le fichier chrome.manifest que vous avez créé à côté du répertoire chrome à la racine de la hiérarchie des dossiers source de votre extension.</span><br> - <br> - <span>Ajouter dans ce code:</span></span></p> - -<pre class="eval">skin browser sample chrome/browser/ -skin communicator sample chrome/communicator/ -skin global sample chrome/global/ -skin mozapps sample chrome/mozapps/ -</pre> - -<p><span id="result_box" lang="fr"><span>N'oubliez pas la barre oblique, "/" !</span> <span>Sans elle, le paquet ne sera pas enregistré.</span> <span>La troisième colonne doit correspondre à la valeur Nom interne de votre thème à partir du manifeste d'installation ci-dessus.</span></span></p> - -<p><span id="result_box" lang="fr"><span>Cela liste les répertoires de l'apparence dans les emplacements de votre thème.</span> <span>Par exemple, le skin de l'explorateur de skin de ligne / navigateur / signifie "lorsque l'utilisateur a sélectionné l'exemple de thème sélectionné, utilisez le navigateur d'annuaire / pour rechercher des skins pour le package de navigateur".</span> <span>Plus concisément, cela signifie que l'URL</span></span> <a class="external" title="chrome://browser/skin/some/path/file.css">chrome://browser/skin/some/path/file.css</a> <span id="result_box" lang="fr"><span>recherchera un navigateur de fichiers / some / path / file.css dans le répertoire racine de votre thème.</span></span></p> - -<p>Enregistrer le fichier.</p> -</div> - -<div id="section_9"> -<h4 class="editable" id="Test"><span>Test</span></h4> - -<p><span id="result_box" lang="fr"><span>Tout d'abord, nous devons informer Firefox de l'existence de votre thème.</span> <span>Depuis Firefox 2.0 et supérieur, a</span></span><span lang="fr"><span>u cours de la phase de développement , vous pouvez faire pointer Firefox vers le dossier où vous développez le thème et le charger à chaque redémarrage de Firefox.</span></span></p> - -<ol> - <li>Localisez votre <a class="external" href="http://kb.mozillazine.org/Profile_folder" rel="external nofollow" title="http://kb.mozillazine.org/Profile_folder">dossier de prifil</a> <span id="result_box" lang="fr"><span>et en dessous le profil avec lequel vous souhaitez travailler</span></span> (e.g. <code>Firefox/Profiles/<profile_id>.default/</code>).</li> - <li><code>Ouvrez l'extension /</code> folder, en le créant, si nécessaire.</li> - <li><span id="result_box" lang="fr"><span>Créez un nouveau fichier texte et placez le chemin d'accès complet à votre dossier de développement à l'intérieur</span></span> (e.g. <code>C:\themes\my_theme\</code> or <code>~/themes/my_theme/)</code>. <span id="result_box" lang="fr"><span>Les utilisateurs de Windows doivent conserver la direction du slash du système d'exploitation, et tout le monde devrait se rappeler d'<strong>inclure</strong> une barre oblique de fermeture et de <strong>supprimer</strong> les espaces à la fin.</span></span></li> - <li><span id="result_box" lang="fr"><span>Enregistrer le fichier avec l'ID de votre thème comme son nom</span></span> (e.g. <code><a class="link-mailto" href="mailto:sample@example.net" rel="external nofollow" title="mailto:sample@example.net">sample@example.net</a></code>). <span class="short_text" id="result_box" lang="fr"><span>Pas d'extension de fichier.</span></span></li> -</ol> - -<p><span id="result_box" lang="fr"><span>Maintenant, vous devriez être prêt à tester votre thème !</span><br> - <br> - <span>Démarrez Firefox.</span> <span>Firefox détecte le lien texte vers votre répertoire de thèmes et installe le thème.</span> <span>Votre thème ne sera pas actif la première fois que vous l'installez, et vous devrez cliquer sur "Activer" et redémarrer avant de pouvoir voir votre changement.</span> <span>Après avoir redémarré cette deuxième fois, vous devriez voir que la couleur d'arrière-plan des barres d'outils s'affiche maintenant en orange.</span></span></p> - -<p><span id="result_box" lang="fr"><span>Vous pouvez maintenant revenir en arrière et apporter des modifications supplémentaires à vos fichiers css, fermer et redémarrer Firefox, et voir les mises à jour.</span></span></p> -</div> - -<div id="section_10"> -<h4 class="editable" id="Package"><span>Package</span></h4> - -<p><span class="short_text" id="result_box" lang="fr"><span>Maintenant que votre thème fonctionne, vous pouvez</span></span> créer un <a href="/Add-ons/Extension_Packaging" rel="internal">package</a> <span class="short_text" id="result_box" lang="fr"><span>pour le déploiement et l'installation.</span></span></p> - -<p><span id="result_box" lang="fr"><span>Zip le contenu du dossier de votre thème (pas le dossier thème lui-même), et renommez le fichier zip pour avoir une extension .xpi.</span> <span>Dans Windows, vous pouvez le faire facilement en sélectionnant tous les fichiers et sous-dossiers dans votre dossier d'extension, faites un clic droit et choisissez "Envoyer vers -> Dossier compressé (zippé)".</span> <span>Un fichier .zip sera créé pour vous.</span> <span>Il suffit de renommer et vous avez terminé!</span></span></p> - -<p><span id="result_box" lang="fr"><span>Sur Mac OS ou Linux, vous pouvez utiliser l'outil zip de ligne de commande:</span></span></p> - -<pre class="eval">zip -r my_theme.xpi install.rdf chrome.manifest browser communicator global mozapps -</pre> - -<p><span id="result_box" lang="fr"><span>Ou, si vous avez 7-Zip installé, vous pouvez l'utiliser pour le zipper ceci:</span></span></p> - -<pre class="eval">7z a -tzip my_theme.xpi chrome chrome.manifest -</pre> - -<p><span id="result_box" lang="fr"><span>Remarque: L'outil en ligne de commande met à jour un fichier zip existant et ne le remplace pas - donc si vous avez supprimé des fichiers de votre thème, supprimez le fichier .xpi avant de lancer la commande zip.</span></span></p> - -<p><span id="result_box" lang="fr"><span>Maintenant, téléchargez le fichier .xpi sur votre serveur, en vous assurant qu'il est servi en tant qu'application / x-xpinstall.</span> <span>Vous pouvez y accéder et permettre aux utilisateurs de le télécharger et de l'installer.</span> <span>Afin de tester notre fichier .xpi, nous pouvons simplement le glisser dans le Gestionnaire de compléments via "Outils -> Gestionnaire de compléments", ou l'ouvrir en utilisant "Fichier -> Ouvrir fichier ...".</span></span></p> - -<div id="section_11"> -<h5 class="editable" id="Installation_à_partir_d'une_page_web"><span>Installation à partir d'une page web</span></h5> - -<p><span id="result_box" lang="fr"><span>Il existe plusieurs façons d'installer des extensions à partir de pages Web, y compris le lien direct vers les fichiers XPI et l'utilisation de l'objet InstallTrigger.</span> <span>Les développeurs Web ou d'add-ons devraient utiliser</span></span> <a href="/docs/Installing_Extensions_and_Themes_From_Web_Pages" rel="internal"> InstallTrigger method</a> <span id="result_box" lang="fr"><span>pour installer les XPIs, car il fournit la meilleure expérience aux utilisateurs.</span></span></p> -</div> - -<div id="section_12"> -<h5 class="editable" id="Utilisation_d'addons.mozilla.org"><span>Utilisation d'addons.mozilla.org</span></h5> - -<p><span id="result_box" lang="fr"><span>Mozilla Add-ons est un site de distribution où vous pouvez héberger votre thème gratuitement.</span> <span>Votre thème sera hébergé sur le réseau miroir de Mozilla pour garantir votre téléchargement même s'il devenait très populaire.</span> <span>Le site de Mozilla fournit également aux utilisateurs une installation plus facile et met automatiquement à disposition vos versions les plus récentes pour les utilisateurs de vos versions existantes lorsque vous les téléchargez.</span> <span>En outre, Mozilla Add-ons permet aux utilisateurs de commenter et de fournir des retours sur votre thème.</span> <span>Il est fortement recommandé d'utiliser <a href="https://addons.mozilla.org">Mozilla Add-ons</a> pour distribuer vos thèmes !</span></span></p> - -<p>Visitez <a class="external" href="https://addons.mozilla.org/developers/" rel="external nofollow" title="http://addons.mozilla.org/developers/">https://addons.mozilla.org/developers/</a> et créez votre compte pour proposer votre thème.</p> - -<p><em>Note:</em> <span id="result_box" lang="fr"><span>Votre thème sera transmis plus rapidement et plus téléchargé plus si vous en avez une bonne description et quelques captures d'écran.</span></span></p> -</div> -</div> - -<div id="section_21"> -<div id="section_23"> -<ul> - <li><a class="internal" href="/Add-ons/Themes" title="en/Themes">Themes</a></li> -</ul> - -<p>______________________________</p> -</div> -</div> - -<p> </p> diff --git a/files/fr/archive/themes/index.html b/files/fr/archive/themes/index.html deleted file mode 100644 index 3313a68599..0000000000 --- a/files/fr/archive/themes/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Themes -slug: Archive/Themes -tags: - - TopicStub -translation_of: Archive/Themes ---- -<p>Documentation thématique archivée.</p> - - - -<ul> - <li><a href="/en-US/docs/Archive/Themes/Building_a_Theme">Construire un thème</a></li> - <li><a href="/en-US/docs/Archive/Themes/Common_Firefox_theme_issues_and_solutions">Problèmes et solutions communs au thème Firefox</a></li> - <li><a href="/en-US/docs/Archive/Themes/Creating_a_Skin_for_Firefox">Créer un skin pour Firefox</a> - <ul> - <li><a href="/en-US/docs/Archive/Themes/Creating_a_Skin_for_Firefox/UUID">UUID</a></li> - <li><a href="/en-US/docs/Archive/Themes/Creating_a_Skin_for_Firefox/contents.rdf">contents.rdf</a></li> - <li><a href="/en-US/docs/Archive/Themes/Creating_a_Skin_for_Firefox/install.rdf">install.rdf</a></li> - </ul> - </li> - <li><a href="/en-US/docs/Archive/Themes/Making_sure_your_theme_works_with_RTL_locales">S'assurer que votre thème fonctionne avec les paramètres régionaux RTL</a></li> - <li><a href="/en-US/docs/Archive/Themes/Theme_changes_in_Firefox_2">Changements de thème dans Firefox 2</a></li> - <li><a href="/en-US/docs/Archive/Themes/Theme_changes_in_Firefox_3">Changements de thème dans Firefox 3</a></li> - <li><a href="/en-US/docs/Archive/Themes/Theme_changes_in_Firefox_3.5">Changements de thème dans Firefox 3.5</a></li> - <li><a href="/en-US/docs/Archive/Themes/Theme_changes_in_Firefox_4">Changements de thème dans Firefox 4</a></li> -</ul> diff --git a/files/fr/archive/web/css/display-inside/index.html b/files/fr/archive/web/css/display-inside/index.html deleted file mode 100644 index 7db4682eb8..0000000000 --- a/files/fr/archive/web/css/display-inside/index.html +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: display-inside -slug: Archive/Web/CSS/display-inside -tags: - - CSS - - Experimental - - NeedsLiveSample - - Reference - - Web -translation_of: Archive/Web/CSS/display-inside ---- -<div><section class="Quick_links" id="Quick_Links"><ol><li><strong><a href="/fr/docs/Web/CSS">CSS</a></strong></li><li><strong><a href="/fr/docs/Web/CSS/Reference">Référence CSS</a></strong></li></ol></section><div class="notice overheadIndicator experimental"> - <p><span title="This is an experimental API that should not be used in production code."><i class="icon-beaker"> </i></span> <strong>Cette fonction est expérimentale</strong><br>Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le <a href="#Browser_compatibility">tableau de compatibilité</a> pour les préfixes à utiliser selon les navigateurs.<br>Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.</p> -</div></div> - -<p>La propriété <strong><code>display-inside</code></strong> indique le type d'affichage (<em>display type</em>) intérieur généré par un élément, celui-ci indique la façon dont son contenu est organisé à l'intérieur de la boîte de l'élément.</p> - -<pre class="brush:css no-line-numbers">/* Valeurs avec un mot-clé */ -display-inside: auto; -display-inside: block; -display-inside: table; -display-inside: flex; -display-inside: grid; -display-inside: ruby; - -/* Valeurs globales */ -display-inside: inherit; -display-inside: initial; -display-inside: unset; -</pre> - -<p><span style="color: red;">Valeur introuvable dans la base de données</span></p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<p>Cette propriété est définie avec un des mots-clés définis ci-après.</p> - -<h3 id="Valeurs">Valeurs</h3> - -<dl> - <dt><code>auto</code></dt> - <dd>Si la valeur calculée de <a href="/fr/docs/Web/CSS/display-outside" title="La propriété display-outside définit le type d'affichage (display type) à l'extérieur de la boîte générée par un élément et indique la façon dont l'élément s'inscrit dans le contexte de formatage de l'élément parent."><code>display-outside</code></a> pour l'élément vaut <code>inline-level</code>, l'élément sera un élément en ligne (<em>inline</em>) et organisera son contenu comme du contenu en ligne (<em>inline</em>). Si la valeur calculée de <a href="/fr/docs/Web/CSS/display-outside" title="La propriété display-outside définit le type d'affichage (display type) à l'extérieur de la boîte générée par un élément et indique la façon dont l'élément s'inscrit dans le contexte de formatage de l'élément parent."><code>display-outside</code></a> pour l'élément est un type de disposition spécifique interne, l'élément agit normalement selon la valeur donnée par <a href="/fr/docs/Web/CSS/display-outside" title="La propriété display-outside définit le type d'affichage (display type) à l'extérieur de la boîte générée par un élément et indique la façon dont l'élément s'inscrit dans le contexte de formatage de l'élément parent."><code>display-outside</code></a>. Sinon, la valeur calculée est <code>block</code>.</dd> - <dt><code>block</code></dt> - <dd>L'élément organise son contenu avec une disposition en bloc.</dd> - <dt><code>table</code></dt> - <dd>L'élément organise son contenu avec une disposition en tableau.</dd> - <dt><code>flex</code></dt> - <dd>L'élément organise son contenu avec une disposition flexible.</dd> - <dt><code>grid</code></dt> - <dd>L'élément organise son contenu avec une disposition en grille.</dd> - <dt><code>ruby</code></dt> - <dd>L'élément organise son contenu avec une disposition ruby.</dd> -</dl> - -<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> - -<pre class="syntaxbox">La syntaxe n'a pas été trouvée !</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td><a class="external" href="https://drafts.csswg.org/css-display/#the-display-inside" hreflang="en" lang="en">CSS Display Module Level 3<br><small lang="fr">La définition de 'display-inside' dans cette spécification.</small></a></td> - <td><span class="spec-WD">Version de travail</span></td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p></p><p class="warning"><strong><a href="https://github.com/mdn/browser-compat-data">Nous convertissons les données de compatibilité dans un format JSON</a></strong>. - Ce tableau de compatibilité utilise encore l'ancien format - car nous n'avons pas encore converti les données qu'il contient. - <strong><a href="/fr/docs/MDN/Contribute/Structures/Compatibility_tables">Vous pouvez nous aider en contribuant !</a></strong></p> - -<div class="htab"> - <a id="AutoCompatibilityTable" name="AutoCompatibilityTable"></a> - <ul> - <li class="selected"><a>Ordinateur</a></li> - <li><a>Mobile</a></li> - </ul> -</div><p></p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support simple</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support simple</td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - <td><span style="color: #f00;">Pas de support</span></td> - </tr> - </tbody> -</table> -</div> - -<p> </p> diff --git a/files/fr/archive/web/css/display-outside/index.html b/files/fr/archive/web/css/display-outside/index.html deleted file mode 100644 index 276a7d9a04..0000000000 --- a/files/fr/archive/web/css/display-outside/index.html +++ /dev/null @@ -1,145 +0,0 @@ ---- -title: display-outside -slug: Archive/Web/CSS/display-outside -tags: - - CSS - - Experimental - - Propriété - - Reference - - Web -translation_of: Archive/Web/CSS/display-outside ---- -<div>{{CSSRef}}{{SeeCompatTable}}</div> - -<p>La propriété <strong><code>display-outside</code></strong> définit le type d'affichage (<em>display type</em>) à l'extérieur de la boîte générée par un élément et indique la façon dont l'élément s'inscrit dans le contexte de formatage de l'élément parent.</p> - -<pre class="brush: css no-line-numbers">/* Valeurs avec un mot-clé */ -display-outside: block-level; -display-outside: inline-level; -display-outside: run-in; -display-outside: contents; -display-outside: none; -display-outside: table-row-group; -display-outside: table-header-group; -display-outside: table-footer-group; -display-outside: table-row; -display-outside: table-cell; -display-outside: table-column-group; -display-outside: table-column; -display-outside: table-caption; -display-outside: ruby-base; -display-outside: ruby-text; -display-outside: ruby-base-container; -display-outside: ruby-text-container; - -/* Valeurs globales */ -display-outside: inherit; -display-outside: initial; -display-outside: unset; -</pre> - -<p>{{cssinfo}}</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<p>Cette propriété est définie grâce à l'un des mots-clés définis ci-après.</p> - -<h3 id="Valeurs">Valeurs</h3> - -<dl> - <dt><code>block-level</code></dt> - <dd>L'élément génère une boîte en bloc (<em>block-level</em>) et s'inscrit dans un contexte de formatage en bloc. D'autres contextes de mise en forme (comme les contextes flexibles) peuvent fonctionner avec les éléments en bloc.</dd> - <dt><code>inline-level</code></dt> - <dd>L'élément génère une boîte de type <em>inline-level</em> et s'inscrit dans un contexte de mise en forme en ligne (<em>inline</em>).</dd> - <dt><code>run-in</code></dt> - <dd>L'élément génère une boîte de type <em>run-in</em>. Les éléments de ce type agissent comme des éléments en ligne ou comme des éléments en bloc selon les éléments qui les entourent.</dd> - <dt><code>contents</code></dt> - <dd>L'élément dispose son contenu grâce à la disposition flexible.</dd> - <dt><code>none</code></dt> - <dd>L'élément ne génère aucune boîte et ne s'inscrit dans aucun contexte de mise en forme.</dd> - <dt><code>table-row-group, table-header-group, table-footer-group, table-row, table-cell, table-column-group, table-column, table-caption</code></dt> - <dd>L'élément est un élément interne à un tableau et s'inscrit dans un contexte de mise en forme au sein d'un tableau.<br> - <br> - <code>table-cell</code> et <code>table-caption</code> sont des dispositions spécifiques de feuille (<em>leaf type</em>) et les autres sont des types de disposition spécifiques internes (cf. ci-après).</dd> - <dt><code>ruby-base, ruby-text, ruby-base-container, ruby-text-container</code></dt> - <dd>L'élément est un élément ruby interne et s'inscrit dans un contexte de disposition ruby.<br> - <br> - <code>ruby-base</code> et <code>ruby-text</code> sont des types de disposition de feuilles et <code>ruby-base-container</code> et <code>ruby-text-container</code> sont des types de disposition spécifiques internes (cf. ci-après).</dd> - <dt>Types de disposition spécifiques internes</dt> - <dd>Pour ces types d'affichage, il est nécessaire que l'élément parent et les éléments fils soient d'un type d'affichage particulier. Ainsi, pour une boîte <code>table-row</code>, il faudra que l'élément parent soit un groupe de ligne d'un tableau et il faudra que ses éléments fils soient des boîtes <code>table-cell</code>.</dd> - <dt>Types de disposition de feuille</dt> - <dd>Pour ces types d'affichage, il est nécessaire que l'élément parent soit d'un type d'affichage donné mais ils peuvent accepter n'importe quelle valeur pour <code>display-inside</code>. Ainsi, pour une boîte <code>table-caption</code>, il faut que le parent soit <code>table</code> mais l'élément peut établir n'importe quel type de contexte de mise en forme pour ses fils.</dd> -</dl> - -<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> - -<pre class="syntaxbox">{{csssyntax}}</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS3 Display', '#the-display-outside', 'display-outside')}}</td> - <td>{{Spec2('CSS3 Display')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support simple</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support simple</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/fr/archive/web/css/index.html b/files/fr/archive/web/css/index.html deleted file mode 100644 index 478bd56318..0000000000 --- a/files/fr/archive/web/css/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: CSS -slug: Archive/Web/CSS -translation_of: Archive/Web/CSS ---- -<div><div class="overheadIndicator obsolete obsoleteHeader"><p><strong><span title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> Obsolète</strong><br>Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.</p></div></div> - -<p class="summary">Obsolete CSS features</p> - -<p></p> diff --git a/files/fr/archive/web/index.html b/files/fr/archive/web/index.html deleted file mode 100644 index 9c217dd79e..0000000000 --- a/files/fr/archive/web/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Archived open Web documentation -slug: Archive/Web -tags: - - Archived - - TopicStub - - Web -translation_of: Archive/Web ---- -<p>La documentation répertoriée ci-dessous est un matériel archivé et obsolète sur des sujets Web ouverts..</p> - - - -<dl> - <dt class="landingPageList"><a href="/fr/docs/E4X">E4X</a></dt> - <dd class="landingPageList"><strong>ECMAScript pour XML</strong> (<strong>E4X</strong>) est une extension de langage de programmation ajoutant un support <a href="fr/XML">XML</a> natif à <a href="fr/JavaScript">JavaScript</a>. Cela se fait en fournissant un accès aux documents XML dans une forme qui semblera naturelle aux programmeurs ECMAScript. Son but est de proposer une syntaxe alternative et plus simple que les interfaces <a href="fr/DOM">DOM</a> pour accéder aux documents XML.</dd> - <dt class="landingPageList"><a href="/fr/docs/Navigateur_Identification_and_Aide_Multi_Navigateur">Identification de navigateur et aide sur multi-navigateurs</a></dt> - <dd class="landingPageList">Vous pouvez vous réferez à un article ultérieur <a href="/en/Web_development/Writing_forward-compatible_websites" title="Writing forward-compatible websites">Writing forward-compatible websites</a> pour trouver des informations plus récentes.</dd> -</dl> diff --git a/files/fr/archive/web/iterator/index.html b/files/fr/archive/web/iterator/index.html deleted file mode 100644 index 19e2c2142b..0000000000 --- a/files/fr/archive/web/iterator/index.html +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Iterator -slug: Archive/Web/Iterator -tags: - - JavaScript - - Legacy Iterator - - Reference -translation_of: Archive/Web/Iterator ---- -<div>{{jsSidebar("Objects")}}</div> - -<div class="warning"><strong>Non-standard.</strong> La fonction <code><strong>Iterator</strong></code> est une fonctionnalité propre à ECMAScript et sera retiré dans le futur. Pour utiliser des fonctions pérennes, préférer les boucles {{jsxref("Instructions/for...of")}} et le <a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_iterator">protocole itérateur</a>.</div> - -<p>La fonction <code><strong>Iterator</strong></code> renvoie un objet implémentant le protocole itérateur historique qui permet d'itérer sur les propriétés énumérables d'un objet.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox">Iterator(<var>objet</var>, [keyOnly])</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>objet</code></dt> - <dd>L'objet dont on souhaite itérer sur les propriétés.</dd> - <dt><code>keyOnly</code></dt> - <dd>Si <code>keyOnly</code> est une valeur équivalente à <code>true</code>, <code>Iterator.prototype.next</code> renverra uniquement <code>nom_propriété</code>.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>Cette fonction renvoie une instance d'<code>Iterator</code> qui permet d'itérer sur un objet. Pour chaque itération, l'instance renverra un tableau <code>[nom_propriété, valeur_propriété]</code> si <code>keyOnly</code> est équivalente à <code>false</code>. Sinon, chaque itération renverra uniquement <code>nom_propriété</code>. Si <code>objet</code> est une instance d'<code>Iterator</code> ou de <code>Generator</code>, la fonction renverra <code>objet</code>.</p> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt><code>Iterator.prototype[@@iterator]</code></dt> - <dd>Renvoie une fonction qui renvoie l'objet itérateur afin de respecter {{jsxref("Les_protocoles_iteration", "les protocoles d'itération", "", 1)}}.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<dl> - <dt><code><strong>Iterator.prototype.next</strong></code></dt> - <dd>Renvoie le prochain item élément au format <code>[nom_propriété, valeur_propriété]</code>. S'il n'y a plus d'éléments, l'exception {{jsxref("StopIteration")}} est levée.</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<h3 id="Itérer_sur_les_propriétés_d'un_objet">Itérer sur les propriétés d'un objet</h3> - -<pre class="brush: js">var a = { - x: 10, - y: 20, -}; -var iter = Iterator(a); -console.log(iter.next()); // ["x", 10] -console.log(iter.next()); // ["y", 20] -console.log(iter.next()); // renvoie StopIteration -</pre> - -<h3 id="Itérer_sur_les_propriétés_d'un_objet_avec_l'instruction_historique_for...in">Itérer sur les propriétés d'un objet avec l'instruction historique <code>for...in</code></h3> - -<pre class="brush: js">var a = { - x: 10, - y: 20, -}; - -for (var [nom, valeur] in Iterator(a)) { - console.log(nom, valeur); // x 10 - // y 20 -} -</pre> - -<h3 id="Itérer_grâce_à_for-of">Itérer grâce à <code>for-of</code></h3> - -<pre class="brush: js">var a = { - x: 10, - y: 20, -}; - -for (var [nom, valeur] of Iterator(a)) { - // @@iterator est utilisé - console.log(nom, valeur); // x 10 - // y 20 -} -</pre> - -<h3 id="Itérer_sur_les_noms_des_propriétés">Itérer sur les noms des propriétés</h3> - -<pre class="brush: js">var a = { - x: 10, - y: 20, -}; - -for (var nom in Iterator(a, true)) { - console.log(nom); // x - // y -} -</pre> - -<h3 id="Utiliser_une_instance_de_Generator">Utiliser une instance de <code>Generator</code></h3> - -<pre class="brush: js">function* f() { - yield "a"; - yield "b"; -} -var g = f(); - -console.log(g == Iterator(g)); // true - -for (var v in Iterator(g)) { - console.log(v); // a - // b -} -</pre> - -<h3 id="Utiliser_une_instance_d'Iterator">Utiliser une instance d'<code>Iterator</code></h3> - -<pre class="brush: js">var a = { - x: 10, - y: 20, -}; - -var i = Iterator(a); - -console.log(i == Iterator(i)); // true -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<p>Non-standard. Ne fait partie d'aucun standard.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Support simple</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Fonctionnalité</th> - <th>Android</th> - <th>Chrome pour Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Support simple</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs">Les itérateurs et générateurs</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/StopIteration">StopIteration</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/activexobject/index.html b/files/fr/archive/web/javascript/extensions_microsoft/activexobject/index.html deleted file mode 100644 index a76d841666..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/activexobject/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: ActiveXObject -slug: Archive/Web/JavaScript/Extensions_Microsoft/ActiveXObject -tags: - - Déprécié - - JavaScript - - Microsoft - - Non-standard - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/ActiveXObject ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cet objet est une extension Microsoft est uniquement pris en charge par Internet Explorer (pas pour Edge ou pour les applications Windows Store à partir de Windows 8).</div> - -<p>L'objet <strong><code>ActiveXObject</code></strong> active et renvoie une référence à un objet <code>Automation</code>. Cet objet est uniquement utilisé afin d'instancier des objets <code>Automation</code>, il ne possède pas de propriété.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: syntaxbox">let nouvelObj = new ActiveXObject(<em>nomServeur</em>.<em>nomType</em>[, <em>emplacement</em>]) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>nomServeur</code></dt> - <dd>Le nom de l'application qui fournit l'objet.</dd> - <dt><code>nomType</code></dt> - <dd>Le type ou la classe de l'objet à créer.</dd> - <dt><code>location</code> {{optional_inline}}</dt> - <dd>Le nom du serveur réseau où l'objet sera créé.</dd> -</dl> - -<h2 id="Notes">Notes</h2> - -<p>Les serveurs d'automatisation fournissent au moins un type d'objet. Une application de traitement de texte pourra par exemple fournir un objet d'application, un objet de document et un objet pour une barre d'outils.</p> - -<p>Il est possible d'identifier les différentes valeurs <code>nomServeur.nomType</code> d'un PC grâce à la clé de registre <code>HKEY_CLASSES_ROOT</code>. Voici quelques exemples de valeurs qui peuvent y être trouvées selon les programmes installés :</p> - -<ul> - <li> - <p><code>Excel.Application</code></p> - </li> - <li> - <p><code>Excel.Chart</code></p> - </li> - <li> - <p><code>Scripting.FileSystemObject</code></p> - </li> - <li> - <p><code>WScript.Shell</code></p> - </li> - <li> - <p><code>Word.Document</code></p> - </li> -</ul> - -<div class="warning"> -<p><strong>Attention !</strong> Les objets ActiveX peuvent présenter des risques de sécurité. Afin d'utiliser <code>ActiveXObject</code>, il est nécessaire d'ajuster le niveau de sécurité d'Internet Explorer dans les paramètres. Pour une utilisation sur un intranet, par exemple, il faudra modifier le réglage afin d'utiliser la valeur « Initialiser et scripter les contrôles ActiveX qui ne sont pas marqués comme sûrs ».</p> -</div> - -<p>Afin d'identifier les propriétés des objets obtenus et si aucune documentation de référence n'est disponible, il peut être nécessaire d'utiliser un explorateur d'objet COM (tel que <a href="https://msdn.microsoft.com/library/d0kh9f4c.aspx">l'explorateur d'objets OLE/COM</a>).</p> - -<p>Pour créer un objet <code>Automation</code>, il suffit d'affecter le résultat du constructeur à une variablee :</p> - -<pre class="brush: js">var ExcelApp = new ActiveXObject("Excel.Application"); -var ExcelSheet = new ActiveXObject("Excel.Sheet"); -</pre> - -<p>Ce code démarre l'application permettant de créer l'objet (ici Microsoft Excel). Une fois l'objet créé, on peut y faire référence dans le code en utilisant la variable. Dans l'exemple qui suit, on manipule la variable <code>ExcelSheet</code> afin d'accéder aux différentes propriétés et méthodes qui permettent de manipuler la feuille de calcul.</p> - -<pre class="brush: js">// Rendre Excel visible grâce à l'objet Application -ExcelSheet.Application.Visible = true; -// Écrire du texte dans la première cellule -ExcelSheet.ActiveSheet.Cells(1,1).Value = "Coucou"; -// Enregistrer le document -ExcelSheet.SaveAs("C:\\TEST.XLS"); -// Quitter Excel grâce à la méthode Quit de l'objet Application. -ExcelSheet.Application.Quit(); -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Fonctionnalité prise en charge sur les différents modes Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<div class="note"> -<p><strong>Note :</strong> La création d'un objet <code>ActiveXObject</code> sur un serveur distant n'est pas prise en charge pour Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard et pour les applications Windows Store ou les versions ultérieures.</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/GetObject">GetObject</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/at-cc-on/index.html b/files/fr/archive/web/javascript/extensions_microsoft/at-cc-on/index.html deleted file mode 100644 index f32b297a77..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/at-cc-on/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: '@cc_on' -slug: Archive/Web/JavaScript/Extensions_Microsoft/at-cc-on -tags: - - Instruction - - JavaScript - - Microsoft - - Non-standard - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/at-cc-on ---- -<div>{{JSRef}}{{Non-standard_header}}{{Obsolete_Header}}</div> - -<div class="warning"><strong>Attention !</strong> La compilation conditionnelle n'est plus prise en charge à partir d'Internet Explorer 11 en mode standard et pour les applications Windows Store à partir de Windows 8.</div> - -<p>L'instruction <code><strong>@cc_on</strong></code> active la compilation conditionnelle via des commentaires placés dans le script.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">@cc_on -</pre> - -<h3 id="Notes">Notes</h3> - -<p>Lors de l'écriture d'un script destiné au Web, il est nécessaire que les instructions de compilation conditionnelle soient placées dans des commentaires afin que les environnements qui ne les prennent pas en charge puissent les ignorer.</p> - -<p>Aussi, il est fortement recommandé d'utiliser <code>@cc_on</code> dans un commentaire afin que les autres navigateurs puissent considérer la syntaxe du script comme valide.</p> - -<p>Une instruction <code>@if</code> ou <code>@set</code> située à l'extérieur d'un commentaire permet également d'activer la compilation conditionnelle.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">/*@cc_on @*/ -/*@ - console.log("Version de JavaScript : " + @_jscript_version + "."); - @if (@_win32) - console.log("Version 32 bits de Windows."); - @elif (@_win16) - console.log("Version 16 bits de Windows."); - @else - console.log("Un autre système d'exploitation est utilisé."); - @end -@*/ -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette instruction est prise en charge par toutes les versions d'Internet Explorer mais ne peut pas être utilisée dans les applications pour Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-javascript">Compilation conditionnelle</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-variables-javascript">Variables de compilation conditionnelle</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-if">@if</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-set">@set</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/at-if/index.html b/files/fr/archive/web/javascript/extensions_microsoft/at-if/index.html deleted file mode 100644 index bf7c949e33..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/at-if/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: '@if' -slug: Archive/Web/JavaScript/Extensions_Microsoft/at-if -tags: - - JavaScript - - Microsoft - - Non-standard - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/at-if ---- -<div>{{JSRef}}{{Non-standard_header}}{{Obsolete_Header}}</div> - -<div class="warning"><strong>Attention !</strong> La compilation conditionnelle n'est plus prise en charge à partir d'Internet Explorer 11 en mode standard et pour les applications Windows Store à partir de Windows 8.</div> - -<p>L'instruction <code><strong>@if</strong></code> exécute un groupe d'instructions en fonction de la valeur d'une expression.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">@if ( - condition1 -) - texte1 -[@elif ( - condition2 -) - texte2] -[@else - texte3] -@end</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>texte1</code> {{optional_inline}}</dt> - <dd>Le texte à analyser si <code>condition1</code> est vérifiée.</dd> - <dt><code>texte2</code> {{optional_inline}}</dt> - <dd>Le texte à analyser si <code>condition1</code> est fausse et que <code>condition2</code> est vraie.</dd> - <dt><code>texte3</code> {{optional_inline}}</dt> - <dd>Le texte à analyser si <code>condition1</code> et <code>condition2</code> sont fausses.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>Lorsqu'on écrit une instruction <code>@if</code>, il n'est pas nécessaire de placer chaque clause sur une ligne séparée. Il est possible d'utiliser plusieurs clauses <code>@elif</code> mais celles-ci doivent nécessairement être présentes avant toute clause <code>@else</code>.</p> - -<p>L'instruction <code>@if</code> est généralement utilisée afin de déterminer quel code utiliser parmi plusieurs options.</p> - -<p>Lors de l'écriture d'un script destiné au Web, il est nécessaire que les instructions de compilation conditionnelle soient placées dans des commentaires afin que les environnements qui ne les prennent pas en charge puissent les ignorer.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">/*@cc_on @*/ -/*@ - console.log("Version de JavaScript : " + @_jscript_version + "."); - @if (@_win32) - console.log("Version 32 bits de Windows."); - @elif (@_win16) - console.log("Version 16 bits de Windows."); - @else - console.log("Un autre système d'exploitation est utilisé."); - @end -@*/ -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette instruction est prise en charge par toutes les versions d'Internet Explorer mais ne peut pas être utilisée dans les applications pour Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-javascript">Compilation conditionnelle</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-variables-javascript">Variables de compilation conditionnelle</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-cc-on">@cc_on</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-set">@set</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/at-set/index.html b/files/fr/archive/web/javascript/extensions_microsoft/at-set/index.html deleted file mode 100644 index dec4e007b9..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/at-set/index.html +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: '@set' -slug: Archive/Web/JavaScript/Extensions_Microsoft/at-set -tags: - - JavaScript - - Microsoft - - Non-standard - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/at-set ---- -<div>{{JSRef}}{{Non-standard_header}}{{Obsolete_Header}}</div> - -<div class="warning"><strong>Attention !</strong> La compilation conditionnelle n'est plus prise en charge à partir d'Internet Explorer 11 en mode standard et pour les applications Windows Store à partir de Windows 8.</div> - -<p>L'instruction <strong><code>@set</code> </strong>permet de créer des variables grâce à des instructions de compilation conditionnelles.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">@set @varname = term -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><em>varname</em></dt> - <dd>Un nom de variable JavaScript valide. Ce nom doit toujours être précédé d'une arobase (@).</dd> - <dt><code>term</code></dt> - <dd>Zéro ou plusieurs opérateurs unaires suivis par une constante, un variable de compilation conditionnelle ou une expression entre parenthèses.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>Les variables numériques et booléennes sont prises en charge pour la compilation conditionnelle. Il n'est pas possible d'utiliser des chaînes de caractères. Les variables créées grâce à <code>@set</code> sont généralement utilisées au sein d'instructions de compilation conditionnelle mais peuvent être utilisées n'importe où dans du code JavaScript.</p> - -<p>Voici quelques exemples :</p> - -<pre class="brush: js">@set @mavar1 = 12 - -@set @mavar2 = (@mavar1 * 20) - -@set @mavar3 = @_jscript_version -</pre> - -<p>Les opérateurs suivants peuvent être utilisés dans les expressions entre parenthèses :</p> - -<ul> - <li> - <p><code>! ~</code></p> - </li> - <li> - <p><code>* / %</code></p> - </li> - <li> - <p><code>+ -</code></p> - </li> - <li> - <p><code><< >> >>></code></p> - </li> - <li> - <p><code>< <= > >=</code></p> - </li> - <li> - <p><code>== != === !==</code></p> - </li> - <li> - <p><code>& ^ |</code></p> - </li> - <li> - <p><code>&& | |</code></p> - </li> -</ul> - -<p>Si une variable est utilisée avant d'avoir été définie, sa valeur par défaut sera <code>NaN</code>. Il est possible de vérifier si une variable vaut <code>NaN</code> grâce à une instruction <code>@if</code> :</p> - -<pre class="brush: js">@if (@nouvelleVar !== @nouvelleVar) - … -</pre> - -<p>Cette méthode fonctionne car <code>NaN</code> est la seule valeur qui n'est pas égale à elle-même au sens de l'égalité stricte.</p> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette instruction est prise en charge par toutes les versions d'Internet Explorer mais ne peut pas être utilisée dans les applications pour Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-javascript">Compilation conditionnelle</a></li> - <li><a href="https://docs.microsoft.com/en-us/scripting/javascript/advanced/conditional-compilation-variables-javascript">Variables de compilation conditionnelle</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-cc-on">@cc_on</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-if">@if</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/date.getvardate/index.html b/files/fr/archive/web/javascript/extensions_microsoft/date.getvardate/index.html deleted file mode 100644 index ea1fd3c8c2..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/date.getvardate/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Date.getVarDate -slug: Archive/Web/JavaScript/Extensions_Microsoft/Date.getVarDate -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Date.getVarDate ---- -<div>{{JSRef("Objets_globaux","Date")}}{{Non-standard_Header}}{{Obsolete_Header}}</div> - -<div class="warning"><strong>Non-standard. Ne doit pas être utilisé !</strong><br> -Cet objet est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <code><strong>getVarDate()</strong></code> renvoie une valeur <code>VT_DATE</code> à partir d'un objet {{jsxref("Date")}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre><code>dateObj.getVarDate() -</code></pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Une valeur de type <code>VT_DATE</code>.</p> - -<h3 id="Notes">Notes</h3> - -<p>La méthode <code>getVarDate()</code> est utilisée lorsque du code JavaScript interagit avec des objets COM, ActiveX ou d'autres objets qui utilisent des dates au format VT_DATE. Cela inclut les objets Visual Basic et VBScript. Le format définitif de la valeur renvoyé dépend des paramètres régionaux.</p> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Fonctionnalité prise en charge sur les différents modes Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li>{{jsxref("Date.getDate()")}}</li> - <li>{{jsxref("Date.parse()")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/debuggerenabled/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/debuggerenabled/index.html deleted file mode 100644 index f0db8375b9..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/debuggerenabled/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Debug.debuggerEnabled -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug/debuggerEnabled -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug/debuggerEnabled ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La propriété statique <strong><code>Debug.debuggerEnabled</code></strong> indique si le débogage est actif pour le contexte de script courant. Le débogage peut être activé ou désactivé qu'un débogueur soit attaché ou non.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>var dbgEnabled = Debug.debuggerEnabled;</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).<br> - Cette fonctionnalité n'est pas prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard et Internet Explorer 9 en mode standard.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/index.html deleted file mode 100644 index 94eaeffe88..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/index.html +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Debug -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug -tags: - - JavaScript - - Microsoft - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug ---- -<div>{{JSRef}}{{non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong><br> -L'objet <code>Debug</code> ne fonctionne qu'avec Internet Explorer et les applications Windows 8 et Windows Phone 8.1.</div> - -<p>L'objet <strong><code>Debug</code></strong> est un objet global qui permet d'envoyer des informations au débogueur.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<p>L'objet <code>Debug</code> n'est pas instancié, il fournit des propriétés et méthodes statiques.</p> - -<p>Différents outils permettent de déboguer les applications Internet Explorer et Windows 8.x Store. Pour les applications Windows 8.x Store, les méthodes statiques <code>write</code> et <code>writeln</code> fournies par <code>Debug</code> permettent d'afficher des chaînes de caractères dans le volet <em>Output</em> de Visual Studio lors de l'exécution.</p> - -<p>Pour déboguer des scripts Internet Explorer, il faut avoir un débogueur de script installé et le script exécuté en mode <em>debug</em>. Internet Explorer 8 et les versions ultérieures possèdent un débogueur JavaScript inégré.</p> - -<p>Si le script n'est pas en cours de débogage, les méthodes et propriétés de <code>Debug</code> n'auront pas d'effet.</p> - -<h2 id="Constantes">Constantes</h2> - -<h3 id="Codes_de_statut_pour_les_fonctions_de_rappel_asynchrones">Codes de statut pour les fonctions de rappel asynchrones</h3> - -<table> - <tbody> - <tr> - <th>Constante</th> - <th>Description</th> - <th>Valeur</th> - </tr> - <tr> - <td>Debug.MS_ASYNC_CALLBACK_STATUS_ASSIGN_DELEGATE</td> - <td>La tâche synchrone a affecté une fonction de rappel ou une continuation à exécuter dans une opération asynchrone.</td> - <td>0</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_CALLBACK_STATUS_JOIN</td> - <td>La tâche synchrone a rejoint une partie d'une opération asynchrone.</td> - <td>1</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_CALLBACK_STATUS_CHOOSEANY</td> - <td>La tâche synchrone a satisfait au choix d'une opération asynchrone.</td> - <td>2</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_CALLBACK_STATUS_CANCEL</td> - <td>La tâche synchrone a été annulée.</td> - <td>3</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_CALLBACK_STATUS_ERROR</td> - <td>La tâche synchrone a provoqué une erreur dans une opération asynchrone</td> - <td>4</td> - </tr> - </tbody> -</table> - -<h3 id="Codes_de_statut_pour_les_opérations_asynchrones">Codes de statut pour les opérations asynchrones</h3> - -<table> - <tbody> - <tr> - <th>Constante</th> - <th>Description</th> - <th>Valeur</th> - </tr> - <tr> - <td>Debug.MS_ASYNC_OP_STATUS_SUCCESS</td> - <td>L'opération asynchrone a réussi.</td> - <td>1</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_OP_STATUS_CANCELED</td> - <td>L'opération asynchrone a été annulée.</td> - <td>2</td> - </tr> - <tr> - <td>Debug.MS_ASYNC_OP_STATUS_ERROR</td> - <td>L'opération asynchrone a déclenché une erreur.</td> - <td>3</td> - </tr> - </tbody> -</table> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt><a href="/fr/docs/Web/JavaScript/Reference/Debug/debuggerEnabled"><code>Debug.debuggerEnabled</code></a></dt> - <dd>Cette propriété indique si le débogage est actif pour le contexte de script courant. Le débogage peut être actif ou non, qu'un débogueur soit attaché ou non.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Reference/Debug/setNonUserCodeExceptions"><code>Debug.setNonUserCodeExceptions</code></a></dt> - <dd>Cette propriété indique si certains blocs <code>try-catch</code> de la portée courante sont considérés par le débogueur comme étant gérés par l'utilisateur.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<dl> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/msTraceAsyncCallbackCompleted"><code>Debug.msTraceAsyncCallbackCompleted</code></a></dt> - <dd>Indique si la pile d'appel pour les fonctions de rappel associée a une opération asynchrone précédemment définie est terminée.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/msTraceAsyncCallbackStarting"><code>Debug.msTraceAsyncCallbackStarting</code></a></dt> - <dd>Associe une pile de fonction de rappel à l'opération asynchrone précédemment définie.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/msTraceAsyncOperationCompleted"><code>Debug.msTraceAsyncOperationCompleted</code></a></dt> - <dd>Indique qu'une opération asynchrone est terminée.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/msTraceAsyncOperationStarting"><code>Debug.msTraceAsyncOperationStarting </code></a></dt> - <dd>Initie une trace pour une opération asynchrone.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/msUpdateAsyncCallbackRelation"><code>Debug.msUpdateAsyncCallbackRelation</code></a></dt> - <dd>Met à jour la relation entre la tâche synchrone et l'opération asynchrone associée.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/write"><code>Debug.write</code></a></dt> - <dd>Envoie une chaîne de caractères au débogueur du script.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/writeln"><code>Debug.writeln</code></a></dt> - <dd>Envoie une chaîne de caractères au débogueur du script, cette chaîne sera suivie par un retour à la ligne.</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<h3 id="Afficher_la_valeur_dune_variable">Afficher la valeur d'une variable</h3> - -<p>Le fragment de code suivant permet d'afficher la valeur d'une variable lorsqu'on débogue le script grâce à la fonction <code>write</code>.</p> - -<pre class="brush:js">var compteur = 42; -Debug.write("Compteur vaut " + compteur);</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/debugger">debugger</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackcompleted/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackcompleted/index.html deleted file mode 100644 index a644fd8577..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackcompleted/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Debug.msTraceAsyncCallbackCompleted -slug: >- - Archive/Web/JavaScript/Extensions_Microsoft/Debug/msTraceAsyncCallbackCompleted -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: >- - Archive/Web/JavaScript/Microsoft_Extensions/Debug/msTraceAsyncCallbackCompleted ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Non-standard. Ne doit pas être utilisé !</strong><br> -Cet objet est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>Indique que la pile de rappels (<em>callback stack</em>) associée avec l'opération asynchrone précédemment indiquée est terminée.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackstarting/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackstarting/index.html deleted file mode 100644 index 928acaad56..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasynccallbackstarting/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Debug.msTraceAsyncCallbackStarting -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug/msTraceAsyncCallbackStarting -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug/msTraceAsyncCallbackStarting ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode statique <strong><code>Debug.msTraceAsyncCallbackStarting()</code></strong> permet d'associer une pile d'appel avec une opération asynchrone donnée.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.msTraceAsyncCallbackStarting(asyncOperationId)</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>asyncOperationId</code></dt> - <dd>Un identifiant d'une opération asynchrone (tel que renvoyé par <code>Debug.msTraceAsyncOperationStarting()</code>).</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>Cette fonction doit être appelée après l'appel à <code>Debug.msTraceAsyncOperationCompleted</code>.</p> - -<div class="note"> -<p><strong>Note : </strong>Certains outils de débogage n'affichent pas les informations envoyées au débogueur.</p> -</div> - -<p><code>asyncOperationId</code> doit correspondre à un identifiant d'une opération fourni par <code>Debug.msTraceAsyncOperationStarting()</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Le fragment de code suivant permet de tracer un appel asynchrone dans une application Windows 8.x Store.</p> - -<pre class="brush: js">function asyncWrapperFunction() { - var opID = Debug.msTraceAsyncOperationStarting('async trace'); - doSomethingAsync().then(function (result) { - Debug.msTraceAsyncOperationCompleted(opID, Debug.MS_ASYNC_OP_STATUS_SUCCESS); - Debug.msTraceAsyncCallbackStarting(opID); - // Traiter le résultat de l'opération asynchrone. - }, function (error) { - Debug.msTraceAsyncOperationCompleted(opID, Debug.MS_ASYNC_OP_STATUS_ERROR); - Debug.msTraceAsyncCallbackStarting(opID); - }); - Debug.msTraceAsyncCallbackCompleted(); -} - -function doSomethingAsync() { - return WinJS.Promise.as(true); -} - -asyncWrapperFunction(); -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par le mode standard d'Internet Explorer 11 et par les applications Store (Windows 8.1 et Windows Phone 8.1).<br> - Elle n'est pas prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard. Elle n'est pas non plus prise en charge par Windows 8.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationcompleted/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationcompleted/index.html deleted file mode 100644 index 2a9c69ac01..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationcompleted/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Debug.msTraceAsyncOperationCompleted -slug: >- - Archive/Web/JavaScript/Extensions_Microsoft/Debug/msTraceAsyncOperationCompleted -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: >- - Archive/Web/JavaScript/Microsoft_Extensions/Debug/msTraceAsyncOperationCompleted ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode statique <strong><code>Debug.msTraceAsyncCallbackCompleted()</code></strong> indique si une opération asynchrone est terminée.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.msTraceAsyncCallbackCompleted(asyncOperationId[, status]) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>asyncOperationId</code></dt> - <dd>L'identifiant associé à l'opération asynchrone.</dd> - <dt><code>status</code> {{optional_inline}}</dt> - <dd>Le statut de l'opération asynchrone. Si cet argument n'est pas indiqué, c'est la constante <code>Debug.MS_ASYNC_OP_STATUS_SUCCESS</code> qui sera utilisée.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p><code>asyncOperationId</code> doit correspondre à un identifiant d'une opération fourni par <code>Debug.msTraceAsyncOperationStarting()</code>.</p> - -<p>Les valeurs qui peuvent être utilisées pour l'argument <code>status</code> sont :</p> - -<ul> - <li> - <p><code>Debug.MS_ASYNC_OP_STATUS_SUCCESS</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_OP_STATUS_CANCELED</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_OP_STATUS_ERROR</code></p> - </li> -</ul> - -<div class="note"> -<p><strong>Note : </strong>Certains outils de débogage n'affichent pas les informations envoyées au débogueur.</p> -</div> - -<h2 id="Exemples">Exemples</h2> - -<p>Le fragment de code suivant permet de tracer un appel asynchrone dans une application Windows 8.x Store.</p> - -<pre class="brush: js">function asyncWrapperFunction() { - var opID = Debug.msTraceAsyncOperationStarting('async trace'); - doSomethingAsync().then(function (result) { - Debug.msTraceAsyncOperationCompleted(opID, Debug.MS_ASYNC_OP_STATUS_SUCCESS); - Debug.msTraceAsyncCallbackStarting(opID); - // Traiter le résultat de l'opération asynchrone. - }, function (error) { - Debug.msTraceAsyncOperationCompleted(opID, Debug.MS_ASYNC_OP_STATUS_ERROR); - Debug.msTraceAsyncCallbackStarting(opID); - }); - Debug.msTraceAsyncCallbackCompleted(); -} - -function doSomethingAsync() { - return WinJS.Promise.as(true); -} - -asyncWrapperFunction(); -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par le mode standard d'Internet Explorer 11 et par les applications Store (Windows 8.1 et Windows Phone 8.1).<br> - Elle n'est pas prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard. Elle n'est pas non plus prise en charge par Windows 8.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationstarting/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationstarting/index.html deleted file mode 100644 index 954900a7d8..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/mstraceasyncoperationstarting/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Debug.msTraceAsyncOperationStarting -slug: >- - Archive/Web/JavaScript/Extensions_Microsoft/Debug/msTraceAsyncOperationStarting -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: >- - Archive/Web/JavaScript/Microsoft_Extensions/Debug/msTraceAsyncOperationStarting ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Non-standard. Ne doit pas être utilisé !</strong><br> -Cet objet est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>Initialise une trace pour une opération asynchrone.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/msupdateasynccallbackrelation/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/msupdateasynccallbackrelation/index.html deleted file mode 100644 index 64aa29e1cc..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/msupdateasynccallbackrelation/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Debug.msUpdateAsyncCallbackRelation -slug: >- - Archive/Web/JavaScript/Extensions_Microsoft/Debug/msUpdateAsyncCallbackRelation -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: >- - Archive/Web/JavaScript/Microsoft_Extensions/Debug/msUpdateAsyncCallbackRelation ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode statique <code><strong>Debug.msUpdateAsyncCallbackRelation</strong></code> met à jour l'état de la rélation entre un élément de travail synchrone et l'opération asynchrone associée.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.msUpdateAsyncCallbackRelation(relatedAsyncOperationId[, relationType])</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>asyncOperationId</code></dt> - <dd>L'identifiant associé à l'opération asynchrone.</dd> - <dt><code>relationType</code> {{optional_inline}}</dt> - <dd>Le type de relation.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>L'élément de travail synchrone est généralement la fonction de rappel pour l'opération asynchrone. Cette fonction peut être appelée lorsqu'une opération asynchrone est interrompue, qu'une opération de jointure est utilisée ou dans d'autres cas.</p> - -<p>Les valeurs qui peuvent être utilisées pour <code>relationType</code> sont :</p> - -<ul> - <li> - <p><code>Debug.MS_ASYNC_CALLBACK_STATUS_ASSIGN_DELEGATE</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_CALLBACK_STATUS_JOIN</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_CALLBACK_STATUS_CHOOSEANY</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_CALLBACK_STATUS_CANCEL</code></p> - </li> - <li> - <p><code>Debug.MS_ASYNC_CALLBACK_STATUS_ERROR</code></p> - </li> -</ul> - -<p>Pour plus d'informations, voir <a href="https://docs.microsoft.com/en-us/scripting/javascript/reference/debug-constants">les constantes relatives au débogage</a>.</p> - -<div class="note"> -<p><strong>Note : </strong>Certains outils de débogage n'affichent pas les informations envoyées au débogueur.</p> -</div> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par le mode standard d'Internet Explorer 11 et par les applications Store (Windows 8.1 et Windows Phone 8.1).<br> - Elle n'est pas prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard. Elle n'est pas non plus prise en charge par Windows 8.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/setnonusercodeexceptions/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/setnonusercodeexceptions/index.html deleted file mode 100644 index 53730ac015..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/setnonusercodeexceptions/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: setNonUserCodeExceptions -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug/setNonUserCodeExceptions -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug/setNonUserCodeExceptions ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div>La propriété statique <strong><code>Debug.setNonUserCodeExceptions</code></strong> indique si les blocs <code>try-catch</code> de cette portée sont considérés par le débogueur comme étant gérés par l'utilisateur. Les exceptions peuvent être considérées comme levées, gérées par l'utilisateur ou non-gérées.</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.setNonUserCodeExceptions [= bool];</pre> - -<h3 id="Notes">Notes</h3> - -<p>Lorsque cette propriété est définie avec <code>true</code> pour une certaine portée, le débogueur peut décider de certaines actions (interrompre l'exécution par exemple) lorsque des exceptions sont levées dans la portée pour laquelle le développeur souhaite gérer les exceptions de façon manuelle. Lorsque cette propriété vaut <code>false</code>, on a le même comportement que si elle n'avait jamais été définie.</p> - -<p>Pour plus d'informations sur le débogage, voir <a href="https://go.microsoft.com/fwlink/p/?LinkId=249469">Un aperçu du débogage Active Script</a>.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">(function () { - Debug.setNonUserCodeExceptions = true; - try{ - var x = null; - x.y(); - } catch (e) { - // Catch the exception. - } -})();</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).<br> - Cette fonctionnalité n'est pas prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard et Internet Explorer 9 en mode standard.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/write/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/write/index.html deleted file mode 100644 index c2f7b095fb..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/write/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Debug.write -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug/write -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug/write ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode statique <strong><code>Debug.write()</code></strong> permet d'envoyer des chaînes de caractères au débogueur.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.write([str1 [, str2 [, ... [, strN]]]]) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>str1, str2, ... , strN</code> {{optional_inline}}</dt> - <dd>Les chaînes à envoyer au débogueur.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>La fonction <code>Debug.write()</code> envoie des chaînes de caractères à la fenêtre de débogage du script. Si le script n'est pas en train d'être débogué, la fonction n'a aucun effet.</p> - -<p><code>Debug.write()</code> est presqu'identique à la fonction <code>Debug.writeln()</code>, la seule différence est que cette dernière ajoute un saut de ligne après les chaînes de caractères qui lui sont passées en arguments.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple qui suit, on utilise la fonction <code>Debug.write()</code> afin d'afficher la valeur d'une variable dans la fenêtre du débogueur.</p> - -<div class="note"> -<p><strong>Note :</strong> Pour exécuter cet exemple, il est nécessaire d'avoir un débogueur installé et d'exécuter le script en mode <em>debug</em>.</p> - -<p>Internet Explorer 8 et les versions ultérieures embarquent un débogueur JavaScript. Pour les versions antérieures, voir <a href="https://go.microsoft.com/fwlink/?LinkId=133801">Comment activer et démarrer le débogage de script à partir d'Internet Explorer</a>.</p> -</div> - -<pre>var compteur = 42; -Debug.write("Compteur vaut " + compteur);</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/writeln">Debug.writeln()</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/debug/writeln/index.html b/files/fr/archive/web/javascript/extensions_microsoft/debug/writeln/index.html deleted file mode 100644 index e1f7f63d3a..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/debug/writeln/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Debug.writeln -slug: Archive/Web/JavaScript/Extensions_Microsoft/Debug/writeln -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Debug/writeln ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode statique <strong><code>Debug.writeln()</code></strong> permet d'envoyer des chaînes de caractères au débogueur qui seront suivies par un saut de ligne.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Debug.writeln([str1 [, str2 [, ... [, strN]]]]) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>str1, str2, ... , strN</code> {{optional_inline}}</dt> - <dd>Les chaînes à envoyer au débogueur.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>La fonction <code>Debug.writeln()</code> envoie des chaînes de caractères suivies par un saut de ligne à la fenêtre de débogage du script. Si le script n'est pas en train d'être débogué, la fonction n'a aucun effet.</p> - -<p><code>Debug.writeln()</code> est presqu'identique à la fonction <code>Debug.write()</code>, la seule différence est que cette dernière n'ajoute pas de saut de ligne après les chaînes de caractères qui lui sont passées en arguments.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple qui suit, on utilise la fonction <code>Debug.writeln()</code> afin d'afficher la valeur d'une variable dans la fenêtre du débogueur.</p> - -<div class="note"> -<p><strong>Note :</strong> Pour exécuter cet exemple, il est nécessaire d'avoir un débogueur installé et d'exécuter le script en mode <em>debug</em>.</p> - -<p>Internet Explorer 8 et les versions ultérieures embarquent un débogueur JavaScript. Pour les versions antérieures, voir <a href="https://go.microsoft.com/fwlink/?LinkId=133801">Comment activer et démarrer le débogage de script à partir d'Internet Explorer</a>.</p> -</div> - -<pre>var compteur = 42; -Debug.writeln("Compteur vaut " + compteur);</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Debug")}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Debug/write">Debug.write()</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/atend/index.html b/files/fr/archive/web/javascript/extensions_microsoft/enumerator/atend/index.html deleted file mode 100644 index 67a9477f70..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/atend/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Enumerator.atEnd -slug: Archive/Web/JavaScript/Extensions_Microsoft/Enumerator/atEnd -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Enumerator/atEnd ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<p>La méthode <strong><code>Enumerator.atEnd()</code></strong> renvoie un booléen qui indique si l'énumérateur a atteint la fin de la collection.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre><code>monEnum.atEnd()</code> -</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Un booléen (cf. {{jsxref("Boolean")}}) qui indique si l'énumérateur est parvenu à la fin de la collection ou si la collection est vide ou si l'élément courant vaut {{jsxref("undefined")}}. Sinon, la méthode renvoie <code>false</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple suivant, on utilise la méthode <code>atEnd()</code> afin de déterminer si on a atteint la fin d'une liste de disques :</p> - -<pre class="brush: js">function ShowDrives() { - var s = ""; - var bytesPerGB = 1024 * 1024 * 1024; - var fso = new ActiveXObject("Scripting.FileSystemObject"); - var e = new Enumerator(fso.Drives); - e.moveFirst(); - while (e.atEnd() == false) { - var drv = e.item(); - s += drv.Path + " - "; - if (drv.IsReady) { - var freeGB = drv.FreeSpace / bytesPerGB; - var totalGB = drv.TotalSize / bytesPerGB; - s += freeGB.toFixed(3) + " GB free of "; - s += totalGB.toFixed(3) + " GB"; - } else { - s += "Not Ready"; - } - s += "<br />"; - e.moveNext(); - } - return(s); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Enumerator")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/index.html b/files/fr/archive/web/javascript/extensions_microsoft/enumerator/index.html deleted file mode 100644 index 762a178557..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Enumerator -slug: Archive/Web/JavaScript/Extensions_Microsoft/Enumerator -tags: - - Enumerator - - JavaScript - - Microsoft - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Enumerator ---- -<div>{{JSRef}}{{non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cet objet est une extension non-standard de Microsoft. Elle est uniquement prise en charge par Internet Explorer. Elle n'est pas prise en charge dans les applications Windows 8.x Store.</div> - -<p>L'objet <code><strong>Enumerator</strong></code> permet d'énumérer les éléments d'une collection.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>enumObj = new Enumerator([collection]) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>collection</code> {{optional_inline}}</dt> - <dd>Un objet <code>Collection</code>.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<dl> - <dt><code>enumObj</code></dt> - <dd>Le nom de la variable à laquelle l'objet <code>Enumerator</code> est affecté.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>Les collections diffèrent des tableaux car les éléments de la collection ne sont pas accessibles directement. Plutôt que d'utiliser des indices, on déplace le pointeur de l'élément courant vers le prochain élément de la collection.</p> - -<p>L'objet <code>Enumerator</code> fournit un moyen d'accéder aux éléments d'une collection à la façon de l'instruction <code>For...Each</code> en VBScript.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var bytesPerGB = 1024 * 1024 * 1024; -var fso = new ActiveXObject("Scripting.FileSystemObject"); - -document.write(fso.Drives); -var e = new Enumerator(fso.Drives); - -var driveString = ""; - -e.moveFirst(); -while (e.atEnd() == false) { - var drv = e.item(); - driveString += drv.Path + " - "; - if (drv.IsReady) { - var freeGB = drv.FreeSpace / bytesPerGB; - var totalGB = drv.TotalSize / bytesPerGB; - driveString += freeGB.toFixed(3) + " GB free of "; - driveString += totalGB.toFixed(3) + " GB"; - } else { - driveString += "Not Ready"; - } - driveString += "<br />"; - e.moveNext(); -} -document.write(driveString); -// Output: <drive information -</pre> - -<h2 id="Propriétés">Propriétés</h2> - -<p>L'objet <code>Enumerator</code> ne possède pas de propriété.</p> - -<h2 id="Méthodes">Méthodes</h2> - -<dl> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Enumerator/atEnd"><code>Enumerator.atEnd</code></a></dt> - <dd>Renvoie une booléen qui indique si l'énumérateur a atteint la fin de la collection.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Enumerator/item"><code>Enumerator.item</code></a></dt> - <dd>Renvoie l'élément courant de la collection.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Enumerator/moveFirst"><code>Enumerator.moveFirst</code></a></dt> - <dd>Déplace le pointeur au premier élément de la collection.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Enumerator/moveNext"><code>Enumerator.moveNext</code></a></dt> - <dd>Déplace le pointeur de la collection sur l'élément suivant.</dd> -</dl> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li>{{jsxref("Boolean")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/item/index.html b/files/fr/archive/web/javascript/extensions_microsoft/enumerator/item/index.html deleted file mode 100644 index f5ac109d18..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/item/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Enumerator.item -slug: Archive/Web/JavaScript/Extensions_Microsoft/Enumerator/item -tags: - - JavaScript - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Enumerator/item ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention ! </strong>Cette méthode est spécifique à Microsoft et est uniquement prise en charge par Internet Explorer.</div> - -<p>La méthode <strong><code>Enumerator.item()</code></strong> renvoie l'élément courant de la collection.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>enumObj.item()</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Cette méthode renvoie la valeur de l'élément courant. Si la collection est vide, cette méthode renverra {{jsxref("undefined")}}.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">function ShowDrives() { - var s = ""; - var bytesPerGB = 1024 * 1024 * 1024; - var fso = new ActiveXObject("Scripting.FileSystemObject"); - var e = new Enumerator(fso.Drives); - e.moveFirst(); - while (e.atEnd() == false) { - var drv = e.item(); - s += drv.Path + " - "; - if (drv.IsReady) { - var freeGB = drv.FreeSpace / bytesPerGB; - var totalGB = drv.TotalSize / bytesPerGB; - s += freeGB.toFixed(3) + " GB free of "; - s += totalGB.toFixed(3) + " GB"; - } else { - s += "Not Ready"; - } - s += "<br />"; - e.moveNext(); - } - return(s); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Enumerator")}}</li> - <li>{{jsxref("Enumerator.atEnd()")}}</li> - <li>{{jsxref("Enumerator.moveFirst()")}}</li> - <li>{{jsxref("Enumerator.moveNext()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movefirst/index.html b/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movefirst/index.html deleted file mode 100644 index c7fcf8201e..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movefirst/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Enumerator.moveFirst -slug: Archive/Web/JavaScript/Extensions_Microsoft/Enumerator/moveFirst -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Enumerator/moveFirst ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention ! </strong>Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>Enumerator.moveFirst()</code></strong> déplace le pointeur de l'énumérateur sur le premier élément de la collection.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>enumObj.moveFirst()</pre> - -<h3 id="Notes">Notes</h3> - -<p>Si la collection ne contient aucun élément, l'élément courant vaudra {{jsxref("undefined")}}.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple suivant, on utilise la méthode <code>moveFirst()</code> afin d'évaluer les éléments de la collection <code>Drives</code>à partir du début de la liste :</p> - -<pre class="brush: js">function ShowDrives() { - var s = ""; - var bytesPerGB = 1024 * 1024 * 1024; - var fso = new ActiveXObject("Scripting.FileSystemObject"); - var e = new Enumerator(fso.Drives); - e.moveFirst(); - while (e.atEnd() == false) { - var drv = e.item(); - s += drv.Path + " - "; - if (drv.IsReady) { - var freeGB = drv.FreeSpace / bytesPerGB; - var totalGB = drv.TotalSize / bytesPerGB; - s += freeGB.toFixed(3) + " GB free of "; - s += totalGB.toFixed(3) + " GB"; - } else { - s += "Not Ready"; - } - s += "<br />"; - e.moveNext(); - } - return(s); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Enumerator")}}</li> - <li>{{jsxref("Enumerator.atEnd()")}}</li> - <li>{{jsxref("Enumerator.item()")}}</li> - <li>{{jsxref("Enumerator.moveNext()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movenext/index.html b/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movenext/index.html deleted file mode 100644 index 1e0e3d6854..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/enumerator/movenext/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Enumerator.moveNext -slug: Archive/Web/JavaScript/Extensions_Microsoft/Enumerator/moveNext -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Enumerator/moveNext ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention ! </strong>Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>Enumerator.moveNext()</code> </strong>déplace le pointeur de l'énumérateur sur le prochain élément de la collection.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>enumObj.moveNext()</pre> - -<h3 id="Notes">Notes</h3> - -<p>Si l'énumérateur a atteint la fin de la collection ou que celle-ci est vide, l'élément courant vaudra {{jsxref("undefined")}}.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple suivant, on utilise la méthode <code>moveNext()</code> afin de parcourir les éléments de la collection <code>Drives</code> :</p> - -<pre class="brush: js">function ShowDrives() { - var s = ""; - var bytesPerGB = 1024 * 1024 * 1024; - var fso = new ActiveXObject("Scripting.FileSystemObject"); - var e = new Enumerator(fso.Drives); - e.moveFirst(); - while (e.atEnd() == false) { - var drv = e.item(); - s += drv.Path + " - "; - if (drv.IsReady) { - var freeGB = drv.FreeSpace / bytesPerGB; - var totalGB = drv.TotalSize / bytesPerGB; - s += freeGB.toFixed(3) + " GB free of "; - s += totalGB.toFixed(3) + " GB"; - } else { - s += "Not Ready"; - } - s += "<br />"; - e.moveNext(); - } - return(s); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Enumerator")}}</li> - <li>{{jsxref("Enumerator.atEnd()")}}</li> - <li>{{jsxref("Enumerator.moveFirst()")}}</li> - <li>{{jsxref("Enumerator.item()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/error.description/index.html b/files/fr/archive/web/javascript/extensions_microsoft/error.description/index.html deleted file mode 100644 index ad806722df..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/error.description/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Error.description -slug: Archive/Web/JavaScript/Extensions_Microsoft/Error.description -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Error.description ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention ! </strong>Cet objet est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer. Utiliser {{jsxref("Error.message")}} à la place.</div> - -<p>La propriété <strong><code>Error.description</code></strong> permet d'obtenir ou de définir la chaîne de caractères qui décrit l'erreur courante.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">erreur.description [= exprChaine]</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>exprChaine</code> {{optional_inline}}</dt> - <dd>Une chaîne de caractères qui contient la description de l'erreur.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>La propriété <code>description</code> est spécifique à Microsoft et peut être utilisée à des fins de rétrocompatibilité pour les navigateurs de Microsoft. Elle fournit la même fonctionnalité que la propriété standard ECMAScript {{jsxref("Error.message")}} qui doit être utilisée en priorité.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">try { - // Cause an error: - x = y; -} catch(e) { - // Affiche "[object Error]": - console.log(e); - console.log(" "); - // Affiche 5009: - console.log((e.number & 0xFFFF)); - console.log(" "); - // Affiche "'y' is undefined": - console.log(e.description); - console.log(" "); - // Affiche "'y' is undefined": - console.log(e.message); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge avec les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft/Error.number">Error.number</a></code></li> - <li>{{jsxref("Error.message")}}</li> - <li>{{jsxref("Error.name")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/error.number/index.html b/files/fr/archive/web/javascript/extensions_microsoft/error.number/index.html deleted file mode 100644 index 0f10395da8..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/error.number/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Error.number -slug: Archive/Web/JavaScript/Extensions_Microsoft/Error.number -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Error.number ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette propriété est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La propriété <strong><code>Error.number</code></strong> permet d'obtenir ou de définir la valeur numérique associée à une erreur donnée.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre><code>erreur.number [= numeroErreur] -</code></pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>numeroErreur</code></dt> - <dd>Un entier représentant l'erreur.</dd> -</dl> - -<h2 id="Notes">Notes</h2> - -<p>Un numéro d'erreur est une valeur sur 32 bits. Les 16 bits de poids fort correspondent au <em>facility code</em> (NdT : « code d'emplacement ») et les 16 bits de poids faibles correspondent au code d'erreur. On pourra utiliser l'opérateur binaire <code>&</code> afin de combiner le nombre avec la valeur hexadécimale <code>0xFFFF</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">try { - // Cause une error: - x = y; -} catch(e) { - - console.log("Code d'erreur :"); - console.log(e.number & 0xFFFF); // 5009 - console.log("Code d'emplacement :"); - console.log(e.number >> 16 & 0x1FFF); // 10 - console.log("Message d'erreur :"); - console.log(e.message); // 'y' is undefined -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge avec les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft/Error.number">Error.number</a></code></li> - <li>{{jsxref("Error.message")}} (la version spécifique à Microsoft est <code><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft/Error.description">Error.description</a></code>)</li> - <li>{{jsxref("Error.name")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/error.stacktracelimit/index.html b/files/fr/archive/web/javascript/extensions_microsoft/error.stacktracelimit/index.html deleted file mode 100644 index f0599b3e0d..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/error.stacktracelimit/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Error.stackTraceLimit -slug: Archive/Web/JavaScript/Extensions_Microsoft/Error.stackTraceLimit -tags: - - JavaScript - - Microsoft - - Non-standard - - Propriété - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/Error.stackTraceLimit ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette propriété est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La propriété <strong><code>Error.stackTraceLimit</code></strong> permet d'obtenir ou de définir la limite de pile pour la trace, cela correspond au nombre de niveaux d'appels à afficher dans les erreurs. La limite par défaut vaut 10.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>Error.stackTraceLimit</pre> - -<h3 id="Notes">Notes</h3> - -<p>La propriété <code>stackTraceLimit</code> peut être un entier compris entre 0 et {{jsxref("Infinity")}}. Si <code>stackTraceLimit</code> vaut 0 au moment où l'erreur est déclenché, aucune pile d'appel ne sera affichée. Si cette propriété vaut une valeur négative ou non-numérique, elle sera convertie en 0. Si <code>stackTraceLimit</code> vaut <code>Infinity</code>, toute la pile sera affichée. Dans les autres cas, <code>ToUint32</code> sera utilisée afin de convertir la valeur.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">try { - var err = new Error("my error"); - Error.stackTraceLimit = 7; - throw err; -} catch(e) { - console.log("Valeur de la limite pour la pile :"); - console.log(Error.stackTraceLimit); -} -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par Internet Explorer 10 et par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li>{{jsxref("Error.message")}} (la version spécifique à Microsoft est <code><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft/Error.description">Error.description</a></code>)</li> - <li>{{jsxref("Error.name")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/getobject/index.html b/files/fr/archive/web/javascript/extensions_microsoft/getobject/index.html deleted file mode 100644 index 22a2dfb1b3..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/getobject/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: GetObject -slug: Archive/Web/JavaScript/Extensions_Microsoft/GetObject -tags: - - JavaScript - - Microsoft - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/GetObject ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette fonction est spécifique à Microsoft et est uniquement prise en charge par Internet Explorer dans les versions antérieures à IE 9 (en mode standard).</div> - -<p>La fonction <strong><code>GetObject()</code></strong> renvoie une référence à un objet <code>Automation</code> à partir d'un fichier donné.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>GetObject([pathname] [, class])</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>pathname </code></dt> - <dd>Un chemin complet contenant également le nom du fichier contenant l'objet qu'on souhaite récupérer. Si <code>pathname</code> n'est pas présent, l'argument <code>class</code> sera obligatoire.</dd> - <dt><code>class</code> {{optional_inline}}</dt> - <dd>La classe de l'objet. Cet argument suit une syntaxe <code>appname.objecttype</code> où :</dd> - <dd><code>appname</code> correspond au nom de l'application fournissant l'objet</dd> - <dd><code>objecttype</code> correspond au type ou à la classe d'objet à créer.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>La fonction <code>GetObject()</code> n'est pas prise en charge par Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard, Internet Explorer 11 en mode standard et par les applications Windows Store.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var CADObject; -CADObject = GetObject("C:\\CAD\\SCHEMA.CAD"); -</pre> - -<p>Lorsque ce code est exécuté, l'application associée au chemin indiquée est démarrée et l'objet indiqué est activé. Si l'argument <code>pathname</code> est une chaîne vide (""), <code>GetObject</code> renvoie une nouvelle instance du type souhaité. Si l'argument <code>pathname</code>est absent, <code>GetObject()</code> renvoie l'objet actif courant pour le type indiqué. Si aucun objet ne correspond, une erreur est déclenchée.</p> - -<p>Certaines applications permettent d'activer une partie d'un fichier. Pour cela, on peut terminer l'argument <code>pathname</code> par un point d'exclamation suivi du nom de la partie du fichier qu'on souhaite activer. Pour plus d'informations sur la composition du nom de la partie, voir la documentation de l'application qui a créé l'objet.</p> - -<p>Ainsi, pour une application de dessin avec différents calques enregistrés dans un même fichier, on pourra utiliser l'instruction suivante pour récupérer un calque précis :</p> - -<pre class="brush: js">var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3"); -</pre> - -<p>Si la classe de l'objet n'est pas passée en argument, l'objet <code>Automation</code> déterminera l'application à démarrer et l'objet à activer en fonction du nom de fichier passé en argument. Il est possible que certains fichiers prennent en charge plusieurs classes d'objet. Dans ce dernier cas, il faudra utiliser l'argument <code>class</code> afin d'indiquer la classe à récupérer :</p> - -<pre class="brush: js">var MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING"); -</pre> - -<p>Dans l'exemple précédent, <code>FIGMENT</code> est le nom d'une application de dessin et <code>DRAWING</code> est le nom d'un type d'objet pris en charge par cette application. Une fois l'objet activé, on peut y faire référence dans le code grâce à la variable qu'on a déclaré. Suite à l'instruction précédente, on peut manipuler les propriétés et méthodes du nouvel objet avec <code>MyObject</code> :</p> - -<pre class="brush: js">MyObject.Line(9, 90); -MyObject.InsertText(9, 100, "Hello, world."); -MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW"); -</pre> - -<div class="note"> -<p><strong>Note :</strong> On utilisera la fonction <code>GetObject()</code> lorsqu'on dispose d'une instance courante pour l'objet ou qu'on souhaite créer un objet à partir d'un fichier déjà chargé. Si on ne dispose encore d'aucunee instance et qu'on ne souhaite pas utiliser un objet d'un fichier chargé, il faudra utiliser l'objet <code>ActiveXObject</code>.</p> -</div> - -<p>Si un objet est enregistré comme un singleton, une seule instance de l'objet sera créée, quel que soit le nombre de fois où <code>ActiveXObject</code> est exécuté. Pour un tel singleton, <code>GetObject()</code> renvoie toujours la même instance lorsqu'elle est appelée avec la chaîne vide et provoque une erreur si l'argument <code>pathname</code> est absent.</p> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard et Internet Explorer 8 en mode standard.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions">ActiveXObject</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/index.html b/files/fr/archive/web/javascript/extensions_microsoft/index.html deleted file mode 100644 index 176357d45e..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Extensions JavaScript spécifiques de Microsoft -slug: Archive/Web/JavaScript/Extensions_Microsoft -tags: - - JavaScript - - Microsoft - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions ---- -<div>{{JSSidebar("Microsoft Extensions")}} {{Non-standard_header}}</div> - -<p>Les navigateurs édités par Microsoft (Internet Explorer ainsi que Microsoft Edge dans certains cas) prennent en charge certaines extensions qui sont spécifiques à Microsoft et n'appartiennent à <a href="/fr/docs/Web/JavaScript">l'ensemble JavaScript standard (ECMAScript)</a>.</p> - -<div class="warning"> -<p><strong>Attention !</strong> Ces API ne fonctionneront que pour les applications Microsoft, elles ne sont pas en voie de standardisation.</p> -</div> - -<h2 id="Objets">Objets</h2> - -<div class="index"> -<ul> - <li>{{jsxref("ActiveXObject")}}</li> - <li>{{jsxref("Debug")}}</li> - <li>{{jsxref("Enumerator")}}</li> - <li>{{jsxref("VBArray")}}</li> -</ul> -</div> - -<h2 id="Fonctions">Fonctions</h2> - -<div class="index"> -<ul> - <li>{{jsxref("GetObject")}}{{obsolete_inline}}</li> - <li>{{jsxref("ScriptEngine")}}{{deprecated_inline}}</li> - <li>{{jsxref("ScriptEngineBuildVersion")}}{{deprecated_inline}}</li> - <li>{{jsxref("ScriptEngineMajorVersion")}}{{deprecated_inline}}</li> - <li>{{jsxref("ScriptEngineMinorVersion")}}{{deprecated_inline}}</li> -</ul> -</div> - -<h2 id="Instructions">Instructions</h2> - -<div class="index"> -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-cc-on">@cc-on</a></code>{{obsolete_inline}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-if">@if</a></code>{{obsolete_inline}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/at-set">@set</a></code>{{obsolete_inline}}</li> -</ul> -</div> - -<h2 id="Autres">Autres</h2> - -<div class="index"> -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Date.getVarDate">Date.getVarDate</a></code>{{obsolete_inline}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Error.description">Error.description</a></code>{{deprecated_inline}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Error.number">Error.number</a></code>{{deprecated_inline}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/Error.stackTraceLimit">Error.stackTraceLimit</a></code>{{deprecated_inline}}</li> -</ul> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/CSS/Extensions_CSS_Microsoft">Extensions CSS de Microsoft</a></li> - <li><a href="/fr/docs/Web/API/Microsoft_API_extensions">Extensions DOM de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/scriptengine/index.html b/files/fr/archive/web/javascript/extensions_microsoft/scriptengine/index.html deleted file mode 100644 index b8e6c7bce1..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/scriptengine/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: ScriptEngine() -slug: Archive/Web/JavaScript/Extensions_Microsoft/ScriptEngine -tags: - - Déprécié - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/ScriptEngine ---- -<div>{{JSRef}}{{Non-standard_header}}{{Deprecated_Header}}</div> - -<p>La fonction <strong><code>ScriptEngine()</code></strong> renvoie le nom du langage de script utilisé.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>ScriptEngine()</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La fonction <code>ScriptEngine()</code> renvoie une chaîne de caractères indiquant le moteur de script utilisé. Pour les anciennes versions d'Internet Explorer, cette chaîne était <code>"JScript"</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">if (window.ScriptEngine) { - console.log(window.ScriptEngine()); -} -// affiche JScript -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge par les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineBuildVersion">ScriptEngineBuildVersion()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMajorVersion">ScriptEngineMajorVersion()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMinorVersion">ScriptEngineMinorVersion()</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/scriptenginebuildversion/index.html b/files/fr/archive/web/javascript/extensions_microsoft/scriptenginebuildversion/index.html deleted file mode 100644 index e14e26cb03..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/scriptenginebuildversion/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: ScriptEngineBuildVersion -slug: Archive/Web/JavaScript/Extensions_Microsoft/ScriptEngineBuildVersion -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/ScriptEngineBuildVersion ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette fonction est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La fonction <strong><code>ScriptEngineBuildVersion()</code></strong> renvoie le numéro de <em>build</em> de la version du moteur de script courant.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>ScriptEngineBuildVersion() -</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La valeur de retour correspond à l'information de version stockée dans la bibliothèque dynamique (DLL) du moteur de script utilisé.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">if(window.ScriptEngineBuildVersion) { - console.log(window.ScriptEngineBuildVersion()); -} -// Output: <numéro de build></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge par les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngine">ScriptEngine()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMajorVersion">ScriptEngineMajorVersion()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMinorVersion">ScriptEngineMinorVersion()</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/scriptenginemajorversion/index.html b/files/fr/archive/web/javascript/extensions_microsoft/scriptenginemajorversion/index.html deleted file mode 100644 index a8a93243da..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/scriptenginemajorversion/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: ScriptEngineMajorVersion() -slug: Archive/Web/JavaScript/Extensions_Microsoft/ScriptEngineMajorVersion -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/ScriptEngineMajorVersion ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette fonction est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La fonction <strong><code>ScriptEngineMajorVersion()</code></strong> permet d'obtenir le numéro de version majeur du moteur de script courant.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>ScriptEngineMajorVersion()</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La valeur de retour correspond à l'information de version stockée dans la bibliothèque dynamique (DLL) du moteur de script utilisé.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">if (window.ScriptEngineMajorVersion) { - console.log(window.ScriptEngineMajorVersion()); -} - -Output: <current major version> -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge par les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngine">ScriptEngine()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineBuildVersion">ScriptEngineBuildVersion()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMinorVersion">ScriptEngineMinorVersion()</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/scriptengineminorversion/index.html b/files/fr/archive/web/javascript/extensions_microsoft/scriptengineminorversion/index.html deleted file mode 100644 index 162f3f01f4..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/scriptengineminorversion/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: ScriptEngineMinorVersion() -slug: Archive/Web/JavaScript/Extensions_Microsoft/ScriptEngineMinorVersion -tags: - - JavaScript - - Microsoft - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/ScriptEngineMinorVersion ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette fonction est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La fonction <strong><code>ScriptEngineMinorVersion()</code></strong> permet d'obtenir le numéro de version mineur du moteur de script courant.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>ScriptEngineMinorVersion()</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La valeur de retour correspond à l'information de version stockée dans la bibliothèque dynamique (DLL) du moteur de script utilisé.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">if (window.ScriptEngineMinorVersion) { - console.log(window.ScriptEngineMinorVersion()); -} - -Output: <version mineure> -</pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge par les applications Store (Windows 8 et Windows Phone 8.1).</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngine">ScriptEngine()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineBuildVersion">ScriptEngineBuildVersion()</a></code></li> - <li><code><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/ScriptEngineMajorVersion">ScriptEngineMajorVersion()</a></code></li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/dimensions/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/dimensions/index.html deleted file mode 100644 index f2d0731ed5..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/dimensions/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: VBArray.dimensions -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray/dimensions -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray/dimensions ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>VBArray.dimensions()</code></strong> renvoie le nombre de dimensions d'un objet {{jsxref("VBArray")}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>monVBArray.dimensions()</pre> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function VBArrayTest(vbarray) { - var a = new VBArray(vbarray); - var b = a.toArray(); - var s = ""; - for (i = 1; i <= a.dimensions() ; i++) { - s += "La borne supérieure de la dimension " + i "; - s += " est " + a.ubound(i) + "."; - } - return s; - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - VBArrayTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("VBArray")}}</li> - <li>{{jsxref("VBArray.getItem()")}}</li> - <li>{{jsxref("VBArray.lbound()")}}</li> - <li>{{jsxref("VBArray.ubound()")}}</li> - <li>{{jsxref("VBArray.toArray()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/getitem/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/getitem/index.html deleted file mode 100644 index 0c4eec42c3..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/getitem/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: VBArray.getItem -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray/getItem -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray/getItem ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>VBArray.getItem()</code></strong> l'élément du tableau {{jsxref("VBArray")}} courant à l'emplacement indiqué.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>monVBArray.getItem(dimension1[, dimension2[, ... [, dimensionN]]])</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>dimension1-dimensionN</code></dt> - <dd>Les coordonnées exactes de la valeur qu'on souhaite récupérer dans le tableau <code>VBArray</code>. La valeur <code>n</code> correspond au nombre de dimensions du tableau.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La valeur de l'objet située aux coordonnées <code>dimension1-dimension2-…-dimensionN</code> dans le tableau <code>VBArray</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function GetItemTest(vbarray) { - var i, j; - var a = new VBArray(vbarray); - for (i = 1; i <= 2 ; i++) { - for (j = 1; j <= 2 ; j++) { - console.log(a.getItem(i,j)); - } - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - GetItemTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("VBArray")}}</li> - <li>{{jsxref("VBArray.dimensions()")}}</li> - <li>{{jsxref("VBArray.lbound()")}}</li> - <li>{{jsxref("VBArray.ubound()")}}</li> - <li>{{jsxref("VBArray.toArray()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/index.html deleted file mode 100644 index 0b823f10f4..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: VBArray -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray -tags: - - JavaScript - - Microsoft - - Non-standard - - Reference - - VBArray -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention ! </strong>Cet objet est spécifique à Microsoft et est uniquement pris en charge par Internet Explorer.</div> - -<p>L'objet <strong><code>VBArray</code></strong> permet d'accéder à des tableaux Visual Basic.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>varName = new VBArray(safeArray);</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>safeArray</code></dt> - <dd>Une valeur <code>VBArray</code>.</dd> -</dl> - -<h3 id="Notes">Notes</h3> - -<p>Les tableaux VBArray sont uniquement accessibles en lecture seule et ne peuvent pas être créés directement. L'argument <em>safeArray</em> doit être une valeur VBArray valide. L'obtention d'une telle valeur ne peut se faire que via un contrôle ActiveX ou via un autre objet.</p> - -<p>Les tableaux VBArray peuvent avoir plusieurs dimensions, dont chacune a un ensemble d'indices différents.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is JavaScript code that converts the Visual Basic safe array to a JavaScript array. Both of these parts go into the <HEAD> section of an HTML page. The third part is the JavaScript code that goes in the <BODY> section to run the other two parts.</p> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function VBArrayTest(vbarray) { - var a = new VBArray(vbarray); - var b = a.toArray(); - var i; - for (i = 0; i < 9; i++) { - console.log(b[i]); - } - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - VBArrayTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Propriétés">Propriétés</h2> - -<p>L'objet <code>VBArray</code> ne possède aucune propriété.</p> - -<h2 id="Méthodes">Méthodes</h2> - -<dl> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/VBArray/dimensions"><code>VBArray.dimensions()</code></a></dt> - <dd>Cette méthode renvoie le nombre de dimensions du tableau <code>VBArray</code>.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/VBArray/getItem"><code>VBArray.getItem()</code></a></dt> - <dd>Cette méthode renvoie l'élément à l'emplacement indiqué.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/VBArray/lbound"><code>VBArray.lbound()</code></a></dt> - <dd>Cette méthode renvoie l'indice le plus bas du <code>VBArray</code> pour la dimension indiquée.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/VBArray/toArray"><code>VBArray.toArray()</code></a></dt> - <dd>Cette méthode renvoie un tableau JavaScript standard converti à partir de l'objet <code>VBArray</code>.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Microsoft_JavaScript_extensions/VBArray/ubound"><code>VBArray.ubound()</code></a></dt> - <dd>Cette méthode renvoie l'indice le plus haut du <code>VBArray</code> pour la dimension indiquée.</dd> -</dl> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Array")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/lbound/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/lbound/index.html deleted file mode 100644 index 4fa681822b..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/lbound/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: VBArray.lbound -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray/lbound -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray/lbound ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>VBArray.lbound()</code></strong> renvoie l'indice le plus bas de l'objet {{jsxref("VBArray")}} pour la dimension indiquée.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>monVBArray.lbound(dimension)</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>dimension</code> {{optional_inline}}</dt> - <dd>La dimension pour laquelle on veut l'indice le plus bas. La valeur par défaut est 1.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Si le tableau est vide, {{jsxref("undefined")}}, sinon l'indice le plus bas pour la dimension souhaitée. Si la valeur de <code>dimension</code> excède le nombre de dimensions du tableau <code>VBArray</code>, une erreur "Subscript out of range" est levée.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function VBArrayTest(vbarray) { - var a = new VBArray(vbarray); - var b = a.toArray(); - var s = ""; - for (i = 1; i <= a.dimensions() ; i++) { - s += "La borne inférieure de la dimension " + i "; - s += " est " + a.lbound(i) + "."; - } - return s; - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - VBArrayTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("VBArray")}}</li> - <li>{{jsxref("VBArray.getItem()")}}</li> - <li>{{jsxref("VBArray.dimensions()")}}</li> - <li>{{jsxref("VBArray.ubound()")}}</li> - <li>{{jsxref("VBArray.toArray()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/toarray/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/toarray/index.html deleted file mode 100644 index 377b5ba29f..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/toarray/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: VBArray.toArray -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray/toArray -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray/toArray ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>VBArray.toArray()</code></strong> renvoie un tableau JavaScript {{jsxref("Array")}} à partir d'une valeur {{jsxref("VBArray")}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>monVBArray.toArray()</pre> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La valeur <code>VBArray</code> convertie en {{jsxref("Array")}}. Un tableau <code>VBArray</code> étant multi-dimensionnel, il est aplati avec les tableaux des dimensions les uns à la suite des autres. Ainsi, si le tableau <code>VBArray</code> contient <code>[1,2,3][4,5,6][7,8,9]</code>, il sera converti en un tableau <code>Array</code> ayant la structure <code>[1,2,3,4,5,6,7,8,9]</code>.</p> - -<p>Il n'existe aucune méthode qui permette de convertir un tableau {{jsxref("Array")}} en {{jsxref("VBArray")}}.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function VBArrayTest(vbarray) { - var a = new VBArray(vbarray); - var b = a.toArray(); - var s = ""; - for (i = 0; i < 9 ; i++) { - console.log(b[i]); - } - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - VBArrayTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("VBArray")}}</li> - <li>{{jsxref("VBArray.getItem()")}}</li> - <li>{{jsxref("VBArray.dimensions()")}}</li> - <li>{{jsxref("VBArray.lbound()")}}</li> - <li>{{jsxref("VBArray.ubound()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/ubound/index.html b/files/fr/archive/web/javascript/extensions_microsoft/vbarray/ubound/index.html deleted file mode 100644 index 9bfb404248..0000000000 --- a/files/fr/archive/web/javascript/extensions_microsoft/vbarray/ubound/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: VBArray.ubound -slug: Archive/Web/JavaScript/Extensions_Microsoft/VBArray/ubound -tags: - - JavaScript - - Méthode - - Non-standard - - Reference -translation_of: Archive/Web/JavaScript/Microsoft_Extensions/VBArray/ubound ---- -<div>{{JSRef}}{{Non-standard_header}}</div> - -<div class="warning"><strong>Attention !</strong> Cette méthode est spécifique à Microsoft et ne fonctionne qu'avec Internet Explorer.</div> - -<p>La méthode <strong><code>VBArray.ubound()</code></strong> renvoie l'indice le plus haut de l'objet {{jsxref("VBArray")}} pour la dimension indiquée.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre>monVBArray.ubound(dimension)</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>dimension</code> {{optional_inline}}</dt> - <dd>La dimension pour laquelle on veut l'indice le plus haut. La valeur par défaut est 1.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Si le tableau est vide, {{jsxref("undefined")}}, sinon l'indice le plus haut pour la dimension souhaitée. Si la valeur de <code>dimension</code> excède le nombre de dimensions du tableau <code>VBArray</code>, une erreur "Subscript out of range" est levée.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js"><head> - <script type="text/vbscript"> - <!-- - Function CreateVBArray() - Dim i, j, k - Dim a(2, 2) - k = 1 - For i = 0 To 2 - For j = 0 To 2 - a(j, i) = k - document.writeln(k) - k = k + 1 - Next - document.writeln("<br />") - Next - CreateVBArray = a - End Function - --> - </script> - - <script type="text/javascript"> - <!-- - function VBArrayTest(vbarray) { - var a = new VBArray(vbarray); - var b = a.toArray(); - var s = ""; - for (i = 1; i <= a.dimensions() ; i++) { - s += "La borne supérieure de la dimension " + i "; - s += " est " + a.ubound(i) + "."; - } - return s; - } - --> - </script> -</head> - -<body> - <script type="text/javascript"> - <!-- - VBArrayTest(CreateVBArray()); - --> - </script> -</body></pre> - -<h2 id="Prérequis">Prérequis</h2> - -<p>Cette fonctionnalité est prise en charge par les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Elle n'est pas prise en charge par les applications Windows 8.x Store.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("VBArray")}}</li> - <li>{{jsxref("VBArray.getItem()")}}</li> - <li>{{jsxref("VBArray.dimensions()")}}</li> - <li>{{jsxref("VBArray.lbound()")}}</li> - <li>{{jsxref("VBArray.toArray()")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Extensions_JavaScript_Microsoft">Les extensions JavaScript spécifiques de Microsoft</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/fonction_génératrice_historique/index.html b/files/fr/archive/web/javascript/fonction_génératrice_historique/index.html deleted file mode 100644 index 4f4e81ba8f..0000000000 --- a/files/fr/archive/web/javascript/fonction_génératrice_historique/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Fonction génératrice historique -slug: Archive/Web/JavaScript/Fonction_génératrice_historique -tags: - - JavaScript - - Legacy Iterator - - Non-standard - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Legacy_generator_function ---- -<div>{{JSSidebar("Operators")}}{{Non-standard_Header}}{{Obsolete_Header("gecko58")}}</div> - -<div class="warning">L'expression de fonction génératrice était une fonctionnalité spécifique à SpiderMonkey et est retirée à partir de Firefox 58. Pour la remplacer, on pourra utiliser l'expression {{jsxref("Opérateurs/function*", "function*")}}.</div> - -<p>Le mot-clé <strong><code>function</code></strong> peut être utilisé afin de définir une fonction génératrice au sein d'une expression. Pour que la fonction soit considérée comme génératrice, il faut que le corps de la fonction contiennent au moins une expression {{jsxref("Opérateurs/yield", "yield")}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox">function [<em>nom</em>]([<em>param1</em>[, <em>param2[</em>, ..., <em>paramN</em>]]]) { - <em>instructions</em> -}</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom de la fonction. Ce paramètre est optionnel, s'il n'est pas utilisé, la fonction sera <em>anonyme</em>. Le nom de la fonction est uniquement local pour le corps de la fonction.</dd> - <dt><code>paramN</code></dt> - <dd>Le nom d'un argument à passer à la fonction. Une fonction peut avoir jusqu'à 255 arguments.</dd> - <dt><code>instructions</code></dt> - <dd>Les instructions qui forment le corps de la fonction. Au moins l'une d'entre elle doit contenir une expression {{jsxref("Opérateurs/yield", "yield")}}.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>Un aperçu de cet opérateur est disponible sur la page <a href="/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs">sur les itérateurs et les générateurs</a>.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>Supported nowhere.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Generator")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Statements/Legacy_generator_function">L'instruction de fonction génératrice historique</a></li> - <li><a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_itérateur_historique">Le protocole itérateur historique</a></li> - <li>{{jsxref("Opérateurs/yield", "yield")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Fonctions">Fonctions et portée des fonctions</a></li> - <li>{{jsxref("Instructions/function", "function")}}</li> - <li>{{jsxref("Opérateurs/L_opérateur_function", "Expression de fonction")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("Instructions/function*", "function*")}}</li> - <li>{{jsxref("Opérateurs/function*", "function* expression")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_iterator">Le protocole itérateur</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/fonction_génératrice_historique_statement/index.html b/files/fr/archive/web/javascript/fonction_génératrice_historique_statement/index.html deleted file mode 100644 index ec21b25a5a..0000000000 --- a/files/fr/archive/web/javascript/fonction_génératrice_historique_statement/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Fonction génératrice historique -slug: Archive/Web/JavaScript/Fonction_génératrice_historique_statement -tags: - - JavaScript - - Legacy Iterator - - Obsolete - - Reference -translation_of: Archive/Web/JavaScript/Legacy_generator_function_statement ---- -<div>{{JSSidebar("Statements")}}{{Non-standard_Header}}{{Obsolete_Header("gecko58")}}</div> - -<div class="warning">Les fonctions génératrices historiques sont une fonctionnalité propre à SpiderMonkey qui a été retirée à partir de Firefox 58. Afin d'utiliser des outils pérennes, privilégier {{jsxref("Instructions/function*", "function*")}}.</div> - -<p>{{Obsolete_Header(58)}}</p> - -<p>L'<strong>instruction de fonction génératrice historique</strong> permet de déclarer une ancienne fonction génératrice avec des paramètres définis.</p> - -<p>Il est également possible de définir des fonctions à l'aide du constructeur {{jsxref("Function")}}, de l'argument <code>functionBody</code> et d'au moins une expression {{jsxref("Opérateurs/yield", "yield")}} et d'une {{jsxref("Opérateurs/Fonction_génératrice_historique", "expression de fonction génératrice historique", "", 1)}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox">function <em>nom</em>([<em>param</em>,[, <em>param</em>,[..., <em>param</em>]]]) { - [<em>instructions</em>] -} -</pre> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom de la fonction</dd> -</dl> - -<dl> - <dt><code>param</code></dt> - <dd>Le nom d'un argument à passer à la fonction. Une fonction peut avoir jusqu'à 255 arguments.</dd> -</dl> - -<dl> - <dt><code>instructions</code></dt> - <dd>Les instructions qui forment le corps de la fonction. Elles doivent contenir au moins une expression {{jsxref("Opérateurs/yield", "yield")}}.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>Un aperçu de ces anciennes fonctionnalités est disponible dans la page sur les <a href="/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs">itérateurs et les générateurs</a>.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>Supported nowhere.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Generator")}}</li> - <li>{{jsxref("Opérateurs/Fonction_génératrice_historique", "L'expression de fonction génératrice historique", "", 1)}}</li> - <li><a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_it%C3%A9rateur_historique">Le protocole Iterator historique</a></li> - <li>{{jsxref("Opérateurs/yield", "yield")}}</li> - <li>{{jsxref("Fonctions", "Fonctions", "", 1)}}</li> - <li>{{jsxref("Instructions/function", "function")}}</li> - <li>L'expression {{jsxref("Opérateurs/L_opérateur_function", "function")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("Instructions/function*", "function*")}}</li> - <li>L'expression {{jsxref("Opérateurs/function*", "function*")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> - <li><a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_iterator">Le protocole Iterator</a></li> -</ul> diff --git a/files/fr/archive/web/javascript/handler.enumerate/index.html b/files/fr/archive/web/javascript/handler.enumerate/index.html deleted file mode 100644 index 40dbd33345..0000000000 --- a/files/fr/archive/web/javascript/handler.enumerate/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: handler.enumerate() -slug: Archive/Web/JavaScript/handler.enumerate -tags: - - ECMAScript 2015 - - JavaScript - - Méthode - - Obsolete - - Proxy - - Reference -translation_of: Archive/Web/JavaScript/handler.enumerate ---- -<div>{{JSRef}} {{obsolete_header}}</div> - -<p>La méthode <strong><code>handler.enumerate()</code></strong> représente une trappe pour les instructions {{jsxref("Instructions/for...in", "for...in")}}. Elle a été retirée du standard ECMAScript avec la septième édition (ES2016) et est dépréciée pour les navigateurs.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js notranslate">var p = new Proxy(cible, { - enumerate(cible) { - } -}); -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<p>Le paramètre suivant est passé à la méthode <code>enumerate</code>. <code>this</code> est lié au gestionnaire.</p> - -<dl> - <dt><code>cible</code></dt> - <dd>L'objet cible.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>La méthode <code>enumerate</code> renvoie un objet <a href="/fr/docs/Web/JavaScript/Guide/Le_protocole_iterator">itérateur</a>.</p> - -<h2 id="Description">Description</h2> - -<p>La méthode <code><strong>handler.enumerate</strong></code> est une trappe permettant d'intercepter les instructions {{jsxref("Instructions/for...in", "for...in")}}.</p> - -<h3 id="Interceptions">Interceptions</h3> - -<p>Cette trappe peut intercepter les opérations suivantes :</p> - -<ul> - <li>L'énumération de propriétés / for...in : <code>for (var name in proxy) {...}</code></li> - <li>{{jsxref("Reflect.enumerate()")}}</li> -</ul> - -<h3 id="Invariants">Invariants</h3> - -<p>Si les invariants suivants ne sont pas respectés, le proxy renverra une exception {{jsxref("TypeError")}} :</p> - -<ul> - <li>La méthode <code>enumerate</code> doit renvoyer un objet.</li> -</ul> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'exemple qui suit, on intercepte l'instruction {{jsxref("Instructions/for...in", "for...in")}}.</p> - -<pre class="brush: js notranslate">var p = new Proxy({}, { - enumerate(cible) { - console.log("appelé"); - return ["a", "b", "c"][Symbol.iterator](); - } -}); - -for (var x in p) { // "appelé" - console.log(x); // "a" -} // "b" - // "c" -</pre> - -<p>Dans le code suivant, on ne respecte pas l'invariant.</p> - -<pre class="brush: js notranslate">var p = new Proxy({}, { - enumerate(cible) { - return 1; - } -}); - -for (var x in p) {} // exception TypeError levée -</pre> - -<p>Note : Ces deux exemples utilisent la notation raccourcie pour <a href="/fr/docs/Web/JavaScript/Reference/Fonctions/Définition_de_méthode">les définitions de méthode</a>.</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots-enumerate', '[[Enumerate]]')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Définition initiale. Retirée avec ECMAScript 2016 (ES7).</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> - -<p>{{Compat("javascript.builtins.Proxy.handler.enumerate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Proxy")}}</li> - <li>{{jsxref("Proxy.handler", "handler")}}</li> - <li>L'instruction {{jsxref("Instructions/for...in", "for...in")}}</li> - <li>{{jsxref("Reflect.enumerate()")}}</li> -</ul> diff --git a/files/fr/archive/web/javascript/index.html b/files/fr/archive/web/javascript/index.html deleted file mode 100644 index 4687b7bf23..0000000000 --- a/files/fr/archive/web/javascript/index.html +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: JavaScript -slug: Archive/Web/JavaScript -translation_of: Archive/Web/JavaScript ---- -<div class="hidden">{{JSRef}}</div> - -<p>{{Obsolete_Header}}</p> - -<p class="summary">Obsolete JavaScript features and unmaintained docs</p> - -<p>{{SubpagesWithSummaries}}</p> diff --git a/files/fr/archive/web/javascript/reflect.enumerate/index.html b/files/fr/archive/web/javascript/reflect.enumerate/index.html deleted file mode 100644 index 11a5cec1ec..0000000000 --- a/files/fr/archive/web/javascript/reflect.enumerate/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Reflect.enumerate() -slug: Archive/Web/JavaScript/Reflect.enumerate -tags: - - ECMAScript 2015 - - JavaScript - - Méthode - - Obsolete - - Reference - - Reflect -translation_of: Archive/Web/JavaScript/Reflect.enumerate ---- -<div>{{JSRef}}{{obsolete_header}}</div> - -<p>La méthode statique <code><strong>Reflect</strong></code><strong><code>.enumerate()</code></strong> renvoie un itérateur qui déroule les propriétés propres énumérables et les propriétés héritées énumérables de l'objet cible. Cette méthode a été <a href="https://github.com/tc39/ecma262/pull/367">retirée de la septième édition d'ECMAScript</a> et est désormais dépréciée dans les navigateurs.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox notranslate">Reflect.enumerate(cible) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>cible</code></dt> - <dd>L'objet cible dont on veut obtenir les propriétés.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Un itérateur qui liste les propriétés propres énumérables de l'objet cible ainsi que ses propriétés héritées énumérables.</p> - -<h3 id="Exceptions_levées">Exceptions levées</h3> - -<p>Une erreur {{jsxref("TypeError")}} si <code>cible</code> n'est pas un {{jsxref("Object")}}.</p> - -<h2 id="Description">Description</h2> - -<p>La méthode <code>Reflect.enumerate</code> renvoie un itérateur qui liste les propriétés énumérables d'un objet cible, celles qui sont propres et celles qui sont héritées.</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js notranslate">var obj = { x: 1, y: 2 }; - -for (var nom of Reflect.enumerate(obj)) { - console.log(nom); -} -// affiche "x" et "y" -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-reflect.enumerate', 'Reflect.enumerate')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Définition initiale. Retirée avec ECMAScript 2016 (ES7).</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> - -<p>{{Compat("javascript.builtins.Reflect.enumerate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Reflect")}}</li> - <li><code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/for...in">for...in</a></code></li> -</ul> diff --git a/files/fr/archive/web/javascript/support_ecmascript_next_par_mozilla/index.html b/files/fr/archive/web/javascript/support_ecmascript_next_par_mozilla/index.html deleted file mode 100644 index e898981c03..0000000000 --- a/files/fr/archive/web/javascript/support_ecmascript_next_par_mozilla/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Support d'ECMAScript Next par Mozilla -slug: Archive/Web/JavaScript/Support_ECMAScript_Next_par_Mozilla -tags: - - Firefox - - JavaScript -translation_of: Archive/Web/JavaScript/ECMAScript_Next_support_in_Mozilla ---- -<div>{{jsSidebar("New_in_JS")}}</div> - -<p>ECMAScript Next fait référence aux fonctionnalités ajoutées au standard ECMA-262 depuis la version ECMAScript 6 (ES2015). Depuis ECMAScript 6, des versions du standard sont publiée chaque année. Cette année, la spécification ES2018 a vu le jour et ES2019 est actuellement en cours de rédaction. est la prochaine évolution du standard ECMA-262. Les nouvelles fonctionnalités du langage peuvent déjà être proposées dans ce brouillon (<em>draft</em>) car <a href="/fr/docs/Web/JavaScript/Nouveautés_et_historique_de_JavaScript/Support_ECMAScript_6_par_Mozilla">la sixième édition</a> n'accepte plus de nouvelles fonctionnalités et est en train d'être finalisée. L'état actuel des propositions peut être consulté sur le dépôt GitHub <a href="https://github.com/tc39/ecma262">tc39/ecma262</a>.<br> - La liste de diffusion <a href="https://mail.mozilla.org/listinfo/es-discuss">es-discuss</a> permet de discuter des standards ECMAScript.</p> - -<h2 id="ECMAScript_2016">ECMAScript 2016</h2> - -<p>Les fonctionnalités suivantes d'ES2016 sont implémentées :</p> - -<ul> - <li>{{jsxref("Array.prototype.includes()")}} (Firefox 43)</li> - <li>{{jsxref("TypedArray.prototype.includes()")}} (Firefox 43)</li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Instructions/function*">Les générateurs</a> et <a href="/fr/docs/Web/JavaScript/Reference/Fonctions/Définition_de_méthode">les méthodes de générateur</a> ne sont plus constructibles (Firefox 43)</li> - <li>Le gestionnaire de proxy <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Proxy/handler/enumerate">enumerate</a> a été retiré (Firefox 47)</li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Opérateurs/Opérateurs_arithmétiques#Exponentiation_(**)">L'opérateur d'exponentiation</a> (Firefox 52)</li> - <li>{{jsxref("Fonctions/paramètres_du_reste", "La décomposition pour les paramètres du reste", "#La_décomposition_sur_les_paramètres_du_reste", 1)}} (Firefox 52)</li> -</ul> - -<h2 id="ECMAScript_2017">ECMAScript 2017</h2> - -<p>Les fonctionnalités d'ES2017 suivantes sont implémentées :</p> - -<ul> - <li>{{jsxref("Object.values()")}} and {{jsxref("Object.entries()")}} (Firefox 47)</li> - <li>{{jsxref("String.prototype.padEnd()")}} (Firefox 48)</li> - <li>{{jsxref("String.prototype.padStart()")}} (Firefox 48)</li> - <li>{{jsxref("Object.getOwnPropertyDescriptors()")}} (Firefox 50)</li> - <li>Async Functions - <ul> - <li>{{jsxref("Instructions/async_function", "Déclaration de fonction asynchrone")}} (Firefox 52)</li> - <li>{{jsxref("Opérateurs/async_function", "Expression de fonction asynchrone")}} (Firefox 52)</li> - <li>{{jsxref("AsyncFunction")}} (Firefox 52)</li> - <li>{{jsxref("Opérateurs/await", "await")}} (Firefox 52)</li> - </ul> - </li> - <li><a href="/fr/docs/Web/JavaScript/Reference/Virgules_en_fin_de_ligne">Les virgules en fin de ligne pour la liste des paramètres d'une fonction</a> (Firefox 52)</li> -</ul> - -<h2 id="Nouvelles_fonctionnalités_expérimentales">Nouvelles fonctionnalités expérimentales</h2> - -<p>Les fonctionnalités suivantes sont d'ores et déjà implémentées mais ne sont disponibles que pour <a href="https://nightly.mozilla.org/">Firefox Nightly</a> et ne font pas encore partie d'un brouillon de la spécification ECMAScript.</p> - -<h3 id="Ajout_à_l'objet_ArrayBuffer">Ajout à l'objet <code>ArrayBuffer</code></h3> - -<ul> - <li>{{jsxref("ArrayBuffer.transfer()")}} (<a href="https://gist.github.com/lukewagner/2735af7eea411e18cf20">spécfication</a>)</li> -</ul> - -<h3 id="Nouveaux_objets_typés">Nouveaux objets typés</h3> - -<ul> - <li>Basés sur <a href="https://github.com/dslomov-chromium/typed-objects-es7">le brouillon de spécification pour les objets types (<em>Typed Objects</em>)</a> et exposés via un objet global <code>TypedObject</code> (par exemple, on pourrait avoir : <code>TypedObject.StructType</code> & <code>TypedObject.ArrayType</code>). Cette fonctionnalité est non-standard et n'est pas documentée.</li> -</ul> - -<h3 id="Nouveaux_objets_pour_la_mémoire_partagée">Nouveaux objets pour la mémoire partagée</h3> - -<ul> - <li>{{jsxref("SharedArrayBuffer")}}</li> - <li>{{jsxref("Atomics")}}</li> -</ul> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://www.ecmascript.org/">Le site web ECMAScript</a></li> - <li><a href="https://kangax.github.io/compat-table/esnext/">La prise en charge d'ECMAScript <em>next</em> parmi les différents navigateurs</a></li> -</ul> diff --git a/files/fr/archive/web/xforms/autres_ressources/index.html b/files/fr/archive/web/xforms/autres_ressources/index.html deleted file mode 100644 index d3af7709d3..0000000000 --- a/files/fr/archive/web/xforms/autres_ressources/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Autres ressources -slug: Archive/Web/XForms/Autres_ressources -tags: - - XForms -translation_of: Archive/Web/XForms/Other_Resources ---- -<p> </p> -<h3 id="Toutes_les_autres_ressources" name="Toutes_les_autres_ressources">Toutes les autres ressources</h3> -<ul> - <li><a class="external" href="http://lab.cph.novell.com/~abeaufour/xforms/doxygen/">Documentation du code</a> (temporaire)</li> - <li><a class="external" href="http://www.mozilla.org/projects/xforms">Page officielle du projet Mozilla XForms</a></li> - <li><a class="external" href="http://www.w3.org/MarkUp/Forms/Test">Suite de tests W3C</a></li> - <li><a class="external" href="http://www.xformstest.org/">xformstest.org</a></li> -</ul> diff --git a/files/fr/archive/web/xforms/index.html b/files/fr/archive/web/xforms/index.html deleted file mode 100644 index e7e805c1a5..0000000000 --- a/files/fr/archive/web/xforms/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: XForms -slug: Archive/Web/XForms -tags: - - XForms -translation_of: Archive/Web/XForms ---- -<div class="callout-box"><strong><a class="external" href="http://xformsinstitute.com/essentials/browse/">XForms Essentials (en)</a></strong> -<p><small>Un livre en ligne qui vous offre une visite guidée des XForms.</small><br> - <strong><a class="external" href="http://en.wikibooks.org/wiki/XForms">XForms Tutorial and Cookbook (en)</a></strong><br> - <small>XForms au format wikibook - testé avec Firefox.</small></p> -<small>(<a class="external" href="http://xforms.fr.free.fr/wiki/index.php/Wikilivre">en cours de traduction en français</a>)</small></div> - -<div> -<div><strong>XForms</strong> est le futur des formulaires en ligne tel qu'imaginé par le W3C. S'appuyant sur d'autres standards du W3C comme <a href="/fr/XML_Schema" title="fr/XML_Schema">XML Schema</a>, <a href="/fr/XPath" title="fr/XPath">XPath</a>, et <a href="/fr/XML_Events" title="fr/XML_Events">XML Events</a>, XForms s'efforce de dépasser les limitations du modèle actuel des formulaires <a href="/fr/HTML" title="fr/HTML">HTML</a>. Les autres forces de <strong>XForms</strong> sont la séparation entre les données et leur présentation, un typage fort des données, la possibilité de soumettre des données <a href="/fr/XML" title="fr/XML">XML</a> vers les serveurs plutôt que les traditionnels couples nom/valeur, et par une manière descriptive de de concevoir des formulaires pouvant être affichés sur une large variété de périphériques. XForms est <a class="external" href="http://www.w3.org/MarkUp/Forms/">une spécification du W3C</a>.</div> - -<p><br> - Le support XForms peut être ajouté à Firefox et SeaMonkey en installant l'<a class="external" href="http://www.mozilla.org/projects/xforms">Extension XForms de Mozilla</a>.</p> -</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation"><a href="/Special:Tags?tag=XForms&language=fr" title="Special:Tags?tag=XForms&language=fr">Documentation</a></h4> - - <dl> - <dt><a class="internal" href="/Fr/XForms/Résolution_des_problèmes_avec_XForms" title="Fr/XForms/Résolution des problèmes avec XForms">Résolution des problèmes avec XForms</a></dt> - <dd><small>Une petite collection d'astuces permettant de régler les problèmes courants que l'on peut rencontrer avec les formulaires XForms (à traduire de <a href="/en/XForms/Form_Troubleshooting">en:XForms:Form Troubleshooting</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XForms/Particularités_de_XForms_dans_Mozilla" title="fr/XForms/Particularités_de_XForms_dans_Mozilla">Particularités de XForms dans Mozilla</a></dt> - <dd><small>Explique où et comment XForms dans Mozilla diffère ou va plus loin que la spécification XForms 1.0 specification (à traduire de <a href="/en/XForms/Mozilla_XForms_Specials">en:XForms:Mozilla XForms Specials</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XForms/Contrôles_personnalisés" title="fr/XForms/Contrôles_personnalisés">Contrôles personnalisés avec XForms</a></dt> - <dd><small>Le {{ Bug(289434) }} a été la première étape pour le support de la personnalisation des contrôles pour XForms. Vous pouvez maintenant styler chaque contrôle XForms grâce aux XBL et créer des effets spéciaux en SVG sur un contrôle <code>input</code> (à traduire de <a href="/en/XForms/Custom_Controls">en:XForms:Custom Controls</a>).</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XForms/Préférences_utilisateur" title="fr/XForms/Préférences_utilisateur">Préférences utilisateur pour XForms</a></dt> - <dd><small>Une courte description des variables <code>about:config</code> utilisées par XForms.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XForms/Référence_de_l'API" title="fr/XForms/Référence_de_l'API">Référence de l'API XForms</a></dt> - <dd><small>Documentation des interfaces XForms.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XForms/Élément_d'interface_utilisateur" title="fr/XForms/Élément_d'interface_utilisateur">Référence des éléments d'interface utilisateur XForms</a></dt> - <dd><small>La documentation sur les éléments d'interface utilisateur XForms.</small></dd> - </dl> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XForms&language=fr" title="Special:Tags?tag=XForms&language=fr">Tous les articles…</a></span></p> - </td> - <td> - <h4 id="Communaut.C3.A9" name="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p>{{ DiscussionList("dev-tech-xforms", "mozilla.dev.tech.xforms") }}</p> - - <ul> - <li><a class="link-irc" href="irc://irc.mozilla.org/xforms">canal #xforms sur irc.mozilla.org</a></li> - <li><a class="external" href="http://lists.w3.org/Archives/Public/www-forms/">Liste de discussion Forms du W3C</a></li> - <li><a class="external" href="http://beaufour.dk/blog">Blog de développement de XForms dans Mozilla</a></li> - <li><a href="/fr/XForms/Communauté" title="fr/XForms/Communauté">Autres liens communautaires…</a></li> - </ul> - - <h4 id="Outils" name="Outils">Outils</h4> - - <ul> - <li><a class="external" href="http://xformsinstitute.com/validator/">Validateur XForms</a></li> - <li><a class="external" href="http://beaufour.dk/index.php?sec=misc&pagename=xforms">XForms Buddy</a></li> - </ul> - - <p><span class="alllinks"><a href="/Special:Tags?tag=XForms:Outils&language=fr" title="Special:Tags?tag=XForms:Outils&language=fr">Tous les outils…</a></span></p> - - <h4 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/Extensions" title="fr/Extensions">Extensions</a>, <a href="/fr/HTML" title="fr/HTML">HTML</a>, <a href="/fr/XHTML" title="fr/XHTML">XHTML</a>, <a href="/fr/XML" title="fr/XML">XML</a>, <a href="/fr/XPath" title="fr/XPath">XPath</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Categories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/fr/archive/web/xforms/préférences_utilisateur/index.html b/files/fr/archive/web/xforms/préférences_utilisateur/index.html deleted file mode 100644 index 37446d057b..0000000000 --- a/files/fr/archive/web/xforms/préférences_utilisateur/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: XForms Préférence utilisateur -slug: Archive/Web/XForms/Préférences_utilisateur -tags: - - XForms -translation_of: Archive/Web/XForms/User_preferences ---- -<p> </p><p>Description des préférences <code>about:config</code> utilisées par XForms. -</p> -<table class="standard-table"> <tbody><tr> -<td class="header">Préférence -</td><td class="header">Défaut -</td><td class="header">Description -</td></tr> <tr> -<td>xforms.disablePopup -</td><td>false -</td><td>Désactive les popups d'erreur XForms -</td></tr> -<tr> -<td>xforms.enableExperimentalFeatures -</td><td>false -</td><td>Active les options de test. Actuellement uniquement l'option <i>XForms 1.1 SOAP Action</i>, pour la version test (<i>trunk</i>) uniquement. -</td></tr> -</tbody></table> -<div class="noinclude"> -</div> -{{ languages( { "en": "en/XForms/User_preferences", "it": "it/Le_preferenze_utente_e_XForms", "ja": "ja/XForms/User_preferences" } ) }} diff --git a/files/fr/archive/web/xforms/référence_api_xforms/index.html b/files/fr/archive/web/xforms/référence_api_xforms/index.html deleted file mode 100644 index b70aae242f..0000000000 --- a/files/fr/archive/web/xforms/référence_api_xforms/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: XForms API Reference -slug: Archive/Web/XForms/Référence_API_XForms -tags: - - XForms -translation_of: Archive/Web/XForms/API_Reference ---- -<div class="note"> -<p>Cette page n'est que le début du recensement de la référence de l'API de XForms. Notez le mot <strong>début</strong> :-)</p> -</div> - -<p> </p> - -<h3 id="Convention_de_nommage" name="Convention_de_nommage">Convention de nommage</h3> - -<p>L'interface XForms a les conventions de nommage suivantes :</p> - -<dl> - <dt>nsIXForms...Element </dt> - <dd>Interfaces implémentées par la partie C++ d'un contrôle.</dd> - <dt>nsIXFormsNS...Element </dt> - <dd>Interfaces étendant la spécification des interfaces XForms.</dd> - <dt>nsIXForms...UIElement </dt> - <dd>Interfaces implémentées par la partie JavaScript d'un contrôle.</dd> - <dt>nsIXForms...Accessors </dt> - <dd>Interfaces exposant l'état d'un nœud d'instance liée d'un contrôle donné.</dd> -</dl> - -<h3 id="Interfaces_gel.C3.A9es" name="Interfaces_gel.C3.A9es">Interfaces gelées</h3> - -<dl> - <dt><a href="fr/NsIXFormsModelElement">nsIXFormsModelElement</a></dt> - <dd>L'interface modèle</dd> -</dl> - -<h3 id="Interfaces_exp.C3.A9rimentales" name="Interfaces_exp.C3.A9rimentales">Interfaces expérimentales</h3> - -<dl> - <dt><a href="fr/NsIXFormsDelegate">nsIXFormsDelegate</a></dt> - <dd>L'interface<em>déléguée</em> de <a href="fr/XForms/Contr%c3%b4les_personnalis%c3%a9s">XForms:Contrôles personnalisés</a>.</dd> - <dt><a href="fr/NsIXFormsAccessors">nsIXFormsAccessors</a></dt> - <dd>L'interface<em>accessoires</em> de {{ mediawiki.external('XForms:Contrôles personnalisés') }}].</dd> - <dt><a href="fr/NsIXFormsNSModelElement">nsIXFormsNSModelElement</a></dt> - <dd>Extensions personnalisées de l'interface <a href="fr/NsIXFormsModelElement">nsIXFormsModelElement</a>.</dd> - <dt><a href="fr/NsIXFormsNSInstanceElement">nsIXFormsNSInstanceElement</a></dt> - <dd>Extensions personnalisées de l'élément instance.</dd> -</dl> diff --git a/files/fr/archive/web/xforms/résolution_des_problèmes_avec_xforms/index.html b/files/fr/archive/web/xforms/résolution_des_problèmes_avec_xforms/index.html deleted file mode 100644 index 7607702cdc..0000000000 --- a/files/fr/archive/web/xforms/résolution_des_problèmes_avec_xforms/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Résolution des problèmes -slug: Archive/Web/XForms/Résolution_des_problèmes_avec_XForms -translation_of: Archive/Web/XForms/Form_Troubleshooting ---- -<p> </p> -<div class="note"> - Cette page est en cours de traduction, son contenu peut donc être incomplet ou contenir des parties en anglais. N'hésitez pas à participer à sa traduction à partir de</div> -<p> </p> -<h3 id="Introduction">Introduction</h3> -<p>Le but de cette page est de collecter toute une sériée de solutions à des erreurs fréquemment rencontrées quand on utilise XForm.</p> -<h3 id="Commencez_toujours_par_ça">Commencez toujours par ça</h3> -<ol> - <li>Assurez-vous d'utiliser la <a class="external" href="http://www.mozilla.org/projects/xforms/download.html">dernière version</a> de l'extension.</li> - <li>Testez votre code avec le <a class="external" href="http://xformsinstitute.com/validator/">validateur XForms</a>. Il vérifie votre formulaire pour y déceler les erreurs. Ce n'est pas parfait mais c'est mieux que rien et permet de mettre en lumière un certain nombre d'erreurs.</li> - <li>Ayez toujours un œil sur la <em>Console d'erreurs</em> (Outils, Console d'erreurs). Si des erreurs sont détectées, n'espérez pas que votre formulaire fonctionne.</li> -</ol> -<h3 id="Troubleshooting" name="Troubleshooting">Problèmes et solutions</h3> -<h4 id="Check_The_File_Type" name="Check_The_File_Type">Vérifiez le type de fichier</h4> -<p>La page est-elle interprétée en tant que document <u>XHTML</u> ? Cliquez droit dans un endroit vide de la page, et sélectionnez <em>Informations sur la page</em>. Le champ <em>Type</em> devrait afficher <code>application/xhtml+xml</code> comme valeur. Toute autre valeur est mauvaise.</p> -<p>Si vous ouvrez votre fichier directement depuis votre système (en local), l'extension du fichier doit être .xhtml ou .xml. Si vous chargez le fichier depuis un serveur, vérifiez que le serveur déserve bien le fichier en tant qu'<code>application/xhtml+xml</code> ou en tant que <code>text/xml</code>.</p> -<h4 id="Check_the_XHTML_1.0_Namespace_Declaration" name="Check_the_XHTML_1.0_Namespace_Declaration">Vérifiez la déclaration de l'espace de nom XHTML 1.0</h4> -<p>Mozilla XForms est construit sur base de la spécification d'XHTML 1.0, laquelle se trouve ici <a class="external" href="http://www.w3.org/1999/xhtml" rel="freelink">http://www.w3.org/1999/xhtml</a>. Assurez-vous que l'élément <html> contienne la bonne déclaration de l'espace de nom :</p> -<pre>xmlns="http://www.w3.org/1999/xhtml"</pre> -<p>(à la place de la dernière spécification, non-ratifiée, XHTML 2.0, située ici <a class="external" href="http://www.w3.org/2002/06/xhtml2" rel="freelink">http://www.w3.org/2002/06/xhtml2</a> )</p> diff --git a/files/fr/archive/web/xforms/élément_interface_utilisateur_xforms/index.html b/files/fr/archive/web/xforms/élément_interface_utilisateur_xforms/index.html deleted file mode 100644 index b6b6a12505..0000000000 --- a/files/fr/archive/web/xforms/élément_interface_utilisateur_xforms/index.html +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Mozilla XForms User Interface -slug: Archive/Web/XForms/Élément_interface_utilisateur_XForms -translation_of: Archive/Web/XForms/User_Interface_Elements ---- -<h3 id="Introduction" name="Introduction">Introduction</h3> - -<p>Cette article est une référence rapide des éléments de l'interface utilisateur de XForms. Il a pour principal but de documenter la façon dont les éléments XForms seront présentés dans Mozilla car les spécifications de XForms ne donnent que des indices sur le comportement des divers contrôles.</p> - -<p>Currently XForms can be hosted by XHTML and XUL in Seamonkey and Firefox. Later we have plans to support XForms hosted by SVG. The XForms specs define two kinds of XForms UI elements, called 'Form Controls' and 'XForms User Interface'. Elements from the "Form Controls" group allows users to interact with instance data. The set of "XForms User Interface" elements exist to aid form authors in combining host language markup and XForms markup together in order to build user interfaces. Some of the 'Form Controls' can have multiple appearances and thus may be rendered in multiple ways. We use the data type of the instance node that the form control is bound to as a clue when making a rendering decision. The form author can also use the 'appearance' attribute on the form control to give us another clue. For example, a XForms input control may appear as a text field or as a datepicker depending on whether it is bound to a xsd:string type or a xsd:date type. When a xf:output binds to a node that has a type of xsd:date, we output the date value as plain text. An output bound to a date and also having @appearance='full' will display as a calendar.</p> - -<p>This article uses several notations. If you see <small>Fx 3.0 only</small>, that means that the control will only be available for Firefox 3.0 (Gecko 1.9). There are several possible reasons for this restriction. The first is that the changes required for such controls could not be safely made to Firefox 1.5 or Firefox 2.0. The second is that the control is introduced in XForms 1.1 and we don't feel adding the enhancement would be prudent until the 1.1 spec is more stable. For instance, when the spec reaches 'recommendation'-level status. If you see <small>xhtml/xul</small> then it means the control is available when XForms is hosted in either XHTML or XUL. Similarly, if you see <small>xhtml only</small> or <small>xul only</small>, then it means the control is available only in that host language.</p> - -<h3 id="Ensembles_d.27attributs" name="Ensembles_d.27attributs">Ensembles d'attributs</h3> - -<p>This section describes attributes that are often used on XForms elements. These attributes are combined into following logical groups.</p> - -<h4 id="UI_Common" name="UI_Common">UI Common</h4> - -<p>The UI Common attribute set (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#attrs-ui-common">spec</a>) contains the attributes that are available for the XForms elements that are used to build the user interface presentation in a form.</p> - -<ul> - <li>appearance - the value provided by the form author gives a hint to the processor as to which widget to use to represent the XForms control. Three possible values are available to the author: minimal, compact and full. Generally speaking, the main purpose for these values is to reflect how much space (screen real estate) the displayed widget will take.</li> - <li>navindex - defines the keyboard navigation sequence between controls {{ mediawiki.external('not currently supported') }}.</li> - <li>accesskey - keyboard shortcut for moving focus to an XForms element.</li> -</ul> - -<h4 id="Attributs_de_liaison" name="Attributs_de_liaison">Attributs de liaison</h4> - -<p>Single-Node (see the <a class="external" href="http://www.w3.org/TR/xforms/slice3.html#structure-attrs-single-node">spec</a>) and Node-Set (see the <a class="external" href="http://www.w3.org/TR/xforms/slice3.html#structure-attrs-nodeset">spec</a>) attributes are used to bind XForms elements to instance nodes. These attributes are: ref, nodeset, model and bind.</p> - -<h3 id=".C3.89l.C3.A9ments_XForms" name=".C3.89l.C3.A9ments_XForms">Éléments XForms</h3> - -<p>Almost every XForms element can be presented as one of serveral different kinds of widgets. This section contains a short description of each XForms element and its representation. The XForms specification offers suggestions for some of the representations, but some of the widgets we use are only available in the Mozilla XForms processor. The choice of widget that we use is often determined by the data type of the instance node that the xforms element is bound to. The form author can also influence the widget by using the appearance attribute on the element.</p> - -<h4 id="Module_des_contr.C3.B4les_de_formulaire" name="Module_des_contr.C3.B4les_de_formulaire">Module des contrôles de formulaire</h4> - -<p>This section contains a short description for each form control element.</p> - -<h5 id="input" name="input"><a href="/en-US/docs/XForms/User_Interface_Elements/Input">input</a></h5> - -<p>A key xforms element to show and change the instance data to which it is bound. Usually bound to data that can be well-represented by a string (see the <a class="external" href="http://www.w3.org/TR/xforms11/#ui-input">spec</a>). It can have the following representations:</p> - -<ul> - <li>text field - default representation. Used for most data types, especially text data.</li> - <li>checkbox - used for boolean instance data</li> - <li>datepicker - default representation for date data types. Similar to a combobox. Consists of a text field for direct input and a dropdown calendar that can also be used to input the date value.</li> - <li>calendar - used for date data types when appearance = 'full'.</li> - <li>days list - used when the data has a data type of day.</li> - <li>months list - used when the data has a data type of month.</li> - <li>number field - used for numerical data types.</li> -</ul> - -<h5 id="UieXFormsSecret" name="UieXFormsSecret"><a href="/en-US/docs/XForms/User_Interface_Elements/Secret">secret</a></h5> - -<p>Used for inputting passwords. Each character typed by the user is represented by an asterisk on the screen (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-secret">spec</a>).</p> - -<h5 id="UieXFormsTextarea" name="UieXFormsTextarea"><a href="/en-US/XForms/User_Interface_Elements/Textarea">textarea</a></h5> - -<p>Serves to show/change multiline text (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-textarea">spec</a>).</p> - -<h5 id="UieXFormsOutput" name="UieXFormsOutput"><a href="/en-US/XForms/User_Interface_Elements/Output">output</a></h5> - -<p>Serves to show the instance data that the element is bound to in a read-only manner (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-output">spec</a>). It can have the following presentations:</p> - -<ul> - <li>text - default representation for data of most types, especially static text.</li> - <li>calendar - used for date data types when appearance = 'full'.</li> - <li>image - if the instance node contains an image, then an output element can be used in combination with the mediatype element to display the image.</li> -</ul> - -<h5 id="UieXFormsUpload" name="UieXFormsUpload"><a href="/en-US/XForms/User_Interface_Elements/Upload">upload</a></h5> - -<p>Provides a means for the user to select a file (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-upload">spec</a>).</p> - -<h5 id="UieXFormsRange" name="UieXFormsRange"><a href="/en-US/XForms/User_Interface_Elements/Range">range</a></h5> - -<p>Allows the user to choose a value from within a specific range of values. It is represented by a slider widget (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-range">spec</a>).</p> - -<h5 id="UieXFormsTrigger" name="UieXFormsTrigger"><a href="/en-US/XForms/User_Interface_Elements/Trigger">trigger</a></h5> - -<p>Allows the user to initiate actions (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-trigger">spec</a>). It can have the following representations:</p> - -<ul> - <li>button - default representation.</li> - <li>link/clickable text - used when appearance = 'minimal'.</li> -</ul> - -<h5 id="UieXFormsSubmit" name="UieXFormsSubmit"><a href="/en-US/XForms/User_Interface_Elements/Submit">submit</a></h5> - -<p>Invokes the submission of the selected instance data to its target destination, which could be local or remote (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-submit">spec</a>). It can have the following representations:</p> - -<ul> - <li>button - default representation.</li> - <li>link/clickable text - used when appearance = 'minimal'.</li> -</ul> - -<h5 id="UieXFormsSelect" name="UieXFormsSelect"><a href="/en-US/XForms/User_Interface_Elements/select">select</a></h5> - -<p>List control. Allows the user to choose one or multiple values from a list of pre-defined values (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-selectMany">spec</a>). It can have the following representations:</p> - -<ul> - <li>listbox - default representation</li> - <li>checkbox group - used when appearance = 'full'</li> -</ul> - -<h5 id="UieXFormsSelect1" name="UieXFormsSelect1"><a href="/en-US/XForms/User_Interface_Elements/Select1">select1</a></h5> - -<p>Combobox control. Allows the user to choose a single value from a list of pre-defined values (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-selectOne">spec</a>). It can have the following representations:</p> - -<ul> - <li>combobox - default representation</li> - <li>listbox - used when appearance = 'compact'</li> - <li>radio group - used when appearance = 'full'</li> -</ul> - -<h4 id=".C3.89l.C3.A9ments_suppl.C3.A9mentaires" name=".C3.89l.C3.A9ments_suppl.C3.A9mentaires">Éléments supplémentaires</h4> - -<p>These elements may be used as child elements to the form controls described above.</p> - -<h5 id="UieXFormsLabel" name="UieXFormsLabel"><a href="/en-US/XForms/User_Interface_Elements/Label">label</a></h5> - -<p>Specifies the label for the xforms control (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-selectMany">spec</a>). Every form control other than the output element must contain a label element. It is valid for a form control to have an empty label element.</p> - -<h5 id="UieXFormsHelp" name="UieXFormsHelp"><a href="/en-US/XForms/User_Interface_Elements/Help">help</a></h5> - -<p>Specifies contextual help for the containing form control (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-commonelems-help">spec</a>). The help will be displayed if the F1 key is pressed while the containing form control has focus.</p> - -<h5 id="UieXFormsHint" name="UieXFormsHint"><a href="/en-US/XForms/User_Interface_Elements/Hint">hint</a></h5> - -<p>Similar to a tooltip (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-commonelems-hint">spec</a>). The hint is displayed when the mouse moves and pauses over the containing form control.</p> - -<h5 id="UieXFormsAlert" name="UieXFormsAlert"><a href="/en-US/XForms/User_Interface_Elements/Alert">alert</a></h5> - -<p>This message will be shown when the form control cannot properly bind to instance data or when the instance data value is invalid or out of the specified range of selectable values (see the <a class="external" href="http://www.w3.org/TR/xforms/slice8.html#ui-common-elements-alert">spec</a>).</p> - -<h5 id="UieXFormsMessage" name="UieXFormsMessage"><a href="/en-US/XForms/User_Interface_Elements/Message">message</a></h5> - -<p>Used in combination with event listeners to display a message to the user when the specified event occurs (see the <a class="external" href="http://www.w3.org/TR/xforms/slice10.html#action-info">spec</a>).</p> - -<h4 id="Interface_utilisateur_de_XForms" name="Interface_utilisateur_de_XForms">Interface utilisateur de XForms</h4> - -<p>These elements are mainly used to organize and manage the form's markup.</p> - -<p>They can be bound to instance nodes to define context for the xforms controls that they contain, should any of their child nodes happen to use relative xpath expressions. Binding these elements to instance data is also a way to apply Model Item Properties (for example, relevancy) to the elements.</p> - -<p>Elements in this section do not have any behaviors that are dependent on the host language.</p> - -<h5 id="UieXFormsGroup" name="UieXFormsGroup"><a href="/en-US/XForms/User_Interface_Elements/Group">group</a></h5> - -<p>This element is used to logically group xforms elements together (see the <a class="external" href="http://www.w3.org/TR/xforms/slice9.html#ui-group">spec</a>).</p> - -<h5 id="UieXFormsSwitch" name="UieXFormsSwitch"><a href="/en-US/XForms/User_Interface_Elements/Switch">switch</a></h5> - -<p>This element is used in conjunction with 'case' and 'toggle' elements (see the <a class="external" href="http://www.w3.org/TR/xforms/slice9.html#ui-conditional">spec</a>). The 'switch' element contains 'case' elements which in turn contain markup. Only the contents of a single case may be displayed at one time. The 'toggle' element is used (as an event handler) to make a 'case' visible and thereby hiding all other cases contained by the same 'switch'.</p> - -<h5 id="UieXFormsRepeat" name="UieXFormsRepeat"><a href="/en-US/XForms/User_Interface_Elements/Repeat">repeat</a></h5> - -<p>A repeat element contains markup and is itself bound to a nodeset in an instance document (see the <a class="external" href="http://www.w3.org/TR/xforms/slice9.html#ui-repeat">spec</a>). For each node in the nodeset, the contents of the repeat element will be displayed in the form. That node will serve as the context node for any relative xpath expressions in that set of repeated markup. For example, if a repeat is bound to a nodeset that contains 5 nodes and the repeat contains an 'output' element that echoes the current node, then the user will see 5 outputs in the form. Combined together, these outputs would echo the value of every node in the selected nodeset.</p> |