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
3 changes: 3 additions & 0 deletions .vscode/dictionaries/code-entities.txt
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@ assetlinks
associationlist
associationlistitemkey
associationlistitemvalue
attributiondestination
attributionsourceid
attributionsrc
audiocontext
authorid
Expand Down Expand Up @@ -281,6 +283,7 @@ hansfin
hantfin
hebr
highp
hiliteColor
HMDVRDevice
hmng
hmnp
Expand Down
2 changes: 0 additions & 2 deletions files/en-us/games/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,6 @@ For a list of web game examples, see our list of [Tutorials](/en-US/docs/Games/T
- : An online book, written by Bob Nystrom, which discusses programming patterns in the context of game development with the aim of helping game developers produce more effective and efficient code.
- [Gamedev.js Weekly](https://gamedevjsweekly.com/)
- : Weekly newsletter about HTML game development, sent every Friday. Contains the latest articles, tutorials, tools, and resources.
- [HTML5 Game Engine](https://html5gameengine.com/)
- : List of the most popular HTML game frameworks along with their rating, features and samples.
- [Tuts+ Game Development](https://code.tutsplus.com/c/game-development)
- : Tutorials and articles about game development in general.
- [HTML5 Gamedev Starter](https://html5devstarter.enclavegames.com/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@ Microsoft ended support for IE on June 15, 2022.
- [Internet Explorer](https://en.wikipedia.org/wiki/Internet_Explorer) on Wikipedia
- [History of Internet Explorer](https://en.wikipedia.org/wiki/History_of_Internet_Explorer) on Wikipedia
- [Internet Explorer version history](https://en.wikipedia.org/wiki/Internet_Explorer_versions) on Wikipedia
- [IE11 end of support countdown](https://death-to-ie11.com/)
- Related glossary terms:
- {{glossary("Browser")}}
- {{glossary("Trident")}} (IE's rendering engine)
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/node.js/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@ Packages hosted on npm are downloaded from the registry at [https://registry.npm
- [Node.js](https://en.wikipedia.org/wiki/Node.js) on Wikipedia
- [Node.js website](https://nodejs.org/)
- [API reference documentation](https://nodejs.org/api/)
- [Guides](https://nodejs.org/en/learn/getting-started/introduction-to-nodejs)
- [Guides](https://nodejs.org/learn/getting-started/introduction-to-nodejs)
- [npm Documentation](https://docs.npmjs.com/)
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ To summarize:
There are numerous checklists and sets of guidelines available for basing accessibility tests on, which might seem overwhelming at first glance. Our advice is to familiarize yourself with the basic areas in which you need to take care, as well as understanding the high-level structures of the guidelines that are most relevant to you.

- For a start, the W3C has published a large and very detailed document that includes very precise, technology-agnostic criteria for accessibility conformance. These are called the [Web Content Accessibility Guidelines](https://www.w3.org/WAI/standards-guidelines/wcag/) (WCAG), and they are not a short read by any means. The criteria are split up into four main categories, which specify how implementations can be made perceivable, operable, understandable, and robust. The best place to get a light introduction and start learning is [WCAG at a Glance](https://www.w3.org/WAI/standards-guidelines/wcag/glance/). There is no need to learn all of the WCAG criteria — be aware of the major areas of concern, and use a variety of techniques and tools to highlight any areas that don't conform to the WCAG criteria (see below for more).
- Your country may also have specific legislation governing the need for websites serving their population to be accessible — for example [EN 301 549](https://www.etsi.org/deliver/etsi_en/301500_301599/301549/02.01.02_60/en_301549v020102p.pdf) in the EU, [Section 508 of the Rehabilitation Act](https://www.section508.gov/training/) in the US, [Federal Ordinance on Barrier-Free Information Technology](https://www.aktion-mensch.de/inklusion/barrierefreiheit/barrierefreie-website) in Germany, the [Accessibility Regulations 2018](https://www.legislation.gov.uk/uksi/2018/952/introduction/made) in the UK, [Accessibilità](https://www.agid.gov.it/it/ambiti-intervento/accessibilita-usabilita) in Italy, the [Disability Discrimination Act](https://humanrights.gov.au/resource-hub/resources-for-organisations-businesses/disability-resources-employers/guidelines-equal-access-digital-goods-and-services) in Australia, etc. The W3C keeps a list of [Web Accessibility Laws & Policies](https://www.w3.org/WAI/policies/) by country.
- Your country may also have specific legislation governing the need for websites serving their population to be accessible — for example [EN 301 549](https://www.etsi.org/deliver/etsi_en/301500_301599/301549/02.01.02_60/en_301549v020102p.pdf) in the EU, [Section 508 of the Rehabilitation Act](https://www.section508.gov/training/) in the US, [Federal Ordinance on Barrier-Free Information Technology](https://www.aktion-mensch.de/inklusion/barrierefreiheit/barrierefreie-website) in Germany, the [Accessibility Regulations 2018](https://www.legislation.gov.uk/uksi/2018/952/introduction/made) in the UK, [Accessibilità](https://www.agid.gov.it/it/ambiti-intervento/accessibilita-usabilita) in Italy, the [Disability Discrimination Act](https://humanrights.gov.au/resource-hub/by-resource-type/guidelines-and-standards/guides-and-standards-disability-rights/guidelines-equal-access-digital-goods-and-services) in Australia, etc. The W3C keeps a list of [Web Accessibility Laws & Policies](https://www.w3.org/WAI/policies/) by country.

So while the WCAG is a set of guidelines, your country will probably have laws governing web accessibility, or at least the accessibility of services available to the public (which could include websites, television, physical spaces, etc.) It is a good idea to find out what your laws are. If you make no effort to check that your content is accessible, you could be legally liable if people complain.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -437,7 +437,7 @@ We start our CSS by styling the `<optgroup>` elements themselves. These are most
}

html {
font-family: Arial, Helvetica, sans-serif;
font-family: "Arial", sans-serif;
}

select,
Expand All @@ -447,8 +447,8 @@ select,
}

select {
border: 2px solid #ddd;
background: #eee;
border: 2px solid #dddddd;
background: #eeeeee;
padding: 10px;
}

Expand All @@ -459,9 +459,9 @@ select {

```css live-sample___optgroup-example
optgroup {
border: 2px solid #ddd;
border: 2px solid #dddddd;
border-radius: 8px;
background: #eee;
background: #eeeeee;
padding: 10px 0 0 0;
margin-top: 5px;
}
Expand All @@ -480,7 +480,7 @@ Finally, we style the `<option>` elements, providing a {{cssxref("background")}}

```css live-sample___optgroup-example
option {
background: #eee;
background: #eeeeee;
padding: 10px;
}

Expand All @@ -489,7 +489,7 @@ option:last-of-type {
}

option:nth-of-type(odd) {
background: #fff;
background: white;
}

option:hover,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ We begin our styling by opting the `<select>` into custom styling with an {{cssx
}

html {
font-family: Arial, Helvetica, sans-serif;
font-family: "Arial", sans-serif;
}
```

Expand All @@ -114,22 +114,22 @@ Our basic styles look like this:

```css live-sample___basic-listbox live-sample___expanding-listbox live-sample___horizontal-listbox
select {
border: 2px solid #ddd;
border: 2px solid #dddddd;
border-radius: 8px;
background: #eee;
background: #eeeeee;
width: 200px;
height: 130px;
}

option {
background: #eee;
background: #eeeeee;
padding: 10px;
height: 40px;
outline: none;
}

option:nth-of-type(odd) {
background: #fff;
background: white;
}
```

Expand Down Expand Up @@ -306,7 +306,7 @@ We start our CSS by opting the `<select>` element into custom styling, as before
}

html {
font-family: Arial, Helvetica, sans-serif;
font-family: "Arial", sans-serif;
}
```

Expand All @@ -320,9 +320,9 @@ Most of the styling is fairly rudimentary, but we'll run through it, pointing ou

```css live-sample___complex-listbox
.wrapper {
border: 2px solid #ddd;
border: 2px solid #dddddd;
border-radius: 8px;
background: #ddd;
background: #dddddd;
width: 250px;
}
```
Expand All @@ -334,21 +334,21 @@ Next, we style the filter `<input>`, the `.options` `<div>` and the contained `<
display: block;
padding: 5px;
border-radius: 5px;
border: 1px solid #bbb;
border: 1px solid #bbbbbb;
width: 95%;
margin: 8px auto;
}

.options {
padding: 0 5px;
background: #ddd;
background: #dddddd;
}

select {
height: 200px;
overflow-y: scroll;
width: 100%;
border: 1px solid #bbb;
border: 1px solid #bbbbbb;
}

.edit {
Expand All @@ -363,12 +363,12 @@ We style our `<option>` elements in a similar manner to earlier examples, giving

```css live-sample___complex-listbox
option {
background: #eee;
background: #eeeeee;
padding: 10px;
}

option:nth-of-type(odd) {
background: #fff;
background: white;
}

option:checked {
Expand All @@ -392,17 +392,17 @@ a {

input:hover,
input:focus {
border: 1px solid #999;
background: #eef;
border: 1px solid #999999;
background: #eeeeff;
}

.edit a {
color: #333;
color: #333333;
}

a:hover,
a:focus {
outline: 2px dotted #666;
outline: 2px dotted #666666;
}
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,15 +63,15 @@ You can use any of them, as they will have similar functionality, though some ar

If you want to include video or audio into your website, you can either embed online services (for example YouTube, Vimeo, or Dailymotion), or include your own videos (see below for bandwidth costs).

For audio files, you can find free software ([Audacity](https://www.audacityteam.org/), [Wavosaur](https://www.wavosaur.com/)), or paying up to a few hundred dollars ([Sound Forge](https://www.vegascreativesoftware.com/us/sound-forge-pro/), [Adobe Audition](https://www.adobe.com/products/audition.html)). Likewise, video-editing software can be free ([PiTiVi](https://www.pitivi.org/), [OpenShot](https://www.openshot.org/) for Linux, [iMovie](https://support.apple.com/imovie) for Mac), less than $100 ([Adobe Premiere Elements](https://www.adobe.com/products/premiere-elements.html)), or several hundred dollars ([Adobe Premiere Pro](https://www.adobe.com/products/premiere.html), [Avid Media Composer](https://www.avid.com/media-composer), [Final Cut Pro](https://www.apple.com/final-cut-pro/)). The software you received with your digital camera may cover all your needs.
For audio files, you can find free software ([Audacity](https://www.audacityteam.org/), [Wavosaur](https://www.wavosaur.com/)), or paying up to a few hundred dollars ([Sound Forge](https://www.vegascreativesoftware.com/sound-forge/), [Adobe Audition](https://www.adobe.com/products/audition.html)). Likewise, video-editing software can be free ([PiTiVi](https://www.pitivi.org/), [OpenShot](https://www.openshot.org/) for Linux, [iMovie](https://support.apple.com/imovie) for Mac), less than $100 ([Adobe Premiere Elements](https://www.adobe.com/products/premiere-elements.html)), or several hundred dollars ([Adobe Premiere Pro](https://www.adobe.com/products/premiere.html), [Avid Media Composer](https://www.avid.com/media-composer), [Final Cut Pro](https://www.apple.com/final-cut-pro/)). The software you received with your digital camera may cover all your needs.

### Publishing tools

You also need a way to upload files: from your hard drive to a distant web server. To do that you should use a publishing tool such as an [(S)FTP client](/en-US/docs/Glossary/FTP), [RSync](https://en.wikipedia.org/wiki/Rsync), or [Git/GitHub](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site).

Each operating system includes an (S)FTP client, as part of its file manager. Windows Explorer, Nautilus (a common Linux file manager), and the Mac Finder all include this functionality. However, people often choose dedicated (S)FTP clients to display local or remote directories side-by-side and store server passwords.

If you want to install an (S)FTP client, there are several reliable and free options: for example, [FileZilla](https://filezilla-project.org/) for all platforms, [WinSCP](https://winscp.net/eng/index.php) for Windows, [Cyberduck](https://cyberduck.io/) for Mac or Windows, [and more](https://en.wikipedia.org/wiki/List_of_FTP_server_software).
If you want to install an (S)FTP client, there are several reliable and free options: for example, [FileZilla](https://filezilla-project.org/) for all platforms, [WinSCP](https://winscp.net/eng/index.php) for Windows, [Cyberduck](https://cyberduck.io/) for Mac or Windows.

Because FTP is inherently insecure, you should make sure to use SFTP — the secure, encrypted version of FTP that most hosting sites you'll deal with these days will offer by default — or another secure solution like Rsync over SSH.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -151,8 +151,8 @@ touch choose_beast.html choose_beast.css choose_beast.js
The HTML file looks like this:

```html
<!DOCTYPE html>
<html>
<!doctype html>
<html lang="en-US">
<head>
<meta charset="utf-8" />
<link rel="stylesheet" href="choose_beast.css" />
Expand Down Expand Up @@ -344,7 +344,7 @@ function reportExecuteScriptError(error) {
})();
```

The popup script executes [the content script](#the-content-script) in the active tab as soon as the popup is loaded, using the [`browser.scripting.executeScript()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/scripting/executeScript) API. If the content script execution is successful, it stays loaded in the page until the tab is closed or the user navigates to a different page.
The popup script executes [the content script](#the_content_script) in the active tab as soon as the popup is loaded, using the [`browser.scripting.executeScript()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/scripting/executeScript) API. If the content script execution is successful, it stays loaded in the page until the tab is closed or the user navigates to a different page.

The `browser.scripting.executeScript()` call can fail if the extension can't execute content scripts in the active page. For example, an extension can't execute scripts in privileged browser pages such as `about:debugging`, or on pages in the [addons.mozilla.org](https://addons.mozilla.org/) domain. If the call fails, `reportExecuteScriptError()` hides the `<div id="popup-content">` element, displays the `<div id="error-content"...` element, and logs an error to the [console](https://extensionworkshop.com/documentation/develop/debugging/).

Expand Down
1 change: 0 additions & 1 deletion files/en-us/web/api/deprecationreport/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,6 @@ const options = {

const observer = new ReportingObserver((reports, observer) => {
reports.forEach((report) => {
//console.log(report);
log(JSON.stringify(report, null, 2));
});
}, options);
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/document/createattribute/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ An {{domxref("Attr")}} node.
### Exceptions

- `InvalidCharacterError` {{domxref("DOMException")}}
- : Thrown if the [`localName`](#localName) value is not a valid attribute name.
- : Thrown if the [`localName`](#localname) value is not a valid attribute name.
It must have at least one character, and may not contain ASCII whitespace, `NULL`, `/`, `=` or `>` (U+0000, U+002F, U+003D, or U+003E, respectively).

> [!NOTE]
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/document/createattributens/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ The new {{domxref("Attr")}} node.
### Exceptions

- `NamespaceError` {{domxref("DOMException")}}
- : Thrown if the [`namespaceURI`](#namespaceURI) value is:
- : Thrown if the [`namespaceURI`](#namespaceuri) value is:
- not a valid namespace URI.
- set to the empty string when `prefix` has a value.
- not the value `http://www.w3.org/XML/1998/namespace` or `http://www.w3.org/2000/xmlns/` when [`prefix`](#prefix) is set to `xml` or `xmlns`, respectively.
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/document/createelement/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ The new {{domxref("Element")}}.
### Exceptions

- `InvalidCharacterError` {{domxref("DOMException")}}
- : Thrown if the [`localName`](#localName) value is not a valid element name.
- : Thrown if the [`localName`](#localname) value is not a valid element name.
A string is a valid element name if its length is at least 1 and:
- it starts with an alphabet character and does not contain ASCII whitespace, `NULL`, `/`, or `>` (U+0000, U+002F, or U+003E, respectively).
- it starts with `:` (U+003A), `_` (U+005F), or any characters in the range U+0080 to U+10FFFF (inclusive), _and_ the remaining code points only include those same characters along with the ASCII alphanumeric characters, `-` (U+002D), and `.` (U+002E),
Expand All @@ -55,7 +55,7 @@ The new {{domxref("Element")}}.
> Earlier versions of the specification were more restrictive, requiring that the `localName` be a valid [XML name](https://www.w3.org/TR/xml/#dt-name).

- `NotSupportedError` {{domxref("DOMException")}}
- : Thrown if both the [`is`](#is) and [`customElementRegistry`](#customElementRegistry) options are specified.
- : Thrown if both the [`is`](#is) and [`customElementRegistry`](#customelementregistry) options are specified.

## Examples

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/document/createelementns/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ The new {{DOMxRef("Element")}}.
### Exceptions

- `NamespaceError` {{domxref("DOMException")}}
- : Thrown if the [`namespaceURI`](#namespaceURI) value is:
- : Thrown if the [`namespaceURI`](#namespaceuri) value is:
- not a valid namespace URI.
- set to the empty string when `prefix` has a value.
- not the value `http://www.w3.org/XML/1998/namespace` or `http://www.w3.org/2000/xmlns/` when [`prefix`](#prefix) is set to `xml` or `xmlns`, respectively.
Expand All @@ -82,7 +82,7 @@ The new {{DOMxRef("Element")}}.
> Earlier versions of the specification were more restrictive, requiring that the `qualifiedName` be a valid [XML name](https://www.w3.org/TR/xml/#dt-name).

- `NotSupportedError` {{domxref("DOMException")}}
- : Thrown if both the [`is`](#is) and [`customElementRegistry`](#customElementRegistry) options are specified.
- : Thrown if both the [`is`](#is) and [`customElementRegistry`](#customelementregistry) options are specified.

## Examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ The newly-created {{domxref("XMLDocument")}}.
### Exceptions

- `NamespaceError` {{domxref("DOMException")}}
- : Thrown if the [`namespaceURI`](#namespaceURI) value is:
- : Thrown if the [`namespaceURI`](#namespaceuri) value is:
- not a valid namespace URI.
- set to the empty string when `prefix` has a value.
- not the value `http://www.w3.org/XML/1998/namespace` or `http://www.w3.org/2000/xmlns/` when [`prefix`](#prefix) is set to `xml` or `xmlns`, respectively.
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/element/setattributens/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ None ({{jsxref("undefined")}}).
### Exceptions

- `NamespaceError` {{domxref("DOMException")}}
- : Thrown if the [`namespaceURI`](#namespaceURI) value is:
- : Thrown if the [`namespaceURI`](#namespaceuri) value is:
- not a valid namespace URI.
- set to the empty string when `prefix` has a value.
- not the value `http://www.w3.org/XML/1998/namespace` or `http://www.w3.org/2000/xmlns/` when [`prefix`](#prefix) is set to `xml` or `xmlns`, respectively.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ function success(pos) {
const crd = pos.coords;

console.log("Your current position is:");
console.log(`Latitude : ${crd.latitude}`);
console.log(`Latitude: ${crd.latitude}`);
console.log(`Longitude: ${crd.longitude}`);
console.log(`More or less ${crd.accuracy} meters.`);
}
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/preferencemanager/colorscheme/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,13 @@ spec-urls: https://drafts.csswg.org/mediaqueries-5/#color-scheme-attribute

{{APIRef("User Preferences API")}}{{SeeCompatTable}}{{SecureContext_Header}}

The **`colorScheme`** read-only property of the {{domxref("PreferenceManager")}} interface returns a {{domxref("PreferenceObject")}} used to override the user's preference for the [color scheme](/en-US/docs/Web/CSS/Reference/Reference/At-rules/@media/prefers-color-scheme) of the site.
The **`colorScheme`** read-only property of the {{domxref("PreferenceManager")}} interface returns a {{domxref("PreferenceObject")}} used to override the user's preference for the [color scheme](/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-color-scheme) of the site.

Valid `colorScheme` {{domxref("PreferenceObject.value")}} settings are `dark` and `light`.

## Value

A {{domxref("PreferenceObject")}} used to override the user's preference for the [color scheme](/en-US/docs/Web/CSS/Reference/Reference/At-rules/@media/prefers-color-scheme) of the site.
A {{domxref("PreferenceObject")}} used to override the user's preference for the [color scheme](/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-color-scheme) of the site.

## Examples

Expand Down
Loading
Loading