diff options
Diffstat (limited to 'files/fr/web/api/idbindex/locale/index.md')
-rw-r--r-- | files/fr/web/api/idbindex/locale/index.md | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/files/fr/web/api/idbindex/locale/index.md b/files/fr/web/api/idbindex/locale/index.md new file mode 100644 index 0000000000..6f91a28888 --- /dev/null +++ b/files/fr/web/api/idbindex/locale/index.md @@ -0,0 +1,83 @@ +--- +title: IDBIndex.locale +slug: Web/API/IDBIndex/locale +translation_of: Web/API/IDBIndex/locale +--- +<div>{{APIRef("IndexedDB")}}{{SeeCompatTable}}</div> + +<p>La propriété <strong><code>locale</code></strong> de l'interface {{domxref("IDBIndex")}} renvoie la localisation de l'index (par exemple fr, ou <code>en-US</code>) <code>si la localisation à été spécifie lors de la mise en place de l'index</code> (voir les paramètres {{domxref("IDBObjectStore.createIndex")}}).</p> + +<p>{{note("Cette propriété renvoie la localisation utilisé par l'index. En d'autres termes, elle ne renverras jamais 'auto'.")}}</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">var indexLocalisation = myIndex.locale;</pre> + +<h2 id="Valeur">Valeur</h2> + +<p>Une {{domxref("DOMString","chaîne de caractère")}} représentant la localisation courante de l'index.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Dans l'exemple suivant on ouvre une transaction puis un magasin d'objet et enfin l'index <code>lName</code>.</p> + +<p>La valeur de la propriété <code>Locale</code> est affichée sur la console.</p> + +<p>Finalement, On itère sur tous les enregistrements pour en insérer les données dans un tableau HTML. En utilisant la méthode {{domxref("IDBIndex.openCursor")}} qui travaille de la même façon que la méthode {{domxref("IDBObjectStore.openCursor")}} de l'{{domxref("IDBObjectStore","accès")}} au magasin d'objet sauf que les enregistrements sont renvoyés dans l'ordre de l'index et non celui du magasin d'objet.</p> + +<pre class="brush:js">function displayDataByIndex() { + tableEntry.innerHTML = ''; + + //ouvre un transaction + var transaction = db.transaction(['contactsList'], 'readonly'); + //accés au magasin d'objet + var objectStore = transaction.objectStore('contactsList'); + + //on récupère l'index + var myIndex = objectStore.index('lName'); + //on affiche la propriété locale sur la console + console.log(myIndex.locale); + + //un curseur qui itère sur l'index + myIndex.openCursor().onsuccess = function(event) { + var cursor = event.target.result; + if(cursor) { + var tableRow = document.createElement('tr'); + tableRow.innerHTML = '<td>' + cursor.value.id + '</td>' + + '<td>' + cursor.value.lName + '</td>' + + '<td>' + cursor.value.fName + '</td>' + + '<td>' + cursor.value.jTitle + '</td>' + + '<td>' + cursor.value.company + '</td>' + + '<td>' + cursor.value.eMail + '</td>' + + '<td>' + cursor.value.phone + '</td>' + + '<td>' + cursor.value.age + '</td>'; + tableEntry.appendChild(tableRow); + + cursor.continue(); + } else { + console.log('Tous les enregistrements ont été affichés.'); + } + }; +};</pre> + +<div class="note"><p><strong>Note :</strong> Pour un exemple de travail complet, voir notre <a href="https://github.com/mdn/to-do-notifications/">To-do Notifications</a> app (<a href="http://mdn.github.io/to-do-notifications/">view example live</a>).</p></div> + +<h2 id="Spécification">Spécification</h2> + +<p>Ne fait actuellement partie d'aucune spécification.</p> + +<h2 id="Compatibilité_avec_les_navigateurs">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.IDBIndex.locale")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{domxref("IndexedDB_API.Using_IndexedDB","Utiliser IndexedDB")}}</li> + <li>{{domxref("IDBDatabase","Débuter une connexion")}}</li> + <li>{{domxref("IDBTransaction","Utilisé les transactions")}}</li> + <li>{{domxref("IDBKeyRange","Définir l'intervalle des clés")}}</li> + <li>{{domxref("IDBObjectStore","Accès aux magasins d'objets")}}</li> + <li>{{domxref("IDBCursor","Utiliser les curseur")}}</li> + <li>Exemple de référence: <a href="https://github.com/mdn/to-do-notifications/tree/gh-pages">To-do Notifications</a> (<a href="http://mdn.github.io/to-do-notifications/">view example live</a>.)</li> +</ul> |