From 67c79b5c01aaf5a1ec6c422a7c9bbb4eabc9e8e2 Mon Sep 17 00:00:00 2001 From: Hamish Willee Date: Wed, 4 Sep 2024 07:20:24 +1000 Subject: [PATCH 001/129] FF131 Relnote - Text fragments supported (#35717) --- files/en-us/mozilla/firefox/releases/131/index.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/files/en-us/mozilla/firefox/releases/131/index.md b/files/en-us/mozilla/firefox/releases/131/index.md index 1d28bdd7f13f48c..ee0f94f23318186 100644 --- a/files/en-us/mozilla/firefox/releases/131/index.md +++ b/files/en-us/mozilla/firefox/releases/131/index.md @@ -40,6 +40,9 @@ This article provides information about the changes in Firefox 131 that affect d ### APIs +- [Text fragments](/en-US/docs/Web/URI/Fragment/Text_fragments) are now supported, allowing users to link to and highlight specific portions of text in a web page. This feature uses a particular syntax in the [URL fragment](/en-US/docs/Web/URI/Fragment) that identifies the target based on patterns in the rendered text. + Website developers can also use the existence of the {{domxref("Document.fragmentDirective")}} property (an instance of the {{domxref("FragmentDirective")}} interface) to feature check for text fragment support, and the {{CSSxRef("::target-text")}} pseudo element to select and style text that has been selected using a text fragment link. ([Firefox bug 1914877](https://bugzil.la/1914877)) + #### DOM #### Media, WebRTC, and Web Audio From 45be179aadfa0500fe92598cbb0e76bdf7a87473 Mon Sep 17 00:00:00 2001 From: Vuqar05 <77661655+Vuqar05@users.noreply.github.com> Date: Wed, 4 Sep 2024 05:36:41 +0400 Subject: [PATCH 002/129] Fix typo (#35729) * Fix typo in index.html * Update files/en-us/learn/forms/html5_input_types/index.md --------- Co-authored-by: Joshua Chen --- files/en-us/learn/forms/html5_input_types/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/learn/forms/html5_input_types/index.md b/files/en-us/learn/forms/html5_input_types/index.md index 591e91292f3986a..e1c37635ccbcd28 100644 --- a/files/en-us/learn/forms/html5_input_types/index.md +++ b/files/en-us/learn/forms/html5_input_types/index.md @@ -150,7 +150,7 @@ Controls for entering numbers can be created with an {{HTMLElement("input")}} [` With the `number` input type, you can constrain the minimum and maximum values allowed by setting the [`min`](/en-US/docs/Web/HTML/Element/input#min) and [`max`](/en-US/docs/Web/HTML/Element/input#max) attributes. -You can also use the `step` attribute to set the increment increase and decrease caused by pressing the spinner buttons. By default, the number input type only validates if the number is an integer, as the [`step`](/en-US/docs/Web/HTML/Attributes/step) attribute defaults to `1`. To allow float numbers, specify `step="any"` or a specific value, lik `step="0.01` to restrict the floating point. If omitted, as the `step` value defaults to `1`, only whole numbers are valid. +You can also use the `step` attribute to set the increment increase and decrease caused by pressing the spinner buttons. By default, the number input type only validates if the number is an integer, as the [`step`](/en-US/docs/Web/HTML/Attributes/step) attribute defaults to `1`. To allow float numbers, specify `step="any"` or a specific value, like `step="0.01"` to restrict the floating point. If omitted, as the `step` value defaults to `1`, only whole numbers are valid. Let's look at some examples: From 727be5569e8e5d6b9c630bc1ed362e1be1edef88 Mon Sep 17 00:00:00 2001 From: "Eric A. Meyer" Date: Wed, 4 Sep 2024 02:51:43 -0400 Subject: [PATCH 003/129] Expanded See Also list on css/stroke (#35727) --- files/en-us/web/css/stroke/index.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/files/en-us/web/css/stroke/index.md b/files/en-us/web/css/stroke/index.md index c99ca8c42010416..4760cad5eba874e 100644 --- a/files/en-us/web/css/stroke/index.md +++ b/files/en-us/web/css/stroke/index.md @@ -209,5 +209,12 @@ Because `stroke-context` is being applied to an element that descends from a {{S ## See also -- SVG {{SVGAttr("stroke")}} attribute +- {{cssxref("stroke-dasharray")}} +- {{cssxref("stroke-dashoffset")}} +- {{cssxref("stroke-linecap")}} +- {{cssxref("stroke-linejoin")}} +- {{cssxref("stroke-miterlimit")}} +- {{cssxref("stroke-opacity")}} +- {{cssxref("stroke-width")}} - {{cssxref("paint-order")}} +- SVG {{SVGAttr("stroke")}} attribute From 7347dcddbde0fde17a8337bd5be0fd35996060e5 Mon Sep 17 00:00:00 2001 From: AshmitGupta <67188586+AshmitGupta@users.noreply.github.com> Date: Tue, 3 Sep 2024 23:57:27 -0700 Subject: [PATCH 004/129] Replaced nanoid with crypto.randomUUID() (#35676) * Replaced nanoid with crypto.randomUUID() * Stylistic changes Co-authored-by: Chris Mills * Update language of steps Co-authored-by: Chris Mills * ambiguous language fix --------- Co-authored-by: Chris Mills --- .../vue_first_component/index.md | 23 +++---------------- 1 file changed, 3 insertions(+), 20 deletions(-) diff --git a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/vue_first_component/index.md b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/vue_first_component/index.md index 5231045d5d9b180..5b7af39ac4c4448 100644 --- a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/vue_first_component/index.md +++ b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/vue_first_component/index.md @@ -310,28 +310,11 @@ Try changing `true` to `false` and back again, reloading your app in between to Great! We now have a working checkbox where we can set the state programmatically. However, we can currently only add one `ToDoList` component to the page because the `id` is hardcoded. This would result in errors with assistive technology since the `id` is needed to correctly map labels to their checkboxes. To fix this, we can programmatically set the `id` in the component data. -We can use the [nanoid](https://github.com/ai/nanoid) package to help keep the index unique. This package exports a function `nanoid()` that generates a unique string. This will be sufficient for keeping component `id`s unique. +We can use the {{domxref("Crypto.randomUUID()")}} method to generate a unique string to keep component `id`s unique. `randomUUID()` is built into modern browsers and provides a straightforward way to ensure uniqueness without relying on external libraries. -Let's add the package to our project with npm; stop your server and enter the following command into your terminal: - -```bash -npm install --save nanoid -``` - -> [!NOTE] -> If you prefer yarn, you could instead use `yarn add nanoid`. - -We can now import this package into our `ToDoItem` component. Add the following line at the top of `ToDoItem.vue`'s ` -``` +An {{domxref("HTMLFormElement")}} or `null`. ## Specifications @@ -53,3 +21,11 @@ A {{domxref("HTMLFormElement")}}. ## Browser compatibility {{Compat}} + +## See also + +- {{domxref("HTMLSelectElement")}} +- {{domxref("HTMLFormElement")}} +- {{HTMLElement("select")}} +- HTML [`form`](/en-US/docs/Web/HTML/Element/select#form) attribute +- [HTML forms guide](/en-US/docs/Learn/Forms) diff --git a/files/en-us/web/api/htmltextareaelement/form/index.md b/files/en-us/web/api/htmltextareaelement/form/index.md new file mode 100644 index 000000000000000..ca695ae4ba86a68 --- /dev/null +++ b/files/en-us/web/api/htmltextareaelement/form/index.md @@ -0,0 +1,31 @@ +--- +title: "HTMLTextAreaElement: form property" +short-title: form +slug: Web/API/HTMLTextAreaElement/form +page-type: web-api-instance-property +browser-compat: api.HTMLTextAreaElement.form +--- + +{{APIRef("HTML DOM")}} + +The **`form`** read-only property of the {{domxref("HTMLTextAreaElement")}} interface returns an {{domxref("HTMLFormElement")}} object that owns this {{htmlelement("textarea")}}, or `null` if this textarea is not owned by any form. + +## Value + +An {{domxref("HTMLFormElement")}} or `null`. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLTextAreaElement")}} +- {{domxref("HTMLFormElement")}} +- {{HTMLElement("textarea")}} +- HTML [`form`](/en-US/docs/Web/HTML/Element/textarea#form) attribute +- [HTML forms guide](/en-US/docs/Learn/Forms) From 9f7016d8434a36052362f7c58ff7c4b144da56b0 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Tue, 10 Sep 2024 19:01:26 -0400 Subject: [PATCH 063/129] Add pages for HTML{FieldSet,Output}Element.type (#35666) --- .../web/api/htmlfieldsetelement/type/index.md | 35 +++++++++++++++++++ .../web/api/htmloutputelement/type/index.md | 35 +++++++++++++++++++ .../web/api/htmltextareaelement/type/index.md | 19 ++++------ 3 files changed, 76 insertions(+), 13 deletions(-) create mode 100644 files/en-us/web/api/htmlfieldsetelement/type/index.md create mode 100644 files/en-us/web/api/htmloutputelement/type/index.md diff --git a/files/en-us/web/api/htmlfieldsetelement/type/index.md b/files/en-us/web/api/htmlfieldsetelement/type/index.md new file mode 100644 index 000000000000000..9c5a3dc5a82b74c --- /dev/null +++ b/files/en-us/web/api/htmlfieldsetelement/type/index.md @@ -0,0 +1,35 @@ +--- +title: "HTMLFieldSetElement: type property" +short-title: type +slug: Web/API/HTMLFieldSetElement/type +page-type: web-api-instance-property +browser-compat: api.HTMLFieldSetElement.type +--- + +{{ApiRef("HTML DOM")}} + +The **`type`** read-only property of the {{domxref("HTMLFieldSetElement")}} interface returns the string `"fieldset"`. + +## Value + +The string `"fieldset"`. + +## Example + +```js +const fs = document.querySelector("fieldset"); +console.log(fs.type); // "fieldset" +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLFieldSetElement")}} +- {{HTMLElement("fieldset")}} diff --git a/files/en-us/web/api/htmloutputelement/type/index.md b/files/en-us/web/api/htmloutputelement/type/index.md new file mode 100644 index 000000000000000..381676c8a803b64 --- /dev/null +++ b/files/en-us/web/api/htmloutputelement/type/index.md @@ -0,0 +1,35 @@ +--- +title: "HTMLOutputElement: type property" +short-title: type +slug: Web/API/HTMLOutputElement/type +page-type: web-api-instance-property +browser-compat: api.HTMLOutputElement.type +--- + +{{ApiRef("HTML DOM")}} + +The **`type`** read-only property of the {{domxref("HTMLOutputElement")}} interface returns the string `"output"`. + +## Value + +The string `"output"`. + +## Example + +```js +const output = document.querySelector("output"); +console.log(output.type); // "output" +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLOutputElement")}} +- {{HTMLElement("output")}} diff --git a/files/en-us/web/api/htmltextareaelement/type/index.md b/files/en-us/web/api/htmltextareaelement/type/index.md index 2888e932370f0c8..43fa4c2af40dc5b 100644 --- a/files/en-us/web/api/htmltextareaelement/type/index.md +++ b/files/en-us/web/api/htmltextareaelement/type/index.md @@ -8,25 +8,17 @@ browser-compat: api.HTMLTextAreaElement.type {{ApiRef("HTML DOM")}} -The read-only **`type`** property of the {{domxref("HTMLTextAreaElement")}} always returns `textarea`. +The **`type`** read-only property of the {{domxref("HTMLTextAreaElement")}} interface returns the string `"textarea"`. ## Value -A string whose value is always `textarea`. +The string `"textarea"`. ## Example -### HTML - -```html - -``` - -### JavaScript - ```js -const txtAreaElement = document.querySelector("#txtarea"); -console.log(txtAreaElement.type); // Output: "textarea" +const textArea = document.querySelector("textarea"); +console.log(textArea.type); // "textarea" ``` ## Specifications @@ -39,4 +31,5 @@ console.log(txtAreaElement.type); // Output: "textarea" ## See also -- {{domxref("HTMLInputElement.type")}} property +- {{domxref("HTMLTextAreaElement")}} +- {{HTMLElement("textarea")}} From a846e591b43c33ab17d991013acdf227ae190b40 Mon Sep 17 00:00:00 2001 From: otakutyrant <64188229+otakutyrant@users.noreply.github.com> Date: Wed, 11 Sep 2024 07:01:55 +0800 Subject: [PATCH 064/129] Explain what white space is more pragmatically (#35818) * Explain what white space is more pragmatically After all, what browsers ignore is "extra white space", not "white space" which seems confusing literally to leaners. * Update files/en-us/learn/css/first_steps/how_css_is_structured/index.md Accept the first suggestion in #35818 Co-authored-by: Estelle Weyl * Accept the second suggestion from #35818 Co-authored-by: Estelle Weyl * Update files/en-us/learn/css/first_steps/how_css_is_structured/index.md --------- Co-authored-by: Estelle Weyl --- .../first_steps/how_css_is_structured/index.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/files/en-us/learn/css/first_steps/how_css_is_structured/index.md b/files/en-us/learn/css/first_steps/how_css_is_structured/index.md index 282d869fbbfa9d2..8efff32c9d6d0ee 100644 --- a/files/en-us/learn/css/first_steps/how_css_is_structured/index.md +++ b/files/en-us/learn/css/first_steps/how_css_is_structured/index.md @@ -471,7 +471,7 @@ Try adding comments in your CSS. ## White space -White space means actual spaces, tabs and new lines. Just as browsers ignore white space in HTML, browsers ignore white space inside CSS. The value of white space is how it can improve readability. +White space means actual spaces, tabs and new lines. Just as browsers ignore extra white space in HTML, browsers ignore extra white space inside CSS. The benefit of white space is that it improves readability. In the example below, each declaration (and rule start/end) has its own line. This is arguably a good way to write CSS. It makes it easier to maintain and understand CSS. @@ -512,17 +512,17 @@ div p + p { } ``` -The next example shows the equivalent CSS in a more compressed format. Although the two examples work the same, the one below is more difficult to read. +The next example shows the equivalent CSS in a more compressed format, with all extra white space removed. Although the two examples work the same, the one below is more difficult to read. ```css-nolint -body {font: 1em/150% Helvetica, Arial, sans-serif; padding: 1em; margin: 0 auto; max-width: 33em;} -@media (min-width: 70em) { body { font-size: 130%;}} +body{font:1em/150% Helvetica,Arial,sans-serif;padding:1em;margin:0 auto;max-width:33em;} +@media(min-width:70em){body{font-size:130%;}} -h1 {font-size: 1.5em;} +h1{font-size:1.5em;} -div p, #id:first-line {background-color: red; border-radius: 3px;} -div p {margin: 0; padding: 1em;} -div p + p {padding-top: 0;} +div p,#id:first-line{background-color:red;border-radius:3px;} +div p{margin:0;padding:1em;} +div p+p{padding-top:0;} ``` For your own projects, you will format your code according to personal preference. For team projects, you may find that a team or project has its own style guide. From 4524e28f0aa5fe3b4da3315c40bbdc8d99653da3 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Tue, 10 Sep 2024 20:57:51 -0400 Subject: [PATCH 065/129] Add pages for HTML*Element.willValidate (#35665) * Add pages for HTML*Element.willValidate * Reviews --- .../htmlbuttonelement/willvalidate/index.md | 35 +++++++++++++++++++ .../htmlfieldsetelement/willvalidate/index.md | 31 ++++++++++++++++ .../htmlinputelement/willvalidate/index.md | 35 +++++++++++++++++++ .../htmlobjectelement/willvalidate/index.md | 15 +++++--- .../en-us/web/api/htmloutputelement/index.md | 2 +- .../htmloutputelement/willvalidate/index.md | 31 ++++++++++++++++ .../htmlselectelement/willvalidate/index.md | 31 ++++++++++++++++ .../htmltextareaelement/willvalidate/index.md | 31 ++++++++++++++++ 8 files changed, 205 insertions(+), 6 deletions(-) create mode 100644 files/en-us/web/api/htmlbuttonelement/willvalidate/index.md create mode 100644 files/en-us/web/api/htmlfieldsetelement/willvalidate/index.md create mode 100644 files/en-us/web/api/htmlinputelement/willvalidate/index.md create mode 100644 files/en-us/web/api/htmloutputelement/willvalidate/index.md create mode 100644 files/en-us/web/api/htmlselectelement/willvalidate/index.md create mode 100644 files/en-us/web/api/htmltextareaelement/willvalidate/index.md diff --git a/files/en-us/web/api/htmlbuttonelement/willvalidate/index.md b/files/en-us/web/api/htmlbuttonelement/willvalidate/index.md new file mode 100644 index 000000000000000..157f5809920a44f --- /dev/null +++ b/files/en-us/web/api/htmlbuttonelement/willvalidate/index.md @@ -0,0 +1,35 @@ +--- +title: "HTMLButtonElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLButtonElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLButtonElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLButtonElement")}} interface indicates whether the {{htmlelement("button")}} element is a candidate for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). It is `false` if any conditions bar it from constraint validation, including: + +- Its {{domxref("HTMLButtonElement.type", "type")}} is `reset` or `button`; +- It has a {{HTMLElement("datalist")}} ancestor; +- The {{domxref("HTMLButtonElement.disabled", "disabled")}} property is `true`. + +## Value + +A boolean value. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLButtonElement.checkValidity()")}} +- {{HTMLElement("button")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmlfieldsetelement/willvalidate/index.md b/files/en-us/web/api/htmlfieldsetelement/willvalidate/index.md new file mode 100644 index 000000000000000..3d67251c9be146f --- /dev/null +++ b/files/en-us/web/api/htmlfieldsetelement/willvalidate/index.md @@ -0,0 +1,31 @@ +--- +title: "HTMLFieldSetElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLFieldSetElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLFieldSetElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLFieldSetElement")}} interface returns `false`, because {{HTMLElement("fieldset")}} elements are not candidates for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). + +## Value + +The boolean value `false`. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLFieldSetElement.checkValidity()")}} +- {{HTMLElement("fieldset")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmlinputelement/willvalidate/index.md b/files/en-us/web/api/htmlinputelement/willvalidate/index.md new file mode 100644 index 000000000000000..ed9e8ddc39aa2bb --- /dev/null +++ b/files/en-us/web/api/htmlinputelement/willvalidate/index.md @@ -0,0 +1,35 @@ +--- +title: "HTMLInputElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLInputElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLInputElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLInputElement")}} interface indicates whether the {{htmlelement("input")}} element is a candidate for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). It is `false` if any conditions bar it from constraint validation, including: + +- Its {{domxref("HTMLInputElement.type", "type")}} is one of `hidden`, `reset` or `button`; +- It has a {{HTMLElement("datalist")}} ancestor; +- Its {{domxref("HTMLInputElement.disabled", "disabled")}} property is `true`. + +## Value + +A boolean value. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLInputElement.checkValidity()")}} +- {{HTMLElement("input")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmlobjectelement/willvalidate/index.md b/files/en-us/web/api/htmlobjectelement/willvalidate/index.md index 5d2f4b2d2b4c778..56f2af15b0997f2 100644 --- a/files/en-us/web/api/htmlobjectelement/willvalidate/index.md +++ b/files/en-us/web/api/htmlobjectelement/willvalidate/index.md @@ -8,14 +8,11 @@ browser-compat: api.HTMLObjectElement.willValidate {{APIRef("HTML DOM")}} -The **`willValidate`** read-only property of -the {{domxref("HTMLObjectElement")}} interface returns a boolean value that -indicates whether the element is a candidate for constraint validation. Always false for -HTMLObjectElement objects. +The **`willValidate`** read-only property of the {{domxref("HTMLObjectElement")}} interface returns `false`, because {{HTMLElement("object")}} elements are not candidates for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). ## Value -A boolean value. +The boolean value `false`. ## Specifications @@ -24,3 +21,11 @@ A boolean value. ## Browser compatibility {{Compat}} + +## See also + +- {{domxref("HTMLObjectElement.checkValidity()")}} +- {{HTMLElement("object")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmloutputelement/index.md b/files/en-us/web/api/htmloutputelement/index.md index 36d240538fb1718..29cc9bb8a311387 100644 --- a/files/en-us/web/api/htmloutputelement/index.md +++ b/files/en-us/web/api/htmloutputelement/index.md @@ -34,7 +34,7 @@ _This interface also inherits properties from its parent, {{domxref("HTMLElement - {{domxref("HTMLOutputElement.value")}} - : A string representing the value of the contents of the elements. Behaves like the {{domxref("Node.textContent")}} property. - {{domxref("HTMLOutputElement.willValidate")}} {{ReadOnlyInline}} - - : A boolean value indicating whether the element is a candidate for constraint validation. + - : Returns a boolean value that indicates whether the element is a candidate for constraint validation. Always `false` for `HTMLOutputElement` objects. ## Instance methods diff --git a/files/en-us/web/api/htmloutputelement/willvalidate/index.md b/files/en-us/web/api/htmloutputelement/willvalidate/index.md new file mode 100644 index 000000000000000..583c366702a519e --- /dev/null +++ b/files/en-us/web/api/htmloutputelement/willvalidate/index.md @@ -0,0 +1,31 @@ +--- +title: "HTMLOutputElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLOutputElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLOutputElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLOutputElement")}} interface returns `false`, because {{HTMLElement("output")}} elements are not candidates for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). + +## Value + +The boolean value `false`. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLOutputElement.checkValidity()")}} +- {{HTMLElement("output")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmlselectelement/willvalidate/index.md b/files/en-us/web/api/htmlselectelement/willvalidate/index.md new file mode 100644 index 000000000000000..1a831a63ac2f357 --- /dev/null +++ b/files/en-us/web/api/htmlselectelement/willvalidate/index.md @@ -0,0 +1,31 @@ +--- +title: "HTMLSelectElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLSelectElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLSelectElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLSelectElement")}} interface indicates whether the {{htmlelement("select")}} element is a candidate for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). It is `false` if any conditions bar it from constraint validation, such as when its {{domxref("HTMLSelectElement.disabled", "disabled")}} property is `true`. + +## Value + +A boolean value. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLSelectElement.checkValidity()")}} +- {{HTMLElement("select")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) diff --git a/files/en-us/web/api/htmltextareaelement/willvalidate/index.md b/files/en-us/web/api/htmltextareaelement/willvalidate/index.md new file mode 100644 index 000000000000000..10fac66a528c7b8 --- /dev/null +++ b/files/en-us/web/api/htmltextareaelement/willvalidate/index.md @@ -0,0 +1,31 @@ +--- +title: "HTMLTextAreaElement: willValidate property" +short-title: willValidate +slug: Web/API/HTMLTextAreaElement/willValidate +page-type: web-api-instance-property +browser-compat: api.HTMLTextAreaElement.willValidate +--- + +{{APIRef("HTML DOM")}} + +The **`willValidate`** read-only property of the {{domxref("HTMLTextAreaElement")}} interface indicates whether the {{htmlelement("textarea")}} element is a candidate for [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). It is `false` if any conditions bar it from constraint validation, such as when its {{domxref("HTMLTextAreaElement.disabled", "disabled")}} or {{domxref("HTMLTextAreaElement.readOnly", "readOnly")}} property is `true`. + +## Value + +A boolean value. + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLTextAreaElement.checkValidity()")}} +- {{HTMLElement("textarea")}} +- {{HTMLElement("form")}} +- [Learn: Client-side form validation](/en-US/docs/Learn/Forms/Form_validation) +- [Guide: Constraint validation](/en-US/docs/Web/HTML/Constraint_validation) From 06b418a190b8e4a46682ab706d14984e7db34862 Mon Sep 17 00:00:00 2001 From: Onkar Khadangale <87750369+OnkarRuikar@users.noreply.github.com> Date: Wed, 11 Sep 2024 09:06:25 +0530 Subject: [PATCH 066/129] Synchronize with BCD v5.5.51 (#35730) * Synchronize with BCD v5.5.50 * Update index.md * Sync with the latest BCD --------- Co-authored-by: Joshua Chen --- .../web/api/audiodata/allocationsize/index.md | 4 +-- .../web/api/audiodata/audiodata/index.md | 4 +-- files/en-us/web/api/audiodata/clone/index.md | 4 +-- files/en-us/web/api/audiodata/close/index.md | 4 +-- files/en-us/web/api/audiodata/copyto/index.md | 4 +-- .../en-us/web/api/audiodata/duration/index.md | 4 +-- files/en-us/web/api/audiodata/format/index.md | 4 +-- files/en-us/web/api/audiodata/index.md | 26 +++++++++---------- .../api/audiodata/numberofchannels/index.md | 4 +-- .../web/api/audiodata/numberofframes/index.md | 4 +-- .../web/api/audiodata/samplerate/index.md | 4 +-- .../web/api/audiodata/timestamp/index.md | 4 +-- .../api/audiodecoder/audiodecoder/index.md | 4 +-- .../en-us/web/api/audiodecoder/close/index.md | 4 +-- .../web/api/audiodecoder/configure/index.md | 4 +-- .../web/api/audiodecoder/decode/index.md | 4 +-- .../api/audiodecoder/decodequeuesize/index.md | 4 +-- .../api/audiodecoder/dequeue_event/index.md | 4 +-- .../en-us/web/api/audiodecoder/flush/index.md | 4 +-- files/en-us/web/api/audiodecoder/index.md | 24 ++++++++--------- .../isconfigsupported_static/index.md | 4 +-- .../en-us/web/api/audiodecoder/reset/index.md | 4 +-- .../en-us/web/api/audiodecoder/state/index.md | 4 +-- .../api/audioencoder/audioencoder/index.md | 4 +-- .../en-us/web/api/audioencoder/close/index.md | 4 +-- .../web/api/audioencoder/configure/index.md | 4 +-- .../api/audioencoder/dequeue_event/index.md | 4 +-- .../web/api/audioencoder/encode/index.md | 4 +-- .../api/audioencoder/encodequeuesize/index.md | 4 +-- .../en-us/web/api/audioencoder/flush/index.md | 4 +-- files/en-us/web/api/audioencoder/index.md | 24 ++++++++--------- .../isconfigsupported_static/index.md | 4 +-- .../en-us/web/api/audioencoder/reset/index.md | 4 +-- .../en-us/web/api/audioencoder/state/index.md | 4 +-- .../api/document/fragmentdirective/index.md | 4 +-- files/en-us/web/api/document/index.md | 2 +- .../api/encodedaudiochunk/bytelength/index.md | 4 +-- .../web/api/encodedaudiochunk/copyto/index.md | 4 +-- .../api/encodedaudiochunk/duration/index.md | 4 +-- .../encodedaudiochunk/index.md | 4 +-- .../en-us/web/api/encodedaudiochunk/index.md | 16 +++++------- .../api/encodedaudiochunk/timestamp/index.md | 4 +-- .../web/api/encodedaudiochunk/type/index.md | 4 +-- .../en-us/web/api/fragmentdirective/index.md | 4 +-- files/en-us/web/api/paymentresponse/index.md | 12 ++++----- .../payerdetailchange_event/index.md | 5 +--- .../api/paymentresponse/payeremail/index.md | 5 +--- .../api/paymentresponse/payername/index.md | 5 +--- .../api/paymentresponse/payerphone/index.md | 5 +--- .../paymentresponse/shippingaddress/index.md | 5 +--- .../paymentresponse/shippingoption/index.md | 5 +--- files/en-us/web/api/pointer_events/index.md | 4 +-- .../api/pointerevent/altitudeangle/index.md | 4 +-- .../api/pointerevent/azimuthangle/index.md | 4 +-- files/en-us/web/api/pointerevent/index.md | 4 +-- .../api/url_fragment_text_directives/index.md | 3 +-- files/en-us/web/css/@media/index.md | 6 ++--- .../web/css/_doublecolon_target-text/index.md | 4 +-- .../web/html/attributes/autocomplete/index.md | 2 +- .../en-us/web/http/headers/expect-ct/index.md | 2 ++ .../web/http/headers/set-cookie/index.md | 2 +- .../global_objects/iterator/drop/index.md | 4 +-- .../global_objects/iterator/every/index.md | 4 +-- .../global_objects/iterator/filter/index.md | 4 +-- .../global_objects/iterator/find/index.md | 4 +-- .../global_objects/iterator/flatmap/index.md | 4 +-- .../global_objects/iterator/foreach/index.md | 4 +-- .../global_objects/iterator/from/index.md | 4 +-- .../global_objects/iterator/index.md | 26 +++++++++---------- .../global_objects/iterator/iterator/index.md | 4 +-- .../global_objects/iterator/map/index.md | 4 +-- .../global_objects/iterator/reduce/index.md | 4 +-- .../global_objects/iterator/some/index.md | 4 +-- .../global_objects/iterator/take/index.md | 4 +-- .../global_objects/iterator/toarray/index.md | 4 +-- .../partitioned_cookies/index.md | 4 --- 76 files changed, 134 insertions(+), 273 deletions(-) diff --git a/files/en-us/web/api/audiodata/allocationsize/index.md b/files/en-us/web/api/audiodata/allocationsize/index.md index 60247c6a8f3539c..ebd8b3e69c286e3 100644 --- a/files/en-us/web/api/audiodata/allocationsize/index.md +++ b/files/en-us/web/api/audiodata/allocationsize/index.md @@ -3,12 +3,10 @@ title: "AudioData: allocationSize() method" short-title: allocationSize() slug: Web/API/AudioData/allocationSize page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioData.allocationSize --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`allocationSize()`** method of the {{domxref("AudioData")}} interface returns the size in bytes required to hold the current sample as filtered by options passed into the method. diff --git a/files/en-us/web/api/audiodata/audiodata/index.md b/files/en-us/web/api/audiodata/audiodata/index.md index f59c11a7ff1c9f7..cacbddbcff5d29c 100644 --- a/files/en-us/web/api/audiodata/audiodata/index.md +++ b/files/en-us/web/api/audiodata/audiodata/index.md @@ -3,12 +3,10 @@ title: "AudioData: AudioData() constructor" short-title: AudioData() slug: Web/API/AudioData/AudioData page-type: web-api-constructor -status: - - experimental browser-compat: api.AudioData.AudioData --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioData()`** constructor creates a new {{domxref("AudioData")}} object which represents an individual audio sample. diff --git a/files/en-us/web/api/audiodata/clone/index.md b/files/en-us/web/api/audiodata/clone/index.md index 552b7af14bdaed0..57cdc867724c2c5 100644 --- a/files/en-us/web/api/audiodata/clone/index.md +++ b/files/en-us/web/api/audiodata/clone/index.md @@ -3,12 +3,10 @@ title: "AudioData: clone() method" short-title: clone() slug: Web/API/AudioData/clone page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioData.clone --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`clone()`** method of the {{domxref("AudioData")}} interface creates a new `AudioData` object with reference to the same media resource as the original. diff --git a/files/en-us/web/api/audiodata/close/index.md b/files/en-us/web/api/audiodata/close/index.md index f92be7d1611da80..717787794c8feaf 100644 --- a/files/en-us/web/api/audiodata/close/index.md +++ b/files/en-us/web/api/audiodata/close/index.md @@ -3,12 +3,10 @@ title: "AudioData: close() method" short-title: close() slug: Web/API/AudioData/close page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioData.close --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`close()`** method of the {{domxref("AudioData")}} interface clears all states and releases the reference to the media resource. diff --git a/files/en-us/web/api/audiodata/copyto/index.md b/files/en-us/web/api/audiodata/copyto/index.md index c343a7222634d1a..3e9026a83b7eb0d 100644 --- a/files/en-us/web/api/audiodata/copyto/index.md +++ b/files/en-us/web/api/audiodata/copyto/index.md @@ -3,12 +3,10 @@ title: "AudioData: copyTo() method" short-title: copyTo() slug: Web/API/AudioData/copyTo page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioData.copyTo --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`copyTo()`** method of the {{domxref("AudioData")}} interface copies a plane of an `AudioData` object to a destination buffer. diff --git a/files/en-us/web/api/audiodata/duration/index.md b/files/en-us/web/api/audiodata/duration/index.md index 7db4e35678d77bb..4afa93cabec182d 100644 --- a/files/en-us/web/api/audiodata/duration/index.md +++ b/files/en-us/web/api/audiodata/duration/index.md @@ -3,12 +3,10 @@ title: "AudioData: duration property" short-title: duration slug: Web/API/AudioData/duration page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.duration --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`duration`** read-only property of the {{domxref("AudioData")}} interface returns the duration in microseconds of this `AudioData` object. diff --git a/files/en-us/web/api/audiodata/format/index.md b/files/en-us/web/api/audiodata/format/index.md index d08b9bdf381b744..719511a3c9aea50 100644 --- a/files/en-us/web/api/audiodata/format/index.md +++ b/files/en-us/web/api/audiodata/format/index.md @@ -3,12 +3,10 @@ title: "AudioData: format property" short-title: format slug: Web/API/AudioData/format page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.format --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`format`** read-only property of the {{domxref("AudioData")}} interface returns the sample format of the `AudioData` object. diff --git a/files/en-us/web/api/audiodata/index.md b/files/en-us/web/api/audiodata/index.md index 938127cb6f2cc67..d4c3cf227830cca 100644 --- a/files/en-us/web/api/audiodata/index.md +++ b/files/en-us/web/api/audiodata/index.md @@ -2,12 +2,10 @@ title: AudioData slug: Web/API/AudioData page-type: web-api-interface -status: - - experimental browser-compat: api.AudioData --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioData`** interface of the [WebCodecs API](/en-US/docs/Web/API/WebCodecs_API) represents an audio sample. @@ -32,33 +30,33 @@ In planar format, the number of planes is equal to {{domxref("AudioData.numberOf ## Constructor -- {{domxref("AudioData.AudioData", "AudioData()")}} {{Experimental_Inline}} +- {{domxref("AudioData.AudioData", "AudioData()")}} - : Creates a new `AudioData` object. ## Instance properties -- {{domxref("AudioData.format")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.format")}} {{ReadOnlyInline}} - : Returns the sample format of the audio. -- {{domxref("AudioData.sampleRate")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.sampleRate")}} {{ReadOnlyInline}} - : Returns the sample rate of the audio in Hz. -- {{domxref("AudioData.numberOfFrames")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.numberOfFrames")}} {{ReadOnlyInline}} - : Returns the number of frames. -- {{domxref("AudioData.numberOfChannels")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.numberOfChannels")}} {{ReadOnlyInline}} - : Returns the number of audio channels. -- {{domxref("AudioData.duration")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.duration")}} {{ReadOnlyInline}} - : Returns the duration of the audio in microseconds. -- {{domxref("AudioData.timestamp")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioData.timestamp")}} {{ReadOnlyInline}} - : Returns the timestamp of the audio in microseconds. ## Instance methods -- {{domxref("AudioData.allocationSize()")}} {{Experimental_Inline}} +- {{domxref("AudioData.allocationSize()")}} - : Returns the number of bytes required to hold the sample as filtered by options passed into the method. -- {{domxref("AudioData.copyTo()")}} {{Experimental_Inline}} +- {{domxref("AudioData.copyTo()")}} - : Copies the samples from the specified plane of the `AudioData` object to the destination. -- {{domxref("AudioData.clone()")}} {{Experimental_Inline}} +- {{domxref("AudioData.clone()")}} - : Creates a new `AudioData` object with reference to the same media resource as the original. -- {{domxref("AudioData.close()")}} {{Experimental_Inline}} +- {{domxref("AudioData.close()")}} - : Clears all states and releases the reference to the media resource. ## Specifications diff --git a/files/en-us/web/api/audiodata/numberofchannels/index.md b/files/en-us/web/api/audiodata/numberofchannels/index.md index 27629aa3af6b46d..ad71497ef726a2e 100644 --- a/files/en-us/web/api/audiodata/numberofchannels/index.md +++ b/files/en-us/web/api/audiodata/numberofchannels/index.md @@ -3,12 +3,10 @@ title: "AudioData: numberOfChannels property" short-title: numberOfChannels slug: Web/API/AudioData/numberOfChannels page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.numberOfChannels --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`numberOfChannels`** read-only property of the {{domxref("AudioData")}} interface returns the number of channels in the `AudioData` object. diff --git a/files/en-us/web/api/audiodata/numberofframes/index.md b/files/en-us/web/api/audiodata/numberofframes/index.md index 6a56c91f06e0457..f8decd6aabc4d65 100644 --- a/files/en-us/web/api/audiodata/numberofframes/index.md +++ b/files/en-us/web/api/audiodata/numberofframes/index.md @@ -3,12 +3,10 @@ title: "AudioData: numberOfFrames property" short-title: numberOfFrames slug: Web/API/AudioData/numberOfFrames page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.numberOfFrames --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`numberOfFrames`** read-only property of the {{domxref("AudioData")}} interface returns the number of frames in the `AudioData` object. diff --git a/files/en-us/web/api/audiodata/samplerate/index.md b/files/en-us/web/api/audiodata/samplerate/index.md index 97a35e675ac4246..396f4e46b416d92 100644 --- a/files/en-us/web/api/audiodata/samplerate/index.md +++ b/files/en-us/web/api/audiodata/samplerate/index.md @@ -3,12 +3,10 @@ title: "AudioData: sampleRate property" short-title: sampleRate slug: Web/API/AudioData/sampleRate page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.sampleRate --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`sampleRate`** read-only property of the {{domxref("AudioData")}} interface returns the sample rate in Hz. diff --git a/files/en-us/web/api/audiodata/timestamp/index.md b/files/en-us/web/api/audiodata/timestamp/index.md index dc348072ad5d43b..d05fcf571353bb4 100644 --- a/files/en-us/web/api/audiodata/timestamp/index.md +++ b/files/en-us/web/api/audiodata/timestamp/index.md @@ -3,12 +3,10 @@ title: "AudioData: timestamp property" short-title: timestamp slug: Web/API/AudioData/timestamp page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioData.timestamp --- -{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`timestamp`** read-only property of the {{domxref("AudioData")}} interface returns the timestamp of this `AudioData` object. diff --git a/files/en-us/web/api/audiodecoder/audiodecoder/index.md b/files/en-us/web/api/audiodecoder/audiodecoder/index.md index c11288620c62ea8..da619bc4647771f 100644 --- a/files/en-us/web/api/audiodecoder/audiodecoder/index.md +++ b/files/en-us/web/api/audiodecoder/audiodecoder/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: AudioDecoder() constructor" short-title: AudioDecoder() slug: Web/API/AudioDecoder/AudioDecoder page-type: web-api-constructor -status: - - experimental browser-compat: api.AudioDecoder.AudioDecoder --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioDecoder()`** constructor creates a new {{domxref("AudioDecoder")}} object with the provided `init.output` callback assigned as the output callback, the provided `init.error` callback as the error callback, and the {{domxref("AudioDecoder.state")}} set to `"unconfigured"`. diff --git a/files/en-us/web/api/audiodecoder/close/index.md b/files/en-us/web/api/audiodecoder/close/index.md index bea8fe90377d05c..2bc8877b60d3088 100644 --- a/files/en-us/web/api/audiodecoder/close/index.md +++ b/files/en-us/web/api/audiodecoder/close/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: close() method" short-title: close() slug: Web/API/AudioDecoder/close page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioDecoder.close --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`close()`** method of the {{domxref("AudioDecoder")}} interface ends all pending work and releases system resources. diff --git a/files/en-us/web/api/audiodecoder/configure/index.md b/files/en-us/web/api/audiodecoder/configure/index.md index 743f8e93cee901e..63bf6608e454260 100644 --- a/files/en-us/web/api/audiodecoder/configure/index.md +++ b/files/en-us/web/api/audiodecoder/configure/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: configure() method" short-title: configure() slug: Web/API/AudioDecoder/configure page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioDecoder.configure --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`configure()`** method of the {{domxref("AudioDecoder")}} interface enqueues a control message to configure the audio decoder for decoding chunks. diff --git a/files/en-us/web/api/audiodecoder/decode/index.md b/files/en-us/web/api/audiodecoder/decode/index.md index 7cf7b11f62d89a9..7739de227185ca2 100644 --- a/files/en-us/web/api/audiodecoder/decode/index.md +++ b/files/en-us/web/api/audiodecoder/decode/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: decode() method" short-title: decode() slug: Web/API/AudioDecoder/decode page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioDecoder.decode --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`decode()`** method of the {{domxref("AudioDecoder")}} interface enqueues a control message to decode a given chunk of audio. diff --git a/files/en-us/web/api/audiodecoder/decodequeuesize/index.md b/files/en-us/web/api/audiodecoder/decodequeuesize/index.md index 7a675b838685051..4c7de465f0584d1 100644 --- a/files/en-us/web/api/audiodecoder/decodequeuesize/index.md +++ b/files/en-us/web/api/audiodecoder/decodequeuesize/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: decodeQueueSize property" short-title: decodeQueueSize slug: Web/API/AudioDecoder/decodeQueueSize page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioDecoder.decodeQueueSize --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`decodeQueueSize`** read-only property of the {{domxref("AudioDecoder")}} interface returns the number of pending decode requests in the queue. diff --git a/files/en-us/web/api/audiodecoder/dequeue_event/index.md b/files/en-us/web/api/audiodecoder/dequeue_event/index.md index ffcd59dc46453fc..5fcecea1b30f837 100644 --- a/files/en-us/web/api/audiodecoder/dequeue_event/index.md +++ b/files/en-us/web/api/audiodecoder/dequeue_event/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: dequeue event" short-title: dequeue slug: Web/API/AudioDecoder/dequeue_event page-type: web-api-event -status: - - experimental browser-compat: api.AudioDecoder.dequeue_event --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`dequeue`** event of the {{domxref("AudioDecoder")}} interface fires to signal a decrease in {{domxref("AudioDecoder.decodeQueueSize")}}. diff --git a/files/en-us/web/api/audiodecoder/flush/index.md b/files/en-us/web/api/audiodecoder/flush/index.md index 522a45d6b20ace1..07a81b097fd3678 100644 --- a/files/en-us/web/api/audiodecoder/flush/index.md +++ b/files/en-us/web/api/audiodecoder/flush/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: flush() method" short-title: flush() slug: Web/API/AudioDecoder/flush page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioDecoder.flush --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`flush()`** method of the {{domxref("AudioDecoder")}} interface returns a Promise that resolves once all pending messages in the queue have been completed. diff --git a/files/en-us/web/api/audiodecoder/index.md b/files/en-us/web/api/audiodecoder/index.md index 617b16bf3af55ec..6ac98bbcba6fc4e 100644 --- a/files/en-us/web/api/audiodecoder/index.md +++ b/files/en-us/web/api/audiodecoder/index.md @@ -2,12 +2,10 @@ title: AudioDecoder slug: Web/API/AudioDecoder page-type: web-api-interface -status: - - experimental browser-compat: api.AudioDecoder --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioDecoder`** interface of the {{domxref('WebCodecs API','','',' ')}} decodes chunks of audio. @@ -15,41 +13,41 @@ The **`AudioDecoder`** interface of the {{domxref('WebCodecs API','','',' ')}} d ## Constructor -- {{domxref("AudioDecoder.AudioDecoder", "AudioDecoder()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.AudioDecoder", "AudioDecoder()")}} - : Creates a new `AudioDecoder` object. ## Instance properties _Inherits properties from its parent, {{DOMxRef("EventTarget")}}._ -- {{domxref("AudioDecoder.decodeQueueSize")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.decodeQueueSize")}} {{ReadOnlyInline}} - : An integer representing the number of decode queue requests. -- {{domxref("AudioDecoder.state")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.state")}} {{ReadOnlyInline}} - : Represents the state of the underlying codec and whether it is configured for decoding. ### Events -- {{domxref("AudioDecoder.dequeue_event", "dequeue")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.dequeue_event", "dequeue")}} - : Fires to signal a decrease in {{domxref("AudioDecoder.decodeQueueSize")}}. ## Static methods -- {{domxref("AudioDecoder/isConfigSupported_static", "AudioDecoder.isConfigSupported()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder/isConfigSupported_static", "AudioDecoder.isConfigSupported()")}} - : Returns a promise indicating whether the provided `AudioDecoderConfig` is supported. ## Instance methods _Inherits methods from its parent, {{DOMxRef("EventTarget")}}._ -- {{domxref("AudioDecoder.configure()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.configure()")}} - : Enqueues a control message to configure the audio decoder for decoding chunks. -- {{domxref("AudioDecoder.decode()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.decode()")}} - : Enqueues a control message to decode a given chunk of audio. -- {{domxref("AudioDecoder.flush()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.flush()")}} - : Returns a promise that resolves once all pending messages in the queue have been completed. -- {{domxref("AudioDecoder.reset()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.reset()")}} - : Resets all states including configuration, control messages in the control message queue, and all pending callbacks. -- {{domxref("AudioDecoder.close()")}} {{Experimental_Inline}} +- {{domxref("AudioDecoder.close()")}} - : Ends all pending work and releases system resources. ## Specifications diff --git a/files/en-us/web/api/audiodecoder/isconfigsupported_static/index.md b/files/en-us/web/api/audiodecoder/isconfigsupported_static/index.md index f82808f8867a744..842eade7923849f 100644 --- a/files/en-us/web/api/audiodecoder/isconfigsupported_static/index.md +++ b/files/en-us/web/api/audiodecoder/isconfigsupported_static/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: isConfigSupported() static method" short-title: isConfigSupported() slug: Web/API/AudioDecoder/isConfigSupported_static page-type: web-api-static-method -status: - - experimental browser-compat: api.AudioDecoder.isConfigSupported_static --- -{{APIRef("WebCodecs API")}}{{SecureContext_Header}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{APIRef("WebCodecs API")}}{{SecureContext_Header}}{{AvailableInWorkers("window_and_dedicated")}} The **`isConfigSupported()`** static method of the {{domxref("AudioDecoder")}} interface checks if the given config is supported (that is, if {{domxref("AudioDecoder")}} objects can be successfully configured with the given config). diff --git a/files/en-us/web/api/audiodecoder/reset/index.md b/files/en-us/web/api/audiodecoder/reset/index.md index 459a7c4c5b0fc04..51a5560a27b601f 100644 --- a/files/en-us/web/api/audiodecoder/reset/index.md +++ b/files/en-us/web/api/audiodecoder/reset/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: reset() method" short-title: reset() slug: Web/API/AudioDecoder/reset page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioDecoder.reset --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`reset()`** method of the {{domxref("AudioDecoder")}} interface resets all states including configuration, control messages in the control message queue, and all pending callbacks. diff --git a/files/en-us/web/api/audiodecoder/state/index.md b/files/en-us/web/api/audiodecoder/state/index.md index 20039e3c85e0db7..d1f8e197d95f270 100644 --- a/files/en-us/web/api/audiodecoder/state/index.md +++ b/files/en-us/web/api/audiodecoder/state/index.md @@ -3,12 +3,10 @@ title: "AudioDecoder: state property" short-title: state slug: Web/API/AudioDecoder/state page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioDecoder.state --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}{{SeeCompatTable}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`state`** read-only property of the {{domxref("AudioDecoder")}} interface returns the current state of the underlying codec. diff --git a/files/en-us/web/api/audioencoder/audioencoder/index.md b/files/en-us/web/api/audioencoder/audioencoder/index.md index 33527d416a775e7..f3b9a9c4d84494d 100644 --- a/files/en-us/web/api/audioencoder/audioencoder/index.md +++ b/files/en-us/web/api/audioencoder/audioencoder/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: AudioEncoder() constructor" short-title: AudioEncoder() slug: Web/API/AudioEncoder/AudioEncoder page-type: web-api-constructor -status: - - experimental browser-compat: api.AudioEncoder.AudioEncoder --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioEncoder()`** constructor creates a new {{domxref("AudioEncoder")}} object with the provided `init.output` callback assigned as the output callback, the provided `init.error` callback as the error callback, and the {{domxref("AudioEncoder.state")}} set to `"unconfigured"`. diff --git a/files/en-us/web/api/audioencoder/close/index.md b/files/en-us/web/api/audioencoder/close/index.md index 42dc3861b162a0b..0d7427e3673e390 100644 --- a/files/en-us/web/api/audioencoder/close/index.md +++ b/files/en-us/web/api/audioencoder/close/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: close() method" short-title: close() slug: Web/API/AudioEncoder/close page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioEncoder.close --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`close()`** method of the {{domxref("AudioEncoder")}} interface ends all pending work and releases system resources. diff --git a/files/en-us/web/api/audioencoder/configure/index.md b/files/en-us/web/api/audioencoder/configure/index.md index 454413e03534d82..ec3db9b08b31a44 100644 --- a/files/en-us/web/api/audioencoder/configure/index.md +++ b/files/en-us/web/api/audioencoder/configure/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: configure() method" short-title: configure() slug: Web/API/AudioEncoder/configure page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioEncoder.configure --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`configure()`** method of the {{domxref("AudioEncoder")}} interface enqueues a control message to configure the audio encoder for encoding chunks. diff --git a/files/en-us/web/api/audioencoder/dequeue_event/index.md b/files/en-us/web/api/audioencoder/dequeue_event/index.md index 18421b1623fae5d..a1e9c0ca3055611 100644 --- a/files/en-us/web/api/audioencoder/dequeue_event/index.md +++ b/files/en-us/web/api/audioencoder/dequeue_event/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: dequeue event" short-title: dequeue slug: Web/API/AudioEncoder/dequeue_event page-type: web-api-event -status: - - experimental browser-compat: api.AudioEncoder.dequeue_event --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`dequeue`** event of the {{domxref("AudioEncoder")}} interface fires to signal a decrease in {{domxref("AudioEncoder.encodeQueueSize")}}. diff --git a/files/en-us/web/api/audioencoder/encode/index.md b/files/en-us/web/api/audioencoder/encode/index.md index ba927968a1c221a..119cdb36a2b2d0c 100644 --- a/files/en-us/web/api/audioencoder/encode/index.md +++ b/files/en-us/web/api/audioencoder/encode/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: encode() method" short-title: encode() slug: Web/API/AudioEncoder/encode page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioEncoder.encode --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`encode()`** method of the {{domxref("AudioEncoder")}} interface enqueues a control message to encode a given {{domxref("AudioData")}} object. diff --git a/files/en-us/web/api/audioencoder/encodequeuesize/index.md b/files/en-us/web/api/audioencoder/encodequeuesize/index.md index fe6c3caedae7a40..0200ec0177adbda 100644 --- a/files/en-us/web/api/audioencoder/encodequeuesize/index.md +++ b/files/en-us/web/api/audioencoder/encodequeuesize/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: encodeQueueSize property" short-title: encodeQueueSize slug: Web/API/AudioEncoder/encodeQueueSize page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioEncoder.encodeQueueSize --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`encodeQueueSize`** read-only property of the {{domxref("AudioEncoder")}} interface returns the number of pending encode requests in the queue. diff --git a/files/en-us/web/api/audioencoder/flush/index.md b/files/en-us/web/api/audioencoder/flush/index.md index 083e4cd250b0357..e6b9a18a7ec7743 100644 --- a/files/en-us/web/api/audioencoder/flush/index.md +++ b/files/en-us/web/api/audioencoder/flush/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: flush() method" short-title: flush() slug: Web/API/AudioEncoder/flush page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioEncoder.flush --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`flush()`** method of the {{domxref("AudioEncoder")}} interface returns a Promise that resolves once all pending messages in the queue have been completed. diff --git a/files/en-us/web/api/audioencoder/index.md b/files/en-us/web/api/audioencoder/index.md index 0f5f803647a56f9..31d3319776f2dc8 100644 --- a/files/en-us/web/api/audioencoder/index.md +++ b/files/en-us/web/api/audioencoder/index.md @@ -2,12 +2,10 @@ title: AudioEncoder slug: Web/API/AudioEncoder page-type: web-api-interface -status: - - experimental browser-compat: api.AudioEncoder --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{SecureContext_Header}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{SecureContext_Header}}{{AvailableInWorkers("window_and_dedicated")}} The **`AudioEncoder`** interface of the [WebCodecs API](/en-US/docs/Web/API/WebCodecs_API) encodes {{domxref("AudioData")}} objects. @@ -15,41 +13,41 @@ The **`AudioEncoder`** interface of the [WebCodecs API](/en-US/docs/Web/API/WebC ## Constructor -- {{domxref("AudioEncoder.AudioEncoder", "AudioEncoder()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.AudioEncoder", "AudioEncoder()")}} - : Creates a new `AudioEncoder` object. ## Instance properties _Inherits properties from its parent, {{DOMxRef("EventTarget")}}._ -- {{domxref("AudioEncoder.encodeQueueSize")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.encodeQueueSize")}} {{ReadOnlyInline}} - : An integer representing the number of encode queue requests. -- {{domxref("AudioEncoder.state")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.state")}} {{ReadOnlyInline}} - : Represents the state of the underlying codec and whether it is configured for encoding. ### Events -- {{domxref("AudioEncoder.dequeue_event", "dequeue")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.dequeue_event", "dequeue")}} - : Fires to signal a decrease in {{domxref("AudioEncoder.encodeQueueSize")}}. ## Static methods -- {{domxref("AudioEncoder.isConfigSupported_static", "AudioEncoder.isConfigSupported()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.isConfigSupported_static", "AudioEncoder.isConfigSupported()")}} - : Returns a promise indicating whether the provided `AudioEncoderConfig` is supported. ## Instance methods _Inherits methods from its parent, {{DOMxRef("EventTarget")}}._ -- {{domxref("AudioEncoder.configure()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.configure()")}} - : Enqueues a control message to configure the audio encoder for encoding chunks. -- {{domxref("AudioEncoder.encode()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.encode()")}} - : Enqueues a control message to encode a given {{domxref("AudioData")}} objects. -- {{domxref("AudioEncoder.flush()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.flush()")}} - : Returns a promise that resolves once all pending messages in the queue have been completed. -- {{domxref("AudioEncoder.reset()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.reset()")}} - : Resets all states including configuration, control messages in the control message queue, and all pending callbacks. -- {{domxref("AudioEncoder.close()")}} {{Experimental_Inline}} +- {{domxref("AudioEncoder.close()")}} - : Ends all pending work and releases system resources. ## Specifications diff --git a/files/en-us/web/api/audioencoder/isconfigsupported_static/index.md b/files/en-us/web/api/audioencoder/isconfigsupported_static/index.md index f5982b92dd2519e..b9ac2819f27b563 100644 --- a/files/en-us/web/api/audioencoder/isconfigsupported_static/index.md +++ b/files/en-us/web/api/audioencoder/isconfigsupported_static/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: isConfigSupported() static method" short-title: isConfigSupported() slug: Web/API/AudioEncoder/isConfigSupported_static page-type: web-api-static-method -status: - - experimental browser-compat: api.AudioEncoder.isConfigSupported_static --- -{{APIRef("WebCodecs API")}}{{SecureContext_Header}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{SecureContext_Header}}{{AvailableInWorkers("window_and_dedicated")}} The **`isConfigSupported()`** static method of the {{domxref("AudioEncoder")}} interface checks if the given config is supported (that is, if {{domxref("AudioEncoder")}} objects can be successfully configured with the given config). diff --git a/files/en-us/web/api/audioencoder/reset/index.md b/files/en-us/web/api/audioencoder/reset/index.md index 74301ac966fab1b..1ff420a37a251ee 100644 --- a/files/en-us/web/api/audioencoder/reset/index.md +++ b/files/en-us/web/api/audioencoder/reset/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: reset() method" short-title: reset() slug: Web/API/AudioEncoder/reset page-type: web-api-instance-method -status: - - experimental browser-compat: api.AudioEncoder.reset --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`reset()`** method of the {{domxref("AudioEncoder")}} interface resets all states including configuration, control messages in the control message queue, and all pending callbacks. diff --git a/files/en-us/web/api/audioencoder/state/index.md b/files/en-us/web/api/audioencoder/state/index.md index 8c533003e662738..850b03c123ae58d 100644 --- a/files/en-us/web/api/audioencoder/state/index.md +++ b/files/en-us/web/api/audioencoder/state/index.md @@ -3,12 +3,10 @@ title: "AudioEncoder: state property" short-title: state slug: Web/API/AudioEncoder/state page-type: web-api-instance-property -status: - - experimental browser-compat: api.AudioEncoder.state --- -{{securecontext_header}}{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`state`** read-only property of the {{domxref("AudioEncoder")}} interface returns the current state of the underlying codec. diff --git a/files/en-us/web/api/document/fragmentdirective/index.md b/files/en-us/web/api/document/fragmentdirective/index.md index b439f1594e639f8..92593ba004aa26b 100644 --- a/files/en-us/web/api/document/fragmentdirective/index.md +++ b/files/en-us/web/api/document/fragmentdirective/index.md @@ -3,12 +3,10 @@ title: "Document: fragmentDirective property" short-title: fragmentDirective slug: Web/API/Document/fragmentDirective page-type: web-api-instance-property -status: - - experimental browser-compat: api.Document.fragmentDirective --- -{{APIRef("URL Fragment Text Directives")}}{{SeeCompatTable}} +{{APIRef("URL Fragment Text Directives")}} The **`fragmentDirective`** read-only property of the {{domxref("Document")}} interface returns the {{domxref("FragmentDirective")}} for the current document. diff --git a/files/en-us/web/api/document/index.md b/files/en-us/web/api/document/index.md index cada251cf9dd12b..5d0f2154974f89e 100644 --- a/files/en-us/web/api/document/index.md +++ b/files/en-us/web/api/document/index.md @@ -59,7 +59,7 @@ _This interface also inherits from the {{DOMxRef("Node")}} and {{DOMxRef("EventT - : Returns the {{DOMxRef("FontFaceSet")}} interface of the current document. - {{DOMxRef("Document.forms")}} {{ReadOnlyInline}} - : Returns an {{DOMxRef("HTMLCollection")}} of the {{HTMLElement("form")}} elements in the document. -- {{DOMxRef("Document.fragmentDirective")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{DOMxRef("Document.fragmentDirective")}} {{ReadOnlyInline}} - : Returns the {{domxref("FragmentDirective")}} for the current document. - {{DOMxRef("Document.fullscreenElement")}} {{ReadOnlyInline}} - : The element that's currently in full screen mode for this document. diff --git a/files/en-us/web/api/encodedaudiochunk/bytelength/index.md b/files/en-us/web/api/encodedaudiochunk/bytelength/index.md index 812d4ce16b51905..a85cf4306c9a056 100644 --- a/files/en-us/web/api/encodedaudiochunk/bytelength/index.md +++ b/files/en-us/web/api/encodedaudiochunk/bytelength/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: byteLength property" short-title: byteLength slug: Web/API/EncodedAudioChunk/byteLength page-type: web-api-instance-property -status: - - experimental browser-compat: api.EncodedAudioChunk.byteLength --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`byteLength`** read-only property of the {{domxref("EncodedAudioChunk")}} interface returns the length in bytes of the encoded audio data. diff --git a/files/en-us/web/api/encodedaudiochunk/copyto/index.md b/files/en-us/web/api/encodedaudiochunk/copyto/index.md index 56f927f24edd581..2a369362ec58b02 100644 --- a/files/en-us/web/api/encodedaudiochunk/copyto/index.md +++ b/files/en-us/web/api/encodedaudiochunk/copyto/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: copyTo() method" short-title: copyTo() slug: Web/API/EncodedAudioChunk/copyTo page-type: web-api-instance-method -status: - - experimental browser-compat: api.EncodedAudioChunk.copyTo --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`copyTo()`** method of the {{domxref("EncodedAudioChunk")}} interface copies the encoded chunk of audio data. diff --git a/files/en-us/web/api/encodedaudiochunk/duration/index.md b/files/en-us/web/api/encodedaudiochunk/duration/index.md index b6b44bf0279d192..0284c94da79622d 100644 --- a/files/en-us/web/api/encodedaudiochunk/duration/index.md +++ b/files/en-us/web/api/encodedaudiochunk/duration/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: duration property" short-title: duration slug: Web/API/EncodedAudioChunk/duration page-type: web-api-instance-property -status: - - experimental browser-compat: api.EncodedAudioChunk.duration --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`duration`** read-only property of the {{domxref("EncodedAudioChunk")}} interface returns an integer indicating the duration of the audio in microseconds. diff --git a/files/en-us/web/api/encodedaudiochunk/encodedaudiochunk/index.md b/files/en-us/web/api/encodedaudiochunk/encodedaudiochunk/index.md index 8987945df0a8823..0418fac28dc7c00 100644 --- a/files/en-us/web/api/encodedaudiochunk/encodedaudiochunk/index.md +++ b/files/en-us/web/api/encodedaudiochunk/encodedaudiochunk/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: EncodedAudioChunk() constructor" short-title: EncodedAudioChunk() slug: Web/API/EncodedAudioChunk/EncodedAudioChunk page-type: web-api-constructor -status: - - experimental browser-compat: api.EncodedAudioChunk.EncodedAudioChunk --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`EncodedAudioChunk()`** constructor creates a new {{domxref("EncodedAudioChunk")}} object representing a chunk of encoded audio. diff --git a/files/en-us/web/api/encodedaudiochunk/index.md b/files/en-us/web/api/encodedaudiochunk/index.md index d561575008936bb..041f37f61c29267 100644 --- a/files/en-us/web/api/encodedaudiochunk/index.md +++ b/files/en-us/web/api/encodedaudiochunk/index.md @@ -2,34 +2,32 @@ title: EncodedAudioChunk slug: Web/API/EncodedAudioChunk page-type: web-api-interface -status: - - experimental browser-compat: api.EncodedAudioChunk --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`EncodedAudioChunk`** interface of the {{domxref('WebCodecs API','','',' ')}} represents a chunk of encoded audio data. ## Constructor -- {{domxref("EncodedAudioChunk.EncodedAudioChunk", "EncodedAudioChunk()")}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.EncodedAudioChunk", "EncodedAudioChunk()")}} - : Creates a new `EncodedAudioChunk` object. ## Instance properties -- {{domxref("EncodedAudioChunk.type")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.type")}} {{ReadOnlyInline}} - : Returns a string indicating whether this chunk of data is a key chunk. -- {{domxref("EncodedAudioChunk.timestamp")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.timestamp")}} {{ReadOnlyInline}} - : Returns an integer representing the timestamp of the audio in microseconds. -- {{domxref("EncodedAudioChunk.duration")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.duration")}} {{ReadOnlyInline}} - : Returns an integer representing the duration of the audio in microseconds. -- {{domxref("EncodedAudioChunk.byteLength")}} {{ReadOnlyInline}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.byteLength")}} {{ReadOnlyInline}} - : Returns an integer representing the length of the audio in bytes. ## Instance methods -- {{domxref("EncodedAudioChunk.copyTo()")}} {{Experimental_Inline}} +- {{domxref("EncodedAudioChunk.copyTo()")}} - : Copies the encoded audio data. ## Specifications diff --git a/files/en-us/web/api/encodedaudiochunk/timestamp/index.md b/files/en-us/web/api/encodedaudiochunk/timestamp/index.md index 1782461a03d0ce2..442fe9a969fa9c4 100644 --- a/files/en-us/web/api/encodedaudiochunk/timestamp/index.md +++ b/files/en-us/web/api/encodedaudiochunk/timestamp/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: timestamp property" short-title: timestamp slug: Web/API/EncodedAudioChunk/timestamp page-type: web-api-instance-property -status: - - experimental browser-compat: api.EncodedAudioChunk.timestamp --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`timestamp`** read-only property of the {{domxref("EncodedAudioChunk")}} interface returns an integer indicating the timestamp of the audio in microseconds. diff --git a/files/en-us/web/api/encodedaudiochunk/type/index.md b/files/en-us/web/api/encodedaudiochunk/type/index.md index 91d3194085107d9..be84e3596600e34 100644 --- a/files/en-us/web/api/encodedaudiochunk/type/index.md +++ b/files/en-us/web/api/encodedaudiochunk/type/index.md @@ -3,12 +3,10 @@ title: "EncodedAudioChunk: type property" short-title: type slug: Web/API/EncodedAudioChunk/type page-type: web-api-instance-property -status: - - experimental browser-compat: api.EncodedAudioChunk.type --- -{{APIRef("WebCodecs API")}}{{SeeCompatTable}}{{AvailableInWorkers("window_and_dedicated")}} +{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}} The **`type`** read-only property of the {{domxref("EncodedAudioChunk")}} interface returns a value indicating whether the audio chunk is a key chunk, which does not relying on other frames for decoding. diff --git a/files/en-us/web/api/fragmentdirective/index.md b/files/en-us/web/api/fragmentdirective/index.md index cb7276e4a0637c5..a67b6e180c7d8c2 100644 --- a/files/en-us/web/api/fragmentdirective/index.md +++ b/files/en-us/web/api/fragmentdirective/index.md @@ -2,12 +2,10 @@ title: FragmentDirective slug: Web/API/FragmentDirective page-type: web-api-interface -status: - - experimental browser-compat: api.FragmentDirective --- -{{APIRef("URL Fragment Text Directives")}}{{SeeCompatTable}} +{{APIRef("URL Fragment Text Directives")}} The **`FragmentDirective`** interface is an object exposed for feature detectability, that is, whether or not a browser supports text fragments. diff --git a/files/en-us/web/api/paymentresponse/index.md b/files/en-us/web/api/paymentresponse/index.md index 808d0516847ba40..f001f805683ae60 100644 --- a/files/en-us/web/api/paymentresponse/index.md +++ b/files/en-us/web/api/paymentresponse/index.md @@ -17,17 +17,17 @@ The **`PaymentResponse`** interface of the [Payment Request API](/en-US/docs/Web - : Returns a JSON-serializable object that provides a payment method specific message used by the merchant to process the transaction and determine successful fund transfer. The contents of the object depend on the payment method being used. Developers need to consult whomever controls the URL for the expected shape of the details object. - {{domxref('PaymentResponse.methodName')}} {{ReadOnlyInline}} - : Returns the payment method identifier for the payment method that the user selected, for example, Visa, Mastercard, Paypal, etc. -- {{domxref('PaymentResponse.payerEmail')}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} +- {{domxref('PaymentResponse.payerEmail')}} {{ReadOnlyInline}} - : Returns the email address supplied by the user. This option is only present when the `requestPayerEmail` option is set to `true` in the `options` parameter of the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor. -- {{domxref('PaymentResponse.payerName')}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} +- {{domxref('PaymentResponse.payerName')}} {{ReadOnlyInline}} - : Returns the name supplied by the user. This option is only present when the `requestPayerName` option is set to true in the `options` parameter of the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor. -- {{domxref('PaymentResponse.payerPhone')}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} +- {{domxref('PaymentResponse.payerPhone')}} {{ReadOnlyInline}} - : Returns the phone number supplied by the user. This option is only present when the `requestPayerPhone` option is set to `true` in the `options` parameter of the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor. - {{domxref('PaymentResponse.requestId')}} {{ReadOnlyInline}} - : Returns the identifier of the {{domxref('PaymentRequest')}} that produced the current response. This is the same value supplied in the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor by `details.id`. -- {{domxref('PaymentResponse.shippingAddress')}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} +- {{domxref('PaymentResponse.shippingAddress')}} {{ReadOnlyInline}} - : Returns the shipping Address supplied by the user. This option is only present when the `requestShipping` option is set to `true` in the `options` parameter of the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor. -- {{domxref('PaymentResponse.shippingOption')}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} +- {{domxref('PaymentResponse.shippingOption')}} {{ReadOnlyInline}} - : Returns the ID attribute of the shipping option selected by the user. This option is only present when the `requestShipping` option is set to `true` in the `options` parameter of the {{domxref('PaymentRequest.PaymentRequest','PaymentRequest()')}} constructor. ## Instance methods @@ -43,7 +43,7 @@ The **`PaymentResponse`** interface of the [Payment Request API](/en-US/docs/Web Listen to this event using [`addEventListener()`](/en-US/docs/Web/API/EventTarget/addEventListener) or by assigning an event listener to the `oneventname` property of this interface. -- [`payerdetailchange`](/en-US/docs/Web/API/PaymentResponse/payerdetailchange_event) {{Deprecated_Inline}} {{Non-standard_Inline}} +- [`payerdetailchange`](/en-US/docs/Web/API/PaymentResponse/payerdetailchange_event) - : Fired during a retry when the user makes changes to their personal information while filling out a payment request form. Allows the developer to revalidate any requested user data (e.g., the phone number or the email address) if it changes. ## Specifications diff --git a/files/en-us/web/api/paymentresponse/payerdetailchange_event/index.md b/files/en-us/web/api/paymentresponse/payerdetailchange_event/index.md index e511a755dc9b565..c871f21e22ba5b6 100644 --- a/files/en-us/web/api/paymentresponse/payerdetailchange_event/index.md +++ b/files/en-us/web/api/paymentresponse/payerdetailchange_event/index.md @@ -3,13 +3,10 @@ title: "PaymentResponse: payerdetailchange event" short-title: payerdetailchange slug: Web/API/PaymentResponse/payerdetailchange_event page-type: web-api-event -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.payerdetailchange_event --- -{{APIRef("Payment Request API")}}{{SecureContext_Header}}{{Deprecated_Header}}{{Non-standard_Header}} +{{APIRef("Payment Request API")}}{{SecureContext_Header}} A **`payerdetailchange`** event is fired by the [Payment Request API](/en-US/docs/Web/API/Payment_Request_API) to a {{domxref("PaymentResponse")}} object when the user makes changes to their personal information while filling out a payment request form. This can happen when the payer is retrying to submit its details after an error has been detected. diff --git a/files/en-us/web/api/paymentresponse/payeremail/index.md b/files/en-us/web/api/paymentresponse/payeremail/index.md index f020087aae6aa8c..04acaf51206095d 100644 --- a/files/en-us/web/api/paymentresponse/payeremail/index.md +++ b/files/en-us/web/api/paymentresponse/payeremail/index.md @@ -3,13 +3,10 @@ title: "PaymentResponse: payerEmail property" short-title: payerEmail slug: Web/API/PaymentResponse/payerEmail page-type: web-api-instance-property -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.payerEmail --- -{{securecontext_header}}{{APIRef("Payment Request API")}}{{Deprecated_header}}{{Non-standard_header}} +{{securecontext_header}}{{APIRef("Payment Request API")}} The `payerEmail` read-only property of the {{domxref("PaymentResponse")}} interface returns the email address supplied by the user. This option is only present diff --git a/files/en-us/web/api/paymentresponse/payername/index.md b/files/en-us/web/api/paymentresponse/payername/index.md index 548d5f4bd556262..930359c1420763d 100644 --- a/files/en-us/web/api/paymentresponse/payername/index.md +++ b/files/en-us/web/api/paymentresponse/payername/index.md @@ -3,13 +3,10 @@ title: "PaymentRequest: payerName property" short-title: payerName slug: Web/API/PaymentResponse/payerName page-type: web-api-instance-property -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.payerName --- -{{securecontext_header}}{{APIRef("Payment Request API")}}{{Deprecated_header}}{{Non-standard_header}} +{{securecontext_header}}{{APIRef("Payment Request API")}} The **`payerName`** read-only property of the {{domxref("PaymentResponse")}} interface returns the name supplied by the user. This diff --git a/files/en-us/web/api/paymentresponse/payerphone/index.md b/files/en-us/web/api/paymentresponse/payerphone/index.md index 2270859dff0c12c..e738f898fd0c54b 100644 --- a/files/en-us/web/api/paymentresponse/payerphone/index.md +++ b/files/en-us/web/api/paymentresponse/payerphone/index.md @@ -3,13 +3,10 @@ title: "PayerResponse: payerPhone property" short-title: payerPhone slug: Web/API/PaymentResponse/payerPhone page-type: web-api-instance-property -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.payerPhone --- -{{securecontext_header}}{{APIRef("Payment Request API")}}{{Deprecated_header}}{{Non-standard_header}} +{{securecontext_header}}{{APIRef("Payment Request API")}} The `payerPhone` read-only property of the {{domxref("PaymentResponse")}} interface returns the phone number supplied by the user. This option is only present diff --git a/files/en-us/web/api/paymentresponse/shippingaddress/index.md b/files/en-us/web/api/paymentresponse/shippingaddress/index.md index d33b0961b1734bb..eabeb597085fd6f 100644 --- a/files/en-us/web/api/paymentresponse/shippingaddress/index.md +++ b/files/en-us/web/api/paymentresponse/shippingaddress/index.md @@ -3,13 +3,10 @@ title: "PaymentResponse: shippingAddress property" short-title: shippingAddress slug: Web/API/PaymentResponse/shippingAddress page-type: web-api-instance-property -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.shippingAddress --- -{{securecontext_header}}{{APIRef("Payment Request API")}}{{Deprecated_header}}{{Non-standard_header}} +{{securecontext_header}}{{APIRef("Payment Request API")}} The **`shippingAddress`** read-only property of the `PaymentRequest` interface returns a {{domxref('PaymentAddress')}} object diff --git a/files/en-us/web/api/paymentresponse/shippingoption/index.md b/files/en-us/web/api/paymentresponse/shippingoption/index.md index 3d6a70d536eca01..a2833f0d5a15c6a 100644 --- a/files/en-us/web/api/paymentresponse/shippingoption/index.md +++ b/files/en-us/web/api/paymentresponse/shippingoption/index.md @@ -3,13 +3,10 @@ title: "PaymentResponse: shippingOption property" short-title: shippingOption slug: Web/API/PaymentResponse/shippingOption page-type: web-api-instance-property -status: - - deprecated - - non-standard browser-compat: api.PaymentResponse.shippingOption --- -{{securecontext_header}}{{APIRef("Payment Request API")}}{{Deprecated_header}}{{Non-standard_header}} +{{securecontext_header}}{{APIRef("Payment Request API")}} The **`shippingOption`** read-only property of the `PaymentRequest` interface returns the ID attribute of the shipping diff --git a/files/en-us/web/api/pointer_events/index.md b/files/en-us/web/api/pointer_events/index.md index 406f6c6bc40b460..82463cd13fa7963 100644 --- a/files/en-us/web/api/pointer_events/index.md +++ b/files/en-us/web/api/pointer_events/index.md @@ -62,9 +62,9 @@ The following sub-sections contain short descriptions of each interface and prop The {{domxref("PointerEvent")}} interface extends the {{domxref("MouseEvent")}} interface and has the following properties. -- {{ domxref('PointerEvent.altitudeAngle', 'altitudeAngle')}} {{ReadOnlyInline}} {{experimental_inline}} +- {{ domxref('PointerEvent.altitudeAngle', 'altitudeAngle')}} {{ReadOnlyInline}} - : Represents the angle between a transducer (a pointer or stylus) axis and the X-Y plane of a device screen. -- {{ domxref('PointerEvent.azimuthAngle', 'azimuthAngle')}} {{ReadOnlyInline}} {{experimental_inline}} +- {{ domxref('PointerEvent.azimuthAngle', 'azimuthAngle')}} {{ReadOnlyInline}} - : Represents the angle between the Y-Z plane and the plane containing both the transducer (a pointer or stylus) axis and the Y axis. - {{domxref('PointerEvent.persistentDeviceId')}} {{ReadOnlyInline}} {{experimental_inline}} - : A unique identifier for the pointing device generating the `PointerEvent`. diff --git a/files/en-us/web/api/pointerevent/altitudeangle/index.md b/files/en-us/web/api/pointerevent/altitudeangle/index.md index 81d0c1c6408869d..ce40b41d6c34670 100644 --- a/files/en-us/web/api/pointerevent/altitudeangle/index.md +++ b/files/en-us/web/api/pointerevent/altitudeangle/index.md @@ -3,12 +3,10 @@ title: "PointerEvent: altitudeAngle property" short-title: altitudeAngle slug: Web/API/PointerEvent/altitudeAngle page-type: web-api-instance-property -status: - - experimental browser-compat: api.PointerEvent.altitudeAngle --- -{{ APIRef("Pointer Events") }}{{SeeCompatTable}} +{{ APIRef("Pointer Events") }} The **`altitudeAngle`** read-only property of the {{domxref("PointerEvent")}} interface represents the angle between a transducer (a pointer or stylus) axis and the X-Y plane of a device screen. The altitude angle describes whether the transducer is perpendicular to the screen, parallel, or at some angle in between. diff --git a/files/en-us/web/api/pointerevent/azimuthangle/index.md b/files/en-us/web/api/pointerevent/azimuthangle/index.md index 0c3541ff718d5ab..93aeb3c0cebc14c 100644 --- a/files/en-us/web/api/pointerevent/azimuthangle/index.md +++ b/files/en-us/web/api/pointerevent/azimuthangle/index.md @@ -3,12 +3,10 @@ title: "PointerEvent: azimuthAngle property" short-title: azimuthAngle slug: Web/API/PointerEvent/azimuthAngle page-type: web-api-instance-property -status: - - experimental browser-compat: api.PointerEvent.azimuthAngle --- -{{ APIRef("Pointer Events") }}{{SeeCompatTable}} +{{ APIRef("Pointer Events") }} The **`azimuthAngle`** read-only property of the {{domxref("PointerEvent")}} interface represents the angle between the Y-Z plane and the plane containing both the transducer (pointer or stylus) axis and the Y axis. diff --git a/files/en-us/web/api/pointerevent/index.md b/files/en-us/web/api/pointerevent/index.md index ee6a65bd668cfe1..3faa46bc93fc5ab 100644 --- a/files/en-us/web/api/pointerevent/index.md +++ b/files/en-us/web/api/pointerevent/index.md @@ -24,9 +24,9 @@ A pointer's _hit test_ is the process a browser uses to determine the target ele _This interface inherits properties from {{domxref("MouseEvent")}} and {{domxref("Event")}}._ -- {{domxref('PointerEvent.altitudeAngle')}} {{ReadOnlyInline}} {{experimental_inline}} +- {{domxref('PointerEvent.altitudeAngle')}} {{ReadOnlyInline}} - : Represents the angle between a transducer (a pointer or stylus) axis and the X-Y plane of a device screen. -- {{domxref('PointerEvent.azimuthAngle')}} {{ReadOnlyInline}} {{experimental_inline}} +- {{domxref('PointerEvent.azimuthAngle')}} {{ReadOnlyInline}} - : Represents the angle between the Y-Z plane and the plane containing both the transducer (a pointer or stylus) axis and the Y axis. - {{domxref('PointerEvent.persistentDeviceId')}} {{ReadOnlyInline}} {{experimental_inline}} - : A unique identifier for the pointing device generating the `PointerEvent`. diff --git a/files/en-us/web/api/url_fragment_text_directives/index.md b/files/en-us/web/api/url_fragment_text_directives/index.md index 38e9e0e3b3c7ef8..87043b2865bc643 100644 --- a/files/en-us/web/api/url_fragment_text_directives/index.md +++ b/files/en-us/web/api/url_fragment_text_directives/index.md @@ -3,13 +3,12 @@ title: URL Fragment Text Directives slug: Web/API/URL_Fragment_Text_Directives page-type: web-api-overview browser-compat: - - html.elements.a.text_fragments - api.Document.fragmentDirective - api.FragmentDirective - css.selectors.target-text --- -{{DefaultAPISidebar("URL Fragment Text Directives")}}{{SeeCompatTable}} +{{DefaultAPISidebar("URL Fragment Text Directives")}} The **URL fragment text directives** API allows web apps to interact with _text fragments_ in the URL. [Text fragments](/en-US/docs/Web/URI/Fragment/Text_fragments) allow linking directly to a specific portion of text in a web document, without requiring the author to annotate it with an ID, using a particular syntax in the URL fragment. diff --git a/files/en-us/web/css/@media/index.md b/files/en-us/web/css/@media/index.md index fed8d3ef700f347..6bd039dc80fe07f 100644 --- a/files/en-us/web/css/@media/index.md +++ b/files/en-us/web/css/@media/index.md @@ -120,12 +120,12 @@ Media feature expressions test for their presence or value, and are entirely opt - {{cssxref("@media/prefers-contrast", "prefers-contrast")}} - : Detects if the user has requested the system increase or decrease the amount of contrast between adjacent colors. Added in Media Queries Level 5. -- {{cssxref("@media/prefers-reduced-data", "prefers-reduced-data")}} {{experimental_inline}} +- {{cssxref("@media/prefers-reduced-data", "prefers-reduced-data")}} - : Detects if the user has requested the web content that consumes less internet traffic. - {{cssxref("@media/prefers-reduced-motion", "prefers-reduced-motion")}} - : The user prefers less motion on the page. Added in Media Queries Level 5. -- {{cssxref("@media/prefers-reduced-transparency", "prefers-reduced-transparency")}} {{experimental_inline}} +- {{cssxref("@media/prefers-reduced-transparency", "prefers-reduced-transparency")}} - : Detects if a user has enabled a setting on their device to reduce the transparent or translucent layer effects used on the device. - {{cssxref("@media/resolution", "resolution")}} - : Pixel density of the output device. @@ -134,7 +134,7 @@ Media feature expressions test for their presence or value, and are entirely opt - {{cssxref("@media/scripting", "scripting")}} - : Detects whether scripting (i.e. JavaScript) is available. Added in Media Queries Level 5. -- {{cssxref("@media/shape", "shape")}} {{experimental_inline}} +- {{cssxref("@media/shape", "shape")}} - : Detects the shape of the device to distinguish rectangular and round displays. - {{cssxref("@media/update", "update")}} - : How frequently the output device can modify the appearance of content. diff --git a/files/en-us/web/css/_doublecolon_target-text/index.md b/files/en-us/web/css/_doublecolon_target-text/index.md index 1c96459a23e6855..7e8d326dba0f5fd 100644 --- a/files/en-us/web/css/_doublecolon_target-text/index.md +++ b/files/en-us/web/css/_doublecolon_target-text/index.md @@ -2,12 +2,10 @@ title: "::target-text" slug: Web/CSS/::target-text page-type: css-pseudo-element -status: - - experimental browser-compat: css.selectors.target-text --- -{{CSSRef}}{{SeeCompatTable}} +{{CSSRef}} The **`::target-text`** [CSS](/en-US/docs/Web/CSS) [pseudo-element](/en-US/docs/Web/CSS/Pseudo-elements) represents the text that has been scrolled to if the browser supports [text fragments](/en-US/docs/Web/URI/Fragment/Text_fragments). It allows authors to choose how to highlight that section of text. diff --git a/files/en-us/web/html/attributes/autocomplete/index.md b/files/en-us/web/html/attributes/autocomplete/index.md index d8a26564efcfd5f..67f8ba8e62c6fd3 100644 --- a/files/en-us/web/html/attributes/autocomplete/index.md +++ b/files/en-us/web/html/attributes/autocomplete/index.md @@ -238,7 +238,7 @@ When the form field is not a phone number, email address, or instant messaging p With {{htmlelement("input")}} and {{htmlelement("textarea")}}, the `webauthn` token can be included last to indicate the user agent should show public key credentials when the user is interacting with the control. -- `webauthn` +- `webauthn` {{experimental_inline}} - : Passkeys generated by the [Web Authentication API](/en-US/docs/Web/API/Web_Authentication_API), as requested by a conditional {{domxref("CredentialsContainer.get()", "navigator.credentials.get()")}} call (i.e., one that includes `mediation: 'conditional'`). If included, this is the last token in the space-separated token list. See [Sign in with a passkey through form autofill](https://web.dev/articles/passkey-form-autofill) for more details. ## Examples diff --git a/files/en-us/web/http/headers/expect-ct/index.md b/files/en-us/web/http/headers/expect-ct/index.md index ec1bbd5d940b83c..460b793dc4a4dc9 100644 --- a/files/en-us/web/http/headers/expect-ct/index.md +++ b/files/en-us/web/http/headers/expect-ct/index.md @@ -2,6 +2,8 @@ title: Expect-CT slug: Web/HTTP/Headers/Expect-CT page-type: http-header +status: + - deprecated browser-compat: http.headers.Expect-CT --- diff --git a/files/en-us/web/http/headers/set-cookie/index.md b/files/en-us/web/http/headers/set-cookie/index.md index b0705c43bd30903..aff75bbb0b5e399 100644 --- a/files/en-us/web/http/headers/set-cookie/index.md +++ b/files/en-us/web/http/headers/set-cookie/index.md @@ -113,7 +113,7 @@ Set-Cookie: =; Domain=; Secure; HttpOnl - : Indicates the number of seconds until the cookie expires. A zero or negative number will expire the cookie immediately. If both `Expires` and `Max-Age` are set, `Max-Age` has precedence. -- `Partitioned` {{optional_inline}}{{experimental_inline}} +- `Partitioned` {{optional_inline}} - : Indicates that the cookie should be stored using partitioned storage. Note that if this is set, the [`Secure` directive](#secure) must also be set. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/drop/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/drop/index.md index d6654fff8848014..54057aa39c6ab74 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/drop/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/drop/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.drop() slug: Web/JavaScript/Reference/Global_Objects/Iterator/drop page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.drop --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`drop()`** method of {{jsxref("Iterator")}} instances returns a new [iterator helper](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers) that skips the given number of elements at the start of this iterator. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/every/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/every/index.md index 0a62bffbc685380..bab50b305c40309 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/every/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/every/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.every() slug: Web/JavaScript/Reference/Global_Objects/Iterator/every page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.every --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`every()`** method of {{jsxref("Iterator")}} instances is similar to {{jsxref("Array.prototype.every()")}}: it tests whether all elements produced by the iterator pass the test implemented by the provided function. It returns a boolean value. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/filter/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/filter/index.md index 9f4e93933f78e07..d59641af515db46 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/filter/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/filter/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.filter() slug: Web/JavaScript/Reference/Global_Objects/Iterator/filter page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.filter --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`filter()`** method of {{jsxref("Iterator")}} instances returns a new [iterator helper](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers) that yields only those elements of the iterator for which the provided callback function returns `true`. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/find/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/find/index.md index e047d8a1d4c0550..908a56126b830dc 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/find/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/find/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.find() slug: Web/JavaScript/Reference/Global_Objects/Iterator/find page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.find --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`find()`** method of {{jsxref("Iterator")}} instances is similar to {{jsxref("Array.prototype.find()")}}: it returns the first element produced by the iterator that satisfies the provided testing function. If no values satisfy the testing function, {{jsxref("undefined")}} is returned. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/flatmap/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/flatmap/index.md index 9a03a7e5ea06da1..8f758ff4ed9d5f4 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/flatmap/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/flatmap/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.flatMap() slug: Web/JavaScript/Reference/Global_Objects/Iterator/flatMap page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.flatMap --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`flatMap()`** method of {{jsxref("Iterator")}} instances returns a new [iterator helper](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers) that takes each element in the original iterator, runs it through a mapping function, and yields elements returned by the mapping function (which are contained in another iterator or iterable). diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/foreach/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/foreach/index.md index 172daa0904f8d63..eb91c15c174ebf9 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/foreach/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/foreach/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.forEach() slug: Web/JavaScript/Reference/Global_Objects/Iterator/forEach page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.forEach --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`forEach()`** method of {{jsxref("Iterator")}} instances is similar to {{jsxref("Array.prototype.forEach()")}}: it executes a provided function once for each element produced by the iterator. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/from/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/from/index.md index 6bcfb7e3a259358..b22b186da412891 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/from/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/from/index.md @@ -2,12 +2,10 @@ title: Iterator.from() slug: Web/JavaScript/Reference/Global_Objects/Iterator/from page-type: javascript-static-method -status: - - experimental browser-compat: javascript.builtins.Iterator.from --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`Iterator.from()`** static method creates a new {{jsxref("Iterator")}} object from an iterator or iterable object. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/index.md index 244e54b01f3ff09..dfb88734d1c840c 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/index.md @@ -127,12 +127,12 @@ const myIterator = Iterator.from({ ## Constructor -- {{jsxref("Iterator/Iterator", "Iterator()")}} {{experimental_inline}} +- {{jsxref("Iterator/Iterator", "Iterator()")}} - : Intended to be [extended](/en-US/docs/Web/JavaScript/Reference/Classes/extends) by other classes that create iterators. Throws an error when constructed by itself. ## Static methods -- {{jsxref("Iterator.from()")}} {{experimental_inline}} +- {{jsxref("Iterator.from()")}} - : Creates a new `Iterator` object from an iterator or iterable object. ## Instance properties @@ -150,27 +150,27 @@ These properties are defined on `Iterator.prototype` and shared by all `Iterator ## Instance methods -- {{jsxref("Iterator.prototype.drop()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.drop()")}} - : Returns a new iterator helper that skips the given number of elements at the start of this iterator. -- {{jsxref("Iterator.prototype.every()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.every()")}} - : Tests whether all elements produced by the iterator pass the test implemented by the provided function. -- {{jsxref("Iterator.prototype.filter()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.filter()")}} - : Returns a new iterator helper that yields only those elements of the iterator for which the provided callback function returns `true`. -- {{jsxref("Iterator.prototype.find()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.find()")}} - : Returns the first element produced by the iterator that satisfies the provided testing function. If no values satisfy the testing function, {{jsxref("undefined")}} is returned. -- {{jsxref("Iterator.prototype.flatMap()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.flatMap()")}} - : Returns a new iterator helper that takes each element in the original iterator, runs it through a mapping function, and yields elements returned by the mapping function (which are contained in another iterator or iterable). -- {{jsxref("Iterator.prototype.forEach()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.forEach()")}} - : Executes a provided function once for each element produced by the iterator. -- {{jsxref("Iterator.prototype.map()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.map()")}} - : Returns a new iterator helper that yields elements of the iterator, each transformed by a mapping function. -- {{jsxref("Iterator.prototype.reduce()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.reduce()")}} - : Executes a user-supplied "reducer" callback function on each element produced by the iterator, passing in the return value from the calculation on the preceding element. The final result of running the reducer across all elements is a single value. -- {{jsxref("Iterator.prototype.some()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.some()")}} - : Tests whether at least one element in the iterator passes the test implemented by the provided function. It returns a boolean value. -- {{jsxref("Iterator.prototype.take()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.take()")}} - : Returns a new iterator helper that yields the given number of elements in this iterator and then terminates. -- {{jsxref("Iterator.prototype.toArray()")}} {{experimental_inline}} +- {{jsxref("Iterator.prototype.toArray()")}} - : Creates a new {{jsxref("Array")}} instance populated with the elements yielded from the iterator. - [`Iterator.prototype[Symbol.iterator]()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator/Symbol.iterator) - : Returns the iterator object itself. This allows iterator objects to also be iterable. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/iterator/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/iterator/index.md index eb3e2ff4ecbe204..a99e496c07a67d9 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/iterator/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/iterator/index.md @@ -2,12 +2,10 @@ title: Iterator() constructor slug: Web/JavaScript/Reference/Global_Objects/Iterator/Iterator page-type: javascript-constructor -status: - - experimental browser-compat: javascript.builtins.Iterator.Iterator --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`Iterator()`** constructor is intended to be used as the [superclass](/en-US/docs/Web/JavaScript/Reference/Classes/extends) of other classes that create iterators. It throws an error when constructed by itself. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/map/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/map/index.md index 5bc0303007151a5..5e6244918333f7f 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/map/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/map/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.map() slug: Web/JavaScript/Reference/Global_Objects/Iterator/map page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.map --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`map()`** method of {{jsxref("Iterator")}} instances returns a new [iterator helper](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers) that yields elements of the iterator, each transformed by a mapping function. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/reduce/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/reduce/index.md index d8abe48ea306000..5cb0c77e9c9f320 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/reduce/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/reduce/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.reduce() slug: Web/JavaScript/Reference/Global_Objects/Iterator/reduce page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.reduce --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`reduce()`** method of {{jsxref("Iterator")}} instances is similar to {{jsxref("Array.prototype.reduce")}}: it executes a user-supplied "reducer" callback function on each element produced by the iterator, passing in the return value from the calculation on the preceding element. The final result of running the reducer across all elements is a single value. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/some/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/some/index.md index 4bd68d5775a4032..7ebf808f3c74f2a 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/some/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/some/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.some() slug: Web/JavaScript/Reference/Global_Objects/Iterator/some page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.some --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`some()`** method of {{jsxref("Iterator")}} instances is similar to {{jsxref("Array.prototype.some()")}}: it tests whether at least one element produced by the iterator passes the test implemented by the provided function. It returns a boolean value. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/take/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/take/index.md index 3f48d4284a34c1e..35ef0a39218b5c2 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/take/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/take/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.take() slug: Web/JavaScript/Reference/Global_Objects/Iterator/take page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.take --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`take()`** method of {{jsxref("Iterator")}} instances returns a new [iterator helper](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers) that yields the given number of elements in this iterator and then terminates. diff --git a/files/en-us/web/javascript/reference/global_objects/iterator/toarray/index.md b/files/en-us/web/javascript/reference/global_objects/iterator/toarray/index.md index a74163fd5f572bf..11dd9769f3ef2b1 100644 --- a/files/en-us/web/javascript/reference/global_objects/iterator/toarray/index.md +++ b/files/en-us/web/javascript/reference/global_objects/iterator/toarray/index.md @@ -2,12 +2,10 @@ title: Iterator.prototype.toArray() slug: Web/JavaScript/Reference/Global_Objects/Iterator/toArray page-type: javascript-instance-method -status: - - experimental browser-compat: javascript.builtins.Iterator.toArray --- -{{JSRef}}{{SeeCompatTable}} +{{JSRef}} The **`toArray()`** method of {{jsxref("Iterator")}} instances creates a new {{jsxref("Array")}} instance populated with the elements yielded from the iterator. diff --git a/files/en-us/web/privacy/privacy_sandbox/partitioned_cookies/index.md b/files/en-us/web/privacy/privacy_sandbox/partitioned_cookies/index.md index 85f68ac7b0ab2d7..a0184074b9f0eae 100644 --- a/files/en-us/web/privacy/privacy_sandbox/partitioned_cookies/index.md +++ b/files/en-us/web/privacy/privacy_sandbox/partitioned_cookies/index.md @@ -2,13 +2,9 @@ title: Cookies Having Independent Partitioned State (CHIPS) slug: Web/Privacy/Privacy_sandbox/Partitioned_cookies page-type: guide -status: - - experimental browser-compat: http.headers.Set-Cookie.Partitioned --- -{{SeeCompatTable}} - **Cookies Having Independent Partitioned State** (**CHIPS**, also known as **Partitioned cookies**) allows developers to opt a cookie into partitioned storage, with a separate cookie jar per top-level site. Without cookie partitioning, third-party cookies can enable services to track users and associate their information across unrelated top-level sites. Cookies marked `Partitioned` are double-keyed: by the origin that sets them _and_ the origin of the top-level page. From 315e53cfc25715a2e79a7b431b0e015b67060ca1 Mon Sep 17 00:00:00 2001 From: Carl-Erik Kopseng Date: Wed, 11 Sep 2024 07:01:35 +0200 Subject: [PATCH 067/129] Fix two markdown syntax errors causing rendering issues on `postTask` (#35824) Fix two markdown syntax errors causing rendering issues The rendering was including the broken markdown due to missing a starting parenthesis. --- files/en-us/web/api/scheduler/posttask/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/en-us/web/api/scheduler/posttask/index.md b/files/en-us/web/api/scheduler/posttask/index.md index 467a54af64d4cd8..240d7b68a87dc80 100644 --- a/files/en-us/web/api/scheduler/posttask/index.md +++ b/files/en-us/web/api/scheduler/posttask/index.md @@ -129,7 +129,7 @@ runTask2(); ### Permanent priorities [Task priorities](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#task_priorities) may be set using `priority` parameter in the optional second argument. -Priorities that are set in this way cannot be changed (are [immutable]/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#mutable_and_immutable_task_priority)). +Priorities that are set in this way cannot be changed (are [immutable](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#mutable_and_immutable_task_priority)). Below we post two groups of three tasks, each member in reverse order of priority. The final task has the default priority. @@ -175,7 +175,7 @@ bckg 2 ### Changing task priorities [Task priorities](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#task_priorities) can also take their initial value from a {{domxref("TaskSignal")}} passed to `postTask()` in the optional second argument. -If set in this way, the priority of the task [can then be changed]/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#mutable_and_immutable_task_priority) using the controller associated with the signal. +If set in this way, the priority of the task [can then be changed](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API#mutable_and_immutable_task_priority) using the controller associated with the signal. > [!NOTE] > Setting and changing task priorities using a signal only works when the `options.priority` argument to `postTask()` is not set, and when the `options.signal` is a {{domxref("TaskSignal")}} (and not an {{domxref("AbortSignal")}}). From 81c67156fef5fb82c439c8f0d8ce6d4dee86a3e3 Mon Sep 17 00:00:00 2001 From: Onkar Khadangale <87750369+OnkarRuikar@users.noreply.github.com> Date: Wed, 11 Sep 2024 12:52:19 +0530 Subject: [PATCH 068/129] fix(css): update color-scheme and prefers-color-scheme documents (#35759) * fix(css): update color-scheme and preferes-color-scheme documents * Apply suggestions from code review Co-authored-by: Chris Mills --------- Co-authored-by: Chris Mills --- .../web/css/@media/prefers-color-scheme/index.md | 8 ++++---- files/en-us/web/css/color-scheme/index.md | 15 +++++++++++---- files/en-us/web/html/element/meta/name/index.md | 2 +- 3 files changed, 16 insertions(+), 9 deletions(-) diff --git a/files/en-us/web/css/@media/prefers-color-scheme/index.md b/files/en-us/web/css/@media/prefers-color-scheme/index.md index 3ea0b2d79d1c10e..4f7b661e559ae17 100644 --- a/files/en-us/web/css/@media/prefers-color-scheme/index.md +++ b/files/en-us/web/css/@media/prefers-color-scheme/index.md @@ -14,7 +14,7 @@ A user indicates their preference through an operating system setting (e.g. ligh For SVG and iframes, `prefers-color-scheme` lets you set a CSS style for the SVG or iframe based on the [`color-scheme`](/en-US/docs/Web/CSS/color-scheme) of the parent element in the web page. SVGs must be used embedded (i.e., `circle`) as opposed to [inlined in HTML](/en-US/docs/Web/SVG/Tutorial/SVG_In_HTML_Introduction#basic_example). -An example of using `prefers-color-scheme` in SVGs can be found in the [Color scheme inheritance](#color_scheme_inheritance) section. +An example of using `prefers-color-scheme` in SVGs can be found in the ["Inherited color scheme in embedded elements"](#inherited_color_scheme_in_embedded_elements) section. Using `prefers-color-scheme` is allowed in [cross-origin](/en-US/docs/Web/Security/Same-origin_policy#cross-origin_network_access) `` and `` elements and their `alt` attributes. This would normally be done in HTML as `circle`. You should see three circles, with one drawn in a different color. diff --git a/files/en-us/web/css/color-scheme/index.md b/files/en-us/web/css/color-scheme/index.md index b051c284bbe9b42..0e2e544690df6b2 100644 --- a/files/en-us/web/css/color-scheme/index.md +++ b/files/en-us/web/css/color-scheme/index.md @@ -7,7 +7,14 @@ browser-compat: css.properties.color-scheme {{CSSRef}} -The **`color-scheme`** [CSS](/en-US/docs/Web/CSS) property allows an element to indicate which color schemes it can comfortably be rendered in. +The **`color-scheme`** [CSS](/en-US/docs/Web/CSS) property allows an element to indicate which color schemes it can comfortably be rendered in. User agents change the following aspects of the UI chrome to match the used color scheme: + +- The color of the canvas surface. +- The default colors of scrollbars and other interaction UI. +- The default colors of form controls. +- The default colors of other browser-provided UI, such as "spellcheck" underlines. + +Component authors must use the [`prefers-color-scheme`](/en-US/docs/Web/CSS/@media/prefers-color-scheme) media feature to support the color schemes on the rest of the elements. Common choices for operating system color schemes are "light" and "dark", or "day mode" and "night mode". When a user selects one of these color schemes, the operating system makes adjustments to the user interface. This includes [form controls](/en-US/docs/Learn/Forms), [scrollbars](/en-US/docs/Web/CSS/CSS_scrollbars_styling), and the used values of [CSS system colors](/en-US/docs/Web/CSS/CSS_colors). @@ -35,11 +42,11 @@ The `color-scheme` property's value must be one of the following keywords. ### Values - `normal` - - : Indicates that the element isn't aware of any color schemes, and so should be rendered using the browser's default color scheme. + - : Indicates that the element can be rendered using the page's [color scheme](/en-US/docs/Web/HTML/Element/meta/name#color-scheme) settings. If the page does not have a color scheme set, the element is rendered using the page's default color settings. - `light` - - : Indicates that the element can be rendered using the operating system light color scheme. + - : Indicates that the element can be rendered using the operating system _light_ color scheme. - `dark` - - : Indicates that the element can be rendered using the operating system dark color scheme. + - : Indicates that the element can be rendered using the operating system _dark_ color scheme. - `only` - : Forbids the user agent from overriding the color scheme for the element. diff --git a/files/en-us/web/html/element/meta/name/index.md b/files/en-us/web/html/element/meta/name/index.md index dfdd8dfd980d46e..3d27923a43ce778 100644 --- a/files/en-us/web/html/element/meta/name/index.md +++ b/files/en-us/web/html/element/meta/name/index.md @@ -96,7 +96,7 @@ The HTML specification defines the following set of standard metadata names: > - When several conflicting policies are defined, the `no-referrer` policy is applied. - [`theme-color`](/en-US/docs/Web/HTML/Element/meta/name/theme-color): indicates a suggested color that user agents should use to customize the display of the page or of the surrounding user interface. The `content` attribute contains a valid CSS {{cssxref("<color>")}}. The `media` attribute with a valid media query list can be included to set the media the theme color metadata applies to. -- `color-scheme`: specifies one or more color schemes with which the document is compatible. +- `color-scheme`: specifies one or more color schemes with which the document is compatible. The browser will use this information in tandem with the user's browser or device settings to determine what colors to use for everything from background and foregrounds to form controls and scrollbars. The primary use for `` is to indicate compatibility with—and order of preference for—light and dark color modes. From eb7a000b802ee9089456b0d3602c71ff5aabcebd Mon Sep 17 00:00:00 2001 From: Onkar Khadangale <87750369+OnkarRuikar@users.noreply.github.com> Date: Wed, 11 Sep 2024 12:55:09 +0530 Subject: [PATCH 069/129] fix(css): update container query pages (#35767) * fix(css): update container qery pages * Apply suggestions from code review Co-authored-by: Chris Mills * fix syntax * fix a flaw --------- Co-authored-by: Chris Mills --- files/en-us/web/css/@container/index.md | 17 ++++++- files/en-us/web/css/container-name/index.md | 11 +++-- files/en-us/web/css/container-type/index.md | 2 +- .../container_size_and_style_queries/index.md | 48 ++++++------------- 4 files changed, 39 insertions(+), 39 deletions(-) diff --git a/files/en-us/web/css/@container/index.md b/files/en-us/web/css/@container/index.md index 85f13c26f6133d3..189843063e7eed4 100644 --- a/files/en-us/web/css/@container/index.md +++ b/files/en-us/web/css/@container/index.md @@ -20,7 +20,7 @@ Once an eligible query container has been selected for an element, each containe The `@container` at-rule has the following syntax: ```plain -@container { +@container # { } ``` @@ -33,12 +33,27 @@ For example: font-size: 1.5em; } } + /* with an optional */ @container tall (height > 30rem) { h2 { line-height: 1.6; } } + +/* multiple queries in a single condition */ +@container (width > 400px) and style(--responsive: true) { + h2 { + font-size: 1.5em; + } +} + +/* condition list */ +@container card (width > 400px), style(--responsive: true) { + h2 { + font-size: 1.5em; + } +} ``` ### Values diff --git a/files/en-us/web/css/container-name/index.md b/files/en-us/web/css/container-name/index.md index 1a5738596086a73..ce41aee103f7dfd 100644 --- a/files/en-us/web/css/container-name/index.md +++ b/files/en-us/web/css/container-name/index.md @@ -17,6 +17,8 @@ When a containment context is given a name, it can be specifically targeted usin ## Syntax ```css +container-name: none; + /* A single name */ container-name: myLayout; @@ -33,13 +35,16 @@ container-name: unset; ### Values -- `` +- `none` - - : A case-sensitive string that is used to identify the container. + - : Default value. The query container has no name. +- {{cssxref("custom-ident")}} + + - : A case-sensitive string that is used to identify the container. The following conditions apply: - - The name can be any valid {{cssxref("custom-ident")}}, but must not equal `default`. + - The name must not equal `or`, `and`, `not`, or `default`. - The name value must not be in quotes. - The dashed ident intended to denote author-defined identifiers (e.g., `--container-name`) is permitted. - A list of multiple names separated by a space is allowed. diff --git a/files/en-us/web/css/container-type/index.md b/files/en-us/web/css/container-type/index.md index 9a345b82da9ad48..338a18a82b2d9e4 100644 --- a/files/en-us/web/css/container-type/index.md +++ b/files/en-us/web/css/container-type/index.md @@ -49,7 +49,7 @@ container-type: unset; Inline size containment is applied to the element. The inline size of the element can be computed in isolation, ignoring the child elements. - `normal` - - : The element is not a query container for any container size queries, but remains a query container for container style queries. + - : Default value. The element is not a query container for any container size queries, but remains a query container for [container style queries](/en-US/docs/Web/CSS/@container#container_style_queries). ## Formal definition diff --git a/files/en-us/web/css/css_containment/container_size_and_style_queries/index.md b/files/en-us/web/css/css_containment/container_size_and_style_queries/index.md index 04e639284f3e917..ca421c874f9dbf8 100644 --- a/files/en-us/web/css/css_containment/container_size_and_style_queries/index.md +++ b/files/en-us/web/css/css_containment/container_size_and_style_queries/index.md @@ -12,7 +12,7 @@ browser-compat: css.at-rules.container Container queries are similar to [media queries](/en-US/docs/Web/CSS/CSS_media_queries). The {{cssxref("@media")}} at-rule enables applying styles to elements based on viewport size or other device characteristics. Similarly, the {{cssxref("@container")}} at-rule enables applying styles to elements based on a containing element's size or other style features, rather than the viewport's. Container queries have the same syntax rules and logical operators as media queries. ```css -@container { +@container # { /* */ } ``` @@ -66,38 +66,38 @@ The `` in this example contains a single `` — ## Naming containers -A `` can include an optional case-sensitive {{cssxref("container-name")}}. In the form example, we could have limited the elements matched by the query by adding a name to the `` and then setting the {{cssxref("container-name")}} property with its value equal to the same name on the form elements we want to match. +A `` can include an optional case-sensitive {{cssxref("container-name")}}. A container name makes the container condition more specific — it is evaluated only against elements that have that name set in the `container-name` property. -The optional `` set within the query condition filters the set of query containers considered to just those with a matching query container name. The {{cssxref("container-name")}} property specifies a list of query container names that can be used by `@container` rules to filter which query containers are targeted. Names enable querying aspects of a specific container, even if the container is not a direct parent. +The {{cssxref("container-name")}} property specifies a list of query `` values that can be used in `@container` rules; these are case-sensitive {{cssxref("ident")}} values. The container names enable targeting any container ancestor of the element. Without a container name, the query matches only the nearest container ancestor. ```css -@container { +@container [ [ ]? ]# { /* */ } ``` -Once you've added names to your `@container` at rules, you can use the {{cssxref("container-name")}} property or the {{cssxref("container")}} shorthand to apply a space-separated list of names to container elements. Styles contained inside the named `@container` at rules will only be applied to matching elements inside size query containers with the same names set on them. The `` is a case-sensitive {{cssxref("ident")}}. +After you add names to your `@container` at rules, you can use the {{cssxref("container-name")}} property or the {{cssxref("container")}} shorthand to target specific container elements. Styles inside the named `@container` at rules will be applied only to matching elements inside containers with those names set, which satisfy the container queries. ```css @container card (orientation: landscape) { /* styles */ } -.cards li { +.todo-panel > li { container-type: inline-size; container-name: card; } ``` -This example size query is limited to elements with a `container-name` of `card` applied to them. In this example, the styles within the container query style block will apply to the descendants of all {{htmlelement("li")}} elements nested within an element with a class of `cards` with a width that is greater than their height. Note that if there are other elements with `container-name: card` applied to them that match the size query, the styles will also be applied to those elements' descendants. +In the above example, the styles within the container query block will apply to the descendants of all {{htmlelement("li")}} elements with a width that is greater than their height. Note that other elements with `container-name: card` applied to them that match the size query will also have these styles applied to their elements' descendants. ```css -@container wide (orientation: landscape) and (min-width: 20em) { - /* styles applied to descendants of .sizeContainer if size features match */ +@container wide (min-width: 20em) { + /* styles applied to descendants of wide .sizeContainer */ } -@container narrow (orientation: portrait) or (max-width: 20em) { - /* styles applied to descendants of .sizeContainer if size features match */ +@container narrow (max-width: 20em) { + /* styles applied to descendants of narrow .sizeContainer */ } .sizeContainer { @@ -106,29 +106,9 @@ This example size query is limited to elements with a `container-name` of `card` } ``` -In this container size query example, the element has two container names. The descendants of any elements with `class="sizeContainer"` will get the styles from the `wide` or `narrow` query applied (or both if that element is exactly a 20em square). +In the above example, the element has two container names, `wide` and `narrow`. The descendants of any elements with `class="sizeContainer"` will get the styles from the `wide` or `narrow` query applied (or both if an element is precisely 20em wide). -Container names also enable querying styles from elements that aren't a direct parent. When a containment context is given a name, it can be specifically targeted using the `@container` at-rule instead of the nearest ancestor with containment. - -Set `container-name: none` to prevent the container from matching any named container queries. That removes all associated container query names, but does not prevent the element from matching unnamed queries. - -To prevent an element from being a size container, set `container-type: normal`. This removes containment, meaning the element isn't a size container (it can still be a [style container](#container_style_queries)). - -To prevent an element from being matched by any container queries, provide it with an unused `container-name`. - -```css -article { - container-name: none; - container-type: size; -} - -main { - container-name: neverUsedName; - container-type: normal; -} -``` - -In the above example, the {{htmlelement("article")}} element can match any unnamed container query. In other words, it will be tested by each `@container` query that doesn't include a name in the ``. On the other hand, assuming the `neverUsedName` is never used as a container query name, the {{htmlelement("main")}} element will never be queried. Even if that name was removed, it would still not be tested against any size queries as the `container-type` value of `normal` means it is not a size query container. +The default value `container-type: normal` prevents the container from being a query container, meaning the element is not a size container but it can still be a [style container](#container_style_queries). The default value `container-name: none` states the container has no name, but it does not prevent the element from matching unnamed queries. With container queries, we are not limited to size queries! You can also query a container's style features. @@ -286,7 +266,7 @@ In this example, we have a {{htmlelement("fieldset")}} with four radio buttons. I change colors ``` -JavaScript updates the value of the CSS `--theme` variable on the {{htmlelement("body")}} element, which is an ancestor of the {{htmlelement("fieldset")}} and {{htmlelement("output")}} elements, whenever a radio button is selected. When the text `` is updated, the {{domxref("HTMLInputElement.value", "value")}} of the `other` radio button is updated only if the `other` radio button is {{domxref("HTMLInputElement.checked", "checked")}}, which in turn updates the value of `--theme`. +JavaScript updates the value of the CSS `--theme` variable on the {{htmlelement("body")}} element, which is an ancestor of the {{htmlelement("fieldset")}} and {{htmlelement("output")}} elements, whenever a radio button is selected. When the text `` is updated, the {{domxref("HTMLInputElement.value", "value")}} of the `other` radio button is updated only if the `other` radio button is checked, which in turn updates the value of `--theme`. ```js const radios = document.querySelectorAll('input[name="selection"]'); From 0febb0315dbb36565f8badbbaa653434df3483d1 Mon Sep 17 00:00:00 2001 From: Onkar Khadangale <87750369+OnkarRuikar@users.noreply.github.com> Date: Wed, 11 Sep 2024 13:23:16 +0530 Subject: [PATCH 070/129] fix(css): add layer() function page (#35508) * fix(css): add layer() function page * Apply suggestions from code review --- files/en-us/web/css/@import/index.md | 2 + .../web/css/@import/layer_function/index.md | 41 +++++++++++++++++++ 2 files changed, 43 insertions(+) create mode 100644 files/en-us/web/css/@import/layer_function/index.md diff --git a/files/en-us/web/css/@import/index.md b/files/en-us/web/css/@import/index.md index f840235efd2f5f7..efe976db4ec79ee 100644 --- a/files/en-us/web/css/@import/index.md +++ b/files/en-us/web/css/@import/index.md @@ -37,6 +37,8 @@ where: If the browser does not conform to the conditions specified in the _supports-condition_, it may not fetch the linked stylesheet, and even if downloaded through some other path, will not load it. The syntax of `supports()` is almost identical to that described in {{CSSxRef("@supports")}}, and that topic can be used as a more complete reference. +Use `@import` together with the `layer` keyword or `layer()` function to import external style sheets (from frameworks, widget stylesheets, libraries, etc.) into layers. + ## Description Imported rules must come before all other types of rules, except {{CSSxRef("@charset")}} rules and layer creating [`@layer`](/en-US/docs/Web/CSS/@layer) statements. diff --git a/files/en-us/web/css/@import/layer_function/index.md b/files/en-us/web/css/@import/layer_function/index.md new file mode 100644 index 000000000000000..29c7cc194c0dd33 --- /dev/null +++ b/files/en-us/web/css/@import/layer_function/index.md @@ -0,0 +1,41 @@ +--- +title: layer() +slug: Web/CSS/@import/layer_function +page-type: css-function +browser-compat: css.at-rules.import.layer +--- + +{{CSSRef}} + +The **`layer()`** [CSS](/en-US/docs/Web/CSS) [function](/en-US/docs/Web/CSS/CSS_Functions) is used along with the [`@import`](/en-US/docs/Web/CSS/@import) [at-rule](/en-US/docs/Web/CSS/At-rule) to put the imported resource in a separate named [cascade layer](/en-US/docs/Web/CSS/@layer). + +## Syntax + +```css +@import url layer(layer-name); +@import "dark.css" layer(framework.themes.dark); +``` + +The `framework.themes.dark` is the layer into which the CSS file would be imported. + +## Formal syntax + +```plain +layer() = layer( ) + + = + [ '.' ]* +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{CSSxRef("@import")}} +- [CSS cascade and inheritance](/en-US/docs/Web/CSS/CSS_cascade) module From 02d457b3cda022e2c6281fb92816810be2ff27cc Mon Sep 17 00:00:00 2001 From: Chris Mills Date: Wed, 11 Sep 2024 11:18:30 +0100 Subject: [PATCH 071/129] Update third-party cookie phaseout wording (#35831) --- files/en-us/web/api/topics_api/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/topics_api/index.md b/files/en-us/web/api/topics_api/index.md index b8f954d8ad7850c..c6909b2e7cc44ce 100644 --- a/files/en-us/web/api/topics_api/index.md +++ b/files/en-us/web/api/topics_api/index.md @@ -22,7 +22,7 @@ The **Topics API** provides a mechanism for developers to implement use cases su A typical mechanism for advertising on the web involves a user visiting **publisher** sites that use an advertising technology (ad tech) platform to publish ads for an **advertiser**'s products or services. The publisher is paid to display the ads, which helps to fund their content, and more business is driven to advertiser sites. -The above process can be made more effective using interest-based advertising (IBA). The idea is that when users visit the publisher sites, they are served a **personalized** selection of ads based on their interests. Their interests are inferred from sites they have previously visited. In the past, third-party cookies have been used to collect information on user interests, but all browsers are phasing out the use of third-party cookies. The Topics API provides part of the path towards this goal — a mechanism to implement IBA that does not depend on third-party cookies. +The above process can be made more effective using interest-based advertising (IBA). The idea is that when users visit the publisher sites, they are served a **personalized** selection of ads based on their interests. Their interests are inferred from sites they have previously visited. In the past, third-party tracking cookies have been used to collect information on user interests, but browsers are [phasing out the availability of third-party cookies](/en-US/blog/goodbye-third-party-cookies/) for an increasing proportion of users. The Topics API provides part of the path towards this goal — a mechanism to implement IBA that does not depend on user tracking. First of all, the browser infers a user's interests from the URLs of sites they visit that have ad tech `