From 61dde9968fe81546497fc23ef73908221e8cb06c Mon Sep 17 00:00:00 2001 From: julieng Date: Thu, 11 Nov 2021 08:14:10 +0100 Subject: move *.html to *.md --- files/fr/web/guide/ajax/community/index.html | 13 - files/fr/web/guide/ajax/community/index.md | 13 + files/fr/web/guide/ajax/getting_started/index.html | 276 ------------ files/fr/web/guide/ajax/getting_started/index.md | 276 ++++++++++++ files/fr/web/guide/ajax/index.html | 107 ----- files/fr/web/guide/ajax/index.md | 107 +++++ files/fr/web/guide/api/index.html | 24 - files/fr/web/guide/api/index.md | 24 + .../index.html | 38 -- .../index.md | 38 ++ .../buffering_seeking_time_ranges/index.html | 218 --------- .../buffering_seeking_time_ranges/index.md | 218 +++++++++ .../web/guide/audio_and_video_delivery/index.html | 485 --------------------- .../fr/web/guide/audio_and_video_delivery/index.md | 485 +++++++++++++++++++++ .../live_streaming_web_audio_and_video/index.html | 289 ------------ .../live_streaming_web_audio_and_video/index.md | 289 ++++++++++++ .../guide/audio_and_video_manipulation/index.html | 361 --------------- .../guide/audio_and_video_manipulation/index.md | 361 +++++++++++++++ .../guide/css/block_formatting_context/index.html | 45 -- .../guide/css/block_formatting_context/index.md | 45 ++ files/fr/web/guide/graphics/index.html | 46 -- files/fr/web/guide/graphics/index.md | 46 ++ .../web/guide/html/content_categories/index.html | 176 -------- .../fr/web/guide/html/content_categories/index.md | 176 ++++++++ .../fr/web/guide/html/editable_content/index.html | 37 -- files/fr/web/guide/html/editable_content/index.md | 37 ++ files/fr/web/guide/index.html | 58 --- files/fr/web/guide/index.md | 58 +++ .../introduction_to_web_development/index.html | 31 -- .../guide/introduction_to_web_development/index.md | 31 ++ files/fr/web/guide/mobile/index.html | 44 -- files/fr/web/guide/mobile/index.md | 44 ++ files/fr/web/guide/performance/index.html | 20 - files/fr/web/guide/performance/index.md | 20 + files/fr/web/guide/user_input_methods/index.html | 186 -------- files/fr/web/guide/user_input_methods/index.md | 186 ++++++++ .../writing_forward-compatible_websites/index.html | 138 ------ .../writing_forward-compatible_websites/index.md | 138 ++++++ 38 files changed, 2592 insertions(+), 2592 deletions(-) delete mode 100644 files/fr/web/guide/ajax/community/index.html create mode 100644 files/fr/web/guide/ajax/community/index.md delete mode 100644 files/fr/web/guide/ajax/getting_started/index.html create mode 100644 files/fr/web/guide/ajax/getting_started/index.md delete mode 100644 files/fr/web/guide/ajax/index.html create mode 100644 files/fr/web/guide/ajax/index.md delete mode 100644 files/fr/web/guide/api/index.html create mode 100644 files/fr/web/guide/api/index.md delete mode 100644 files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.html create mode 100644 files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.md delete mode 100644 files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.html create mode 100644 files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.md delete mode 100644 files/fr/web/guide/audio_and_video_delivery/index.html create mode 100644 files/fr/web/guide/audio_and_video_delivery/index.md delete mode 100644 files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.html create mode 100644 files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.md delete mode 100644 files/fr/web/guide/audio_and_video_manipulation/index.html create mode 100644 files/fr/web/guide/audio_and_video_manipulation/index.md delete mode 100644 files/fr/web/guide/css/block_formatting_context/index.html create mode 100644 files/fr/web/guide/css/block_formatting_context/index.md delete mode 100644 files/fr/web/guide/graphics/index.html create mode 100644 files/fr/web/guide/graphics/index.md delete mode 100644 files/fr/web/guide/html/content_categories/index.html create mode 100644 files/fr/web/guide/html/content_categories/index.md delete mode 100644 files/fr/web/guide/html/editable_content/index.html create mode 100644 files/fr/web/guide/html/editable_content/index.md delete mode 100644 files/fr/web/guide/index.html create mode 100644 files/fr/web/guide/index.md delete mode 100644 files/fr/web/guide/introduction_to_web_development/index.html create mode 100644 files/fr/web/guide/introduction_to_web_development/index.md delete mode 100644 files/fr/web/guide/mobile/index.html create mode 100644 files/fr/web/guide/mobile/index.md delete mode 100644 files/fr/web/guide/performance/index.html create mode 100644 files/fr/web/guide/performance/index.md delete mode 100644 files/fr/web/guide/user_input_methods/index.html create mode 100644 files/fr/web/guide/user_input_methods/index.md delete mode 100644 files/fr/web/guide/writing_forward-compatible_websites/index.html create mode 100644 files/fr/web/guide/writing_forward-compatible_websites/index.md diff --git a/files/fr/web/guide/ajax/community/index.html b/files/fr/web/guide/ajax/community/index.html deleted file mode 100644 index 935a72879e..0000000000 --- a/files/fr/web/guide/ajax/community/index.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Communauté -slug: Web/Guide/AJAX/Community -tags: - - AJAX -translation_of: Web/Guide/AJAX/Community -original_slug: Web/Guide/AJAX/Communauté ---- -

-

Si vous connaissez d'autres listes de diffusion, newsgroups, forums ou d'autres communautés ayant trait à AJAX, n'hésitez pas à ajouter un lien ci-dessous. -

http://www.ajaxlines.com (anglais) - Très grosse collection de ressources AJAX, de tutoriels, d'outils et de sites web sur le sujet. -

http://www.ajaxmatters.com - Portail d'informations sur AJAX et les technologies Web associées (anglais). -

\ No newline at end of file diff --git a/files/fr/web/guide/ajax/community/index.md b/files/fr/web/guide/ajax/community/index.md new file mode 100644 index 0000000000..935a72879e --- /dev/null +++ b/files/fr/web/guide/ajax/community/index.md @@ -0,0 +1,13 @@ +--- +title: Communauté +slug: Web/Guide/AJAX/Community +tags: + - AJAX +translation_of: Web/Guide/AJAX/Community +original_slug: Web/Guide/AJAX/Communauté +--- +

+

Si vous connaissez d'autres listes de diffusion, newsgroups, forums ou d'autres communautés ayant trait à AJAX, n'hésitez pas à ajouter un lien ci-dessous. +

http://www.ajaxlines.com (anglais) - Très grosse collection de ressources AJAX, de tutoriels, d'outils et de sites web sur le sujet. +

http://www.ajaxmatters.com - Portail d'informations sur AJAX et les technologies Web associées (anglais). +

\ No newline at end of file diff --git a/files/fr/web/guide/ajax/getting_started/index.html b/files/fr/web/guide/ajax/getting_started/index.html deleted file mode 100644 index 9aa61def8d..0000000000 --- a/files/fr/web/guide/ajax/getting_started/index.html +++ /dev/null @@ -1,276 +0,0 @@ ---- -title: Premiers pas -slug: Web/Guide/AJAX/Getting_Started -tags: - - AJAX -translation_of: Web/Guide/AJAX/Getting_Started -original_slug: Web/Guide/AJAX/Premiers_pas ---- -

Cet article vous guide à travers les bases d’AJAX et vous donne deux exemples clefs-en-main pour débuter.

- -

Présentation d’AJAX

- -

AJAX est un raccourci pour Asynchronous JavaScript And XML (JavaScript asynchrone et XML) inventé par Jesse James Garrett. Pour simplifier, il s’agit d’employer l’objet XMLHttpRequest pour communiquer avec des serveurs. Il peut envoyer et recevoir des informations sous différents formats, dont JSON, XML, HTML ou texte. Son principal attrait est sa nature « asynchrone » ce qui signifie qu’il peut communiquer avec le serveur, échanger des données et mettre à jour la page sans avoir à la recharger.

- -

Les deux principales fonctionnalités d’AJAX permettent de :

- - - -

Étape 1 — Lancement d’une requête HTTP

- -

Pour faire une requête HTTP vers le serveur à l’aide de JavaScript, il faut disposer d’une instance d’objet fournissant cette fonctionnalité. C’est ici que XMLHttpRequest intervient. Son prédécesseur est originaire de Internet Explorer sous la forme d’un objet ActiveX appelé XMLHTTP. Par la suite, Mozilla, Safari et d’autres navigateurs ont suivi en implémentant un objet XMLHttpRequest qui fournit les mêmes méthodes et propriétés que l’objet ActiveX original de Microsoft. Entre temps, Microsoft a également implémenté XMLHttpRequest.

- -
// ancien code de compatibilité, aujourd’hui inutile
-if (window.XMLHttpRequest) { // Mozilla, Safari, IE7+...
-    httpRequest = new XMLHttpRequest();
-}
-else if (window.ActiveXObject) { // IE 6 et antérieurs
-    httpRequest = new ActiveXObject("Microsoft.XMLHTTP");
-}
- -
-

Note : Pour illustrer le principe, le code ci-dessus est une version un peu simplifiée de celui qui est utilisé pour créer une instance XMLHTTP. Pour un exemple plus réaliste, voir l’étape 3 de cet article.

-
- -

Après avoir fait une requête, vous recevrez une réponse du serveur. À ce stade, vous devez indiquer à l’objet httpRequest le nom de la fonction JavaScript qui traitera la réponse. Pour cela, assignez à la propriété onreadystatechange de l’objet le nom de la fonction JavaScript que vous envisagez d’utiliser, comme ceci :

- -
httpRequest.onreadystatechange = nomDeLaFonction;
- -

Notez qu’il n’y a ni parenthèses ni paramètres après le nom de la fonction, car vous ne faites qu’assigner une référence à la fonction sans l’appeler réellement. Alternativement, au lieu de donner un nom de fonction, vous pouvez utiliser la technique JavaScript de définition de fonctions à la volée (ce qu’on appelle une fonction anonyme), et définir à cet endroit les actions à effectuer sur la réponse, comme ceci :

- -
httpRequest.onreadystatechange = function() {
-    // instructions de traitement de la réponse
-};
-
- -

Ensuite, après avoir déclaré ce qui se produit lorsque la réponse est reçue, il s’agit de lancer effectivement la requête. Il faut pour cela appeler les méthodes open() et send() de l’objet httpRequest, comme ceci :

- -
httpRequest.open('GET', 'http://www.example.org/some.file', true);
-httpRequest.send();
- - - -

Le paramètre de la méthode send() peut être n’importe quelle donnée que vous voulez envoyer au serveur en cas d’utilisation de la méthode POST. Les données doivent être sous la forme d’une chaîne de requête, comme :

- -
"nom=valeur&autrenom="+encodeURIComponent(autrevaleur)+"&ainsi=desuite"
- -

Ou d’autres formats tels que multipart/form-data, JSON, XML, etc.

- -

Notez que si vous voulez envoyer des données avec la méthode POST, vous aurez peut-être à changer le type MIME de la requête. Par exemple, utilisez ce qui suit avant d’appeler send() pour envoyer des données de formulaire en tant que chaîne de requête :

- -
httpRequest.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
-
- -

Étape 2 — Gestion de la réponse du serveur

- -

Lors de l’envoi de la requête, vous avez désigné une fonction JavaScript pour traiter la réponse.

- -
httpRequest.onreadystatechange = nomDeLaFonction;
- -

Voyons maintenant ce que cette fonction doit faire. Tout d’abord, elle doit vérifier l’état de la requête. Si cet état a la valeur de XMLHttpRequest.DONE (ce qui correspond à 4), cela signifie que la réponse du serveur a été reçue dans son intégralité et qu’elle peut maintenant être traitée.

- -
if (httpRequest.readyState === XMLHttpRequest.DONE) {
-    // tout va bien, la réponse a été reçue
-} else {
-    // pas encore prête
-}
- -

La liste complète des valeurs de readyState est documentée sur XMLHttpRequest.readyState et se résume de cette façon :

- - - -

Ensuite, vérifiez le code de statut HTTP de la réponse du serveur. Tous les codes possibles sont listés sur le site du W3C. Dans l’exemple qui suit, nous différencions un appel réussi ou échoué en vérifiant la réception d’un code 200 OK.

- -
if (httpRequest.status === 200) {
-    // parfait !
-} else {
-    // il y a eu un problème avec la requête,
-    // par exemple la réponse peut être un code 404 (Non trouvée)
-    // ou 500 (Erreur interne au serveur)
-}
-
- -

Après avoir vérifié l’état de la requête et le code de statut HTTP de la réponse, vous pouvez traiter à votre guise les données envoyées par le serveur. Il existe deux manières d’accéder à ces données :

- - - -

Notez que les étapes ci-dessus sont valides uniquement si vous utilisez une requête asynchrone (Le 3e paramètre d’open() n’a pas été spécifié, ou a été défini à true). Si vous utilisez une requête synchrone, vous n’avez pas besoin de spécifier une fonction, mais c’est fortement découragé car cela entraîne une mauvaise expérience utilisateur.

- -

Étape 3 — Un exemple simple

- -

Rassemblons tous ces éléments dans un exemple : une requête HTTP simple. Notre JavaScript demande un document HTML, test.html, qui contient le texte « Je suis un test. », puis nous affichons le contenu de la réponse dans un message alert(). Remarquez que cet exemple n’utilise que du pur JavaScript vanilla (pas de jQuery). D’autre part, les fichiers HTML, XML et PHP doivent être placés dans le même dossier.

- -
<button id="ajaxButton" type="button">Faire une requête</button>
-
-<script>
-(function() {
-  var httpRequest;
-  document.getElementById("ajaxButton").addEventListener('click', makeRequest);
-
-  function makeRequest() {
-    httpRequest = new XMLHttpRequest();
-
-    if (!httpRequest) {
-      alert('Abandon :( Impossible de créer une instance de XMLHTTP');
-      return false;
-    }
-    httpRequest.onreadystatechange = alertContents;
-    httpRequest.open('GET', 'test.html');
-    httpRequest.send();
-  }
-
-  function alertContents() {
-    if (httpRequest.readyState === XMLHttpRequest.DONE) {
-      if (httpRequest.status === 200) {
-        alert(httpRequest.responseText);
-      } else {
-        alert('Il y a eu un problème avec la requête.');
-      }
-    }
-  }
-})();
-</script>
- -

Dans cet exemple :

- - - -
-

Note : Si vous envoyez une requête à du code qui renvoie du XML plutôt qu’un fichier HTML statique, vous devez spécifier des en-têtes de réponse pour que cela fonctionne avec Internet Explorer. Si vous ne spécifiez pas l’en-tête Content-Type: application/xml, IE émettra une erreur JavaScript « Objet attendu » après la ligne à laquelle vous avez tenté d’accéder à l’élément XML.

-
- -
-

Note : Si vous ne spécifiez pas l’en-tête Cache-Control: no-cache, le navigateur mettra la réponse en cache et n’effectuera plus jamais la requête ultérieurement, ce qui peut rendre le débogage difficile. Vous pouvez également ajouter un paramètre GET toujours différent, comme un timestamp ou un nombre aléatoire (voir contourner le cache).

-
- -
-

Note : Si la variable httpRequest est utilisée globalement, des appels concurrents à makeRequest() peuvent s’écraser l’un l’autre, provoquant une situation de compétition (race condition). On peut s’en prémunir en déclarant la variable httpRequest locale à une closure contenant les fonctions AJAX.

-
- -

Si une erreur de communication se produit (par exemple le serveur qui cesse de répondre), une exception sera levée dans la méthode onreadystatechange lors de l’accès à la propriété status. Pour atténuer ce problème, vous pouvez entourer votre bloc if...then dans un try...catch :

- -
function alertContents(httpRequest) {
-  try {
-    if (httpRequest.readyState === XMLHttpRequest.DONE) {
-      if (httpRequest.status === 200) {
-        alert(httpRequest.responseText);
-      } else {
-        alert("Un problème est survenu au cours de la requête.");
-      }
-    }
-  }
-  catch( e ) {
-    alert("Une exception s’est produite : " + e.description);
-  }
-}
- -

Étape 4 — Travailler avec des réponses XML

- -

Dans l’exemple précédent, après avoir reçu la réponse à la requête HTTP, nous avons utilisé la propriété responseText de l’objet, qui contenait le contenu du fichier test.html. Essayons maintenant la propriété responseXML.

- -

Tout d’abord, créons un document XML valide qui sera l’objet de la requête. Le document (test.xml) contient ce qui suit :

- -
<?xml version="1.0" ?>
-<root>
-    Je suis un test.
-</root>
-
- -

Dans le script, il est seulement nécessaire de remplacer la ligne de requête par :

- -
...
-onclick="makeRequest('test.xml')">
-...
-
- -

Ensuite, dans alertContents(), il faut remplacer la ligne alert(httpRequest.responseText); par :

- -
var xmldoc = httpRequest.responseXML;
-var root_node = xmldoc.getElementsByTagName('root').item(0);
-alert(root_node.firstChild.data);
-
- -

Ce code prend l’objet XMLDocument donné par responseXML et utilise les méthodes du DOM pour accéder à des données contenues dans le document XML.

- -

Catégories

- -

Interwiki

- -

Étape 5 – Manipuler les données

- -

Pour finir, envoyons quelques données au serveur et réceptionnons la réponse. Notre JavaScript demandera cette fois-ci une page dynamique, test.php, qui prendra notre contenu envoyé et revera une chaîne « calculée » – "Bonjour, [user data] !" – que nous afficherons via alert().

- -

D’abord, nous allons ajouter un boîte de texte dans notre HTML afin que l’utilisateur ou l’utilisatrice puisse saisir son nom :

- -
<label>Vore nom :
-  <input type="text" id="ajaxTextbox" />
-</label>
-<span id="ajaxButton">
-  Lancer une requête
-</span>
- -

Nous allons également ajouter une ligne à notre gestionnaire d’événement pour obtenir les données de la boite de texte et les envoyer à la fonction makeRequest(), ainsi que l’URL de notre script côté serveur :

- -
  document.getElementById("ajaxButton").onclick = function() {
-      var userName = document.getElementById("ajaxTextbox").value;
-      makeRequest('test.php', userName);
-  };
- -

Nous devons modifier makeRequest() afin d’accepter les données et les transmettre au serveur. Nous changerons la méthode de GET à POST et inclurons nos données en paramètres dans l’appel à httpRequest.send() :

- -
  function makeRequest(url, userName) {
-
-    ...
-
-    httpRequest.onreadystatechange = alertContents;
-    httpRequest.open('POST', url);
-    httpRequest.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
-    httpRequest.send('userName=' + encodeURIComponent(userName));
-  }
- -

La fonction alertContents() peut être écrite de la même manière qu’à l’étape 3 pour afficher notre chaîne calculée, si c’est tout ce que le serveur renvoie. Cependant, supposons que le serveur renvoie à la fois la phrase calculée et la donnée originale. Donc si l’utilisateur ou l’utilisatrice a saisi « Dorothée », la réponse du serveur ressemblera à :

- -
{"userData":"Dorothée","computedString":"Bonjour, Dorothée !"}
- -

Pour utiliser cette phrase dans alertContents(), nous ne pouvons pas simplement afficher une alerte avec le contenu de responseText, nous devons l’analyser et afficher computedString, la propriété que nous souhaitons :

- -
function alertContents() {
-  if (httpRequest.readyState === XMLHttpRequest.DONE) {
-    if (httpRequest.status === 200) {
-      var response = JSON.parse(httpRequest.responseText);
-      alert(response.computedString);
-    } else {
-      alert('Un problème est survenu avec la requête.');
-    }
-  }
-}
- -

Le fichier test.php devrait contenir ce qui suit :

- -
$name = (isset($_POST['userName'])) ? $_POST['userName'] : 'anonyme';
-$computedString = 'Bonjour, ' . $name . ' !';
-$array = ['userName' => $name, 'computedString' => $computedString];
-echo json_encode($array);
- -

Pour en savoir sur les méthodes DOM, pensez à lire la Référence du DOM de Mozilla.

diff --git a/files/fr/web/guide/ajax/getting_started/index.md b/files/fr/web/guide/ajax/getting_started/index.md new file mode 100644 index 0000000000..9aa61def8d --- /dev/null +++ b/files/fr/web/guide/ajax/getting_started/index.md @@ -0,0 +1,276 @@ +--- +title: Premiers pas +slug: Web/Guide/AJAX/Getting_Started +tags: + - AJAX +translation_of: Web/Guide/AJAX/Getting_Started +original_slug: Web/Guide/AJAX/Premiers_pas +--- +

Cet article vous guide à travers les bases d’AJAX et vous donne deux exemples clefs-en-main pour débuter.

+ +

Présentation d’AJAX

+ +

AJAX est un raccourci pour Asynchronous JavaScript And XML (JavaScript asynchrone et XML) inventé par Jesse James Garrett. Pour simplifier, il s’agit d’employer l’objet XMLHttpRequest pour communiquer avec des serveurs. Il peut envoyer et recevoir des informations sous différents formats, dont JSON, XML, HTML ou texte. Son principal attrait est sa nature « asynchrone » ce qui signifie qu’il peut communiquer avec le serveur, échanger des données et mettre à jour la page sans avoir à la recharger.

+ +

Les deux principales fonctionnalités d’AJAX permettent de :

+ + + +

Étape 1 — Lancement d’une requête HTTP

+ +

Pour faire une requête HTTP vers le serveur à l’aide de JavaScript, il faut disposer d’une instance d’objet fournissant cette fonctionnalité. C’est ici que XMLHttpRequest intervient. Son prédécesseur est originaire de Internet Explorer sous la forme d’un objet ActiveX appelé XMLHTTP. Par la suite, Mozilla, Safari et d’autres navigateurs ont suivi en implémentant un objet XMLHttpRequest qui fournit les mêmes méthodes et propriétés que l’objet ActiveX original de Microsoft. Entre temps, Microsoft a également implémenté XMLHttpRequest.

+ +
// ancien code de compatibilité, aujourd’hui inutile
+if (window.XMLHttpRequest) { // Mozilla, Safari, IE7+...
+    httpRequest = new XMLHttpRequest();
+}
+else if (window.ActiveXObject) { // IE 6 et antérieurs
+    httpRequest = new ActiveXObject("Microsoft.XMLHTTP");
+}
+ +
+

Note : Pour illustrer le principe, le code ci-dessus est une version un peu simplifiée de celui qui est utilisé pour créer une instance XMLHTTP. Pour un exemple plus réaliste, voir l’étape 3 de cet article.

+
+ +

Après avoir fait une requête, vous recevrez une réponse du serveur. À ce stade, vous devez indiquer à l’objet httpRequest le nom de la fonction JavaScript qui traitera la réponse. Pour cela, assignez à la propriété onreadystatechange de l’objet le nom de la fonction JavaScript que vous envisagez d’utiliser, comme ceci :

+ +
httpRequest.onreadystatechange = nomDeLaFonction;
+ +

Notez qu’il n’y a ni parenthèses ni paramètres après le nom de la fonction, car vous ne faites qu’assigner une référence à la fonction sans l’appeler réellement. Alternativement, au lieu de donner un nom de fonction, vous pouvez utiliser la technique JavaScript de définition de fonctions à la volée (ce qu’on appelle une fonction anonyme), et définir à cet endroit les actions à effectuer sur la réponse, comme ceci :

+ +
httpRequest.onreadystatechange = function() {
+    // instructions de traitement de la réponse
+};
+
+ +

Ensuite, après avoir déclaré ce qui se produit lorsque la réponse est reçue, il s’agit de lancer effectivement la requête. Il faut pour cela appeler les méthodes open() et send() de l’objet httpRequest, comme ceci :

+ +
httpRequest.open('GET', 'http://www.example.org/some.file', true);
+httpRequest.send();
+ + + +

Le paramètre de la méthode send() peut être n’importe quelle donnée que vous voulez envoyer au serveur en cas d’utilisation de la méthode POST. Les données doivent être sous la forme d’une chaîne de requête, comme :

+ +
"nom=valeur&autrenom="+encodeURIComponent(autrevaleur)+"&ainsi=desuite"
+ +

Ou d’autres formats tels que multipart/form-data, JSON, XML, etc.

+ +

Notez que si vous voulez envoyer des données avec la méthode POST, vous aurez peut-être à changer le type MIME de la requête. Par exemple, utilisez ce qui suit avant d’appeler send() pour envoyer des données de formulaire en tant que chaîne de requête :

+ +
httpRequest.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
+
+ +

Étape 2 — Gestion de la réponse du serveur

+ +

Lors de l’envoi de la requête, vous avez désigné une fonction JavaScript pour traiter la réponse.

+ +
httpRequest.onreadystatechange = nomDeLaFonction;
+ +

Voyons maintenant ce que cette fonction doit faire. Tout d’abord, elle doit vérifier l’état de la requête. Si cet état a la valeur de XMLHttpRequest.DONE (ce qui correspond à 4), cela signifie que la réponse du serveur a été reçue dans son intégralité et qu’elle peut maintenant être traitée.

+ +
if (httpRequest.readyState === XMLHttpRequest.DONE) {
+    // tout va bien, la réponse a été reçue
+} else {
+    // pas encore prête
+}
+ +

La liste complète des valeurs de readyState est documentée sur XMLHttpRequest.readyState et se résume de cette façon :

+ + + +

Ensuite, vérifiez le code de statut HTTP de la réponse du serveur. Tous les codes possibles sont listés sur le site du W3C. Dans l’exemple qui suit, nous différencions un appel réussi ou échoué en vérifiant la réception d’un code 200 OK.

+ +
if (httpRequest.status === 200) {
+    // parfait !
+} else {
+    // il y a eu un problème avec la requête,
+    // par exemple la réponse peut être un code 404 (Non trouvée)
+    // ou 500 (Erreur interne au serveur)
+}
+
+ +

Après avoir vérifié l’état de la requête et le code de statut HTTP de la réponse, vous pouvez traiter à votre guise les données envoyées par le serveur. Il existe deux manières d’accéder à ces données :

+ + + +

Notez que les étapes ci-dessus sont valides uniquement si vous utilisez une requête asynchrone (Le 3e paramètre d’open() n’a pas été spécifié, ou a été défini à true). Si vous utilisez une requête synchrone, vous n’avez pas besoin de spécifier une fonction, mais c’est fortement découragé car cela entraîne une mauvaise expérience utilisateur.

+ +

Étape 3 — Un exemple simple

+ +

Rassemblons tous ces éléments dans un exemple : une requête HTTP simple. Notre JavaScript demande un document HTML, test.html, qui contient le texte « Je suis un test. », puis nous affichons le contenu de la réponse dans un message alert(). Remarquez que cet exemple n’utilise que du pur JavaScript vanilla (pas de jQuery). D’autre part, les fichiers HTML, XML et PHP doivent être placés dans le même dossier.

+ +
<button id="ajaxButton" type="button">Faire une requête</button>
+
+<script>
+(function() {
+  var httpRequest;
+  document.getElementById("ajaxButton").addEventListener('click', makeRequest);
+
+  function makeRequest() {
+    httpRequest = new XMLHttpRequest();
+
+    if (!httpRequest) {
+      alert('Abandon :( Impossible de créer une instance de XMLHTTP');
+      return false;
+    }
+    httpRequest.onreadystatechange = alertContents;
+    httpRequest.open('GET', 'test.html');
+    httpRequest.send();
+  }
+
+  function alertContents() {
+    if (httpRequest.readyState === XMLHttpRequest.DONE) {
+      if (httpRequest.status === 200) {
+        alert(httpRequest.responseText);
+      } else {
+        alert('Il y a eu un problème avec la requête.');
+      }
+    }
+  }
+})();
+</script>
+ +

Dans cet exemple :

+ + + +
+

Note : Si vous envoyez une requête à du code qui renvoie du XML plutôt qu’un fichier HTML statique, vous devez spécifier des en-têtes de réponse pour que cela fonctionne avec Internet Explorer. Si vous ne spécifiez pas l’en-tête Content-Type: application/xml, IE émettra une erreur JavaScript « Objet attendu » après la ligne à laquelle vous avez tenté d’accéder à l’élément XML.

+
+ +
+

Note : Si vous ne spécifiez pas l’en-tête Cache-Control: no-cache, le navigateur mettra la réponse en cache et n’effectuera plus jamais la requête ultérieurement, ce qui peut rendre le débogage difficile. Vous pouvez également ajouter un paramètre GET toujours différent, comme un timestamp ou un nombre aléatoire (voir contourner le cache).

+
+ +
+

Note : Si la variable httpRequest est utilisée globalement, des appels concurrents à makeRequest() peuvent s’écraser l’un l’autre, provoquant une situation de compétition (race condition). On peut s’en prémunir en déclarant la variable httpRequest locale à une closure contenant les fonctions AJAX.

+
+ +

Si une erreur de communication se produit (par exemple le serveur qui cesse de répondre), une exception sera levée dans la méthode onreadystatechange lors de l’accès à la propriété status. Pour atténuer ce problème, vous pouvez entourer votre bloc if...then dans un try...catch :

+ +
function alertContents(httpRequest) {
+  try {
+    if (httpRequest.readyState === XMLHttpRequest.DONE) {
+      if (httpRequest.status === 200) {
+        alert(httpRequest.responseText);
+      } else {
+        alert("Un problème est survenu au cours de la requête.");
+      }
+    }
+  }
+  catch( e ) {
+    alert("Une exception s’est produite : " + e.description);
+  }
+}
+ +

Étape 4 — Travailler avec des réponses XML

+ +

Dans l’exemple précédent, après avoir reçu la réponse à la requête HTTP, nous avons utilisé la propriété responseText de l’objet, qui contenait le contenu du fichier test.html. Essayons maintenant la propriété responseXML.

+ +

Tout d’abord, créons un document XML valide qui sera l’objet de la requête. Le document (test.xml) contient ce qui suit :

+ +
<?xml version="1.0" ?>
+<root>
+    Je suis un test.
+</root>
+
+ +

Dans le script, il est seulement nécessaire de remplacer la ligne de requête par :

+ +
...
+onclick="makeRequest('test.xml')">
+...
+
+ +

Ensuite, dans alertContents(), il faut remplacer la ligne alert(httpRequest.responseText); par :

+ +
var xmldoc = httpRequest.responseXML;
+var root_node = xmldoc.getElementsByTagName('root').item(0);
+alert(root_node.firstChild.data);
+
+ +

Ce code prend l’objet XMLDocument donné par responseXML et utilise les méthodes du DOM pour accéder à des données contenues dans le document XML.

+ +

Catégories

+ +

Interwiki

+ +

Étape 5 – Manipuler les données

+ +

Pour finir, envoyons quelques données au serveur et réceptionnons la réponse. Notre JavaScript demandera cette fois-ci une page dynamique, test.php, qui prendra notre contenu envoyé et revera une chaîne « calculée » – "Bonjour, [user data] !" – que nous afficherons via alert().

+ +

D’abord, nous allons ajouter un boîte de texte dans notre HTML afin que l’utilisateur ou l’utilisatrice puisse saisir son nom :

+ +
<label>Vore nom :
+  <input type="text" id="ajaxTextbox" />
+</label>
+<span id="ajaxButton">
+  Lancer une requête
+</span>
+ +

Nous allons également ajouter une ligne à notre gestionnaire d’événement pour obtenir les données de la boite de texte et les envoyer à la fonction makeRequest(), ainsi que l’URL de notre script côté serveur :

+ +
  document.getElementById("ajaxButton").onclick = function() {
+      var userName = document.getElementById("ajaxTextbox").value;
+      makeRequest('test.php', userName);
+  };
+ +

Nous devons modifier makeRequest() afin d’accepter les données et les transmettre au serveur. Nous changerons la méthode de GET à POST et inclurons nos données en paramètres dans l’appel à httpRequest.send() :

+ +
  function makeRequest(url, userName) {
+
+    ...
+
+    httpRequest.onreadystatechange = alertContents;
+    httpRequest.open('POST', url);
+    httpRequest.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
+    httpRequest.send('userName=' + encodeURIComponent(userName));
+  }
+ +

La fonction alertContents() peut être écrite de la même manière qu’à l’étape 3 pour afficher notre chaîne calculée, si c’est tout ce que le serveur renvoie. Cependant, supposons que le serveur renvoie à la fois la phrase calculée et la donnée originale. Donc si l’utilisateur ou l’utilisatrice a saisi « Dorothée », la réponse du serveur ressemblera à :

+ +
{"userData":"Dorothée","computedString":"Bonjour, Dorothée !"}
+ +

Pour utiliser cette phrase dans alertContents(), nous ne pouvons pas simplement afficher une alerte avec le contenu de responseText, nous devons l’analyser et afficher computedString, la propriété que nous souhaitons :

+ +
function alertContents() {
+  if (httpRequest.readyState === XMLHttpRequest.DONE) {
+    if (httpRequest.status === 200) {
+      var response = JSON.parse(httpRequest.responseText);
+      alert(response.computedString);
+    } else {
+      alert('Un problème est survenu avec la requête.');
+    }
+  }
+}
+ +

Le fichier test.php devrait contenir ce qui suit :

+ +
$name = (isset($_POST['userName'])) ? $_POST['userName'] : 'anonyme';
+$computedString = 'Bonjour, ' . $name . ' !';
+$array = ['userName' => $name, 'computedString' => $computedString];
+echo json_encode($array);
+ +

Pour en savoir sur les méthodes DOM, pensez à lire la Référence du DOM de Mozilla.

diff --git a/files/fr/web/guide/ajax/index.html b/files/fr/web/guide/ajax/index.html deleted file mode 100644 index 1cfc6f249b..0000000000 --- a/files/fr/web/guide/ajax/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: AJAX -slug: Web/Guide/AJAX -translation_of: Web/Guide/AJAX ---- - -

AJAX (Asynchronous JavaScript + XML) n'est pas une technologie en soi, mais un terme désignant une « nouvelle » approche utilisant un ensemble de technologies existantes, dont : HTML ou XHTML, les feuilles de styles CSS, JavaScript, le modèle objet de document (DOM), XML, XSLT, et l'objet XMLHttpRequest. Lorsque ces technologies sont combinées dans le modèle AJAX, les applications Web sont capables de réaliser des mises à jour rapides et incrémentielles de l'interface utilisateur sans devoir recharger la page entière du navigateur. Les applications fonctionnent plus rapidement et sont plus réactives aux actions de l'utilisateur.

- -

Quand utiliser (ou non) AJAX ? 

- -

S'il n'y a pas de "bonne réponse", quelques éléments généraux sont à garder à mémoire : 

- - - - - - - - - - -
-

Documentation

- -
-
AJAX:Premiers pas
-
Cet article vous guide à travers les bases d'AJAX et vous donne deux exemples simples pour commencer.
-
- -
-
Techniques AJAX alternatives
-
La plupart des articles sur AJAX se concentrent sur l'utilisation de XMLHttp comme moyen de communication, mais les techniques AJAX ne s'arrêtent pas à XMLHttp. Il y en a bien d'autres.
-
- -
-
Ajax: A New Approach to Web Applications (en)
-
Jesse James Garrett, du site adaptive path, a écrit cet article en février 2005, introduisant le terme AJAX et les concepts liés.
-
- -
-
A Simpler Ajax Path
-
« Comme on le remarquera, il est assez facile de tirer parti de l'objet XMLHttpRequest pour faire se comporter une application Web un peu plus comme une application traditionnelle, tout en continuant à utiliser des outils comme des formulaires Web pour collecter les entrées de l'utilisateur. »
-
- -
-
Fixing the Back Button and Enabling Bookmarking for AJAX Apps
-
Cet article rédigé par Mike Stenhouse détaille certaines méthodes utilisables pour rendre fonctionnel le bouton Précédent et réparer les problèmes causés au marquage des pages lorsque des applications sont développées avec les outils AJAX.
-
- -
-
Ajax Mistakes
-
Cet article d'Alex Bosworth attire l'attention sur certaines erreurs que les développeurs d'applications AJAX peuvent faire.
-
- -
-
Tutoriel avec des exemples.
-
- -
-
La spécification XMLHttpRequest-  (Traduction française)
-
Brouillon de travail du W3C
-
- - 		-

Communauté

- -
    -
  • Voir les forums de Mozilla… {{ DiscussionList("dev-ajax", "mozilla.dev.ajax") }}
    • -
- -

Outils

- - - -

Exemples

- - - - - -
-
HTML, XHTML, Feuilles de style (CSS), Modèle objet de document (DOM), JavaScript, XML, XSLT , DHTML, Canvas
-
-
diff --git a/files/fr/web/guide/ajax/index.md b/files/fr/web/guide/ajax/index.md new file mode 100644 index 0000000000..1cfc6f249b --- /dev/null +++ b/files/fr/web/guide/ajax/index.md @@ -0,0 +1,107 @@ +--- +title: AJAX +slug: Web/Guide/AJAX +translation_of: Web/Guide/AJAX +--- + +

AJAX (Asynchronous JavaScript + XML) n'est pas une technologie en soi, mais un terme désignant une « nouvelle » approche utilisant un ensemble de technologies existantes, dont : HTML ou XHTML, les feuilles de styles CSS, JavaScript, le modèle objet de document (DOM), XML, XSLT, et l'objet XMLHttpRequest. Lorsque ces technologies sont combinées dans le modèle AJAX, les applications Web sont capables de réaliser des mises à jour rapides et incrémentielles de l'interface utilisateur sans devoir recharger la page entière du navigateur. Les applications fonctionnent plus rapidement et sont plus réactives aux actions de l'utilisateur.

+ +

Quand utiliser (ou non) AJAX ? 

+ +

S'il n'y a pas de "bonne réponse", quelques éléments généraux sont à garder à mémoire : 

+ + + + + + + + + + +
+

Documentation

+ +
+
AJAX:Premiers pas
+
Cet article vous guide à travers les bases d'AJAX et vous donne deux exemples simples pour commencer.
+
+ +
+
Techniques AJAX alternatives
+
La plupart des articles sur AJAX se concentrent sur l'utilisation de XMLHttp comme moyen de communication, mais les techniques AJAX ne s'arrêtent pas à XMLHttp. Il y en a bien d'autres.
+
+ +
+
Ajax: A New Approach to Web Applications (en)
+
Jesse James Garrett, du site adaptive path, a écrit cet article en février 2005, introduisant le terme AJAX et les concepts liés.
+
+ +
+
A Simpler Ajax Path
+
« Comme on le remarquera, il est assez facile de tirer parti de l'objet XMLHttpRequest pour faire se comporter une application Web un peu plus comme une application traditionnelle, tout en continuant à utiliser des outils comme des formulaires Web pour collecter les entrées de l'utilisateur. »
+
+ +
+
Fixing the Back Button and Enabling Bookmarking for AJAX Apps
+
Cet article rédigé par Mike Stenhouse détaille certaines méthodes utilisables pour rendre fonctionnel le bouton Précédent et réparer les problèmes causés au marquage des pages lorsque des applications sont développées avec les outils AJAX.
+
+ +
+
Ajax Mistakes
+
Cet article d'Alex Bosworth attire l'attention sur certaines erreurs que les développeurs d'applications AJAX peuvent faire.
+
+ +
+
Tutoriel avec des exemples.
+
+ +
+
La spécification XMLHttpRequest-  (Traduction française)
+
Brouillon de travail du W3C
+
+ + 		+

Communauté

+ +
    +
  • Voir les forums de Mozilla… {{ DiscussionList("dev-ajax", "mozilla.dev.ajax") }}
    • +
+ +

Outils

+ + + +

Exemples

+ + + + + +
+
HTML, XHTML, Feuilles de style (CSS), Modèle objet de document (DOM), JavaScript, XML, XSLT , DHTML, Canvas
+
+
diff --git a/files/fr/web/guide/api/index.html b/files/fr/web/guide/api/index.html deleted file mode 100644 index 9dbd8867c5..0000000000 --- a/files/fr/web/guide/api/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Guide to Web APIs -slug: Web/Guide/API -tags: - - API - - Guide - - Landing - - Web -translation_of: Web/Guide/API ---- -

Le Web peut être utilisé avec de nombreuses API, accessibles en JavaScript, qui permettent de construire des applications puissantes, sur le Web, localement ou sur un serveur grâce à Node.js. Sur cette page, vous pourrez trouver une liste complète de l'ensemble des API utilisables avec les technologies web.

- -

Index des API Web (A à Z)

- -

{{ListGroups}}

- -

Voir aussi

- - diff --git a/files/fr/web/guide/api/index.md b/files/fr/web/guide/api/index.md new file mode 100644 index 0000000000..9dbd8867c5 --- /dev/null +++ b/files/fr/web/guide/api/index.md @@ -0,0 +1,24 @@ +--- +title: Guide to Web APIs +slug: Web/Guide/API +tags: + - API + - Guide + - Landing + - Web +translation_of: Web/Guide/API +--- +

Le Web peut être utilisé avec de nombreuses API, accessibles en JavaScript, qui permettent de construire des applications puissantes, sur le Web, localement ou sur un serveur grâce à Node.js. Sur cette page, vous pourrez trouver une liste complète de l'ensemble des API utilisables avec les technologies web.

+ +

Index des API Web (A à Z)

+ +

{{ListGroups}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.html b/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.html deleted file mode 100644 index 5e20228556..0000000000 --- a/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Communication de pair-à-pair avec WebRTC -slug: Web/Guide/API/WebRTC/Peer-to-peer_communications_with_WebRTC -translation_of: Web/Guide/API/WebRTC/Peer-to-peer_communications_with_WebRTC -original_slug: WebRTC/communication-de-pair-a-pair-avec-WebRTC ---- -

{{SeeCompatTable}}

-

Les APIs WebRTC sont conçues pour permettre aux applications JavaScript de créer des connexions en temps-réel, avec des canaux audio, vidéo et/ou de données, entre utilisateurs à travers leurs navigateurs ou avec des serveurs supportant le protocole WebRTC. Il autorise aussi navigator.mozGetUserMedia() à accéder au microphone et à la webcam (getUserMedia() est en cours de standardisation par le groupe Media Capture Task, avec les APIs Recording).

-

La principale source des évolutions des spécifications de WebRTC sont les spécifications du W3C WebRTC et getUserMedia, ainsi que différents brouillons de IETF, principalement du groupe de travail rtcweb, mais aussi mmusic, rmcat et quelques autres. Une grande partie de l'implémentation dans Chrome et Firefox est basée sur le code libéré par Google à webrtc.org.

-

NOTE:  Les versions courantes de FlashBlock peuvent bloquer le tag HTML5 <video> par défaut; si c'est le cas, il faut lui dire d'autoriser le contenu de la page, ou désactiver cette option via Tools/Add-ons.

-

Un bon tutoriel sur les fonctionnalités de base de WebRTC peut-être trouvé sur HTML5 Rocks. On pourra trouver sur le site webrtc-landing une série de page de test basique.

-

Il est possible de faire un appel simple de personne à personne  (y compris à ceux utilisant Chrome) à apprtc.appspot.com.

-

Un article de Hacks décrit avec précision ce qu'il se passe dans une connexion RTCPeerConnecion (lien) :

-

Basics of RTCPeerConnection call setup

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("Media Capture")}}{{Spec2("Media Capture")}}Définition de getUserMedia API.
{{SpecName("WebRTC 1.0")}}{{Spec2("WebRTC 1.0")}}Définition initiale.
diff --git a/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.md b/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.md new file mode 100644 index 0000000000..5e20228556 --- /dev/null +++ b/files/fr/web/guide/api/webrtc/peer-to-peer_communications_with_webrtc/index.md @@ -0,0 +1,38 @@ +--- +title: Communication de pair-à-pair avec WebRTC +slug: Web/Guide/API/WebRTC/Peer-to-peer_communications_with_WebRTC +translation_of: Web/Guide/API/WebRTC/Peer-to-peer_communications_with_WebRTC +original_slug: WebRTC/communication-de-pair-a-pair-avec-WebRTC +--- +

{{SeeCompatTable}}

+

Les APIs WebRTC sont conçues pour permettre aux applications JavaScript de créer des connexions en temps-réel, avec des canaux audio, vidéo et/ou de données, entre utilisateurs à travers leurs navigateurs ou avec des serveurs supportant le protocole WebRTC. Il autorise aussi navigator.mozGetUserMedia() à accéder au microphone et à la webcam (getUserMedia() est en cours de standardisation par le groupe Media Capture Task, avec les APIs Recording).

+

La principale source des évolutions des spécifications de WebRTC sont les spécifications du W3C WebRTC et getUserMedia, ainsi que différents brouillons de IETF, principalement du groupe de travail rtcweb, mais aussi mmusic, rmcat et quelques autres. Une grande partie de l'implémentation dans Chrome et Firefox est basée sur le code libéré par Google à webrtc.org.

+

NOTE:  Les versions courantes de FlashBlock peuvent bloquer le tag HTML5 <video> par défaut; si c'est le cas, il faut lui dire d'autoriser le contenu de la page, ou désactiver cette option via Tools/Add-ons.

+

Un bon tutoriel sur les fonctionnalités de base de WebRTC peut-être trouvé sur HTML5 Rocks. On pourra trouver sur le site webrtc-landing une série de page de test basique.

+

Il est possible de faire un appel simple de personne à personne  (y compris à ceux utilisant Chrome) à apprtc.appspot.com.

+

Un article de Hacks décrit avec précision ce qu'il se passe dans une connexion RTCPeerConnecion (lien) :

+

Basics of RTCPeerConnection call setup

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("Media Capture")}}{{Spec2("Media Capture")}}Définition de getUserMedia API.
{{SpecName("WebRTC 1.0")}}{{Spec2("WebRTC 1.0")}}Définition initiale.
diff --git a/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.html b/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.html deleted file mode 100644 index c7be3a71e6..0000000000 --- a/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.html +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: 'Mémoire tampon, position, et plages de temps' -slug: Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges -tags: - - Apps - - Buffer - - HTML5 - - TimeRanges - - Video - - buffering - - seeking -translation_of: Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges ---- - -

Il est parfois utile de savoir combien d'{{htmlelement("audio") }} ou {{htmlelement("video") }} a été téléchargé ou peut être joué sans délai — par exemple pour afficher la barre de progression du tampon dans un lecteur audio ou vidéo. Cet article explique comment construire une barre de progrès de mise en mémoire tampon en utilisant TimeRanges, et d'autres fonctionnalités de l'API Media.

- - -

Buffered

- -

L'attribut buffered indique quelles parties du média ont été téléchargées. Il retourne un objet {{ domxref("TimeRanges") }}, qui indique tous les morceaux téléchargés. C'est généralement contigu, mais si l'utilisateur saute à une autre position pendant que le média est en cours de chargement, il peut alors y avoir des trous.

- -

Cela fonctionne avec {{htmlelement("audio") }} et {{htmlelement("video") }}; pour l'instant, considérons un simple exemple audio:

- -
<audio id="my-audio" controls src="music.mp3">
-</audio>
- -

On accède à cet attribut ainsi:

- -
var myAudio = document.getElementById('my-audio');
-
-var bufferedTimeRanges = myAudio.buffered;
- -

Objet TimeRanges

- -

TimeRanges est une série de plages de temps ne se chevauchant pas, avec un temps de début et de fin. (en savoir plus sur TimeRanges).

- -

Un objet {{ domxref("TimeRanges") }} contient les propriétés/méthodes suivantes:

- - - -

Sans interraction utilisateur il y a généralement une seule plage de temps, mais si vous sautez dans le média alors plus d'une plage de temps peut apparaître, comme illustré dans la visualisation ci-dessous. Elle représente deux plages de temps en mémoire tampon — une qui s'étend de 0 à 5 secondes et la seconde qui s'étend de 15 à 19 secondes.

- -
------------------------------------------------------
-|=============|                    |===========|     |
-------------------------------------------------------
-0             5                    15          19    21
- -

Pour cette instance audio, l'objet {{ domxref("TimeRanges") }} associé aurait les propriétés suivantes:

- -
myAudio.buffered.length;   // returns 2
-myAudio.buffered.start(0); // returns 0
-myAudio.buffered.end(0);   // returns 5
-myAudio.buffered.start(1); // returns 15
-myAudio.buffered.end(1);   // returns 19
- -

Pour essayer et visualiser les plages de temps en mémoire tampon, on peut écrire un peu d'HTML:

- -
<p>
-  <audio id="my-audio" controls>
-    <source src="music.mp3" type="audio/mpeg">
-  </audio>
-</p>
-<p>
-  <canvas id="my-canvas" width="300" height="20">
-  </canvas>
-</p>
- -

Et un peu de JavaScript:

- -
  window.onload = function(){
-
-    var myAudio = document.getElementById('my-audio');
-    var myCanvas = document.getElementById('my-canvas');
-    var context = myCanvas.getContext('2d');
-
-    context.fillStyle = 'lightgray';
-    context.fillRect(0, 0, myCanvas.width, myCanvas.height);
-    context.fillStyle = 'red';
-    context.strokeStyle = 'white';
-
-    var inc = myCanvas.width / myAudio.duration;
-
-    // afficher TimeRanges
-
-    myAudio.addEventListener('seeked', function() {
-      for (i = 0; i < myAudio.buffered.length; i++) {
-
-        var startX = myAudio.buffered.start(i) * inc;
-        var endX = myAudio.buffered.end(i) * inc;
-        var width = endX - startX;
-
-        context.fillRect(startX, 0, width, myCanvas.height);
-        context.rect(startX, 0, width, myCanvas.height);
-        context.stroke();
-      }
-    });
-  }
- -

Cela fonctionne mieux avec les morceaux audio ou vidéo un peu plus longs, mais appuyez sur play et cliquez sur la barre de progression du lecteur et vous devriez obtenir quelque chose comme ci-dessous. Chaque rectangle rouge remplissant le rectangle blanc représente une plage de temps.

- -

- -
-

Note : Vous pouvez voir cet exemple en direct sur JS Bin.

-
- -

Seekable

- -

L'attribut seekable retourne un objet {{ domxref("TimeRanges") }} qui indique quelles parties du média peuvent être jouées sans chargement préalable. C'est indépendant du fait que la partie ait été téléchargée ou non: certaines parties peuvent être seekable mais non buffered si les requêtes de plage d'octets (byte-range requests) sont activées sur le serveur. Les requêtes de plage d'octets permettent aux parties du fichier média d'être délivrées du serveur et jouées presque immédiatement — et sont donc seekable.

- -
var seekableTimeRanges = myAudio.seekable;
- -

Créer notre propre barre de progrès

- -

Si on voulait créer notre propre lecteur média, on pourrait vouloir afficher les parties du média prêtes à être jouées. Un bon moyen d'y arriver est d'utiliser l'attribut seekable.

- -

Bien qu'on ait vu que les parties ne sont pas nécessairement contigues, elles le sont généralement, et on peut utiliser une approximation de cette information pour donner à l'utilisateur une indication de la quantité de média qui peut être jouée directement. On peut trouver ce point en utilisant la ligne de code suivante:

- -
var seekableEnd = myAudio.seekable.end(myAudio.seekable.length - 1);
- -
-

Note : myAudio.seekable.end(myAudio.seekable.length - 1) nous indique en fait le temps de fin de la dernière plage de temps disponible (et non toutes). En pratique, c'est suffisant, car le navigateur peut permettre ou non de requêter des plages d'octets. S'il ne le permet pas — audio.seekable sera l'équivalent de audio.buffered — on a une indication valide de la fin du média chargée. Sinon, alors cette valeur vaudra la durée du média presque instantannément.

-
- -

Il est peut-être préférable de donner une indication de la quantité de média effectivement téléchargée — c'est ce que les lecteurs natifs du navigateur semblent indiquer.

- -

Alors, construisons cela. Le HTML de notre lecteur ressemble à ça:

- -
<audio id="my-audio" preload controls>
-  <source src="music.mp3" type="audio/mpeg">
-</audio>
-<div class="buffered">
-  <span id="buffered-amount"></span>
-</div>
-<div class="progress">
-  <span id="progress-amount"></span>
-</div>
-
- -

Nous utiliserons le CSS suivant pour styliser l'affichage de la mémoire tampon:

- -
.buffered {
-  height: 20px;
-  position: relative;
-  background: #555;
-  width: 300px;
-}
-
-#buffered-amount {
-  display: block;
-  height: 100%;
-  background-color: #777;
-  width: 0;
-}
-
-.progress {
-  margin-top: -20px;
-  height: 20px;
-  position: relative;
-  width: 300px;
-}
-
-#progress-amount {
-  display: block;
-  height: 100%;
-  background-color: #595;
-  width: 0;
-}
- -

Et le JavaScript suivant se charge notre fonctionnalité:

- -
window.onload = function(){
-
-  var myAudio = document.getElementById('my-audio');
-
-  myAudio.addEventListener('progress', function() {
-    var duration =  myAudio.duration;
-    if (duration > 0) {
-      for (var i = 0; i < myAudio.buffered.length; i++) {
-            if (myAudio.buffered.start(myAudio.buffered.length - 1 - i) < myAudio.currentTime) {
-                document.getElementById("buffered-amount").style.width = (myAudio.buffered.end(myAudio.buffered.length - 1 - i) / duration) * 100 + "%";
-                break;
-            }
-        }
-    }
-  });
-
-  myAudio.addEventListener('timeupdate', function() {
-    var duration =  myAudio.duration;
-    if (duration > 0) {
-      document.getElementById('progress-amount').style.width = ((myAudio.currentTime / duration)*100) + "%";
-    }
-  });
-}
- -

L'événement progress est déclenché au fur et à mesure que les données sont téléchargées, cela nous permet de réagir pour afficher la progression du téléchargement ou de la mise en mémoire tampon.

- -

L'événement timeupdate est declénché 4 fois par seconde au fur et à mesure que le média est joué et c'est là qu'on incrémente notre barre de progrès.

- -

Cela devrait vous donner des résultats similaires à ce qui suit, où la barre gris clair représente la progression de la mise en mémoire tampon et la barre verte montre la progression de la lecture:

- -

- -
-

Note : Voir pouvez voir l'exemple en direct sur JS Bin.

-
- -

Un petit mot sur Played

- -

Il vaut la peine de mentionner la propriété played — elle nous indique quelles plages de temps ont été jouées dans le média. Par exemple:

- -
var played = audio.played; // returns a TimeRanges object
- -

Ce peut être utile pour récupérer les parties du média qui sont les plus écoutées ou regardées.

diff --git a/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.md b/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.md new file mode 100644 index 0000000000..c7be3a71e6 --- /dev/null +++ b/files/fr/web/guide/audio_and_video_delivery/buffering_seeking_time_ranges/index.md @@ -0,0 +1,218 @@ +--- +title: 'Mémoire tampon, position, et plages de temps' +slug: Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges +tags: + - Apps + - Buffer + - HTML5 + - TimeRanges + - Video + - buffering + - seeking +translation_of: Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges +--- + +

Il est parfois utile de savoir combien d'{{htmlelement("audio") }} ou {{htmlelement("video") }} a été téléchargé ou peut être joué sans délai — par exemple pour afficher la barre de progression du tampon dans un lecteur audio ou vidéo. Cet article explique comment construire une barre de progrès de mise en mémoire tampon en utilisant TimeRanges, et d'autres fonctionnalités de l'API Media.

+ + +

Buffered

+ +

L'attribut buffered indique quelles parties du média ont été téléchargées. Il retourne un objet {{ domxref("TimeRanges") }}, qui indique tous les morceaux téléchargés. C'est généralement contigu, mais si l'utilisateur saute à une autre position pendant que le média est en cours de chargement, il peut alors y avoir des trous.

+ +

Cela fonctionne avec {{htmlelement("audio") }} et {{htmlelement("video") }}; pour l'instant, considérons un simple exemple audio:

+ +
<audio id="my-audio" controls src="music.mp3">
+</audio>
+ +

On accède à cet attribut ainsi:

+ +
var myAudio = document.getElementById('my-audio');
+
+var bufferedTimeRanges = myAudio.buffered;
+ +

Objet TimeRanges

+ +

TimeRanges est une série de plages de temps ne se chevauchant pas, avec un temps de début et de fin. (en savoir plus sur TimeRanges).

+ +

Un objet {{ domxref("TimeRanges") }} contient les propriétés/méthodes suivantes:

+ + + +

Sans interraction utilisateur il y a généralement une seule plage de temps, mais si vous sautez dans le média alors plus d'une plage de temps peut apparaître, comme illustré dans la visualisation ci-dessous. Elle représente deux plages de temps en mémoire tampon — une qui s'étend de 0 à 5 secondes et la seconde qui s'étend de 15 à 19 secondes.

+ +
------------------------------------------------------
+|=============|                    |===========|     |
+------------------------------------------------------
+0             5                    15          19    21
+ +

Pour cette instance audio, l'objet {{ domxref("TimeRanges") }} associé aurait les propriétés suivantes:

+ +
myAudio.buffered.length;   // returns 2
+myAudio.buffered.start(0); // returns 0
+myAudio.buffered.end(0);   // returns 5
+myAudio.buffered.start(1); // returns 15
+myAudio.buffered.end(1);   // returns 19
+ +

Pour essayer et visualiser les plages de temps en mémoire tampon, on peut écrire un peu d'HTML:

+ +
<p>
+  <audio id="my-audio" controls>
+    <source src="music.mp3" type="audio/mpeg">
+  </audio>
+</p>
+<p>
+  <canvas id="my-canvas" width="300" height="20">
+  </canvas>
+</p>
+ +

Et un peu de JavaScript:

+ +
  window.onload = function(){
+
+    var myAudio = document.getElementById('my-audio');
+    var myCanvas = document.getElementById('my-canvas');
+    var context = myCanvas.getContext('2d');
+
+    context.fillStyle = 'lightgray';
+    context.fillRect(0, 0, myCanvas.width, myCanvas.height);
+    context.fillStyle = 'red';
+    context.strokeStyle = 'white';
+
+    var inc = myCanvas.width / myAudio.duration;
+
+    // afficher TimeRanges
+
+    myAudio.addEventListener('seeked', function() {
+      for (i = 0; i < myAudio.buffered.length; i++) {
+
+        var startX = myAudio.buffered.start(i) * inc;
+        var endX = myAudio.buffered.end(i) * inc;
+        var width = endX - startX;
+
+        context.fillRect(startX, 0, width, myCanvas.height);
+        context.rect(startX, 0, width, myCanvas.height);
+        context.stroke();
+      }
+    });
+  }
+ +

Cela fonctionne mieux avec les morceaux audio ou vidéo un peu plus longs, mais appuyez sur play et cliquez sur la barre de progression du lecteur et vous devriez obtenir quelque chose comme ci-dessous. Chaque rectangle rouge remplissant le rectangle blanc représente une plage de temps.

+ +

+ +
+

Note : Vous pouvez voir cet exemple en direct sur JS Bin.

+
+ +

Seekable

+ +

L'attribut seekable retourne un objet {{ domxref("TimeRanges") }} qui indique quelles parties du média peuvent être jouées sans chargement préalable. C'est indépendant du fait que la partie ait été téléchargée ou non: certaines parties peuvent être seekable mais non buffered si les requêtes de plage d'octets (byte-range requests) sont activées sur le serveur. Les requêtes de plage d'octets permettent aux parties du fichier média d'être délivrées du serveur et jouées presque immédiatement — et sont donc seekable.

+ +
var seekableTimeRanges = myAudio.seekable;
+ +

Créer notre propre barre de progrès

+ +

Si on voulait créer notre propre lecteur média, on pourrait vouloir afficher les parties du média prêtes à être jouées. Un bon moyen d'y arriver est d'utiliser l'attribut seekable.

+ +

Bien qu'on ait vu que les parties ne sont pas nécessairement contigues, elles le sont généralement, et on peut utiliser une approximation de cette information pour donner à l'utilisateur une indication de la quantité de média qui peut être jouée directement. On peut trouver ce point en utilisant la ligne de code suivante:

+ +
var seekableEnd = myAudio.seekable.end(myAudio.seekable.length - 1);
+ +
+

Note : myAudio.seekable.end(myAudio.seekable.length - 1) nous indique en fait le temps de fin de la dernière plage de temps disponible (et non toutes). En pratique, c'est suffisant, car le navigateur peut permettre ou non de requêter des plages d'octets. S'il ne le permet pas — audio.seekable sera l'équivalent de audio.buffered — on a une indication valide de la fin du média chargée. Sinon, alors cette valeur vaudra la durée du média presque instantannément.

+
+ +

Il est peut-être préférable de donner une indication de la quantité de média effectivement téléchargée — c'est ce que les lecteurs natifs du navigateur semblent indiquer.

+ +

Alors, construisons cela. Le HTML de notre lecteur ressemble à ça:

+ +
<audio id="my-audio" preload controls>
+  <source src="music.mp3" type="audio/mpeg">
+</audio>
+<div class="buffered">
+  <span id="buffered-amount"></span>
+</div>
+<div class="progress">
+  <span id="progress-amount"></span>
+</div>
+
+ +

Nous utiliserons le CSS suivant pour styliser l'affichage de la mémoire tampon:

+ +
.buffered {
+  height: 20px;
+  position: relative;
+  background: #555;
+  width: 300px;
+}
+
+#buffered-amount {
+  display: block;
+  height: 100%;
+  background-color: #777;
+  width: 0;
+}
+
+.progress {
+  margin-top: -20px;
+  height: 20px;
+  position: relative;
+  width: 300px;
+}
+
+#progress-amount {
+  display: block;
+  height: 100%;
+  background-color: #595;
+  width: 0;
+}
+ +

Et le JavaScript suivant se charge notre fonctionnalité:

+ +
window.onload = function(){
+
+  var myAudio = document.getElementById('my-audio');
+
+  myAudio.addEventListener('progress', function() {
+    var duration =  myAudio.duration;
+    if (duration > 0) {
+      for (var i = 0; i < myAudio.buffered.length; i++) {
+            if (myAudio.buffered.start(myAudio.buffered.length - 1 - i) < myAudio.currentTime) {
+                document.getElementById("buffered-amount").style.width = (myAudio.buffered.end(myAudio.buffered.length - 1 - i) / duration) * 100 + "%";
+                break;
+            }
+        }
+    }
+  });
+
+  myAudio.addEventListener('timeupdate', function() {
+    var duration =  myAudio.duration;
+    if (duration > 0) {
+      document.getElementById('progress-amount').style.width = ((myAudio.currentTime / duration)*100) + "%";
+    }
+  });
+}
+ +

L'événement progress est déclenché au fur et à mesure que les données sont téléchargées, cela nous permet de réagir pour afficher la progression du téléchargement ou de la mise en mémoire tampon.

+ +

L'événement timeupdate est declénché 4 fois par seconde au fur et à mesure que le média est joué et c'est là qu'on incrémente notre barre de progrès.

+ +

Cela devrait vous donner des résultats similaires à ce qui suit, où la barre gris clair représente la progression de la mise en mémoire tampon et la barre verte montre la progression de la lecture:

+ +

+ +
+

Note : Voir pouvez voir l'exemple en direct sur JS Bin.

+
+ +

Un petit mot sur Played

+ +

Il vaut la peine de mentionner la propriété played — elle nous indique quelles plages de temps ont été jouées dans le média. Par exemple:

+ +
var played = audio.played; // returns a TimeRanges object
+ +

Ce peut être utile pour récupérer les parties du média qui sont les plus écoutées ou regardées.

diff --git a/files/fr/web/guide/audio_and_video_delivery/index.html b/files/fr/web/guide/audio_and_video_delivery/index.html deleted file mode 100644 index 9b5ede8e2d..0000000000 --- a/files/fr/web/guide/audio_and_video_delivery/index.html +++ /dev/null @@ -1,485 +0,0 @@ ---- -title: Intégration audio et vidéo -slug: Web/Guide/Audio_and_video_delivery -translation_of: Web/Guide/Audio_and_video_delivery ---- -

On peut distribuer de l'audio et de la vidéo sur le web de plusieurs manières, du fichier média statique au live stream (flux en direct) adaptatif. Cet article se veut être le point de départ pour explorer les différents mécanismes de diffusion de média sur le web et la compatiblité avec les navigateurs populaires.

- -

Les éléments audio et vidéo

- -

Que l'on traite des fichiers audio pré-enregistrés ou des flux en directs, le mécanisme pour les rendre disponibles à travers un navigateur reste à peu près le même — via les éléments <audio> et <video>. Actuellement, pour prendre en charge tous les navigateurs, il est nécessaire de définir deux formats — bien qu'avec l'adoption des formats MP3 et MP4 dans Firefox et Opera, cela change rapidement. Vous pouvez trouver les informations de compatibilité des navigateurs aux endroits suivants :

- - - -

Pour distribuer du contenu audio et vidéo, le processus général se déroule comme suit :

- -
    -
  1. Vérifier quels formats sont pris en charge par le navigateur via la détection de fonctionnalité ;
    2. -
  2. Si le navigateur ne lit pas nativement les formats fournis, utiliser un contenu de secours dans un autre format ;
    3. -
  3. Définir la façon dont vous voulez lire/instancier le média (par exemple un élément <video>, ou peut-être via JavaScript avec document.createElement('video')) ;
    4. -
  4. Ajouter le fichier média au lecteur.
    5. -
- -

Audio HTML

- -
<audio controls preload="auto">
-  <source src="audiofile.mp3" type="audio/mpeg">
-
-  <!-- fallback pour les navigateurs qui ne supportent pas mp3 -->
-  <source src="audiofile.ogg" type="audio/ogg">
-
-  <!-- fallback pour les navigateurs qui ne supportent pas la balise audio -->
-  <a href="audiofile.mp3">Télécharger l'audio</a>
-</audio>
- -

Le code ci-dessus va créer un lecteur audio qui tente de précharger autant d'audio que possible pour une lecture fluide.

- -
-

Note : l'attribut preload peut être ignoré par certains navigateurs mobiles.

-
- -

Pour plus d'informations voir Les bases de l'audio multi-navigateur (Audio HTML5 en détails)

- -

Vidéo HTML

- -
<video controls width="640" height="480" poster="initialimage.png" autoplay muted>
-  <source src="videofile.mp4" type="video/mp4">
-
-  <!-- fallback pour les navigateurs qui ne supportent pas mp4 -->
-  <source src="videofile.webm" type="video/webm">
-
-  <!-- spécifie les fichiers de sous-titres -->
-  <track src="subtitles_en.vtt" kind="subtitles" srclang="en" label="English">
-  <track src="subtitles_no.vtt" kind="subtitles" srclang="no" label="Norwegian">
-
-  <!-- fallback pour les navigateurs qui ne supportent pas la balise video -->
-  <a href="videofile.mp4">Télécharger la vidéo</a>
-</video>
- -

Le code ci-dessus crée un lecteur vidéo de dimensions 640x480 pixels, affichant une vignette jusqu'à ce que la vidéo soit lue. On demande à la vidéo de passer en autoplay (jouer automatiquement) mais d'être muted (en sourdine) par défaut.

- -
-

Note : l'attribut autoplay peut être ignoré par certains navigateurs mobiles et est sujet à controverse lorsqu'il est utilisé à mauvais escient. Il est recommandé de lire le guide à ce sujet pour savoir comment l'utiliser pertinemment.

-
- -

Pour plus d'informations voir l'article de référence sur l'élément <video> et la page sur la création d'un lecteur vidéo multi-navigateur.

- -

Audio JavaScript

- -
const myAudio = document.createElement('audio');
-
-if (myAudio.canPlayType('audio/mpeg')) {
-  myAudio.setAttribute('src','audiofile.mp3');
-} else if (myAudio.canPlayType('audio/ogg')) {
-  myAudio.setAttribute('src','audiofile.ogg');
-}
-
-myAudio.currentTime = 5;
-myAudio.play();
- -

On définit la source de l'audio en fonction du type de fichier audio pris en charge par le navigateur, puis nous plaçons la tête de lecture à 5 secondes et essayons de lire le fichier.

- -
-

Note : play() sera ignoré par certains navigateurs mobiles à moins que l'événement ne soit initié par une action de la personne visitant le site.

-
- -

Il est également possible de donner un fichier WAV encodé en base64 à l'élément <audio>, permettant ainsi de générer de l'audio à la volée :

- -
<audio id="player" src="data:audio/x-wav;base64,UklGRvC..."></audio>
- -

Speak.js emploie cette technique. Essayez la démo.

- -

Vidéo JavaScript

- -
const myVideo = document.createElement('video');
-
-if (myVideo.canPlayType('video/mp4')) {
-  myVideo.setAttribute('src','videofile.mp4');
-} else if (myVideo.canPlayType('video/webm')) {
-  myVideo.setAttribute('src','videofile.webm');
-}
-
-myVideo.width = 480;
-myVideo.height = 320;
- -

On définit la source de la vidéo en fonction du type de fichier vidéo pris en charge par le navigateur, puis on définit la largeur et la hauteur de la vidéo.

- -

API Web Audio

- -
let context;
-let request;
-let source;
-
-try {
-  context = new AudioContext();
-  request = new XMLHttpRequest();
-  request.open("GET","https://jplayer.org/audio/mp3/RioMez-01-Sleep_together.mp3",true);
-  request.responseType = "arraybuffer";
-
-  request.onload = function() {
-    context.decodeAudioData(request.response, function(buffer) {
-      source = context.createBufferSource();
-      source.buffer = buffer;
-      source.connect(context.destination);
-      // auto play
-      source.start(0); // start était précédemment intitulé noteOn
-    });
-  };
-
-  request.send();
-
-} catch(e) {
-  console.error(`L'API Web Audio n'est pas prise en charge`);
-}
- -

Dans cet exemple, on récupère un fichier MP3 via XHR, on le charge et on le lit (essayez par vous-même). Pour en savoir plus sur l'API Web Audio voir Utiliser l'API Web Audio.

- -

getUserMedia / Stream API

- -

Il est également possible de récupérer un live stream de la webcam et/ou du microphone de la personne consultant le site avec getUserMedia et l'API Stream. Cela fait partie d'une technologie plus largement connue sous le nom de WebRTC (Web Real-Time Communications) et est compatible avec les dernières versions de Chrome, Firefox et Opera.

- -

Pour récupérer un flux de la webcam, commençons par créer un élément <video> :

- -
<video id="webcam" width="480" height="360"></video>
- -

Ensuite, si cette opération est prise en charge, nous connectons la webcam à l'élément video :

- -
-if (navigator.mediaDevices) {
-  navigator.mediaDevices.getUserMedia({ video: true, audio: false })
-  .then(function onSuccess(stream) {
-    const video = document.getElementById('webcam');
-    video.autoplay = true;
-    video.srcObject = stream;
-  })
-  .catch(function onError() {
-    console.error(`Problème de récupération des flux : utilisez-vous une page avec file:/// ou avez-vous décliné la permission ?`);
-  });
-} else {
-  console.error(`getUserMedia n'est pas pris en charge par ce navigateur.`);
-}
-
- -

Pour en savoir plus, lisez la page MediaDevices.getUserMedia.

- -

Enregistrement de flux média

- -

De nouveaux standards sont en cours de déploiement pour permettre au navigateur de récupérer le flux du micro ou de la webcam — en utilisant getUserMedia — et l'enregistrer directement avec la nouvelle API MediaRecorder. Pour ce faire, on prend le stream retourné par getUserMedia, on le donne en paramètre à un objet MediaRecorder, puis on utilise le résultat obtenu comme source audio ou video.

- -

Le principe de base est décrit ci-après :

- -
-navigator.mediaDevices.getUserMedia({audio:true})
-  .then(function onSuccess(stream) {
-    const recorder = new MediaRecorder(stream);
-
-    const data = [];
-    recorder.ondataavailable = function(e) {
-      data.push(e.data);
-    };
-    recorder.start();
-    recorder.onerror = function(e) {
-      throw e.error || new Error(e.name); // e.name est utilisé pour Firefox
-    }
-    recorder.onstop = function(e) {
-      const audio = document.createElement('audio');
-      audio.src = window.URL.createObjectURL(new Blob(data));
-    }
-    setTimeout(function() {
-      rec.stop();
-    }, 5000);
-  })
-  .catch(function onError(error) {
-    console.log(error.message);
-  });
-
- -

Voir l'API MediaRecorder pour plus de détails.

- -

Media Source Extensions (MSE)

- -

Media Source Extensions (MSE ou « extensions pour les sources de média ») est un brouillon de travail (Working Draft en anglais) du W3C qui prévoit d'étendre HTMLMediaElement pour permettre à JavaScript de générer des flux média pour la lecture. Permettre à JavaScript de générer des flux facilite différents cas d'usage comme la diffusion en direct adaptative et le décalage temporel des flux de diffusion en direct.

- -

Encrypted Media Extensions (EME)

- -

Encrypted Media Extensions (EME ou « extensions pour les médias chiffrés ») est une proposition du W3C d'étendre HTMLMediaElement en fournissant des API pour contrôler la lecture de contenu protégé.

- -

L'API prend en charge divers cas d'utilisation, allant du simple déchiffrement par clé aux vidéos protégées par DRM (pourvu que le navigateur implémente ce système). L'échange de licence/clé est contrôlé par l'application, facilitant ainsi le développement d'applications de lecture robustes et qui prennent en charge différentes technologies de déchiffrement et de protection de contenu. Un des principaux usages d'EME est de permettre au navigateur d'implémenter la gestion des DRM (Digital Rights Management).

- -

Diffusion adaptative

- -

De nouveaux formats et protocoles ont été (et sont encore) deployés pour faciliter la diffusion adaptative. Une diffusion adaptative est un flux en direct qui s'adapte à la bande passante disponible de la personne utilisant le site. Typiquement, la qualité du stream peut changer en temps réel pour utiliser plus ou moins de bande passante. La diffusion adaptative est souvent utilisée en conjonction avec le live streaming, où une diffusion fluide de l'audio et vidéo est primordiale.

- -

Les principaux encodages utilisés pour le streaming adaptatif sont HLS et MPEG-DASH. MSE a été conçu avec DASH en tête, il définit les flux d'octets selon ISOBMFF et M2TS (deux formats pris en charge par DASH, le dernier étant également pris en charge par HLS). DASH est probablement la meilleure option en termes de compatibilité, standard et flexibilité.

- -
-

Note : actuellement, Safari ne prend pas en charge DASH, cependant dash.js marche sur les nouvelles versions de Safari prévues pour être publiées avec OSX Yosemite.

-
- -

DASH fournit également un certain nombre de profils, y compris des profils à la demande simples, sans pré-traitement ni séparation des fichiers multimédia. Il existe un certain nombre de services en ligne qui vous permettront de convertir vos média en HLS ou DASH.

- -

Pour plus d'informations, voir Live streaming web Audio et Vidéo.

- -

Personnaliser votre lecteur média

- -

Vous pouvez vouloir un lecteur audio ou vidéo qui ait le même aspect sur tous les navigateurs, ou simplement vouloir l'adapter à votre site. La technique générale pour y parvenir est d'omettre l'attribut controls afin que les contrôles par défaut du navigateur ne s'affichent pas, et de créer vos propres contrôles en HTML et CSS, avec du JavaScript pour lier vos contrôles à l'API audio/vidéo.

- -

Si vous avez besoin d'aller plus loin, il est possible d'ajouter des fonctionnalités qui ne sont pas présentes par défaut dans les lecteurs, tels que la vitesse de lecture, le choix de la qualité ou mêmes les spectres audio. Vous pouvez également décider de rendre votre lecteur responsive — par exemple, vous pouvez enlever la barre de progression sous certaines conditions.

- -

Vous pouvez détecter les événements de clic, de toucher et/ou de clavier pour déclencher des actions telles que lecture, pause et stop. Il est souvent souhaitable d'ajouter des raccourcis clavier pour plus de commodité et d'accessibilité pour la personne utilisant le lecteur média.

- -

Un exemple rapide — d'abord, configurez votre audio et vos contrôles personnalisés en HTML:

- -
-<audio id="my-audio" src="https://jPlayer.org/audio/mp3/Miaow-01-Tempered-song.mp3"></audio>
-<button id="my-control">play</button>
- -

Ensuite, ajoutez un peu de JavaScript pour détecter les événements afin de lire et de mettre en pause l'audio:

- -
window.onload = function() {
-
-  const myAudio = document.getElementById('my-audio');
-  const myControl = document.getElementById('my-control');
-
-  function switchState() {
-    if (myAudio.paused == true) {
-      myAudio.play();
-      myControl.textContent = "pause";
-    } else {
-      myAudio.pause();
-      myControl.textContent = "play";
-    }
-  }
-
-  function checkKey(e) {
-    if (e.keycode == 32 ) { //spacebar
-      switchState();
-    }
-  }
-
-  myControl.addEventListener('click', function() {
-    switchState();
-  }, false);
-
-  window.addEventListener( "keypress", checkKey, false );
-}
- -

Vous pouvez essayer cet exemple ici. Pour plus d'informations, voir Créer votre propre lecteur audio.

- -

Autres conseils pour l'audio/video

- -

Interrompre le téléchargement d'un média

- -

Bien qu'il suffit d'utiliser la méthode pause() pour interrompre la lecture d'un média, le navigateur continue de télécharger le média jusqu'à ce que l'élément correspondant soit nettoyé par le ramasse-miettes.

- -

Voici une astuce qui permet d'arrêter le téléchargement :

- -
const mediaElement = document.querySelector("#monIDdeMedia");
-mediaElement.removeAttribute("src");
-mediaElement.load();
-
- -

En supprimant l'attribut src de l'élément et en invoquant la méthode load(), on libère les ressources associées à la vidéo, ce qui entraîne l'arrêt du téléchargement. Il est nécessaire d'invoquer load() après le retrait de l'attribut, car sa simple suppression ne relance pas l'algorithme chargement. Si l'élément <video> dispose également d'éléments descendants <source>, ceux-ci devraient également être supprimés avant l'appel à load().

- -

Si on définit l'attribut src avec une chaîne vide, le navigateur considèrera la source comme un chemin relatif et cela déclenchera une tentative d'un autre téléchargement à partir d'une source qui n'est probablement pas une vidéo valide.

- -

Parcourir la piste du média

- -

Les éléments média permettent de placer le curseur de lecture à des instants spécifiques du contenu. Pour cela, on ajustera la propriété currentTime de l'élément (voir HTMLMediaElement pour plus de détails)

- -

La propriété seekable de l'élément peut être utilisée afin de déterminer les intervalles disponibles pour de tels déplacements. Cette propriété renvoie un objet TimeRanges contenant les intervalles temporels accessibles.

- -
const mediaElement = document.querySelector('#mediaElementID');
-mediaElement.seekable.start(0);  // Renvoie l'instant de départ (en secondes)
-mediaElement.seekable.end(0);    // Renvoie l'instant de fin (en secondes)
-mediaElement.currentTime = 122;  // Déplace la lecture à 122 secondes
-mediaElement.played.end(0);      // Renvoie le nombre de secondes lues par le navigateur
-
- -

Définir des intervalles de lecture

- -

Lors de la définition de l'URI du média d'un élément <audio> ou <video>, il est possible d'ajouter des informations supplémentaires pour indiquer la portion du média qu'on souhaite lire. Pour cela, on ajoutera un dièse/croisillon (« # ») suivi de la description du fragment de média.

- -

Un intervalle temporel se définit avec la syntaxe suivante :

- -
#t=[tempsdebut][,tempsfin]
- -

La valeur temporelle peut être définie en nombre de secondes (avec une valeur décimale) ou avec un horodatage en heures/minutes/secondes avec un deux-points comme séparateur (par exemple 2:05:01 pour indiquer 2 heures, 5 minutes et 1 seconde).

- -

Voici quelques exemples :

- -
-
https://example.com/video.ogv#t=10,20
-
Indique que la vidéo devrait jouer l'intervalle compris entre 10 et 20 secondes.
-
https://example.com/video.ogv#t=,10.5
-
Indique que la vidéo devrait jouer l'intervalle depuis le début et jusqu'à 10,5 secondes.
-
https://example.com/video.ogv#t=,02:00:00
-
Indique que la vidéo devrait jouer depuis le début et jusqu'à deux heures.
-
https://example.com/video.ogv#t=60
-
Indique que la vidéo devrait commencer sa lecture à 60 secondes puis continuer jusqu'à la fin.
-
- -

Déboguer les problèmes audio/vidéo

- -

Vous rencontrez des problèmes de lecture audio ou vidéo ? Vérifiez les différents points qui suivent.

- -

Est-ce que le navigateur prend en charge les formats fournis ?

- -

Utilisez les fichiers suivants pour vérifier le support de votre format:

- - - -

Si un de ces fichiers n'est pas lu, c'est que le navigateur que vous testez ne prend pas en charge le format correspondant. Vous pouvez utiliser un format différent ou un contenu de secours.

- -

Si ces fichiers fonctionnent mais que votre fichier ne fonctionne pas, il y a deux explications possibles, que nous verrons ci-après.

- -

1. Le serveur ne fournit pas le type MIME correct du fichier

- -

Bien que les serveurs les prennent généralement en charge, vous allez peut-être avoir besoin d'ajouter ce qui suit à votre fichier .htaccess :

- -
# AddType TYPE/SUBTYPE EXTENSION
-
-AddType audio/mpeg mp3
-AddType audio/mp4 m4a
-AddType audio/ogg ogg
-AddType audio/ogg oga
-
-AddType video/mp4 mp4
-AddType video/mp4 m4v
-AddType video/ogg ogv
-AddType video/webm webm
-AddType video/webm webmv
- -

2. Votre fichier n'est pas encodé correctement

- -

Votre fichier n'a peut-être pas été encodé correctement — essayez de l'encoder en utilisant un des outils suivants, qui sont plutôt fiables :

- - - -

Utiliser du contenu de substitution si la source n'a pu être décodée

- -

Il existe une autre méthode pour présenter du contenu alternatif lorsqu'aucune des ressources n'a pu être décodée par le navigateur. Celle-ci consiste à ajouter un gestionnaire d'erreur sur le dernier élément source et d'utiliser celui-ci afin de remplacer l'élément par son contenu alternatif :

- -
<video controls>
-  <source src="dynamicsearch.mp4" type="video/mp4"></source>
-  <a href="dynamicsearch.mp4">
-    <img src="dynamicsearch.jpg" alt="Recherche sur une application">
-  </a>
-  <p>Cliquez sur l'image pour voir une vidéo de démonstration</p>
-</video>
-
- -
-let v = document.querySelector('video'),
-    sources = v.querySelectorAll('source'),
-    lastsource = sources[sources.length-1];
-lastsource.addEventListener('error', function(ev) {
-  const d = document.createElement('div');
-  d.innerHTML = v.innerHTML;
-  v.parentNode.replaceChild(d, v);
-}, false);
-
- -

Bibliothèques JavaScript audio/vidéo

- -

Un certain nombre de bibliothèques JavaScript audio et vidéo existent. Les plus populaires permettent de choisir un design de lecteur cohérent sur tous les navigateurs et fournissent un contenu de secours pour les navigateurs qui ne prennent pas en charge l'audio et vidéo nativement. Le contenu de secours utilise souvent les plugins Adobe Flash ou Microsoft Silverlight. D'autres fonctionnalités telles que les éléments <track> pour les sous-titres peuvent également être fournies par les bibliothèques média.

- -

Audio uniquement

- - - -

Vidéo uniquement

- - - -

Audio et vidéo

- - - -

Web Audio API

- - - -

Tutoriels pour apprendre les bases

- -
-
Créer un lecteur vidéo fonctionnant sur tous les navigateurs (en anglais)
-
Guide pour créer un lecteur vidéo simple et fonctionnant sur tous les navigateurs en utilisant l'élément <video>
-
Bases concernant la mise en forme des lecteurs vidéo (en anglais)
-
À l'aide du lecteur vidéo mis en place sur l'article précédent, cet article montre comment fournir une mise en forme basique et responsive (en anglais)
-
Les bases pour créer un lecteur audio fonctionnant sur tous les navigateurs (en anglais)
-
Cet article propose un guide de base pour créer un lecteur audio HTML5 qui fonctionne sur tous les navigateurs, avec une explication pour tous les attributs, propriétés et évènements associés, ainsi qu'un guide introduisant rapidement les contrôles personnalisés créés avec l'API Media (en anglais)
-
Mise en tampon des fichiers médias, recherche et gestion des intervales de temps
-
Parfois, il est utile de savoir le temps de téléchargment et de lecture des éléments <audio> ou <video> sans attendre — un bon exemple d'application est la barre de progression mise en mémoire tampon d'un fichier audio ou vidéo. Cet article présente la construction d'une barre de recherche et mise en mémoire tampon en utilisant l'API TimeRanges ainsi que d'autres fonctionnalités de l'API Media.
-
Explications concernant la propriété playbackRate proposée par HTML5
-
La propriété playbackRate permet de modifier la vitesse ou la fréquence à laquelle un morceau de fichier audio ou vidéo est joué. Cet article l'explique en détails.
-
Utilisation de l'API Web Audio
-
Explique les bases de l'API Web Audio, afin de pouvoir atteindre, manipuler et jouer une ressource audio.
-
- -

Tutoriels concernant la diffusion en direct (streaming)

- -
-
Diffusion en direct de fichiers audio et vidéo sur le web
-
Les technologies de diffusion en direct sont souvent employées pour diffuser en direct des évènements sportifs, des concerts et plus généralement des programmes télévisuels ou radiophoniques qui se déroulent en direct. Le terme est souvent raccourci en parlant de « direct » ou en anglais de streaming ou de live. Il s'agit du processus de transmission en direct d'une source média. Cela est plutôt complexe et sujet à de nombreux paramètres. Cet article fait une présentation générale du sujet et indique comment débuter.
-
Mettre en place une ressource média diffusée en direct adaptative
-
Si vous avez besoin de mettre en place une ressource média diffusée en direct et adaptative sur un serveur, et que cette ressource doit être consommée au sein d'un élément média HTML5, cet article explique comment faire. Il détaille les deux principaux formats, MPEG-DASH et HLS (HTTP Live Streaming)
-
Diffusion en direct et adaptative DASH pour les vidéos HTML5
-
Informations concernant la mise en place d'une diffusion en direct adaptative avec les formats DASH et WebM.
-
- -

Tutoriels avancés

- -
-
Ajout de légendes et de sous-titres aux vidéos HTML5
-
Cet article explique comment ajouter des légendes et des sous-titres à l'élément HTML5 <video>, en utilisant le format VTT (Video Text Tracks) et l'élément <track>.
-
Utiliser l'API Audio de façon compatible
-
Un guide pour utiliser l'API Audio de façon compatible sur tous les navigateurs.
-
Capture audio simplifiée avec l'API MediaRecorder
-
Cet article montre les bases de l'utilisation de l'API MediaRecorder, utilisée afin d'enregistrer un flux média.
-
- -

Références

- - diff --git a/files/fr/web/guide/audio_and_video_delivery/index.md b/files/fr/web/guide/audio_and_video_delivery/index.md new file mode 100644 index 0000000000..9b5ede8e2d --- /dev/null +++ b/files/fr/web/guide/audio_and_video_delivery/index.md @@ -0,0 +1,485 @@ +--- +title: Intégration audio et vidéo +slug: Web/Guide/Audio_and_video_delivery +translation_of: Web/Guide/Audio_and_video_delivery +--- +

On peut distribuer de l'audio et de la vidéo sur le web de plusieurs manières, du fichier média statique au live stream (flux en direct) adaptatif. Cet article se veut être le point de départ pour explorer les différents mécanismes de diffusion de média sur le web et la compatiblité avec les navigateurs populaires.

+ +

Les éléments audio et vidéo

+ +

Que l'on traite des fichiers audio pré-enregistrés ou des flux en directs, le mécanisme pour les rendre disponibles à travers un navigateur reste à peu près le même — via les éléments <audio> et <video>. Actuellement, pour prendre en charge tous les navigateurs, il est nécessaire de définir deux formats — bien qu'avec l'adoption des formats MP3 et MP4 dans Firefox et Opera, cela change rapidement. Vous pouvez trouver les informations de compatibilité des navigateurs aux endroits suivants :

+ + + +

Pour distribuer du contenu audio et vidéo, le processus général se déroule comme suit :

+ +
    +
  1. Vérifier quels formats sont pris en charge par le navigateur via la détection de fonctionnalité ;
    2. +
  2. Si le navigateur ne lit pas nativement les formats fournis, utiliser un contenu de secours dans un autre format ;
    3. +
  3. Définir la façon dont vous voulez lire/instancier le média (par exemple un élément <video>, ou peut-être via JavaScript avec document.createElement('video')) ;
    4. +
  4. Ajouter le fichier média au lecteur.
    5. +
+ +

Audio HTML

+ +
<audio controls preload="auto">
+  <source src="audiofile.mp3" type="audio/mpeg">
+
+  <!-- fallback pour les navigateurs qui ne supportent pas mp3 -->
+  <source src="audiofile.ogg" type="audio/ogg">
+
+  <!-- fallback pour les navigateurs qui ne supportent pas la balise audio -->
+  <a href="audiofile.mp3">Télécharger l'audio</a>
+</audio>
+ +

Le code ci-dessus va créer un lecteur audio qui tente de précharger autant d'audio que possible pour une lecture fluide.

+ +
+

Note : l'attribut preload peut être ignoré par certains navigateurs mobiles.

+
+ +

Pour plus d'informations voir Les bases de l'audio multi-navigateur (Audio HTML5 en détails)

+ +

Vidéo HTML

+ +
<video controls width="640" height="480" poster="initialimage.png" autoplay muted>
+  <source src="videofile.mp4" type="video/mp4">
+
+  <!-- fallback pour les navigateurs qui ne supportent pas mp4 -->
+  <source src="videofile.webm" type="video/webm">
+
+  <!-- spécifie les fichiers de sous-titres -->
+  <track src="subtitles_en.vtt" kind="subtitles" srclang="en" label="English">
+  <track src="subtitles_no.vtt" kind="subtitles" srclang="no" label="Norwegian">
+
+  <!-- fallback pour les navigateurs qui ne supportent pas la balise video -->
+  <a href="videofile.mp4">Télécharger la vidéo</a>
+</video>
+ +

Le code ci-dessus crée un lecteur vidéo de dimensions 640x480 pixels, affichant une vignette jusqu'à ce que la vidéo soit lue. On demande à la vidéo de passer en autoplay (jouer automatiquement) mais d'être muted (en sourdine) par défaut.

+ +
+

Note : l'attribut autoplay peut être ignoré par certains navigateurs mobiles et est sujet à controverse lorsqu'il est utilisé à mauvais escient. Il est recommandé de lire le guide à ce sujet pour savoir comment l'utiliser pertinemment.

+
+ +

Pour plus d'informations voir l'article de référence sur l'élément <video> et la page sur la création d'un lecteur vidéo multi-navigateur.

+ +

Audio JavaScript

+ +
const myAudio = document.createElement('audio');
+
+if (myAudio.canPlayType('audio/mpeg')) {
+  myAudio.setAttribute('src','audiofile.mp3');
+} else if (myAudio.canPlayType('audio/ogg')) {
+  myAudio.setAttribute('src','audiofile.ogg');
+}
+
+myAudio.currentTime = 5;
+myAudio.play();
+ +

On définit la source de l'audio en fonction du type de fichier audio pris en charge par le navigateur, puis nous plaçons la tête de lecture à 5 secondes et essayons de lire le fichier.

+ +
+

Note : play() sera ignoré par certains navigateurs mobiles à moins que l'événement ne soit initié par une action de la personne visitant le site.

+
+ +

Il est également possible de donner un fichier WAV encodé en base64 à l'élément <audio>, permettant ainsi de générer de l'audio à la volée :

+ +
<audio id="player" src="data:audio/x-wav;base64,UklGRvC..."></audio>
+ +

Speak.js emploie cette technique. Essayez la démo.

+ +

Vidéo JavaScript

+ +
const myVideo = document.createElement('video');
+
+if (myVideo.canPlayType('video/mp4')) {
+  myVideo.setAttribute('src','videofile.mp4');
+} else if (myVideo.canPlayType('video/webm')) {
+  myVideo.setAttribute('src','videofile.webm');
+}
+
+myVideo.width = 480;
+myVideo.height = 320;
+ +

On définit la source de la vidéo en fonction du type de fichier vidéo pris en charge par le navigateur, puis on définit la largeur et la hauteur de la vidéo.

+ +

API Web Audio

+ +
let context;
+let request;
+let source;
+
+try {
+  context = new AudioContext();
+  request = new XMLHttpRequest();
+  request.open("GET","https://jplayer.org/audio/mp3/RioMez-01-Sleep_together.mp3",true);
+  request.responseType = "arraybuffer";
+
+  request.onload = function() {
+    context.decodeAudioData(request.response, function(buffer) {
+      source = context.createBufferSource();
+      source.buffer = buffer;
+      source.connect(context.destination);
+      // auto play
+      source.start(0); // start était précédemment intitulé noteOn
+    });
+  };
+
+  request.send();
+
+} catch(e) {
+  console.error(`L'API Web Audio n'est pas prise en charge`);
+}
+ +

Dans cet exemple, on récupère un fichier MP3 via XHR, on le charge et on le lit (essayez par vous-même). Pour en savoir plus sur l'API Web Audio voir Utiliser l'API Web Audio.

+ +

getUserMedia / Stream API

+ +

Il est également possible de récupérer un live stream de la webcam et/ou du microphone de la personne consultant le site avec getUserMedia et l'API Stream. Cela fait partie d'une technologie plus largement connue sous le nom de WebRTC (Web Real-Time Communications) et est compatible avec les dernières versions de Chrome, Firefox et Opera.

+ +

Pour récupérer un flux de la webcam, commençons par créer un élément <video> :

+ +
<video id="webcam" width="480" height="360"></video>
+ +

Ensuite, si cette opération est prise en charge, nous connectons la webcam à l'élément video :

+ +
+if (navigator.mediaDevices) {
+  navigator.mediaDevices.getUserMedia({ video: true, audio: false })
+  .then(function onSuccess(stream) {
+    const video = document.getElementById('webcam');
+    video.autoplay = true;
+    video.srcObject = stream;
+  })
+  .catch(function onError() {
+    console.error(`Problème de récupération des flux : utilisez-vous une page avec file:/// ou avez-vous décliné la permission ?`);
+  });
+} else {
+  console.error(`getUserMedia n'est pas pris en charge par ce navigateur.`);
+}
+
+ +

Pour en savoir plus, lisez la page MediaDevices.getUserMedia.

+ +

Enregistrement de flux média

+ +

De nouveaux standards sont en cours de déploiement pour permettre au navigateur de récupérer le flux du micro ou de la webcam — en utilisant getUserMedia — et l'enregistrer directement avec la nouvelle API MediaRecorder. Pour ce faire, on prend le stream retourné par getUserMedia, on le donne en paramètre à un objet MediaRecorder, puis on utilise le résultat obtenu comme source audio ou video.

+ +

Le principe de base est décrit ci-après :

+ +
+navigator.mediaDevices.getUserMedia({audio:true})
+  .then(function onSuccess(stream) {
+    const recorder = new MediaRecorder(stream);
+
+    const data = [];
+    recorder.ondataavailable = function(e) {
+      data.push(e.data);
+    };
+    recorder.start();
+    recorder.onerror = function(e) {
+      throw e.error || new Error(e.name); // e.name est utilisé pour Firefox
+    }
+    recorder.onstop = function(e) {
+      const audio = document.createElement('audio');
+      audio.src = window.URL.createObjectURL(new Blob(data));
+    }
+    setTimeout(function() {
+      rec.stop();
+    }, 5000);
+  })
+  .catch(function onError(error) {
+    console.log(error.message);
+  });
+
+ +

Voir l'API MediaRecorder pour plus de détails.

+ +

Media Source Extensions (MSE)

+ +

Media Source Extensions (MSE ou « extensions pour les sources de média ») est un brouillon de travail (Working Draft en anglais) du W3C qui prévoit d'étendre HTMLMediaElement pour permettre à JavaScript de générer des flux média pour la lecture. Permettre à JavaScript de générer des flux facilite différents cas d'usage comme la diffusion en direct adaptative et le décalage temporel des flux de diffusion en direct.

+ +

Encrypted Media Extensions (EME)

+ +

Encrypted Media Extensions (EME ou « extensions pour les médias chiffrés ») est une proposition du W3C d'étendre HTMLMediaElement en fournissant des API pour contrôler la lecture de contenu protégé.

+ +

L'API prend en charge divers cas d'utilisation, allant du simple déchiffrement par clé aux vidéos protégées par DRM (pourvu que le navigateur implémente ce système). L'échange de licence/clé est contrôlé par l'application, facilitant ainsi le développement d'applications de lecture robustes et qui prennent en charge différentes technologies de déchiffrement et de protection de contenu. Un des principaux usages d'EME est de permettre au navigateur d'implémenter la gestion des DRM (Digital Rights Management).

+ +

Diffusion adaptative

+ +

De nouveaux formats et protocoles ont été (et sont encore) deployés pour faciliter la diffusion adaptative. Une diffusion adaptative est un flux en direct qui s'adapte à la bande passante disponible de la personne utilisant le site. Typiquement, la qualité du stream peut changer en temps réel pour utiliser plus ou moins de bande passante. La diffusion adaptative est souvent utilisée en conjonction avec le live streaming, où une diffusion fluide de l'audio et vidéo est primordiale.

+ +

Les principaux encodages utilisés pour le streaming adaptatif sont HLS et MPEG-DASH. MSE a été conçu avec DASH en tête, il définit les flux d'octets selon ISOBMFF et M2TS (deux formats pris en charge par DASH, le dernier étant également pris en charge par HLS). DASH est probablement la meilleure option en termes de compatibilité, standard et flexibilité.

+ +
+

Note : actuellement, Safari ne prend pas en charge DASH, cependant dash.js marche sur les nouvelles versions de Safari prévues pour être publiées avec OSX Yosemite.

+
+ +

DASH fournit également un certain nombre de profils, y compris des profils à la demande simples, sans pré-traitement ni séparation des fichiers multimédia. Il existe un certain nombre de services en ligne qui vous permettront de convertir vos média en HLS ou DASH.

+ +

Pour plus d'informations, voir Live streaming web Audio et Vidéo.

+ +

Personnaliser votre lecteur média

+ +

Vous pouvez vouloir un lecteur audio ou vidéo qui ait le même aspect sur tous les navigateurs, ou simplement vouloir l'adapter à votre site. La technique générale pour y parvenir est d'omettre l'attribut controls afin que les contrôles par défaut du navigateur ne s'affichent pas, et de créer vos propres contrôles en HTML et CSS, avec du JavaScript pour lier vos contrôles à l'API audio/vidéo.

+ +

Si vous avez besoin d'aller plus loin, il est possible d'ajouter des fonctionnalités qui ne sont pas présentes par défaut dans les lecteurs, tels que la vitesse de lecture, le choix de la qualité ou mêmes les spectres audio. Vous pouvez également décider de rendre votre lecteur responsive — par exemple, vous pouvez enlever la barre de progression sous certaines conditions.

+ +

Vous pouvez détecter les événements de clic, de toucher et/ou de clavier pour déclencher des actions telles que lecture, pause et stop. Il est souvent souhaitable d'ajouter des raccourcis clavier pour plus de commodité et d'accessibilité pour la personne utilisant le lecteur média.

+ +

Un exemple rapide — d'abord, configurez votre audio et vos contrôles personnalisés en HTML:

+ +
+<audio id="my-audio" src="https://jPlayer.org/audio/mp3/Miaow-01-Tempered-song.mp3"></audio>
+<button id="my-control">play</button>
+ +

Ensuite, ajoutez un peu de JavaScript pour détecter les événements afin de lire et de mettre en pause l'audio:

+ +
window.onload = function() {
+
+  const myAudio = document.getElementById('my-audio');
+  const myControl = document.getElementById('my-control');
+
+  function switchState() {
+    if (myAudio.paused == true) {
+      myAudio.play();
+      myControl.textContent = "pause";
+    } else {
+      myAudio.pause();
+      myControl.textContent = "play";
+    }
+  }
+
+  function checkKey(e) {
+    if (e.keycode == 32 ) { //spacebar
+      switchState();
+    }
+  }
+
+  myControl.addEventListener('click', function() {
+    switchState();
+  }, false);
+
+  window.addEventListener( "keypress", checkKey, false );
+}
+ +

Vous pouvez essayer cet exemple ici. Pour plus d'informations, voir Créer votre propre lecteur audio.

+ +

Autres conseils pour l'audio/video

+ +

Interrompre le téléchargement d'un média

+ +

Bien qu'il suffit d'utiliser la méthode pause() pour interrompre la lecture d'un média, le navigateur continue de télécharger le média jusqu'à ce que l'élément correspondant soit nettoyé par le ramasse-miettes.

+ +

Voici une astuce qui permet d'arrêter le téléchargement :

+ +
const mediaElement = document.querySelector("#monIDdeMedia");
+mediaElement.removeAttribute("src");
+mediaElement.load();
+
+ +

En supprimant l'attribut src de l'élément et en invoquant la méthode load(), on libère les ressources associées à la vidéo, ce qui entraîne l'arrêt du téléchargement. Il est nécessaire d'invoquer load() après le retrait de l'attribut, car sa simple suppression ne relance pas l'algorithme chargement. Si l'élément <video> dispose également d'éléments descendants <source>, ceux-ci devraient également être supprimés avant l'appel à load().

+ +

Si on définit l'attribut src avec une chaîne vide, le navigateur considèrera la source comme un chemin relatif et cela déclenchera une tentative d'un autre téléchargement à partir d'une source qui n'est probablement pas une vidéo valide.

+ +

Parcourir la piste du média

+ +

Les éléments média permettent de placer le curseur de lecture à des instants spécifiques du contenu. Pour cela, on ajustera la propriété currentTime de l'élément (voir HTMLMediaElement pour plus de détails)

+ +

La propriété seekable de l'élément peut être utilisée afin de déterminer les intervalles disponibles pour de tels déplacements. Cette propriété renvoie un objet TimeRanges contenant les intervalles temporels accessibles.

+ +
const mediaElement = document.querySelector('#mediaElementID');
+mediaElement.seekable.start(0);  // Renvoie l'instant de départ (en secondes)
+mediaElement.seekable.end(0);    // Renvoie l'instant de fin (en secondes)
+mediaElement.currentTime = 122;  // Déplace la lecture à 122 secondes
+mediaElement.played.end(0);      // Renvoie le nombre de secondes lues par le navigateur
+
+ +

Définir des intervalles de lecture

+ +

Lors de la définition de l'URI du média d'un élément <audio> ou <video>, il est possible d'ajouter des informations supplémentaires pour indiquer la portion du média qu'on souhaite lire. Pour cela, on ajoutera un dièse/croisillon (« # ») suivi de la description du fragment de média.

+ +

Un intervalle temporel se définit avec la syntaxe suivante :

+ +
#t=[tempsdebut][,tempsfin]
+ +

La valeur temporelle peut être définie en nombre de secondes (avec une valeur décimale) ou avec un horodatage en heures/minutes/secondes avec un deux-points comme séparateur (par exemple 2:05:01 pour indiquer 2 heures, 5 minutes et 1 seconde).

+ +

Voici quelques exemples :

+ +
+
https://example.com/video.ogv#t=10,20
+
Indique que la vidéo devrait jouer l'intervalle compris entre 10 et 20 secondes.
+
https://example.com/video.ogv#t=,10.5
+
Indique que la vidéo devrait jouer l'intervalle depuis le début et jusqu'à 10,5 secondes.
+
https://example.com/video.ogv#t=,02:00:00
+
Indique que la vidéo devrait jouer depuis le début et jusqu'à deux heures.
+
https://example.com/video.ogv#t=60
+
Indique que la vidéo devrait commencer sa lecture à 60 secondes puis continuer jusqu'à la fin.
+
+ +

Déboguer les problèmes audio/vidéo

+ +

Vous rencontrez des problèmes de lecture audio ou vidéo ? Vérifiez les différents points qui suivent.

+ +

Est-ce que le navigateur prend en charge les formats fournis ?

+ +

Utilisez les fichiers suivants pour vérifier le support de votre format:

+ + + +

Si un de ces fichiers n'est pas lu, c'est que le navigateur que vous testez ne prend pas en charge le format correspondant. Vous pouvez utiliser un format différent ou un contenu de secours.

+ +

Si ces fichiers fonctionnent mais que votre fichier ne fonctionne pas, il y a deux explications possibles, que nous verrons ci-après.

+ +

1. Le serveur ne fournit pas le type MIME correct du fichier

+ +

Bien que les serveurs les prennent généralement en charge, vous allez peut-être avoir besoin d'ajouter ce qui suit à votre fichier .htaccess :

+ +
# AddType TYPE/SUBTYPE EXTENSION
+
+AddType audio/mpeg mp3
+AddType audio/mp4 m4a
+AddType audio/ogg ogg
+AddType audio/ogg oga
+
+AddType video/mp4 mp4
+AddType video/mp4 m4v
+AddType video/ogg ogv
+AddType video/webm webm
+AddType video/webm webmv
+ +

2. Votre fichier n'est pas encodé correctement

+ +

Votre fichier n'a peut-être pas été encodé correctement — essayez de l'encoder en utilisant un des outils suivants, qui sont plutôt fiables :

+ + + +

Utiliser du contenu de substitution si la source n'a pu être décodée

+ +

Il existe une autre méthode pour présenter du contenu alternatif lorsqu'aucune des ressources n'a pu être décodée par le navigateur. Celle-ci consiste à ajouter un gestionnaire d'erreur sur le dernier élément source et d'utiliser celui-ci afin de remplacer l'élément par son contenu alternatif :

+ +
<video controls>
+  <source src="dynamicsearch.mp4" type="video/mp4"></source>
+  <a href="dynamicsearch.mp4">
+    <img src="dynamicsearch.jpg" alt="Recherche sur une application">
+  </a>
+  <p>Cliquez sur l'image pour voir une vidéo de démonstration</p>
+</video>
+
+ +
+let v = document.querySelector('video'),
+    sources = v.querySelectorAll('source'),
+    lastsource = sources[sources.length-1];
+lastsource.addEventListener('error', function(ev) {
+  const d = document.createElement('div');
+  d.innerHTML = v.innerHTML;
+  v.parentNode.replaceChild(d, v);
+}, false);
+
+ +

Bibliothèques JavaScript audio/vidéo

+ +

Un certain nombre de bibliothèques JavaScript audio et vidéo existent. Les plus populaires permettent de choisir un design de lecteur cohérent sur tous les navigateurs et fournissent un contenu de secours pour les navigateurs qui ne prennent pas en charge l'audio et vidéo nativement. Le contenu de secours utilise souvent les plugins Adobe Flash ou Microsoft Silverlight. D'autres fonctionnalités telles que les éléments <track> pour les sous-titres peuvent également être fournies par les bibliothèques média.

+ +

Audio uniquement

+ + + +

Vidéo uniquement

+ + + +

Audio et vidéo

+ + + +

Web Audio API

+ + + +

Tutoriels pour apprendre les bases

+ +
+
Créer un lecteur vidéo fonctionnant sur tous les navigateurs (en anglais)
+
Guide pour créer un lecteur vidéo simple et fonctionnant sur tous les navigateurs en utilisant l'élément <video>
+
Bases concernant la mise en forme des lecteurs vidéo (en anglais)
+
À l'aide du lecteur vidéo mis en place sur l'article précédent, cet article montre comment fournir une mise en forme basique et responsive (en anglais)
+
Les bases pour créer un lecteur audio fonctionnant sur tous les navigateurs (en anglais)
+
Cet article propose un guide de base pour créer un lecteur audio HTML5 qui fonctionne sur tous les navigateurs, avec une explication pour tous les attributs, propriétés et évènements associés, ainsi qu'un guide introduisant rapidement les contrôles personnalisés créés avec l'API Media (en anglais)
+
Mise en tampon des fichiers médias, recherche et gestion des intervales de temps
+
Parfois, il est utile de savoir le temps de téléchargment et de lecture des éléments <audio> ou <video> sans attendre — un bon exemple d'application est la barre de progression mise en mémoire tampon d'un fichier audio ou vidéo. Cet article présente la construction d'une barre de recherche et mise en mémoire tampon en utilisant l'API TimeRanges ainsi que d'autres fonctionnalités de l'API Media.
+
Explications concernant la propriété playbackRate proposée par HTML5
+
La propriété playbackRate permet de modifier la vitesse ou la fréquence à laquelle un morceau de fichier audio ou vidéo est joué. Cet article l'explique en détails.
+
Utilisation de l'API Web Audio
+
Explique les bases de l'API Web Audio, afin de pouvoir atteindre, manipuler et jouer une ressource audio.
+
+ +

Tutoriels concernant la diffusion en direct (streaming)

+ +
+
Diffusion en direct de fichiers audio et vidéo sur le web
+
Les technologies de diffusion en direct sont souvent employées pour diffuser en direct des évènements sportifs, des concerts et plus généralement des programmes télévisuels ou radiophoniques qui se déroulent en direct. Le terme est souvent raccourci en parlant de « direct » ou en anglais de streaming ou de live. Il s'agit du processus de transmission en direct d'une source média. Cela est plutôt complexe et sujet à de nombreux paramètres. Cet article fait une présentation générale du sujet et indique comment débuter.
+
Mettre en place une ressource média diffusée en direct adaptative
+
Si vous avez besoin de mettre en place une ressource média diffusée en direct et adaptative sur un serveur, et que cette ressource doit être consommée au sein d'un élément média HTML5, cet article explique comment faire. Il détaille les deux principaux formats, MPEG-DASH et HLS (HTTP Live Streaming)
+
Diffusion en direct et adaptative DASH pour les vidéos HTML5
+
Informations concernant la mise en place d'une diffusion en direct adaptative avec les formats DASH et WebM.
+
+ +

Tutoriels avancés

+ +
+
Ajout de légendes et de sous-titres aux vidéos HTML5
+
Cet article explique comment ajouter des légendes et des sous-titres à l'élément HTML5 <video>, en utilisant le format VTT (Video Text Tracks) et l'élément <track>.
+
Utiliser l'API Audio de façon compatible
+
Un guide pour utiliser l'API Audio de façon compatible sur tous les navigateurs.
+
Capture audio simplifiée avec l'API MediaRecorder
+
Cet article montre les bases de l'utilisation de l'API MediaRecorder, utilisée afin d'enregistrer un flux média.
+
+ +

Références

+ + diff --git a/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.html b/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.html deleted file mode 100644 index 15662fe166..0000000000 --- a/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.html +++ /dev/null @@ -1,289 +0,0 @@ ---- -title: Live streaming web Audio et Vidéo -slug: Web/Guide/Audio_and_video_delivery/Live_streaming_web_audio_and_video -tags: - - Guide - - Streaming adaptatif -translation_of: Web/Guide/Audio_and_video_delivery/Live_streaming_web_audio_and_video ---- - -

La technologie de live streaming (diffusion en direct) est souvent utilisée pour relayer des événements en direct, tels que le sport, les concerts, ou de manière plus générale les programmes TV et radio en direct. Souvent raccourci au simple terme de streaming, le live streaming est le processus de transmissions d'un média live (c'est à dire dynamique et non statique) aux ordinateurs et aux périphériques. C'est un sujet assez complexe et nouveau avec beaucoup de variables à prendre en considération, dans cet article nous allons vous introduire le sujet et vous donner des clés pour démarrer.

- -

La première chose à avoir en tête quand on diffuse un live stream à un navigateur est le fait que, plutôt que de jouer un fichier fini, on relaie un fichier qui est créé à la volée et qui n'a pas de début ou de fin prédéterminé.

- -

Principales différences entre media en stream et statique

- -

Un média statique est un média stocké dans un fichier, comme un fichier mp3 ou webm. Ce fichier se trouve sur un serveur et peut être délivré — comme la plupart des types de fichier — au navigateur. Le navigateur peut commencer à jouer le média avant de l'avoir reçu en intégralité, c'est ce qu'on appelle un téléchargement progressif.

- -

Un média en live stream n'a pas de temps de début et de fin finis comme un fichier statique, c'est un flux de données que le serveur transmet au navigateur et qui est souvent adaptatif (explication ci-dessous). Habituellement, il est nécessaire d'utiliser des formats différents et des logiciles spéciaux côté serveur pour y parvenir.

- -

Streaming adaptatif

- -

Une des principale priorité du live streaming est de garder le lecteur du client synchronisé avec le flux envoyé par le serveur: le streaming adaptatif est une technique qui le permet, qui s'adapte en cas de bande passante faible. Le taux de transfert des données est contrôlé, et, s'il semble être en retard, utilise un flux qui demande moins de bande passante (et donc de qualité inférieure).

- -

Pour que ce soit possible, on doit utiliser des formats qui facilitent cette opération. Les formats de live streaming autorisent généralement une diffusion adaptative en divisant le flux en série de petits segments, et en rendant ces segments disponibles à différents qualités et débits binaires.

- -

Streaming Audio et Vidéo à la demande

- -

La technologie de streaming n'est pas utilisée exclusivement pour les live streams. Elle peut également être utilisée à la place de la méthode traditionnelle de téléchargement progressif, pour diffuser des fichiers audio et vidéo à la demande. Il y a plusieurs avantages à ça:

- - - -

Protocoles de Streaming

- -

Tandis que les médias statiques sont généralement servis avec HTTP, il existe plusieurs protocoles pour servir un stream adaptatif; voyons les différentes options.

- -

HTTP

- -

Pour l'instant, HTTP est de loin le protocole le plus couramment utilisé pour transférer des médias à la demande ou en stream.

- -

RTMP

- -

Real Time Messaging Protocol (RTMP) est un protocole propriétaire développée par Macromedia (maintenant Adobe) et supporté par le plugin Adobe Flash. RTMP est disponible en plusieurs variantes, notamment RTMPE (Encrypté), RTMPS (Securisé sur SSL/TLS) et RTMPT (encapsulé dans des requêtes HTTP).

- -

RTSP

- -

Real Time Streaming Protocol (RTSP) contrôle les sessions média entre les entités et il est souvent utilisé en combinaison avec Real-time Transport Protocol (RTP) et Real-time Control Protocol (RTCP) pour délivrer des flux média. Utiliser RTP avec RTCP permet un streaming adaptatif. Il n'est pas encore suporté nativement par la plupart des navigateurs, mais Firefox OS 1.3 supporte RTSP.

- -
-

Note : Certains fournisseurs implémentent des protocoles de transfert propriétaires, tel que RealNetworks et leur Real Data Transport (RDT).

-
- -

RTSP 2.0

- -

RTSP 2.0 est actuellement en cours de développement, il n'est pas rétro-compatible avec RTSP 1.0.

- -
-

Attention : Bien que les balises {{ htmlelement("audio") }} et {{ htmlelement("video") }} soient agnostiques de tout protocole, aucun navigateur ne supporte actuellement autre chose que HTTP sans nécessiter de plugin, bien que cela semble être parti pour changer. De plus, les protocoles autres que HTTP peuvent être bloqués par des pare-feu et des serveurs proxy.

-
- -

Utiliser des protocoles de streaming

- -

Le procédé pour utiliser différents protocoles vous sera familier si vous avez l'habitude de travailler avec les média sur HTTP — il suffit de spécifier le protocole.

- -

Par exemple:

- -
<video src="rtsp://myhost.com/mymedia.format">
- <!-- Fallback here -->
-</video>
- -

Extensions de Sources Média  (MSE)

- -

Media Source Extensions est un brouillon de travail de W3C qui prévoit d'étendre {{ domxref("HTMLMediaElement") }} pour permettre à JavaScript de générer des flux média pour la lecture. Permettre à JavaScript de générer des streams facilite toute une variété de cas d'utilisations comme le streaming adaptatif et le décalage temporel des live streams.
-
- Par exemple, vous pourriez implémenter MPEG-DASH en utilisant JavaScript tout en laissant le décodage à la charge de MSE.

- -
-

Note : Le décalage temporel est le processus de lire un live stream quelque temps après qu'il ait été diffusé.

-
- -

Formats de fichiers Vidéo en Streaming

- -

Quelques formats de vidéo en live streaming HTTP commençent à être pris en charge parmi les navigateurs.

- -
-

Note : Vous pouvez trouver un guide pour encoder HLS et MPEG-DASH pour une utilisation sur le web sur Configuration de sources multimédia en streaming adaptatif.

-
- -

MPEG-DASH

- -

DASH est l'acronyme de Dynamic Adaptive Streaming over HTTP, c'est un nouveau format dont le support a récemment été ajouté à Chrome, et Internet Explorer 11 sous Windows 8.1. Il est supporté via les Extensions de Sources Media, qui sont utilisées par les bibliothèques JavaScript comme DASH.js.

- -

Cette approche permet de télécharger des segments de flux vidéo en utilisant XHR et en "ajoutant" le segment au flux en cours de lecture par l'élément {{ htmlelement("video") }}. Ainsi, par exemple, si l'on détecte que le réseau est lent, on peut demander des segments de moins bonne qualité (plus petits) en cours de route. Cette technologie permet également d'ajouter/insérer un segment publicitaire dans le flux.

- -
-

Note : Vous pouvez également utiliser WebM avec le système de streaming adaptatif MPEG DASH.

-
- -

HLS

- -

HLS (HTTP Live Streaming) est un protocole inventé par Apple Inc et il est pris en charge par iOS, Safari et les dernières versions du navigateur Android / Chrome. HLS est également adaptatif.
-
- HLS peut également être décodé en utilisant JavaScript, ce qui signifie que l'on peut supporter les dernières versions de Firefox, Chrome et Internet Explorer 10+. Voir ce lecteur JavaScript HTTP Live Streaming.
-
- Au début de la session de streaming, une playlist M3U étendue (m3u8) est téléchargée. Elle contient les metadonnées des différents sous-fux fournis.

- -

Suport de formats de fichiers en Streaming

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NavigateurDASHHLSOpus (Audio)
Firefox 32✓ [1]✓ [2]✓ 14+
Safari 6+ ✓ 
Chrome 24+✓ [1]✓ 
Opera 20+✓ [1]  
Internet Explorer 10+✓ 11✓ [2] 
Firefox Mobile✓✓✓
Safari iOS6+ ✓ 
Chrome Mobile✓✓ [2] 
Opera Mobile✓ [1]✓ 
Internet Explorer Mobile✓ 11✓ [2] 
Android✓  
- -

[1] Via JavaScript et MSE

- -

[2] Via JavaScript et un Proxy CORS

- -

Video de secours

- -

Entre DASH et HLS, on peut couvrir une partie importante des navigateurs modernes mais il faut encore une solution de secours si on veut supporter le reste.
-
- Une approche populaire est d'utiliser Flash en solution de secours, qui prend en charge RTMP. Bien sûr, le problème est qu'il nous faut alors encoder dans trois formats de données différents.

- -

Formats de fichiers Audio en Streaming

- -

Il y a également quelques formats audio qui commençent à pris en charge par les navigateurs.

- -

Opus

- -

Opus est un format libre de droit et open source qui permet d'optimiser la qualité de différents débits binaires pour différents types audio. La musique et la parole peuvent être optimisées de différentes manières et Opus utilise les codecs SILK et CELT pour y parvenir.
-
- Actuellement, Opus est supporté par Firefox (bureau et mobile) ainsi que les dernières versions de Chrome bureau et Opera.

- -
-

Note : Opus est un format obligatoire pour les implémentations navigateur de WebRTC.

-
- -

MP3, AAC, Ogg Vorbis

- -

Les formats audio les plus courants peuvent être diffusés en stream en utilisant des technologies spécifiques côté serveur.

- -
-

Note : Il est plus facile de diffuser de l'audio en stream en utilisant des formats qui n'ont pas été conçu pour car, contrairement aux vidéos, il n'y a pas de keyframes.

-
- -

Technologies de Streaming côté serveur

- -

Pour diffuser de l'audio ou vidéo en live stream, vous devez exécuter un logiciel de streaming sur votre serveur ou utiliser un service tiers.

- -

GStreamer

- -

GStreamer est un framework multimédia open source et multi-platforme qui permet de créer une variété de composants pour gérer les médias, y compris des composants de streaming. À travers son système de plugin, GStreamer fournit un support pour plus d'une centaine de codecs (dont MPEG-1, MPEG-2, MPEG-4, H.261, H.263, H.264, RealVideo, MP3, WMV, et FLV.)

- -

Des plugins GStreamer existent, tels que souphttpclientsink et shout2send, pour diffuser en stream des médias sur HTTP. Vous pouvez également intégrer le framework Python Twisted ou utiliser quelque chose comme Flumotion (logiciel de streaming open source).

- -

Pour le transfert RTMP, vous pouvez utiliser le module Nginx RTMP.

- -

SHOUTcast

- -

SHOUTcast est une technologie propriétaire multi-plateforme pour diffuser des médias en streaming. Développé par Nullsoft, elle permet de diffuser du contenu audio au format MP3 ou AAC en broadcast. Pour utilisation sur le web, les streams SHOUTcast sont transmis sur HTTP.

- -
-

Note : Les urls SHOUTcast peuvent nécessiter l'ajout d'un point-virgule à la fin.

-
- -

Icecast

- -

Le serveur Icecast est une technologie open source pour diffuser des média en streaming. Maintenu par Xiph.org Foundation, il diffuse les formats Ogg Vorbis/Theora ainsi que MP3 et AAC  via le protocole SHOUTcast.

- -
-

Note : SHOUTcast et Icecast font partie des technologies les plus répandues et les plus populaires, mais il existe de nombreux autres systèmes de diffusion en streaming disponibles.

-
- -

Services de Streaming

- -

Bien que vous ayez la possibilité d'installer des logiciels tels que GStreamer, SHOUTcast et Icecast, vous pouvez également trouver de nombreux services de streaming tiers qui feront le travail pour vous.

- -

Voir aussi

- - - -


-  

- -

 

- -

 

- -

 

- -

 

diff --git a/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.md b/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.md new file mode 100644 index 0000000000..15662fe166 --- /dev/null +++ b/files/fr/web/guide/audio_and_video_delivery/live_streaming_web_audio_and_video/index.md @@ -0,0 +1,289 @@ +--- +title: Live streaming web Audio et Vidéo +slug: Web/Guide/Audio_and_video_delivery/Live_streaming_web_audio_and_video +tags: + - Guide + - Streaming adaptatif +translation_of: Web/Guide/Audio_and_video_delivery/Live_streaming_web_audio_and_video +--- + +

La technologie de live streaming (diffusion en direct) est souvent utilisée pour relayer des événements en direct, tels que le sport, les concerts, ou de manière plus générale les programmes TV et radio en direct. Souvent raccourci au simple terme de streaming, le live streaming est le processus de transmissions d'un média live (c'est à dire dynamique et non statique) aux ordinateurs et aux périphériques. C'est un sujet assez complexe et nouveau avec beaucoup de variables à prendre en considération, dans cet article nous allons vous introduire le sujet et vous donner des clés pour démarrer.

+ +

La première chose à avoir en tête quand on diffuse un live stream à un navigateur est le fait que, plutôt que de jouer un fichier fini, on relaie un fichier qui est créé à la volée et qui n'a pas de début ou de fin prédéterminé.

+ +

Principales différences entre media en stream et statique

+ +

Un média statique est un média stocké dans un fichier, comme un fichier mp3 ou webm. Ce fichier se trouve sur un serveur et peut être délivré — comme la plupart des types de fichier — au navigateur. Le navigateur peut commencer à jouer le média avant de l'avoir reçu en intégralité, c'est ce qu'on appelle un téléchargement progressif.

+ +

Un média en live stream n'a pas de temps de début et de fin finis comme un fichier statique, c'est un flux de données que le serveur transmet au navigateur et qui est souvent adaptatif (explication ci-dessous). Habituellement, il est nécessaire d'utiliser des formats différents et des logiciles spéciaux côté serveur pour y parvenir.

+ +

Streaming adaptatif

+ +

Une des principale priorité du live streaming est de garder le lecteur du client synchronisé avec le flux envoyé par le serveur: le streaming adaptatif est une technique qui le permet, qui s'adapte en cas de bande passante faible. Le taux de transfert des données est contrôlé, et, s'il semble être en retard, utilise un flux qui demande moins de bande passante (et donc de qualité inférieure).

+ +

Pour que ce soit possible, on doit utiliser des formats qui facilitent cette opération. Les formats de live streaming autorisent généralement une diffusion adaptative en divisant le flux en série de petits segments, et en rendant ces segments disponibles à différents qualités et débits binaires.

+ +

Streaming Audio et Vidéo à la demande

+ +

La technologie de streaming n'est pas utilisée exclusivement pour les live streams. Elle peut également être utilisée à la place de la méthode traditionnelle de téléchargement progressif, pour diffuser des fichiers audio et vidéo à la demande. Il y a plusieurs avantages à ça:

+ + + +

Protocoles de Streaming

+ +

Tandis que les médias statiques sont généralement servis avec HTTP, il existe plusieurs protocoles pour servir un stream adaptatif; voyons les différentes options.

+ +

HTTP

+ +

Pour l'instant, HTTP est de loin le protocole le plus couramment utilisé pour transférer des médias à la demande ou en stream.

+ +

RTMP

+ +

Real Time Messaging Protocol (RTMP) est un protocole propriétaire développée par Macromedia (maintenant Adobe) et supporté par le plugin Adobe Flash. RTMP est disponible en plusieurs variantes, notamment RTMPE (Encrypté), RTMPS (Securisé sur SSL/TLS) et RTMPT (encapsulé dans des requêtes HTTP).

+ +

RTSP

+ +

Real Time Streaming Protocol (RTSP) contrôle les sessions média entre les entités et il est souvent utilisé en combinaison avec Real-time Transport Protocol (RTP) et Real-time Control Protocol (RTCP) pour délivrer des flux média. Utiliser RTP avec RTCP permet un streaming adaptatif. Il n'est pas encore suporté nativement par la plupart des navigateurs, mais Firefox OS 1.3 supporte RTSP.

+ +
+

Note : Certains fournisseurs implémentent des protocoles de transfert propriétaires, tel que RealNetworks et leur Real Data Transport (RDT).

+
+ +

RTSP 2.0

+ +

RTSP 2.0 est actuellement en cours de développement, il n'est pas rétro-compatible avec RTSP 1.0.

+ +
+

Attention : Bien que les balises {{ htmlelement("audio") }} et {{ htmlelement("video") }} soient agnostiques de tout protocole, aucun navigateur ne supporte actuellement autre chose que HTTP sans nécessiter de plugin, bien que cela semble être parti pour changer. De plus, les protocoles autres que HTTP peuvent être bloqués par des pare-feu et des serveurs proxy.

+
+ +

Utiliser des protocoles de streaming

+ +

Le procédé pour utiliser différents protocoles vous sera familier si vous avez l'habitude de travailler avec les média sur HTTP — il suffit de spécifier le protocole.

+ +

Par exemple:

+ +
<video src="rtsp://myhost.com/mymedia.format">
+ <!-- Fallback here -->
+</video>
+ +

Extensions de Sources Média  (MSE)

+ +

Media Source Extensions est un brouillon de travail de W3C qui prévoit d'étendre {{ domxref("HTMLMediaElement") }} pour permettre à JavaScript de générer des flux média pour la lecture. Permettre à JavaScript de générer des streams facilite toute une variété de cas d'utilisations comme le streaming adaptatif et le décalage temporel des live streams.
+
+ Par exemple, vous pourriez implémenter MPEG-DASH en utilisant JavaScript tout en laissant le décodage à la charge de MSE.

+ +
+

Note : Le décalage temporel est le processus de lire un live stream quelque temps après qu'il ait été diffusé.

+
+ +

Formats de fichiers Vidéo en Streaming

+ +

Quelques formats de vidéo en live streaming HTTP commençent à être pris en charge parmi les navigateurs.

+ +
+

Note : Vous pouvez trouver un guide pour encoder HLS et MPEG-DASH pour une utilisation sur le web sur Configuration de sources multimédia en streaming adaptatif.

+
+ +

MPEG-DASH

+ +

DASH est l'acronyme de Dynamic Adaptive Streaming over HTTP, c'est un nouveau format dont le support a récemment été ajouté à Chrome, et Internet Explorer 11 sous Windows 8.1. Il est supporté via les Extensions de Sources Media, qui sont utilisées par les bibliothèques JavaScript comme DASH.js.

+ +

Cette approche permet de télécharger des segments de flux vidéo en utilisant XHR et en "ajoutant" le segment au flux en cours de lecture par l'élément {{ htmlelement("video") }}. Ainsi, par exemple, si l'on détecte que le réseau est lent, on peut demander des segments de moins bonne qualité (plus petits) en cours de route. Cette technologie permet également d'ajouter/insérer un segment publicitaire dans le flux.

+ +
+

Note : Vous pouvez également utiliser WebM avec le système de streaming adaptatif MPEG DASH.

+
+ +

HLS

+ +

HLS (HTTP Live Streaming) est un protocole inventé par Apple Inc et il est pris en charge par iOS, Safari et les dernières versions du navigateur Android / Chrome. HLS est également adaptatif.
+
+ HLS peut également être décodé en utilisant JavaScript, ce qui signifie que l'on peut supporter les dernières versions de Firefox, Chrome et Internet Explorer 10+. Voir ce lecteur JavaScript HTTP Live Streaming.
+
+ Au début de la session de streaming, une playlist M3U étendue (m3u8) est téléchargée. Elle contient les metadonnées des différents sous-fux fournis.

+ +

Suport de formats de fichiers en Streaming

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NavigateurDASHHLSOpus (Audio)
Firefox 32✓ [1]✓ [2]✓ 14+
Safari 6+ ✓ 
Chrome 24+✓ [1]✓ 
Opera 20+✓ [1]  
Internet Explorer 10+✓ 11✓ [2] 
Firefox Mobile✓✓✓
Safari iOS6+ ✓ 
Chrome Mobile✓✓ [2] 
Opera Mobile✓ [1]✓ 
Internet Explorer Mobile✓ 11✓ [2] 
Android✓  
+ +

[1] Via JavaScript et MSE

+ +

[2] Via JavaScript et un Proxy CORS

+ +

Video de secours

+ +

Entre DASH et HLS, on peut couvrir une partie importante des navigateurs modernes mais il faut encore une solution de secours si on veut supporter le reste.
+
+ Une approche populaire est d'utiliser Flash en solution de secours, qui prend en charge RTMP. Bien sûr, le problème est qu'il nous faut alors encoder dans trois formats de données différents.

+ +

Formats de fichiers Audio en Streaming

+ +

Il y a également quelques formats audio qui commençent à pris en charge par les navigateurs.

+ +

Opus

+ +

Opus est un format libre de droit et open source qui permet d'optimiser la qualité de différents débits binaires pour différents types audio. La musique et la parole peuvent être optimisées de différentes manières et Opus utilise les codecs SILK et CELT pour y parvenir.
+
+ Actuellement, Opus est supporté par Firefox (bureau et mobile) ainsi que les dernières versions de Chrome bureau et Opera.

+ +
+

Note : Opus est un format obligatoire pour les implémentations navigateur de WebRTC.

+
+ +

MP3, AAC, Ogg Vorbis

+ +

Les formats audio les plus courants peuvent être diffusés en stream en utilisant des technologies spécifiques côté serveur.

+ +
+

Note : Il est plus facile de diffuser de l'audio en stream en utilisant des formats qui n'ont pas été conçu pour car, contrairement aux vidéos, il n'y a pas de keyframes.

+
+ +

Technologies de Streaming côté serveur

+ +

Pour diffuser de l'audio ou vidéo en live stream, vous devez exécuter un logiciel de streaming sur votre serveur ou utiliser un service tiers.

+ +

GStreamer

+ +

GStreamer est un framework multimédia open source et multi-platforme qui permet de créer une variété de composants pour gérer les médias, y compris des composants de streaming. À travers son système de plugin, GStreamer fournit un support pour plus d'une centaine de codecs (dont MPEG-1, MPEG-2, MPEG-4, H.261, H.263, H.264, RealVideo, MP3, WMV, et FLV.)

+ +

Des plugins GStreamer existent, tels que souphttpclientsink et shout2send, pour diffuser en stream des médias sur HTTP. Vous pouvez également intégrer le framework Python Twisted ou utiliser quelque chose comme Flumotion (logiciel de streaming open source).

+ +

Pour le transfert RTMP, vous pouvez utiliser le module Nginx RTMP.

+ +

SHOUTcast

+ +

SHOUTcast est une technologie propriétaire multi-plateforme pour diffuser des médias en streaming. Développé par Nullsoft, elle permet de diffuser du contenu audio au format MP3 ou AAC en broadcast. Pour utilisation sur le web, les streams SHOUTcast sont transmis sur HTTP.

+ +
+

Note : Les urls SHOUTcast peuvent nécessiter l'ajout d'un point-virgule à la fin.

+
+ +

Icecast

+ +

Le serveur Icecast est une technologie open source pour diffuser des média en streaming. Maintenu par Xiph.org Foundation, il diffuse les formats Ogg Vorbis/Theora ainsi que MP3 et AAC  via le protocole SHOUTcast.

+ +
+

Note : SHOUTcast et Icecast font partie des technologies les plus répandues et les plus populaires, mais il existe de nombreux autres systèmes de diffusion en streaming disponibles.

+
+ +

Services de Streaming

+ +

Bien que vous ayez la possibilité d'installer des logiciels tels que GStreamer, SHOUTcast et Icecast, vous pouvez également trouver de nombreux services de streaming tiers qui feront le travail pour vous.

+ +

Voir aussi

+ + + +


+  

+ +

 

+ +

 

+ +

 

+ +

 

diff --git a/files/fr/web/guide/audio_and_video_manipulation/index.html b/files/fr/web/guide/audio_and_video_manipulation/index.html deleted file mode 100644 index 1b79154eb7..0000000000 --- a/files/fr/web/guide/audio_and_video_manipulation/index.html +++ /dev/null @@ -1,361 +0,0 @@ ---- -title: Manipulation Audio et Vidéo -slug: Web/Guide/Audio_and_video_manipulation -tags: - - Audio - - Canvas - - HTML5 - - Video - - Web Audio API - - WebGL -translation_of: Web/Guide/Audio_and_video_manipulation ---- -

La beauté du web est qu'on peut combiner différentes technologies pour en créer de nouvelles. Avoir de l'audio et vidéo nativement dans le navigateur nous donne la possibilité d'utiliser ces flux de données avec d'autres technologies comme {{htmlelement("canvas")}}, WebGL ou Web Audio API pour modifier le média — par exemple ajouter des effets de réverbération ou de compression à l'audio, ou encore des filtres noir & blanc/sépia aux vidéos. Cet article fournit une référence pour expliquer ce que vous pouvez faire.

- -

Manipulation Vidéo

- -

La possibilité de lire les valeurs de pixels de chaque image d'une vidéo peut être très utile, cela nous permet de placer ces images dans d'autres contextes.

- -

Vidéo et Canvas

- -

{{htmlelement("canvas")}} est un moyen de dessiner de manière scripté sur des pages web; c'est un outil très puissant et qui peut être couplé avec du contenu vidéo.

- -

La technique générale est comme suit:

- -
    -
  1. Dessiner une image de l'élément {{htmlelement("video")}} sur un élément {{htmlelement("canvas")}} intermédiaire.
    2. -
  2. Lire les données de l'élément <canvas> et les manipuler.
    3. -
  3. Écrire les données manipulées dans le <canvas> que l'on veut afficher.
    4. -
  4. Marquer une pause et répéter.
    5. -
- -

On peut configurer notre lecteur vidéo et l'élément <canvas> comme ceci:

- -
<video id="my-video" controls="true" width="480" height="270" crossorigin="anonymous">
-  <source src="http://jplayer.org/video/webm/Big_Buck_Bunny_Trailer.webm" type="video/webm">
-  <source src="http://jplayer.org/video/m4v/Big_Buck_Bunny_Trailer.m4v" type="video/mp4">
-</video>
-
-<canvas id="my-canvas" width="480" height="270"></canvas>
- -

Et les manipuler comme ceci: (en l'occurence, on affiche une version en noir et blanc de la vidéo)

- -
var processor = {
-  timerCallback: function() {
-    if (this.video.paused || this.video.ended) {
-      return;
-    }
-    this.computeFrame();
-    var self = this;
-    setTimeout(function () {
-      self.timerCallback();
-    }, 16); // roughly 60 frames per second
-  },
-
-  doLoad: function() {
-    this.video = document.getElementById("my-video");
-    this.c1 = document.getElementById("my-canvas");
-    this.ctx1 = this.c1.getContext("2d");
-    var self = this;
-
-    this.video.addEventListener("play", function() {
-      self.width = self.video.width;
-      self.height = self.video.height;
-      self.timerCallback();
-    }, false);
-  },
-
-  computeFrame: function() {
-    this.ctx1.drawImage(this.video, 0, 0, this.width, this.height);
-    var frame = this.ctx1.getImageData(0, 0, this.width, this.height);
-    var l = frame.data.length / 4;
-
-    for (var i = 0; i < l; i++) {
-      var grey = (frame.data[i * 4 + 0] + frame.data[i * 4 + 1] + frame.data[i * 4 + 2]) / 3;
-
-      frame.data[i * 4 + 0] = grey;
-      frame.data[i * 4 + 1] = grey;
-      frame.data[i * 4 + 2] = grey;
-    }
-    this.ctx1.putImageData(frame, 0, 0);
-
-    return;
-  }
-};
- -

Une fois que la page est chargée, on peut appeler

- -
processor.doLoad()
- -

{{EmbedLiveSample("Vidéo_et_Canvas", '100%', 550)}}

- -
-

Note : En raison de problèmes de sécurité potentiels, si votre vidéo se trouve sur un domaine différent de votre page, vous devez activer CORS (Cross Origin Resource Sharing) sur le serveur qui héberge la vidéo et utiliser l'attribut crossorigin sur la balise vidéo.

-
- -
-

Note : L'exemple présenté est un exemple minimal de manipulation vidéo avec canvas; pour plus d'efficacité, vous pouvez envisager d'utiliser requestAnimationFrame à la place de setTimeout pour les navigateurs qui le prennent en charge.

-
- -

Vidéo e WebGL

- -

WebGL est une API puissante qui utilise canvas pour (typiquement) afficher des scènes en trois dimensions. On peut combiner WebGL et l'élément {{htmlelement("video")}} pour créer des textures vidéo, ce qui veut dire que vous pouvez placer une vidéo dans des scènes 3D.

- -

Exemple:

- -

{{EmbedGHLiveSample('webgl-examples/tutorial/sample8/index.html', 670, 510) }}

- -
-

Note : Vous pouvez trouver le code source de cette démo sur GitHub (la voir en direct aussi).

-
- -

Vitesse de lecture

- -

On peut ajuster la vitesse de lecture de l'audio et vidéo en utilisant l'attribut playbackRate (voir {{domxref("HTMLMediaElement")}}). Il prend pour valeur un nombre qui est le coefficient à appliquer à la vitesse de lecture: par exemple, 0.5 représente la moitié de la vitesse tandis que 2 représente le double.
-
- HTML:

- -
<video id="my-video" controls src="http://jplayer.org/video/m4v/Big_Buck_Bunny_Trailer.m4v"></video>
- -

JavaScript:

- -
var myVideo = document.getElementById('my-video');
-myVideo.playbackRate = 2;
- -

Code jouable

- - - - - -

{{ EmbedLiveSample('Code jouable', 700, 425) }}

- -
-

Note : Essayez l' exemple playbackRate en direct.

-
- -
-

Note : playbackRate marche avec les éléments <audio> et <video>; cependant, dans les deux cas, la vitesse change mais pas la hauteur du son. Pour manipuler la hauteur du son, vous devez utliliser l'API Web Audio — voir la propriété {{domxref("AudioBufferSourceNode.playbackRate")}}.

-
- -

Manipulation Audio

- -

Laissons playbackRate de côté. Pour manipuler l'audio, on utilise typiquement l'API Web Audio.

- -

Sélectionner une source audio

- -

On peut utiliser la piste audio d'un élément {{htmlelement("audio")}} ou {{htmlelement("video")}} comme source pour alimenter l'API Web Audio, ou un simple buffer audio, une onde sinusoïdale/oscillateur, un flux (comme getUserMedia de WebRTC)... Découvrez exactement comment les utiliser en lisant les pages suivantes:

- - - -

Filtres Audio

- -

L'API Web Audio a beaucoup de différents filtres/effets qui peuvent être appliqués à l'audio en utilisant {{domxref("BiquadFilterNode")}}, par exemple:

- -

HTML:

- -
<video id="my-video" controls src="myvideo.mp4" type="video/mp4"></video>
- -

JavaScript:

- -
var context     = new AudioContext(),
-    audioSource = context.createMediaElementSource(document.getElementById("my-video")),
-    filter      = context.createBiquadFilter();
-audioSource.connect(filter);
-filter.connect(context.destination);
-
-// Configure filter
-filter.type = "lowshelf";
-filter.frequency.value = 1000;
-filter.gain.value = 25;
- -

Code jouable 2

- - - - - - -

{{ EmbedLiveSample('Code_jouable_2', 700, 425) }}

- -
-

Note : À moins que CORS ne soit activé, vous devrez pour éviter les problèmes de sécurité placer la vidéo sur le même domaine que votre code.

-
- -

Les filtres pouvant être appliqués sont:

- - - -
-

Note : Voir {{domxref("BiquadFilterNode")}} pour plus d'informations.

-
- -

Convolutions et Impulsions

- -

Il est également possible d'appliquer des réponses impulsionnelles à l'audio en utilisant {{domxref("ConvolverNode")}}. Une réponse impulsionnelle (impulse response en anglais) est un son crée après une brève impulsion sonore (comme un applaudissement) et qui s'applique sur l'environnement qui l'a créée. Exemple: un écho crée en frappant des mains dans un tunnel.

- -

Exemple:

- -
var convolver = context.createConvolver();
-convolver.buffer = this.impulseResponseBuffer;
-// Connect the graph.
-source.connect(convolver);
-convolver.connect(context.destination);
- -
-

Note : Voir ce Codepen pour un exemple appliqué.

-
- -
-

Note : Voir {{domxref("ConvolverNode")}} pour plus d'informations.

-
- -

Audio dans l'espace

- -

On peut également positionner l'audio dans l'espace en utilisant un noeud panoramique (un panner). Ce noeud permet de définir un cône source ainsi que des éléments positionnels et directionnels — le tout dans un espace 3D définit par des coordonnées cartésiennes 3D.  
-
- Exemple:

- -
var panner = context.createPanner();
-panner.coneOuterGain = 0.2;
-panner.coneOuterAngle = 120;
-panner.coneInnerAngle = 0;
-
-panner.connect(context.destination);
-source.connect(panner);
-source.start(0);
-
-// Position the listener at the origin.
-context.listener.setPosition(0, 0, 0);
- -
-

Note : Vous pouvez trouver un exemple sur notre repo GitHub (le voir en direct aussi).

-
- -
-

Note : Voir {{domxref("PannerNode")}} pour plus d'informations.

-
- -

Codecs JavaScript

- -

Il est possible de manipuler l'audio au bas niveau en utilisant JavaScript. Cela peut être utile si vous voulez créer des codecs audio.
-
- Des bibliothèques existent actuellement pour les formats suivants:

- - - -
-

Note : Sur AudioCogs, vous pouvez essayer quelques démos; Audiocogs fournit également un Framework, Aurora.js, qui est destiné à vous aider à créer vos propres codecs en JavaScript.

-
- -

Tutoriels

- - - -

Référence

- - diff --git a/files/fr/web/guide/audio_and_video_manipulation/index.md b/files/fr/web/guide/audio_and_video_manipulation/index.md new file mode 100644 index 0000000000..1b79154eb7 --- /dev/null +++ b/files/fr/web/guide/audio_and_video_manipulation/index.md @@ -0,0 +1,361 @@ +--- +title: Manipulation Audio et Vidéo +slug: Web/Guide/Audio_and_video_manipulation +tags: + - Audio + - Canvas + - HTML5 + - Video + - Web Audio API + - WebGL +translation_of: Web/Guide/Audio_and_video_manipulation +--- +

La beauté du web est qu'on peut combiner différentes technologies pour en créer de nouvelles. Avoir de l'audio et vidéo nativement dans le navigateur nous donne la possibilité d'utiliser ces flux de données avec d'autres technologies comme {{htmlelement("canvas")}}, WebGL ou Web Audio API pour modifier le média — par exemple ajouter des effets de réverbération ou de compression à l'audio, ou encore des filtres noir & blanc/sépia aux vidéos. Cet article fournit une référence pour expliquer ce que vous pouvez faire.

+ +

Manipulation Vidéo

+ +

La possibilité de lire les valeurs de pixels de chaque image d'une vidéo peut être très utile, cela nous permet de placer ces images dans d'autres contextes.

+ +

Vidéo et Canvas

+ +

{{htmlelement("canvas")}} est un moyen de dessiner de manière scripté sur des pages web; c'est un outil très puissant et qui peut être couplé avec du contenu vidéo.

+ +

La technique générale est comme suit:

+ +
    +
  1. Dessiner une image de l'élément {{htmlelement("video")}} sur un élément {{htmlelement("canvas")}} intermédiaire.
    2. +
  2. Lire les données de l'élément <canvas> et les manipuler.
    3. +
  3. Écrire les données manipulées dans le <canvas> que l'on veut afficher.
    4. +
  4. Marquer une pause et répéter.
    5. +
+ +

On peut configurer notre lecteur vidéo et l'élément <canvas> comme ceci:

+ +
<video id="my-video" controls="true" width="480" height="270" crossorigin="anonymous">
+  <source src="http://jplayer.org/video/webm/Big_Buck_Bunny_Trailer.webm" type="video/webm">
+  <source src="http://jplayer.org/video/m4v/Big_Buck_Bunny_Trailer.m4v" type="video/mp4">
+</video>
+
+<canvas id="my-canvas" width="480" height="270"></canvas>
+ +

Et les manipuler comme ceci: (en l'occurence, on affiche une version en noir et blanc de la vidéo)

+ +
var processor = {
+  timerCallback: function() {
+    if (this.video.paused || this.video.ended) {
+      return;
+    }
+    this.computeFrame();
+    var self = this;
+    setTimeout(function () {
+      self.timerCallback();
+    }, 16); // roughly 60 frames per second
+  },
+
+  doLoad: function() {
+    this.video = document.getElementById("my-video");
+    this.c1 = document.getElementById("my-canvas");
+    this.ctx1 = this.c1.getContext("2d");
+    var self = this;
+
+    this.video.addEventListener("play", function() {
+      self.width = self.video.width;
+      self.height = self.video.height;
+      self.timerCallback();
+    }, false);
+  },
+
+  computeFrame: function() {
+    this.ctx1.drawImage(this.video, 0, 0, this.width, this.height);
+    var frame = this.ctx1.getImageData(0, 0, this.width, this.height);
+    var l = frame.data.length / 4;
+
+    for (var i = 0; i < l; i++) {
+      var grey = (frame.data[i * 4 + 0] + frame.data[i * 4 + 1] + frame.data[i * 4 + 2]) / 3;
+
+      frame.data[i * 4 + 0] = grey;
+      frame.data[i * 4 + 1] = grey;
+      frame.data[i * 4 + 2] = grey;
+    }
+    this.ctx1.putImageData(frame, 0, 0);
+
+    return;
+  }
+};
+ +

Une fois que la page est chargée, on peut appeler

+ +
processor.doLoad()
+ +

{{EmbedLiveSample("Vidéo_et_Canvas", '100%', 550)}}

+ +
+

Note : En raison de problèmes de sécurité potentiels, si votre vidéo se trouve sur un domaine différent de votre page, vous devez activer CORS (Cross Origin Resource Sharing) sur le serveur qui héberge la vidéo et utiliser l'attribut crossorigin sur la balise vidéo.

+
+ +
+

Note : L'exemple présenté est un exemple minimal de manipulation vidéo avec canvas; pour plus d'efficacité, vous pouvez envisager d'utiliser requestAnimationFrame à la place de setTimeout pour les navigateurs qui le prennent en charge.

+
+ +

Vidéo e WebGL

+ +

WebGL est une API puissante qui utilise canvas pour (typiquement) afficher des scènes en trois dimensions. On peut combiner WebGL et l'élément {{htmlelement("video")}} pour créer des textures vidéo, ce qui veut dire que vous pouvez placer une vidéo dans des scènes 3D.

+ +

Exemple:

+ +

{{EmbedGHLiveSample('webgl-examples/tutorial/sample8/index.html', 670, 510) }}

+ +
+

Note : Vous pouvez trouver le code source de cette démo sur GitHub (la voir en direct aussi).

+
+ +

Vitesse de lecture

+ +

On peut ajuster la vitesse de lecture de l'audio et vidéo en utilisant l'attribut playbackRate (voir {{domxref("HTMLMediaElement")}}). Il prend pour valeur un nombre qui est le coefficient à appliquer à la vitesse de lecture: par exemple, 0.5 représente la moitié de la vitesse tandis que 2 représente le double.
+
+ HTML:

+ +
<video id="my-video" controls src="http://jplayer.org/video/m4v/Big_Buck_Bunny_Trailer.m4v"></video>
+ +

JavaScript:

+ +
var myVideo = document.getElementById('my-video');
+myVideo.playbackRate = 2;
+ +

Code jouable

+ + + + + +

{{ EmbedLiveSample('Code jouable', 700, 425) }}

+ +
+

Note : Essayez l' exemple playbackRate en direct.

+
+ +
+

Note : playbackRate marche avec les éléments <audio> et <video>; cependant, dans les deux cas, la vitesse change mais pas la hauteur du son. Pour manipuler la hauteur du son, vous devez utliliser l'API Web Audio — voir la propriété {{domxref("AudioBufferSourceNode.playbackRate")}}.

+
+ +

Manipulation Audio

+ +

Laissons playbackRate de côté. Pour manipuler l'audio, on utilise typiquement l'API Web Audio.

+ +

Sélectionner une source audio

+ +

On peut utiliser la piste audio d'un élément {{htmlelement("audio")}} ou {{htmlelement("video")}} comme source pour alimenter l'API Web Audio, ou un simple buffer audio, une onde sinusoïdale/oscillateur, un flux (comme getUserMedia de WebRTC)... Découvrez exactement comment les utiliser en lisant les pages suivantes:

+ + + +

Filtres Audio

+ +

L'API Web Audio a beaucoup de différents filtres/effets qui peuvent être appliqués à l'audio en utilisant {{domxref("BiquadFilterNode")}}, par exemple:

+ +

HTML:

+ +
<video id="my-video" controls src="myvideo.mp4" type="video/mp4"></video>
+ +

JavaScript:

+ +
var context     = new AudioContext(),
+    audioSource = context.createMediaElementSource(document.getElementById("my-video")),
+    filter      = context.createBiquadFilter();
+audioSource.connect(filter);
+filter.connect(context.destination);
+
+// Configure filter
+filter.type = "lowshelf";
+filter.frequency.value = 1000;
+filter.gain.value = 25;
+ +

Code jouable 2

+ + + + + + +

{{ EmbedLiveSample('Code_jouable_2', 700, 425) }}

+ +
+

Note : À moins que CORS ne soit activé, vous devrez pour éviter les problèmes de sécurité placer la vidéo sur le même domaine que votre code.

+
+ +

Les filtres pouvant être appliqués sont:

+ + + +
+

Note : Voir {{domxref("BiquadFilterNode")}} pour plus d'informations.

+
+ +

Convolutions et Impulsions

+ +

Il est également possible d'appliquer des réponses impulsionnelles à l'audio en utilisant {{domxref("ConvolverNode")}}. Une réponse impulsionnelle (impulse response en anglais) est un son crée après une brève impulsion sonore (comme un applaudissement) et qui s'applique sur l'environnement qui l'a créée. Exemple: un écho crée en frappant des mains dans un tunnel.

+ +

Exemple:

+ +
var convolver = context.createConvolver();
+convolver.buffer = this.impulseResponseBuffer;
+// Connect the graph.
+source.connect(convolver);
+convolver.connect(context.destination);
+ +
+

Note : Voir ce Codepen pour un exemple appliqué.

+
+ +
+

Note : Voir {{domxref("ConvolverNode")}} pour plus d'informations.

+
+ +

Audio dans l'espace

+ +

On peut également positionner l'audio dans l'espace en utilisant un noeud panoramique (un panner). Ce noeud permet de définir un cône source ainsi que des éléments positionnels et directionnels — le tout dans un espace 3D définit par des coordonnées cartésiennes 3D.  
+
+ Exemple:

+ +
var panner = context.createPanner();
+panner.coneOuterGain = 0.2;
+panner.coneOuterAngle = 120;
+panner.coneInnerAngle = 0;
+
+panner.connect(context.destination);
+source.connect(panner);
+source.start(0);
+
+// Position the listener at the origin.
+context.listener.setPosition(0, 0, 0);
+ +
+

Note : Vous pouvez trouver un exemple sur notre repo GitHub (le voir en direct aussi).

+
+ +
+

Note : Voir {{domxref("PannerNode")}} pour plus d'informations.

+
+ +

Codecs JavaScript

+ +

Il est possible de manipuler l'audio au bas niveau en utilisant JavaScript. Cela peut être utile si vous voulez créer des codecs audio.
+
+ Des bibliothèques existent actuellement pour les formats suivants:

+ + + +
+

Note : Sur AudioCogs, vous pouvez essayer quelques démos; Audiocogs fournit également un Framework, Aurora.js, qui est destiné à vous aider à créer vos propres codecs en JavaScript.

+
+ +

Tutoriels

+ + + +

Référence

+ + diff --git a/files/fr/web/guide/css/block_formatting_context/index.html b/files/fr/web/guide/css/block_formatting_context/index.html deleted file mode 100644 index bb9ee501f2..0000000000 --- a/files/fr/web/guide/css/block_formatting_context/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Contexte de formatage de blocs -slug: Web/Guide/CSS/Block_formatting_context -tags: - - CSS - - Reference - - Web -translation_of: Web/Guide/CSS/Block_formatting_context -original_slug: Web/CSS/Block_formatting_context ---- -
{{CSSRef}}
- -

Un contexte de formatage de blocs (block formatting context) est une partie du rendu visuel par le CSS, d'une page web. C'est la région qui délimite la mise en page des blocs et dans laquelle les éléments flottant interagissent les uns avec les autres.

- -

Un contexte de formatage de blocs est créé dans les situations suivantes :

- - - -

Un contexte de formatage de blocs contient tout ce qui se trouve dans l'élément qui l'a créé, et qui ne se trouve pas aussi dans un élément descendant définissant un nouveau contexte de formatage de blocs.

- -

Les contextes de formatage de blocs sont important pour le positionnement (voir {{cssxref("float")}} et {{cssxref("clear")}}). Les règles de positionnement et de "libération" des blocs flottants (par {{cssxref("clear")}}) s'appliquent seulement aux éléments au sein d'un même contexte de formatage de blocs. Les blocs flottants n'influent pas sur le positionnement des éléments se trouvant dans d'autres contextes de formatage de blocs, et {{cssxref("clear")}} ne libère que des blocs flottants dans le même contexte de formatage de blocs.

- -

Spécifications

- - - -

Voir aussi

- - diff --git a/files/fr/web/guide/css/block_formatting_context/index.md b/files/fr/web/guide/css/block_formatting_context/index.md new file mode 100644 index 0000000000..bb9ee501f2 --- /dev/null +++ b/files/fr/web/guide/css/block_formatting_context/index.md @@ -0,0 +1,45 @@ +--- +title: Contexte de formatage de blocs +slug: Web/Guide/CSS/Block_formatting_context +tags: + - CSS + - Reference + - Web +translation_of: Web/Guide/CSS/Block_formatting_context +original_slug: Web/CSS/Block_formatting_context +--- +
{{CSSRef}}
+ +

Un contexte de formatage de blocs (block formatting context) est une partie du rendu visuel par le CSS, d'une page web. C'est la région qui délimite la mise en page des blocs et dans laquelle les éléments flottant interagissent les uns avec les autres.

+ +

Un contexte de formatage de blocs est créé dans les situations suivantes :

+ + + +

Un contexte de formatage de blocs contient tout ce qui se trouve dans l'élément qui l'a créé, et qui ne se trouve pas aussi dans un élément descendant définissant un nouveau contexte de formatage de blocs.

+ +

Les contextes de formatage de blocs sont important pour le positionnement (voir {{cssxref("float")}} et {{cssxref("clear")}}). Les règles de positionnement et de "libération" des blocs flottants (par {{cssxref("clear")}}) s'appliquent seulement aux éléments au sein d'un même contexte de formatage de blocs. Les blocs flottants n'influent pas sur le positionnement des éléments se trouvant dans d'autres contextes de formatage de blocs, et {{cssxref("clear")}} ne libère que des blocs flottants dans le même contexte de formatage de blocs.

+ +

Spécifications

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/guide/graphics/index.html b/files/fr/web/guide/graphics/index.html deleted file mode 100644 index 2f2c7abad4..0000000000 --- a/files/fr/web/guide/graphics/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Graphismes sur le Web -slug: Web/Guide/Graphics -tags: - - 2D - - 3D - - Canvas - - Graphismes - - HTML - - SVG - - Web - - WebGL - - WebRTC -translation_of: Web/Guide/Graphics ---- -

Les applications et sites Web modernes ont souvent besoin de présenter des graphismes de qualité. Tandis qu'afficher de simples images statiques peut être aisément réalisé à l'aide de la balise <img>, ou en réglant l'arrière-plan des éléments HTML avec la propriété CSS : background-image.

- -

Mais lorsque l'on veut réaliser des graphismes à la volée, ou manipuler des images après coup, ou encore utiliser de la 3D, les méthodes habituelles ne suffisent plus, cependant avec HTML5, il est possible de réaliser ce type de graphismes plus évolués.

- -

Les articles ci-dessous vous permettront de vous familiariser avec ces technologies.

- -

Graphismes 2D

- -
-
Dessiner avec les canvas
-
Un guide d'introduction pour utiliser l'élément pour dessiner en 2D.
-
SVG
-
Scalable Vector Graphics (SVG) vous permet d'utiliser des lignes, courbes et  d'autres figures géométriques pour dessiner. Les images SVG n'étant pas des images matricielles, elles permettent de faire des images redimensionnables sans limite. -
-
- -

Graphismes 3D

- -
-
WebGL
-
Un guide pour débuter avec WebGL l'API  graphique 3D, pour le Web. Cette technologie vous permettra d'utiliser le standard OpenGL ES pour du contenu Web.
-
- -

Video

- -
-
Utiliser les éléments HTML5 audio et video
-
Intégrer de la vidéo et / ou de l'audio dans une page Web
-
WebRTC
-
Le RTC dans WebRTC est l'abréviation de Real-Time Communications, c'est une technologie qui permet le streaming audio / vidéo et le partage de données entre les clients du navigateur (homologues).
-
diff --git a/files/fr/web/guide/graphics/index.md b/files/fr/web/guide/graphics/index.md new file mode 100644 index 0000000000..2f2c7abad4 --- /dev/null +++ b/files/fr/web/guide/graphics/index.md @@ -0,0 +1,46 @@ +--- +title: Graphismes sur le Web +slug: Web/Guide/Graphics +tags: + - 2D + - 3D + - Canvas + - Graphismes + - HTML + - SVG + - Web + - WebGL + - WebRTC +translation_of: Web/Guide/Graphics +--- +

Les applications et sites Web modernes ont souvent besoin de présenter des graphismes de qualité. Tandis qu'afficher de simples images statiques peut être aisément réalisé à l'aide de la balise <img>, ou en réglant l'arrière-plan des éléments HTML avec la propriété CSS : background-image.

+ +

Mais lorsque l'on veut réaliser des graphismes à la volée, ou manipuler des images après coup, ou encore utiliser de la 3D, les méthodes habituelles ne suffisent plus, cependant avec HTML5, il est possible de réaliser ce type de graphismes plus évolués.

+ +

Les articles ci-dessous vous permettront de vous familiariser avec ces technologies.

+ +

Graphismes 2D

+ +
+
Dessiner avec les canvas
+
Un guide d'introduction pour utiliser l'élément pour dessiner en 2D.
+
SVG
+
Scalable Vector Graphics (SVG) vous permet d'utiliser des lignes, courbes et  d'autres figures géométriques pour dessiner. Les images SVG n'étant pas des images matricielles, elles permettent de faire des images redimensionnables sans limite. +
+
+ +

Graphismes 3D

+ +
+
WebGL
+
Un guide pour débuter avec WebGL l'API  graphique 3D, pour le Web. Cette technologie vous permettra d'utiliser le standard OpenGL ES pour du contenu Web.
+
+ +

Video

+ +
+
Utiliser les éléments HTML5 audio et video
+
Intégrer de la vidéo et / ou de l'audio dans une page Web
+
WebRTC
+
Le RTC dans WebRTC est l'abréviation de Real-Time Communications, c'est une technologie qui permet le streaming audio / vidéo et le partage de données entre les clients du navigateur (homologues).
+
diff --git a/files/fr/web/guide/html/content_categories/index.html b/files/fr/web/guide/html/content_categories/index.html deleted file mode 100644 index 34db97e760..0000000000 --- a/files/fr/web/guide/html/content_categories/index.html +++ /dev/null @@ -1,176 +0,0 @@ ---- -title: Catégories de contenu -slug: Web/Guide/HTML/Content_categories -tags: - - Avancé - - Contenus - - Guide - - HTML -translation_of: Web/Guide/HTML/Content_categories -original_slug: Web/Guide/HTML/Catégories_de_contenu ---- -

Chaque élément HTML est membre d'un certain nombre de catégories de contenu qui regroupent des éléments partageant un ensemble de caractéristiques. Ceci est un regroupement lâche, en ce sens qu'il ne crée pas réellement de relation entre les éléments de ces types, mais il aide à définir et à décrire leur comportement et les règles associées qu'ils doivent respecter, en particulier lorsque l'on entre dans leurs détails complexes. Il est également possible que les éléments ne soient membres d'aucune de ces catégories.

- -

Il y a trois types différents de catégories de contenu :

- - - -
-

Note : un discours plus détaillé sur ces catégories de contenu et de leurs fonctionnalités comparatives dépasse le cadre de cet article ; pour en savoir plus, vous pouvez lire les parties correspondantes de la spécification HTML (en).

-
- -
- -

Principales catégories de contenu

- -

Contenu de méta-données

- -

Les éléments appartenant à cette catégorie modifient la présentation ou le comportement du reste du document, insèrent des liens vers d'autres documents ou comportent des informations sur la structure même des données.

- -

Les éléments appartenant à cette catégories sont : {{HTMLElement("base")}}, {{HTMLElement("command")}}{{ Obsolete_inline()}} , {{HTMLElement("link")}}, {{HTMLElement("meta")}}, {{HTMLElement("noscript")}}, {{HTMLElement("script")}}, {{HTMLElement("style")}} et {{HTMLElement("title")}}.

- -

Contenu de flux

- -

Les éléments appartenant à la catégorie de contenu de flux contiennent généralement du texte ou du contenu intégré. Ces éléments sont : {{HTMLElement("a")}}, {{HTMLElement("abbr")}}, {{HTMLElement("address")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("audio")}}, {{HTMLElement("b")}},{{HTMLElement("bdo")}}, {{HTMLElement("bdi")}}, {{HTMLElement("blockquote")}}, {{HTMLElement("br")}}, {{HTMLElement("button")}}, {{HTMLElement("canvas")}}, {{HTMLElement("cite")}}, {{HTMLElement("code")}}, {{ Obsolete_inline() }}{{HTMLElement("command")}}, {{HTMLElement("data")}}, {{HTMLElement("datalist")}}, {{HTMLElement("del")}}, {{HTMLElement("details")}}, {{HTMLElement("dfn")}}, {{HTMLElement("div")}}, {{HTMLElement("dl")}}, {{HTMLElement("em")}}, {{HTMLElement("embed")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("figure")}}, {{HTMLElement("footer")}}, {{HTMLElement("form")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}, {{HTMLElement("header")}}, {{HTMLElement("hgroup")}}, {{HTMLElement("hr")}}, {{HTMLElement("i")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("ins")}}, {{HTMLElement("kbd")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("label")}}, {{HTMLElement("main")}}, {{HTMLElement("map")}}, {{HTMLElement("mark")}}, {{MathMLElement("math")}}, {{HTMLElement("menu")}}, {{HTMLElement("meter")}}, {{HTMLElement("nav")}}, {{HTMLElement("noscript")}}, {{HTMLElement("object")}}, {{HTMLElement("ol")}}, {{HTMLElement("output")}}, {{HTMLElement("p")}}, {{HTMLElement("picture")}}, {{HTMLElement("pre")}}, {{HTMLElement("progress")}}, {{HTMLElement("q")}}, {{HTMLElement("ruby")}}, {{HTMLElement("s")}}, {{HTMLElement("samp")}}, {{HTMLElement("script")}}, {{HTMLElement("section")}}, {{HTMLElement("select")}}, {{HTMLElement("small")}}, {{HTMLElement("span")}}, {{HTMLElement("strong")}}, {{HTMLElement("sub")}}, {{HTMLElement("sup")}}, {{SVGElement("svg")}}, {{HTMLElement("table")}}, {{HTMLElement("template")}}, {{HTMLElement("textarea")}}, {{HTMLElement("time")}}, {{HTMLElement("ul")}}, {{HTMLElement("var")}}, {{HTMLElement("video")}}, {{HTMLElement("wbr")}} et le texte.

- -

Quelques autres éléments appartiennent à cette catégorie mais seulement sous certaines conditions :

- - - -

Contenu sectionnant

- -

Les éléments appartenant à cette catégorie sont ceux créant une nouvelle section dans le plan du document qui définit la portée des éléments {{HTMLElement("header")}}, des éléments {{HTMLElement("footer")}} et du contenu de titre.

- -

Les éléments appartenant à cette catégorie sont les éléments {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("nav")}} et {{HTMLElement("section")}}. 

- -
-

Note : Il ne faut pas confondre ce modèle de contenu avec la catégorie de racine de sectionnement qui isole un contenu par rapport à la structure (ou plan) principale.

-
- -

Contenu de titre

- -

Le contenu de titre définit le titre d'une section, qu'elle soit marquée par un contenu sectionnant de manière explicite ou qu'elle soit définie de manière implicite par le contenu de titre lui-même.

- -

Les éléments appartenant à cette catégorie sont {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}} et {{HTMLElement("hgroup")}}.

- -
-

Note : Bien qu'il soit probable qu'un élément {{HTMLElement("header")}} comporte du contenu de titre, il n'est pas lui-même un contenu de titre.

-
- -
-

Note : {{HTMLElement("hgroup")}} est supprimé du document recommandé par W3C.

-
- -

Contenu phrasé

- -

Le contenu phrasé définit le texte et le balisage qu'il contient. Des séquences de contenu phrasé constituent des paragraphes.

- -

Les éléments appartenant à cette catégorie sont  {{HTMLElement("abbr")}}, {{HTMLElement("audio")}}, {{HTMLElement("b")}}, {{HTMLElement("bdo")}}, {{HTMLElement("br")}}, {{HTMLElement("button")}}, {{HTMLElement("canvas")}}, {{HTMLElement("cite")}}, {{HTMLElement("code")}}, {{ Obsolete_inline() }}{{HTMLElement("command")}}, {{HTMLElement("data")}}, {{HTMLElement("datalist")}}, {{HTMLElement("dfn")}}, {{HTMLElement("em")}}, {{HTMLElement("embed")}}, {{HTMLElement("i")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("kbd")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("label")}}, {{HTMLElement("mark")}}, {{MathMLElement("math")}}, {{HTMLElement("meter")}}, {{HTMLElement("noscript")}}, {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("picture")}}, {{HTMLElement("progress")}}, {{HTMLElement("q")}}, {{HTMLElement("ruby")}}, {{HTMLElement("samp")}}, {{HTMLElement("script")}}, {{HTMLElement("select")}}, {{HTMLElement("small")}}, {{HTMLElement("span")}}, {{HTMLElement("strong")}}, {{HTMLElement("sub")}}, {{HTMLElement("sup")}}, {{SVGElement("svg")}}, {{HTMLElement("textarea")}}, {{HTMLElement("time")}}, {{HTMLElement("var")}}, {{HTMLElement("video")}}, {{HTMLElement("wbr")}} et du texte brut (n'étant pas une simple suite de blancs).

- -

Quelques autres éléments appartiennent à cette catégorie mais seulement selon certaines conditions :

- - - -

Contenu intégré

- -

Le contenu intégré importe une autre ressource ou intègre du contenu provenant d'un autre langage de balisage ou d'un autre espace de noms dans le document. Les éléments appartenant à cette catégorie sont : {{HTMLElement("audio")}}, {{HTMLElement("canvas")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{MathMLElement("math")}}, {{HTMLElement("object")}}, {{HTMLElement("svg")}}, {{HTMLElement("video")}}.

- -

Contenu interactif

- -

Le contenu interactif regroupe des éléments spécialement conçus pour une interaction avec l'utilisateur. Les éléments appartenant à cette catégories sont : {{HTMLElement("a")}}, {{HTMLElement("button")}}, {{HTMLElement("details")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("label")}}, {{HTMLElement("select")}}, et {{HTMLElement("textarea")}}.

- -

Quelques éléments appartiennent à cette catégorie seulement sous certaines conditions :

- - - -

Contenu tangible

- -

Un contenu peut être dit tangible lorsqu'il n'est ni vide ni caché. Les éléments dont le modèle de contenu est de flux ou phrasé devraient toujours avoir au moins un noeud dont le contenu est tangible.

- -

Contenu associé aux formulaires

- -

Le contenu associé aux formulaires contient les éléments possédés par un formulaire, exposé avec un attribut form. Être possédé par un formulaire signifie être descendant d'un élément  {{HTMLElement("form")}} ou de l'élément dont l'identifiant est référencé par la valeur de l'attribut form.

- -

Cette catégorie contient les éléments :

- - - -

 Cette catégorie peut être subdivisée en plusieurs sous-catégories.

- -
-
listed (éléments listés)
-
Les éléments étant listés sont les ensembles IDL form.elements et fieldset.elements. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("select")}}, et {{HTMLElement("textarea")}}.
-
labelable (éléments étiquetables)
-
Les éléments pouvant être associés avec des éléments  {{HTMLElement("label")}}. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("meter")}}, {{HTMLElement("output")}}, {{HTMLElement("progress")}}, {{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
-
submittable (éléments participants à l'envoi du formulaire)
-
Les éléments pouvant être utilisés pour construire les données du formulaires quand celui-ci est envoyé. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("object")}}, {{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
-
resettable (éléments de ré-initialisation)
-
Éléments pouvant être impactés lorsqu'un formulaire est ré-initialisé. Ce sont : {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("output")}},{{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
-
- -

Catégories secondaires

- -

Il existe des classifications secondaires d'éléments qu'il peut être utile de connaître également.

- -

Éléments supports de script

- -

Les éléments supports de script sont des éléments qui ne contribuent pas directement à la sortie rendue d'un document. Au lieu de cela, ils servent à prendre en charge les scripts, soit en contenant ou en spécifiant le code de script directement, soit en spécifiant les données qui seront utilisées par les scripts. Ce sont :

- - - -

Modèle de contenu transparent

- -

Si l'élément possède un modèle de contenu transparent, son contenu doit alors être structuré comme du HTML5 valide, et ce, même si l'élément transparent a été enlevé et remplacé par ses éléments fils.

- -

Les éléments {{HTMLElement("del")}} et {{HTMLELement("ins")}} sont des exemples d'éléments transparents.

- -
<p>Bonjour <del><em>tout</em></del> <ins>le monde</ins>.</p>
-
- -

Si ces éléments étaient retirés, ce fragment de code HTML serait toujours du HTML valide.

- -
<p>Bonjour <em>tout</em> le monde.</p>
-
- -

Autres modèles de contenu

- -

Racine de sectionnement.

diff --git a/files/fr/web/guide/html/content_categories/index.md b/files/fr/web/guide/html/content_categories/index.md new file mode 100644 index 0000000000..34db97e760 --- /dev/null +++ b/files/fr/web/guide/html/content_categories/index.md @@ -0,0 +1,176 @@ +--- +title: Catégories de contenu +slug: Web/Guide/HTML/Content_categories +tags: + - Avancé + - Contenus + - Guide + - HTML +translation_of: Web/Guide/HTML/Content_categories +original_slug: Web/Guide/HTML/Catégories_de_contenu +--- +

Chaque élément HTML est membre d'un certain nombre de catégories de contenu qui regroupent des éléments partageant un ensemble de caractéristiques. Ceci est un regroupement lâche, en ce sens qu'il ne crée pas réellement de relation entre les éléments de ces types, mais il aide à définir et à décrire leur comportement et les règles associées qu'ils doivent respecter, en particulier lorsque l'on entre dans leurs détails complexes. Il est également possible que les éléments ne soient membres d'aucune de ces catégories.

+ +

Il y a trois types différents de catégories de contenu :

+ + + +
+

Note : un discours plus détaillé sur ces catégories de contenu et de leurs fonctionnalités comparatives dépasse le cadre de cet article ; pour en savoir plus, vous pouvez lire les parties correspondantes de la spécification HTML (en).

+
+ +
+ +

Principales catégories de contenu

+ +

Contenu de méta-données

+ +

Les éléments appartenant à cette catégorie modifient la présentation ou le comportement du reste du document, insèrent des liens vers d'autres documents ou comportent des informations sur la structure même des données.

+ +

Les éléments appartenant à cette catégories sont : {{HTMLElement("base")}}, {{HTMLElement("command")}}{{ Obsolete_inline()}} , {{HTMLElement("link")}}, {{HTMLElement("meta")}}, {{HTMLElement("noscript")}}, {{HTMLElement("script")}}, {{HTMLElement("style")}} et {{HTMLElement("title")}}.

+ +

Contenu de flux

+ +

Les éléments appartenant à la catégorie de contenu de flux contiennent généralement du texte ou du contenu intégré. Ces éléments sont : {{HTMLElement("a")}}, {{HTMLElement("abbr")}}, {{HTMLElement("address")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("audio")}}, {{HTMLElement("b")}},{{HTMLElement("bdo")}}, {{HTMLElement("bdi")}}, {{HTMLElement("blockquote")}}, {{HTMLElement("br")}}, {{HTMLElement("button")}}, {{HTMLElement("canvas")}}, {{HTMLElement("cite")}}, {{HTMLElement("code")}}, {{ Obsolete_inline() }}{{HTMLElement("command")}}, {{HTMLElement("data")}}, {{HTMLElement("datalist")}}, {{HTMLElement("del")}}, {{HTMLElement("details")}}, {{HTMLElement("dfn")}}, {{HTMLElement("div")}}, {{HTMLElement("dl")}}, {{HTMLElement("em")}}, {{HTMLElement("embed")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("figure")}}, {{HTMLElement("footer")}}, {{HTMLElement("form")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}, {{HTMLElement("header")}}, {{HTMLElement("hgroup")}}, {{HTMLElement("hr")}}, {{HTMLElement("i")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("ins")}}, {{HTMLElement("kbd")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("label")}}, {{HTMLElement("main")}}, {{HTMLElement("map")}}, {{HTMLElement("mark")}}, {{MathMLElement("math")}}, {{HTMLElement("menu")}}, {{HTMLElement("meter")}}, {{HTMLElement("nav")}}, {{HTMLElement("noscript")}}, {{HTMLElement("object")}}, {{HTMLElement("ol")}}, {{HTMLElement("output")}}, {{HTMLElement("p")}}, {{HTMLElement("picture")}}, {{HTMLElement("pre")}}, {{HTMLElement("progress")}}, {{HTMLElement("q")}}, {{HTMLElement("ruby")}}, {{HTMLElement("s")}}, {{HTMLElement("samp")}}, {{HTMLElement("script")}}, {{HTMLElement("section")}}, {{HTMLElement("select")}}, {{HTMLElement("small")}}, {{HTMLElement("span")}}, {{HTMLElement("strong")}}, {{HTMLElement("sub")}}, {{HTMLElement("sup")}}, {{SVGElement("svg")}}, {{HTMLElement("table")}}, {{HTMLElement("template")}}, {{HTMLElement("textarea")}}, {{HTMLElement("time")}}, {{HTMLElement("ul")}}, {{HTMLElement("var")}}, {{HTMLElement("video")}}, {{HTMLElement("wbr")}} et le texte.

+ +

Quelques autres éléments appartiennent à cette catégorie mais seulement sous certaines conditions :

+ + + +

Contenu sectionnant

+ +

Les éléments appartenant à cette catégorie sont ceux créant une nouvelle section dans le plan du document qui définit la portée des éléments {{HTMLElement("header")}}, des éléments {{HTMLElement("footer")}} et du contenu de titre.

+ +

Les éléments appartenant à cette catégorie sont les éléments {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("nav")}} et {{HTMLElement("section")}}. 

+ +
+

Note : Il ne faut pas confondre ce modèle de contenu avec la catégorie de racine de sectionnement qui isole un contenu par rapport à la structure (ou plan) principale.

+
+ +

Contenu de titre

+ +

Le contenu de titre définit le titre d'une section, qu'elle soit marquée par un contenu sectionnant de manière explicite ou qu'elle soit définie de manière implicite par le contenu de titre lui-même.

+ +

Les éléments appartenant à cette catégorie sont {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}} et {{HTMLElement("hgroup")}}.

+ +
+

Note : Bien qu'il soit probable qu'un élément {{HTMLElement("header")}} comporte du contenu de titre, il n'est pas lui-même un contenu de titre.

+
+ +
+

Note : {{HTMLElement("hgroup")}} est supprimé du document recommandé par W3C.

+
+ +

Contenu phrasé

+ +

Le contenu phrasé définit le texte et le balisage qu'il contient. Des séquences de contenu phrasé constituent des paragraphes.

+ +

Les éléments appartenant à cette catégorie sont  {{HTMLElement("abbr")}}, {{HTMLElement("audio")}}, {{HTMLElement("b")}}, {{HTMLElement("bdo")}}, {{HTMLElement("br")}}, {{HTMLElement("button")}}, {{HTMLElement("canvas")}}, {{HTMLElement("cite")}}, {{HTMLElement("code")}}, {{ Obsolete_inline() }}{{HTMLElement("command")}}, {{HTMLElement("data")}}, {{HTMLElement("datalist")}}, {{HTMLElement("dfn")}}, {{HTMLElement("em")}}, {{HTMLElement("embed")}}, {{HTMLElement("i")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("kbd")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("label")}}, {{HTMLElement("mark")}}, {{MathMLElement("math")}}, {{HTMLElement("meter")}}, {{HTMLElement("noscript")}}, {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("picture")}}, {{HTMLElement("progress")}}, {{HTMLElement("q")}}, {{HTMLElement("ruby")}}, {{HTMLElement("samp")}}, {{HTMLElement("script")}}, {{HTMLElement("select")}}, {{HTMLElement("small")}}, {{HTMLElement("span")}}, {{HTMLElement("strong")}}, {{HTMLElement("sub")}}, {{HTMLElement("sup")}}, {{SVGElement("svg")}}, {{HTMLElement("textarea")}}, {{HTMLElement("time")}}, {{HTMLElement("var")}}, {{HTMLElement("video")}}, {{HTMLElement("wbr")}} et du texte brut (n'étant pas une simple suite de blancs).

+ +

Quelques autres éléments appartiennent à cette catégorie mais seulement selon certaines conditions :

+ + + +

Contenu intégré

+ +

Le contenu intégré importe une autre ressource ou intègre du contenu provenant d'un autre langage de balisage ou d'un autre espace de noms dans le document. Les éléments appartenant à cette catégorie sont : {{HTMLElement("audio")}}, {{HTMLElement("canvas")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{MathMLElement("math")}}, {{HTMLElement("object")}}, {{HTMLElement("svg")}}, {{HTMLElement("video")}}.

+ +

Contenu interactif

+ +

Le contenu interactif regroupe des éléments spécialement conçus pour une interaction avec l'utilisateur. Les éléments appartenant à cette catégories sont : {{HTMLElement("a")}}, {{HTMLElement("button")}}, {{HTMLElement("details")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("label")}}, {{HTMLElement("select")}}, et {{HTMLElement("textarea")}}.

+ +

Quelques éléments appartiennent à cette catégorie seulement sous certaines conditions :

+ + + +

Contenu tangible

+ +

Un contenu peut être dit tangible lorsqu'il n'est ni vide ni caché. Les éléments dont le modèle de contenu est de flux ou phrasé devraient toujours avoir au moins un noeud dont le contenu est tangible.

+ +

Contenu associé aux formulaires

+ +

Le contenu associé aux formulaires contient les éléments possédés par un formulaire, exposé avec un attribut form. Être possédé par un formulaire signifie être descendant d'un élément  {{HTMLElement("form")}} ou de l'élément dont l'identifiant est référencé par la valeur de l'attribut form.

+ +

Cette catégorie contient les éléments :

+ + + +

 Cette catégorie peut être subdivisée en plusieurs sous-catégories.

+ +
+
listed (éléments listés)
+
Les éléments étant listés sont les ensembles IDL form.elements et fieldset.elements. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("select")}}, et {{HTMLElement("textarea")}}.
+
labelable (éléments étiquetables)
+
Les éléments pouvant être associés avec des éléments  {{HTMLElement("label")}}. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("meter")}}, {{HTMLElement("output")}}, {{HTMLElement("progress")}}, {{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
+
submittable (éléments participants à l'envoi du formulaire)
+
Les éléments pouvant être utilisés pour construire les données du formulaires quand celui-ci est envoyé. Ce sont : {{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}} , {{HTMLElement("object")}}, {{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
+
resettable (éléments de ré-initialisation)
+
Éléments pouvant être impactés lorsqu'un formulaire est ré-initialisé. Ce sont : {{HTMLElement("input")}}, {{HTMLElement("keygen")}}{{deprecated_inline()}}, {{HTMLElement("output")}},{{HTMLElement("select")}} et {{HTMLElement("textarea")}}.
+
+ +

Catégories secondaires

+ +

Il existe des classifications secondaires d'éléments qu'il peut être utile de connaître également.

+ +

Éléments supports de script

+ +

Les éléments supports de script sont des éléments qui ne contribuent pas directement à la sortie rendue d'un document. Au lieu de cela, ils servent à prendre en charge les scripts, soit en contenant ou en spécifiant le code de script directement, soit en spécifiant les données qui seront utilisées par les scripts. Ce sont :

+ + + +

Modèle de contenu transparent

+ +

Si l'élément possède un modèle de contenu transparent, son contenu doit alors être structuré comme du HTML5 valide, et ce, même si l'élément transparent a été enlevé et remplacé par ses éléments fils.

+ +

Les éléments {{HTMLElement("del")}} et {{HTMLELement("ins")}} sont des exemples d'éléments transparents.

+ +
<p>Bonjour <del><em>tout</em></del> <ins>le monde</ins>.</p>
+
+ +

Si ces éléments étaient retirés, ce fragment de code HTML serait toujours du HTML valide.

+ +
<p>Bonjour <em>tout</em> le monde.</p>
+
+ +

Autres modèles de contenu

+ +

Racine de sectionnement.

diff --git a/files/fr/web/guide/html/editable_content/index.html b/files/fr/web/guide/html/editable_content/index.html deleted file mode 100644 index b5295b8c40..0000000000 --- a/files/fr/web/guide/html/editable_content/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Contenu éditable -slug: Web/Guide/HTML/Editable_content -translation_of: Web/Guide/HTML/Editable_content -original_slug: Web/HTML/Contenu_editable ---- -

Introduction

-

Chaque élément du HTML5 peut être éditable. Cette fonctionnalité a été introduite longtemps auparavant mais a maintenant été standarisée avec WHATWG (voir la spécification HTML actuelle). Avec des gestionnaires d'événements JavaScript, vous pouvez transformer votre page Web en un éditeur de texte, complet et rapide.

-

Compatibilité

-

Le contenu éditable est entièrement compatible avec les navigateurs actuels :

- -

Ce n'est pas encore supporté par Opera Mini et Opera Mobile.

-

Comment ça marche ?

-

Fixez l'attribut contenteditable à true dans votre élément HTML. Ça peut être fait dans quasiment tous les éléments HTML.

-

Exemples

-

Un exemple simple :

-
<!DOCTYPE html>
-<html>
-  <body>
-    <div contenteditable="true">
-      Ce texte peut être édité par l'utilisateur.
-    </div>
-  </body>
-</html>
-

Vous pouvez observer un exemple concret intégrant JavaScript utilisant LocalStorage ici. Le code source est disponible ici.

-

Voir aussi

-

Comment interagir avec le contenu (style proche de l'ancienne API Internet Explorer) ou encore ici.

-
- {{ languages({ "ja": "ja/HTML/Content_Editable", "zh-cn": "zh-cn/HTML/Content_Editable" }) }}
diff --git a/files/fr/web/guide/html/editable_content/index.md b/files/fr/web/guide/html/editable_content/index.md new file mode 100644 index 0000000000..b5295b8c40 --- /dev/null +++ b/files/fr/web/guide/html/editable_content/index.md @@ -0,0 +1,37 @@ +--- +title: Contenu éditable +slug: Web/Guide/HTML/Editable_content +translation_of: Web/Guide/HTML/Editable_content +original_slug: Web/HTML/Contenu_editable +--- +

Introduction

+

Chaque élément du HTML5 peut être éditable. Cette fonctionnalité a été introduite longtemps auparavant mais a maintenant été standarisée avec WHATWG (voir la spécification HTML actuelle). Avec des gestionnaires d'événements JavaScript, vous pouvez transformer votre page Web en un éditeur de texte, complet et rapide.

+

Compatibilité

+

Le contenu éditable est entièrement compatible avec les navigateurs actuels :

+ +

Ce n'est pas encore supporté par Opera Mini et Opera Mobile.

+

Comment ça marche ?

+

Fixez l'attribut contenteditable à true dans votre élément HTML. Ça peut être fait dans quasiment tous les éléments HTML.

+

Exemples

+

Un exemple simple :

+
<!DOCTYPE html>
+<html>
+  <body>
+    <div contenteditable="true">
+      Ce texte peut être édité par l'utilisateur.
+    </div>
+  </body>
+</html>
+

Vous pouvez observer un exemple concret intégrant JavaScript utilisant LocalStorage ici. Le code source est disponible ici.

+

Voir aussi

+

Comment interagir avec le contenu (style proche de l'ancienne API Internet Explorer) ou encore ici.

+
+ {{ languages({ "ja": "ja/HTML/Content_Editable", "zh-cn": "zh-cn/HTML/Content_Editable" }) }}
diff --git a/files/fr/web/guide/index.html b/files/fr/web/guide/index.html deleted file mode 100644 index c649cfd67e..0000000000 --- a/files/fr/web/guide/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Guides pour les développeurs du Web -slug: Web/Guide -tags: - - Guide - - Landing - - Web -translation_of: Web/Guide ---- -

Ces articles sont des tutoriels et guides pratiques permettant d'utiliser certaines API et technologies web.

- - -
-
Apprendre - HTML
-
HyperText Markup Language (HTML) est le langage de base pour la grande partie du contenu web. La plupart de ce que vous voyez à l'écran est décrit en HTML.
-
Apprendre - CSS
-
Cascading Style Sheets (CSS) est un langage de feuille de styles utilisé afin de définir la présentation d'un document écrit en HTML.
-
Fournir de l'audio et/ou de la vidéo
-
Il est possible d'intégrer de l'audio et de la vidéo à du contenu web de différentes façons : que ce soit des fichiers statiques ou des flux adaptatifs. Cet article est une introduction à ces différentes méthodes et à la compatibilité pour les principaux navigateurs web.
-
Manipuler des données audio ou vidéo
-
Il est possible de combiner les technologies web et les médias afin de créer de nouveaux usages. Dans cet article, nous verrons comment utiliser des technologies web telles que {{htmlelement("canvas")}}, WebGL ou l'API Web Audio afin de modifier les fichiers audio ou vidéo directement (en ajoutant des effets de réverbération ou des filtres de couleurs).
-
Guide sur les évènements
-
Les évènements peuvent désigner deux concepts : un patron de conception permettant de gérer de façon asynchrone ce qui se produit lors de la vue d'une page web d'une part et la liste, les noms et les caractéristiques desdits évènements d'autre part.
-
AJAX
-
AJAX est un terme regroupant différentes technologies qui permettent aux applications web d'appliquer des mises à jour incrémentales au contenu de la page sans mettre à jour l'intégralité de la page. Cela permet d'obtenir des applications plus rapides et plus réactives.
-
Les graphismes sur le Web
-
Les sites et applications web modernes utilisent généralement des graphismes (avec différents degrés de sophistication).
-
Guide pour les API web
-
Une liste de l'ensemble des API web et de leur rôle.
-
JavaScript
-
JavaScript est un langage de script notamment utilisé pour créer des applications sur le Web.
-
Localisations et encodages
-
En interne, les navigateurs traitent le texte en Unicode. Toutefois, la façon de représenter les caractères sous forme d'octets (l'encodage) est utilisée lors du transfert du texte sur le réseau vers le navigateur. La spécification HTML recommande l'usage de l'encodage UTF-8 (qui peut représenter l'ensemble des caractères Unicode). Quel que soit l'encodage utilisé, le contenu web doit déclarer l'encodage qu'il utilise.
-
Développement web pour mobile
-
Cet article fournit un aperçu des techniques principales utilisées pour concevoir des sites web qui fonctionnent correctement sur les appareils mobiles. Voir aussi Firefox for Android.
-
Applications web progressives (PWA)
-
Les applications web progressives (aussi appelées PWA) utilisent des API web modernes ainsi que des techniques d'amélioration progressive afin de créer des applications web fonctionnant sur différentes plateformes. Ces applications fonctionnent sur différents appareils et fournissent certaines fonctionnalités les rapprochant des applications natives. Dans ce guide, nous verrons ce qu'il vous faut savoir à propos des PWA.
-
Optimisation et performance
-
Lorsqu'on construit des sites et applications web, il est crucial que le contenu soit fourni rapidement et efficacement. Ainsi, votre site ou application fonctionnera au mieux, que ce soit sur un PC puissant ou sur un appareil mobile potentiellement plus léger.
-
Analyser et sérialiser du XML
-
La plateforme web fournit différentes méthodes pour analyser (parsing) et sérialiser du XML dont chacune a ses avantages et ses inconvénients.
-
Web Open Font Format (WOFF)
-
Le format WOFF (Web Open Font Format) est un format pour représenter des polices de caractères afin de les utiliser sur le Web.
-
Algorithme de texte Unicode bidirectionnel (BiDi)
-
L'algorithme Unicode® BiDi fait partie du standard Unicode. Il décrit la façon dont le navigateur doit ordonner les caractères lorsqu'il affiche du texte Unicode. Ce guide présente l'algorithme en général et la façon dont il s'applique au contenu que vous créez. Cela s'avère particulièrement utile lorsque vous concevez et implémentez des systèmes avec une localisation et une internationalisation.
-
Manipuler les objets FormData
-
L'objet FormData permet de compiler un ensemble de paires de clés/valeurs et de l'envoyer via une XMLHttpRequest. Son but principal est d'envoyer des données de formulaire mais il peut être utilisé sans formulaire afin de transmettre des données utilisant des clés. Le format de la transmission est identique à ce qui serait utilisé par la méthode submit() d'un formulaire si l'encodage de celui-ci valait "multipart/form-data".
-
Gérer la saisie de l'utilisateur et les contrôles
-
Sur les sites et applications web, un utilisateur peut interagir avec sa souris et son clavier mais aussi avec d'autres outils (écran tactile par exemple). Cet article fournit quelques recommandations sur la gestion de la saisie de l'utilisateur pour les applications web ainsi qu'une FAQ, des exemples concrets et des liens vers des informations supplémentaires détaillées.
-
Glossaire
-
Définit de nombreux termes techniques relatifs au Web et à Internet.
-
- -

Voir aussi

- - diff --git a/files/fr/web/guide/index.md b/files/fr/web/guide/index.md new file mode 100644 index 0000000000..c649cfd67e --- /dev/null +++ b/files/fr/web/guide/index.md @@ -0,0 +1,58 @@ +--- +title: Guides pour les développeurs du Web +slug: Web/Guide +tags: + - Guide + - Landing + - Web +translation_of: Web/Guide +--- +

Ces articles sont des tutoriels et guides pratiques permettant d'utiliser certaines API et technologies web.

+ + +
+
Apprendre - HTML
+
HyperText Markup Language (HTML) est le langage de base pour la grande partie du contenu web. La plupart de ce que vous voyez à l'écran est décrit en HTML.
+
Apprendre - CSS
+
Cascading Style Sheets (CSS) est un langage de feuille de styles utilisé afin de définir la présentation d'un document écrit en HTML.
+
Fournir de l'audio et/ou de la vidéo
+
Il est possible d'intégrer de l'audio et de la vidéo à du contenu web de différentes façons : que ce soit des fichiers statiques ou des flux adaptatifs. Cet article est une introduction à ces différentes méthodes et à la compatibilité pour les principaux navigateurs web.
+
Manipuler des données audio ou vidéo
+
Il est possible de combiner les technologies web et les médias afin de créer de nouveaux usages. Dans cet article, nous verrons comment utiliser des technologies web telles que {{htmlelement("canvas")}}, WebGL ou l'API Web Audio afin de modifier les fichiers audio ou vidéo directement (en ajoutant des effets de réverbération ou des filtres de couleurs).
+
Guide sur les évènements
+
Les évènements peuvent désigner deux concepts : un patron de conception permettant de gérer de façon asynchrone ce qui se produit lors de la vue d'une page web d'une part et la liste, les noms et les caractéristiques desdits évènements d'autre part.
+
AJAX
+
AJAX est un terme regroupant différentes technologies qui permettent aux applications web d'appliquer des mises à jour incrémentales au contenu de la page sans mettre à jour l'intégralité de la page. Cela permet d'obtenir des applications plus rapides et plus réactives.
+
Les graphismes sur le Web
+
Les sites et applications web modernes utilisent généralement des graphismes (avec différents degrés de sophistication).
+
Guide pour les API web
+
Une liste de l'ensemble des API web et de leur rôle.
+
JavaScript
+
JavaScript est un langage de script notamment utilisé pour créer des applications sur le Web.
+
Localisations et encodages
+
En interne, les navigateurs traitent le texte en Unicode. Toutefois, la façon de représenter les caractères sous forme d'octets (l'encodage) est utilisée lors du transfert du texte sur le réseau vers le navigateur. La spécification HTML recommande l'usage de l'encodage UTF-8 (qui peut représenter l'ensemble des caractères Unicode). Quel que soit l'encodage utilisé, le contenu web doit déclarer l'encodage qu'il utilise.
+
Développement web pour mobile
+
Cet article fournit un aperçu des techniques principales utilisées pour concevoir des sites web qui fonctionnent correctement sur les appareils mobiles. Voir aussi Firefox for Android.
+
Applications web progressives (PWA)
+
Les applications web progressives (aussi appelées PWA) utilisent des API web modernes ainsi que des techniques d'amélioration progressive afin de créer des applications web fonctionnant sur différentes plateformes. Ces applications fonctionnent sur différents appareils et fournissent certaines fonctionnalités les rapprochant des applications natives. Dans ce guide, nous verrons ce qu'il vous faut savoir à propos des PWA.
+
Optimisation et performance
+
Lorsqu'on construit des sites et applications web, il est crucial que le contenu soit fourni rapidement et efficacement. Ainsi, votre site ou application fonctionnera au mieux, que ce soit sur un PC puissant ou sur un appareil mobile potentiellement plus léger.
+
Analyser et sérialiser du XML
+
La plateforme web fournit différentes méthodes pour analyser (parsing) et sérialiser du XML dont chacune a ses avantages et ses inconvénients.
+
Web Open Font Format (WOFF)
+
Le format WOFF (Web Open Font Format) est un format pour représenter des polices de caractères afin de les utiliser sur le Web.
+
Algorithme de texte Unicode bidirectionnel (BiDi)
+
L'algorithme Unicode® BiDi fait partie du standard Unicode. Il décrit la façon dont le navigateur doit ordonner les caractères lorsqu'il affiche du texte Unicode. Ce guide présente l'algorithme en général et la façon dont il s'applique au contenu que vous créez. Cela s'avère particulièrement utile lorsque vous concevez et implémentez des systèmes avec une localisation et une internationalisation.
+
Manipuler les objets FormData
+
L'objet FormData permet de compiler un ensemble de paires de clés/valeurs et de l'envoyer via une XMLHttpRequest. Son but principal est d'envoyer des données de formulaire mais il peut être utilisé sans formulaire afin de transmettre des données utilisant des clés. Le format de la transmission est identique à ce qui serait utilisé par la méthode submit() d'un formulaire si l'encodage de celui-ci valait "multipart/form-data".
+
Gérer la saisie de l'utilisateur et les contrôles
+
Sur les sites et applications web, un utilisateur peut interagir avec sa souris et son clavier mais aussi avec d'autres outils (écran tactile par exemple). Cet article fournit quelques recommandations sur la gestion de la saisie de l'utilisateur pour les applications web ainsi qu'une FAQ, des exemples concrets et des liens vers des informations supplémentaires détaillées.
+
Glossaire
+
Définit de nombreux termes techniques relatifs au Web et à Internet.
+
+ +

Voir aussi

+ + diff --git a/files/fr/web/guide/introduction_to_web_development/index.html b/files/fr/web/guide/introduction_to_web_development/index.html deleted file mode 100644 index 0c2daff192..0000000000 --- a/files/fr/web/guide/introduction_to_web_development/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Introduction au développement web -slug: Web/Guide/Introduction_to_Web_development -translation_of: Web/Guide/Introduction_to_Web_development -original_slug: Développement_Web/Introduction_au_développement_web ---- -

Que vous débutiez dans le domaine du développement web ou que vous désiriez élargir vos horizons, ces liens devraient vous aider.

-
-

Note : cette page n'est qu'une ébauche, nous aurions besoin de plus de contenu.

- - - - - - - - -
-

Sujets de documentation

-

Aucun article n'est encore disponible.

- 		-

Ressources

-
-
- Alsacréations
-
- Tutoriels HTML, CSS, actualités et articles sur les standards du web.
-
-
-

 

-

{{ languages( { "en": "en/Web_development/Introduction_to_Web_development", "zh-tw": "zh_tw/Web_開發/Web開發入門" } ) }}

diff --git a/files/fr/web/guide/introduction_to_web_development/index.md b/files/fr/web/guide/introduction_to_web_development/index.md new file mode 100644 index 0000000000..0c2daff192 --- /dev/null +++ b/files/fr/web/guide/introduction_to_web_development/index.md @@ -0,0 +1,31 @@ +--- +title: Introduction au développement web +slug: Web/Guide/Introduction_to_Web_development +translation_of: Web/Guide/Introduction_to_Web_development +original_slug: Développement_Web/Introduction_au_développement_web +--- +

Que vous débutiez dans le domaine du développement web ou que vous désiriez élargir vos horizons, ces liens devraient vous aider.

+
+

Note : cette page n'est qu'une ébauche, nous aurions besoin de plus de contenu.

+ + + + + + + + +
+

Sujets de documentation

+

Aucun article n'est encore disponible.

+ 		+

Ressources

+
+
+ Alsacréations
+
+ Tutoriels HTML, CSS, actualités et articles sur les standards du web.
+
+
+

 

+

{{ languages( { "en": "en/Web_development/Introduction_to_Web_development", "zh-tw": "zh_tw/Web_開發/Web開發入門" } ) }}

diff --git a/files/fr/web/guide/mobile/index.html b/files/fr/web/guide/mobile/index.html deleted file mode 100644 index 8cc4376982..0000000000 --- a/files/fr/web/guide/mobile/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Développement web mobile -slug: Web/Guide/Mobile -translation_of: Web/Guide/Mobile ---- -

Cette page fournit un aperçu de certaines des techniques principales nécessaires pour concevoir des sites web qui fonctionneront bien sur les appareils mobiles. Si vous cherchez des informations sur le projet Firefox OS de Mozilla, consultez la page Firefox OS. Des détails sur Firefox pour Android pourraient également vous intéresser.

-

Cette page est divisée en deux sections, conception pour les appareils mobiles et développement multinavigateur. Consultez également le guide de Jason Grlicky mobile-friendliness pour les développeurs web.

-

Conception pour les appareils mobiles

-

Les appareils mobiles ont des caractéristiques physiques assez différentes des ordinateurs portables ou de bureau. Leurs écrans sont généralement plus petits, évidemment, mais ils changent aussi automatiquement l'orientation de l'écran entre portrait et paysage lorsque l'utilisateur les tourne. Ils disposent généralement d'écrans tactiles pour les manipuler. Des API comme la géolocalisation ou l'orientation de l'appareil ne sont pas toujours gérées sur un ordinateur ou y sont beaucoup moins utiles, alors qu'elles donnent aux utilisateurs mobiles de nouvelles manières d'interagir avec votre site.

-

Gestion des petits écrans

-

Le Responsive Web Design est un terme pour un ensemble de techniques permettant à votre site web d'adapter sa disposition lorsque son environnement change ; en particulier la taille et l'orientation de l'écran. Parmi ces techniques :

- -

La balise meta viewport indique au navigateur d'afficher votre site à l'échelle appropriée pour l'appareil de l'utilisateur.

-

Gestion des écrans tactiles

-

Pour utiliser un écran tactile, vous devrez travailler avec les évènements DOM Touch. Vous n'aurez pas la possibilité d'utiliser la pseudo-classe CSS :hover et devrez concevoir les éléments cliquables comme les boutons de manière à prendre en compte le fait que les doigts sont plus gros qu'un pointeur de souris. Consultez cet article concernant la conception pour écrans tactiles.

-

Vous pouvez utiliser la media query -moz-touch-enabled pour charger un style CSS différent sur un appareil tactile.

-

Optimisation des images

-

Pour aider les utilisateurs dont les appareils ont une bande passante faible ou coûteuse, vous pouvez optimiser les images en ne chargeant que celles qui sont appropriées pour la taille et la résolution de l'écran. Ceci peut se faire en CSS selon la hauteur, la largeur et la densité en pixels.

-

Il est également possible d'utiliser des propriétés CSS pour concevoir des effets visuels comme des dégradés et des ombres sans utiliser d'images.

-

API mobiles

-

Enfin, vous pourrez tirer partir des nouvelles possibilités offertes par les appareils mobiles, comme l'orientation et la géolocalisation.

-

Développement multinavigateur

-

Écriture de code multinavigateur

-

Pour créer des sites web qui fonctionneront de manière acceptable sur différents navigateurs mobiles :

- -

Par exemple, si vous prévoyez un fond avec dégradé de couleurs sur une zone de texte avec une propriété préfixée comme -webkit-linear-gradient, il est préférable d'ajouter les autres versions préfixées de la propriété linear-gradient. Si vous ne le faites pas, assurez-vous au moins que le fond par défaut offre un bon contraste avec le texte : de cette manière la page sera au moins utilisable dans un navigateur qui n'est pas visé par votre règle linear-gradient.

-

Consultez cette liste des propriétés spécifiques à Gecko, cette liste de propriétés spécifiques à WebKit, ainsi que le tableau de Peter Beverloo des propriétés spécifiques des moteurs de rendu des navigateurs.

-

Vous pouvez vous aider d'outils comme CSS Lint pour trouver des problèmes de ce genre dans votre code, et de préprocesseurs comme SASS et LESS pour produire du code multinavigateur.

-

Attention avec la détection d'agent utilisateur

-

Il est préférable que les sites web détectent des fonctionnalités spécifiques de l'appareil comme sa taille d'écran et ses capacités tactiles à l'aide des techniques listées ci-dessus, et s'y adaptent en conséquence. Mais parfois ce n'est pas possible et certains sites ont recours à la chaîne d'identification d'agent utilisateur (user agent) pour essayer de faire la distinction entre ordinateurs de bureau, tablettes et téléphones afin de servir un type de contenu différent à chaque type d'appareil.

-

Si vous faites cela, assurez-vous que votre algorithme est correct et que vous ne fournissez pas le mauvais type de contenu à un appareil parce que vous ne traitez pas la chaîne d'identification d'un navigateur particulier. Consultez ce guide d'utilisation de la chaîne user agent pour déteminer le type d'appareil.

-

Test sur plusieurs navigateurs

-

Testez votre site web sur plusieurs navigateurs. Cela veut dire aussi tester sur plusieurs plateformes — au moins iOS et Android.

- diff --git a/files/fr/web/guide/mobile/index.md b/files/fr/web/guide/mobile/index.md new file mode 100644 index 0000000000..8cc4376982 --- /dev/null +++ b/files/fr/web/guide/mobile/index.md @@ -0,0 +1,44 @@ +--- +title: Développement web mobile +slug: Web/Guide/Mobile +translation_of: Web/Guide/Mobile +--- +

Cette page fournit un aperçu de certaines des techniques principales nécessaires pour concevoir des sites web qui fonctionneront bien sur les appareils mobiles. Si vous cherchez des informations sur le projet Firefox OS de Mozilla, consultez la page Firefox OS. Des détails sur Firefox pour Android pourraient également vous intéresser.

+

Cette page est divisée en deux sections, conception pour les appareils mobiles et développement multinavigateur. Consultez également le guide de Jason Grlicky mobile-friendliness pour les développeurs web.

+

Conception pour les appareils mobiles

+

Les appareils mobiles ont des caractéristiques physiques assez différentes des ordinateurs portables ou de bureau. Leurs écrans sont généralement plus petits, évidemment, mais ils changent aussi automatiquement l'orientation de l'écran entre portrait et paysage lorsque l'utilisateur les tourne. Ils disposent généralement d'écrans tactiles pour les manipuler. Des API comme la géolocalisation ou l'orientation de l'appareil ne sont pas toujours gérées sur un ordinateur ou y sont beaucoup moins utiles, alors qu'elles donnent aux utilisateurs mobiles de nouvelles manières d'interagir avec votre site.

+

Gestion des petits écrans

+

Le Responsive Web Design est un terme pour un ensemble de techniques permettant à votre site web d'adapter sa disposition lorsque son environnement change ; en particulier la taille et l'orientation de l'écran. Parmi ces techniques :

+ +

La balise meta viewport indique au navigateur d'afficher votre site à l'échelle appropriée pour l'appareil de l'utilisateur.

+

Gestion des écrans tactiles

+

Pour utiliser un écran tactile, vous devrez travailler avec les évènements DOM Touch. Vous n'aurez pas la possibilité d'utiliser la pseudo-classe CSS :hover et devrez concevoir les éléments cliquables comme les boutons de manière à prendre en compte le fait que les doigts sont plus gros qu'un pointeur de souris. Consultez cet article concernant la conception pour écrans tactiles.

+

Vous pouvez utiliser la media query -moz-touch-enabled pour charger un style CSS différent sur un appareil tactile.

+

Optimisation des images

+

Pour aider les utilisateurs dont les appareils ont une bande passante faible ou coûteuse, vous pouvez optimiser les images en ne chargeant que celles qui sont appropriées pour la taille et la résolution de l'écran. Ceci peut se faire en CSS selon la hauteur, la largeur et la densité en pixels.

+

Il est également possible d'utiliser des propriétés CSS pour concevoir des effets visuels comme des dégradés et des ombres sans utiliser d'images.

+

API mobiles

+

Enfin, vous pourrez tirer partir des nouvelles possibilités offertes par les appareils mobiles, comme l'orientation et la géolocalisation.

+

Développement multinavigateur

+

Écriture de code multinavigateur

+

Pour créer des sites web qui fonctionneront de manière acceptable sur différents navigateurs mobiles :

+ +

Par exemple, si vous prévoyez un fond avec dégradé de couleurs sur une zone de texte avec une propriété préfixée comme -webkit-linear-gradient, il est préférable d'ajouter les autres versions préfixées de la propriété linear-gradient. Si vous ne le faites pas, assurez-vous au moins que le fond par défaut offre un bon contraste avec le texte : de cette manière la page sera au moins utilisable dans un navigateur qui n'est pas visé par votre règle linear-gradient.

+

Consultez cette liste des propriétés spécifiques à Gecko, cette liste de propriétés spécifiques à WebKit, ainsi que le tableau de Peter Beverloo des propriétés spécifiques des moteurs de rendu des navigateurs.

+

Vous pouvez vous aider d'outils comme CSS Lint pour trouver des problèmes de ce genre dans votre code, et de préprocesseurs comme SASS et LESS pour produire du code multinavigateur.

+

Attention avec la détection d'agent utilisateur

+

Il est préférable que les sites web détectent des fonctionnalités spécifiques de l'appareil comme sa taille d'écran et ses capacités tactiles à l'aide des techniques listées ci-dessus, et s'y adaptent en conséquence. Mais parfois ce n'est pas possible et certains sites ont recours à la chaîne d'identification d'agent utilisateur (user agent) pour essayer de faire la distinction entre ordinateurs de bureau, tablettes et téléphones afin de servir un type de contenu différent à chaque type d'appareil.

+

Si vous faites cela, assurez-vous que votre algorithme est correct et que vous ne fournissez pas le mauvais type de contenu à un appareil parce que vous ne traitez pas la chaîne d'identification d'un navigateur particulier. Consultez ce guide d'utilisation de la chaîne user agent pour déteminer le type d'appareil.

+

Test sur plusieurs navigateurs

+

Testez votre site web sur plusieurs navigateurs. Cela veut dire aussi tester sur plusieurs plateformes — au moins iOS et Android.

+ diff --git a/files/fr/web/guide/performance/index.html b/files/fr/web/guide/performance/index.html deleted file mode 100644 index 5c2605f1aa..0000000000 --- a/files/fr/web/guide/performance/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Optimisation et performances -slug: Web/Guide/Performance -tags: - - Optimisation - - Performances web - - Web -translation_of: Web/Guide/Performance ---- -

Lorsque l’on créent des sites et des applications internet modernes, il est important que notre code soit performant. C’est-à-dire, le faire fonctionner rapidement et efficacement. Lui permettant ainsi de fonctionner aussi efficacement à la fois pour les utilisateurs de puissants systèmes de bureau et pour les appareils portables ayant moins de puissance. On appel cela le PageSpeed Optimization (optimisation de la vitesse de chargement de pages web). Il y a plusieurs outils disponibles pour vérifiez les performances de chargement d’un site ou de blog internet. Les plus connus sont listés ci-dessous :  

- - - -

Les sites internet statiques en HTML ont besoins, pour améliorer leurs performances, de techniques manuelles d’optimisation. Plusieurs produits logiciels open source à l’instar de WordPress, ont eux des plugins disponibles pour permettre aux propriétaires de sites web d’optimisez leurs performances web. WP Super Charge est un des plugins disponible sur la boutique de WordPress, il permet à l’utilisateur d’optimisez les performances de son site en un clic.

- -

{{LandingPageListSubpages}}

diff --git a/files/fr/web/guide/performance/index.md b/files/fr/web/guide/performance/index.md new file mode 100644 index 0000000000..5c2605f1aa --- /dev/null +++ b/files/fr/web/guide/performance/index.md @@ -0,0 +1,20 @@ +--- +title: Optimisation et performances +slug: Web/Guide/Performance +tags: + - Optimisation + - Performances web + - Web +translation_of: Web/Guide/Performance +--- +

Lorsque l’on créent des sites et des applications internet modernes, il est important que notre code soit performant. C’est-à-dire, le faire fonctionner rapidement et efficacement. Lui permettant ainsi de fonctionner aussi efficacement à la fois pour les utilisateurs de puissants systèmes de bureau et pour les appareils portables ayant moins de puissance. On appel cela le PageSpeed Optimization (optimisation de la vitesse de chargement de pages web). Il y a plusieurs outils disponibles pour vérifiez les performances de chargement d’un site ou de blog internet. Les plus connus sont listés ci-dessous :  

+ + + +

Les sites internet statiques en HTML ont besoins, pour améliorer leurs performances, de techniques manuelles d’optimisation. Plusieurs produits logiciels open source à l’instar de WordPress, ont eux des plugins disponibles pour permettre aux propriétaires de sites web d’optimisez leurs performances web. WP Super Charge est un des plugins disponible sur la boutique de WordPress, il permet à l’utilisateur d’optimisez les performances de son site en un clic.

+ +

{{LandingPageListSubpages}}

diff --git a/files/fr/web/guide/user_input_methods/index.html b/files/fr/web/guide/user_input_methods/index.html deleted file mode 100644 index b2f48453e0..0000000000 --- a/files/fr/web/guide/user_input_methods/index.html +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Entrées utilisateur et méthodes -slug: Web/Guide/User_input_methods -translation_of: Web/Guide/User_input_methods ---- -

Les entrées utilisateur modernes vont au-delà du simple clavier et souris: pensez aux écrans tactiles par exemple. Cet article fournit des recommendations pour gérer les entrées utilisateur et implémenter les contrôles des Open Web Apps, ainsi que des FAQs, des exemples concrets, et des liens pour ceux qui ont besoin d'informations supplémentaires sur les technologies utilisées. Les APIs et événements abordés sont en autre les événements tactiles, l'API Pointer Lock, l'API Screen Orientation, l'API Fullscreen et Drag & Drop.

- -

Workflow entrées utilisateur et contrôles

- -

La diagramme suivant illustre le déroulement des opérations typique pour implémenter les mécanismes d'entrée utilisateur:

- -

- -

Tout d'abord vous devez décider quels mécanismes en entrées vous voulez prendre en charge dans votre application: souris, clavier, doigt, etc. Une fois que vous avez décidé, vous pouvez les contrôler en utilisant les outils offerts par la plateforme web ou par des bibliothèques JavaScript.

- -

Recommandations

- -

Les mécanismes en entrées dépendent des capacités de l'appareil qui exécute l'application:

- - - -

Vous trouverez ci-dessous un ensemble de recommandations et meilleures pratiques pour utiliser de tels outils dans des Open Web Apps.

- -

Décidez quel mécanisme en entrée vous utilisez

- -

Clavier

- -

La saisie du clavier peut être contrôlée par votre application. Par exemple, si vous voulez ajouter des contrôles déclenchés quand des touches sont pressées, vous devez ajouter un gestionnaire d'événement sur l'objet window:

- -
window.addEventListener("keydown", handleKeyDown, true);
-window.addEventListener("keyup", handleKeyUp, true);
- -

où handleKeyDown et handleKeyUp sont des fonctions implémentant les contrôles sur les événements keydown et keyup.

- -
-

Note : Jetez un coup d'oeil à la Référence des événements et au guide {{domxref("KeyboardEvent")}} pour en savoir plus sur les événements de clavier.

-
- -

Souris

- -

Les événements qui se produisent quand l'utilisateur interagit avec un appareil de pointage comme une souris sont représentés par l'interface DOM {{domxref("MouseEvent")}}. Les événements de souris les plus communs sont click, dblclick, mouseup, et mousedown. La liste de tous les événements souris utilisant l'interface MouseEvent est disponible dans la Référence des événements.
-
- Quand le périphérique d'entrée est une souris, vous pouvez également contrôler les entrées utilisateur avec l'API Pointer Lock et implémenter le Drag & Drop (voir ci-dessous).

- -

Toucher du doigt

- -

Quand vous développez des applications web destinées à être installées sur des appareils à écran tactile, il est recommandé de prendre en considération les différentes capacités de l'appareil, en terme de résolution d'écran et d'entrée utilisateur. Les événements tactiles peuvent vous aider à implémenter des éléments interactifs et des geste d'interactions courants sur les appareils à écran tactile.
-
- Si vous voulez utiliser les événements tactiles, vous devez ajouter des gestionnaires d'événement et spécifier des fonctions de rappel, appelées quand l'événement est déclenché:

- -
element.addEventListener("touchstart", handleStart, false);
-element.addEventListener("touchend", handleEnd, false);
-element.addEventListener("touchcancel", handleCancel, false);
-element.addEventListener("touchend", handleEnd, false);
-element.addEventListener("touchmove", handleMove, false);
- -

où element est l'élément du DOM sur lequel vous voulez enregistrer les événements tactiles.

- -
-

Note : Pour plus d'informations sur ce que vous pouvez faire avec les événements tactiles, lisez le guide des événements tactiles.

-
- -

Événements de pointeur

- -

Quand vous avez affaire à des appareils qui incorporent de multiples formes d'entrée, comme la souris, le toucher du doigt et la saisie au stylet, il peut être difficile de développer une solution qui marche pour tous ces mécanismes de contrôle différents. Les événements de pointeur aident les développeurs à gérer plus facilement les événements sur les appareils en normalisant le traitement de chacun d'entre eux. Un pointeur peut être n'importe quel contact sur l'écran, fait par le curseur d'une souris, d'un stylo, le toucher (y compris multi-touch) ou autre périphérique d'entrée de pointage. Les événements génériques pour gérer la saisie du pointeur ressemblent beaucoup à ceux pour la souris: pointerdown, pointermove, pointerup, pointerover, pointerout, etc.

- -
-

Note : Les événements du pointeur ne sont pas encore beaucoup pris en charge, mais le polyfill pointer.js est disponible sur le compte GitHub de Mozilla.

-
- -

Implémentez les contrôles

- -

Verrouiller le pointeur

- -

Dans certains cas, typiquement dans le développement de jeux, vous pouvez avoir besoin d'accéder aux événements de la souris même lorsque le curseur dépasse la limite du navigateur ou de l'écran: l'{{domxref("Pointer_Lock_API", "API Pointer Lock")}} vous donne le contrôle total de l'appareil de pointage.

- -

Voici le code pour demander que le pointeur soit bloqué à l'intérieur d'element:

- -
element.requestPointerLock();
- -
-

Note : Pour un tutoriel complet et la référence, lisez notre page {{domxref("Pointer_Lock_API", "Pointer Lock API")}}.

-
- -

Orientation de l'écran

- -

Si l'orientation de l'écran est importante pour votre application, vous pouvez lire l'état de l'orientation de l'écran, être informé quand cet état change, et verrouiller l'orientation dans un état spécifique (habituellement portrait ou paysage) à travers l'API Screen Orientation.

- -

Les données d'orientation peuvent être récupérées à travers l'attribut {{domxref("screen.orientation")}} ou à travers la media query orientation. Quand screen.orientation change, l'événement {{domxref("screen.orientationchange")}} est declenché sur l'objet screen. Verrouiller l'orientation de l'écran en possible en invoquant la méthode {{domxref("screen.lockOrientation")}}, tandis que la méthode {{domxref("screen.unlockOrientation")}} supprime le verrouillage de l'écran précédemment définit.

- -
-

Note : Pour plus d'informations sur l'API Screen Orientation API consultez Gérer l'orientation de l'écran.

-
- -

Plein écran

- -

Vous pourriez avoir besoin de présenter un élément de votre application (comme une {{ htmlelement("video") }} par exemple) en mode plein écran. Vous pouvez y parvenir en appelant {{domxref("Element.requestFullscreen()")}} sur cet élément. Gardez à l'esprit que beaucoup de navigateurs l'implémentent encore avec un préfixe de fournisseur, vous aurez donc probablement besoin de découper votre code ainsi:

- -
var elem = document.getElementById("myvideo");
-if (elem.requestFullscreen) {
-  elem.requestFullscreen();
-} else if (elem.msRequestFullscreen) {
-  elem.msRequestFullscreen();
-} else if (elem.mozRequestFullScreen) {
-  elem.mozRequestFullScreen();
-} else if (elem.webkitRequestFullscreen) {
-  elem.webkitRequestFullscreen();
-}
- -
-

Note : Pour en savoir plus sur la fonctionnalité de plein écran, lisez notre documentation utiliser le plein écran.

-
- -

Drag & Drop

- -

Drag & Drop (glisser/déposer) permet à l'utilisateur de votre application de cliquer sur un élément, maintenir le bouton de la souris enfoncé sur cet élément, le faire glisser vers un autre emplacement, et relacher le bouton de la souris pour le déposer à cet emplacement.
-
- Voici un exemple qui permet à du contenu d'être déplacé:

- -
<div draggable="true" ondragstart="event.dataTransfer.setData('text/plain', 'Ce texte peut être déplacé')">
-    Ce texte <strong>peut</strong> être déplacé.
-</div>
- -

Ici, on

- - - -
-

Note : Vous pouvez trouver plus d'informations dans la documentation MDN Drag & Drop.

-
- -

contentEditable

- -

Dans un Open Web App, tout élément DOM peut être rendu directement éditable en utilisant l'attribut contenteditable.

- -
<div contenteditable="true">
-    Ce texte peut être édité par l'utilisateur.
-</div>
- -
-

Note : Vous pouvez trouver les informations de compatibilité, des exemples et d'autres ressources dans le guide Contenu Éditable.

-
- -

Exemples

- -
-
Suivre plusieurs points de contact à la fois
-
Cet exemple permet de gérer un toucher multiple (plusieurs contacts simultanés), permettant ainsi à l'utilisateur de dessiner dans un {{htmlelement("canvas")}} avec plusieurs doigts. Cela ne fonctionne qu'avec les navigateurs supportant les interactions tactiles.
-
Démo de verrouillage de pointeur simple
-
Vous avons écrit une démo de verrouillage de pointeur pour vous montrer comment l'utiliser pour mettre en place un système de contrôle simple. Cette démo utilise JavaScript pour dessiner une balle dans un élément {{htmlelement("canvas")}}. Quand vous cliquez sur le canvas, le verrouillage du pointeur est utilisé pour supprimer le curseur de la souris à l'écran et vous permettre de déplacer la balle avec la souris.
-
Démo contentEditable
-
Ceci est un exemple qui montre comment contenteditable peut être utilisé pour créer une section de document éditable, et dont l'état est sauvegardé en utilisant LocalStorage.
-
- -

Tutoriels

- - - -

Référence

- - diff --git a/files/fr/web/guide/user_input_methods/index.md b/files/fr/web/guide/user_input_methods/index.md new file mode 100644 index 0000000000..b2f48453e0 --- /dev/null +++ b/files/fr/web/guide/user_input_methods/index.md @@ -0,0 +1,186 @@ +--- +title: Entrées utilisateur et méthodes +slug: Web/Guide/User_input_methods +translation_of: Web/Guide/User_input_methods +--- +

Les entrées utilisateur modernes vont au-delà du simple clavier et souris: pensez aux écrans tactiles par exemple. Cet article fournit des recommendations pour gérer les entrées utilisateur et implémenter les contrôles des Open Web Apps, ainsi que des FAQs, des exemples concrets, et des liens pour ceux qui ont besoin d'informations supplémentaires sur les technologies utilisées. Les APIs et événements abordés sont en autre les événements tactiles, l'API Pointer Lock, l'API Screen Orientation, l'API Fullscreen et Drag & Drop.

+ +

Workflow entrées utilisateur et contrôles

+ +

La diagramme suivant illustre le déroulement des opérations typique pour implémenter les mécanismes d'entrée utilisateur:

+ +

+ +

Tout d'abord vous devez décider quels mécanismes en entrées vous voulez prendre en charge dans votre application: souris, clavier, doigt, etc. Une fois que vous avez décidé, vous pouvez les contrôler en utilisant les outils offerts par la plateforme web ou par des bibliothèques JavaScript.

+ +

Recommandations

+ +

Les mécanismes en entrées dépendent des capacités de l'appareil qui exécute l'application:

+ + + +

Vous trouverez ci-dessous un ensemble de recommandations et meilleures pratiques pour utiliser de tels outils dans des Open Web Apps.

+ +

Décidez quel mécanisme en entrée vous utilisez

+ +

Clavier

+ +

La saisie du clavier peut être contrôlée par votre application. Par exemple, si vous voulez ajouter des contrôles déclenchés quand des touches sont pressées, vous devez ajouter un gestionnaire d'événement sur l'objet window:

+ +
window.addEventListener("keydown", handleKeyDown, true);
+window.addEventListener("keyup", handleKeyUp, true);
+ +

où handleKeyDown et handleKeyUp sont des fonctions implémentant les contrôles sur les événements keydown et keyup.

+ +
+

Note : Jetez un coup d'oeil à la Référence des événements et au guide {{domxref("KeyboardEvent")}} pour en savoir plus sur les événements de clavier.

+
+ +

Souris

+ +

Les événements qui se produisent quand l'utilisateur interagit avec un appareil de pointage comme une souris sont représentés par l'interface DOM {{domxref("MouseEvent")}}. Les événements de souris les plus communs sont click, dblclick, mouseup, et mousedown. La liste de tous les événements souris utilisant l'interface MouseEvent est disponible dans la Référence des événements.
+
+ Quand le périphérique d'entrée est une souris, vous pouvez également contrôler les entrées utilisateur avec l'API Pointer Lock et implémenter le Drag & Drop (voir ci-dessous).

+ +

Toucher du doigt

+ +

Quand vous développez des applications web destinées à être installées sur des appareils à écran tactile, il est recommandé de prendre en considération les différentes capacités de l'appareil, en terme de résolution d'écran et d'entrée utilisateur. Les événements tactiles peuvent vous aider à implémenter des éléments interactifs et des geste d'interactions courants sur les appareils à écran tactile.
+
+ Si vous voulez utiliser les événements tactiles, vous devez ajouter des gestionnaires d'événement et spécifier des fonctions de rappel, appelées quand l'événement est déclenché:

+ +
element.addEventListener("touchstart", handleStart, false);
+element.addEventListener("touchend", handleEnd, false);
+element.addEventListener("touchcancel", handleCancel, false);
+element.addEventListener("touchend", handleEnd, false);
+element.addEventListener("touchmove", handleMove, false);
+ +

où element est l'élément du DOM sur lequel vous voulez enregistrer les événements tactiles.

+ +
+

Note : Pour plus d'informations sur ce que vous pouvez faire avec les événements tactiles, lisez le guide des événements tactiles.

+
+ +

Événements de pointeur

+ +

Quand vous avez affaire à des appareils qui incorporent de multiples formes d'entrée, comme la souris, le toucher du doigt et la saisie au stylet, il peut être difficile de développer une solution qui marche pour tous ces mécanismes de contrôle différents. Les événements de pointeur aident les développeurs à gérer plus facilement les événements sur les appareils en normalisant le traitement de chacun d'entre eux. Un pointeur peut être n'importe quel contact sur l'écran, fait par le curseur d'une souris, d'un stylo, le toucher (y compris multi-touch) ou autre périphérique d'entrée de pointage. Les événements génériques pour gérer la saisie du pointeur ressemblent beaucoup à ceux pour la souris: pointerdown, pointermove, pointerup, pointerover, pointerout, etc.

+ +
+

Note : Les événements du pointeur ne sont pas encore beaucoup pris en charge, mais le polyfill pointer.js est disponible sur le compte GitHub de Mozilla.

+
+ +

Implémentez les contrôles

+ +

Verrouiller le pointeur

+ +

Dans certains cas, typiquement dans le développement de jeux, vous pouvez avoir besoin d'accéder aux événements de la souris même lorsque le curseur dépasse la limite du navigateur ou de l'écran: l'{{domxref("Pointer_Lock_API", "API Pointer Lock")}} vous donne le contrôle total de l'appareil de pointage.

+ +

Voici le code pour demander que le pointeur soit bloqué à l'intérieur d'element:

+ +
element.requestPointerLock();
+ +
+

Note : Pour un tutoriel complet et la référence, lisez notre page {{domxref("Pointer_Lock_API", "Pointer Lock API")}}.

+
+ +

Orientation de l'écran

+ +

Si l'orientation de l'écran est importante pour votre application, vous pouvez lire l'état de l'orientation de l'écran, être informé quand cet état change, et verrouiller l'orientation dans un état spécifique (habituellement portrait ou paysage) à travers l'API Screen Orientation.

+ +

Les données d'orientation peuvent être récupérées à travers l'attribut {{domxref("screen.orientation")}} ou à travers la media query orientation. Quand screen.orientation change, l'événement {{domxref("screen.orientationchange")}} est declenché sur l'objet screen. Verrouiller l'orientation de l'écran en possible en invoquant la méthode {{domxref("screen.lockOrientation")}}, tandis que la méthode {{domxref("screen.unlockOrientation")}} supprime le verrouillage de l'écran précédemment définit.

+ +
+

Note : Pour plus d'informations sur l'API Screen Orientation API consultez Gérer l'orientation de l'écran.

+
+ +

Plein écran

+ +

Vous pourriez avoir besoin de présenter un élément de votre application (comme une {{ htmlelement("video") }} par exemple) en mode plein écran. Vous pouvez y parvenir en appelant {{domxref("Element.requestFullscreen()")}} sur cet élément. Gardez à l'esprit que beaucoup de navigateurs l'implémentent encore avec un préfixe de fournisseur, vous aurez donc probablement besoin de découper votre code ainsi:

+ +
var elem = document.getElementById("myvideo");
+if (elem.requestFullscreen) {
+  elem.requestFullscreen();
+} else if (elem.msRequestFullscreen) {
+  elem.msRequestFullscreen();
+} else if (elem.mozRequestFullScreen) {
+  elem.mozRequestFullScreen();
+} else if (elem.webkitRequestFullscreen) {
+  elem.webkitRequestFullscreen();
+}
+ +
+

Note : Pour en savoir plus sur la fonctionnalité de plein écran, lisez notre documentation utiliser le plein écran.

+
+ +

Drag & Drop

+ +

Drag & Drop (glisser/déposer) permet à l'utilisateur de votre application de cliquer sur un élément, maintenir le bouton de la souris enfoncé sur cet élément, le faire glisser vers un autre emplacement, et relacher le bouton de la souris pour le déposer à cet emplacement.
+
+ Voici un exemple qui permet à du contenu d'être déplacé:

+ +
<div draggable="true" ondragstart="event.dataTransfer.setData('text/plain', 'Ce texte peut être déplacé')">
+    Ce texte <strong>peut</strong> être déplacé.
+</div>
+ +

Ici, on

+ + + +
+

Note : Vous pouvez trouver plus d'informations dans la documentation MDN Drag & Drop.

+
+ +

contentEditable

+ +

Dans un Open Web App, tout élément DOM peut être rendu directement éditable en utilisant l'attribut contenteditable.

+ +
<div contenteditable="true">
+    Ce texte peut être édité par l'utilisateur.
+</div>
+ +
+

Note : Vous pouvez trouver les informations de compatibilité, des exemples et d'autres ressources dans le guide Contenu Éditable.

+
+ +

Exemples

+ +
+
Suivre plusieurs points de contact à la fois
+
Cet exemple permet de gérer un toucher multiple (plusieurs contacts simultanés), permettant ainsi à l'utilisateur de dessiner dans un {{htmlelement("canvas")}} avec plusieurs doigts. Cela ne fonctionne qu'avec les navigateurs supportant les interactions tactiles.
+
Démo de verrouillage de pointeur simple
+
Vous avons écrit une démo de verrouillage de pointeur pour vous montrer comment l'utiliser pour mettre en place un système de contrôle simple. Cette démo utilise JavaScript pour dessiner une balle dans un élément {{htmlelement("canvas")}}. Quand vous cliquez sur le canvas, le verrouillage du pointeur est utilisé pour supprimer le curseur de la souris à l'écran et vous permettre de déplacer la balle avec la souris.
+
Démo contentEditable
+
Ceci est un exemple qui montre comment contenteditable peut être utilisé pour créer une section de document éditable, et dont l'état est sauvegardé en utilisant LocalStorage.
+
+ +

Tutoriels

+ + + +

Référence

+ + diff --git a/files/fr/web/guide/writing_forward-compatible_websites/index.html b/files/fr/web/guide/writing_forward-compatible_websites/index.html deleted file mode 100644 index f9a62d2f43..0000000000 --- a/files/fr/web/guide/writing_forward-compatible_websites/index.html +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: Développer des sites à compatibilité descendante -slug: Web/Guide/Writing_forward-compatible_websites -tags: - - NeedsEditorialReview - - NeedsTechnicalReview -translation_of: Web/Guide/Writing_forward-compatible_websites -original_slug: Développement_Web/Développer_des_sites_à_compatibilité_descendante ---- -

Cette page explique comment développer des sites qui continuent de fonctionner au fur et à mesure des mises à jour des navigateurs.

- -

C'est d'autant plus important pour les intranets et autres sites non-publics; s'il n'est pas possible de voir votre site, il ne nous est pas possible de voir s'il est cassé. Il ne nous est pas toujours possible de suivre tous les sites, mais en suivre autant que possible permet d'en assurer la pérennité.

- -

JavaScript

- -

Préfixez tous les accès à des variables globales dans les attributs onfoo par “window.”

- -
Quand un attribut de gestion d'évenement (onclick, onmouseover, etc) est utilisé sur un élément HTML, toutes les résolutions de variable dans l'attribut sont d'abord résolues sur l'élément lui-même, puis sur le formulaire contenant l'élément (si c'est un élément de formulaire), puis sur document, puis finalement sur window (là où se trouvent les variables globales que vous avez définies).Par exemple, si vous avez le balisage suivant :
- -
<div onclick="alert(ownerDocument)">Cliquez moi</div>
- -

Alors cliquer sur le texte affichera le ownerDocument du div. Il en sera toujours ainsi, même s'il y a une var ownerDocument déclarée dans l'espace de visibilité global.

- -

Cela signifie qu'à chaque fois que vous accédez à une variable (ou une fonction) globale dans un attribut de gestion d'évenement vous pouvez vous retrouver avec une collision de nom. Il suffit pour cela qu'une nouvelle specification ajoute une nouvelle propriété DOM aux éléments, et que cette propriété porte le même nom que votre variable ou fonction.
- Si cela arrive, alors soudainement votre function ne sera plus appellée. Ceci est déjà arrivé de nombreuses fois à de multiples sites durant la phase d'évolution d'HTML5.

- -

Pour éviter ce problème, qualifiez complétement vos variables globales en utilisant window., comme ceci :

- -
<script>
-  function nomLocal() {
-    alert('La fonction nomLocal a été appellée.');
-  }
-</script>
-<div onclick="window.nomLocal()">Cliquer ici devrait faire apparaitre un message.<div>
-
- -

Ne concatenez pas les scripts dont vous n'avez pas le contrôle.

- -

En ECMAScript, la directive "use strict;" s'applique sur la totalité du fichier. Ainsi, ajouter un script qui dépends d'un comportement non-strict à la suite d'un script en mode strict risque fortement de générer des erreurs.

- -

Demandez aux auteurs des bibliothèques Javascript que vous utilisez de suivre ces recommandations.

- -

Suggérez aux développeurs de vos bibliothèques favorites de suivre ces recommendations. S'ils ne le font pas, vous n'avez pas l'assurance que la bibliothèque continue de fonctionner dans le futur. Malheureusement, les bibliothèques suivent rarement ces conseils.

- -

Détection

- -

Détecter des fonctionnalités particulières

- -

Si vous avez l'intention d'utiliser une fonctionnalité en particulier, utilisez autant que possible la détection d'objet pour détecter cette fonctionnalité particulière. Par exemple, ne considérez pas que si dans un navigateur "filter" in body.style s'évalue à true, alors forcément ce navigateur doit être Internet Explorer et que donc cela signifie qu'il possède un objet window.event disponible dans les gestionnaires d'évenement. 

- -

De manière générale, ne considérez pas que si un navigateur supporte une certaine fonctionnalité DOM, alors il doit forcément en supporter une autre, particulièrement si elle est non standard. Ou, à l'inverse, que s'il ne supporte pas une autre fonctionnalité, alors il n'en supportera pas non plus une autre. Par exemple, ce n'est pas parce qu'un navigateur supporte onload sur les éléments scripts alors cela signifie qu'il ne supportera jamais onreadystatechange sur ces mêmes éléments.

- -

Les comportement des navigateurs convergent de plus en plus: des fonctionnalités sont ajoutées, supprimées, des bugs sont corrigés. Tout ceci arrive regulièrement et arrivera encore.

- -

Ne cherchez donc pas à détecter une fonctionnalité ou un objet pour en déduire ensuite que parce qu'elle existe (ou non) alors telle ou telle autre fonctionnalité doit alors aussi exister (ou non).

- -

Ne détectez pas l'agent utilisateur

- -

Ceci est une sous-catégorie très particulière de l'exemple précédent. Il ne faut pas penser qu'une certaine fonctionnalité (la présence ou non d'une certaine chaine de caractères dans l'agent utilisateur -UA-) implique la présence ou l'absence d'autres fonctionnalités.

- -

Si vous devez détecter l'agent utilisateur, alors ne détectez que pour les anciennes versions.

- -

Si vous devez vraiment détecter l'agent utilisateur, alors ne l'utilisez que pour cibler des versions déjà dépassées.
- Tout d'abord, prévoyez toujours un chemin dans votre code pour les navigateurs que vous ne connaissez pas, ainsi que pour les versions courantes et futures des navigateurs avec lesquels vous avez testé votre site. Ensuite si ce chemin par défaut ne fonctionne pas dans certaines anciennes versions de certains navigateurs et uniquement si l'erreur ne peut pas être détectée par l'absence de fonctionnalités utilisées par votre chemin par défaut, alors il est raisonnable d'ajouter des hacks qui ne ciblent que ces anciennes versions de certains navigateurs, en recourant à la détection de l'agent utilisateur.

- -

Pour les besoins de ce conseil, considérez que "version courante" signifie la dernière version du navigateur que vous avez testé. Par exemple, si vous avez testé le chemin par défaut de votre code dans Firefox Aurora mais que Firefox Beta et les dernières versions ont un bug qui font planter votre code, alors il est raisonnable de considérer le numero de version de Aurora au moment du test comme étant la "version courante", et considérer la version Beta comme une version "ancienne", même si elle n'est pas encore sortie pour le public.

- -

Ne créez pas de chemin de code inutile pour une multitude de navigateurs différents

- -
N'allez pas créer trop de branches de code différentes, qui s'executent en fonction de l'agent utilisateur ou de la détection de fonctionnalité si vous avez une branche de code qui fonctionne pour tous les navigateurs. Il y a de fortes chances pour que les navigateurs convergent vers un comportement commun, ce qui risque de casser les chemins alternatifs que vous auriez créés pour tel ou tel navigateur.
- -

Test

- -

Tester dans les navigateurs principaux

- -

Testez votre code au moins sous Firefox, Chrome ou Safari (vu que les deux sont basés sur le même moteur WebKit), Opera et Internet Explorer. Si vous avez suivi le conseil donné précedemment à propos de l'unique branche de code pour toutes les versions de navigateurs (connues et inconnues), tester uniquement cette unique branche de code dans tous les navigateurs rends extremement probable le fait que votre code ne cassera pas dans le futur.

- -

Parfois, plusieurs navigateurs implementent une certaine fonctionnalité de manière légérement différente. Si vous avez une unique branche de code qui tourne dans tous les navigateurs principaux, cela signifie que vous utilisez soit des fonctionnalités pour lesquelles les navigateurs ont un comportement identiques, ou, s'ils n'ont pas encore convergé vers un seul comportement, votre code fonctionnera quelque soit le comportement final qui sera utilisé par tous.

- -

Prefixes et fonctionnalités propres à un certain navigateur

- -

N'utilisez pas de hack pour cibler la version actuelle ou une version future d'un navigateur

- -

Cela reviendrai à supposer que la corrélation actuelle entre plusieurs bugs implique une future corrélation entre ces mêmes bugs. Nous avons vu que cela n'était pas le cas.

- -

Il est par contre acceptable de cibler d'anciennes versions du navigateur si votre hack repose sur un bug présent dans les anciennes versions et corrigé dans les versions actuelles. Une fois que le bug X a été corrigé d'un navigateur, vous pouvez savoir que toutes les versions qui avaient le bug X avaient aussi le bug Y, et vous pourrez ainsi vous servir de X pour cibler des cas particuliers pour le bug Y.

- -

Dans ce cas, on considère par "actuelles" les versions les plus récentes du navigateur que vous avez testé, comme nous l'avons déjà évoqué dans le cas de la détection de l'agent utilisateur précédemment.

- -

Evitez de dépendre de fonctionnalités non standard ultra récentes

- -

Même si la fonctionnalitée est préfixée, l'utiliser peut être dangereux : au fur et à mesure de l'évolution de la spécification, l'implémentation préfixée du navigateur peut évoluer pour se rapprocher de la spécification. De plus, une fois la fonctionnalité standardisée, les versions prefixées seront vraisemblablement supprimées.

- -

Les fonctionnalités non standard, prefixées, sont fournies par les développeurs de navigateurs pour vous permettre de les expérimenter et d'offrir vos remarques en retour. Elles ne sont pas censées être déployées. Si vous choisissez de les utiliser, préparez-vous à faire des mises à jour régulières de votre site pour rester à flot avec les changements.

- -

Lorsque vous utilisez des fonctionnalités ultra récentes (même standards) qui ne sont pas encore implémentées partout, assurez-vous de tester les solutions de secours. Assurez-vous de tester ce qu'il se passe dans un navigateur qui n'implémente pas la fonctionnalité que vous utilisez, plus particulierement si vous ne l'utilisez pas régulièrement lors de l'élaboration de votre site.

- -

N'utilisez pas les versions préfixées des fonctionnalités, à moins de cibler les anciennes versions

- -

Le comportement des versions préfixées des fonctionnalités peut changer dans une future version. Néanmoins, dès lors qu'un navigateur est sorti avec une fonctionnalité non-prefixée, vous pouvez utiliser la version préfixée pour cibler les anciennes versions. Assurez-vous de toujours utiliser la version non-préfixée quand celle-ci est disponible.

- -

Voici un exemple, pour un navigateur qui utilise le préfixe -vnd en CSS et qui a sorti une version non-prefixée de la propriété rends-moi-joli, avec un comportement défini pour la valeur "parfois" qui diffère de la valeur préfixée.

- -
<style>
-  .joli-element {
-    -vnd-rends-moi-joli: parfois;
-    rends-moi-joli: parfois;
-  }
-</style>
-
- -

L'ordre des déclarations dans la règle précédente est important : la version non préfixée doit apparaitre en dernier.

- -

N'utilisez pas les versions non préfixées des propriétés CSS ou des APIs tant qu'au moins un navigateur ne les ont pas implémentées

- -

Tant que le support d'une version non préfixée d'une fonctionnalité n'est pas généralisé auprès des navigateurs, son comportement peut encore changer de manière radicale. Plus particulièrement, n'utilisez pas les versions non préfixées si aucun navigateur ne les implémente. Vous ne pouvez même pas être sûr que la syntaxe de la version finale sera la même que la syntaxe utilisée dans l'une des version préfixées.

- -

Hygiène de code

- -

Evitez les > manquants

- -

Passer votre code au validateur est un bon moyen de s'assurer de cela. Mais même si votre site ne valide pas complétement, vous devriez vous assurer que tous vos caractères > sont présents.
- S'ils manquent, cela peut vous amener à des situations où un nom de balise est interprété comme un attribut d'une balise précédente. Cela peut sembler fonctionner pendant quelques temps, mais finira par casser si une spécification future défini un sens à cet attribut. 

- -

Voici un exemple qui fonctionne dans les navigateurs ne possédant pas le support du HTML5, mais est cassé dans un navigateur le supportant :

- -
<form action="http://www.exemple.com">
-  <input type="submit" value="Soumettre le formulaire"
-</form>
-
- -

à cause du > manquant sur la balise input.

- -

Ne laissez pas de tests qui ne fonctionnent pas dans votre code

- -

Si vous essayez d'utiliser une propriété CSS, mais que celle-ci n'a pas d'effet, supprimez-la. Elle pourrait se mettre à avoir un effet que vous n'attendiez pas du tout dans une version future.

- -

{{ languages( {"en":"en/Web_development/Writing_forward-compatible_websites" } ) }}

diff --git a/files/fr/web/guide/writing_forward-compatible_websites/index.md b/files/fr/web/guide/writing_forward-compatible_websites/index.md new file mode 100644 index 0000000000..f9a62d2f43 --- /dev/null +++ b/files/fr/web/guide/writing_forward-compatible_websites/index.md @@ -0,0 +1,138 @@ +--- +title: Développer des sites à compatibilité descendante +slug: Web/Guide/Writing_forward-compatible_websites +tags: + - NeedsEditorialReview + - NeedsTechnicalReview +translation_of: Web/Guide/Writing_forward-compatible_websites +original_slug: Développement_Web/Développer_des_sites_à_compatibilité_descendante +--- +

Cette page explique comment développer des sites qui continuent de fonctionner au fur et à mesure des mises à jour des navigateurs.

+ +

C'est d'autant plus important pour les intranets et autres sites non-publics; s'il n'est pas possible de voir votre site, il ne nous est pas possible de voir s'il est cassé. Il ne nous est pas toujours possible de suivre tous les sites, mais en suivre autant que possible permet d'en assurer la pérennité.

+ +

JavaScript

+ +

Préfixez tous les accès à des variables globales dans les attributs onfoo par “window.”

+ +
Quand un attribut de gestion d'évenement (onclick, onmouseover, etc) est utilisé sur un élément HTML, toutes les résolutions de variable dans l'attribut sont d'abord résolues sur l'élément lui-même, puis sur le formulaire contenant l'élément (si c'est un élément de formulaire), puis sur document, puis finalement sur window (là où se trouvent les variables globales que vous avez définies).Par exemple, si vous avez le balisage suivant :
+ +
<div onclick="alert(ownerDocument)">Cliquez moi</div>
+ +

Alors cliquer sur le texte affichera le ownerDocument du div. Il en sera toujours ainsi, même s'il y a une var ownerDocument déclarée dans l'espace de visibilité global.

+ +

Cela signifie qu'à chaque fois que vous accédez à une variable (ou une fonction) globale dans un attribut de gestion d'évenement vous pouvez vous retrouver avec une collision de nom. Il suffit pour cela qu'une nouvelle specification ajoute une nouvelle propriété DOM aux éléments, et que cette propriété porte le même nom que votre variable ou fonction.
+ Si cela arrive, alors soudainement votre function ne sera plus appellée. Ceci est déjà arrivé de nombreuses fois à de multiples sites durant la phase d'évolution d'HTML5.

+ +

Pour éviter ce problème, qualifiez complétement vos variables globales en utilisant window., comme ceci :

+ +
<script>
+  function nomLocal() {
+    alert('La fonction nomLocal a été appellée.');
+  }
+</script>
+<div onclick="window.nomLocal()">Cliquer ici devrait faire apparaitre un message.<div>
+
+ +

Ne concatenez pas les scripts dont vous n'avez pas le contrôle.

+ +

En ECMAScript, la directive "use strict;" s'applique sur la totalité du fichier. Ainsi, ajouter un script qui dépends d'un comportement non-strict à la suite d'un script en mode strict risque fortement de générer des erreurs.

+ +

Demandez aux auteurs des bibliothèques Javascript que vous utilisez de suivre ces recommandations.

+ +

Suggérez aux développeurs de vos bibliothèques favorites de suivre ces recommendations. S'ils ne le font pas, vous n'avez pas l'assurance que la bibliothèque continue de fonctionner dans le futur. Malheureusement, les bibliothèques suivent rarement ces conseils.

+ +

Détection

+ +

Détecter des fonctionnalités particulières

+ +

Si vous avez l'intention d'utiliser une fonctionnalité en particulier, utilisez autant que possible la détection d'objet pour détecter cette fonctionnalité particulière. Par exemple, ne considérez pas que si dans un navigateur "filter" in body.style s'évalue à true, alors forcément ce navigateur doit être Internet Explorer et que donc cela signifie qu'il possède un objet window.event disponible dans les gestionnaires d'évenement. 

+ +

De manière générale, ne considérez pas que si un navigateur supporte une certaine fonctionnalité DOM, alors il doit forcément en supporter une autre, particulièrement si elle est non standard. Ou, à l'inverse, que s'il ne supporte pas une autre fonctionnalité, alors il n'en supportera pas non plus une autre. Par exemple, ce n'est pas parce qu'un navigateur supporte onload sur les éléments scripts alors cela signifie qu'il ne supportera jamais onreadystatechange sur ces mêmes éléments.

+ +

Les comportement des navigateurs convergent de plus en plus: des fonctionnalités sont ajoutées, supprimées, des bugs sont corrigés. Tout ceci arrive regulièrement et arrivera encore.

+ +

Ne cherchez donc pas à détecter une fonctionnalité ou un objet pour en déduire ensuite que parce qu'elle existe (ou non) alors telle ou telle autre fonctionnalité doit alors aussi exister (ou non).

+ +

Ne détectez pas l'agent utilisateur

+ +

Ceci est une sous-catégorie très particulière de l'exemple précédent. Il ne faut pas penser qu'une certaine fonctionnalité (la présence ou non d'une certaine chaine de caractères dans l'agent utilisateur -UA-) implique la présence ou l'absence d'autres fonctionnalités.

+ +

Si vous devez détecter l'agent utilisateur, alors ne détectez que pour les anciennes versions.

+ +

Si vous devez vraiment détecter l'agent utilisateur, alors ne l'utilisez que pour cibler des versions déjà dépassées.
+ Tout d'abord, prévoyez toujours un chemin dans votre code pour les navigateurs que vous ne connaissez pas, ainsi que pour les versions courantes et futures des navigateurs avec lesquels vous avez testé votre site. Ensuite si ce chemin par défaut ne fonctionne pas dans certaines anciennes versions de certains navigateurs et uniquement si l'erreur ne peut pas être détectée par l'absence de fonctionnalités utilisées par votre chemin par défaut, alors il est raisonnable d'ajouter des hacks qui ne ciblent que ces anciennes versions de certains navigateurs, en recourant à la détection de l'agent utilisateur.

+ +

Pour les besoins de ce conseil, considérez que "version courante" signifie la dernière version du navigateur que vous avez testé. Par exemple, si vous avez testé le chemin par défaut de votre code dans Firefox Aurora mais que Firefox Beta et les dernières versions ont un bug qui font planter votre code, alors il est raisonnable de considérer le numero de version de Aurora au moment du test comme étant la "version courante", et considérer la version Beta comme une version "ancienne", même si elle n'est pas encore sortie pour le public.

+ +

Ne créez pas de chemin de code inutile pour une multitude de navigateurs différents

+ +
N'allez pas créer trop de branches de code différentes, qui s'executent en fonction de l'agent utilisateur ou de la détection de fonctionnalité si vous avez une branche de code qui fonctionne pour tous les navigateurs. Il y a de fortes chances pour que les navigateurs convergent vers un comportement commun, ce qui risque de casser les chemins alternatifs que vous auriez créés pour tel ou tel navigateur.
+ +

Test

+ +

Tester dans les navigateurs principaux

+ +

Testez votre code au moins sous Firefox, Chrome ou Safari (vu que les deux sont basés sur le même moteur WebKit), Opera et Internet Explorer. Si vous avez suivi le conseil donné précedemment à propos de l'unique branche de code pour toutes les versions de navigateurs (connues et inconnues), tester uniquement cette unique branche de code dans tous les navigateurs rends extremement probable le fait que votre code ne cassera pas dans le futur.

+ +

Parfois, plusieurs navigateurs implementent une certaine fonctionnalité de manière légérement différente. Si vous avez une unique branche de code qui tourne dans tous les navigateurs principaux, cela signifie que vous utilisez soit des fonctionnalités pour lesquelles les navigateurs ont un comportement identiques, ou, s'ils n'ont pas encore convergé vers un seul comportement, votre code fonctionnera quelque soit le comportement final qui sera utilisé par tous.

+ +

Prefixes et fonctionnalités propres à un certain navigateur

+ +

N'utilisez pas de hack pour cibler la version actuelle ou une version future d'un navigateur

+ +

Cela reviendrai à supposer que la corrélation actuelle entre plusieurs bugs implique une future corrélation entre ces mêmes bugs. Nous avons vu que cela n'était pas le cas.

+ +

Il est par contre acceptable de cibler d'anciennes versions du navigateur si votre hack repose sur un bug présent dans les anciennes versions et corrigé dans les versions actuelles. Une fois que le bug X a été corrigé d'un navigateur, vous pouvez savoir que toutes les versions qui avaient le bug X avaient aussi le bug Y, et vous pourrez ainsi vous servir de X pour cibler des cas particuliers pour le bug Y.

+ +

Dans ce cas, on considère par "actuelles" les versions les plus récentes du navigateur que vous avez testé, comme nous l'avons déjà évoqué dans le cas de la détection de l'agent utilisateur précédemment.

+ +

Evitez de dépendre de fonctionnalités non standard ultra récentes

+ +

Même si la fonctionnalitée est préfixée, l'utiliser peut être dangereux : au fur et à mesure de l'évolution de la spécification, l'implémentation préfixée du navigateur peut évoluer pour se rapprocher de la spécification. De plus, une fois la fonctionnalité standardisée, les versions prefixées seront vraisemblablement supprimées.

+ +

Les fonctionnalités non standard, prefixées, sont fournies par les développeurs de navigateurs pour vous permettre de les expérimenter et d'offrir vos remarques en retour. Elles ne sont pas censées être déployées. Si vous choisissez de les utiliser, préparez-vous à faire des mises à jour régulières de votre site pour rester à flot avec les changements.

+ +

Lorsque vous utilisez des fonctionnalités ultra récentes (même standards) qui ne sont pas encore implémentées partout, assurez-vous de tester les solutions de secours. Assurez-vous de tester ce qu'il se passe dans un navigateur qui n'implémente pas la fonctionnalité que vous utilisez, plus particulierement si vous ne l'utilisez pas régulièrement lors de l'élaboration de votre site.

+ +

N'utilisez pas les versions préfixées des fonctionnalités, à moins de cibler les anciennes versions

+ +

Le comportement des versions préfixées des fonctionnalités peut changer dans une future version. Néanmoins, dès lors qu'un navigateur est sorti avec une fonctionnalité non-prefixée, vous pouvez utiliser la version préfixée pour cibler les anciennes versions. Assurez-vous de toujours utiliser la version non-préfixée quand celle-ci est disponible.

+ +

Voici un exemple, pour un navigateur qui utilise le préfixe -vnd en CSS et qui a sorti une version non-prefixée de la propriété rends-moi-joli, avec un comportement défini pour la valeur "parfois" qui diffère de la valeur préfixée.

+ +
<style>
+  .joli-element {
+    -vnd-rends-moi-joli: parfois;
+    rends-moi-joli: parfois;
+  }
+</style>
+
+ +

L'ordre des déclarations dans la règle précédente est important : la version non préfixée doit apparaitre en dernier.

+ +

N'utilisez pas les versions non préfixées des propriétés CSS ou des APIs tant qu'au moins un navigateur ne les ont pas implémentées

+ +

Tant que le support d'une version non préfixée d'une fonctionnalité n'est pas généralisé auprès des navigateurs, son comportement peut encore changer de manière radicale. Plus particulièrement, n'utilisez pas les versions non préfixées si aucun navigateur ne les implémente. Vous ne pouvez même pas être sûr que la syntaxe de la version finale sera la même que la syntaxe utilisée dans l'une des version préfixées.

+ +

Hygiène de code

+ +

Evitez les > manquants

+ +

Passer votre code au validateur est un bon moyen de s'assurer de cela. Mais même si votre site ne valide pas complétement, vous devriez vous assurer que tous vos caractères > sont présents.
+ S'ils manquent, cela peut vous amener à des situations où un nom de balise est interprété comme un attribut d'une balise précédente. Cela peut sembler fonctionner pendant quelques temps, mais finira par casser si une spécification future défini un sens à cet attribut. 

+ +

Voici un exemple qui fonctionne dans les navigateurs ne possédant pas le support du HTML5, mais est cassé dans un navigateur le supportant :

+ +
<form action="http://www.exemple.com">
+  <input type="submit" value="Soumettre le formulaire"
+</form>
+
+ +

à cause du > manquant sur la balise input.

+ +

Ne laissez pas de tests qui ne fonctionnent pas dans votre code

+ +

Si vous essayez d'utiliser une propriété CSS, mais que celle-ci n'a pas d'effet, supprimez-la. Elle pourrait se mettre à avoir un effet que vous n'attendiez pas du tout dans une version future.

+ +

{{ languages( {"en":"en/Web_development/Writing_forward-compatible_websites" } ) }}

-- cgit v1.2.3-54-g00ecf