Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .vscode/dictionaries/code-entities.txt
Original file line number Diff line number Diff line change
Expand Up @@ -732,6 +732,7 @@ SHA-256-sess
SHA-512-sess
shadowrootcustomelementregistry
shadowrootreferencetarget
shadowrootslotassignment
sharpyuv
shrd
shtm
Expand Down
1 change: 1 addition & 0 deletions .vscode/dictionaries/proper-names.txt
Original file line number Diff line number Diff line change
Expand Up @@ -399,6 +399,7 @@ mcdetect
McLellan
McNally
McVerry
Mediabunny
Megalosaurus
Menard
Mensah
Expand Down
4 changes: 4 additions & 0 deletions .vscode/dictionaries/terms-abbreviations.txt
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,7 @@ Deinonychus
demi
demultiplexing
demux
demuxer
demuxing
deoptimize
deprioritized
Expand Down Expand Up @@ -437,6 +438,8 @@ multivalued
multiview
muscaria
musicogenic
muxer
muxing
MVVM
namedspace
narrowband
Expand Down Expand Up @@ -571,6 +574,7 @@ QWERTZ
RAII
rari
rasterizes
raycaster
RDBMS
RDBMSes
readback
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/games/techniques/3d_on_the_web/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Three.js, like any other library, gives you a huge advantage: instead of writing

### Other tools

Both [Unity](https://unity.com/) and [Unreal](https://www.unrealengine.com/en-US) can export your game to [WebGL](/en-US/docs/Web/API/WebGL_API) with [asm.js](/en-US/docs/Games/Tools/asm.js), so you're free to use their tools and techniques to build games that will be exported to the web.
Both [Unity](https://unity.com/) and [Unreal](https://www.unrealengine.com/) can export your game to [WebGL](/en-US/docs/Web/API/WebGL_API) with [asm.js](/en-US/docs/Games/Tools/asm.js), so you're free to use their tools and techniques to build games that will be exported to the web.

![Illustration of three 3D geometry shapes: a grey torus, a blue cube, and a yellow cylinder.](shapes.png)

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/screen_reader/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ See [VoiceOver User Guide for Mac](https://support.apple.com/guide/voiceover/wel

Narrator is a screen-reading application that's built into Windows 10 and Windows 11.

See [Complete guide to Narrator](https://support.microsoft.com/en-us/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1).
See [Complete guide to Narrator](https://support.microsoft.com/en-US/accessibility/windows/narrator/complete-guide-to-narrator).

### ChromeVox

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ People with visual impairments include people with blindness, low-level vision,

- Paid commercial products, like [JAWS](https://vispero.com/jaws-screen-reader-software/) (Windows) and [Dolphin Screen Reader](https://yourdolphin.com/ScreenReader) (Windows).
- Free products, like [NVDA](https://www.nvaccess.org/) (Windows), [ChromeVox](https://support.google.com/chromebook/answer/7031755) (Chrome), and [Orca](https://wiki.gnome.org/Projects/Orca) (Linux).
- Software built into the operating system, like [VoiceOver](https://www.apple.com/accessibility/features/?vision) (macOS, iPadOS, iOS), [Narrator](https://support.microsoft.com/en-us/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1) (Windows), [ChromeVox](https://support.google.com/chromebook/answer/7031755) (on ChromeOS), and [TalkBack](https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback) (Android).
- Software built into the operating system, like [VoiceOver](https://www.apple.com/accessibility/features/?vision) (macOS, iPadOS, iOS), [Narrator](https://support.microsoft.com/en-US/accessibility/windows/narrator/complete-guide-to-narrator) (Windows), [ChromeVox](https://support.google.com/chromebook/answer/7031755) (on ChromeOS), and [TalkBack](https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback) (Android).

It is a good idea to familiarize yourself with screen readers; you should also set up a screen reader and play around with it, to get an idea of how it works. See our [screen reader tutorials](/en-US/docs/Learn_web_development/Core/Accessibility/Tooling#screen_readers) for more details on using them. The below video also provides a brief example of what the experience is like.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,6 @@ As a result, you need to be careful to check the answers they give you, and not
- `intitle:cheese` will only return results that have "cheese" in the main title of the page.

> [!NOTE]
> There are many other techniques you can use in various different search engines. Try seeing what others you can find — some useful resources are [Refine Google Searches](https://support.google.com/websearch/answer/2466433?hl=en), [How to use advanced syntax on DuckDuckGo Search](https://duckduckgo.com/duckduckgo-help-pages/results/syntax), and [Microsoft: Advanced search options](https://support.microsoft.com/en-us/topic/advanced-search-options-b92e25f1-0085-4271-bdf9-14aaea720930).
> There are many other techniques you can use in various different search engines. Try seeing what others you can find — some useful resources are [Refine Google Searches](https://support.google.com/websearch/answer/2466433?hl=en), [How to use advanced syntax on DuckDuckGo Search](https://duckduckgo.com/duckduckgo-help-pages/results/syntax), and [Microsoft: Advanced search options](https://support.microsoft.com/en-US/bing/advanced-search-options).

{{PreviousMenuNext("Learn_web_development/Getting_started/Environment_setup/Installing_software", "Learn_web_development/Getting_started/Environment_setup/Code_editors", "Learn_web_development/Getting_started/Environment_setup")}}
Original file line number Diff line number Diff line change
Expand Up @@ -251,7 +251,7 @@ With the `default_locale` set to `fr`.
- `getMessage("colorLocalized")` returns "color" because there is no `_locales/en_US/messages.json` file, so it falls back to the message present in `_locales/en/messages.json`.
- `getMessage("colorBlue")` returns "blue" because it falls back to the `colorBlue` message in `_locales/en/messages.json`.
- If the browser's locale is `zh-Hans-CN`:
- `getMessage("colorLocalized")` returns "couleur" because there is no region, script, or language match to the `zh-Hans-CN` locale (i.e., no `messages.json` file in a `zh-Hans-CN`, `zh-Hans`, or`zh` folder).
- `getMessage("colorLocalized")` returns "couleur" because there is no region, script, or language match to the `zh-Hans-CN` locale (i.e., no `messages.json` file in a `zh-Hans-CN`, `zh-Hans`, or `zh` folder).
- `getMessage("colorBlue")` returns "bleu" because there is no region, script, or language match to the `zh-Hans-CN` locale.

If the extension were to call `getMessage("colorRed")` it's returned an empty string, as there is no property for `"colorRed"` in any of the language files.
Expand Down
8 changes: 4 additions & 4 deletions files/en-us/web/api/audioplaybackstats/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,13 +66,13 @@ It is possible to retrieve the immediate playout latency of the audio context vi
- {{domxref("AudioPlaybackStats.resetLatency()")}}
- : Resets the start of the interval during which latency statistics are measured to the current time.
- {{domxref("AudioPlaybackStats.toJSON()")}}
- : A {{Glossary("Serialization","serializer")}} that returns a JSON representation of the {{domxref("AudioPlaybackStats")}} object.
- : A {{Glossary("Serialization","serializer")}} that returns a JSON representation of the `AudioPlaybackStats` object.

## Examples

### Reporting audio playback stats

This example demonstrates how to report audio stats accessed via the {{domxref("AudioPlaybackStats")}} object.
This example demonstrates how to report audio stats accessed via the `AudioPlaybackStats` object.

#### HTML

Expand Down Expand Up @@ -117,7 +117,7 @@ Next, we add a `click` event listener to the play button so that when it is clic
- Create a new {{domxref("AudioContext")}} and disable the play button so it can't be pressed again.
- Run some feature detection code that checks if the {{domxref("AudioContext.playbackStats")}} property exists. If it doesn't, we display a "Your browser doesn't support `AudioPlaybackStats`." message in a list item in the output list, and `return` out of the function.
- Create a basic audio graph consisting of of an {{domxref("OscillatorNode")}} and a {{domxref("GainNode")}} and start the oscillator playing.
- Enable the stats button and give it a `click` event listener so that when it is clicked, we write the different stats available in the audio context's {{domxref("AudioPlaybackStats")}} object into a text string and display it in a list item in the output list.
- Enable the stats button and give it a `click` event listener so that when it is clicked, we write the different stats available in the audio context's `AudioPlaybackStats` object into a text string and display it in a list item in the output list.
- Enable the reset button and give it a `click` event listener so that when it is clicked, we run the {{domxref("AudioPlaybackStats.resetLatency()")}} method.

```js live-sample___playback-stats
Expand Down Expand Up @@ -170,7 +170,7 @@ The rendered output looks like this:

{{embedlivesample("playback-stats", "100%", "400")}}

Click the "Play audio" button to start the oscillator tone playing. Now, when you click the "Display stats" button, you'll see the different stats available in the {{domxref("AudioPlaybackStats")}} object displayed in a list item.
Click the "Play audio" button to start the oscillator tone playing. Now, when you click the "Display stats" button, you'll see the different stats available in the `AudioPlaybackStats` object displayed in a list item.

If you click the "Reset latency" button and then click the "Display stats" button, new statistics will appear, but the minimum latency will no longer be zero. This is because the latency is now measured from when you clicked the "Reset latency" button, not from when the audio context was initialized.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/csscontainerrule/conditions/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The read-only **`conditions`** property of the {{domxref("CSSContainerRule")}} i
An array of objects where each object has the form:

```js
{ name: "<container-name>", query: "<container-query>" };
({ name: "<container-name>", query: "<container-query>" });
```

Either the `name` or `query` may be the empty string, but not both.
Expand Down
15 changes: 6 additions & 9 deletions files/en-us/web/api/element/requestfullscreen/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,15 +233,12 @@ document.addEventListener("keydown", (event) => {
event.preventDefault();
// Do whatever else you might want to do when escape is pressed
}
} else {
// Open full screen if Enter or F is pressed.
// Note that "F" is case-sensitive (uppercase):
if (event.key === "Enter" || event.key === "F") {
// Otherwise enter fullscreen mode
video.requestFullscreen({ keyboardLock: "browser" }).catch((err) => {
console.error(`Error enabling fullscreen: ${err.message}`);
});
}
} else if (event.key === "Enter" || event.key === "F") {
// Open full screen if Enter or F is pressed and not already fullscreen.
// Note that "F" is case-sensitive (uppercase).
video.requestFullscreen({ keyboardLock: "browser" }).catch((err) => {
console.error(`Error enabling fullscreen: ${err.message}`);
});
}
});
```
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/headers/entries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,10 @@ content-type: text/xml
vary: Accept-Language
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/headers/foreach/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,10 @@ content-type ==> application/json
cookie ==> This is a demo cookie
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/headers/keys/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,10 @@ content-type
vary
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/headers/values/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,10 @@ text/xml
Accept-Language
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/nodelist/entries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,10 @@ Array [ 1, #text "hey" ]
Array [ 2, <span> ]
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/nodelist/keys/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,10 @@ The result is:
2
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
4 changes: 4 additions & 0 deletions files/en-us/web/api/nodelist/values/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,10 @@ The result is:
<span>
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ None ({{jsxref("undefined")}}).

### Basic usage

The following example clears the override of the {{domxref("PreferenceObject.colorScheme", "color scheme")}}.
The following example clears the override of the [color scheme](/en-US/docs/Web/API/PreferenceObject/colorScheme).

```js
navigator.preferences.colorScheme.clearOverride();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This value is reported only once per server URL, and only while the {{domxref("R
### Basic usage

This example creates a handler for {{domxref("RTCPeerConnection.icecandidateerror_event", "icecandidateerror")}} events, which creates human-readable messages describing the local network interface for the connection and the ICE server used to attempt the connection.
It then calls a function to display those messages and the value of the event's {{domxref("RTCPeerConnectionIceErrorEvent.errorCode", "errorCode")}} property.
It then calls a function to display those messages and the value of the event's `errorCode` property.

```js
pc.addEventListener("icecandidateerror", (event) => {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ A string returned by the STUN or TURN server, or a browser-specific string expla
### Basic usage

This example creates a handler for {{domxref("RTCPeerConnection.icecandidateerror_event", "icecandidateerror")}} events, which creates human-readable messages describing the local network interface for the connection and the ICE server used to attempt the connection.
It then calls a function to display those messages and the value of the event's {{domxref("RTCPeerConnectionIceErrorEvent.errorText", "errorText")}} property.
It then calls a function to display those messages and the value of the event's `errorText` property.

```js
pc.addEventListener("icecandidateerror", (event) => {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ _The `RTCPeerConnectionIceErrorEvent` interface includes the properties found on
- {{domxref("RTCPeerConnectionIceErrorEvent.errorText", "errorText")}} {{ReadOnlyInline}}
- : A string containing the STUN reason text returned by the STUN or TURN server, or a browser-specific string explaining why communication with the server could not be established.
- {{domxref("RTCPeerConnectionIceErrorEvent.port", "port")}} {{ReadOnlyInline}}
- : A positive integer value giving the port number over which communication with the STUN or TURN server is taking place, using the IP address given in [`address`](#address).
- : A positive integer value giving the port number over which communication with the STUN or TURN server is taking place, using the IP address given in [`address`](/en-US/docs/Web/API/RTCPeerConnectionIceErrorEvent/address).
This is `null` if the connection hasn't been established (that is, if `address` is `null`).
- {{domxref("RTCPeerConnectionIceErrorEvent.url", "url")}} {{ReadOnlyInline}}
- : A string indicating the URL of the STUN or TURN server with which the error occurred.
Expand Down
12 changes: 6 additions & 6 deletions files/en-us/web/api/viewtransition/waituntil/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ This example demonstrates basic usage of the `waitUntil()` method to delay a vie

#### HTML

We include a {{htmlelement("div")}} element containing page content, which includes a {{htmlelement("p")}} element and a {{htmlelement("button")}} element that when pressed will change the displayed content. The paragraph includes an [`aria-live`](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live) attribute so that DOM updates are announced to screenreader users.
We include a {{htmlelement("div")}} element containing page content, which includes a {{htmlelement("p")}} element and a {{htmlelement("button")}} element that when pressed will change the displayed content. The paragraph includes an [`aria-live`](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live) attribute so that DOM updates are announced to screen reader users.

```html live-sample___basic-waituntil
<div class="page">
Expand Down Expand Up @@ -168,18 +168,18 @@ function btnHandler() {
Next, we define the `updatePage()` function, which updates the page DOM. It toggles between setting the content paragraph `textContent` equal to the first and the second `pageContent` array elements.

```js live-sample___basic-waituntil
const pageContent = [
"Hello! This is the first page.",
"Well, this is the second page.",
];

function updatePage() {
if (content.textContent === pageContent[0]) {
content.textContent = pageContent[1];
} else {
content.textContent = pageContent[0];
}
}

const pageContent = [
"Hello! This is the first page.",
"Well, this is the second page.",
];
```

Finally, we define the `showLog()` function — this sets the log paragraph's `textContent` to "View transition finished", waits for one second, then sets it back to an empty string.
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/web_midi_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,4 +135,4 @@ function startLoggingMIDIInput(midiAccess) {
## See also

- [Introduction to Web MIDI](https://code.tutsplus.com/introduction-to-web-midi--cms-25220t)
- [Making Music in the Browser](https://www.keithmcmillen.com/blog/making-music-in-the-browser-web-midi-api/)
- [Making Music in the Browser](https://keithmcmillen.com/blog/making-music-in-the-browser-web-midi-api/)
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ See the [Codec Support Table](https://webcodecsfundamentals.org/datasets/codec-s

The fully qualified codec string encodes the codec family, profile, level, and other parameters that affect which hardware can encode or decode the stream and at what resolution and quality.

The format for these codec strings is specified in the [W3C codec registry](https://www.w3.org/TR/webcodecs-codec-registry/), and the format is different for each codec family.
The format for these codec strings is specified in the [W3C codec registry](https://w3c.github.io/webcodecs/codec_registry.html), and the format is different for each codec family.

#### H.264

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/webcodecs_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ You can then start encoding frames to the encoder. You can construct a `VideoFra

```js
for (let i = 0; i < 60; i++) {
const frame = new VideoFrame(canvas, { timestamp: (i * 1e6) / 30 }); //30 fps, in microseconds
const frame = new VideoFrame(canvas, { timestamp: (i * 1e6) / 30 }); // 30 fps, in microseconds
encoder.encode(frame, { keyFrame: i % 60 === 0 });
}
```
Expand Down
Loading
Loading