diff --git a/files/en-us/mozilla/firefox/releases/150/index.md b/files/en-us/mozilla/firefox/releases/150/index.md index 85c257e9dedf4db..a9253dd424c6f0f 100644 --- a/files/en-us/mozilla/firefox/releases/150/index.md +++ b/files/en-us/mozilla/firefox/releases/150/index.md @@ -54,7 +54,14 @@ Firefox 150 is the current [Beta version of Firefox](https://www.firefox.com/en- #### DOM +- The [`options.shadowRoots`](/en-US/docs/Web/API/Document/caretPositionFromPoint#shadowroots) argument of the {{domxref('Document.caretPositionFromPoint()')}} method is now supported. + This allows the method to return the node containing the caret from within a shadow DOM, provided its associated {{domxref("ShadowRoot")}} was passed as an option. + ([Firefox bug 1914596](https://bugzil.la/1914596)). + - The non-standard {{domxref("Document/caretRangeFromPoint","caretRangeFromPoint()")}} method of the {{domxref("Document")}} interface is now supported. ([Firefox bug 1550635](https://bugzil.la/1550635)). +- The `ariaNotify()` method is now supported on {{domxref("Document/ariaNotify","Document")}} and {{domxref("Element/ariaNotify","Element")}}. + This queues a string of text to be announced by a {{glossary("screen reader")}}, providing a more ergonomic and reliable alternative to [ARIA live regions](/en-US/docs/Web/Accessibility/ARIA/Guides/Live_regions). + ([Firefox bug 2018095](https://bugzil.la/2018095)). diff --git a/files/en-us/web/api/cssfontfacedescriptors/index.md b/files/en-us/web/api/cssfontfacedescriptors/index.md index 4f06157612d472c..6ff75e7c8b0f2de 100644 --- a/files/en-us/web/api/cssfontfacedescriptors/index.md +++ b/files/en-us/web/api/cssfontfacedescriptors/index.md @@ -2,12 +2,10 @@ title: CSSFontFaceDescriptors slug: Web/API/CSSFontFaceDescriptors page-type: web-api-interface -status: - - experimental browser-compat: api.CSSFontFaceDescriptors --- -{{APIRef("CSSOM")}}{{SeeCompatTable}} +{{APIRef("CSSOM")}} The **`CSSFontFaceDescriptors`** interface represents a CSS declaration block for an {{cssxref("@font-face")}} [at-rule](/en-US/docs/Web/CSS/Guides/Syntax/At-rules). @@ -25,25 +23,25 @@ _Inherits properties from its ancestor {{domxref("CSSStyleDeclaration")}}._ The following property names, in kebab-case (accessed using bracket notation) and camel-case (accessed using dot notation), each represent the value of a descriptor in the corresponding `@font-face` at-rule: -- `font-display` or `fontDisplay` {{experimental_inline}} +- `font-display` or `fontDisplay` - : A string representing the value of the {{cssxref("@font-face/font-display", "font-display")}} descriptor. -- `font-family` or `fontFamily` {{experimental_inline}} +- `font-family` or `fontFamily` - : A string representing the value of the {{cssxref("@font-face/font-family", "font-family")}} descriptor. -- `font-feature-settings` or `fontFeatureSettings` {{experimental_inline}} +- `font-feature-settings` or `fontFeatureSettings` - : A string representing the value of the {{cssxref("@font-face/font-feature-settings", "font-feature-settings")}} descriptor. -- `font-stretch` or `fontStretch` {{experimental_inline}} +- `font-stretch` or `fontStretch` - : A string representing the value of the {{cssxref("@font-face/font-stretch", "font-stretch")}} descriptor. -- `font-style` or `fontStyle` {{experimental_inline}} +- `font-style` or `fontStyle` - : A string representing the value of the {{cssxref("@font-face/font-style", "font-style")}} descriptor. -- `font-weight` or `fontWeight` {{experimental_inline}} +- `font-weight` or `fontWeight` - : A string representing the value of the {{cssxref("@font-face/font-weight", "font-weight")}} descriptor. - `font-width` or `fontWidth` {{experimental_inline}} - : A string representing the value of the {{cssxref("@font-face/font-width", "font-width")}} descriptor. -- `size-adjust` or `sizeAdjust` {{experimental_inline}} +- `size-adjust` or `sizeAdjust` - : A string representing the value of the {{cssxref("@font-face/size-adjust", "size-adjust")}} descriptor. -- `src` {{experimental_inline}} +- `src` - : A string representing the value of the {{cssxref("@font-face/src", "src")}} descriptor. -- `unicode-range` or `unicodeRange` {{experimental_inline}} +- `unicode-range` or `unicodeRange` - : A string representing the value of the {{cssxref("@font-face/unicode-range", "unicode-range")}} descriptor. ## Instance methods diff --git a/files/en-us/web/api/document/arianotify/index.md b/files/en-us/web/api/document/arianotify/index.md index 813fca415ed603f..58ae9a0020015c9 100644 --- a/files/en-us/web/api/document/arianotify/index.md +++ b/files/en-us/web/api/document/arianotify/index.md @@ -3,14 +3,12 @@ title: "Document: ariaNotify() method" short-title: ariaNotify() slug: Web/API/Document/ariaNotify page-type: web-api-instance-method -status: - - experimental browser-compat: api.Document.ariaNotify --- -{{ApiRef("DOM")}}{{SeeCompatTable}} +{{ApiRef("DOM")}} -The **`ariaNotify()`** method of the {{domxref("Document")}} interface specifies that a given string of text should be announced by a {{glossary("screen reader")}} if available and activated. +The **`ariaNotify()`** method of the {{domxref("Document")}} interface queues a string of text to be announced by a {{glossary("screen reader")}}. ## Syntax @@ -26,11 +24,15 @@ ariaNotify(announcement, options) - `options` {{optional_inline}} - : An options object containing the following properties: - `priority` - - : An enumerated value specifying the priority of the announcement. Possible values are: + - : An enumerated value specifying the priority of the announcement. + Possible values are: - `normal` - - : The announcement has normal priority. It will be spoken after any announcement that a screen reader is currently making. + - : The announcement has normal priority. + It will be spoken after any announcement that a screen reader is currently making. + This is the default value. - `high` - - : The announcement has high priority. It will be spoken immediately, interrupting any announcement that a screen reader is currently making. + - : The announcement has high priority. + It will be spoken immediately, interrupting any announcement that a screen reader is currently making. ### Return value diff --git a/files/en-us/web/api/document/index.md b/files/en-us/web/api/document/index.md index a182692e3af1929..417a3aaa6a8c52c 100644 --- a/files/en-us/web/api/document/index.md +++ b/files/en-us/web/api/document/index.md @@ -186,7 +186,7 @@ _This interface also inherits from the {{DOMxRef("Node")}} and {{DOMxRef("EventT - : Adopt node from an external document. - {{DOMxRef("Document.append()")}} - : Inserts a set of {{domxref("Node")}} objects or strings after the last child of the document. -- {{DOMxRef("Document.ariaNotify()")}} {{Experimental_Inline}} +- {{DOMxRef("Document.ariaNotify()")}} - : Specifies that a given string of text should be announced by a screen reader. - {{DOMxRef("Document.browsingTopics()")}} {{non-standard_inline}} {{deprecated_inline}} - : Returns a promise that fulfills with an array of objects representing the top topics for the user, one from each of the last three epochs. By default, the method also causes the browser to record the current page visit as observed by the caller, so the page's hostname can later be used in topics calculation. See the [Topics API](/en-US/docs/Web/API/Topics_API) for more details. diff --git a/files/en-us/web/api/element/arianotify/index.md b/files/en-us/web/api/element/arianotify/index.md index 37c3257996d4f5e..07eaad131419e6f 100644 --- a/files/en-us/web/api/element/arianotify/index.md +++ b/files/en-us/web/api/element/arianotify/index.md @@ -3,14 +3,12 @@ title: "Element: ariaNotify() method" short-title: ariaNotify() slug: Web/API/Element/ariaNotify page-type: web-api-instance-method -status: - - experimental browser-compat: api.Element.ariaNotify --- -{{ApiRef("DOM")}}{{SeeCompatTable}} +{{ApiRef("DOM")}} -The **`ariaNotify()`** method of the {{domxref("Element")}} interface specifies that a given string of text should be announced by a {{glossary("screen reader")}} if available and activated. +The **`ariaNotify()`** method of the {{domxref("Element")}} interface queues a string of text to be announced by a {{glossary("screen reader")}}. ## Syntax @@ -26,11 +24,15 @@ ariaNotify(announcement, options) - `options` {{optional_inline}} - : An options object containing the following properties: - `priority` - - : An enumerated value specifying the priority of the announcement. Possible values are: + - : An enumerated value specifying the priority of the announcement. + Possible values are: - `normal` - - : The announcement has normal priority. It will be spoken after any announcement that a screen reader is currently making. + - : The announcement has normal priority. + It will be spoken after any announcement that a screen reader is currently making. + This is the default value. - `high` - - : The announcement has high priority. It will be spoken immediately, interrupting any announcement that a screen reader is currently making. + - : The announcement has high priority. + It will be spoken immediately, interrupting any announcement that a screen reader is currently making. ### Return value diff --git a/files/en-us/web/api/element/index.md b/files/en-us/web/api/element/index.md index 26a02c4b191e6c4..83532038b8bdff3 100644 --- a/files/en-us/web/api/element/index.md +++ b/files/en-us/web/api/element/index.md @@ -217,7 +217,7 @@ _`Element` inherits methods from its parents {{DOMxRef("Node")}}, and its own pa - : Inserts a set of {{domxref("Node")}} objects or strings in the children list of the `Element`'s parent, just after the `Element`. - {{DOMxRef("Element.animate()")}} - : A shortcut method to create and run an animation on an element. Returns the created Animation object instance. -- {{DOMxRef("Element.ariaNotify()")}} {{Experimental_Inline}} +- {{DOMxRef("Element.ariaNotify()")}} - : Specifies that a given string of text should be announced by a screen reader. - {{DOMxRef("Element.append()")}} - : Inserts a set of {{domxref("Node")}} objects or strings after the last child of the element. diff --git a/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md b/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md index 74c49a3cd4a6946..d956fed8067fba9 100644 --- a/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md +++ b/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md @@ -3,12 +3,10 @@ title: "HighlightRegistry: highlightsFromPoint() method" short-title: highlightsFromPoint() slug: Web/API/HighlightRegistry/highlightsFromPoint page-type: web-api-instance-method -status: - - experimental browser-compat: api.HighlightRegistry.highlightsFromPoint --- -{{APIRef("CSS Custom Highlight API")}}{{SeeCompatTable}} +{{APIRef("CSS Custom Highlight API")}} The **`highlightsFromPoint()`** method of the {{domxref("HighlightRegistry")}} interface returns an array of objects representing the custom highlights applied at a specific point within the viewport. diff --git a/files/en-us/web/api/highlightregistry/index.md b/files/en-us/web/api/highlightregistry/index.md index 29f8d8c3ae11def..3ce6ec86da096a2 100644 --- a/files/en-us/web/api/highlightregistry/index.md +++ b/files/en-us/web/api/highlightregistry/index.md @@ -37,7 +37,7 @@ _The `HighlightRegistry` interface doesn't inherit any methods_. - : Gets the named `Highlight` object from the registry. - {{domxref("HighlightRegistry.has()")}} - : Returns a boolean asserting whether a `Highlight` object is present the registry or not. -- {{domxref("HighlightRegistry.highlightsFromPoint()")}} {{experimental_inline}} +- {{domxref("HighlightRegistry.highlightsFromPoint()")}} - : Returns an array of objects representing the custom highlights applied at a specific point within the viewport. - {{domxref("HighlightRegistry.keys()")}} - : An alias for {{domxref("HighlightRegistry.values()")}}. diff --git a/files/en-us/web/api/htmlmediaelement/index.md b/files/en-us/web/api/htmlmediaelement/index.md index d16cb694aa4a969..a781088d3318e5c 100644 --- a/files/en-us/web/api/htmlmediaelement/index.md +++ b/files/en-us/web/api/htmlmediaelement/index.md @@ -49,7 +49,7 @@ _This interface also inherits properties from its ancestors {{domxref("HTMLEleme - : Returns a boolean that indicates whether the media element has finished playing. - {{domxref("HTMLMediaElement.error")}} {{ReadOnlyInline}} - : Returns a {{domxref("MediaError")}} object for the most recent error, or `null` if there has not been an error. -- {{domxref("HTMLMediaElement.loading")}} +- {{domxref("HTMLMediaElement.loading")}} {{experimental_inline}} - : A string indicating whether the browser should load the media immediately (`eager`) or when it is needed (`lazy`). See [`