From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove 
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 files/fr/web/api/idbdatabase/close/index.html      |  2 +-
 files/fr/web/api/idbdatabase/index.html            |  9 +++----
 files/fr/web/api/idbdatabase/name/index.html       |  6 +++--
 .../api/idbdatabase/objectstorenames/index.html    |  4 ++-
 .../fr/web/api/idbdatabase/transaction/index.html  | 31 +++++++++-------------
 files/fr/web/api/idbdatabase/version/index.html    |  4 +--
 6 files changed, 27 insertions(+), 29 deletions(-)

(limited to 'files/fr/web/api/idbdatabase')

diff --git a/files/fr/web/api/idbdatabase/close/index.html b/files/fr/web/api/idbdatabase/close/index.html
index 26473ab2d7..63f025584d 100644
--- a/files/fr/web/api/idbdatabase/close/index.html
+++ b/files/fr/web/api/idbdatabase/close/index.html
@@ -26,7 +26,7 @@ translation_of: Web/API/IDBDatabase/close
 
 
Exemple

 
-
// ouverture de la connexion à la base de données toDoList
+
// ouverture de la connexion à la base de données toDoList
   var DBOpenRequest = window.indexedDB.open("toDoList", 4);
 
   // deux gestionnaires d’événements effectuant les
diff --git a/files/fr/web/api/idbdatabase/index.html b/files/fr/web/api/idbdatabase/index.html
index 6a9bfb1fd7..9be924fb0b 100644
--- a/files/fr/web/api/idbdatabase/index.html
+++ b/files/fr/web/api/idbdatabase/index.html
@@ -15,7 +15,7 @@ translation_of: Web/API/IDBDatabase
 
{{AvailableInWorkers}}

 
 

-
Note : Tout ce qui est fait dans une base de données indexée s'inscrit dans le contexte d'une transaction qui représente un interaction avec les données dans la base. Tout les objets de l'interface IndexedDB (incluant les accès aux magasins d'objets, indexes et curseurs) sont liés à une transaction en particulier. Aussi, on ne peut pas exécuter une commande, accéder aux données ou ouvrir quoi que ce soit, en dehors d'une transaction.

+
Note : Tout ce qui est fait dans une base de données indexée s'inscrit dans le contexte d'une transaction qui représente un interaction avec les données dans la base. Tout les objets de l'interface IndexedDB (incluant les accès aux magasins d'objets, indexes et curseurs) sont liés à une transaction en particulier. Aussi, on ne peut pas exécuter une commande, accéder aux données ou ouvrir quoi que ce soit, en dehors d'une transaction.

 

 
 
Méthodes

@@ -53,14 +53,13 @@ translation_of: Web/API/IDBDatabase
  
S’exécute au déclenchement de l'événement error quand la connexion à la base de donnée échoue.

  
{{domxref("IDBDatabase.onversionchange")}}

  
S’exécute au déclenchement de l'événement versionchange quand la structure de la base de donnée change (l'événement {{domxref("IDBOpenDBRequest.onupgradeneeded")}} ou {{domxref("IDBFactory.deleteDatabase")}} à été demandé ailleurs (probablement dans une autre fenêtre ou onglet sur le même ordinateur). Cela est différent de la transaction correspondant à un changement de version (cf. {{domxref("IDBVersionChangeEvent")}}) mais les concepts sont liés.

- 

- 
Exemples

- 

 
 
+
Exemples

+
 
Dans le fragment de code suivant, on ouvre une base de données de façon asynchrone avec {{domxref("IDBFactory")}} puis on gère les cas de succès et d'erreur avant de créer un nouveau magasin d'objet au cas où une mise à jour est nécessaire ({{domxref("IDBdatabase")}}). Pour étudier un exemple complet et fonctionnel, voir notre application To-do Notifications (voir l'exemple live).

 
-
// On ouvre la base de données
+
// On ouvre la base de données
   var DBOpenRequest = window.indexedDB.open("toDoList", 4);
 
   // On ajoute les deux gestionnaires d'événements
diff --git a/files/fr/web/api/idbdatabase/name/index.html b/files/fr/web/api/idbdatabase/name/index.html
index c2247da499..635a6ae383 100644
--- a/files/fr/web/api/idbdatabase/name/index.html
+++ b/files/fr/web/api/idbdatabase/name/index.html
@@ -26,7 +26,7 @@ translation_of: Web/API/IDBDatabase/name
 
 
Cet exemple affiche le nom de la base de données qui est ouverte. La connexion (l'objet {{domxref("IDBDatabase")}}) est affectée à la variable db, puis sa propriété name est affichée dans la console.

 
-
// Connexion à la base de données
+
// Connexion à la base de données
 var DBOpenRequest = window.indexedDB.open("toDoList", 4);
 
 // Les deux gestionnaires d'événement activés pour
@@ -48,7 +48,9 @@ DBOpenRequest.onsuccess = function(event) {
   console.log(db.name);
 };

 
-
Pour un exemple fonctionnel complet, voir notre To-do Notifications (voir l'exemple live).

+

+  
Note : Pour un exemple fonctionnel complet, voir notre To-do Notifications (voir l'exemple live).

+

 
 
Spécifications

 
diff --git a/files/fr/web/api/idbdatabase/objectstorenames/index.html b/files/fr/web/api/idbdatabase/objectstorenames/index.html
index 95de1826a2..f9263bdf33 100644
--- a/files/fr/web/api/idbdatabase/objectstorenames/index.html
+++ b/files/fr/web/api/idbdatabase/objectstorenames/index.html
@@ -45,7 +45,9 @@ DBOpenRequest.onsuccess = function(event) {
   console.log(db.objectStoreNames);
 };

 
-
Pour un exemple fonctionnel complet, voir notre application de démo To-do Notifications (l'exemple live).

+

+  
Note :Pour un exemple fonctionnel complet, voir notre application de démo To-do Notifications (l'exemple live).

+

 
 
Spécifications

 
diff --git a/files/fr/web/api/idbdatabase/transaction/index.html b/files/fr/web/api/idbdatabase/transaction/index.html
index 501c1fe7a3..531edfbdb2 100644
--- a/files/fr/web/api/idbdatabase/transaction/index.html
+++ b/files/fr/web/api/idbdatabase/transaction/index.html
@@ -19,18 +19,14 @@ translation_of: Web/API/IDBDatabase/transaction
 
 

  
storeNames

- 
un tableau de noms de magasins d'objets entrant dans le cadre de cette transaction. Indique seulement les magasins d'objets dont on a besoin.

- Si l’on n’a besoin que d’un seul magasin d'objet, on peut simplement passer son nom. Les lignes suivantes sont équivalentes :
+ 
un tableau de noms de magasins d'objets entrant dans le cadre de cette transaction. Indique seulement les magasins d'objets dont on a besoin. Si l’on n’a besoin que d’un seul magasin d'objet, on peut simplement passer son nom. Les lignes suivantes sont équivalentes :

  
var transaction = db.transaction(['my-store-name']);
 var transaction = db.transaction('my-store-name');

- Pour utiliser tous les magasins d'objets de la base de donnée, on peut appeler la methode {{domxref("IDBDatabase.objectStoreNames")}}:
-
+ 
Pour utiliser tous les magasins d'objets de la base de donnée, on peut appeler la methode {{domxref("IDBDatabase.objectStoreNames")}}:

  
var transaction = db.transaction(db.objectStoreNames);

- Passer un tableau vide lèvera une exception.

+ 
Passer un tableau vide lèvera une exception.

  
mode {{optional_inline}}

- 

- 
Le {{domxref("IDBTransactionMode","mode")}} d’{{domxref("IDBObjectStore","accès aux magasins d'objets")}} à la base de données (par default readonly):

-
+ 
Le {{domxref("IDBTransactionMode","mode")}} d’{{domxref("IDBObjectStore","accès aux magasins d'objets")}} à la base de données (par default readonly):

  
@@ -40,32 +36,30 @@ var transaction = db.transaction('my-store-name');
-    
+    
-    
+    
-   
+   
-    
+    

   
    

   

   
    
readonlyreadonly
     permet de prendre des objets dans les magasins d'objets, de lire les index et de faire des curseurs.
    

    
readwritereadwrite
     Permet en plus de que l'on peut faire en readonly, d’ajouter et mettre à jour des objets dans les magasins d'objets.
    

     versionchange
     Permet toute les opérations, y compris celles qui suppriment ou ajoutent des {{domxref("IDBOjectStore","magasins d'objets")}} ou des {{domxref("IDBIndex","index")}}. Ce mode met à jour le numéro de version de la base de données, il se sert au début de {{domxref ("IDBDatabase.setVersion")}}. Les {{domxref("IDBTransaction","transactions")}} dans ce mode ne peuvent pas fonctionner en même temps que d'autres.
    

    
readwriteflushreadwriteflush
     
      
Si vous devez vous assurer de l'efficacité d'une transaction pour une raison quelconque (par exemple, vous stockez des données critiques qui ne peuvent être recalculées plus tard), vous pouvez forcer l’enregistrement complet sur disque avant de déclencher l’événement complete en utilisant le mode readwriteflush (non standard) expérimental ( voir {{domxref("IDBDatabase.transaction")}} ). C'est expérimental, et ne peut être utilisé que si le  dom.indexedDB.experimental  pref est réglé sur  true  dans  about:config.

 
-     
Depuis Firefox 40, les transactions IndexedDB diminuent en efficacité pour gagner en efficience (voir {{Bug ( "1112702")}}.) Auparavant, dans une transaction en readwrite l'événement complete était déclanché seulement lorsque toutes les données étaient écrites sur le disque. Maintenant l'événement complete est déclenché après que l'OS ai envoyé l'ordre d'écrire les données, mais potentiellement avant qu'elles aient été écrites sur le disque. L'événement complete peut ainsi se déclancher plus rapidement qu'auparavant, cependant, il existe une chance infime pour que l'ensemble de la transaction soit perdue si le système d'exploitation plante ou s'il y a une perte de courant avant que les données aient été écites sur le disque. Étant donné que ces événements catastrophiques sont rares la plupart des utilisateurs ne devraient pas avoir à s'en préoccuper davantage.

+     
Note : Depuis Firefox 40, les transactions IndexedDB diminuent en efficacité pour gagner en efficience (voir {{Bug ( "1112702")}}.) Auparavant, dans une transaction en readwrite l'événement complete était déclanché seulement lorsque toutes les données étaient écrites sur le disque. Maintenant l'événement complete est déclenché après que l'OS ai envoyé l'ordre d'écrire les données, mais potentiellement avant qu'elles aient été écrites sur le disque. L'événement complete peut ainsi se déclancher plus rapidement qu'auparavant, cependant, il existe une chance infime pour que l'ensemble de la transaction soit perdue si le système d'exploitation plante ou s'il y a une perte de courant avant que les données aient été écites sur le disque. Étant donné que ces événements catastrophiques sont rares la plupart des utilisateurs ne devraient pas avoir à s'en préoccuper davantage.

     		
    

   
  

- {{note("Pour éviter des pertes de performance, n’utilisez le mode readwrite que si vous avez effectivement besoin d’écrire ou de mettre à jour des données sur la base.")}} Si on a besoin d’accéder à un magasin d'objets pour écrire ou mettre à jour des enregistrement, on utilise la sytaxe:
-
+ 
Pour éviter des pertes de performance, n’utilisez le mode readwrite que si vous avez effectivement besoin d’écrire ou de mettre à jour des données sur la base.")}} Si on a besoin d’accéder à un magasin d'objets pour écrire ou mettre à jour des enregistrement, on utilise la sytaxe:

  
var transaction = db.transaction('monMagasin','readwrite');

  

- 
 

 

 
 
Renvoie

@@ -121,7 +115,8 @@ transaction.onerror = function(event) {
 var objectStore = transaction.objectStore("toDoList");
 // etc.

 
-
Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

+
Note :Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

+

 
 
Spécification

 
@@ -153,5 +148,5 @@ var objectStore = transaction.objectStore("toDoList");
  
  • {{domxref("IDBKeyRange","Définir l'intervalle des clés")}}
    • 
  
  • {{domxref("IDBObjectStore","Accès aux magasins d'objets")}}
    • 
  
  • {{domxref("IDBCursor","Utiliser les curseur")}}
    • 
- 
  • Exemple de référence: To-do Notifications (view example live.)
    • 
+ 
  • Exemple de référence: To-do Notifications (view example live.)
    • 
 
diff --git a/files/fr/web/api/idbdatabase/version/index.html b/files/fr/web/api/idbdatabase/version/index.html
index c692965224..81289060e2 100644
--- a/files/fr/web/api/idbdatabase/version/index.html
+++ b/files/fr/web/api/idbdatabase/version/index.html
@@ -25,7 +25,7 @@ translation_of: Web/API/IDBDatabase/version
 
 
    Exemples
    
 
-
    // On ouvre la base de données
+
    // On ouvre la base de données
 var DBOpenRequest = window.indexedDB.open("toDoList", 4);
 
 //  On déclare des gestionnaires d'évènements pour l'ouverture
@@ -73,5 +73,5 @@ DBOpenRequest.onsuccess = function(event) {
  
  • Définir un intervalle de clés : {{domxref("IDBKeyRange")}}
    • 
  
  • Récupérer et modifier les données : {{domxref("IDBObjectStore")}}
    • 
  
  • Utiliser les curseurs {{domxref("IDBCursor")}}
    • 
- 
  • Exemple de référence : To-do Notifications (exemple live).
    • 
+ 
  • Exemple de référence : To-do Notifications (exemple live).
    • 
 
-- 
cgit v1.2.3-54-g00ecf