From 51af369340576bee7073830bbb805103b2349b61 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sat, 19 Mar 2022 22:30:38 +0100 Subject: Remove {{page}} from Web/API - Fixes #3882 (#4480) * update audiobuffersourcenode.buffer * update audiolistener * fix svg compression * biquadfilternode * customevent * DataTransfer.clearData * DeviceOrientationEvent/absolute * Document * animate * error element * mousedown * mouseup * gainnode * Gamepad API * Geolocation API * MediaStreamAudioSourceNode * navigator.getusermedia * periodicwave * webglrenderingcontext * Various fixes/nitpicking Co-authored-by: cw118 <87150472+cw118@users.noreply.github.com> --- .../web/api/audiobuffersourcenode/buffer/index.md | 80 +- files/fr/web/api/audiolistener/index.md | 96 ++- .../api/audiolistener/webaudiolistenerreduced.svg | 1 + files/fr/web/api/biquadfilternode/index.md | 140 ++-- files/fr/web/api/customevent/index.md | 59 +- files/fr/web/api/datatransfer/cleardata/index.md | 163 ++-- .../api/deviceorientationevent/absolute/index.md | 33 +- files/fr/web/api/document/index.md | 828 +++++++++++---------- files/fr/web/api/element/animate/index.md | 78 +- files/fr/web/api/element/error_event/index.md | 144 +++- files/fr/web/api/element/mousedown_event/index.md | 34 +- files/fr/web/api/element/mouseup_event/index.md | 35 +- files/fr/web/api/gainnode/index.md | 46 +- .../api/gamepad_api/using_the_gamepad_api/index.md | 305 ++++---- files/fr/web/api/geolocation_api/index.md | 255 +------ .../fr/web/api/mediastreamaudiosourcenode/index.md | 68 +- files/fr/web/api/navigator/getusermedia/index.md | 69 +- files/fr/web/api/periodicwave/index.md | 35 +- files/fr/web/api/webglrenderingcontext/index.md | 608 ++++++++------- 19 files changed, 1475 insertions(+), 1602 deletions(-) create mode 100644 files/fr/web/api/audiolistener/webaudiolistenerreduced.svg (limited to 'files/fr') diff --git a/files/fr/web/api/audiobuffersourcenode/buffer/index.md b/files/fr/web/api/audiobuffersourcenode/buffer/index.md index 81421a685b..91ac9e346e 100644 --- a/files/fr/web/api/audiobuffersourcenode/buffer/index.md +++ b/files/fr/web/api/audiobuffersourcenode/buffer/index.md @@ -2,58 +2,90 @@ title: AudioBufferSourceNode.buffer slug: Web/API/AudioBufferSourceNode/buffer translation_of: Web/API/AudioBufferSourceNode/buffer +browser-compat: api.AudioBufferSourceNode.buffer --- -{{ APIRef("Web Audio API") }} +{{APIRef("Web Audio API")}} -La propriété **`buffer`** de l'interface {{ domxref("AudioBufferSourceNode") }} donne la possibilité de lire un son en utilisant un {{domxref("AudioBuffer")}} comme ressource audio. +La propriété **`buffer`** de l'interface [`AudioBufferSourceNode`](/fr/docs/Web/API/AudioBufferSourceNode) donne la possibilité de lire un son en utilisant un objet [`AudioBuffer`](/fr/docs/Web/API/AudioBuffer) comme ressource audio. -Si la propriété `buffer` a la valeur NULL, elle définit un canal unique silencieux (chaque échantillon vaut 0). +Si la propriété `buffer` a la valeur `null`, le nœud génère un canal unique silencieux (chaque échantillon vaut `0`). ## Syntaxe - AudioBufferSourceNode.buffer = soundBuffer; +```js +AudioBufferSourceNode.buffer = soundBuffer; +``` ### Valeur -Un {{domxref("AudioBuffer")}} qui contient les données représentant le son que le noeud va lire. +Un objet [`AudioBuffer`](/fr/docs/Web/API/AudioBuffer) qui contient les données représentant le son que le nœud va lire. ## Exemple -> **Note :** Pour un exemple complet, voir [le code interprété](http://mdn.github.io/audio-buffer/), ou [le code source](https://github.com/mdn/audio-buffer). +> **Note :** Pour un exemple complet, voir [cette démonstration](https://mdn.github.io/webaudio-examples/audio-buffer/), ou [le code source correspondant](https://github.com/mdn/webaudio-examples/blob/master/audio-buffer/index.html). ```js -var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate); +let AudioContext = window.AudioContext || window.webkitAudioContext; +let audioCtx; + +// Stereo +let channels = 2; + +function init() { + audioCtx = new AudioContext(); +} button.onclick = function() { - // Remplit le buffer avec du bruit blanc; - // valeurs aléatoires entre -1.0 et 1.0 - for (var channel = 0; channel < channels; channel++) { - // Crée le ArrayBuffer qui contient effectivement les données - var nowBuffering = myArrayBuffer.getChannelData(channel); - for (var i = 0; i < frameCount; i++) { - // Math.random() is in [0; 1.0] - // audio doit être compris entre [-1.0; 1.0] + if(!audioCtx) { + init(); + } + + // On crée un tampon stéréo vide de deux secondes + // qui utilise l'échantillonage de AudioContext + let frameCount = audioCtx.sampleRate * 2.0; + + let myArrayBuffer = audioCtx.createBuffer(channels, frameCount, audioCtx.sampleRate); + + // On remplit le buffer avec du bruit blanc ; + // soit des valeurs entre -1.0 et 1.0 + for (let channel = 0; channel < channels; channel++) { + // Voici le calcul du tableau réel qui contient + // les données + let nowBuffering = myArrayBuffer.getChannelData(channel); + for (let i = 0; i < frameCount; i++) { + // Math.random() donne une valeur sur [0; 1.0] + // audio doit être sur [-1.0; 1.0] nowBuffering[i] = Math.random() * 2 - 1; } } - // Crée un AudioBufferSourceNode. - // C'est le AudioNode à utiliser pour jouer un AudioBuffer - var source = audioCtx.createBufferSource(); - // Définit le buffer dans l'AudioBufferSourceNode + // On récupère un AudioBufferSourceNode. + // C'est l'objet AudioNode à utiliser pour lire + // un AudioBuffer + let source = audioCtx.createBufferSource(); + // on passe le buffer avec AudioBufferSourceNode source.buffer = myArrayBuffer; + // on connecte le nœud AudioBufferSourceNode à + // la destination afin d'entendre le son + source.connect(audioCtx.destination); + // on lance la lecture + source.start(); + + source.onended = () => { + console.log('Bruit blanc terminé'); + } +} ``` ## Spécifications -| Spécification | Statut | Commentaire | -| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | -| {{SpecName("Web Audio API", "#widl-AudioBufferSourceNode-buffer", "buffer")}} | {{Spec2("Web Audio API")}} | Définition initiale | +{{Specifications}} ## Compatibilité navigateurs -{{Compat("api.AudioBufferSourceNode.buffer")}} +{{Compat}} ## Voir aussi -{{page("/en-US/docs/Web/API/AudioBufferSourceNode","See_also")}} +- [Utiliser l'API Web Audio](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) +- [L'API Web Audio](/fr/docs/Web/API/Web_Audio_API) diff --git a/files/fr/web/api/audiolistener/index.md b/files/fr/web/api/audiolistener/index.md index 225e9b0519..b90ed1d32a 100644 --- a/files/fr/web/api/audiolistener/index.md +++ b/files/fr/web/api/audiolistener/index.md @@ -1,84 +1,78 @@ --- title: AudioListener slug: Web/API/AudioListener -tags: - - API - - Experimental - - Reference - - Web Audio API translation_of: Web/API/AudioListener +browser-compat: api.AudioListener --- {{APIRef("Web Audio API")}} -L'interface _AudioListener_ représente la position et l'orientation de l'unique personne écoutant la scène audio; elle est utilisée dans le cadre d'une [spatialisation audio](/en-US/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics). Tous les {{domxref ("PannerNode")}} sont spatialisés par rapport à l'objet _AudioListener_ stocké dans la propriété {{domxref ("AudioContext.listener")}}. +L'interface `AudioListener` représente la position et l'orientation de l'unique personne écoutant la scène audio ; elle est utilisée dans le cadre d'une [spatialisation audio](/fr/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics). Tous les objets [`PannerNode`](/fr/docs/Web/API/PannerNode) sont spatialisés par rapport à l'objet `AudioListener` stocké dans la propriété [`BaseAudioContext.listener`](/fr/docs/Web/API/BaseAudioContext/listener). -Il est important de noter qu'il n'y a qu'un seul auditeur par contexte, et qu'il ne s'agit pas d'un {{domxref("AudioNode")}}. +Il est important de noter qu'il n'y a qu'un seul auditeur par contexte, et qu'il ne s'agit pas d'un [`AudioNode`](/fr/docs/Web/API/AudioNode). -![On voit ici la position, les vecteurs haut et face d'un AudioListener, avec les vecteurs haut et face à 90° l'un de l'autre.](webaudiolistenerreduced.png) +![On voit ici la position, les vecteurs haut et face d'un AudioListener, avec les vecteurs haut et face à 90° l'un de l'autre.](webaudiolistenerreduced.svg) ## Propriétés -_Hérite des propriétés de son parent,_ `AudioNode`. - -> **Note :** Les valeurs de position, d'orientation, et du haut de la tête peuvent être définies et lues à l'aide de différentes syntaxes. Par exemple, l'accès se fait à l'aide de la propriété, `AudioListener.positionX`, tandis que la même propriété est définir à l'aide de `AudioListener.positionX.value`. C'est pourquoi ces valeurs ne sont pas marquées en lecture seule, bien qu'elles apparaissent comme tel dans la spécification IDL. - -- {{domxref("AudioListener.positionX")}} - - : Position de l'auditeur avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est 0. -- {{domxref("AudioListener.positionY")}} - - : Position verticale de l'auditeur avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est 0. -- {{domxref("AudioListener.positionZ")}} - - : Position longitudinale (avant et arrière) de l'auditeur avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est 0. -- {{domxref("AudioListener.forwardX")}} - - : Position horizontale de l'orientation vers l'avant de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. -- {{domxref("AudioListener.forwardY")}} - - : Position verticale de l'orientation vers l'avant de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. -- {{domxref("AudioListener.forwardZ")}} - - : Position longitudinale (avant et arrière) de l'orientation vers l'avant de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. -- {{domxref("AudioListener.upX")}} - - : Position horizontale du haut de la tête de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. -- {{domxref("AudioListener.upY")}} - - : Position verticale du haut de la tête de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. -- {{domxref("AudioListener.upZ")}} - - : Position longitudinale (avant et arrière) du haut de la tête de l'auditeur avec le même système de coordonnées cartésiennnes que les valeurs de position (`positionX`, `positionY`, and `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est 0. +> **Note :** Les valeurs de position, d'orientation, et du haut de la tête peuvent être définies et lues à l'aide de différentes syntaxes. Par exemple, l'accès se fait à l'aide de la propriété, `AudioListener.positionX`, tandis que la même propriété est définie à l'aide de `AudioListener.positionX.value`. C'est pourquoi ces valeurs ne sont pas marquées en lecture seule, bien qu'elles apparaissent comme telle dans la spécification IDL. + +- [`AudioListener.positionX`](/fr/docs/Web/API/AudioListener/positionX) + - : La position horizontale de la personne qui écoute avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est `0`. +- [`AudioListener.positionY`](/fr/docs/Web/API/AudioListener/positionY) + - : La position verticale de la personne qui écoute avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est `0`. +- [`AudioListener.positionZ`](/fr/docs/Web/API/AudioListener/positionZ) + - : La position longitudinale (avant et arrière) de la personne qui écoute avec des coordonnées cartésiennes selon la règle de la main droite. La valeur par défaut est `0`. +- [`AudioListener.forwardX`](/fr/docs/Web/API/AudioListener/forwardX) + - : La position horizontale de l'orientation vers l'avant de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `0`. +- [`AudioListener.forwardY`](/fr/docs/Web/API/AudioListener/forwardY) + - : La position verticale de l'orientation vers l'avant de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `0`. +- [`AudioListener.forwardZ`](/fr/docs/Web/API/AudioListener/forwardZ) + - : La position longitudinale (avant et arrière) de l'orientation vers l'avant de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `-1`. +- [`AudioListener.upX`](/fr/docs/Web/API/AudioListener/upX) + - : La position horizontale du haut de la tête de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `0`. +- [`AudioListener.upY`](/fr/docs/Web/API/AudioListener/upY) + - : La position verticale du haut de la tête de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `1`. +- [`AudioListener.upZ`](/fr/docs/Web/API/AudioListener/upZ) + - : La position longitudinale (avant et arrière) du haut de la tête de la personne qui écoute avec le même système de coordonnées cartésiennes que les valeurs de position (`positionX`, `positionY`, et `positionZ`). Les valeurs de direction vers l'avant et vers le haut sont indépendantes linéairement l'une de l'autre. La valeur par défaut est `0`. ## Méthodes -_Hérite des propriétés de son parent,_ `AudioNode`. +- [`AudioListener.setOrientation()`](/fr/docs/Web/API/AudioListener/setOrientation) {{deprecated_inline}} + - : Définit l'orientation de la personne qui écoute. +- [`AudioListener.setPosition()`](/fr/docs/Web/API/AudioListener/setPosition) {{deprecated_inline}} + - : Définit la position de la personne qui écoute. -- {{domxref("AudioListener.setOrientation()")}} - - : Définit l'orientation de l'auditeur. -- {{domxref("AudioListener.setPosition()")}} - - : Définit la position de l'auditeur. Consulter {{anch("Deprecated features")}} pour savoir pourquoi cette méthode est désormais obsolète. +> **Note :** Bien que ces méthodes soient dépréciées, il s'agit de l'unique façon de définir l'orientation et la position pour Firefox, Internet Explorer et Safari. -## Fonctionnalités obsolètes +## Fonctionnalités dépréciées -- {{domxref("AudioListener.dopplerFactor")}} {{obsolete_inline}} - - : Nombre flottant à double précision représentant la quantité de "pitch shift" à utiliser pour le rendu d'un [effet doppler](http://en.wikipedia.org/wiki/Doppler_effect). -- {{domxref("AudioListener.speedOfSound")}} {{obsolete_inline}} - - : Nombre flottant à double précision représentant la vitesse du son, en _mètres par seconde_. +- [`AudioListener.dopplerFactor`](/fr/docs/Web/API/AudioListener/dopplerFactor) {{deprecated_inline}} + - : Nombre flottant à double précision représentant la quantité de décalage de fréquence (pitch shift) à utiliser pour le rendu d'un [effet doppler](https://fr.wikipedia.org/wiki/Effet_Doppler). +- [`AudioListener.speedOfSound`](/fr/docs/Web/API/AudioListener/speedOfSound) {{deprecated_inline}} + - : Nombre flottant à précision double représentant la vitesse du son, en _mètres par seconde_. -Dans une version précédente de la spécification, les propriétés `dopplerFactor` et `speedOfSound` et la méthode `setPosition()` lpouvaient être utilisés pour contrôler un effet doppler appliqué à un {{domxref("AudioBufferSourceNode")}} connecté en aval - ils pouvaient être transposés en fonction de la vitesse relative du {{domxref("PannerNode")}}, et de l'{{domxref("AudioListener")}}. Ces fonctionnalités soulevaient un certain nombre de problèmes : +Dans une version précédente de la spécification, les propriétés `dopplerFactor` et `speedOfSound` et la méthode `setPosition()` pouvaient être utilisés pour contrôler un effet Doppler appliqué à un [`AudioBufferSourceNode`](/fr/docs/Web/API/AudioBufferSourceNode) connecté en aval. Ils pouvaient être transposés en fonction de la vitesse relative du [`PannerNode`](/fr/docs/Web/API/PannerNode), et de l'`AudioListener`. Ces fonctionnalités soulevaient un certain nombre de problèmes : -- Seuls les {{domxref("AudioBufferSourceNode")}} étaient transposés, pas les autres noeuds source. -- Le comportement à adopter lorsqu'un {{domxref("AudioBufferSourceNode")}} était connecté à plusieurs {{domxref("PannerNode")}} n'était pas clair. -- Comme la vélocité du panoramique et de l'auditeur n'étaient pas des {{domxref("AudioParam")}}, la modification du pitch ne pouvait pas être appliquée uniformément, ce qui provoquait des irrégularités dans le son. +- Seuls les [`AudioBufferSourceNode`](/fr/docs/Web/API/AudioBufferSourceNode) étaient transposés, pas les autres nœuds source. +- Le comportement à adopter lorsqu'un [`AudioBufferSourceNode`](/fr/docs/Web/API/AudioBufferSourceNode) était connecté à plusieurs [`PannerNode`](/fr/docs/Web/API/PannerNode) n'était pas clair. +- Comme la vélocité du panoramique et de la personne qui écoute n'étaient pas des [`AudioParam`](/fr/docs/Web/API/AudioParam), la modification du pitch ne pouvait pas être appliquée uniformément, ce qui provoquait des irrégularités dans le son. C'est la raison pour laquelle elles ont été supprimées. +Les méthodes `setOrientation()` et `setPosition()` ont été remplacées par la capacité à modifier les valeurs des propriétés correspondantes. Ainsi, `setPosition(x, y, z)` pourra être réalisé en agissant sur les propriétés `positionX.value`, `positionY.value`, et `positionZ.value`. + ## Exemples -{{page("/en-US/docs/Web/API/AudioContext.createPanner","Example")}} +Voir la page sur [`BaseAudioContext.createPanner()`](/fr/docs/Web/API/BaseAudioContext/createPanner#exemple) pour un exemple de code. ## Spécifications -| Spécification | Statut | Commentaire | -| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | -| {{SpecName('Web Audio API', '#AudioListener-section', 'AudioListener')}} | {{Spec2('Web Audio API')}} | | +{{Specifications}} -## Compatibilité navigateurs +## Compatibilité des navigateurs -{{Compat("api.AudioListener")}} +{{Compat}} ## Voir aussi -- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) +- [Utiliser l'API Web Audio](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/audiolistener/webaudiolistenerreduced.svg b/files/fr/web/api/audiolistener/webaudiolistenerreduced.svg new file mode 100644 index 0000000000..e76786336b --- /dev/null +++ b/files/fr/web/api/audiolistener/webaudiolistenerreduced.svg @@ -0,0 +1 @@ +
y
y
x
x
z
z
Le vecteur de position qui place la source
dans l'espace avec un repère cartésien
Le vecteur...
Le vecteur haut (up) qui représente la direction du haut
de la tête de la personne qui écoute
Le vecteur...
Le vecteur avant (front) qui indique la direction vers laquelle la personne fait face (où pointe son nez)
Le vect...
Les vecteurs avant et haut
sont toujours perpendiculaires
(ils forment un angle de 90°)
Les vecteu... \ No newline at end of file diff --git a/files/fr/web/api/biquadfilternode/index.md b/files/fr/web/api/biquadfilternode/index.md index e641539367..81ed1cfe1d 100644 --- a/files/fr/web/api/biquadfilternode/index.md +++ b/files/fr/web/api/biquadfilternode/index.md @@ -1,37 +1,35 @@ --- title: BiquadFilterNode slug: Web/API/BiquadFilterNode -tags: - - API - - Experimental - - Reference - - Web Audio API translation_of: Web/API/BiquadFilterNode +browser-compat: api.BiquadFilterNode --- {{APIRef("Web Audio API")}} -L'interface **`BiquadFilterNode`** représente un simple filtre de bas niveau, créé avec la méthode {{ domxref("AudioContext.createBiquadFilter()") }}. Il s'agit d'un {{domxref("AudioNode")}} qui peut représenter différents types de filtres, dispositifs de réglage de tonalité ou égaliseurs graphiques. Un `BiquadFilterNode` a toujours exactement une entrée et une sortie. +L'interface **`BiquadFilterNode`** représente un simple filtre de bas niveau, créé avec la méthode [`AudioContext.createBiquadFilter()`](/fr/docs/Web/API/AudioContext/createBiquadFilter). Il s'agit d'un objet [`AudioNode`](/fr/docs/Web/API/AudioNode) qui peut représenter différents types de filtres, dispositifs de réglage de tonalité ou égaliseurs graphiques. Un objet `BiquadFilterNode` possède toujours exactement une entrée et une sortie. + +{{InheritanceDiagram}} - + - + - + - + - + @@ -39,27 +37,27 @@ L'interface **`BiquadFilterNode`** représente un simple filtre de bas niveau, c ## Constructeur -- {{domxref("BiquadFilterNode.BiquadFilterNode", "BiquadFilterNode()")}} - - : Crée une nouvelle instance d'un objet `BiquadFilterNode`. +- [`BiquadFilterNode()`](/fr/docs/Web/API/BiquadFilterNode/BiquadFilterNode) + - : Crée une nouvelle instance d'un objet `BiquadFilterNode`. ## Propriétés -_Hérite des propriétés de son parent,_ _{{domxref("AudioNode")}}_. +_Hérite des propriétés de son parent, [`AudioNode`](/fr/docs/Web/API/AudioNode)._ -- {{domxref("BiquadFilterNode.frequency")}} - - : Est un {{domxref ("AudioParam")}} de type [a-rate](/fr/docs/Web/API/AudioParam#a-rate) : un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage, exprimée en Hertz. -- {{domxref("BiquadFilterNode.detune")}} - - : Est un {{domxref ("AudioParam")}} de type [a-rate](/fr/docs/Web/API/AudioParam#a-rate) : un nombre flottant à double précision représentant le désaccordage de la fréquence exprimé en [cents](https://fr.wikipedia.org/wiki/Cent_et_savart). -- {{domxref("BiquadFilterNode.Q")}} - - : Est un [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [a-rate](/fr/docs/Web/API/AudioParam#a-rate) : un nombre flottant à double précision représentant un [facteur Q](https://en.wikipedia.org/wiki/Q_factor), ou facteur de qualité. -- {{domxref("BiquadFilterNode.gain")}} {{readonlyInline}} - - : Est un [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [a-rate](/fr/docs/Web/API/AudioParam#a-rate) : un nombre flottant à double précision représentant le [gain](https://en.wikipedia.org/wiki/Gain) utilisé dans l'algorithme de filtrage. -- {{domxref("BiquadFilterNode.type")}} +- [`BiquadFilterNode.frequency`](/fr/docs/Web/API/BiquadFilterNode/frequency) + - : Un objet [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [`a-rate`](/fr/docs/Web/API/AudioParam#a-rate) : c'est un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage, exprimée en Hertz. +- [`BiquadFilterNode.detune`](/fr/docs/Web/API/BiquadFilterNode/detune) + - : Un objet [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [`a-rate`](/fr/docs/Web/API/AudioParam#a-rate) : c'est un nombre flottant à double précision représentant le désaccordage de la fréquence exprimée en [cents](https://fr.wikipedia.org/wiki/Cent_et_savart). +- [`BiquadFilterNode.Q`](/fr/docs/Web/API/BiquadFilterNode/Q) + - : Un objet [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [`a-rate`](/fr/docs/Web/API/AudioParam#a-rate) : c'est un nombre flottant à double précision représentant un [facteur de qualité](https://en.wikipedia.org/wiki/Q_factor). +- [`BiquadFilterNode.gain`](/fr/docs/Web/API/BiquadFilterNode/gain) {{readonlyInline}} + - : Un objet [`AudioParam`](/fr/docs/Web/API/AudioParam) de type [`a-rate`](/fr/docs/Web/API/AudioParam#a-rate) : c'est un nombre flottant à double précision représentant le [gain](https://fr.wikipedia.org/wiki/Gain_(électronique)) utilisé dans l'algorithme de filtrage. +- [`BiquadFilterNode.type`](/fr/docs/Web/API/BiquadFilterNode/type) - - : Une chaîne définissant le type d'algorithme de filtrage que le noeud implémente: La signification des paramètres diffère en fonction du type du filtre (sauf detune qui a la même signification dans tous les cas, et n'est donc pas listé ci-dessous) + - : Une chaîne de caractères définissant le type d'algorithme de filtrage que le nœud implémente.
Nombre d'entréesNombre d'entrées 1
Nombre de sortiesNombre de sorties 1
Mode de comptage des canauxMode de comptage des canaux "max"
Nombre de canauxNombre de canaux 2 (pas utilisés dans le mode de comptage par défaut)
Interprétation du canalInterprétation du canal "speakers"
- + @@ -73,127 +71,97 @@ _Hérite des propriétés de son parent,_ _{{domxref("AudioNode")}}_. - @@ -202,25 +170,23 @@ _Hérite des propriétés de son parent,_ _{{domxref("AudioNode")}}_. ## Méthodes -_Hérite des propriétés de son parent,_ _{{domxref("AudioNode")}}_. +_Hérite des propriétés de son parent, [`AudioNode`](/fr/docs/Web/API/AudioNode)._ -- {{domxref("BiquadFilterNode.getFrequencyResponse()")}} - - : A partir des valeurs courantes des paramètres de filtre, calcule la fréquence de réponse pour des fréquences spécifiées dans le tableau de fréquences _frequencyHz_ passé en paramètre. +- [`BiquadFilterNode.getFrequencyResponse()`](/fr/docs/Web/API/BiquadFilterNode/getFrequencyResponse) + - : À partir des valeurs courantes des paramètres de filtre, calcule la fréquence de réponse pour des fréquences spécifiées dans le tableau de fréquences `frequencyHz` passé en paramètre. ## Exemples -{{page("/fr/docs/Web/API/AudioContext.createBiquadFilter","Example")}} +Voir la page [`AudioContext.createBiquadFilter`](/fr/docs/Web/API/BaseAudioContext/createBiquadFilter#exemple) pour un exemple de code illustrant comment utiliser un objet `AudioContext` afin de créer un nœud de filtre. -## Spécification +## Spécifications -| Spécification | Statut | Commentaire | -| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------- | -| {{SpecName('Web Audio API', '#BiquadFilterNode-section', 'BiquadFilterNode')}} | {{Spec2('Web Audio API')}} | | +{{Specifications}} -## Compatibilité navigateurs +## Compatibilité des navigateurs -{{Compat("api.BiquadFilterNode")}} +{{Compat}} ## Voir aussi -- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) +- [Utiliser l'API Web Audio](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/customevent/index.md b/files/fr/web/api/customevent/index.md index e99ca8a535..69d2afb2d8 100644 --- a/files/fr/web/api/customevent/index.md +++ b/files/fr/web/api/customevent/index.md @@ -1,72 +1,45 @@ --- title: CustomEvent slug: Web/API/CustomEvent -tags: - - API - - DOM - - Interface - - Reference - - évènements translation_of: Web/API/CustomEvent +browser-compat: api.CustomEvent --- {{APIRef("DOM")}} -Les interfaces `CustomEvent` DOM sont des évènements initialisés par une application pour n'importe quel usage. +L'interface **`CustomEvent`** représente un évènement initialisé par une application dans un but quelconque. {{AvailableInWorkers}} +{{InheritanceDiagram}} + ## Constructeur -- {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}} - - : Crée un `CustomEvent.` +- [`CustomEvent()`](/fr/docs/Web/API/CustomEvent/CustomEvent) + - : Crée un nouvel objet `CustomEvent`. ## Propriétés -- {{domxref("CustomEvent.detail")}} {{readonlyinline}} - - : Toute donnée transmise lors de l'initialisation de l'événement. - -Cette interface hérite des propriétés de son parent {{domxref("Event")}}: +_Cette interface hérite des propriétés de son parent, [`Event`](/fr/docs/Web/API/Event)._ -{{Page("/fr/docs/Web/API/Event", "Propriétés")}} +- [`CustomEvent.detail`](/fr/docs/Web/API/CustomEvent/detail) {{readonlyinline}} + - : Renvoie toutes les données passées lor de l'initialisation de l'évènement. ## Méthodes -- {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}} - - : Initialise un objet CustomEvent. Si l'événement a déjà été distribué, cette méthode ne fait rien. +_Cette interface hérite des propriétés de son parent, [`Event`](/fr/docs/Web/API/Event)._ -Cette interface hérite les méthodes de son parent {{domxref("Event")}}: - -{{Page("/fr/docs/Web/API/Event", "Méthodes")}} +- [`CustomEvent.initCustomEvent()`](/fr/docs/Web/API/CustomEvent/initCustomEvent) {{deprecated_inline}} + - : Initialise un objet `CustomEvent`. Si l'évènement a déjà été diffusé, cette méthode n'a aucun effet. ## Spécifications -| Spécification | Statut | Commentaire | -| ---------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | -| {{SpecName('DOM WHATWG','#interface-customevent','CustomEvent')}} | {{Spec2('DOM WHATWG')}} | Définition initial | +{{Specifications}} ## Compatibilité des navigateurs -{{Compat("api.CustomEvent")}} - -## Déclenchement à partir de code privilégié vers du code non-privilégié - -Lors du déclenchement d'un CustomEvent depuis du code privilégié (une extension, par exemple) vers du code non-privilégié (une page web par exemple), vous devez prendre en considération la sécurité. Firefox et les autres applications Gecko empêchent qu'un objet créé dans un contexte soit utilisé dans un autre, ce qui empêchera généralement les failles de sécurité, mais ces restrictions peuvent aussi empêcher votre code de s'executer comme prévu. - -Lors de la création d'un objet CustomEvent, vous devez créer l'objet à partir de la même [fenêtre](/fr/docs/Mozilla/Tech/XUL/window) que celle où vous déclencherez l'évenement. - -```js -// doc est une référence au contenu du document -function dispatchCustomEvent(doc) { - var eventDetail = Components.utils.cloneInto({foo: 'bar'}, doc.defaultView); - var myEvent = doc.defaultView.CustomEvent("mytype", eventDetail); - doc.dispatchEvent(myEvent); -} -``` - -Notez qu'exposer une fonction permettra au script de l'exécuter avec les privilèges qu'accorde Chrome ce qui peut ouvrir une faille de sécurité. +{{Compat}} ## Voir aussi -- [Interaction entre pages privilégiées et non-privilégiées](/fr/docs/Extraits_de_code/Interaction_entre_des_pages_%C3%A0_privil%C3%A8ges_et_sans_privil%C3%A8ges) -- [Window.postMessage](/fr/docs/Web/API/Window/postMessage) -- [Création et déclenchement d'événements](/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events) +- [`Window.postMessage()`](/fr/docs/Web/API/Window/postMessage) +- [Créer et déclencher des évènements](/fr/docs/Web/Events/Creating_and_triggering_events) diff --git a/files/fr/web/api/datatransfer/cleardata/index.md b/files/fr/web/api/datatransfer/cleardata/index.md index 020ef1466b..0d107fa619 100644 --- a/files/fr/web/api/datatransfer/cleardata/index.md +++ b/files/fr/web/api/datatransfer/cleardata/index.md @@ -1,46 +1,45 @@ --- title: DataTransfer.clearData() slug: Web/API/DataTransfer/clearData -tags: - - API - - HTML DOM - - Method - - Reference - - drag and drop translation_of: Web/API/DataTransfer/clearData +browser-compat: api.DataTransfer.clearData --- {{APIRef("HTML Drag and Drop API")}} -La méthode DataTransfer.clearData() retire l'opération de {{domxref("DataTransfer","glisser-déposer")}} pour le format donné. Si la donnée pour le format ciblé n'existe pas, cette méthode n'aura aucun effet. +La méthode **`DataTransfer.clearData()`** retire les données du type indiqué de l'opération de glisser-déposer. S'il n'existe pas de données pour le type indiqué, cette méthode n'a aucun effet. -> **Note :** Si cette méthode est appelée sans argument, ou que le format donné est une {{domxref("DOMString","chaîne de caractères")}} vide, les données de tous les formats seront retirées. +Si cette méthode est appelée sans argument ou que le format est une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) vide, la suppression des données concernera tous les types. -## Syntaxe +Cette méthode _ne retire pas_ les fichiers de l'opération de glisser-déposer et il est donc possible d'avoir un élément restant avec le type `Files` dans la liste [`DataTransfer.types`](/fr/docs/Web/API/DataTransfer/types) si des fichiers font partie du glisser-déposer. - void dataTransfer.clearData([format]); +> **Note :** Cette méthode peut uniquement être utilisée dans le gestionnaire d'évènement pour [`dragstart`](/fr/docs/Web/API/Document/dragstart_event), car c'est le seul moment où le magasin de données pour l'opération de glisser-déposer est accessible en écriture. -### Paramètres +## Syntaxe -- format{{optional_inline}} - - : Une {{domxref("DOMString","chaîne de caractères")}} représentant le format de donnée à retirer. +```js +DataTransfer.clearData([format]); +``` -### Valeur de retour +### Paramètres -Void. +- `format` {{optional_inline}} + - : Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) qui indique le type de données à retirer. Si ce paramètre est une chaîne vide ou qu'il n'est pas fourni, les données pour l'ensemble des types seront retirées. ## Exemple -Cette exemple illustre l'utilisation des méthodes {{domxref("DataTransfer.getData()","getData()")}}, {{domxref("DataTransfer.setData()","setData()")}} et {{domxref("DataTransfer.clearData()","clearData()")}} de l'objet {{domxref("DataTransfer")}}. +Cet exemple illustre l'utilisation des méthodes +[`getData()`](/fr/docs/Web/API/DataTransfer/getData), +[`setData()`](/fr/docs/Web/API/DataTransfer/setData) et `clearData()` de l'objet [`DataTransfer`](/fr/docs/Web/API/DataTransfer). ### HTML ```html - Sélectionnez cet élément, glissez-le et déposez-le dans la Zone de Dépose pour le déplacer. + Sélectionnez cet élément, glissez-le dans la zone de dépôt puis relâcher la sélection pour déplacer l'élément. -Zone de Dépose -
Status: Glissez pour démarrer
-
Data is: non initialisé
+Zone de dépôt +
État : Glisser pour démarrer
+
Données : non-initialisée
``` ### CSS @@ -66,101 +65,113 @@ span.tweaked { ```js window.addEventListener('DOMContentLoaded', function () { - // Séléctionner les éléments HTML - var draggable = document.getElementById('source') - var dropable = document.getElementById('target') - var status = document.getElementById('status') - var data = document.getElementById('data') - var dropped = false - - // Enregistrer les évènements - draggable.addEventListener('dragstart', dragStartHandler) - draggable.addEventListener('dragend', dragEndHandler) - dropable.addEventListener('dragover', dragOverHandler) - dropable.addEventListener('dragleave', dragLeaveHandler) - dropable.addEventListener('drop', dropHandler) + // On sélectionne les éléments HTML + let draggable = document.getElementById('source'); + let droppable = document.getElementById('target'); + let status = document.getElementById('status'); + let data = document.getElementById('data'); + let dropped = false; + + // On enregistre les gestionnaires d'évènements + draggable.addEventListener('dragstart', dragStartHandler); + draggable.addEventListener('dragend', dragEndHandler); + droppable.addEventListener('dragover', dragOverHandler); + droppable.addEventListener('dragleave', dragLeaveHandler); + droppable.addEventListener('drop', dropHandler); function dragStartHandler (event) { - status.innerHTML = 'Glisse en cours' + status.textContent = 'Glisser-déposer en cours'; + + // On change la bordure de l'élément cible pour + // indiquer que le glisser-déposer a démarré + event.currentTarget.style.border = '1px dashed blue'; + + // On commence par nettoyer les presse-papiers + // existants. Cela porte sur tous les types vu qu'on + // ne passe pas de type en argument. - // Modifier la bordure de l'élément pour indiquer qu'une opération de glisse a démarré - event.currentTarget.style.border = '1px dashed blue' + event.dataTransfer.clearData(); - // Définir le type et la donnée associée à l'opération de glisse (utilise l'ID de la cible de l'évènement pour la donnée) - event.dataTransfer.setData('text/plain', event.target.id) + // On définit le format et les données pour l'opération + // on utilise l'identifiant de la cible d'évènement comme + // donnée + event.dataTransfer.setData('text/plain', event.target.id); - data.innerHTML = event.dataTransfer.getData('text/plain') + data.textContent = event.dataTransfer.getData('text/plain'); } function dragEndHandler (event) { if (!dropped) { - status.innerHTML = 'Glisse annulée' + status.textContent = 'Glisser-déposer annulé'; } - data.innerHTML = event.dataTransfer.getData('text/plain') || 'vide' + data.textContent = event.dataTransfer.getData('text/plain') || 'vide'; - // Modifier la bordure de l'élément pour indiquer que l'opération de glisse n'est plus en cours - event.currentTarget.style.border = '1px solid black' + // On change la bordure afin d'indiquer que le glisser- + // déposer n'est plus en cours + event.currentTarget.style.border = '1px solid black'; if (dropped) { - // Retirer tous les évènements enregistrés précédemment - draggable.removeEventListener('dragstart', dragStartHandler) - draggable.removeEventListener('dragend', dragEndHandler) - dropable.removeEventListener('dragover', dragOverHandler) - dropable.removeEventListener('dragleave', dragLeaveHandler) - dropable.removeEventListener('drop', dropHandler) + // On retire les gestionnaires d'évènements + draggable.removeEventListener('dragstart', dragStartHandler); + draggable.removeEventListener('dragend', dragEndHandler); + droppable.removeEventListener('dragover', dragOverHandler); + droppable.removeEventListener('dragleave', dragLeaveHandler); + droppable.removeEventListener('drop', dropHandler); } } function dragOverHandler (event) { - status.innerHTML = 'Dépose disponible' + status.textContent = 'Dépôt disponible'; - event.preventDefault() + event.preventDefault(); } function dragLeaveHandler (event) { - status.innerHTML = 'Glisse en cours (la dépose était disponible)' + status.textContent = 'Glisser-déposer en cours (le dépôt était disponible)'; - event.preventDefault() + event.preventDefault(); } function dropHandler (event) { - dropped = true + dropped = true; - status.innerHTML = 'Dépose effectuée' + status.textContent = 'Dépôt effectué'; - event.preventDefault() + event.preventDefault(); - // Récupérer la donnée liée au type « text/plain » - var _data = event.dataTransfer.getData('text/plain') - var element = document.getElementById(_data) + // On récupère les données liées à l'évènement + // et qui sont au format « text » + let _data = event.dataTransfer.getData('text/plain'); + let element = document.getElementById(_data); - // Insérer l'élément source de l'opération de glisse en tant que dernier enfant de l'élément cible de l'opération de dépose - event.target.appendChild(element) + // On ajoute l'élément source glissé à l'élément qui + // est la cible de l'évènement + event.target.appendChild(element); - // Modifier les styles CSS et le texte affiché - element.style.cssText = 'border: 1px solid black;display: block; color: red' - element.innerHTML = "J'suis dans la Zone de Dépose !" - - // Effacer les données de TOUS les types liés à l'opération de glisse (car on n'a pas donné de paramètre) - event.dataTransfer.clearData() + // On modifie les styles CSS et le texte affiché + element.style.cssText = 'border: 1px solid black;display: block; color: red'; + element.textContent = 'Je suis dans la zone de dépôt !'; } }) ``` -{{EmbedLiveSample('Exemple', 300, 250)}} +### Résultat + +{{EmbedLiveSample('', 300, 280)}} ## Spécifications -| Spécification | Statut | Commentaire | -| ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | -| {{SpecName('HTML WHATWG', 'interaction.html#dom-datatransfer-cleardata','DataTransfer.clearData()')}} | {{Spec2('HTML WHATWG')}} | | -| {{SpecName('HTML5.1', 'editing.html#dom-datatransfer-cleardata','DataTransfer.clearData()')}} | {{Spec2('HTML5.1')}} | Définition initiale | +{{Specifications}} -## Compatibilité +## Compatibilité des navigateurs -{{Compat("api.DataTransfer.clearData")}} +{{Compat}} -## À voir également +## Voir aussi -{{page("/fr/docs/Web/API/DataTransfer", "See also")}} +- [L'API Drag and drop pour le glisser-déposer](/fr/docs/Web/API/HTML_Drag_and_Drop_API) +- [Les opérations de glisser-déposer](/fr/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations) +- [Types de données pour le glisser-déposer](/fr/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types) +- [Glisser-déposer plusieurs objets](/fr/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items) +- [Test `DataTransfer` — Coller ou glisser ?](https://codepen.io/tech_query/pen/MqGgap) diff --git a/files/fr/web/api/deviceorientationevent/absolute/index.md b/files/fr/web/api/deviceorientationevent/absolute/index.md index aee893522d..7cd7872202 100644 --- a/files/fr/web/api/deviceorientationevent/absolute/index.md +++ b/files/fr/web/api/deviceorientationevent/absolute/index.md @@ -3,35 +3,32 @@ title: DeviceOrientationEvent.absolute slug: Web/API/DeviceOrientationEvent/absolute translation_of: Web/API/DeviceOrientationEvent/absolute original_slug: Web/API/DeviceOrientationEvent.absolute +browser-compat: api.DeviceOrientationEvent.absolute --- -{{ ApiRef() }} +{{APIRef("Device Orientation Events")}} -Indique si l'appareil partage des données en référentiel absolut c'est à dire sur avec des cordonnées issu du référentiel terrestre, ou si il partage des données utilisant un référentiel arbitraire déterminé par l'appareil. Voir [Orientation et mouvement expliqué](/en/DOM/Orientation_and_motion_data_explained) pour plus de détails. +Cette propriété indique si l'appareil fournit des données d'orientation dans un repère absolu (utilisant les coordonnées par rapport à la Terre) ou s'il utilise un repère arbitraire propre. Voir [le guide sur les données d'orientation et de déplacement](/fr/docs/Web/Events/Orientation_and_motion_data_explained) pour plus de détails. ## Syntaxe - var absolute = instanceOfDeviceOrientationEvent.absolute; +```js +let absolute = instanceOfDeviceOrientationEvent.absolute; +``` -`DeviceOrientationEvent.absolute` retourne un booléen : - -- `true` : si les données d'orientation dans `instanceOfDeviceOrientationEvent` est proposer dans un référentiel terrestre. -- `false` : si les données d'orientation utilisent un référentiel arbitraire. +_`absolute`_ vaut `true` si les données d'orientation fournies par l'évènement `instanceOfDeviceOrientationEvent` sont fournies comme la différence entre l'orientation de l'appareil et celle du repère terrestre ou `false` si les données d'orientation sont fournies relativement à un repère arbitraire fixé par l'appareil. ## Spécifications -| Spécification | Statuts | Commentaires | -| -------------------------------------------- | ---------------------------------------- | ---------------------- | -| {{SpecName('Device Orientation')}} | {{Spec2('Device Orientation')}} | Initial specification. | +{{Specifications}} -## Compatibilité entre les navigateurs +## Compatibilité des navigateurs -{{ page("/en-US/docs/Web/API/DeviceOrientationEvent","Browser_compatibility") }} +{{Compat}} ## Voir aussi -- {{ domxref("DeviceOrientationEvent") }} -- [Detecting device orientation](/en/Detecting_device_orientation) -- [Orientation and motion data explained](/en/DOM/Orientation_and_motion_data_explained) -- {{ domxref("window.ondeviceorientation") }} - -{{ event("deviceorientation") }} +- [`DeviceOrientationEvent`](/fr/docs/Web/API/DeviceOrientationEvent) +- [Détecter l'orientation d'un appareil](/fr/docs/Web/Events/Detecting_device_orientation) +- [Guide sur les données d'orientation et de déplacement](/fr/docs/Web/Events/Orientation_and_motion_data_explained) +- L'évènement [`window.ondeviceorientation`](/fr/docs/Web/API/Window/ondeviceorientation) +- [`deviceorientation`](/fr/docs/Web/API/Window/deviceorientation_event) diff --git a/files/fr/web/api/document/index.md b/files/fr/web/api/document/index.md index 24e4cf5f7d..f3d67b48de 100644 --- a/files/fr/web/api/document/index.md +++ b/files/fr/web/api/document/index.md @@ -1,410 +1,466 @@ --- -title: document +title: Document slug: Web/API/Document -tags: - - API - - DOM - - Document - - Interface - - Reference translation_of: Web/API/Document +browser-compat: api.Document --- -{{ApiRef}} +{{APIRef("DOM")}} -L'interface **`Document`** représente n'importe quelle page Web chargée dans le navigateur et sert de point d'entrée dans le contenu de la page Web, qui est l'arborescence DOM. L'arborescence DOM inclut des éléments tels que {{HTMLElement ("body")}} _(corps)_ et {{HTMLElement ("table")}} _(tableau)_, parmi beaucoup d'autres. Il fournit des fonctionnalités globales au document, comme le moyen d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document. +L'interface **`Document`** représente n'importe quelle page web chargée dans le navigateur et sert de point d'entrée pour accéder au contenu de la page qui est formé par [l'arbre du DOM](/fr/docs/Web/API/Document_object_model/Using_the_W3C_DOM_Level_1_Core). -{{inheritanceDiagram}} +L'arbre du DOM inclut les éléments tels que [``](/fr/docs/Web/HTML/Element/body), [`
La signification des paramètres diffère en fonction du type du filtre (sauf detune qui a la même signification dans tous les cas, et n'est donc pas listé ci-dessous)
type
lowpass - Filtre standard passe-bas résonnant de second ordre avec atténuation de - 12dB/octave. Les fréquences inférieures au seuil sont inchangées; les - fréquences supérieures sont atténuées. + Filtre standard passe-bas résonnant de second ordre avec atténuation de 12dB/octave. Les fréquences inférieures au seuil sont inchangées ; les fréquences supérieures sont atténuées. La fréquence de coupure - Indique comment la fréquence a culminé autour de la coupure. Plus la - valeur est élevée, plus le point culminant est haut + Indique comment la fréquence a culminé autour de la coupure. Plus la valeur est élevée, plus le point culminant est haut. Non utilisé
highpass - Filtre standard passe-haut résonnant de second ordre avec atténuation de - 12dB/octave. Les fréquences inférieures à la fréquence de coupure sont - atténuées, les fréquences supérieures sont inchangées. + Filtre standard passe-haut résonnant de second ordre avec atténuation de 12dB/octave. Les fréquences inférieures à la fréquence de coupure sont atténuées, les fréquences supérieures sont inchangées. La fréquence de coupure - Indique comment la fréquence a culminé autour de la coupure. Plus la - valeur est élevée, plus le point culminant est haut + Indique comment la fréquence a culminé autour de la coupure. Plus la valeur est élevée, plus le point culminant est haut. Non utilisé
bandpass - Filtre standard passe-bande de second ordre. Les fréquences en dehors de - la plage donnée de fréquences sont atténués, et les fréquences à - l'intérieur sont inchangées. + Filtre standard passe-bande de second ordre. Les fréquences en dehors de la plage donnée de fréquences sont atténués, et les fréquences à l'intérieur sont inchangées. Le centre de la gamme de fréquences. - Contrôle la largeur de la bande de fréquences. Plus Q est grande, plus - la bande de fréquences est grande. + Contrôle la largeur de la bande de fréquences. Plus Q est grande, plus la bande de fréquences est grande. Non utilisé
lowshelf - Filtre standard de dégradé de basses fréquences de second ordre. Les - fréquences inférieures à la fréquence obtiennent une impulsion ou une - atténuation; Les fréquences supérieurs sont inchangées. + Filtre standard de dégradé de basses fréquences de second ordre. Les fréquences inférieures à la fréquence obtiennent une impulsion ou une atténuation ; les fréquences supérieures sont inchangées. - La limite supérieure des fréquences obtenant une impulsion ou une - atténuation + La limite supérieure des fréquences obtenant une impulsion ou une atténuation. Non utilisé - L'impulsion, en dB, à appliquer; s'il est négatif, ce sera une - atténuation. + L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
highshelf - Filtre standard de dégradé de hautes fréquences de second ordre. Les - fréquences supérieures à la fréquence obtiennent une impulsion, ou une - atténuation; Les fréquences inférieurs restent inchangées + Filtre standard de dégradé de hautes fréquences de second ordre. Les fréquences supérieures à la fréquence obtiennent une impulsion, ou une atténuation ; les fréquences inférieures restent inchangées. - La limite inférieure des fréquences obtenant une impulsion ou une - atténuation + La limite inférieure des fréquences obtenant une impulsion ou une atténuation. Non utilisé - L'impulsion, en dB, à appliquer; s'il est négatif, ce sera une - atténuation. + L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
peaking - Les fréquences à l'intérieur de la gamme obtiennent une impulsion ou une - atténuation; les fréquences en dehors de celle-ci sont inchangées. + Les fréquences à l'intérieur de la gamme obtiennent une impulsion ou une atténuation ; les fréquences en dehors de celle-ci sont inchangées. - Le milieu de la gamme de fréquences obtiennent une impulsion, ou un - attenuation + Le milieu de la gamme de fréquences obtiennent une impulsion, ou une atténuation. - Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus - grande est la bande de fréquences. + Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus grande est la bande de fréquences. - L'impulsion, en dB, à appliquer; s'il est négatif, ce sera une - atténuation. + L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
notch - Filtre coupe standard, appelé aussi coupe-bande. C'est l'inverse d'un - filtre passe-bande: les fréquences en dehors de la gamme de fréquences - donnée sont inchangées; les fréquences à l'intérieur de celle-ci sont - atténuées. + Filtre coupe standard, appelé aussi coupe-bande. C'est l'inverse d'un filtre passe-bande : les fréquences en dehors de la gamme de fréquences donnée sont inchangées ; les fréquences à l'intérieur de celle-ci sont atténuées. Le centre de la gamme de fréquences. - Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus - grande est la bande de fréquences. + Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus grande est la bande de fréquences. Non utilisé
allpass - Filtre standard passe-tout du second ordre. Laisse toutes les fréquences - inchangées, mais modifie le rapport de phase entre les différentes - fréquences. + Filtre standard passe-tout du second ordre. Laisse toutes les fréquences inchangées, mais modifie le rapport de phase entre les différentes fréquences. - La fréquence du retard de groupe maximal, qui est la fréquence à - laquelle le centre de la transition de phase se produit. + La fréquence du retard de groupe maximal, qui est la fréquence à laquelle le centre de la transition de phase se produit. - Contrôle finement la transition à la fréquence moyenne. Plus ce - paramètre est grand, plus la transition est fine et large. + Contrôle finement la transition à la fréquence moyenne. Plus ce paramètre est grand, plus la transition est fine et large. Non utilisé
`](/fr/docs/Web/HTML/Element/table) et [tous les autres](/fr/docs/Web/HTML/Element) présents dans la page. Il fournit des fonctionnalités à l'ensemble du document et permet, par exemple, d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document. -L'interface Document décrit les propriétés et méthodes communes à tout type de document. En fonction du type de document (HTML, XML, SVG, ...), une API plus grande est disponible : les documents HTML, servis avec le type `text/html`, implémentent également l'interface {{domxref ("HTMLDocument")}}, alors que les documents XML et SVG implémentent l'interface {{domxref ("XMLDocument")}}. +{{InheritanceDiagram}} + +L'interface `Document` décrit les propriétés et méthodes communes à toutes sortes de documents. Selon le type de document (par exemple [HTML](/fr/docs/Web/HTML), [XML](/fr/docs/Web/XML), SVG, etc.), une API plus grande pourra être disponible. Ainsi, les documents HTML, servis avec le type de contenu `text/html` implémenteront également l'interface [`HTMLDocument`](/fr/docs/Web/API/HTMLDocument) tandis que les documents XML et SVG implémenteront l'interface [`XMLDocument`](/fr/docs/Web/API/XMLDocument). ## Constructeur -- {{domxref("Document.Document","Document()")}}{{non-standard_inline}} - - : crée un nouvel objet `Document` . +- [`Document()`](/fr/docs/Web/API/Document/Document) + - : Crée un nouvel objet `Document`. ## Propriétés -_Cette interface hérite aussi des interfaces {{domxref("Node")}} et {{domxref("EventTarget")}} ._ - -- {{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}} - - : fournit un accès à tous les éléments du document. C'est une interface héritée non standard qui ne doit pas être utilisée. - - - -- {{domxref("Document.async")}} {{Deprecated_inline}} - - : utilisé avec {{domxref("document.load")}} pour indiquer une requête asynchrone. - - - -- {{domxref("Document.characterSet")}} {{readonlyinline}} {{Deprecated_inline}} - - : renvoie le jeu de caractères utilisé par le document. - - - -- {{domxref("Document.compatMode")}} {{readonlyinline}} {{experimental_inline}} - - : indique si le document est rendu en mode _Quirks_ ou _Strict_. - - - -- {{domxref("Document.contentType")}} {{readonlyinline}} {{experimental_inline}} - - : Renvoie le type de contenu de l'en-tête MIME du document courant. - - - -- {{domxref("Document.doctype")}} {{readonlyinline}} - - : Renvoie le DTD (Document Type Definition) du document courant. - - - -- {{domxref("Document.documentElement")}} {{readonlyinline}} - - : Renvoie l'{{domxref("Element")}} qui est l'enfant direct du document. Pour les documents HTML, il s'agit normalement de l'élément {{HTMLElement("HTML")}}. -- {{domxref("Document.documentURI")}} {{readonlyinline}} - - : retroune l'emplacement du document sous la forme d'une chaîne de caractères. -- {{domxref("Document.domConfig")}} {{Deprecated_inline}} - - : devrait retourner un objet {{domxref("DOMConfiguration")}} . -- {{domxref("Document.fullscreen")}} {{obsolete_inline}} - - : `true` _(vrai)_ quand le document est en {{domxref("Using_full-screen_mode","mode plein écran")}}. -- {{domxref("Document.hidden")}} {{readonlyinline}} - - : ... -- {{domxref("Document.implementation")}} {{readonlyinline}} - - : Renvoie l'implémentation DOM associée au document courant. -- {{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}} - - : alias de {{domxref("Document.characterSet")}}. Utilisez cette propriété à la place. -- {{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}} - - : retourne le nom de l'ensemble de feuilles de style qui a été activé en dernier. A la valeur `null` jusqu'à ce que la feuille de style soit modifiée en définissant la valeur de {{domxref("document.selectedStyleSheetSet","selectedStyleSheetSet")}}. -- {{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}} - - : retourne un {{jsxref("Boolean")}} qui est `true` _(vrai)_ seulement si le document est synthétique, tel qu'une image autonome, une vidéo, un fichier audio ou similaire. -- {{domxref("Document.mozFullScreenElement")}} {{readonlyinline}} {{non-standard_inline}} - - : L'élément qui est actuellement affiché en mode plein écran pour ce document. -- {{domxref("Document.mozFullScreenEnabled")}} {{readonlyinline}} {{non-standard_inline}} - - : `true` _(vrai)_ si l'appel {{domxref("Element.mozRequestFullscreen()")}} est réussi dans le document courant. -- {{domxref("Document.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}} - - : renvoie l'ensemble d'éléments en tant que cible pour les événements de la souris lorsque le pointeur est verrouillé. `null` si le verrouillage est en attente, le pointeur est déverrouillé ou la cible se trouve dans un autre document. -- {{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}} - - : renvoie la page de style préférée spécifiée par l'auteur de la page. -- {{domxref("Document.scrollingElement")}} {{experimental_inline}} {{readonlyinline}} - - : retourne une référence à l'{{domxref("Element")}} qui fait défiler le document. -- {{domxref("Document.selectedStyleSheetSet")}} - - : renvoie la feuille de style actuellement utilisée. -- {{domxref("Document.styleSheets")}} {{readonlyinline}} - - : Renvoie une liste de tous les objets {{domxref("stylesheet")}} _(feuilles de styles)_ du document courant. -- {{domxref("Document.timeline")}} {{readonlyinline}} - - : ... -- {{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}} - - : ... -- {{domxref("Document.visibilityState")}} {{readonlyinline}} - - : renvoie une `string` _(chaîne de caractères)_ indiquant l'état de visibilité du document. Les valeurs possibles sont `visible` , `hidden (masqué)` , prerender _(pré-rendu)_ et `unloaded` (_déchargées_). -- {{domxref("Document.xmlEncoding")}} {{Deprecated_inline}} - - : retourne le codage déterminé par une déclaration XML. -- {{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}} - - : renvoie `true` si la déclaration XML précise que le document doit être autonome (par exemple, une partie externe de la DTD du contenu du document), sinon `false` _(faux)_. -- {{domxref("Document.xmlVersion")}} {{obsolete_inline("10.0")}} - - : retourne le numéro de la version spécifié dans la déclaration XML ou `"1.0"` si la déclaration est absente. - -L'interface Document est étendue avec l'interface {{domxref("ParentNode")}} : - -{{page("/fr/docs/Web/API/ParentNode","Propriétés")}} - -### Extensions du document HTML - -L'interface Document, pour les documents HTML, hérite de l'interface *{{domxref("HTMLDocument")}}* ou depuis HTML5, est étendue pour eux. - -- {{domxref("Document.activeElement")}} {{readonlyinline}} - - : Renvoie l'élément courant qui a la focus. -- {{domxref("Document.alinkColor")}} {{Deprecated_inline}} - - : Renvoie ou définit la couleur des liens actifs du corps du document. -- {{domxref("Document.anchors")}} +_Cette interface hérite également des interfaces [`Node`](/fr/docs/Web/API/Node) et [`EventTarget`](/fr/docs/Web/API/EventTarget)._ + +- [`Document.activeElement`](/fr/docs/Web/API/Document/activeElement) {{ReadOnlyInline}} + - : Renvoie l'objet [`Element`](/fr/docs/Web/API/Element) correspondant à l'élément qui possède le focus. +- [`Document.body`](/fr/docs/Web/API/Document/body) + - : Renvoie le nœud [``](/fr/docs/Web/HTML/Element/body) ou [``](/fr/docs/Web/HTML/Element/frameset) du document courant. +- [`Document.characterSet`](/fr/docs/Web/API/Document/characterSet) {{ReadOnlyInline}} + - : Renvoie le jeu de caractères utilisé par le document. +- [`Document.childElementCount`](/fr/docs/Web/API/Document/childElementCount) {{readonlyInline}} + - : Renvoie le nombre d'éléments enfants pour le document courant. +- [`Document.children`](/fr/docs/Web/API/Document/children) {{readonlyInline}} + - : Renvoie les éléments enfants pour le document courant. +- [`Document.compatMode`](/fr/docs/Web/API/Document/compatMode) {{Experimental_Inline}} {{ReadOnlyInline}} + - : Indique si le document est rendu à l'écran selon le mode _quirks_ ou _strict_. +- [`Document.contentType`](/fr/docs/Web/API/Document/contentType) {{Experimental_Inline}} {{ReadOnlyInline}} + - : Renvoie le type MIME du document courant. +- [`Document.currentScript`](/fr/docs/Web/API/Document/currentScript) {{ReadOnlyInline}} + - : Renvoie l'élément [`